spectrum-ts 1.18.0 → 2.0.0

package/dist/types-BD0-kKyv.d.ts

@@ -0,0 +1,82 @@
+import { b as ProjectData, c as Store, d as ProviderMessageRecord, e as Space, M as Message } from './types-Bje8aq1k.js';
+
+declare const FUSOR_EVENT_BRAND: unique symbol;
+interface FusorEvent<TName extends string = string, TData = unknown> {
+    readonly data: TData;
+    readonly name: TName;
+    readonly [FUSOR_EVENT_BRAND]: true;
+}
+declare function fusorEvent<TName extends string, TData>(name: TName, data: TData): FusorEvent<TName, TData>;
+declare function isFusorEvent(value: unknown): value is FusorEvent;
+
+interface FusorVerifyRequest {
+    headers: Record<string, string>;
+    method: string;
+    path: string;
+    rawBody: Uint8Array;
+}
+type FusorVerify<TPayload = unknown> = (req: FusorVerifyRequest) => TPayload | Promise<TPayload>;
+interface FusorReply {
+    body?: string | Uint8Array;
+    headers?: Record<string, string>;
+    status?: number;
+}
+type FusorRespond = (reply: FusorReply) => void;
+interface FusorMessagesCtx<TPayload, TConfig = unknown> {
+    /** Parsed provider config (`z.infer` of the platform's config schema). */
+    config: TConfig;
+    payload: TPayload;
+    /**
+     * Spectrum Cloud project metadata, fetched once at `Spectrum()` init.
+     * `undefined` for local-only setups (no `projectId`/`projectSecret`). Read
+     * project-level toggles from `projectConfig.profile.<key>`.
+     */
+    projectConfig: ProjectData | undefined;
+    respond: FusorRespond;
+    /** Per-platform in-memory key/value store, shared with the rest of the platform. */
+    store: Store;
+}
+type FusorMessagesReturn = ProviderMessageRecord | FusorEvent | (ProviderMessageRecord | FusorEvent)[] | undefined;
+type FusorMessages<TPayload, TConfig = unknown> = (ctx: FusorMessagesCtx<TPayload, TConfig>) => FusorMessagesReturn | Promise<FusorMessagesReturn>;
+declare const FUSOR_BRAND: unique symbol;
+interface FusorClient<TPayload = unknown> {
+    readonly platform: string;
+    readonly verify: FusorVerify<TPayload>;
+    readonly [FUSOR_BRAND]: true;
+}
+/**
+ * Request-scoped handler invoked once per inbound message that
+ * `spectrum.webhook()` resolves. Receives the same fully-built `[space,
+ * message]` pair that `spectrum.messages` yields.
+ *
+ * Runs **fire-and-forget**: it is dispatched after the HTTP response (the
+ * platform's `respond()` reply) has already been computed, so its outcome never
+ * affects the response, and a throw is caught + logged rather than surfaced —
+ * mirroring the body of a `for await (… of spectrum.messages)` loop.
+ *
+ * On a long-running server the event loop keeps the handler alive. On
+ * serverless/edge runtimes the function may be frozen once the response is
+ * returned, so keeping background work alive is the caller's responsibility —
+ * the usual pattern is to enqueue the work and process it in a separate worker.
+ */
+type WebhookHandler = (space: Space, message: Message) => void | Promise<void>;
+/**
+ * Raw webhook input for HTTP servers without Web `Request`/`Response` (Express,
+ * raw Node). `body` MUST be the exact bytes fusor POSTed — never a re-encoded
+ * JSON/text body — so the protobuf decode works. `headers` are accepted (so the
+ * natural `{ headers: req.headers, body: req.body }` shape keeps working) but are
+ * not read: inbound authenticity is established by the per-platform `verify()`,
+ * which reads the inner request reconstructed from the envelope.
+ */
+interface WebhookRawRequest {
+    body: Uint8Array | ArrayBuffer;
+    headers?: Record<string, string>;
+}
+/** Raw webhook result, written back by the caller as the HTTP response. */
+interface WebhookRawResult {
+    body: Uint8Array;
+    headers: Record<string, string>;
+    status: number;
+}
+
+export { type FusorClient as F, type WebhookHandler as W, type FusorVerify as a, type FusorMessages as b, type WebhookRawRequest as c, type WebhookRawResult as d, type FusorEvent as e, type FusorMessagesCtx as f, type FusorMessagesReturn as g, type FusorReply as h, type FusorRespond as i, type FusorVerifyRequest as j, fusorEvent as k, isFusorEvent as l };

