@spectrum-ts/core 11.2.0 → 12.1.0

package/dist/authoring.d.ts

@@ -1,4 +1,4 @@
-import { Cn as reactionSchema, Dt as asRichlink, Gn as photoActionSchema, Gt as asPollOption, H as ProviderMessageRecord, Hn as avatarSchema, It as renameSchema, Nt as replySchema, Pn as asContact, Rt as asRead, U as ProviderUserRecord, Un as PhotoInput, Wn as buildPhotoAction, Wt as asPoll, Yt as asMarkdown, _t as asVoice, bt as asUnsend, gn as leaveSpaceSchema, in as groupSchema, jt as asReply, mn as addMemberSchema, nn as asGroup, q as ManagedStream, r as asAttachment, vn as removeMemberSchema, wn as asCustom, wt as asText, xn as asReaction } from "./attachment-CtoKMCG2.js";
+import { Cn as reactionSchema, Dt as asRichlink, Gn as photoActionSchema, Gt as asPollOption, H as ProviderMessageRecord, Hn as avatarSchema, It as renameSchema, Nt as replySchema, Pn as asContact, Rt as asRead, U as ProviderUserRecord, Un as PhotoInput, Wn as buildPhotoAction, Wt as asPoll, Yt as asMarkdown, _t as asVoice, bt as asUnsend, gn as leaveSpaceSchema, in as groupSchema, jt as asReply, mn as addMemberSchema, nn as asGroup, q as ManagedStream, r as asAttachment, vn as removeMemberSchema, wn as asCustom, wt as asText, xn as asReaction } from "./attachment-CbNQEDfL.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";
@@ -178,4 +178,18 @@ declare const resumableOrderedStream: <TLive, TMissed, TOutput>(options: Resumab
  */
 declare function errorAttrs(error: unknown, prefix?: string): LogAttrs$1;
 //#endregion
-export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ProviderUserRecord, type ResumableStreamItem, type SanitizeUrlOptions, addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };
+//#region src/utils/token-renewal.d.ts
+interface TokenRenewal {
+  dispose(): void;
+  forceRefresh(): Promise<void>;
+  invalidate(): void;
+  refreshIfNeeded(): Promise<void>;
+}
+interface TokenRenewalOptions {
+  expiresInSeconds(): number;
+  name: string;
+  refresh(): Promise<void>;
+}
+declare const createTokenRenewal: (options: TokenRenewalOptions) => TokenRenewal;
+//#endregion
+export { type CloseableAsyncIterable, type LogAttrs, type LogLevel, type PhotoInput, type PhotonLogger, type ProviderMessageRecord, type ProviderUserRecord, type ResumableStreamItem, type SanitizeUrlOptions, type TokenRenewal, type TokenRenewalOptions, addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/authoring.js

@@ -1,4 +1,4 @@
-import { A as asPoll, B as asMarkdown, D as asReaction, F as addMemberSchema, G as groupSchema, H as markdownSchema, L as leaveSpaceSchema, Q as asCustom, S as replySchema, T as asRead, U as asGroup, Y as textSchema, at as avatarSchema, b as asReply, ct as asAttachment, d as envAwareConfig, et as asContact, f as envFor, ft as tracedFetch, g as asUnsend, i as stream, j as asPollOption, k as reactionSchema, l as renderInlineTokens, m as asVoice, o as errorAttrs, ot as buildPhotoAction, p as fromEnv, q as asText, st as photoActionSchema, ut as attachmentSchema, v as asRichlink, w as renameSchema, z as removeMemberSchema } from "./stream-B6kth7y9.js";
+import { $ as asCustom, A as reactionSchema, B as removeMemberSchema, C as replySchema, E as asRead, I as addMemberSchema, J as asText, K as groupSchema, M as asPollOption, O as asReaction, R as leaveSpaceSchema, T as renameSchema, U as markdownSchema, V as asMarkdown, W as asGroup, X as textSchema, _ as asUnsend, a as createTokenRenewal, ct as photoActionSchema, dt as attachmentSchema, f as envAwareConfig, h as asVoice, i as stream, j as asPoll, lt as asAttachment, m as fromEnv, ot as avatarSchema, p as envFor, pt as tracedFetch, s as errorAttrs, st as buildPhotoAction, tt as asContact, u as renderInlineTokens, x as asReply, y as asRichlink } from "./stream-4VQBWgZQ.js";
 import z from "zod";
 import { createLogger, createLogger as createLogger$1, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel } from "@photon-ai/otel";
 import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
@@ -422,4 +422,4 @@ const resumableOrderedStream = (options) => stream((emit, end) => {
 	};
 });
 //#endregion
