@spectrum-ts/core 6.0.0 → 6.1.0

package/dist/{attachment-CfEp6LAu.d.ts → attachment-CQh4PQGl.d.ts}

@@ -447,6 +447,10 @@ interface Message<TPlatform extends string = string, TSender extends User = User
 declare const editSchema: z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -541,10 +545,6 @@ declare const editSchema: z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -602,6 +602,10 @@ declare const editSchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -696,10 +700,6 @@ declare const editSchema: z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -982,6 +982,10 @@ declare function rename(displayName: string): ContentBuilder;
 declare const replySchema: z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -1076,10 +1080,6 @@ declare const replySchema: z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -1137,6 +1137,10 @@ declare const replySchema: z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -1231,10 +1235,6 @@ declare const replySchema: z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -6893,6 +6893,10 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"reply">;
   content: z.ZodCustom<{
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -6987,10 +6991,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7048,6 +7048,10 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -7142,10 +7146,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7207,6 +7207,10 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
   type: z.ZodLiteral<"edit">;
   content: z.ZodCustom<{
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -7301,10 +7305,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];
@@ -7362,6 +7362,10 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       kind: "clear";
     };
   }, {
+    type: "reaction";
+    emoji: string;
+    target: Message<string, User, Space<unknown>>;
+  } | {
     type: "text";
     text: string;
   } | {
@@ -7456,10 +7460,6 @@ declare const contentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       imageSubtitle: z.ZodOptional<z.ZodString>;
       summary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-  } | {
-    type: "reaction";
-    emoji: string;
-    target: Message<string, User, Space<unknown>>;
   } | {
     type: "group";
     items: Message<string, User, Space<unknown>>[];

package/dist/authoring.d.ts

@@ -1,4 +1,4 @@
-import { $t as groupSchema, Bt as asPollOption, Dn as buildPhotoAction, En as PhotoInput, H as ProviderMessageRecord, K as ManagedStream, Nt as asRead, On as photoActionSchema, St as asText, Tt as asRichlink, Wt as asMarkdown, Zt as asGroup, cn as reactionSchema, gt as asVoice, ln as asCustom, on as asReaction, r as asAttachment, yn as asContact, zt as asPoll } from "./attachment-CfEp6LAu.js";
+import { $t as groupSchema, Bt as asPollOption, Dn as buildPhotoAction, En as PhotoInput, H as ProviderMessageRecord, K as ManagedStream, Nt as asRead, On as photoActionSchema, St as asText, Tt as asRichlink, Wt as asMarkdown, Zt as asGroup, cn as reactionSchema, gt as asVoice, ln as asCustom, on as asReaction, r as asAttachment, yn as asContact, zt as asPoll } from "./attachment-CQh4PQGl.js";
 import z from "zod";
 import { LogAttrs, LogAttrs as LogAttrs$1, LogLevel, PhotonLogger, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, setLogLevel } from "@photon-ai/otel";
 import { Token } from "marked";
@@ -69,6 +69,18 @@ interface ResumableOrderedStreamOptions<TLive, TMissed, TOutput> {
   maxRetryDelayMs?: number;
   processLive: (event: TLive) => Promise<ResumableStreamItem<TOutput>>;
   processMissed: (event: TMissed) => Promise<ResumableStreamItem<TOutput>>;
+  /**
+   * Invoked when reconnects have failed persistently (the consecutive-failure
+   * count has reached a multiple of `PERSISTENT_FAILURE_ERROR_THRESHOLD`) to
+   * rebuild state a plain reconnect cannot refresh — e.g. re-mint an auth token
+   * the server rejects after a restart. Runs between the failure and the next
+   * retry, throttled to once per threshold window, and resets once the stream
+   * recovers. Errors thrown are logged and swallowed; the reconnect loop
+   * continues either way, so a recover that itself fails is harmless.
+   */
+  recover?: (error: unknown, failureCount: number) => Promise<void> | void;
+  /** Cap on how long a `recover` hook may run before it is abandoned; injectable for tests. */
+  recoverTimeoutMs?: number;
   subscribeLive: (cursor?: string) => CloseableAsyncIterable<TLive>;
 }
 /**

package/dist/authoring.js

@@ -147,6 +147,18 @@ const closeIterable = async (iterable) => {
 	await iterable.close?.();
 };
 const ignoreCleanupError = () => void 0;
+const RECOVER_TIMEOUT_MS = 3e4;
+const runWithTimeout = async (work, timeoutMs, onTimeout) => {
+	work.catch(ignoreCleanupError);
+	let timer;
+	try {
+		await Promise.race([work, new Promise((_resolve, reject) => {
+			timer = setTimeout(() => reject(onTimeout()), timeoutMs);
+		})]);
+	} finally {
+		if (timer) clearTimeout(timer);
+	}
+};
 const jitterDelay = (delayMs) => delayMs * (.5 + Math.random() * .5);
 async function* throwOnCursorRejection(source, isCursorRejected) {
 	try {
@@ -178,10 +190,12 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	const initialRetryDelayMs = options.initialRetryDelayMs ?? 500;
 	const maxRetryDelayMs = options.maxRetryDelayMs ?? 3e4;
 	const jitter = options.jitter ?? jitterDelay;
+	const recoverTimeoutMs = options.recoverTimeoutMs ?? RECOVER_TIMEOUT_MS;
 	const label = options.label;
 	let activeLive;
 	let closed = false;
 	let failedAttempts = 0;
+	let lastRecoverAttempt = 0;
 	let lastCursor;
 	let retryDelayMs = initialRetryDelayMs;
 	let sleepTimer;
@@ -197,6 +211,7 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	});
 	const noteRecovery = () => {
 		retryDelayMs = initialRetryDelayMs;
+		lastRecoverAttempt = 0;
 		if (failedAttempts === 0) return;
 		log.info("stream recovered", {
 			"spectrum.stream.id": streamId,
@@ -267,6 +282,25 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 		log.warn("stream interrupted; reconnecting", attrs, error);
 		return delayMs;
 	};
+	const maybeRecover = async (error) => {
+		if (!options.recover || failedAttempts < 5 || failedAttempts - lastRecoverAttempt < 5) return;
+		lastRecoverAttempt = failedAttempts;
+		try {
+			await runWithTimeout(Promise.resolve(options.recover(error, failedAttempts)), recoverTimeoutMs, () => /* @__PURE__ */ new Error(`recover hook did not settle within ${recoverTimeoutMs}ms`));
+			log.info("stream recover hook ran", {
+				"spectrum.stream.id": streamId,
+				"spectrum.stream.label": label,
+				"spectrum.stream.attempt": failedAttempts
+			});
+		} catch (recoverError) {
+			log.warn("stream recover hook failed", {
+				"spectrum.stream.id": streamId,
+				"spectrum.stream.label": label,
+				"spectrum.stream.attempt": failedAttempts,
+				...errorAttrs(recoverError)
+			}, recoverError);
+		}
+	};
 	const consumeLive = async () => {
 		const live = options.subscribeLive(lastCursor);
 		activeLive = live;
@@ -366,7 +400,9 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 				await closeIterable(activeLive).catch(ignoreCleanupError);
 				activeLive = void 0;
 				if (closed) break;
-				await sleep(handleFailure(error, phase));
+				const delayMs = handleFailure(error, phase);
+				await maybeRecover(error);
+				await sleep(delayMs);
 			}
 		}
 		end();

