spectrum-ts 1.1.1 → 1.2.0

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

@@ -3,7 +3,7 @@ import {
   cloud,
   mergeStreams,
   stream
-} from "../../chunk-PXX7ISZ6.js";
+} from "../../chunk-FF2R4EP3.js";
 import {
   UnsupportedError,
   asAttachment,
@@ -12,7 +12,7 @@ import {
   asReaction,
   asText,
   definePlatform
-} from "../../chunk-7D6FHYKT.js";
+} from "../../chunk-UQPIWAHH.js";
 
 // src/providers/whatsapp-business/index.ts
 import { createClient as createClient2 } from "@photon-ai/whatsapp-business";
@@ -266,8 +266,11 @@ var primary = (clients) => {
   }
   return client;
 };
-var toSendResult = (result) => ({
-  id: result.messageId
+var toRecord = (result, spaceId, content) => ({
+  id: result.messageId,
+  content,
+  space: { id: spaceId },
+  timestamp: /* @__PURE__ */ new Date()
 });
 var MAX_POLL_CACHE_SIZE = 1e3;
 var OPTION_ID_PREFIX = "opt_";
@@ -622,8 +625,10 @@ var send = async (clients, spaceId, content) => {
   const client = primary(clients);
   switch (content.type) {
     case "text":
-      return toSendResult(
-        await client.messages.send({ to: spaceId, text: content.text })
+      return toRecord(
+        await client.messages.send({ to: spaceId, text: content.text }),
+        spaceId,
+        content
       );
     case "attachment": {
       const { mediaId } = await client.media.upload({
@@ -633,19 +638,23 @@ var send = async (clients, spaceId, content) => {
       });
       const mediaType = mimeToMediaType(content.mimeType);
       const mediaPayload = mediaType === "document" ? { id: mediaId, filename: content.name } : { id: mediaId };
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           [mediaType]: mediaPayload
-        })
+        }),
+        spaceId,
+        content
       );
     }
     case "contact":
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           contacts: [contactToWa(content)]
-        })
+        }),
+        spaceId,
+        content
       );
     case "voice": {
       const { mediaId } = await client.media.upload({
@@ -653,11 +662,13 @@ var send = async (clients, spaceId, content) => {
         mimeType: content.mimeType,
         filename: voiceFilename(content)
       });
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           audio: { id: mediaId }
-        })
+        }),
+        spaceId,
+        content
       );
     }
     case "poll": {
@@ -666,7 +677,7 @@ var send = async (clients, spaceId, content) => {
         interactive: pollToInteractive(content)
       });
       cachePoll(client, result.messageId, content);
-      return toSendResult(result);
+      return toRecord(result, spaceId, content);
     }
     default:
       throw UnsupportedError.content(content.type);
@@ -682,12 +693,14 @@ var replyToMessage = async (clients, spaceId, messageId, content) => {
   const client = primary(clients);
   switch (content.type) {
     case "text":
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           replyTo: messageId,
           text: content.text
-        })
+        }),
+        spaceId,
+        content
       );
     case "attachment": {
       const { mediaId } = await client.media.upload({
@@ -697,21 +710,25 @@ var replyToMessage = async (clients, spaceId, messageId, content) => {
       });
       const mediaType = mimeToMediaType(content.mimeType);
       const mediaPayload = mediaType === "document" ? { id: mediaId, filename: content.name } : { id: mediaId };
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           replyTo: messageId,
           [mediaType]: mediaPayload
-        })
+        }),
+        spaceId,
+        content
       );
     }
     case "contact":
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           replyTo: messageId,
           contacts: [contactToWa(content)]
-        })
+        }),
+        spaceId,
+        content
       );
     case "voice": {
       const { mediaId } = await client.media.upload({
@@ -719,12 +736,14 @@ var replyToMessage = async (clients, spaceId, messageId, content) => {
         mimeType: content.mimeType,
         filename: voiceFilename(content)
       });
-      return toSendResult(
+      return toRecord(
         await client.messages.send({
           to: spaceId,
           replyTo: messageId,
           audio: { id: mediaId }
-        })
+        }),
+        spaceId,
+        content
       );
     }
     case "poll": {
@@ -734,7 +753,7 @@ var replyToMessage = async (clients, spaceId, messageId, content) => {
         interactive: pollToInteractive(content)
       });
       cachePoll(client, result.messageId, content);
-      return toSendResult(result);
+      return toRecord(result, spaceId, content);
     }
     default:
       throw UnsupportedError.content(content.type);

package/dist/{types-BZhWdyLk.d.ts → types-Dvp0I86h.d.ts}

