@spectrum-ts/core 9.3.1 → 10.0.0

package/README.md

@@ -27,7 +27,7 @@ The fastest way to ship is with **Spectrum Cloud** — hosted infrastructure for
 
 1. Sign up at **[app.photon.codes](https://app.photon.codes)** to get your project ID and secret.
 2. Install the SDK (`spectrum-ts` is batteries-included — the runtime plus
-   every official provider):
+   the standard provider set):
 
    ```bash
    bun add spectrum-ts
@@ -42,7 +42,7 @@ The fastest way to ship is with **Spectrum Cloud** — hosted infrastructure for
    const app = await Spectrum({
      projectId: process.env.PROJECT_ID,
      projectSecret: process.env.PROJECT_SECRET,
-     providers: [imessage.config()],
+     platforms: [imessage.config()],
    });
 
    for await (const [space, message] of app.messages) {
@@ -52,7 +52,7 @@ The fastest way to ship is with **Spectrum Cloud** — hosted infrastructure for
    }
    ```
 
-Spectrum also runs fully standalone — you can connect to a local iMessage database, bring your own gRPC endpoints, or build your own platform provider. See the [docs](https://docs.photon.codes) for self-hosted setups.
+Spectrum also runs fully standalone — you can connect to a local iMessage database with the separate [`@spectrum-ts/imessage-local`](https://npmjs.com/package/@spectrum-ts/imessage-local) package, bring your own gRPC endpoints, or build your own platform provider. See the [docs](https://docs.photon.codes) for self-hosted setups.
 
 ## Documentation
 
@@ -63,13 +63,14 @@ Visit **[docs.photon.codes](https://docs.photon.codes)** to view the full docume
 | Platform | Package |
 |----------|---------|
 | iMessage | [`@spectrum-ts/imessage`](https://npmjs.com/package/@spectrum-ts/imessage) |
+| Local iMessage | [`@spectrum-ts/imessage-local`](https://npmjs.com/package/@spectrum-ts/imessage-local) (explicit install only) |
 | WhatsApp Business | [`@spectrum-ts/whatsapp-business`](https://npmjs.com/package/@spectrum-ts/whatsapp-business) |
 | Telegram | [`@spectrum-ts/telegram`](https://npmjs.com/package/@spectrum-ts/telegram) |
 | Slack | [`@spectrum-ts/slack`](https://npmjs.com/package/@spectrum-ts/slack) |
 | Terminal | [`@spectrum-ts/terminal`](https://npmjs.com/package/@spectrum-ts/terminal) |
 | Custom   | `definePlatform` from `spectrum-ts` |
 
-`bun add spectrum-ts` is batteries-included (all providers). For a smaller install, depend on the runtime plus only the providers you use — `bun add @spectrum-ts/core @spectrum-ts/telegram` — and import from the scoped packages directly. Either way the `spectrum-ts/providers/<platform>` import paths work as long as the matching provider package is installed; if it isn't, the import fails at build/startup naming the exact package to add.
+`bun add spectrum-ts` is batteries-included (the standard provider set; local iMessage is an explicit install). For a smaller install, depend on the runtime plus only the providers you use — `bun add @spectrum-ts/core @spectrum-ts/telegram` — and import from the scoped packages directly. Either way the `spectrum-ts/providers/<platform>` import paths work as long as the matching provider package is installed; if it isn't, the import fails at build/startup naming the exact package to add.
 
 ## Issues
 

package/dist/{attachment-ChqzKngn.d.ts → attachment-CxF8ejPo.d.ts}

@@ -594,6 +594,14 @@ declare const editSchema: z.ZodObject<{
   content: z.ZodCustom<{
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -637,20 +645,39 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -680,33 +707,6 @@ declare const editSchema: z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -751,6 +751,14 @@ declare const editSchema: z.ZodObject<{
   }, {
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -794,20 +802,39 @@ declare const editSchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -837,33 +864,6 @@ declare const editSchema: z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -1138,6 +1138,14 @@ declare const replySchema: z.ZodObject<{
   content: z.ZodCustom<{
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -1181,20 +1189,39 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1224,33 +1251,6 @@ declare const replySchema: z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -1295,6 +1295,14 @@ declare const replySchema: z.ZodObject<{
   }, {
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -1338,20 +1346,39 @@ declare const replySchema: z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -1381,33 +1408,6 @@ declare const replySchema: z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -6872,24 +6872,28 @@ interface SpectrumOptions {
    */
   logLevel?: LogLevel;
 }
-declare function Spectrum<const Providers extends PlatformProviderConfig[]>(options: {
-  projectId: string;
-  projectSecret: string;
+type PlatformSelection<Providers extends PlatformProviderConfig[]> = {
+  platforms: [...Providers];
+  providers?: never;
+} | {
+  platforms?: never;
   providers: [...Providers];
+};
+type SpectrumFactoryOptions<Providers extends PlatformProviderConfig[]> = PlatformSelection<Providers> & {
   options?: SpectrumOptions;
   telemetry?: boolean;
   webhookSecret?: string;
-}): Promise<SpectrumInstance<Providers> & {
+};
+declare function Spectrum<const Providers extends PlatformProviderConfig[]>(options: {
+  projectId: string;
+  projectSecret: string;
+} & SpectrumFactoryOptions<Providers>): Promise<SpectrumInstance<Providers> & {
   readonly config: ProjectData;
 }>;
 declare function Spectrum<const Providers extends PlatformProviderConfig[]>(options: {
   projectId?: never;
   projectSecret?: never;
-  providers: [...Providers];
-  options?: SpectrumOptions;
-  telemetry?: boolean;
-  webhookSecret?: string;
-}): Promise<SpectrumInstance<Providers>>;
+} & SpectrumFactoryOptions<Providers>): Promise<SpectrumInstance<Providers>>;
 //#endregion
 //#region src/utils/errors.d.ts
 type UnsupportedKind = "content" | "action";
@@ -7276,6 +7280,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   content: z.ZodCustom<{
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -7319,20 +7331,39 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7362,33 +7393,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -7433,6 +7437,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, {
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -7476,20 +7488,39 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7519,33 +7550,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -7594,6 +7598,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   content: z.ZodCustom<{
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -7637,20 +7649,39 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7680,33 +7711,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {
@@ -7751,6 +7755,14 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, {
     type: "custom";
     raw: unknown;
+  } | {
+    type: "attachment";
+    id: string;
+    name: string;
+    mimeType: string;
+    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    size?: number | undefined;
   } | {
     type: "contact";
     user?: {
@@ -7794,20 +7806,39 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
     } | undefined;
     raw?: unknown;
-  } | {
-    type: "attachment";
-    id: string;
-    name: string;
-    mimeType: string;
-    read: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
-    stream: z.core.$InferOuterFunctionType<z.ZodTuple<readonly [], null>, z.ZodPromise<z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
-    size?: number | undefined;
   } | {
     type: "text";
     text: string;
   } | {
     type: "markdown";
     markdown: string;
+  } | {
+    type: "group";
+    items: Message<string, User, Space<unknown>>[];
+  } | {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
+    type: "poll";
+    title: string;
+    options: {
+      title: string;
+    }[];
+  } | {
+    type: "poll_option";
+    option: {
+      title: string;
+    };
+    poll: {
+      type: "poll";
+      title: string;
+      options: {
+        title: string;
+      }[];
+    };
+    selected: boolean;
+    title: string;
   } | {
     type: "streamText";
     stream: () => AsyncIterable<string>;
@@ -7837,33 +7868,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     live?: boolean | undefined;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
-  } | {
-    type: "group";
-    items: Message<string, User, Space<unknown>>[];
-  } | {
-    type: "poll";
-    title: string;
-    options: {
-      title: string;
-    }[];
-  } | {
-    type: "poll_option";
-    option: {
-      title: string;
-    };
-    poll: {
-      type: "poll";
-      title: string;
-      options: {
-        title: string;
-      }[];
-    };
-    selected: boolean;
-    title: string;
   } | {
     type: "effect";
     content: {

package/dist/authoring.d.ts

@@ -1,4 +1,4 @@
-import { At as asReply, Cn as asCustom, Ct as asText, Et as asRichlink, Ft as renameSchema, H as ProviderMessageRecord, Hn as PhotoInput, Jt as asMarkdown, Lt as asRead, Mt as replySchema, Nn as asContact, Sn as reactionSchema, U as ProviderUserRecord, Un as buildPhotoAction, Ut as asPoll, Vn as avatarSchema, Wn as photoActionSchema, Wt as asPollOption, _n as removeMemberSchema, _t as asVoice, bn as asReaction, hn as leaveSpaceSchema, pn as addMemberSchema, q as ManagedStream, r as asAttachment, rn as groupSchema, tn as asGroup } from "./attachment-ChqzKngn.js";
+import { At as asReply, Cn as asCustom, Ct as asText, Et as asRichlink, Ft as renameSchema, H as ProviderMessageRecord, Hn as PhotoInput, Jt as asMarkdown, Lt as asRead, Mt as replySchema, Nn as asContact, Sn as reactionSchema, U as ProviderUserRecord, Un as buildPhotoAction, Ut as asPoll, Vn as avatarSchema, Wn as photoActionSchema, Wt as asPollOption, _n as removeMemberSchema, _t as asVoice, bn as asReaction, hn as leaveSpaceSchema, pn as addMemberSchema, q as ManagedStream, r as asAttachment, rn as groupSchema, tn as asGroup } from "./attachment-CxF8ejPo.js";
 import z from "zod";
 import { FetchSpanOptions, LogAttrs, LogAttrs as LogAttrs$1, LogLevel, PhotonLogger, SanitizeUrlOptions, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { Token } from "marked";

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as DedicatedTokenData, $t as TextStreamOptions, A as isFusorEvent, An as ContactName, B as PlatformUser, Bn as avatar, Bt as PollChoice, C as FusorVerify, D as WebhookRawResult, Dn as ContactDetails, Dt as richlink, E as WebhookRawRequest, En as ContactAddress, F as PlatformInstance, Fn as AgentSender, G as SpaceNamespace, Gn as App, Gt as option, Ht as PollOption, I as PlatformMessage, In as User, It as Read, J as broadcast, Jn as AppUrl, K as Broadcaster, Kn as AppLayout, Kt as poll, L as PlatformProviderConfig, Ln as Avatar, M as EventProducer, Mn as ContactPhone, N as Platform, Nt as Rename, O as FusorEvent, On as ContactEmail, Ot as resolveContents, P as PlatformDef, Pn as contact, Pt as rename, Q as CloudPlatform, Qt as StreamTextSource, R as PlatformRuntime, Rn as AvatarData, Rt as read, S as FusorRespond, St as typing, T as WebhookHandler, Tn as Contact, Tt as Richlink, V as ProviderMessage, Vt as PollChoiceInput, W as SchemaMessage, X as stream, Xn as appLayoutSchema, Xt as DeltaExtractor, Y as mergeStreams, Yn as app, Yt as markdown, Z as Store, Zt as StreamText, _ as FusorClient, a as Content, an as edit, at as ProjectProfile, b as FusorMessagesReturn, bt as unsend, c as fromVCard, cn as AddMember, ct as SlackTokenData, d as UnsupportedKind, dn as RemoveMember, dt as SubscriptionStatus, en as Group, et as FusorTokenData, f as Spectrum, fn as addMember, ft as TokenData, g as isFusorClient, gn as removeMember, gt as Voice, h as fusor, ht as EmojiKey, i as attachment, in as Edit, it as ProjectData, j as AnyPlatformDef, jn as ContactOrg, jt as reply, k as fusorEvent, kn as ContactInput, kt as Reply, l as toVCard, ln as LeaveSpace, lt as SpectrumCloudError, m as definePlatform, mn as leaveSpace, mt as Emoji, n as AttachmentInput, nn as group, nt as PlatformStatus, o as ContentBuilder, on as Message, ot as SharedTokenData, p as SpectrumInstance, pt as cloud, q as ManagedStream, qn as AppOptions, qt as Markdown, rt as PlatformsData, s as ContentInput, sn as Space, st as SlackTeamMeta, t as Attachment, tt as ImessageInfoData, u as UnsupportedError, un as MemberInput, ut as SubscriptionData, v as FusorMessages, vn as Reaction, vt as voice, w as FusorVerifyRequest, wn as custom, wt as text, x as FusorReply, xn as reaction, xt as Typing, y as FusorMessagesCtx, yn as ReactionBuilder, yt as Unsend, z as PlatformSpace, zn as AvatarInput, zt as Poll } from "./attachment-ChqzKngn.js";
+import { $ as DedicatedTokenData, $t as TextStreamOptions, A as isFusorEvent, An as ContactName, B as PlatformUser, Bn as avatar, Bt as PollChoice, C as FusorVerify, D as WebhookRawResult, Dn as ContactDetails, Dt as richlink, E as WebhookRawRequest, En as ContactAddress, F as PlatformInstance, Fn as AgentSender, G as SpaceNamespace, Gn as App, Gt as option, Ht as PollOption, I as PlatformMessage, In as User, It as Read, J as broadcast, Jn as AppUrl, K as Broadcaster, Kn as AppLayout, Kt as poll, L as PlatformProviderConfig, Ln as Avatar, M as EventProducer, Mn as ContactPhone, N as Platform, Nt as Rename, O as FusorEvent, On as ContactEmail, Ot as resolveContents, P as PlatformDef, Pn as contact, Pt as rename, Q as CloudPlatform, Qt as StreamTextSource, R as PlatformRuntime, Rn as AvatarData, Rt as read, S as FusorRespond, St as typing, T as WebhookHandler, Tn as Contact, Tt as Richlink, V as ProviderMessage, Vt as PollChoiceInput, W as SchemaMessage, X as stream, Xn as appLayoutSchema, Xt as DeltaExtractor, Y as mergeStreams, Yn as app, Yt as markdown, Z as Store, Zt as StreamText, _ as FusorClient, a as Content, an as edit, at as ProjectProfile, b as FusorMessagesReturn, bt as unsend, c as fromVCard, cn as AddMember, ct as SlackTokenData, d as UnsupportedKind, dn as RemoveMember, dt as SubscriptionStatus, en as Group, et as FusorTokenData, f as Spectrum, fn as addMember, ft as TokenData, g as isFusorClient, gn as removeMember, gt as Voice, h as fusor, ht as EmojiKey, i as attachment, in as Edit, it as ProjectData, j as AnyPlatformDef, jn as ContactOrg, jt as reply, k as fusorEvent, kn as ContactInput, kt as Reply, l as toVCard, ln as LeaveSpace, lt as SpectrumCloudError, m as definePlatform, mn as leaveSpace, mt as Emoji, n as AttachmentInput, nn as group, nt as PlatformStatus, o as ContentBuilder, on as Message, ot as SharedTokenData, p as SpectrumInstance, pt as cloud, q as ManagedStream, qn as AppOptions, qt as Markdown, rt as PlatformsData, s as ContentInput, sn as Space, st as SlackTeamMeta, t as Attachment, tt as ImessageInfoData, u as UnsupportedError, un as MemberInput, ut as SubscriptionData, v as FusorMessages, vn as Reaction, vt as voice, w as FusorVerifyRequest, wn as custom, wt as text, x as FusorReply, xn as reaction, xt as Typing, y as FusorMessagesCtx, yn as ReactionBuilder, yt as Unsend, z as PlatformSpace, zn as AvatarInput, zt as Poll } from "./attachment-CxF8ejPo.js";
 export { type AddMember, type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppOptions, type AppUrl, type Attachment, type AttachmentInput, type Avatar, type AvatarData, type AvatarInput, type Broadcaster, type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, type Content, type ContentBuilder, type ContentInput, type DedicatedTokenData, type DeltaExtractor, type Edit, Emoji, type EmojiKey, type EventProducer, type FusorClient, type FusorEvent, type FusorMessages, type FusorMessagesCtx, type FusorMessagesReturn, type FusorReply, type FusorRespond, type FusorTokenData, type FusorVerify, type FusorVerifyRequest, type Group, type ImessageInfoData, type LeaveSpace, type ManagedStream, type Markdown, type MemberInput, type Message, type Platform, type PlatformDef, type PlatformInstance, type PlatformMessage, type PlatformProviderConfig, type PlatformRuntime, type PlatformSpace, type PlatformStatus, type PlatformUser, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type ProjectData, type ProjectProfile, type ProviderMessage, type Reaction, type ReactionBuilder, type Read, type RemoveMember, type Rename, type Reply, type Richlink, type SchemaMessage, type SharedTokenData, type SlackTeamMeta, type SlackTokenData, type Space, type SpaceNamespace, Spectrum, SpectrumCloudError, type SpectrumInstance, type Store, type StreamText, type StreamTextSource, type SubscriptionData, type SubscriptionStatus, type TextStreamOptions, type TokenData, type Typing, type Unsend, UnsupportedError, type UnsupportedKind, type User, type Voice, type WebhookHandler, type WebhookRawRequest, type WebhookRawResult, addMember, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, leaveSpace, markdown, mergeStreams, option, poll, reaction, read, removeMember, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };

package/dist/index.js

@@ -3051,7 +3051,7 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "9.3.1";
+const SPECTRUM_SDK_VERSION = "10.0.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {
@@ -3073,7 +3073,7 @@ const installCommand = (pkg) => process.versions.bun ? `bun add ${pkg}` : `npm i
 const officialProviderInstallHint = (platform) => {
 	const pkg = officialProviderPackage(platform);
 	if (!pkg) return;
-	return `the "${platform}" platform is provided by the optional package ${pkg} — install it (\`${installCommand(pkg)}\`) and pass it to Spectrum({ providers: [...] })`;
+	return `the "${platform}" platform is provided by the optional package ${pkg} — install it (\`${installCommand(pkg)}\`) and pass it to Spectrum({ platforms: [...] })`;
 };
 //#endregion
 //#region src/utils/cloud.ts
@@ -4058,18 +4058,20 @@ const spectrumOptionsSchema = z.object({
 const spectrumConfigSchema = z.union([z.object({
 	projectId: z.string().min(1),
 	projectSecret: z.string().min(1),
-	providers: z.array(z.custom()),
+	providers: z.array(z.custom()).optional(),
+	platforms: z.array(z.custom()).optional(),
 	options: spectrumOptionsSchema,
 	telemetry: z.boolean().optional(),
 	webhookSecret: z.string().min(1).optional()
 }), z.object({
 	projectId: z.undefined().optional(),
 	projectSecret: z.undefined().optional(),
-	providers: z.array(z.custom()),
+	providers: z.array(z.custom()).optional(),
+	platforms: z.array(z.custom()).optional(),
 	options: spectrumOptionsSchema,
 	telemetry: z.boolean().optional(),
 	webhookSecret: z.string().min(1).optional()
-})]);
+})]).refine((config) => config.providers === void 0 !== (config.platforms === void 0), "Spectrum requires exactly one of platforms or providers");
 function bootstrapTelemetry(opts) {
 	const headers = {};
 	if (opts.projectId && opts.projectSecret) {
@@ -4101,6 +4103,11 @@ function resolveProjectCredentials(options) {
 		projectSecret: options.projectSecret ?? envValue(envFor("PROJECT", "SECRET"))
 	};
 }
+const resolveConfiguredProviders = (options) => {
+	const configuredProviders = options.platforms ?? options.providers;
+	if (!configuredProviders) throw new Error("Spectrum requires platforms or providers");
+	return configuredProviders;
+};
 async function Spectrum(options) {
 	const { projectId, projectSecret } = resolveProjectCredentials(options);
 	spectrumConfigSchema.parse({
@@ -4108,7 +4115,8 @@ async function Spectrum(options) {
 		projectId,
 		projectSecret
 	});
-	const { providers, options: runtimeOptions, telemetry, webhookSecret } = options;
+	const providers = resolveConfiguredProviders(options);
+	const { options: runtimeOptions, telemetry, webhookSecret } = options;
 	const flattenGroups = runtimeOptions?.flattenGroups ?? false;
 	applyLogLevel(runtimeOptions?.logLevel);
 	const resolvedWebhookSecret = webhookSecret ?? process.env[envFor("WEBHOOK", "SECRET")];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrum-ts/core",
-  "version": "9.3.1",
+  "version": "10.0.0",
   "description": "The spectrum-ts runtime — Spectrum, content builders, fusor, and the provider authoring API.",
   "repository": {
     "type": "git",