spectrum-ts 1.2.1 → 1.4.0

package/dist/{chunk-K3CTEGCZ.js → chunk-66GJ45ZZ.js}

@@ -3,7 +3,7 @@ import {
   readSchema,
   resolveContents,
   streamSchema
-} from "./chunk-UQPIWAHH.js";
+} from "./chunk-LH4YEBG3.js";
 
 // src/content/group.ts
 import z from "zod";

package/dist/{chunk-I7EKZS5C.js → chunk-B4MHPWPZ.js}

@@ -2,7 +2,7 @@ import {
   bufferToStream,
   readSchema,
   streamSchema
-} from "./chunk-UQPIWAHH.js";
+} from "./chunk-LH4YEBG3.js";
 
 // src/content/voice.ts
 import { createReadStream } from "fs";

package/dist/{chunk-UQPIWAHH.js → chunk-LH4YEBG3.js}

@@ -720,7 +720,8 @@ function wrapProviderMessage(raw, ctx, direction) {
     space: ctx.space,
     definition: ctx.definition,
     client: ctx.client,
-    config: ctx.config
+    config: ctx.config,
+    store: ctx.store
   };
   if (direction === "inbound") {
     if (!raw.sender) {
@@ -763,7 +764,7 @@ var isRawProviderRecord = (v) => {
   return "id" in record && "content" in record && typeof record.react !== "function" && typeof record.reply !== "function";
 };
 function buildSpace(params) {
-  const { spaceRef, extras, typingCtx, definition, client, config } = params;
+  const { spaceRef, extras, typingCtx, definition, client, config, store } = params;
   let space;
   async function dispatchReaction(item) {
     try {
@@ -775,7 +776,8 @@ function buildSpace(params) {
         target: item.target,
         reaction: item.emoji,
         client,
-        config
+        config,
+        store
       });
     } catch (err) {
       if (err instanceof UnsupportedError) {
@@ -813,7 +815,7 @@ function buildSpace(params) {
     }
     return wrapProviderMessage(
       raw,
-      { client, config, definition, space, spaceRef },
+      { client, config, definition, space, spaceRef, store },
       "outbound"
     );
   }
@@ -849,7 +851,8 @@ function buildSpace(params) {
         space: spaceRef,
         messageId: id,
         client,
-        config
+        config,
+        store
       });
     } catch (err) {
       if (err instanceof UnsupportedError) {
@@ -863,7 +866,7 @@ function buildSpace(params) {
     }
     return wrapProviderMessage(
       raw,
-      { client, config, definition, space, spaceRef },
+      { client, config, definition, space, spaceRef, store },
       "inbound"
     );
   }
@@ -894,7 +897,7 @@ function buildSpace(params) {
   return space;
 }
 function buildMessage(params) {
-  const { definition, client, config, spaceRef, space } = params;
+  const { definition, client, config, spaceRef, space, store } = params;
   let self;
   const react = async (reaction2) => {
     if (!definition.actions.reactToMessage) {
@@ -915,7 +918,8 @@ function buildMessage(params) {
         target: self,
         reaction: reaction2,
         client,
-        config
+        config,
+        store
       });
     } catch (err) {
       if (err instanceof UnsupportedError) {
@@ -949,7 +953,8 @@ function buildMessage(params) {
         target,
         content: item,
         client,
-        config
+        config,
+        store
       });
     } catch (err) {
       if (err instanceof UnsupportedError) {
@@ -965,7 +970,7 @@ function buildMessage(params) {
     }
     return wrapProviderMessage(
       raw,
-      { client, config, definition, space, spaceRef },
+      { client, config, definition, space, spaceRef, store },
       "outbound"
     );
   };
@@ -1028,7 +1033,8 @@ function buildMessage(params) {
             messageId: params.id,
             content: resolved,
             client,
-            config
+            config,
+            store
           });
         } catch (err) {
           if (err instanceof UnsupportedError) {
@@ -1070,7 +1076,8 @@ function createPlatformInstance(def, runtime) {
     const resolved = await def.user.resolve({
       input: { userID },
       client: runtime.client,
-      config: runtime.config
+      config: runtime.config,
+      store: runtime.store
     });
     return {
       ...resolved,
@@ -1123,7 +1130,8 @@ function createPlatformInstance(def, runtime) {
       const resolved = await def.user.resolve({
         input: { userID },
         client: runtime.client,
-        config: runtime.config
+        config: runtime.config,
+        store: runtime.store
       });
       return {
         ...resolved,
@@ -1140,17 +1148,20 @@ function createPlatformInstance(def, runtime) {
       const resolved = await def.space.resolve({
         input: { users, params: parsedParams },
         client: runtime.client,
-        config: runtime.config
+        config: runtime.config,
+        store: runtime.store
       });
       const parsedSpace = def.space.schema ? def.space.schema.parse(resolved) : resolved;
       const spaceRef = {
+        ...parsedSpace,
         id: parsedSpace.id,
         __platform: def.name
       };
       const typingCtx = {
         space: spaceRef,
         client: runtime.client,
-        config: runtime.config
+        config: runtime.config,
+        store: runtime.store
       };
       return buildSpace({
         spaceRef,
@@ -1158,7 +1169,8 @@ function createPlatformInstance(def, runtime) {
         typingCtx,
         definition: def,
         client: runtime.client,
-        config: runtime.config
+        config: runtime.config,
+        store: runtime.store
       });
     }
   };
@@ -1171,7 +1183,8 @@ function createPlatformInstance(def, runtime) {
     if (producer) {
       eventProperties[eventName] = producer({
         client: runtime.client,
-        config: runtime.config
+        config: runtime.config,
+        store: runtime.store
       });
     }
   }

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as ContentBuilder, U as User, M as Message, a as ContentInput, b as Content, P as ProviderMessage, c as PlatformDef, d as Platform, e as PlatformProviderConfig, S as SpectrumLike, f as CustomEventStreams, g as Space, I as InboundMessage, O as OutboundMessage } from './types-Dvp0I86h.js';
-export { A as AnyPlatformDef, B as Broadcaster, E as EventProducer, h as InboundPlatformMessage, i as ManagedStream, j as PlatformInstance, k as PlatformMessage, l as PlatformRuntime, m as PlatformSpace, n as PlatformUser, o as SchemaMessage, p as broadcast, q as mergeStreams, s as stream } from './types-Dvp0I86h.js';
+import { C as ContentBuilder, U as User, M as Message, a as ContentInput, b as Content, P as ProviderMessage, E as EventProducer, c as CreateClientContext, S as Store, d as PlatformDef, e as Platform, f as PlatformProviderConfig, g as SpectrumLike, h as CustomEventStreams, i as Space, I as InboundMessage, O as OutboundMessage } from './types-BcCLW2VO.js';
+export { A as AnyPlatformDef, B as Broadcaster, j as InboundPlatformMessage, k as ManagedStream, l as PlatformInstance, m as PlatformMessage, n as PlatformRuntime, o as PlatformSpace, p as PlatformUser, q as SchemaMessage, r as broadcast, s as mergeStreams, t as stream } from './types-BcCLW2VO.js';
 import vCard from 'vcf';
 import z__default from 'zod';
 import 'hotscript';
@@ -2148,21 +2148,24 @@ declare const Emoji: {
 };
 type EmojiKey = keyof typeof Emoji;
 
+type NoInferValue<T> = [T][T extends unknown ? 0 : never];
 declare function definePlatform<_Name extends string, _ConfigSchema extends z__default.ZodType<object>, _UserSchema extends z__default.ZodType<object> | undefined, _SpaceSchema extends z__default.ZodType<object> | undefined, _SpaceParamsSchema extends z__default.ZodType<object> | undefined, _Client, _ResolvedUser extends {
     id: string;
 }, _ResolvedSpace extends {
     id: string;
 }, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, _MessageSchema extends z__default.ZodType<object> ? z__default.infer<_MessageSchema> : Record<never, never>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, _MessageSchema extends z__default.ZodType<object> ? z__default.infer<_MessageSchema> : Record<never, never>>, _Events extends {
-    messages: (ctx: {
-        client: _Client;
-        config: z__default.infer<_ConfigSchema>;
-    }) => AsyncIterable<_MessageType>;
+    messages: EventProducer<_MessageType, _Client, z__default.infer<_ConfigSchema>>;
 } = {
-    messages: (ctx: {
-        client: _Client;
-        config: z__default.infer<_ConfigSchema>;
-    }) => AsyncIterable<_MessageType>;
-}, _Static extends Record<string, unknown> = Record<never, never>>(name: _Name, def: Omit<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events>, "name"> & {
+    messages: EventProducer<_MessageType, _Client, z__default.infer<_ConfigSchema>>;
+}, _Static extends Record<string, unknown> = Record<never, never>>(name: _Name, def: {
+    lifecycle: {
+        createClient: (ctx: CreateClientContext<_ConfigSchema>) => Promise<_Client>;
+        destroyClient?: (ctx: {
+            client: NoInferValue<_Client>;
+            store: Store;
+        }) => Promise<void>;
+    };
+} & Omit<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events>, "lifecycle" | "name"> & {
     static?: _Static;
 }): Platform<PlatformDef<_Name, _ConfigSchema, _UserSchema, _SpaceSchema, _SpaceParamsSchema, _Client, _ResolvedUser, _ResolvedSpace, _MessageSchema, _MessageType, _Events>> & Readonly<_Static>;
 
@@ -2215,6 +2218,7 @@ interface SharedTokenData {
 interface DedicatedTokenData {
     auth: Record<string, string>;
     expiresIn: number;
+    numbers: Record<string, string | null>;
     type: "dedicated";
 }
 type TokenData = SharedTokenData | DedicatedTokenData;
@@ -2268,4 +2272,4 @@ declare class UnsupportedError extends Error {
 declare const fromVCard: (vcf: string) => ContactInput;
 declare const toVCard: (contact: Contact) => Promise<string>;
 
-export { type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, Emoji, type EmojiKey, type Group, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type Reaction, type Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, fromVCard, group, option, poll, reaction, resolveContents, richlink, text, toVCard, voice };
+export { type CloudPlatform, type Contact, type ContactAddress, type ContactDetails, type ContactEmail, type ContactInput, type ContactName, type ContactOrg, type ContactPhone, Content, ContentBuilder, ContentInput, type DedicatedTokenData, Emoji, type EmojiKey, EventProducer, type Group, type ImessageInfoData, Message, Platform, PlatformDef, PlatformProviderConfig, type PlatformStatus, type PlatformsData, type Poll, type PollChoice, type PollChoiceInput, type PollOption, type Reaction, type Richlink, type SharedTokenData, Space, Spectrum, SpectrumCloudError, type SpectrumInstance, type SubscriptionData, type SubscriptionStatus, type TokenData, UnsupportedError, type UnsupportedKind, User, type Voice, attachment, cloud, contact, custom, definePlatform, fromVCard, group, option, poll, reaction, resolveContents, richlink, text, toVCard, voice };

package/dist/index.js

@@ -1,10 +1,10 @@
 import {
   group,
   richlink
-} from "./chunk-K3CTEGCZ.js";
+} from "./chunk-66GJ45ZZ.js";
 import {
   voice
-} from "./chunk-I7EKZS5C.js";
+} from "./chunk-B4MHPWPZ.js";
 import {
   SpectrumCloudError,
   broadcast,
@@ -27,7 +27,7 @@ import {
   text,
   toVCard,
   wrapProviderMessage
-} from "./chunk-UQPIWAHH.js";
+} from "./chunk-LH4YEBG3.js";
 
 // src/emoji/generated.ts
 var GeneratedEmoji = {
@@ -1960,6 +1960,63 @@ var Emoji = { ...GeneratedEmoji, ...aliases };
 
 // src/spectrum.ts
 import z from "zod";
+
+// src/utils/store.ts
+var isRecordObject = (value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+};
+function createStore() {
+  const data = /* @__PURE__ */ new Map();
+  return {
+    set(key, value) {
+      data.set(key, value);
+    },
+    get(key) {
+      return data.get(key);
+    },
+    has(key) {
+      return data.has(key);
+    },
+    delete(key) {
+      return data.delete(key);
+    },
+    clear() {
+      data.clear();
+    },
+    keys() {
+      return Array.from(data.keys());
+    },
+    string(key) {
+      const v = data.get(key);
+      return typeof v === "string" ? v : void 0;
+    },
+    number(key) {
+      const v = data.get(key);
+      return typeof v === "number" ? v : void 0;
+    },
+    bool(key) {
+      const v = data.get(key);
+      return typeof v === "boolean" ? v : void 0;
+    },
+    object(key) {
+      const v = data.get(key);
+      if (!isRecordObject(v)) {
+        return;
+      }
+      return v;
+    },
+    array(key) {
+      const v = data.get(key);
+      return Array.isArray(v) ? v : void 0;
+    }
+  };
+}
+
+// src/spectrum.ts
 var spectrumOptionsSchema = z.object({
   flattenGroups: z.boolean().optional()
 }).optional();
@@ -2012,10 +2069,11 @@ async function Spectrum(options) {
     });
   };
   const createProviderMessagesStream = (state) => {
-    const { client, config, definition } = state;
+    const { client, config, definition, store } = state;
     const raw = definition.events.messages({
       client,
-      config
+      config,
+      store
     });
     const bindSend = async function* () {
       for await (const msg of raw) {
@@ -2023,14 +2081,15 @@ async function Spectrum(options) {
           ...msg.space,
           __platform: definition.name
         };
-        const typingCtx = { space: spaceRef, client, config };
+        const typingCtx = { space: spaceRef, client, config, store };
         const space = buildSpace({
           spaceRef,
           extras: {},
           typingCtx,
           definition,
           client,
-          config
+          config,
+          store
         });
         const normalizedMessage = wrapProviderMessage(
           msg,
@@ -2039,7 +2098,8 @@ async function Spectrum(options) {
             config,
             definition,
             space,
-            spaceRef
+            spaceRef,
+            store
           },
           "inbound"
         );
@@ -2072,15 +2132,18 @@ async function Spectrum(options) {
     const providerConfig = provider;
     const def = providerConfig.__definition;
     const userConfig = def.config.parse(providerConfig.config);
+    const store = createStore();
     const client = await def.lifecycle.createClient({
       config: userConfig,
       projectId,
-      projectSecret
+      projectSecret,
+      store
     });
     const state = {
       client,
       config: userConfig,
-      definition: def
+      definition: def,
+      store
     };
     platformStates.set(def.name, {
       ...state,
@@ -2114,12 +2177,12 @@ async function Spectrum(options) {
   const createCustomEventStream = (eventName) => {
     return stream((emit, end) => {
       const providerStreams = Array.from(platformStates.values(), (state) => {
-        const { client, config, definition } = state;
+        const { client, config, definition, store } = state;
         const producer = definition.events[eventName];
         if (!producer) {
           return void 0;
         }
-        const providerEvents = producer({ client, config });
+        const providerEvents = producer({ client, config, store });
         const annotatePlatform = async function* () {
           for await (const value of providerEvents) {
             yield { ...value, platform: definition.name };
@@ -2168,10 +2231,11 @@ async function Spectrum(options) {
     await Promise.allSettled(streamShutdowns);
     const clientShutdowns = Array.from(
       platformStates.values(),
-      (state) => state.definition.lifecycle.destroyClient({
-        client: state.client
+      (state) => state.definition.lifecycle.destroyClient?.({
+        client: state.client,
+        store: state.store
       })
-    );
+    ).filter((shutdown) => shutdown !== void 0);
     await Promise.allSettled(clientShutdowns);
     customEventStreams.clear();
     messageBroadcasters.clear();

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

@@ -1,4 +1,4 @@
-import { a as ContentInput, C as ContentBuilder, o as SchemaMessage, d as Platform, c as PlatformDef, P as ProviderMessage, i as ManagedStream } from '../../types-Dvp0I86h.js';
+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 * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
@@ -9,7 +9,11 @@ import 'hotscript';
 type IMessageMessageEffect = MessageEffect;
 declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
 
-type IMessageClient = IMessageSDK | AdvancedIMessage[];
+interface RemoteClient {
+    client: AdvancedIMessage;
+    phone: string;
+}
+type IMessageClient = IMessageSDK | RemoteClient[];
 declare const userSchema: z__default.ZodObject<{}, z__default.core.$strip>;
 declare const spaceSchema: z__default.ZodObject<{
     id: z__default.ZodString;
@@ -17,6 +21,7 @@ declare const spaceSchema: z__default.ZodObject<{
         dm: "dm";
         group: "group";
     }>;
+    phone: z__default.ZodString;
 }, z__default.core.$strip>;
 type IMessageMessage = SchemaMessage<typeof userSchema, typeof spaceSchema> & {
     partIndex?: number;
@@ -30,9 +35,11 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
     clients: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
         address: z.ZodString;
         token: z.ZodString;
+        phone: z.ZodString;
     }, zod_v4_core.$strip>, z.ZodArray<z.ZodObject<{
         address: z.ZodString;
         token: z.ZodString;
+        phone: z.ZodString;
     }, zod_v4_core.$strip>>]>>;
 }, zod_v4_core.$strip>]>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodObject<{
     id: z.ZodString;
@@ -40,14 +47,19 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
         dm: "dm";
         group: "group";
     }>;
-}, zod_v4_core.$strip>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, IMessageClient, {
+    phone: z.ZodString;
+}, zod_v4_core.$strip>, z.ZodObject<{
+    phone: z.ZodOptional<z.ZodString>;
+}, zod_v4_core.$strip>, IMessageClient, {
     id: string;
 }, {
     id: string;
     type: "dm";
+    phone: string;
 } | {
     id: string;
     type: "group";
+    phone: string;
 }, z.ZodObject<{
     partIndex: z.ZodOptional<z.ZodNumber>;
     parentId: z.ZodOptional<z.ZodString>;
@@ -56,9 +68,11 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
 }, {
     id: string;
     type: "dm";
+    phone: string;
 } | {
     id: string;
     type: "group";
+    phone: string;
 }, {
     partIndex?: number | undefined;
     parentId?: string | undefined;
@@ -72,11 +86,14 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
             clients?: {
                 address: string;
                 token: string;
+                phone: string;
             } | {
                 address: string;
                 token: string;
+                phone: string;
             }[] | undefined;
         };
+        store: Store;
     }) => ManagedStream<IMessageMessage>;
 }>> & Readonly<{
     effect: {