@@ -115,6 +115,20 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
     }, z__default.core.$strip>;
     selected: z__default.ZodBoolean;
     title: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"effect">;
+    content: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+        type: z__default.ZodLiteral<"text">;
+        text: z__default.ZodString;
+    }, z__default.core.$strip>, z__default.ZodObject<{
+        type: z__default.ZodLiteral<"attachment">;
+        name: z__default.ZodString;
+        mimeType: z__default.ZodString;
+        size: z__default.ZodOptional<z__default.ZodNumber>;
+        read: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
+        stream: z__default.ZodFunction<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
+    }, z__default.core.$strip>], "type">;
+    effect: z__default.ZodString;
 }, z__default.core.$strip>], "type">;
 type Content = z__default.infer<typeof contentSchema>;
 interface ContentBuilder {
@@ -166,6 +180,18 @@ interface OutboundMessage<TPlatform extends string = string, TSender extends Use
 }
 type Message<TPlatform extends string = string, TSender extends User = User, TSpace extends Space = Space> = InboundMessage<TPlatform, TSender, TSpace> | OutboundMessage<TPlatform, TSender, TSpace>;
 
+interface ManagedStream<T> extends AsyncIterable<T> {
+    close(): Promise<void>;
+}
+type StreamCleanup = void | (() => void | Promise<void>);
+declare function stream<T>(setup: (emit: (value: T) => Promise<void>, end: (error?: unknown) => void) => StreamCleanup | Promise<StreamCleanup>): ManagedStream<T>;
+declare function mergeStreams<T>(streams: readonly ManagedStream<T>[]): ManagedStream<T>;
+interface Broadcaster<T> {
+    close(): Promise<void>;
+    subscribe(): ManagedStream<T>;
+}
+declare function broadcast<T>(source: ManagedStream<T>): Broadcaster<T>;
+
 type ResolvedSpace = Pick<Space, "id">;
 type SpaceRef = Pick<Space, "id" | "__platform">;
 type ResolvedUser = Pick<User, "id">;
@@ -187,19 +213,28 @@ type ProviderMessage<TSender extends ResolvedUser = ResolvedUser, TSpace extends
     space: TSpace;
     timestamp?: Date;
 } & TExtra;
-interface SendResult<TSender extends ResolvedUser = ResolvedUser> {
-    /**
-     * Per-item send receipts returned when the dispatched content was a
-     * `group`. Providers that iterate native sends to emulate a group
-     * (e.g. iMessage) populate this so the platform build layer can
-     * replace the outbound group's placeholder items with real Messages
-     * that carry each item's own id.
-     */
-    groupMembers?: SendResult<TSender>[];
+/**
+ * A message a provider produced — used for both inbound (`events.messages`,
+ * `getMessage`) and outbound (`send`, `replyToMessage`) flows. Providers
+ * return their native record shape (including platform extras like
+ * `partIndex`/`parentId` for iMessage) and the platform `wrapProviderMessage`
+ * pipeline turns it into a fully-built Message.
+ *
+ * `sender` is optional because outbound sends often can't synthesize one
+ * (the SDK doesn't surface the bot's own handle); inbound providers are
+ * expected to populate it.
+ */
+type ProviderMessageRecord = {
     id: string;
-    sender?: TSender;
+    content: Content;
+    sender?: {
+        id: string;
+    } & Record<string, unknown>;
+    space: {
+        id: string;
+    } & Record<string, unknown>;
     timestamp?: Date;
-}
+} & Record<string, unknown>;
 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;
@@ -215,7 +250,7 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             content: Content;
             client: _Client;
             config: z__default.infer<_ConfigSchema>;
