Messages

const sent = await im.messages.sendText(chat.guid, "Hello");

console.log(sent.guid);

const message = {
  // Message GUID. Use it for edits, unsends, reactions, replies, and lookups.
  guid: "message-guid",
  // Chats that contain this message.
  chatGuids: ["any;-;alice@example.com"],
  content: {
    text: "Hello",
    attachments: [],
    formatting: [],
    mentions: [],
  },
  isFromMe: true,
  dateCreated: new Date("2026-01-01T12:00:00Z"),
};

import { MessageEffect } from "@photon-ai/advanced-imessage";

await im.messages.sendText(chat.guid, "Happy birthday", {
  effect: MessageEffect.confetti,
});

import { TextEffect } from "@photon-ai/advanced-imessage";

await im.messages.sendText(chat.guid, "Bold then bloom", {
  formatting: [
    { type: "bold", start: 0, length: 4 },
    { type: "effect", start: 10, length: 5, effect: TextEffect.bloom },
  ],
});

const uploaded = await im.attachments.upload({
  fileName: "photo.jpg",
  data: await readFile("photo.jpg"),
});

const sent = await im.messages.sendAttachment(chat.guid, uploaded.attachment.guid);

console.log(sent.guid);

const audio = await im.attachments.upload({
  fileName: "voice.m4a",
  data: await readFile("voice.m4a"),
});

await im.messages.sendAttachment(chat.guid, audio.attachment.guid, {
  isAudioMessage: true,
});

await im.messages.sendText(chat.guid, "Replying to this", {
  replyTo: sent.guid,
});

await im.messages.sendText(chat.guid, "Replying to the second bubble", {
  replyTo: {
    guid: sent.guid,
    partIndex: 1,
  },
});

await im.messages.sendMultipart(chat.guid, [
  { text: "Look at this " },
  { text: "@Alice", mentionedAddress: "alice@example.com" },
  {
    attachmentGuid: uploaded.attachment.guid,
    attachmentName: "photo.jpg",
  },
]);

{
  "text":             "Look at this",       // Text content
  "mentionedAddress": "alice@example.com",  // Optional; marks this text part as a mention
  "formatting":       []                    // Optional; applies only to this text part
}

{
  "attachmentGuid":   "attachment-guid",    // Attachment GUID
  "attachmentName":   "photo.jpg"           // Optional display name
}

const photos = await Promise.all(
  ["photo-1.jpg", "photo-2.jpg", "photo-3.jpg"].map(async (fileName) => {
    return im.attachments.upload({
      fileName,
      data: await readFile(fileName),
    });
  }),
);

await im.messages.sendMultipart(chat.guid, [
  {
    attachmentGuid: photos[0]!.attachment.guid,
    attachmentName: "photo-1.jpg",
  },
  {
    attachmentGuid: photos[1]!.attachment.guid,
    attachmentName: "photo-2.jpg",
  },
  {
    attachmentGuid: photos[2]!.attachment.guid,
    attachmentName: "photo-3.jpg",
  },
]);

await im.messages.setReaction(chat.guid, sent.guid, { kind: "love" }, true);

await im.messages.setReaction(chat.guid, sent.guid, { kind: "love" }, false);

await im.messages.setReaction(chat.guid, sent.guid, { kind: "emoji", emoji: "👍" }, true);

const sticker = await im.attachments.upload({
  fileName: "sticker.png",
  data: await readFile("sticker.png"),
});

await im.messages.placeSticker(chat.guid, sent.guid, sticker.attachment.guid, {
  x: 0.54,
  y: 0.48,
  scale: 0.45,
  rotation: -0.08,
  width: 96,
});

await im.messages.setReaction(chat.guid, sent.guid, { kind: "like" }, true, {
  partIndex: 1,
});

const edited = await im.messages.edit(chat.guid, sent.guid, "Corrected text", {
  backwardCompatText: "Edited: Corrected text",
});

console.log(edited.guid);

await im.messages.unsend(chat.guid, sent.guid);

await im.messages.notifySilenced(chat.guid, sent.guid);

const message = await im.messages.get(chat.guid, sent.guid);

console.log(message.content.text);

const recent = await im.messages.listRecent({
  pageSize: 25,
});

for (const message of recent.messages) {
  console.log(message.guid, message.content.text);
}

const page = await im.messages.listInChat(chat.guid, {
  pageSize: 25,
  before: new Date("2026-01-01T00:00:00Z"),
});

for (const message of page.messages) {
  console.log(message.guid);
}

let pageToken;

do {
  const page = await im.messages.listInChat(chat.guid, {
    pageSize: 50,
    pageToken,
  });

  for (const message of page.messages) {
    console.log(message.guid, message.content.text);
  }

  pageToken = page.nextPageToken;
} while (pageToken);

const media = await im.messages.getEmbeddedMedia(chat.guid, message.guid);

console.log(media.mimeType, media.data.byteLength);

for await (const event of im.messages.subscribeEvents({ chat: chat.guid })) {
  switch (event.type) {
    case "message.received":
      console.log(event.message.guid, event.message.content.text);
      break;

    case "message.edited":
      console.log(event.messageGuid, event.editedAt);
      break;

    case "message.unsent":
      console.log(event.messageGuid, event.retractedAt);
      break;
  }
}

for await (const event of im.messages.subscribeEvents()) {
  console.log(event.chatGuid, event.type);
}

const event = {
  // Event type.
  type: "message.received",
  // Durable event sequence.
  sequence: 123,
  // Chat that owns the event.
  chatGuid: "any;-;alice@example.com",
  // Whether the current account produced the event.
  isFromMe: false,
  occurredAt: new Date("2026-01-01T12:00:00Z"),
  // Participant that triggered the event; may be absent.
  actor: {
    address: "alice@example.com",
    service: "iMessage",
  },
  // Present on message.received.
  message: {
    guid: "message-guid",
  },
};