package/dist/{types-DcQ5a7PK.d.ts → types-Bje8aq1k.d.ts}

@@ -4,6 +4,9 @@ import z__default from 'zod';
 declare const contentSchema: 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<"streamText">;
+    stream: z__default.ZodCustom<() => AsyncIterable<string>, () => AsyncIterable<string>>;
 }, z__default.core.$strip>, z__default.ZodObject<{
     type: z__default.ZodLiteral<"custom">;
     raw: z__default.ZodUnknown;
@@ -171,6 +174,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
         size?: number | undefined;
+    } | {
+        type: "streamText";
+        stream: () => AsyncIterable<string>;
     } | {
         type: "custom";
         raw: unknown;
@@ -303,6 +309,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
         size?: number | undefined;
+    } | {
+        type: "streamText";
+        stream: () => AsyncIterable<string>;
     } | {
         type: "custom";
         raw: unknown;
@@ -439,6 +448,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
         size?: number | undefined;
+    } | {
+        type: "streamText";
+        stream: () => AsyncIterable<string>;
     } | {
         type: "custom";
         raw: unknown;
@@ -571,6 +583,9 @@ declare const contentSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObj
         read: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>>>;
         stream: z__default.core.$InferOuterFunctionType<z__default.ZodTuple<readonly [], null>, z__default.ZodPromise<z__default.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>>>;
         size?: number | undefined;
+    } | {
+        type: "streamText";
+        stream: () => AsyncIterable<string>;
     } | {
         type: "custom";
         raw: unknown;
@@ -823,6 +838,12 @@ interface ProjectData {
     id: string;
     name: string;
     profile: ProjectProfile;
+    /**
+     * URL-safe project identifier (e.g. `what-c62a6`). Used as the subdomain of
+     * the Fusor "super webhook" edge a platform registers its provider webhook
+     * against — see Telegram's `webhookUrl`.
+     */
+    slug: string;
 }
 declare class SpectrumCloudError extends Error {
     readonly status: number;
@@ -1010,10 +1031,17 @@ type ProviderMessageRecord = {
 } & 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;
+type InferEventPayload<T> = T extends z__default.ZodType ? z__default.infer<T> : T extends (ctx: never) => AsyncIterable<infer P> ? P : never;
 type ReservedNames = "stop" | "send" | "config" | "__internal" | "__providers";
 interface CreateClientContext<_ConfigSchema extends z__default.ZodType<object>> {
     config: z__default.infer<_ConfigSchema>;
+    /**
+     * The resolved cloud project record (slug, profile, …) when `Spectrum()` runs
+     * with `projectId` + `projectSecret`; `undefined` in local/direct mode. Lets
+     * `createClient` self-register provider webhooks against the Fusor edge keyed
+     * by `projectConfig.slug` — see Telegram.
+     */
+    projectConfig: ProjectData | undefined;
     projectId: string | undefined;
     projectSecret: string | undefined;
     store: Store;
@@ -1034,7 +1062,7 @@ interface CreateClientContext<_ConfigSchema extends z__default.ZodType<object>>
  * Minimum viable platform integration:
  * `name`, `config`, `lifecycle`, `user`, `space`, `messages`, `send`.
  */
-interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__default.ZodType<object> = z__default.ZodType<object>, _UserSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceParamsSchema extends z__default.ZodType<object> | undefined = undefined, _Client = unknown, _ResolvedUser extends ResolvedUser = ResolvedUser, _ResolvedSpace extends ResolvedSpace = ResolvedSpace, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>>, _Events extends (Record<string, EventProducer<unknown, _Client, z__default.infer<_ConfigSchema>>> & {
+interface PlatformDef<_Name extends string = string, _ConfigSchema extends z__default.ZodType<object> = z__default.ZodType<object>, _UserSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceSchema extends z__default.ZodType<object> | undefined = undefined, _SpaceParamsSchema extends z__default.ZodType<object> | undefined = undefined, _Client = unknown, _ResolvedUser extends ResolvedUser = ResolvedUser, _ResolvedSpace extends ResolvedSpace = ResolvedSpace, _MessageSchema extends z__default.ZodType<object> | undefined = undefined, _MessageType extends ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>> = ProviderMessage<_ResolvedUser, _ResolvedSpace, InferSchema<_MessageSchema>>, _Events extends (Record<string, EventProducer<unknown, _Client, z__default.infer<_ConfigSchema>> | z__default.ZodType<object>> & {
     messages?: never;
 }) | undefined = undefined, _SpaceActions extends Record<string, SpaceActionFn> = Record<never, never>, _MessageActions extends Record<string, MessageActionFn> = Record<never, never>, _Actions extends Record<string, InstanceActionFn> = Record<never, never>> {
     /**
@@ -1191,7 +1219,7 @@ interface AnyPlatformDef {
     actions?: Record<string, InstanceActionFn>;
     config: z__default.ZodType<object>;
     events?: {
-        [key: string]: (ctx: any) => AsyncIterable<any>;
+        [key: string]: ((ctx: any) => AsyncIterable<any>) | z__default.ZodType<object>;
     };
     lifecycle: {
         createClient: (ctx: any) => Promise<any>;
@@ -1304,7 +1332,9 @@ interface PlatformRuntime {
     client: unknown;
     config: unknown;
     definition: AnyPlatformDef;
+    projectConfig: ProjectData | undefined;
     store: Store;
+    subscribeEvent?: (channel: string) => AsyncIterable<unknown> | undefined;
     subscribeMessages: () => ManagedStream<[Space, Message]>;
 }
 interface SpectrumLike<Providers extends PlatformProviderConfig[] = PlatformProviderConfig[]> {
@@ -1323,4 +1353,4 @@ interface Platform<Def extends AnyPlatformDef> {
     (message: Message): PlatformMessage<Def>;
 }
 
-export { type AgentSender as A, type Broadcaster as B, type ContentBuilder as C, type DedicatedTokenData as D, type EventProducer as E, type FusorTokenData as F, type SharedTokenData as G, type SlackTeamMeta as H, type InstanceActionFn as I, type SlackTokenData as J, SpectrumCloudError as K, type SubscriptionData as L, type Message as M, type SubscriptionStatus as N, broadcast as O, type Platform as P, cloud as Q, mergeStreams as R, type SchemaMessage as S, type TokenData as T, type User as U, stream as V, type PlatformDef as a, type Space as b, type ContentInput as c, type Store as d, type Content as e, type ProviderMessageRecord as f, type SpaceActionFn as g, type MessageActionFn as h, type CreateClientContext as i, type ProviderMessage as j, type PlatformProviderConfig as k, type SpectrumLike as l, type CustomEventStreams as m, type ProjectData as n, type AnyPlatformDef as o, type CloudPlatform as p, type ImessageInfoData as q, type ManagedStream as r, type PlatformInstance as s, type PlatformMessage as t, type PlatformRuntime as u, type PlatformSpace as v, type PlatformStatus as w, type PlatformUser as x, type PlatformsData as y, type ProjectProfile as z };
+export { type AgentSender as A, type Broadcaster as B, type ContentBuilder as C, type DedicatedTokenData as D, type EventProducer as E, type FusorTokenData as F, type ProjectProfile as G, type SharedTokenData as H, type InstanceActionFn as I, type SlackTeamMeta as J, type SlackTokenData as K, SpectrumCloudError as L, type Message as M, type SubscriptionData as N, type SubscriptionStatus as O, type Platform as P, broadcast as Q, cloud as R, type SchemaMessage as S, type TokenData as T, type User as U, mergeStreams as V, stream as W, type PlatformDef as a, type ProjectData as b, type Store as c, type ProviderMessageRecord as d, type Space as e, contentSchema as f, type ProviderMessage as g, type ContentInput as h, type Content as i, type SpaceActionFn as j, type MessageActionFn as k, type CreateClientContext as l, type PlatformProviderConfig as m, type SpectrumLike as n, type CustomEventStreams as o, type AnyPlatformDef as p, type CloudPlatform as q, type ImessageInfoData as r, type ManagedStream as s, type PlatformInstance as t, type PlatformMessage as u, type PlatformRuntime as v, type PlatformSpace as w, type PlatformStatus as x, type PlatformUser as y, type PlatformsData as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spectrum-ts",
-  "version": "1.18.0",
+  "version": "2.0.0",
   "description": "Bring agents to any interface — unified messaging SDK for TypeScript.",
   "repository": {
     "type": "git",
@@ -42,6 +42,7 @@
     "@photon-ai/imessage-kit": "^3.0.0",
     "@photon-ai/otel": "^0.1.1",
     "@photon-ai/slack": "^0.2.0",
+    "@photon-ai/telegram-ts": "10.0.0",
     "@photon-ai/whatsapp-business": "^0.1.1",
     "@photon-ai/proto": "^0.2.4",
     "@repeaterjs/repeater": "^3.0.6",