-export { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };
+export { addMemberSchema, asAttachment, asContact, asCustom, asGroup, asMarkdown, asPoll, asPollOption, asReaction, asRead, asReply, asRichlink, asText, asUnsend, asVoice, avatarSchema, buildPhotoAction, createLogger, createTokenRenewal, ensureM4a, envAwareConfig, envFor, errorAttrs, fromEnv, groupSchema, leaveSpaceSchema, messageEffectSchema, photoActionSchema, reactionSchema, removeMemberSchema, renameSchema, renderInlineTokens, replySchema, resumableOrderedStream, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl, setLogLevel, tracedFetch };

package/dist/index.d.ts

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

@@ -1,4 +1,4 @@
-import { $ as custom, B as asMarkdown, C as rename, E as read, F as addMemberSchema, I as leaveSpace, J as text, K as resolveContents, L as leaveSpaceSchema, M as option, N as poll, O as reaction, P as addMember, Q as asCustom, R as removeMember, V as markdown, W as group, X as StreamConsumedError, Z as drainStreamText, _ as unsend, a as contentAttrs, at as avatarSchema, c as markdownToPlainText, ct as asAttachment, d as envAwareConfig, dt as fetchUrlBytes, et as asContact, f as envFor, ft as tracedFetch, h as voice, i as stream, it as avatar, lt as attachment, m as asVoice, n as createAsyncQueue, nt as fromVCard, o as errorAttrs, q as asText, r as mergeStreams, rt as toVCard, s as senderAttrs, t as broadcast, tt as contact, u as classifyIdentifier, w as renameSchema, x as reply, y as richlink, z as removeMemberSchema } from "./stream-B6kth7y9.js";
+import { $ as asCustom, B as removeMemberSchema, D as read, F as addMember, G as group, H as markdown, I as addMemberSchema, J as asText, L as leaveSpace, N as option, P as poll, Q as drainStreamText, R as leaveSpaceSchema, S as reply, T as renameSchema, V as asMarkdown, Y as text, Z as StreamConsumedError, a as createTokenRenewal, at as avatar, b as richlink, c as senderAttrs, d as classifyIdentifier, et as custom, f as envAwareConfig, ft as fetchUrlBytes, g as voice, h as asVoice, i as stream, it as toVCard, k as reaction, l as markdownToPlainText, lt as asAttachment, n as createAsyncQueue, nt as contact, o as contentAttrs, ot as avatarSchema, p as envFor, pt as tracedFetch, q as resolveContents, r as mergeStreams, rt as fromVCard, s as errorAttrs, t as broadcast, tt as asContact, ut as attachment, v as unsend, w as rename, z as removeMember } from "./stream-4VQBWgZQ.js";
 import z from "zod";
 import ogs from "open-graph-scraper";
 import { createLogger, setLogLevel, setupOtel, withSpan } from "@photon-ai/otel";
@@ -2806,6 +2806,11 @@ function buildMessage(params) {
 //#endregion
 //#region src/platform/define.ts
 const platformLog = createLogger("spectrum.platform");
+const PLATFORM_ID_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
+const assertValidPlatformId = (platformId) => {
+	if (PLATFORM_ID_PATTERN.test(platformId)) return;
+	throw new Error(`Invalid platform id "${platformId}". Platform ids must use lowercase snake_case (for example, "my_platform").`);
+};
 function buildInstanceActions(platformName, declared, reservedKeys, buildCtx) {
 	const out = {};
 	for (const key of PLATFORM_WISE_ACTION_KEYS) {
@@ -2948,33 +2953,34 @@ function createPlatformInstance(def, runtime) {
 	}));
 	return Object.assign(base, instanceActions, eventProperties);
 }
