spectrum-ts 1.17.1 → 2.0.0

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

@@ -1,8 +1,8 @@
-import { C as ContentBuilder, c as ContentInput, M as Message, S as SchemaMessage, P as Platform, a as PlatformDef, b as Space, d as Store } from '../../types-DcQ5a7PK.js';
+import { C as ContentBuilder, h as ContentInput, M as Message, S as SchemaMessage, P as Platform, a as PlatformDef, e as Space, c as Store } from '../../types-Bje8aq1k.js';
 import * as zod_v4_core from 'zod/v4/core';
 import * as z from 'zod';
 import z__default from 'zod';
-import { A as Attachment } from '../../attachment-DfWSZS5L.js';
+import { A as Attachment } from '../../attachment-B4nSrKVd.js';
 import { P as PhotoInput } from '../../photo-content-BJKnqgN-.js';
 import { MessageEffect, AdvancedIMessage } from '@photon-ai/advanced-imessage';
 import { IMessageSDK } from '@photon-ai/imessage-kit';
@@ -39,6 +39,78 @@ declare function background(input: string | Buffer | URL, options?: {
     mimeType?: string;
 }): ContentBuilder;
 
+/**
+ * Visible layout of a mini-app card. Mirrors Apple's
+ * `MSMessageTemplateLayout`. At least one of `caption`, `subcaption`,
+ * `trailingCaption`, `trailingSubcaption`, or `image` must be set so the
+ * bubble is not empty — `summary` is the fallback text shown on surfaces
+ * that cannot render the card (notifications, lock screen) and is not a
+ * visible slot on its own. `image` and `imageTitle` must be set together;
+ * `imageSubtitle` requires `image`.
+ */
+declare const layoutSchema: z__default.ZodObject<{
+    caption: z__default.ZodOptional<z__default.ZodString>;
+    subcaption: z__default.ZodOptional<z__default.ZodString>;
+    trailingCaption: z__default.ZodOptional<z__default.ZodString>;
+    trailingSubcaption: z__default.ZodOptional<z__default.ZodString>;
+    image: z__default.ZodOptional<z__default.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
+    imageTitle: z__default.ZodOptional<z__default.ZodString>;
+    imageSubtitle: z__default.ZodOptional<z__default.ZodString>;
+    summary: z__default.ZodOptional<z__default.ZodString>;
+}, z__default.core.$strip>;
+/**
+ * iMessage-only mini-app card content. Lives entirely under the iMessage
+ * provider — never enters the universal `Content` discriminated union. The
+ * framework recognizes it via the generic content-level platform contract:
+ *
+ * - `__platform: "iMessage"` — `findUnsupportedPlatformContent` reads this tag
+ *   and warns-and-skips when a different platform receives it.
+ *
+ * Unlike `background` / `read`, this content is **not** `__fireAndForget`: it
+ * produces a real outbound message, so the iMessage `send` handler narrows
+ * back to `CustomizedMiniApp` via the `isCustomizedMiniApp` guard and returns
+ * the resulting `ProviderMessageRecord` (rather than `void`).
+ */
+declare const customizedMiniAppSchema: z__default.ZodObject<{
+    type: z__default.ZodLiteral<"customized-mini-app">;
+    __platform: z__default.ZodLiteral<"iMessage">;
+    appName: z__default.ZodString;
+    appStoreId: z__default.ZodOptional<z__default.ZodNumber>;
+    extensionBundleId: z__default.ZodString;
+    layout: z__default.ZodObject<{
+        caption: z__default.ZodOptional<z__default.ZodString>;
+        subcaption: z__default.ZodOptional<z__default.ZodString>;
+        trailingCaption: z__default.ZodOptional<z__default.ZodString>;
+        trailingSubcaption: z__default.ZodOptional<z__default.ZodString>;
+        image: z__default.ZodOptional<z__default.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>>;
+        imageTitle: z__default.ZodOptional<z__default.ZodString>;
+        imageSubtitle: z__default.ZodOptional<z__default.ZodString>;
+        summary: z__default.ZodOptional<z__default.ZodString>;
+    }, z__default.core.$strip>;
+    teamId: z__default.ZodString;
+    url: z__default.ZodURL;
+}, z__default.core.$strip>;
+type CustomizedMiniApp = z__default.infer<typeof customizedMiniAppSchema>;
+type CustomizedMiniAppLayout = z__default.infer<typeof layoutSchema>;
+type CustomizedMiniAppInput = Omit<CustomizedMiniApp, "type" | "__platform">;
+/**
+ * Construct a `customized-mini-app` content value. iMessage-only, remote-only.
+ *
+ * The layout is what recipients see in the bubble. `teamId` and
+ * `extensionBundleId` identify the iMessage extension that receives `url` when
+ * the recipient taps the card; the server constructs the matching
+ * `MSMessageExtensionBalloonPlugin` plugin id from these values. `appStoreId`
+ * is optional and only points recipients without the extension at its App
+ * Store entry.
+ *
+ * `space.send(customizedMiniApp(...))` is the canonical form.
+ *
+ * `CustomizedMiniApp` is intentionally not a member of the universal `Content`
+ * union — the `as unknown as Content` cast keeps the builder shape compatible
+ * with the framework's `ContentBuilder.build(): Promise<Content>` signature.
+ */
+declare function customizedMiniApp(input: CustomizedMiniAppInput): ContentBuilder;
+
 type IMessageMessageEffect = MessageEffect;
 declare function effect(input: ContentInput, messageEffect: IMessageMessageEffect): ContentBuilder;
 
