@photon-ai/advanced-imessage-kit 1.2.0 → 1.3.0

package/dist/index.cjs

@@ -202,15 +202,23 @@ var AttachmentModule = class {
       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);
-      const { data } = await this.http.post("/api/v1/attachment/upload", form, {
+      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 { data } = await this.http.post("/api/v1/message/attachment", form, {
         headers: form.getHeaders()
       });
-      const response = await this.http.post("/api/v1/message/multipart", {
-        chatGuid: options.chatGuid,
-        selectedMessageGuid: options.selectedMessageGuid,
-        parts: [{ partIndex: 0, attachment: data.data.path, name: fileName }]
-      });
-      return response.data.data;
+      return data.data;
     });
   }
 };
@@ -227,35 +235,32 @@ var ChatModule = class {
     return response.data.data;
   }
   async getChat(guid, options) {
-    const response = await this.http.get(`/api/v1/chat/${guid}`, {
+    const response = await this.http.get(`/api/v1/chat/${encodeURIComponent(guid)}`, {
       params: options?.with ? { with: options.with.join(",") } : {}
     });
     return response.data.data;
   }
   async updateChat(guid, options) {
-    const response = await this.http.put(`/api/v1/chat/${guid}`, options);
+    const response = await this.http.put(`/api/v1/chat/${encodeURIComponent(guid)}`, options);
     return response.data.data;
   }
   async deleteChat(guid) {
-    await this.http.delete(`/api/v1/chat/${guid}`);
+    await this.http.delete(`/api/v1/chat/${encodeURIComponent(guid)}`);
   }
   async markChatRead(guid) {
-    await this.http.post(`/api/v1/chat/${guid}/read`);
-  }
-  async markChatUnread(guid) {
-    await this.http.post(`/api/v1/chat/${guid}/unread`);
+    await this.http.post(`/api/v1/chat/${encodeURIComponent(guid)}/read`);
   }
   async leaveChat(guid) {
-    await this.http.post(`/api/v1/chat/${guid}/leave`);
+    await this.http.post(`/api/v1/chat/${encodeURIComponent(guid)}/leave`);
   }
   async addParticipant(chatGuid, address) {
-    const response = await this.http.post(`/api/v1/chat/${chatGuid}/participant`, {
+    const response = await this.http.post(`/api/v1/chat/${encodeURIComponent(chatGuid)}/participant`, {
       address
     });
     return response.data.data;
   }
   async removeParticipant(chatGuid, address) {
-    const response = await this.http.delete(`/api/v1/chat/${chatGuid}/participant`, {
+    const response = await this.http.delete(`/api/v1/chat/${encodeURIComponent(chatGuid)}/participant`, {
       data: { address }
     });
     return response.data.data;
@@ -268,7 +273,7 @@ var ChatModule = class {
     if (options?.before !== void 0) params.before = options.before;
     if (options?.after !== void 0) params.after = options.after;
     if (options?.with) params.with = options.with.join(",");
-    const response = await this.http.get(`/api/v1/chat/${chatGuid}/message`, {
+    const response = await this.http.get(`/api/v1/chat/${encodeURIComponent(chatGuid)}/message`, {
       params
     });
     return response.data.data;
@@ -278,15 +283,15 @@ var ChatModule = class {
     const fileName = path__namespace.default.basename(filePath);
     const form = new FormData__default.default();
     form.append("icon", fileBuffer, fileName);
-    await this.http.post(`/api/v1/chat/${chatGuid}/icon`, form, {
+    await this.http.post(`/api/v1/chat/${encodeURIComponent(chatGuid)}/icon`, form, {
       headers: form.getHeaders()
     });
   }
   async removeGroupIcon(chatGuid) {
-    await this.http.delete(`/api/v1/chat/${chatGuid}/icon`);
+    await this.http.delete(`/api/v1/chat/${encodeURIComponent(chatGuid)}/icon`);
   }
   async getGroupIcon(chatGuid) {
-    const response = await this.http.get(`/api/v1/chat/${chatGuid}/icon`, {
+    const response = await this.http.get(`/api/v1/chat/${encodeURIComponent(chatGuid)}/icon`, {
       responseType: "arraybuffer"
     });
     return Buffer.from(response.data);
@@ -298,10 +303,10 @@ var ChatModule = class {
     return response.data.data;
   }
   async startTyping(chatGuid) {
-    await this.http.post(`/api/v1/chat/${chatGuid}/typing`);
+    await this.http.post(`/api/v1/chat/${encodeURIComponent(chatGuid)}/typing`);
   }
   async stopTyping(chatGuid) {
-    await this.http.delete(`/api/v1/chat/${chatGuid}/typing`);
+    await this.http.delete(`/api/v1/chat/${encodeURIComponent(chatGuid)}/typing`);
   }
 };
 
@@ -321,10 +326,10 @@ var ContactModule = class {
     return response.data.data;
   }
   async shareContactCard(chatGuid) {
-    await this.http.post(`/api/v1/chat/${chatGuid}/share/contact`);
+    await this.http.post(`/api/v1/chat/${encodeURIComponent(chatGuid)}/share/contact`);
   }
   async shouldShareContact(chatGuid) {
-    const response = await this.http.get(`/api/v1/chat/${chatGuid}/share/contact/status`);
+    const response = await this.http.get(`/api/v1/chat/${encodeURIComponent(chatGuid)}/share/contact/status`);
     return response.data.data;
   }
 };
@@ -390,6 +395,40 @@ var ICloudModule = class {
     await this.http.post("/api/v1/icloud/findmy/friends/refresh");
   }
 };
+
+// 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];
+}
+async function createChatWithMessage(options) {
+  const { http, address, message, tempGuid, subject, effectId } = options;
+  try {
+    const response = await http.post("/api/v1/chat/new", {
+      addresses: [address],
+      message,
+      tempGuid,
+      subject,
+      effectId
+    });
+    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/message.ts
 var MessageModule = class {
   constructor(http, enqueueSend = (task) => task()) {
     this.http = http;
@@ -397,12 +436,25 @@ var MessageModule = class {
   }
   async sendMessage(options) {
     return this.enqueueSend(async () => {
-      const payload = {
-        ...options,
-        tempGuid: options.tempGuid || crypto.randomUUID()
-      };
-      const response = await this.http.post("/api/v1/message/text", payload);
-      return response.data.data;
+      const tempGuid = options.tempGuid || crypto.randomUUID();
+      const payload = { ...options, tempGuid };
+      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;
+        await createChatWithMessage({
+          http: this.http,
+          address,
+          message: options.message,
+          tempGuid,
+          subject: options.subject,
+          effectId: options.effectId
+        });
+        return { guid: tempGuid, text: options.message, dateCreated: Date.now() };
+      }
     });
   }
   async getMessage(guid, options) {
@@ -491,6 +543,51 @@ var MessageModule = class {
   }
 };
 
+// modules/poll.ts
+var PollModule = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async create(options) {
+    if (options.options.length < 2) {
+      throw new Error("Poll must have at least 2 options");
+    }
+    const { data } = await this.http.post("/api/v1/poll/create", {
+      chatGuid: options.chatGuid,
+      title: options.title ?? "",
+      options: options.options
+    });
+    return data.data;
+  }
+  async vote(options) {
+    const { data } = await this.http.post("/api/v1/poll/vote", {
+      chatGuid: options.chatGuid,
+      pollMessageGuid: options.pollMessageGuid,
+      optionIdentifier: options.optionIdentifier
+    });
+    return data.data;
+  }
+  async unvote(options) {
+    const { data } = await this.http.post("/api/v1/poll/unvote", {
+      chatGuid: options.chatGuid,
+      pollMessageGuid: options.pollMessageGuid,
+      optionIdentifier: options.optionIdentifier
+    });
+    return data.data;
+  }
+  async addOption(options) {
+    if (!options.optionText || options.optionText.trim().length === 0) {
+      throw new Error("Option text cannot be empty");
+    }
+    const { data } = await this.http.post("/api/v1/poll/option", {
+      chatGuid: options.chatGuid,
+      pollMessageGuid: options.pollMessageGuid,
+      optionText: options.optionText
+    });
+    return data.data;
+  }
+};
+
 // modules/scheduled.ts
 var ScheduledMessageModule = class {
   constructor(http) {
@@ -532,14 +629,6 @@ var ServerModule = class {
     });
     return response.data.data;
   }
-  async getAlerts() {
-    const response = await this.http.get("/api/v1/server/alert");
-    return response.data.data;
-  }
-  async markAlertAsRead(ids) {
-    const response = await this.http.post("/api/v1/server/alert/read", { ids });
-    return response.data.data;
-  }
   async getMediaStatistics(options) {
     const params = {};
     if (options?.only) params.only = options.only.join(",");
@@ -574,6 +663,7 @@ var _AdvancedIMessageKit = class _AdvancedIMessageKit extends EventEmitter.Event
     __publicField(this, "handles");
     __publicField(this, "facetime");
     __publicField(this, "icloud");
+    __publicField(this, "polls");
     __publicField(this, "scheduledMessages");
     __publicField(this, "server");
     // Message deduplication feature
@@ -587,6 +677,11 @@ var _AdvancedIMessageKit = class _AdvancedIMessageKit extends EventEmitter.Event
     // Purpose: Ensure all outgoing messages (text, attachments, stickers, etc.) from
     // a single user/SDK instance are sent in strict order, preventing race conditions.
     __publicField(this, "sendQueue", Promise.resolve());
+    // Flag to track if 'ready' event has been emitted
+    //
+    // Purpose: Prevent duplicate 'ready' events when both legacy mode (no API key)
+    // and auth-ok events occur, which would cause user callbacks to fire twice.
+    __publicField(this, "readyEmitted", false);
     this.config = {
       serverUrl: "http://localhost:1234",
       logLevel: "info",
@@ -629,6 +724,7 @@ var _AdvancedIMessageKit = class _AdvancedIMessageKit extends EventEmitter.Event
     this.handles = new HandleModule(this.http);
     this.facetime = new FaceTimeModule(this.http);
     this.icloud = new ICloudModule(this.http);
+    this.polls = new PollModule(this.http);
     this.scheduledMessages = new ScheduledMessageModule(this.http);
     this.server = new ServerModule(this.http);
   }
@@ -697,11 +793,15 @@ var _AdvancedIMessageKit = class _AdvancedIMessageKit extends EventEmitter.Event
     }
     this.socket.on("disconnect", () => {
       this.logger.info("Disconnected from iMessage server");
+      this.readyEmitted = false;
       this.emit("disconnect");
     });
     this.socket.on("auth-ok", () => {
       this.logger.info("Authentication successful");
-      this.emit("ready");
+      if (!this.readyEmitted) {
+        this.readyEmitted = true;
+        this.emit("ready");
+      }
     });
     this.socket.on("auth-error", (error) => {
       this.logger.error(`Authentication failed: ${error.message} ${error.reason ? `(${error.reason})` : ""}`);
@@ -713,6 +813,13 @@ var _AdvancedIMessageKit = class _AdvancedIMessageKit extends EventEmitter.Event
     }
     this.socket.once("connect", () => {
       this.logger.info("Connected to iMessage server, waiting for authentication...");
+      if (!this.config.apiKey) {
+        this.logger.info("No API key provided, skipping authentication (legacy server mode)");
+        if (!this.readyEmitted) {
+          this.readyEmitted = true;
+          this.emit("ready");
+        }
+      }
     });
     if (!this.socket.connected) {
       this.socket.connect();
@@ -795,6 +902,144 @@ var IMESSAGE_ALIASES_REMOVED = "imessage-aliases-removed";
 var FT_CALL_STATUS_CHANGED = "ft-call-status-changed";
 var NEW_FINDMY_LOCATION = "new-findmy-location";
 
+// lib/poll-utils.ts
+var POLL_BALLOON_BUNDLE_ID = "com.apple.messages.MSMessageExtensionBalloonPlugin:0000000000:com.apple.messages.Polls";
+var pollCache = /* @__PURE__ */ new Map();
+function cachePoll(messageGuid, poll) {
+  pollCache.set(messageGuid, poll);
+}
+function getOptionTextById(optionId) {
+  for (const poll of pollCache.values()) {
+    const option = poll.options.find((o) => o.optionIdentifier === optionId);
+    if (option) return option.text;
+  }
+  return null;
+}
+function isPollMessage(message) {
+  return message.balloonBundleId === POLL_BALLOON_BUNDLE_ID;
+}
+function isPollVote(message) {
+  return isPollMessage(message) && message.associatedMessageType === "4000";
+}
+function extractDataUrl(payloadData) {
+  if (!payloadData || payloadData.length === 0) return null;
+  const payload = payloadData[0];
+  if (!payload) return null;
+  if (payload.URL && typeof payload.URL === "string") {
+    return payload.URL;
+  }
+  const objects = payload.$objects;
+  if (Array.isArray(objects)) {
+    for (const obj of objects) {
+      if (typeof obj === "object" && obj !== null) {
+        if (obj["NS.relative"] && typeof obj["NS.relative"] === "object") {
+          const relativeObj = objects[obj["NS.relative"].UID];
+          if (typeof relativeObj === "string" && relativeObj.startsWith("data:,")) {
+            return relativeObj;
+          }
+        }
+        if (typeof obj === "string" && obj.startsWith("data:,")) {
+          return obj;
+        }
+      }
+    }
+  }
+  return null;
+}
+function parseDataUrl(dataUrl) {
+  try {
+    const prefix = "data:,";
+    if (!dataUrl.startsWith(prefix)) return null;
+    let data = dataUrl.slice(prefix.length);
+    const queryIndex = data.indexOf("?");
+    if (queryIndex !== -1) {
+      data = data.slice(0, queryIndex);
+    }
+    data = decodeURIComponent(data);
+    try {
+      return JSON.parse(data);
+    } catch {
+      const decoded = Buffer.from(data, "base64").toString("utf-8");
+      return JSON.parse(decoded);
+    }
+  } catch {
+    return null;
+  }
+}
+function parsePollDefinition(message) {
+  if (!isPollMessage(message)) return null;
+  if (isPollVote(message)) return null;
+  const dataUrl = extractDataUrl(message.payloadData);
+  if (!dataUrl) return null;
+  const data = parseDataUrl(dataUrl);
+  if (!data || !data.item) return null;
+  const parsed = {
+    title: data.item.title || "",
+    creatorHandle: data.item.creatorHandle || "",
+    options: data.item.orderedPollOptions || []
+  };
+  if (message.guid) {
+    cachePoll(message.guid, parsed);
+  }
+  return parsed;
+}
+function parsePollVotes(message) {
+  if (!isPollMessage(message)) return null;
+  if (!isPollVote(message)) return null;
+  const dataUrl = extractDataUrl(message.payloadData);
+  if (!dataUrl) return null;
+  const data = parseDataUrl(dataUrl);
+  if (!data || !data.item) return null;
+  return {
+    votes: data.item.votes || []
+  };
+}
+function getPollSummary(message) {
+  if (!isPollMessage(message)) {
+    return message.text || "(no text)";
+  }
+  if (isPollVote(message)) {
+    const voteData = parsePollVotes(message);
+    if (voteData && voteData.votes.length > 0) {
+      const votes = voteData.votes.map((v) => {
+        const optionText = getOptionTextById(v.voteOptionIdentifier);
+        const optionDisplay = optionText ? `"${optionText}"` : `option ${v.voteOptionIdentifier}`;
+        return `${v.participantHandle || "Someone"} voted ${optionDisplay}`;
+      }).join(", ");
+      return `[Poll Vote] ${votes}`;
+    }
+    return "[Poll Vote]";
+  }
+  const pollData = parsePollDefinition(message);
+  if (pollData) {
+    const title = pollData.title ? `"${pollData.title}"` : "(untitled poll)";
+    const optionsList = pollData.options.map((opt, i) => `  ${i + 1}. ${opt.text}`).join("\n");
+    return `[Poll] ${title}
+${optionsList}`;
+  }
+  return "[Poll] (unable to parse)";
+}
+function getPollOneLiner(message) {
+  if (!isPollMessage(message)) {
+    return message.text || "(no text)";
+  }
+  if (isPollVote(message)) {
+    const voteData = parsePollVotes(message);
+    if (voteData && voteData.votes.length > 0) {
+      return `[Poll Vote] ${voteData.votes.length} vote(s)`;
+    }
+    return "[Poll Vote]";
+  }
+  const pollData = parsePollDefinition(message);
+  if (pollData) {
+    const title = pollData.title || "Poll";
+    const optionsPreview = pollData.options.slice(0, 2).map((o) => o.text).join(", ");
+    const moreOptions = pollData.options.length > 2 ? `, +${pollData.options.length - 2} more` : "";
+    return `[${title}] ${optionsPreview}${moreOptions}`;
+  }
+  return "[Poll]";
+}
+
 exports.AdvancedIMessageKit = AdvancedIMessageKit;
 exports.CHAT_READ_STATUS_CHANGED = CHAT_READ_STATUS_CHANGED;
 exports.FT_CALL_STATUS_CHANGED = FT_CALL_STATUS_CHANGED;
@@ -829,6 +1074,12 @@ exports.THEME_BACKUP_DELETED = THEME_BACKUP_DELETED;
 exports.THEME_BACKUP_UPDATED = THEME_BACKUP_UPDATED;
 exports.TYPING_INDICATOR = TYPING_INDICATOR;
 exports.getLogger = getLogger;
+exports.getPollOneLiner = getPollOneLiner;
+exports.getPollSummary = getPollSummary;
+exports.isPollMessage = isPollMessage;
+exports.isPollVote = isPollVote;
+exports.parsePollDefinition = parsePollDefinition;
+exports.parsePollVotes = parsePollVotes;
 exports.setGlobalLogLevel = setGlobalLogLevel;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map