-function definePlatform(name, rawDef) {
+function definePlatform(platformId, rawDef) {
+	assertValidPlatformId(platformId);
 	const def = rawDef;
 	const fullDef = {
 		...def,
-		name,
-		config: envAwareConfig(name, def.config)
+		name: platformId,
+		config: envAwareConfig(platformId, def.config)
 	};
 	const platformCache = /* @__PURE__ */ new WeakMap();
 	const narrowSpectrum = (spectrum) => {
 		const cached = platformCache.get(spectrum);
 		if (cached) return cached;
-		const runtime = spectrum.__internal.platforms.get(name);
-		if (!runtime) throw new Error(`Platform "${name}" is not registered`);
+		const runtime = spectrum.__internal.platforms.get(platformId);
+		if (!runtime) throw new Error(`Platform "${platformId}" is not registered`);
 		const instance = createPlatformInstance(fullDef, runtime);
 		platformCache.set(spectrum, instance);
 		return instance;
 	};
 	const narrowSpace = (input) => {
-		if (input.__platform !== name) platformLog.warn("space platform mismatch; narrowing skipped", {
-			"spectrum.platform.expected": name,
+		if (input.__platform !== platformId) platformLog.warn("space platform mismatch; narrowing skipped", {
+			"spectrum.platform.expected": platformId,
 			"spectrum.platform.actual": input.__platform
 		});
 		return input;
 	};
 	const narrowMessage = (input) => {
-		if (input.platform !== name) platformLog.warn("message platform mismatch; narrowing skipped", {
-			"spectrum.platform.expected": name,
+		if (input.platform !== platformId) platformLog.warn("message platform mismatch; narrowing skipped", {
+			"spectrum.platform.expected": platformId,
 			"spectrum.platform.actual": input.platform
 		});
 		return input;
@@ -2989,15 +2995,15 @@ function definePlatform(name, rawDef) {
 		return {
 			__tag: "PlatformProviderConfig",
 			__def: void 0,
-			__name: name,
+			__name: platformId,
 			config: config ?? {},
 			__definition: fullDef
 		};
 	};
 	narrower.is = ((input) => {
 		if (typeof input !== "object" || input === null) return false;
-		if ("__platform" in input) return input.__platform === name;
-		if ("platform" in input) return input.platform === name;
+		if ("__platform" in input) return input.__platform === platformId;
+		if ("platform" in input) return input.platform === platformId;
 		return false;
 	});
 	if (def.static) Object.assign(narrower, def.static);
@@ -3005,18 +3011,19 @@ function definePlatform(name, rawDef) {
 }
 //#endregion
 //#region src/build-env.ts
-const SPECTRUM_SDK_VERSION = "11.2.0";
+const SPECTRUM_SDK_VERSION = "12.1.0";
 //#endregion
 //#region src/utils/provider-packages.ts
 const OFFICIAL_PROVIDER_PACKAGES = {
 	imessage: "@spectrum-ts/imessage",
+	local_imessage: "@spectrum-ts/imessage-local",
 	slack: "@spectrum-ts/slack",
 	telegram: "@spectrum-ts/telegram",
 	terminal: "@spectrum-ts/terminal",
-	"whatsapp-business": "@spectrum-ts/whatsapp-business"
+	whatsapp_business: "@spectrum-ts/whatsapp-business"
 };
-const SEPARATORS = /[\s_]+/g;
-const normalizePlatformKey = (platform) => platform.trim().toLowerCase().replace(SEPARATORS, "-");
+const LEGACY_SEPARATORS = /[\s-]+/g;
+const normalizePlatformKey = (platform) => platform.trim().toLowerCase().replace(LEGACY_SEPARATORS, "_");
 const officialProviderPackage = (platform) => OFFICIAL_PROVIDER_PACKAGES[normalizePlatformKey(platform)];
 const installCommand = (pkg) => process.versions.bun ? `bun add ${pkg}` : `npm install ${pkg}`;
 /**
@@ -3027,7 +3034,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({ platforms: [...] })`;
+	return `the "${platform}" platform is provided by the optional package ${pkg} — install it (\`${installCommand(pkg)}\`) and pass it to Spectrum({ providers: [...] })`;
 };
 //#endregion
 //#region src/utils/cloud.ts
@@ -3095,10 +3102,6 @@ const cloud = {
 };
 //#endregion
 //#region src/fusor/auth.ts
-const log$2 = createLogger("spectrum.fusor.auth");
-const RENEWAL_RATIO = .8;
-const EXPIRY_BUFFER_MS = 3e4;
-const RETRY_DELAY_MS = 3e4;
 /**
 * Single-token provider for the fusor stream. Mirrors the renewal cadence
 * of the slack provider package's auth but without per-team bookkeeping —
@@ -3107,83 +3110,23 @@ const RETRY_DELAY_MS = 3e4;
 function createFusorTokenProvider(projectId, projectSecret) {
 	return (async () => {
 		let tokenData = await cloud.issueFusorToken(projectId, projectSecret);
-		let tokenExpiresAt = Date.now() + tokenData.expiresIn * 1e3;
-		let disposed = false;
-		let renewalTimer;
-		let refreshFailures = 0;
-		const clearRenewalTimer = () => {
-			if (renewalTimer !== void 0) {
-				clearTimeout(renewalTimer);
-				renewalTimer = void 0;
-			}
-		};
-		const refresh = async () => {
-			tokenData = await cloud.issueFusorToken(projectId, projectSecret);
-			tokenExpiresAt = Date.now() + tokenData.expiresIn * 1e3;
-		};
-		const onRefreshSuccess = () => {
-			if (refreshFailures > 0) {
-				log$2.info("fusor token refresh recovered", { "spectrum.fusor.auth.attempt": refreshFailures });
-				refreshFailures = 0;
+		const renewal = createTokenRenewal({
+			expiresInSeconds: () => tokenData.expiresIn,
+			name: "fusor",
+			refresh: async () => {
+				tokenData = await cloud.issueFusorToken(projectId, projectSecret);
 			}
-		};
-		const onRefreshFailure = (error) => {
-			refreshFailures += 1;
-			log$2.warn("fusor token refresh failed; retrying", {
-				"spectrum.fusor.auth.attempt": refreshFailures,
-				"spectrum.fusor.auth.retry_in_ms": RETRY_DELAY_MS,
-				...errorAttrs(error)
-			}, error);
-		};
-		const scheduleRetry = () => {
-			if (disposed) return;
-			clearRenewalTimer();
-			renewalTimer = setTimeout(async () => {
-				if (disposed) return;
-				try {
-					await refresh();
-					onRefreshSuccess();
-					scheduleRenewal();
-				} catch (retryErr) {
-					onRefreshFailure(retryErr);
-					scheduleRetry();
-				}
-			}, RETRY_DELAY_MS);
-			renewalTimer?.unref?.();
-		};
-		const scheduleRenewal = () => {
-			if (disposed) return;
-			clearRenewalTimer();
-			const ttlMs = tokenData.expiresIn * 1e3;
-			const renewInMs = Math.max(ttlMs * RENEWAL_RATIO, 5e3);
-			renewalTimer = setTimeout(async () => {
-				try {
-					await refresh();
-					onRefreshSuccess();
-					scheduleRenewal();
-				} catch (err) {
-					onRefreshFailure(err);
-					scheduleRetry();
-				}
-			}, renewInMs);
-			renewalTimer?.unref?.();
-		};
-		scheduleRenewal();
+		});
 		return {
 			async getToken() {
-				if (Date.now() >= tokenExpiresAt - EXPIRY_BUFFER_MS) {
-					await refresh();
-					onRefreshSuccess();
-					scheduleRenewal();
-				}
+				await renewal.refreshIfNeeded();
 				return tokenData.token;
 			},
 			invalidate() {
-				tokenExpiresAt = 0;
+				renewal.invalidate();
 			},
 			async dispose() {
-				disposed = true;
-				clearRenewalTimer();
+				renewal.dispose();
 			}
 		};
 	})();
@@ -3653,6 +3596,16 @@ var FusorCore = class {
 	}
 };
 //#endregion
+//#region src/platform/unique-names.ts
+const assertUniquePlatformNames = (providers) => {
+	const names = /* @__PURE__ */ new Set();
+	for (const provider of providers) {
+		const name = provider.__definition.name;
+		if (names.has(name)) throw new Error(`Spectrum received multiple providers for platform "${name}". Register exactly one provider per platform.`);
+		names.add(name);
+	}
+};
+//#endregion
 //#region src/utils/store.ts
 const isRecordObject = (value) => {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
@@ -4027,20 +3980,18 @@ 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()).optional(),
-	platforms: z.array(z.custom()).optional(),
+	providers: z.array(z.custom()),
 	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()).optional(),
-	platforms: z.array(z.custom()).optional(),
+	providers: z.array(z.custom()),
 	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) {
@@ -4072,11 +4023,6 @@ 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({
@@ -4084,8 +4030,8 @@ async function Spectrum(options) {
 		projectId,
 		projectSecret
 	});
-	const providers = resolveConfiguredProviders(options);
-	const { options: runtimeOptions, telemetry, webhookSecret } = options;
+	assertUniquePlatformNames(options.providers);
+	const { options: runtimeOptions, providers, telemetry, webhookSecret } = options;
 	const flattenGroups = runtimeOptions?.flattenGroups ?? false;
 	applyLogLevel(runtimeOptions?.logLevel);
 	const resolvedWebhookSecret = webhookSecret ?? process.env[envFor("WEBHOOK", "SECRET")];

package/dist/{stream-B6kth7y9.js → stream-4VQBWgZQ.js}

@@ -1,5 +1,5 @@
 import z from "zod";
-import { createInstrumentedFetch, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl } from "@photon-ai/otel";
+import { createInstrumentedFetch, createLogger, sanitizeEmail, sanitizeErrorMessage, sanitizePhone, sanitizeUrl } from "@photon-ai/otel";
 import { randomUUID } from "node:crypto";
 import { createReadStream } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
@@ -1249,8 +1249,8 @@ const fromEnv = (envKey, schema) => z.preprocess((value) => {
 * Normalize a platform id into the env-var prefix segment: upper-case, with any
 * run of non-alphanumeric characters collapsed to a single `_`. This is a
 * whole-name transform, NOT camelCase splitting, so it reproduces the prefixes
-* the adapters used by hand — `"telegram"` → `TELEGRAM`,
-* `"WhatsApp Business"` → `WHATSAPP_BUSINESS`, `"Slack"` → `SLACK`.
+* canonical platform ids use lowercase snake_case, so `"telegram"` becomes
+* `TELEGRAM` and `"whatsapp_business"` becomes `WHATSAPP_BUSINESS`.
 */
 const NON_ALPHANUMERIC_RUN = /[^A-Z0-9]+/;
 const normalizePlatformName = (name) => name.toUpperCase().split(NON_ALPHANUMERIC_RUN).filter(Boolean).join("_");
@@ -1576,6 +1576,85 @@ function errorAttrs(error, prefix = "spectrum.error") {
 	};
 }
 //#endregion
+//#region src/utils/token-renewal.ts
+const RENEWAL_RATIO = .8;
+const EXPIRY_BUFFER_MS = 3e4;
+const MIN_RENEWAL_DELAY_MS = 5e3;
+const RETRY_DELAY_MS = 3e4;
+const createTokenRenewal = (options) => {
+	const telemetryPrefix = `spectrum.${options.name}.auth`;
+	const log = createLogger(telemetryPrefix);
+	let disposed = false;
+	let refreshFailures = 0;
+	let refreshInFlight;
+	let renewalTimer;
+	let tokenExpiresAt = Date.now() + options.expiresInSeconds() * 1e3;
+	const clearRenewalTimer = () => {
+		if (renewalTimer !== void 0) {
+			clearTimeout(renewalTimer);
+			renewalTimer = void 0;
+		}
+	};
+	const onRefreshSuccess = () => {
+		if (refreshFailures > 0) {
+			log.info(`${options.name} token refresh recovered`, { [`${telemetryPrefix}.attempt`]: refreshFailures });
+			refreshFailures = 0;
+		}
+	};
+	const onRefreshFailure = (error) => {
+		refreshFailures += 1;
+		log.warn(`${options.name} token refresh failed; retrying`, {
+			[`${telemetryPrefix}.attempt`]: refreshFailures,
+			[`${telemetryPrefix}.retry_in_ms`]: RETRY_DELAY_MS,
+			...errorAttrs(error)
+		}, error);
+	};
+	const refreshNow = async () => {
+		await options.refresh();
+		tokenExpiresAt = Date.now() + options.expiresInSeconds() * 1e3;
+		onRefreshSuccess();
+		scheduleRenewal();
+	};
+	const coalescedRefresh = () => {
+		if (!refreshInFlight) refreshInFlight = refreshNow().finally(() => {
+			refreshInFlight = void 0;
+		});
+		return refreshInFlight;
+	};
+	const runScheduledRefresh = () => {
+		if (disposed) return;
+		coalescedRefresh().catch((error) => {
+			onRefreshFailure(error);
+			if (disposed) return;
+			renewalTimer = setTimeout(runScheduledRefresh, RETRY_DELAY_MS);
+			renewalTimer?.unref?.();
+		});
+	};
+	const scheduleRenewal = () => {
+		if (disposed) return;
+		clearRenewalTimer();
+		const ttlMs = options.expiresInSeconds() * 1e3;
+		const renewInMs = Math.max(ttlMs * RENEWAL_RATIO, MIN_RENEWAL_DELAY_MS);
+		renewalTimer = setTimeout(runScheduledRefresh, renewInMs);
+		renewalTimer?.unref?.();
+	};
+	scheduleRenewal();
+	return {
+		dispose() {
+			disposed = true;
+			clearRenewalTimer();
+		},
+		forceRefresh: coalescedRefresh,
+		invalidate() {
+			tokenExpiresAt = 0;
+		},
+		async refreshIfNeeded() {
+			if (Date.now() < tokenExpiresAt - EXPIRY_BUFFER_MS) return;
+			await coalescedRefresh();
+		}
+	};
+};
+//#endregion
 //#region src/utils/stream.ts
 /**
 * Unbounded FIFO queue with `AsyncIterable` consumer. Used by FusorCore to feed
@@ -1746,4 +1825,4 @@ function broadcast(source) {
 	};
 }
 //#endregion
-export { custom as $, asPoll as A, asMarkdown as B, rename as C, asReaction as D, read as E, addMemberSchema as F, groupSchema as G, markdownSchema as H, leaveSpace as I, text as J, resolveContents as K, leaveSpaceSchema as L, option as M, poll as N, reaction as O, addMember as P, asCustom as Q, removeMember as R, replySchema as S, asRead as T, asGroup as U, markdown as V, group as W, StreamConsumedError as X, textSchema as Y, drainStreamText as Z, unsend as _, contentAttrs as a, avatarSchema as at, asReply as b, markdownToPlainText as c, asAttachment as ct, envAwareConfig as d, fetchUrlBytes as dt, asContact as et, envFor as f, tracedFetch as ft, asUnsend as g, voice as h, stream as i, avatar as it, asPollOption as j, reactionSchema as k, renderInlineTokens as l, attachment as lt, asVoice as m, createAsyncQueue as n, fromVCard as nt, errorAttrs as o, buildPhotoAction as ot, fromEnv as p, asText as q, mergeStreams as r, toVCard as rt, senderAttrs as s, photoActionSchema as st, broadcast as t, contact as tt, classifyIdentifier as u, attachmentSchema as ut, asRichlink as v, renameSchema as w, reply as x, richlink as y, removeMemberSchema as z };
+export { asCustom as $, reactionSchema as A, removeMemberSchema as B, replySchema as C, read as D, asRead as E, addMember as F, group as G, markdown as H, addMemberSchema as I, asText as J, groupSchema as K, leaveSpace as L, asPollOption as M, option as N, asReaction as O, poll as P, drainStreamText as Q, leaveSpaceSchema as R, reply as S, renameSchema as T, markdownSchema as U, asMarkdown as V, asGroup as W, textSchema as X, text as Y, StreamConsumedError as Z, asUnsend as _, createTokenRenewal as a, avatar as at, richlink as b, senderAttrs as c, photoActionSchema as ct, classifyIdentifier as d, attachmentSchema as dt, custom as et, envAwareConfig as f, fetchUrlBytes as ft, voice as g, asVoice as h, stream as i, toVCard as it, asPoll as j, reaction as k, markdownToPlainText as l, asAttachment as lt, fromEnv as m, createAsyncQueue as n, contact as nt, contentAttrs as o, avatarSchema as ot, envFor as p, tracedFetch as pt, resolveContents as q, mergeStreams as r, fromVCard as rt, errorAttrs as s, buildPhotoAction as st, broadcast as t, asContact as tt, renderInlineTokens as u, attachment as ut, unsend as v, rename as w, asReply as x, asRichlink as y, removeMember as z };

package/package.json

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