@@ -176,4 +248,4 @@ declare const imessage: Platform<PlatformDef<"iMessage", z.ZodUnion<readonly [z.
     };
 }>;
 
-export { type BackgroundInput, type IMessageMessageEffect, background, effect, imessage, read };
+export { type BackgroundInput, type CustomizedMiniApp, type CustomizedMiniAppInput, type CustomizedMiniAppLayout, type IMessageMessageEffect, background, customizedMiniApp, effect, imessage, read };

package/dist/providers/imessage/index.js

@@ -1,18 +1,23 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   background,
+  customizedMiniApp,
   effect,
   imessage,
   read
-} from "../../chunk-YJMPSD3S.js";
-import "../../chunk-JQN6CRSC.js";
+} from "../../chunk-ATNAE7OR.js";
+import "../../chunk-6BI4PFTP.js";
+import "../../chunk-3B4QH4JG.js";
 import "../../chunk-2D27WW5B.js";
-import "../../chunk-MC6ZKFSG.js";
-import "../../chunk-QGJFZMD5.js";
-import "../../chunk-IPOFBAIM.js";
+import "../../chunk-3GEJYGZK.js";
+import "../../chunk-U7AWXDH6.js";
+import "../../chunk-5XEFJBN2.js";
+import "../../chunk-6UZFVXQF.js";
+import "../../chunk-NGC4DJIX.js";
 import "../../chunk-2ILTJC35.js";
 export {
   background,
+  customizedMiniApp,
   effect,
   imessage,
   read

package/dist/providers/index.d.ts

@@ -1,16 +1,19 @@
 export { imessage } from './imessage/index.js';
 export { slack } from './slack/index.js';
+export { telegram } from './telegram/index.js';
 export { terminal } from './terminal/index.js';
 export { whatsappBusiness } from './whatsapp-business/index.js';
-import '../types-DcQ5a7PK.js';
+import '../types-Bje8aq1k.js';
 import 'hotscript';
 import 'zod';
 import 'zod/v4/core';
-import '../attachment-DfWSZS5L.js';
+import '../attachment-B4nSrKVd.js';
 import '../photo-content-BJKnqgN-.js';
 import '@photon-ai/advanced-imessage';
 import '@photon-ai/imessage-kit';
 import '@photon-ai/slack';
+import '@photon-ai/telegram-ts';
+import '../types-BD0-kKyv.js';
 import 'node:child_process';
 import 'node:net';
 import '@photon-ai/whatsapp-business';

package/dist/providers/index.js

@@ -1,26 +1,34 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   imessage
-} from "../chunk-YJMPSD3S.js";
-import "../chunk-JQN6CRSC.js";
+} from "../chunk-ATNAE7OR.js";
+import "../chunk-6BI4PFTP.js";
 import {
   slack
-} from "../chunk-3OTECDNH.js";
+} from "../chunk-WXY5QP3M.js";
+import {
+  telegram
+} from "../chunk-5LT5J3NR.js";
+import "../chunk-34FQGGD7.js";
+import "../chunk-3B4QH4JG.js";
 import {
   terminal
-} from "../chunk-5BKZJMZV.js";
+} from "../chunk-U3LXXT3W.js";
 import "../chunk-NNY6LMSC.js";
 import {
   whatsappBusiness
-} from "../chunk-5TIF3FIE.js";
+} from "../chunk-Q537JPTG.js";
 import "../chunk-2D27WW5B.js";
