spectrum-ts 0.5.0 → 0.6.1

package/dist/providers/imessage/index.js

@@ -13,7 +13,7 @@ import {
 import {
   asText,
   definePlatform
-} from "../../chunk-XEEDIGVK.js";
+} from "../../chunk-XZTTLPHE.js";
 
 // src/providers/imessage/index.ts
 import { createClient as createClient2, directChat } from "@photon-ai/advanced-imessage";
@@ -107,13 +107,14 @@ async function disposeCloudAuth(clients) {
 
 // src/providers/imessage/local.ts
 import { createReadStream } from "fs";
-import { mkdtemp, rm, writeFile } from "fs/promises";
+import { mkdtemp, readFile, rm, writeFile } from "fs/promises";
 import { tmpdir } from "os";
 import { basename, join } from "path";
 import { Readable } from "stream";
-import {
-  readAttachmentBytes
-} from "@photon-ai/imessage-kit";
+var synthSendResult = () => ({
+  id: crypto.randomUUID(),
+  timestamp: /* @__PURE__ */ new Date()
+});
 var DEFAULT_ATTACHMENT_NAME = "attachment";
 var VCARD_MIME_TYPES = /* @__PURE__ */ new Set([
   "text/vcard",
@@ -129,17 +130,21 @@ var isVCardAttachment = (mimeType, fileName) => {
   }
   return Boolean(fileName?.toLowerCase().endsWith(".vcf"));
 };
-var toSpace = (message) => ({
-  id: message.chatId,
-  type: message.chatKind === "group" ? "group" : "dm"
-});
+var readLocalAttachment = async (att) => {
+  if (!att.localPath) {
+    throw new Error(
+      `iMessage attachment ${att.id} has no local file available on disk`
+    );
+  }
+  return readFile(att.localPath);
+};
 var toAttachmentContent = (att) => {
   const { localPath } = att;
   return asAttachment({
     name: att.fileName ?? DEFAULT_ATTACHMENT_NAME,
     mimeType: att.mimeType,
     size: att.sizeBytes,
-    read: () => readAttachmentBytes(att),
+    read: () => readLocalAttachment(att),
     stream: localPath ? async () => Readable.toWeb(
       createReadStream(localPath)
     ) : void 0
@@ -147,16 +152,23 @@ var toAttachmentContent = (att) => {
 };
 var toVCardContent = async (att) => {
   try {
-    const buf = await readAttachmentBytes(att);
+    const buf = await readLocalAttachment(att);
     return asContact(fromVCard(buf.toString("utf8")));
   } catch {
     return toAttachmentContent(att);
   }
 };
 var toMessages = async (message) => {
+  const { chatId, chatKind } = message;
+  if (!chatId || chatKind === "unknown") {
+    return [];
+  }
+  if (message.reaction !== null || message.kind !== "text" || message.retractedAt !== null) {
+    return [];
+  }
   const base = {
     sender: { id: message.participant ?? "" },
-    space: toSpace(message),
+    space: { id: chatId, type: chatKind === "group" ? "group" : "dm" },
     timestamp: message.createdAt
   };
   if (message.attachments.length > 0) {
@@ -178,16 +190,23 @@ var toMessages = async (message) => {
 };
 var messages = (client) => stream((emit, end) => {
   let lastPromise = Promise.resolve();
-  client.startWatching({
-    onMessage: (message) => {
+  const startPromise = client.startWatching({
+    onIncomingMessage: (message) => {
       lastPromise = lastPromise.then(() => toMessages(message)).then((ms) => {
         for (const m of ms) {
           emit(m);
         }
-      }).catch((error) => end(error));
-    }
-  });
-  return () => client.stopWatching();
+      }).catch(end);
+    },
+    onError: end
+  }).catch(end);
+  return async () => {
+    await startPromise.catch(() => {
+    });
+    await client.stopWatching();
+    await lastPromise.catch(() => {
+    });
+  };
 });
 var vcardFileName = (content) => {
   const base = content.name?.formatted ?? content.user?.id ?? "contact";
@@ -199,7 +218,7 @@ var sendTempFile = async (client, spaceId, name, data) => {
   const tmp = join(dir, safeName);
   await writeFile(tmp, data);
   try {
-    await client.send(spaceId, { attachments: [tmp] });
+    await client.send({ to: spaceId, attachments: [tmp] });
   } finally {
     await rm(dir, { recursive: true, force: true }).catch(() => {
     });
@@ -208,11 +227,11 @@ var sendTempFile = async (client, spaceId, name, data) => {
 var send = async (client, spaceId, content) => {
   switch (content.type) {
     case "text":
-      await client.send(spaceId, content.text);
-      break;
+      await client.send({ to: spaceId, text: content.text });
+      return synthSendResult();
     case "attachment":
       await sendTempFile(client, spaceId, content.name, await content.read());
-      break;
+      return synthSendResult();
     case "contact": {
       const vcf = await toVCard(content);
       await sendTempFile(
@@ -221,10 +240,12 @@ var send = async (client, spaceId, content) => {
         vcardFileName(content),
         Buffer.from(vcf, "utf8")
       );
-      break;
+      return synthSendResult();
     }
     default:
-      break;
+      throw new Error(
+        `Unsupported iMessage local content type: ${content.type}`
+      );
   }
 };
 
@@ -237,7 +258,7 @@ import {
 
 // src/utils/audio.ts
 import { spawn } from "child_process";
-import { mkdtemp as mkdtemp2, readFile, rm as rm2, writeFile as writeFile2 } from "fs/promises";
+import { mkdtemp as mkdtemp2, readFile as readFile2, rm as rm2, writeFile as writeFile2 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import { join as join2 } from "path";
 var M4A_BRANDS = /* @__PURE__ */ new Set([
@@ -344,7 +365,7 @@ var transcodeToM4a = async (buffer) => {
     if (code !== 0) {
       throw new Error(`ffmpeg conversion failed (exit ${code}): ${stderr}`);
     }
-    const out = await readFile(outPath);
+    const out = await readFile2(outPath);
     return { buffer: out, duration: parseDuration(stderr) };
   } finally {
     await rm2(dir, { recursive: true, force: true }).catch(() => {
@@ -359,6 +380,10 @@ var ensureM4a = async (buffer, mimeType) => {
 };
 
 // src/providers/imessage/remote.ts
+var toSendResult = (receipt) => ({
+  id: receipt.guid,
+  timestamp: /* @__PURE__ */ new Date()
+});
 var VCARD_MIME_TYPES2 = /* @__PURE__ */ new Set([
   "text/vcard",
   "text/x-vcard",
@@ -425,6 +450,9 @@ var clientStream = (client) => {
     (async () => {
       try {
         for await (const event of sub) {
+          if (event.message.isFromMe) {
+            continue;
+          }
           for (const message of await toMessages2(client, event)) {
             emit(message);
           }
@@ -469,27 +497,27 @@ var stopTyping = async (clients, spaceId) => {
 var send2 = async (clients, spaceId, content) => {
   const remote = clients[0];
   if (!remote) {
-    return;
+    throw new Error("No remote iMessage client available");
   }
+  const chat = chatGuid(spaceId);
   switch (content.type) {
     case "text":
-      await remote.messages.send(chatGuid(spaceId), content.text);
-      break;
+      return toSendResult(await remote.messages.send(chat, content.text));
     case "attachment": {
       const attachment = await remote.attachments.upload({
         data: await content.read(),
         fileName: content.name,
         mimeType: content.mimeType
       });
-      await remote.messages.send(chatGuid(spaceId), "", {
-        attachment: attachment.guid
-      });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, "", {
+          attachment: attachment.guid
+        })
+      );
     }
     case "contact": {
       const attachment = await sendContactAttachment(remote, content);
-      await remote.messages.send(chatGuid(spaceId), "", { attachment });
-      break;
+      return toSendResult(await remote.messages.send(chat, "", { attachment }));
     }
     case "voice": {
       const { buffer } = await ensureM4a(
@@ -501,11 +529,12 @@ var send2 = async (clients, spaceId, content) => {
         fileName: content.name ?? "voice.m4a",
         mimeType: "audio/x-m4a"
       });
-      await remote.messages.send(chatGuid(spaceId), "", {
-        attachment: attachment.guid,
-        audioMessage: true
-      });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, "", {
+          attachment: attachment.guid,
+          audioMessage: true
+        })
+      );
     }
     default:
       throw new Error(`Unsupported iMessage content type: ${content.type}`);
@@ -514,30 +543,33 @@ var send2 = async (clients, spaceId, content) => {
 var replyToMessage = async (clients, spaceId, msgId, content) => {
   const remote = clients[0];
   if (!remote) {
-    return;
+    throw new Error("No remote iMessage client available");
   }
   const chat = chatGuid(spaceId);
   const replyTo = messageGuid(msgId);
   switch (content.type) {
     case "text":
-      await remote.messages.send(chat, content.text, { replyTo });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, content.text, { replyTo })
+      );
     case "attachment": {
       const attachment = await remote.attachments.upload({
         data: await content.read(),
         fileName: content.name,
         mimeType: content.mimeType
       });
-      await remote.messages.send(chat, "", {
-        attachment: attachment.guid,
-        replyTo
-      });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, "", {
+          attachment: attachment.guid,
+          replyTo
+        })
+      );
     }
     case "contact": {
       const attachment = await sendContactAttachment(remote, content);
-      await remote.messages.send(chat, "", { attachment, replyTo });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, "", { attachment, replyTo })
+      );
     }
     case "voice": {
       const { buffer } = await ensureM4a(
@@ -549,17 +581,32 @@ var replyToMessage = async (clients, spaceId, msgId, content) => {
         fileName: content.name ?? "voice.m4a",
         mimeType: "audio/x-m4a"
       });
-      await remote.messages.send(chat, "", {
-        attachment: attachment.guid,
-        audioMessage: true,
-        replyTo
-      });
-      break;
+      return toSendResult(
+        await remote.messages.send(chat, "", {
+          attachment: attachment.guid,
+          audioMessage: true,
+          replyTo
+        })
+      );
     }
     default:
       throw new Error(`Unsupported iMessage content type: ${content.type}`);
   }
 };
+var editMessage = async (clients, spaceId, msgId, content) => {
+  if (content.type !== "text") {
+    throw new Error("iMessage only supports editing text content");
+  }
+  const remote = clients[0];
+  if (!remote) {
+    throw new Error("No remote iMessage client available");
+  }
+  await remote.messages.edit(
+    chatGuid(spaceId),
+    messageGuid(msgId),
+    content.text
+  );
+};
 var reactToMessage = async (clients, spaceId, msgId, reaction) => {
   const remote = clients[0];
   if (!remote) {
@@ -671,10 +718,9 @@ var imessage = definePlatform("iMessage", {
   actions: {
     send: async ({ space, content, client }) => {
       if (isLocal(client)) {
-        await send(client, space.id, content);
-      } else {
-        await send2(client, space.id, content);
+        return await send(client, space.id, content);
       }
+      return await send2(client, space.id, content);
     },
     startTyping: async ({ space, client }) => {
       if (isLocal(client)) {
@@ -696,9 +742,19 @@ var imessage = definePlatform("iMessage", {
     },
     replyToMessage: async ({ space, messageId, content, client }) => {
       if (isLocal(client)) {
-        return;
+        throw new Error(
+          "iMessage local mode does not support replying to messages"
+        );
+      }
+      return await replyToMessage(client, space.id, messageId, content);
+    },
+    editMessage: async ({ space, messageId, content, client }) => {
+      if (isLocal(client)) {
+        throw new Error(
+          "iMessage local mode does not support editing messages"
+        );
       }
-      await replyToMessage(client, space.id, messageId, content);
+      await editMessage(client, space.id, messageId, content);
     }
   }
 });

package/dist/providers/terminal/index.d.ts

@@ -1,4 +1,4 @@
-import { d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-CfiD_00g.js';
+import { d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-DZMHfgYQ.js';
 import * as node_readline from 'node:readline';
 import z__default from 'zod';
 import 'hotscript';

package/dist/providers/terminal/index.js

@@ -1,6 +1,6 @@
 import {
   definePlatform
-} from "../../chunk-XEEDIGVK.js";
+} from "../../chunk-XZTTLPHE.js";
 
 // src/providers/terminal/index.ts
 import { createInterface } from "readline";
@@ -49,9 +49,13 @@ var terminal = definePlatform("terminal", {
   },
   actions: {
     send: async ({ content }) => {
-      if (content.type === "text") {
-        console.log(content.text);
+      if (content.type !== "text") {
+        throw new Error(
+          `Terminal provider only supports text content, got "${content.type}"`
+        );
       }
+      console.log(content.text);
+      return { id: crypto.randomUUID(), timestamp: /* @__PURE__ */ new Date() };
     }
   }
 });

package/dist/providers/whatsapp-business/index.d.ts

@@ -1,7 +1,7 @@
 import { M as ManagedStream } from '../../stream-DGy4geUK.js';
 import * as z from 'zod';
 import z__default from 'zod';
-import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-CfiD_00g.js';
+import { l as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage } from '../../types-DZMHfgYQ.js';
 import * as zod_v4_core from 'zod/v4/core';
 import { WhatsAppClient } from '@photon-ai/whatsapp-business';
 import 'hotscript';

package/dist/providers/whatsapp-business/index.js

@@ -7,7 +7,7 @@ import {
 import {
   asText,
   definePlatform
-} from "../../chunk-XEEDIGVK.js";
+} from "../../chunk-XZTTLPHE.js";
 
 // src/providers/whatsapp-business/index.ts
 import {
@@ -16,6 +16,9 @@ import {
 
 // src/providers/whatsapp-business/messages.ts
 import { extension as mimeExtension } from "mime-types";
+var toSendResult = (result) => ({
+  id: result.messageId
+});
 var mapWaPhoneType = (type) => {
   if (!type) {
     return void 0;
@@ -311,8 +314,9 @@ var messages = (client) => {
 var send = async (client, spaceId, content) => {
   switch (content.type) {
     case "text":
-      await client.messages.send({ to: spaceId, text: content.text });
-      break;
+      return toSendResult(
+        await client.messages.send({ to: spaceId, text: content.text })
+      );
     case "attachment": {
       const { mediaId } = await client.media.upload({
         file: await content.read(),
@@ -321,32 +325,35 @@ var send = async (client, spaceId, content) => {
       });
       const mediaType = mimeToMediaType(content.mimeType);
       const mediaPayload = mediaType === "document" ? { id: mediaId, filename: content.name } : { id: mediaId };
-      await client.messages.send({
-        to: spaceId,
-        [mediaType]: mediaPayload
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          [mediaType]: mediaPayload
+        })
+      );
     }
     case "contact":
-      await client.messages.send({
-        to: spaceId,
-        contacts: [contactToWa(content)]
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          contacts: [contactToWa(content)]
+        })
+      );
     case "voice": {
       const { mediaId } = await client.media.upload({
         file: await content.read(),
         mimeType: content.mimeType,
         filename: voiceFilename(content)
       });
-      await client.messages.send({
-        to: spaceId,
-        audio: { id: mediaId }
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          audio: { id: mediaId }
+        })
+      );
     }
     default:
-      break;
+      throw new Error(`Unsupported WhatsApp content type: ${content.type}`);
   }
 };
 var reactToMessage = async (client, spaceId, messageId, reaction) => {
@@ -358,12 +365,13 @@ var reactToMessage = async (client, spaceId, messageId, reaction) => {
 var replyToMessage = async (client, spaceId, messageId, content) => {
   switch (content.type) {
     case "text":
-      await client.messages.send({
-        to: spaceId,
-        replyTo: messageId,
-        text: content.text
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          replyTo: messageId,
+          text: content.text
+        })
+      );
     case "attachment": {
       const { mediaId } = await client.media.upload({
         file: await content.read(),
@@ -372,35 +380,38 @@ var replyToMessage = async (client, spaceId, messageId, content) => {
       });
       const mediaType = mimeToMediaType(content.mimeType);
       const mediaPayload = mediaType === "document" ? { id: mediaId, filename: content.name } : { id: mediaId };
-      await client.messages.send({
-        to: spaceId,
-        replyTo: messageId,
-        [mediaType]: mediaPayload
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          replyTo: messageId,
+          [mediaType]: mediaPayload
+        })
+      );
     }
     case "contact":
-      await client.messages.send({
-        to: spaceId,
-        replyTo: messageId,
-        contacts: [contactToWa(content)]
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          replyTo: messageId,
+          contacts: [contactToWa(content)]
+        })
+      );
     case "voice": {
       const { mediaId } = await client.media.upload({
         file: await content.read(),
         mimeType: content.mimeType,
         filename: voiceFilename(content)
       });
-      await client.messages.send({
-        to: spaceId,
-        replyTo: messageId,
-        audio: { id: mediaId }
-      });
-      break;
+      return toSendResult(
+        await client.messages.send({
+          to: spaceId,
+          replyTo: messageId,
+          audio: { id: mediaId }
+        })
+      );
     }
     default:
-      break;
+      throw new Error(`Unsupported WhatsApp content type: ${content.type}`);
   }
 };
 
@@ -457,7 +468,7 @@ var whatsappBusiness = definePlatform("WhatsApp Business", {
   },
   actions: {
     send: async ({ space, content, client }) => {
-      await send(client, space.id, content);
+      return await send(client, space.id, content);
     },
     reactToMessage: async ({ space, messageId, reaction, client }) => {
       await reactToMessage(
@@ -468,7 +479,7 @@ var whatsappBusiness = definePlatform("WhatsApp Business", {
       );
     },
     replyToMessage: async ({ space, messageId, content, client }) => {
-      await replyToMessage(
+      return await replyToMessage(
         client,
         space.id,
         messageId,

package/dist/{types-CfiD_00g.d.ts → types-DZMHfgYQ.d.ts}

@@ -92,23 +92,35 @@ interface User {
 
 interface Space<_Def = unknown> {
     readonly __platform: string;
+    edit(message: OutboundMessage, newContent: ContentInput): Promise<void>;
     readonly id: string;
     responding<T>(fn: () => T | Promise<T>): Promise<T>;
-    send(...content: [ContentInput, ...ContentInput[]]): Promise<void>;
+    send(content: ContentInput): Promise<OutboundMessage>;
+    send(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<OutboundMessage[]>;
     startTyping(): Promise<void>;
     stopTyping(): Promise<void>;
 }
 
-interface Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> {
+interface BaseMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> {
     content: Content;
     readonly id: string;
     platform: TPlatform;
     react(reaction: string): Promise<void>;
-    reply(...content: [ContentInput, ...ContentInput[]]): Promise<void>;
-    sender: TSender;
+    reply(content: ContentInput): Promise<OutboundMessage<TPlatform, TSender, TSpace>>;
+    reply(...content: [ContentInput, ContentInput, ...ContentInput[]]): Promise<OutboundMessage<TPlatform, TSender, TSpace>[]>;
     space: TSpace;
     timestamp: Date;
 }
+interface InboundMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> extends BaseMessage<TPlatform, TSender, TSpace> {
+    direction: "inbound";
+    sender: TSender;
+}
+interface OutboundMessage<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> extends BaseMessage<TPlatform, TSender, TSpace> {
+    direction: "outbound";
+    edit(newContent: ContentInput): Promise<void>;
+    sender: TSender | undefined;
+}
+type Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> = InboundMessage<TPlatform, TSender, TSpace> | OutboundMessage<TPlatform, TSender, TSpace>;
 
 type ResolvedSpace = Pick<Space, "id">;
 type SpaceRef = Pick<Space, "id" | "__platform">;
@@ -131,6 +143,11 @@ type ProviderMessage<TSender extends ResolvedUser = ResolvedUser, TSpace extends
     space: TSpace;
     timestamp?: Date;
 } & TExtra;
+interface SendResult<TSender extends ResolvedUser = ResolvedUser> {
+    id: string;
+    sender?: TSender;
+    timestamp?: Date;
+}
 type MergeSchema<TSchema extends z__default.ZodType | undefined, TBase extends object> = TSchema extends z__default.ZodType ? string extends keyof z__default.infer<TSchema> ? TBase : Omit<z__default.infer<TSchema>, keyof TBase> & TBase : TBase;
 type SchemaMessage<TUserSchema extends z__default.ZodType | undefined = undefined, TSpaceSchema extends z__default.ZodType | undefined = undefined> = ProviderMessage<MergeSchema<TUserSchema, ResolvedUser>, MergeSchema<TSpaceSchema, ResolvedSpace>>;
 type InferEventPayload<T> = T extends (ctx: never) => AsyncIterable<infer P> ? P : never;
@@ -146,7 +163,7 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             content: Content;
             client: _Client;
             config: z__default.infer<_ConfigSchema>;
-        }) => Promise<void>;
+        }) => Promise<SendResult<_ResolvedUser>>;
         startTyping?: (_: {
             space: _ResolvedSpace & SpaceRef;
             client: _Client;
@@ -170,6 +187,13 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             content: Content;
             client: _Client;
             config: z__default.infer<_ConfigSchema>;
+        }) => Promise<SendResult<_ResolvedUser>>;
+        editMessage?: (_: {
+            space: _ResolvedSpace & SpaceRef;
+            messageId: string;
+            content: Content;
+            client: _Client;
+            config: z__default.infer<_ConfigSchema>;
         }) => Promise<void>;
     };
     config: _ConfigSchema;
@@ -215,11 +239,12 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
 }
 interface AnyPlatformDef {
     actions: {
-        send: (_: any) => Promise<void>;
+        send: (_: any) => Promise<SendResult>;
         startTyping?: (_: any) => Promise<void>;
         stopTyping?: (_: any) => Promise<void>;
         reactToMessage?: (_: any) => Promise<void>;
-        replyToMessage?: (_: any) => Promise<void>;
+        replyToMessage?: (_: any) => Promise<SendResult>;
+        editMessage?: (_: any) => Promise<void>;
     };
     config: z__default.ZodType<object>;
     events: {
@@ -318,4 +343,4 @@ interface Platform<Def extends AnyPlatformDef> {
     (message: Message): PlatformMessage<Def>;
 }
 
-export type { AnyPlatformDef as A, ContentBuilder as C, EventProducer as E, Message as M, ProviderMessage as P, SpectrumLike as S, User as U, ContentInput as a, Content as b, PlatformDef as c, Platform as d, PlatformProviderConfig as e, CustomEventStreams as f, Space as g, PlatformInstance as h, PlatformMessage as i, PlatformSpace as j, PlatformUser as k, SchemaMessage as l };
+export type { AnyPlatformDef as A, ContentBuilder as C, EventProducer as E, InboundMessage as I, Message as M, OutboundMessage as O, ProviderMessage as P, SpectrumLike as S, User as U, ContentInput as a, Content as b, PlatformDef as c, Platform as d, PlatformProviderConfig as e, CustomEventStreams as f, Space as g, PlatformInstance as h, PlatformMessage as i, PlatformSpace as j, PlatformUser as k, SchemaMessage as l };