-        }) => Promise<SendResult<_ResolvedUser>>;
+        }) => Promise<ProviderMessageRecord>;
         startTyping?: (_: {
             space: _ResolvedSpace & SpaceRef;
             client: _Client;
@@ -240,7 +275,7 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
             content: Content;
             client: _Client;
             config: z__default.infer<_ConfigSchema>;
-        }) => Promise<SendResult<_ResolvedUser>>;
+        }) => Promise<ProviderMessageRecord>;
         editMessage?: (_: {
             space: _ResolvedSpace & SpaceRef;
             messageId: string;
@@ -298,11 +333,11 @@ interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__de
 }
 interface AnyPlatformDef {
     actions: {
-        send: (_: any) => Promise<SendResult>;
+        send: (_: any) => Promise<ProviderMessageRecord>;
         startTyping?: (_: any) => Promise<void>;
         stopTyping?: (_: any) => Promise<void>;
         reactToMessage?: (_: any) => Promise<void>;
-        replyToMessage?: (_: any) => Promise<SendResult>;
+        replyToMessage?: (_: any) => Promise<ProviderMessageRecord>;
         editMessage?: (_: any) => Promise<void>;
         getMessage?: (_: any) => Promise<any>;
     };
@@ -380,28 +415,38 @@ type SpaceVarargArgs<Def extends AnyPlatformDef> = [
 type SpaceArgs<Def extends AnyPlatformDef> = SpaceArrayArgs<Def> | SpaceVarargArgs<Def>;
 type PlatformSpace<Def extends AnyPlatformDef> = Omit<SpaceShapeOf<Def>, keyof Space> & Space;
 type PlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof Message> & Message<Def["name"], PlatformUser<Def>, PlatformSpace<Def>>;
+type InboundPlatformMessage<Def extends AnyPlatformDef> = Omit<SchemaInfer<Def["message"]>, keyof InboundMessage> & InboundMessage<Def["name"], PlatformUser<Def>, PlatformSpace<Def>>;
 type PlatformUser<Def extends AnyPlatformDef> = Omit<ResolvedUserOf<Def>, keyof User> & User;
 type PlatformInstance<Def extends AnyPlatformDef> = {
+    readonly messages: AsyncIterable<[
+        PlatformSpace<Def>,
+        InboundPlatformMessage<Def>
+    ]>;
     space(...args: SpaceArgs<Def>): Promise<PlatformSpace<Def>>;
     user(userID: string): Promise<PlatformUser<Def>>;
 } & {
     [K in Exclude<keyof Def["events"], "messages" | symbol | number> as K extends ReservedNames ? never : K]: AsyncIterable<InferEventPayload<Def["events"][K]>>;
 };
+interface PlatformRuntime {
+    client: unknown;
+    config: unknown;
+    definition: AnyPlatformDef;
+    subscribeMessages: () => ManagedStream<[Space, InboundMessage]>;
+}
 interface SpectrumLike<Providers extends PlatformProviderConfig[] = PlatformProviderConfig[]> {
     readonly __internal: {
-        platforms: Map<string, {
-            client: unknown;
-            config: unknown;
-            definition: AnyPlatformDef;
-        }>;
+        platforms: Map<string, PlatformRuntime>;
     };
     readonly __providers: Providers;
 }
 interface Platform<Def extends AnyPlatformDef> {
     config(...args: Record<string, never> extends z__default.input<Def["config"]> ? [config?: z__default.input<Def["config"]>] : [config: z__default.input<Def["config"]>]): PlatformProviderConfig<Def>;
+    is(input: Message): input is PlatformMessage<Def>;
+    is(input: Space): input is PlatformSpace<Def>;
+    is(input: unknown): input is PlatformMessage<Def> | PlatformSpace<Def>;
     <Providers extends PlatformProviderConfig[]>(spectrum: SpectrumLike<Providers>): HasProvider<Providers, Def["name"]> extends true ? PlatformInstance<Def> : never;
     (space: Space): PlatformSpace<Def>;
     (message: Message): PlatformMessage<Def>;
 }
 
-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 };
+export { type AnyPlatformDef as A, type Broadcaster as B, type ContentBuilder as C, type EventProducer as E, type InboundMessage as I, type Message as M, type OutboundMessage as O, type ProviderMessage as P, type SpectrumLike as S, type User as U, type ContentInput as a, type Content as b, type PlatformDef as c, type Platform as d, type PlatformProviderConfig as e, type CustomEventStreams as f, type Space as g, type InboundPlatformMessage as h, type ManagedStream as i, type PlatformInstance as j, type PlatformMessage as k, type PlatformRuntime as l, type PlatformSpace as m, type PlatformUser as n, type SchemaMessage as o, broadcast as p, mergeStreams as q, stream as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -19,7 +19,7 @@
     }
   },
   "dependencies": {
-    "@photon-ai/advanced-imessage": "^0.5.1",
+    "@photon-ai/advanced-imessage": "^0.6.0",
     "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@repeaterjs/repeater": "^3.0.6",

package/dist/stream-B55k7W8-.d.ts

@@ -1,8 +0,0 @@
-interface ManagedStream<T> extends AsyncIterable<T> {
-    close(): Promise<void>;
-}
-type StreamCleanup = void | (() => void | Promise<void>);
-declare function stream<T>(setup: (emit: (value: T) => Promise<void>, end: (error?: unknown) => void) => StreamCleanup | Promise<StreamCleanup>): ManagedStream<T>;
-declare function mergeStreams<T>(streams: readonly ManagedStream<T>[]): ManagedStream<T>;
-
-export { type ManagedStream as M, mergeStreams as m, stream as s };