-import "../chunk-MC6ZKFSG.js";
-import "../chunk-QGJFZMD5.js";
-import "../chunk-IPOFBAIM.js";
+import "../chunk-3GEJYGZK.js";
+import "../chunk-U7AWXDH6.js";
+import "../chunk-5XEFJBN2.js";
+import "../chunk-6UZFVXQF.js";
+import "../chunk-NGC4DJIX.js";
 import "../chunk-2ILTJC35.js";
 export {
   imessage,
   slack,
+  telegram,
   terminal,
   whatsappBusiness
 };

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

@@ -1,4 +1,4 @@
-import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-DcQ5a7PK.js';
+import { S as SchemaMessage, P as Platform, a as PlatformDef } from '../../types-Bje8aq1k.js';
 import * as z from 'zod';
 import z__default from 'zod';
 import * as _photon_ai_slack from '@photon-ai/slack';

package/dist/providers/slack/index.js

@@ -1,9 +1,10 @@
 import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
 import {
   slack
-} from "../../chunk-3OTECDNH.js";
-import "../../chunk-MC6ZKFSG.js";
-import "../../chunk-IPOFBAIM.js";
+} from "../../chunk-WXY5QP3M.js";
+import "../../chunk-3GEJYGZK.js";
+import "../../chunk-5XEFJBN2.js";
+import "../../chunk-NGC4DJIX.js";
 import "../../chunk-2ILTJC35.js";
 export {
   slack

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

@@ -0,0 +1,47 @@
+import { P as Platform, a as PlatformDef, g as ProviderMessage } from '../../types-Bje8aq1k.js';
+import * as _photon_ai_telegram_ts from '@photon-ai/telegram-ts';
+import * as zod_v4_core from 'zod/v4/core';
+import * as z from 'zod';
+import z__default from 'zod';
+import { F as FusorClient } from '../../types-BD0-kKyv.js';
+import 'hotscript';
+
+interface TelegramSpace {
+    id: string;
+}
+
+declare const configSchema: z__default.ZodObject<{
+    botToken: z__default.ZodString;
+    webhookSecret: z__default.ZodOptional<z__default.ZodString>;
+    baseUrl: z__default.ZodDefault<z__default.ZodURL>;
+}, z__default.core.$strip>;
+type TelegramConfig = z__default.infer<typeof configSchema>;
+
+/**
+ * Telegram provider for Spectrum.
+ *
+ * Inbound is delivered through Fusor: `createClient` returns a `fusor(...)`
+ * client whose `verify` checks the Telegram webhook secret token and parses the
+ * `Update` (pure parsing — no client). The `messages` handler reads `config`
+ * from its ctx and builds a photon client inline only to download media bytes.
+ * Outbound (`send`) also builds a photon client inline. Both go through
+ * `@photon-ai/telegram-ts`. Drop `telegram.config({...})` into
+ * `Spectrum({ providers: [...] })`.
+ *
+ * In cloud mode (`projectConfig` present), `createClient` also self-registers
+ * the bot's webhook against the Fusor edge for the project slug — see
+ * `ensureWebhook`. Without a slug (local/direct mode) registration is skipped.
+ */
+declare const telegram: Platform<PlatformDef<"telegram", z.ZodObject<{
+    botToken: z.ZodString;
+    webhookSecret: z.ZodOptional<z.ZodString>;
+    baseUrl: z.ZodDefault<z.ZodURL>;
+}, zod_v4_core.$strip>, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodType<object, unknown, zod_v4_core.$ZodTypeInternals<object, unknown>> | undefined, z.ZodObject<{
+    chatId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, zod_v4_core.$strip>, FusorClient<_photon_ai_telegram_ts.Update>, {
+    id: string;
+}, TelegramSpace, undefined, ProviderMessage<{
+    id: string;
+}, TelegramSpace, Record<never, never>>, undefined, Record<never, never>, Record<never, never>, Record<never, never>>> & Readonly<Record<never, never>>;
+
+export { type TelegramConfig, telegram };

package/dist/providers/telegram/index.js

@@ -0,0 +1,13 @@
+import { createRequire as __spectrumCreateRequire } from "node:module"; const require = __spectrumCreateRequire(import.meta.url);
+import {
+  telegram
+} from "../../chunk-5LT5J3NR.js";
+import "../../chunk-34FQGGD7.js";
+import "../../chunk-3B4QH4JG.js";
+import "../../chunk-NNY6LMSC.js";
+import "../../chunk-6UZFVXQF.js";
+import "../../chunk-NGC4DJIX.js";
+import "../../chunk-2ILTJC35.js";
+export {
+  telegram
+};