spectrum-ts 1.4.0 → 1.7.1

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   group,
   richlink
-} from "./chunk-66GJ45ZZ.js";
+} from "./chunk-VO43HJ5B.js";
 import {
   voice
-} from "./chunk-B4MHPWPZ.js";
+} from "./chunk-VVXMZYDH.js";
 import {
   SpectrumCloudError,
   broadcast,
@@ -13,7 +13,7 @@ import {
   option,
   poll,
   stream
-} from "./chunk-FF2R4EP3.js";
+} from "./chunk-WFIUWFE4.js";
 import {
   UnsupportedError,
   attachment,
@@ -21,13 +21,16 @@ import {
   contact,
   custom,
   definePlatform,
+  edit,
   fromVCard,
   reaction,
+  reply,
   resolveContents,
   text,
   toVCard,
+  typing,
   wrapProviderMessage
-} from "./chunk-LH4YEBG3.js";
+} from "./chunk-JWWIFSI7.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -2017,6 +2020,7 @@ function createStore() {
 }
 
 // src/spectrum.ts
+var ignoreCleanupError = () => void 0;
 var spectrumOptionsSchema = z.object({
   flattenGroups: z.boolean().optional()
 }).optional();
@@ -2047,30 +2051,28 @@ async function Spectrum(options) {
   const messageBroadcasters = /* @__PURE__ */ new Map();
   const customEventStreams = /* @__PURE__ */ new Map();
   let stopped = false;
-  const adaptIterable = (iterable) => {
-    return stream((emit, end) => {
-      const iterator = iterable[Symbol.asyncIterator]();
-      const pump = (async () => {
-        try {
-          let result = await iterator.next();
-          while (!result.done) {
-            await emit(result.value);
-            result = await iterator.next();
-          }
-          end();
-        } catch (error) {
-          end(error);
+  const adaptIterable = (iterable) => stream((emit, end) => {
+    const iterator = iterable[Symbol.asyncIterator]();
+    const pump = (async () => {
+      try {
+        let result = await iterator.next();
+        while (!result.done) {
+          await emit(result.value);
+          result = await iterator.next();
         }
-      })();
-      return async () => {
-        await iterator.return?.();
-        await pump;
-      };
-    });
-  };
+        end();
+      } catch (error) {
+        end(error);
+      }
+    })();
+    return async () => {
+      await iterator.return?.();
+      await pump.catch(ignoreCleanupError);
+    };
+  });
   const createProviderMessagesStream = (state) => {
     const { client, config, definition, store } = state;
-    const raw = definition.events.messages({
+    const raw = definition.messages({
       client,
       config,
       store
@@ -2081,11 +2083,11 @@ async function Spectrum(options) {
           ...msg.space,
           __platform: definition.name
         };
-        const typingCtx = { space: spaceRef, client, config, store };
+        const actionCtx = { space: spaceRef, client, config, store };
         const space = buildSpace({
           spaceRef,
           extras: {},
-          typingCtx,
+          actionCtx,
           definition,
           client,
           config,
@@ -2150,65 +2152,60 @@ async function Spectrum(options) {
       subscribeMessages: () => getOrCreateMessageBroadcast(state).subscribe()
     });
   }
-  const createMessagesStream = () => {
-    return stream((emit, end) => {
-      const merged = mergeStreams(
-        Array.from(
-          platformStates.values(),
-          (runtime) => runtime.subscribeMessages()
-        )
-      );
-      const pump = (async () => {
-        try {
-          for await (const value of merged) {
-            await emit(value);
-          }
-          end();
-        } catch (error) {
-          end(error);
-        }
-      })();
-      return async () => {
-        await merged.close();
-        await pump;
-      };
-    });
-  };
-  const createCustomEventStream = (eventName) => {
-    return stream((emit, end) => {
-      const providerStreams = Array.from(platformStates.values(), (state) => {
-        const { client, config, definition, store } = state;
-        const producer = definition.events[eventName];
-        if (!producer) {
-          return void 0;
+  const createMessagesStream = () => stream((emit, end) => {
+    const merged = mergeStreams(
+      Array.from(
+        platformStates.values(),
+        (runtime) => runtime.subscribeMessages()
+      )
+    );
+    const pump = (async () => {
+      try {
+        for await (const value of merged) {
+          await emit(value);
         }
-        const providerEvents = producer({ client, config, store });
-        const annotatePlatform = async function* () {
-          for await (const value of providerEvents) {
-            yield { ...value, platform: definition.name };
-          }
-        };
-        return adaptIterable(annotatePlatform());
-      }).filter(
-        (value) => value !== void 0
-      );
-      const merged = mergeStreams(providerStreams);
-      const pump = (async () => {
-        try {
-          for await (const value of merged) {
-            await emit(value);
-          }
-          end();
-        } catch (error) {
-          end(error);
+        end();
+      } catch (error) {
+        end(error);
+      }
+    })();
+    return async () => {
+      await merged.close();
+      await pump.catch(ignoreCleanupError);
+    };
+  });
+  const createCustomEventStream = (eventName) => stream((emit, end) => {
+    const providerStreams = [];
+    for (const state of platformStates.values()) {
+      const { client, config, definition, store } = state;
+      const producer = definition.events?.[eventName];
+      if (!producer) {
+        continue;
+      }
+      const providerEvents = producer({ client, config, store });
+      const annotatePlatform = async function* () {
+        for await (const value of providerEvents) {
+          yield { ...value, platform: definition.name };
         }
-      })();
-      return async () => {
-        await merged.close();
-        await pump;
       };
-    });
-  };
+      providerStreams.push(adaptIterable(annotatePlatform()));
+    }
+    const merged = mergeStreams(providerStreams);
+    const pump = (async () => {
+      try {
+        for await (const value of merged) {
+          await emit(value);
+        }
+        end();
+      } catch (error) {
+        end(error);
+      }
+    })();
+    return async () => {
+      await merged.close();
+      await pump.catch(ignoreCleanupError);
+    };
+  });
   const messagesStream = createMessagesStream();
   const stopOnce = async () => {
     if (stopped) {
@@ -2266,17 +2263,13 @@ async function Spectrum(options) {
     __internal: { platforms: platformStates },
     messages,
     stop: stopOnce,
-    send: (async (space, ...content) => {
-      return content.length === 1 ? await space.send(content[0]) : await space.send(
-        ...content
-      );
-    }),
+    send: (async (space, ...content) => content.length === 1 ? await space.send(content[0]) : await space.send(
+      ...content
+    )),
     edit: async (message, newContent) => {
       await message.edit(newContent);
     },
-    responding: async (space, fn) => {
-      return space.responding(fn);
-    }
+    responding: async (space, fn) => space.responding(fn)
   };
   return new Proxy(base, {
     get(target, prop, receiver) {
@@ -2286,7 +2279,7 @@ async function Spectrum(options) {
       if (typeof prop === "string") {
         return customEventProxy[prop];
       }
-      return void 0;
+      return;
     }
   });
 }
@@ -2301,16 +2294,19 @@ export {
   contact,
   custom,
   definePlatform,
+  edit,
   fromVCard,
   group,
   mergeStreams,
   option,
   poll,
   reaction,
+  reply,
   resolveContents,
   richlink,
   stream,
   text,
   toVCard,
+  typing,
   voice
 };

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

@@ -1,4 +1,4 @@
-import { a as ContentInput, C as ContentBuilder, q as SchemaMessage, e as Platform, d as PlatformDef, P as ProviderMessage, S as Store, k as ManagedStream } from '../../types-BcCLW2VO.js';
+import { C as ContentBuilder, b as ContentInput, S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-lUyzRurY.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
@@ -6,6 +6,34 @@ import { MessageEffect, AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
 import 'hotscript';
 
+declare const CLEAR_SENTINEL: "clear";
+type BackgroundInput = typeof CLEAR_SENTINEL | string | Buffer;
+/**
+ * Set or clear the chat background. iMessage-only, remote-only.
+ *
+ * - `background("clear")` — remove the current chat background.
+ * - `background("./photo.jpg")` — set background from a filesystem path.
+ *   MIME type is inferred from the extension; override with `options.mimeType`.
+ * - `background(buffer, { mimeType })` — set background from in-memory bytes.
+ *   `options.mimeType` is required.
+ *
+ * `"clear"` is a reserved string-literal sentinel. If you have a file literally
+ * named `clear` with no extension, pass `"./clear"` or load it as a Buffer.
+ *
+ * `space.send(background(...))` is the canonical form; `space.background(...)`
+ * is sugar attached via `PlatformDef.space.actions` (only typed on
+ * `PlatformSpace<IMessageDef>`).
+ *
+ * `Background` is intentionally not a member of the universal `Content`
+ * union — the `as unknown as Content` cast keeps the builder shape compatible
+ * with the framework's `ContentBuilder.build(): Promise<Content>` signature.
+ * The framework treats it as a fire-and-forget control signal at runtime.
+ */
+declare function background(input: "clear"): ContentBuilder;
+declare function background(input: string | Buffer, options?: {
+    mimeType?: string;
+}): ContentBuilder;
+
 type IMessageMessageEffect = MessageEffect;
 declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
 
@@ -18,8 +46,8 @@ declare const userSchema: z__default.ZodObject<{}, z__default.core.$strip>;
 declare const spaceSchema: z__default.ZodObject<{
     id: z__default.ZodString;
     type: z__default.ZodEnum<{
-        dm: "dm";
         group: "group";
+        dm: "dm";
     }>;
     phone: z__default.ZodString;
 }, z__default.core.$strip>;
@@ -44,8 +72,8 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
 }, zod_v4_core.$strip>]>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodObject<{
     id: z.ZodString;
     type: z.ZodEnum<{
-        dm: "dm";
         group: "group";
+        dm: "dm";
     }>;
     phone: z.ZodString;
 }, zod_v4_core.$strip>, z.ZodObject<{
@@ -63,39 +91,7 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
 }, z.ZodObject<{
     partIndex: z.ZodOptional<z.ZodNumber>;
     parentId: z.ZodOptional<z.ZodString>;
-}, zod_v4_core.$strip>, ProviderMessage<{
-    id: string;
-}, {
-    id: string;
-    type: "dm";
-    phone: string;
-} | {
-    id: string;
-    type: "group";
-    phone: string;
-}, {
-    partIndex?: number | undefined;
-    parentId?: string | undefined;
-}>, {
-    messages: ({ client }: {
-        client: IMessageClient;
-        config: {
-            local: true;
-        } | {
-            local: false;
-            clients?: {
-                address: string;
-                token: string;
-                phone: string;
-            } | {
-                address: string;
-                token: string;
-                phone: string;
-            }[] | undefined;
-        };
-        store: Store;
-    }) => ManagedStream<IMessageMessage>;
-}>> & Readonly<{
+}, zod_v4_core.$strip>, IMessageMessage, undefined>> & Readonly<{
     effect: {
         message: {
             readonly slam: "com.apple.MobileSMS.expressivesend.impact";
@@ -115,4 +111,4 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
     };
 }>;
 
-export { type IMessageMessageEffect, effect, imessage };
+export { type BackgroundInput, type IMessageMessageEffect, background, effect, imessage };