package/dist/elysia.d.ts

@@ -1,4 +1,4 @@
-import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CfEp6LAu.js";
+import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CQh4PQGl.js";
 import { Elysia } from "elysia";
 
 //#region src/elysia.d.ts

package/dist/express.d.ts

@@ -1,4 +1,4 @@
-import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CfEp6LAu.js";
+import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CQh4PQGl.js";
 import { Router } from "express";
 
 //#region src/express.d.ts

package/dist/hono.d.ts

@@ -1,4 +1,4 @@
-import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CfEp6LAu.js";
+import { T as WebhookHandler, nn as Message, rn as Space } from "./attachment-CQh4PQGl.js";
 
 //#region src/hono.d.ts
 /**

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as FusorTokenData, A as isFusorEvent, An as AppLayout, At as Rename, B as PlatformUser, C as FusorVerify, Cn as Avatar, Ct as text, D as WebhookRawResult, Dt as resolveContents, E as WebhookRawRequest, Et as richlink, F as PlatformInstance, Ft as Poll, G as Broadcaster, Gt as markdown, Ht as poll, I as PlatformMessage, It as PollChoice, J as mergeStreams, Jt as StreamTextSource, K as ManagedStream, Kt as DeltaExtractor, L as PlatformProviderConfig, Lt as PollChoiceInput, M as EventProducer, Mn as app, Mt as Read, N as Platform, Nn as appLayoutSchema, O as FusorEvent, Ot as Reply, P as PlatformDef, Pt as read, Q as DedicatedTokenData, Qt as group, R as PlatformRuntime, Rt as PollOption, S as FusorRespond, Sn as User, T as WebhookHandler, Tn as avatar, U as SchemaMessage, Ut as Markdown, V as ProviderMessage, Vt as option, W as SpaceNamespace, X as Store, Xt as Group, Y as stream, Yt as TextStreamOptions, Z as CloudPlatform, _ as FusorClient, _n as ContactOrg, _t as voice, a as Content, an as ReactionBuilder, at as SharedTokenData, b as FusorMessagesReturn, bn as contact, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dn as Contact, dt as TokenData, en as Edit, et as ImessageInfoData, f as Spectrum, fn as ContactAddress, ft as cloud, g as isFusorClient, gn as ContactName, h as fusor, hn as ContactInput, ht as Voice, i as attachment, in as Reaction, it as ProjectProfile, j as AnyPlatformDef, jn as AppUrl, jt as rename, k as fusorEvent, kn as App, kt as reply, l as toVCard, lt as SubscriptionData, m as definePlatform, mn as ContactEmail, mt as EmojiKey, n as AttachmentInput, nn as Message, nt as PlatformsData, o as ContentBuilder, ot as SlackTeamMeta, p as SpectrumInstance, pn as ContactDetails, pt as Emoji, q as broadcast, qt as StreamText, rn as Space, rt as ProjectData, s as ContentInput, sn as reaction, st as SlackTokenData, t as Attachment, tn as edit, tt as PlatformStatus, u as UnsupportedError, un as custom, ut as SubscriptionStatus, v as FusorMessages, vn as ContactPhone, vt as Unsend, w as FusorVerifyRequest, wn as AvatarInput, wt as Richlink, x as FusorReply, xn as AgentSender, xt as typing, y as FusorMessagesCtx, yt as unsend, z as PlatformSpace } from "./attachment-CfEp6LAu.js";
+import { $ as FusorTokenData, A as isFusorEvent, An as AppLayout, At as Rename, B as PlatformUser, C as FusorVerify, Cn as Avatar, Ct as text, D as WebhookRawResult, Dt as resolveContents, E as WebhookRawRequest, Et as richlink, F as PlatformInstance, Ft as Poll, G as Broadcaster, Gt as markdown, Ht as poll, I as PlatformMessage, It as PollChoice, J as mergeStreams, Jt as StreamTextSource, K as ManagedStream, Kt as DeltaExtractor, L as PlatformProviderConfig, Lt as PollChoiceInput, M as EventProducer, Mn as app, Mt as Read, N as Platform, Nn as appLayoutSchema, O as FusorEvent, Ot as Reply, P as PlatformDef, Pt as read, Q as DedicatedTokenData, Qt as group, R as PlatformRuntime, Rt as PollOption, S as FusorRespond, Sn as User, T as WebhookHandler, Tn as avatar, U as SchemaMessage, Ut as Markdown, V as ProviderMessage, Vt as option, W as SpaceNamespace, X as Store, Xt as Group, Y as stream, Yt as TextStreamOptions, Z as CloudPlatform, _ as FusorClient, _n as ContactOrg, _t as voice, a as Content, an as ReactionBuilder, at as SharedTokenData, b as FusorMessagesReturn, bn as contact, bt as Typing, c as fromVCard, ct as SpectrumCloudError, d as UnsupportedKind, dn as Contact, dt as TokenData, en as Edit, et as ImessageInfoData, f as Spectrum, fn as ContactAddress, ft as cloud, g as isFusorClient, gn as ContactName, h as fusor, hn as ContactInput, ht as Voice, i as attachment, in as Reaction, it as ProjectProfile, j as AnyPlatformDef, jn as AppUrl, jt as rename, k as fusorEvent, kn as App, kt as reply, l as toVCard, lt as SubscriptionData, m as definePlatform, mn as ContactEmail, mt as EmojiKey, n as AttachmentInput, nn as Message, nt as PlatformsData, o as ContentBuilder, ot as SlackTeamMeta, p as SpectrumInstance, pn as ContactDetails, pt as Emoji, q as broadcast, qt as StreamText, rn as Space, rt as ProjectData, s as ContentInput, sn as reaction, st as SlackTokenData, t as Attachment, tn as edit, tt as PlatformStatus, u as UnsupportedError, un as custom, ut as SubscriptionStatus, v as FusorMessages, vn as ContactPhone, vt as Unsend, w as FusorVerifyRequest, wn as AvatarInput, wt as Richlink, x as FusorReply, xn as AgentSender, xt as typing, y as FusorMessagesCtx, yt as unsend, z as PlatformSpace } from "./attachment-CQh4PQGl.js";
 export { type AgentSender, type AnyPlatformDef, type App, type AppLayout, type AppUrl, type Attachment, type AttachmentInput, type Avatar, 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 ManagedStream, type Markdown, 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 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, app, appLayoutSchema, attachment, avatar, broadcast, cloud, contact, custom, definePlatform, edit, fromVCard, fusor, fusorEvent, group, isFusorClient, isFusorEvent, markdown, mergeStreams, option, poll, reaction, read, rename, reply, resolveContents, richlink, stream, text, toVCard, typing, unsend, voice };

package/dist/index.js

@@ -2994,7 +2994,7 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "6.0.0";
+const SPECTRUM_SDK_VERSION = "6.1.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {

package/package.json

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