@photon-ai/advanced-imessage-kit 1.6.1 → 1.8.0

package/README.md

@@ -34,6 +34,7 @@ Advanced iMessage Kit is a full-featured iMessage SDK for **reading**, **sending
 | [Reply Stickers](#send-stickers)                           | Attach sticker to a message bubble            | `attachments.sendSticker()`        | [message-reply-sticker.ts](./examples/message-reply-sticker.ts) |
 | [Download Attachments](#download-attachments)              | Download received files and media             | `attachments.downloadAttachment()` | [attachment-download.ts](./examples/attachment-download.ts)     |
 | [Get Chats](#get-chats)                                    | List all conversations                        | `chats.getChats()`                 | [chat-fetch.ts](./examples/chat-fetch.ts)                       |
+| [Get Chat Participants](#get-chat-participants)            | View group chat participants                  | `chats.getChat()`                  | [chat-participants.ts](./examples/chat-participants.ts)         |
 | [Manage Group Chats](#manage-group-chats)                  | Add/remove members, rename groups             | `chats.addParticipant()`           | [chat-group.ts](./examples/chat-group.ts)                       |
 | [Typing Indicators](#typing-indicators)                    | Show "typing..." status                       | `chats.startTyping()`              | [message-typing.ts](./examples/message-typing.ts)               |
 | [Get Contacts](#get-contacts)                              | Fetch device contacts                         | `contacts.getContacts()`           | [contact-list.ts](./examples/contact-list.ts)                   |
@@ -291,6 +292,37 @@ const chat = await sdk.chats.getChat("chat-guid", {
 });
 ```
 
+### Get Chat Participants
+
+Get participants from group chats and display them with contact names:
+
+```typescript
+const chats = await sdk.chats.getChats();
+const groups = chats.filter((chat) => chat.style === 43); // Filter group chats
+
+// Get contacts for name mapping
+const contacts = await sdk.contacts.getContacts();
+const nameMap = new Map<string, string>();
+for (const c of contacts) {
+  const name = c.displayName || c.firstName || "";
+  if (!name) continue;
+  for (const p of c.phoneNumbers || []) nameMap.set(p.address, name);
+  for (const e of c.emails || []) nameMap.set(e.address, name);
+}
+
+// Display participants
+groups.forEach((group) => {
+  console.log(`Group: ${group.displayName || group.chatIdentifier}`);
+  group.participants?.forEach((p) => {
+    const name = nameMap.get(p.address);
+    const display = name ? `${name} <${p.address}>` : p.address;
+    console.log(`  - ${display} (${p.service})`);
+  });
+});
+```
+
+> Example: [chat-participants.ts](./examples/chat-participants.ts)
+
 ### Create Chat
 
 ```typescript
@@ -926,11 +958,12 @@ bun run examples/<filename>.ts
 
 ### Chats & Groups
 
-| File                                              | Description       |
-| ------------------------------------------------- | ----------------- |
-| [chat-fetch.ts](./examples/chat-fetch.ts)         | Get chat list     |
-| [chat-group.ts](./examples/chat-group.ts)         | Manage groups     |
-| [message-typing.ts](./examples/message-typing.ts) | Typing indicators |
+| File                                                    | Description            |
+| ------------------------------------------------------- | ---------------------- |
+| [chat-fetch.ts](./examples/chat-fetch.ts)               | Get chat list          |
+| [chat-participants.ts](./examples/chat-participants.ts) | Get group participants |
+| [chat-group.ts](./examples/chat-group.ts)               | Manage groups          |
+| [message-typing.ts](./examples/message-typing.ts)       | Typing indicators      |
 
 ### Contacts & Services
 

package/dist/index.cjs

@@ -134,6 +134,48 @@ var getLogger = (tag) => {
   }
   return logger;
 };
+
+// lib/auto-create-chat.ts
+function isChatNotExistError(error) {
+  const axiosError = error;
+  const errorMsg = axiosError?.response?.data?.error?.message || axiosError?.response?.data?.message || "";
+  const lowerMsg = errorMsg.toLowerCase();
+  return lowerMsg.includes("chat does not exist") || lowerMsg.includes("chat not found");
+}
+function extractAddress(chatGuid) {
+  const parts = chatGuid.split(";-;");
+  if (parts.length !== 2 || !parts[1]) {
+    return void 0;
+  }
+  return parts[1];
+}
+function extractService(chatGuid) {
+  if (!chatGuid) return void 0;
+  const prefix = chatGuid.split(";")[0]?.toLowerCase();
+  if (prefix === "imessage") return "iMessage";
+  if (prefix === "sms") return "SMS";
+  return void 0;
+}
+async function createChatWithMessage(options) {
+  const { http, address, message, tempGuid, subject, effectId, service } = options;
+  try {
+    const response = await http.post("/api/v1/chat/new", {
+      addresses: [address],
+      message,
+      tempGuid,
+      subject,
+      effectId,
+      ...service && { service }
+    });
+    return response.data.data?.guid;
+  } catch (error) {
+    throw new Error(
+      `Failed to create chat with address "${address}": ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+
+// modules/attachment.ts
 var AttachmentModule = class {
   constructor(http, enqueueSend = (task) => task()) {
     this.http = http;
@@ -176,52 +218,94 @@ var AttachmentModule = class {
     });
     return response.data.data.blurhash;
   }
+  /**
+   * Ensures the chat exists by creating it if it doesn't already exist.
+   */
+  async ensureChatExists(chatGuid) {
+    const address = extractAddress(chatGuid);
+    if (!address) return;
+    const service = extractService(chatGuid);
+    await this.http.post("/api/v1/chat/new", {
+      addresses: [address],
+      ...service && { service }
+    });
+  }
   async sendAttachment(options) {
     return this.enqueueSend(async () => {
       const fileBuffer = await promises.readFile(options.filePath);
       const fileName = options.fileName || path__namespace.default.basename(options.filePath);
-      const form = new FormData__default.default();
-      form.append("chatGuid", options.chatGuid);
-      form.append("attachment", fileBuffer, fileName);
-      form.append("name", fileName);
-      form.append("tempGuid", crypto.randomUUID());
-      if (options.isAudioMessage !== void 0) {
-        form.append("isAudioMessage", options.isAudioMessage.toString());
-        if (options.isAudioMessage) {
-          form.append("method", "private-api");
+      const tempGuid = crypto.randomUUID();
+      const buildForm = () => {
+        const form = new FormData__default.default();
+        form.append("chatGuid", options.chatGuid);
+        form.append("attachment", fileBuffer, fileName);
+        form.append("name", fileName);
+        form.append("tempGuid", tempGuid);
+        if (options.isAudioMessage !== void 0) {
+          form.append("isAudioMessage", options.isAudioMessage.toString());
+          if (options.isAudioMessage) {
+            form.append("method", "private-api");
+          }
         }
+        if (options.selectedMessageGuid) {
+          form.append("selectedMessageGuid", options.selectedMessageGuid);
+        }
+        return form;
+      };
+      try {
+        const form = buildForm();
+        const response = await this.http.post("/api/v1/message/attachment", form, {
+          headers: form.getHeaders()
+        });
+        return response.data.data;
+      } catch (error) {
+        if (!isChatNotExistError(error)) throw error;
+        await this.ensureChatExists(options.chatGuid);
+        const form = buildForm();
+        const response = await this.http.post("/api/v1/message/attachment", form, {
+          headers: form.getHeaders()
+        });
+        return response.data.data;
       }
-      if (options.selectedMessageGuid) {
-        form.append("selectedMessageGuid", options.selectedMessageGuid);
-      }
-      const response = await this.http.post("/api/v1/message/attachment", form, {
-        headers: form.getHeaders()
-      });
-      return response.data.data;
     });
   }
   async sendSticker(options) {
     return this.enqueueSend(async () => {
       const fileName = options.fileName || path__namespace.default.basename(options.filePath);
-      const form = new FormData__default.default();
-      form.append("attachment", await promises.readFile(options.filePath), fileName);
-      form.append("name", fileName);
-      form.append("chatGuid", options.chatGuid);
-      form.append("isSticker", "true");
-      form.append("method", "private-api");
-      if (options.selectedMessageGuid) {
-        form.append("selectedMessageGuid", options.selectedMessageGuid);
-        form.append("partIndex", "0");
-        form.append("stickerX", String(options.stickerX ?? 0.5));
-        form.append("stickerY", String(options.stickerY ?? 0.5));
-        form.append("stickerScale", String(options.stickerScale ?? 0.75));
-        form.append("stickerRotation", String(options.stickerRotation ?? 0));
-        form.append("stickerWidth", String(options.stickerWidth ?? 300));
+      const fileBuffer = await promises.readFile(options.filePath);
+      const buildForm = () => {
+        const form = new FormData__default.default();
+        form.append("attachment", fileBuffer, fileName);
+        form.append("name", fileName);
+        form.append("chatGuid", options.chatGuid);
+        form.append("isSticker", "true");
+        form.append("method", "private-api");
+        if (options.selectedMessageGuid) {
+          form.append("selectedMessageGuid", options.selectedMessageGuid);
+          form.append("partIndex", "0");
+          form.append("stickerX", String(options.stickerX ?? 0.5));
+          form.append("stickerY", String(options.stickerY ?? 0.5));
+          form.append("stickerScale", String(options.stickerScale ?? 0.75));
+          form.append("stickerRotation", String(options.stickerRotation ?? 0));
+          form.append("stickerWidth", String(options.stickerWidth ?? 300));
+        }
+        return form;
+      };
+      try {
+        const form = buildForm();
+        const { data } = await this.http.post("/api/v1/message/attachment", form, {
+          headers: form.getHeaders()
+        });
+        return data.data;
+      } catch (error) {
+        if (!isChatNotExistError(error)) throw error;
+        await this.ensureChatExists(options.chatGuid);
+        const form = buildForm();
+        const { data } = await this.http.post("/api/v1/message/attachment", form, {
+          headers: form.getHeaders()
+        });
+        return data.data;
       }
-      const { data } = await this.http.post("/api/v1/message/attachment", form, {
-        headers: form.getHeaders()
-      });
-      return data.data;
     });
   }
 };
@@ -266,8 +350,8 @@ var ChatModule = class {
     return response.data.data;
   }
   async removeParticipant(chatGuid, address) {
-    const response = await this.http.delete(`/api/v1/chat/${encodeURIComponent(chatGuid)}/participant`, {
-      data: { address }
+    const response = await this.http.post(`/api/v1/chat/${encodeURIComponent(chatGuid)}/participant/remove`, {
+      address
     });
     return response.data.data;
   }
@@ -421,8 +505,25 @@ var MessageModule = class {
     return this.enqueueSend(async () => {
       const tempGuid = options.tempGuid || crypto.randomUUID();
       const payload = { ...options, tempGuid };
-      const response = await this.http.post("/api/v1/message/text", payload);
-      return response.data.data;
+      try {
+        const response = await this.http.post("/api/v1/message/text", payload);
+        return response.data.data;
+      } catch (error) {
+        if (!isChatNotExistError(error)) throw error;
+        const address = extractAddress(options.chatGuid);
+        if (!address) throw error;
+        const service = extractService(options.chatGuid);
+        await createChatWithMessage({
+          http: this.http,
+          address,
+          message: options.message,
+          tempGuid,
+          subject: options.subject,
+          effectId: options.effectId,
+          service
+        });
+        return { guid: tempGuid, text: options.message, dateCreated: Date.now() };
+      }
     });
   }
   async getMessage(guid, options) {