@spectrum-ts/telegram 9.0.0 → 9.3.0

package/dist/index.js

@@ -1,45 +1,9 @@
 import { UnsupportedError, definePlatform, fusor, toVCard } from "@spectrum-ts/core";
-import z from "zod";
-import { asAttachment, asCustom, asGroup, asMarkdown, asReaction, asText, asVoice, renderInlineTokens, tracedFetch } from "@spectrum-ts/core/authoring";
 import { createTelegramClient, editMessageText, getFile, getWebhookInfo, sendChatAction, sendMessageDraft, setMessageReaction, setWebhook } from "@photon-ai/telegram-ts";
+import { asAttachment, asCustom, asGroup, asMarkdown, asReaction, asText, asVoice, renderInlineTokens, tracedFetch } from "@spectrum-ts/core/authoring";
+import z from "zod";
 import { Marked } from "marked";
 import { timingSafeEqual } from "node:crypto";
-//#region src/config.ts
-/**
-* The platform identifier — used for ALL THREE of:
-*
-* - the `definePlatform` name (so `message.platform` / `__platform` and
-*   the `platformStates` key are this value),
-* - the `fusor(...)` routing key the handler is registered under, and
-* - the value Fusor tags inbound Telegram events with (`event.platform`).
-*
-* Spectrum's webhook delivery looks the runtime up by `event.platform` against
-* the platform name (`platformStates.get(event.platform)`), while routing is by
-* the fusor key — so these MUST be the same string. It must also match Fusor's
-* configured platform identifier for Telegram (the `<platform>` path segment
-* the webhook is delivered under).
-*/
-const TELEGRAM_PLATFORM = "telegram";
-const configSchema = z.object({
-	/** Bot token from @BotFather (outbound API calls + media downloads). */
-	botToken: z.string().regex(/^\d+:[A-Za-z0-9_-]+$/, "botToken must be in the form '<id>:<token>'"),
-	/**
-	* The `secret_token` passed to `setWebhook`. When present, inbound webhooks
-	* are verified against the `X-Telegram-Bot-Api-Secret-Token` header; when
-	* omitted, the check is skipped. Telegram does not HMAC-sign the body, so
-	* this shared token is the only inbound authentication.
-	*/
-	webhookSecret: z.string().regex(/^[A-Za-z0-9_-]{1,256}$/).optional(),
-	/** Override the Bot API base URL. Defaults to `https://api.telegram.org`. */
-	baseUrl: z.url().default("https://api.telegram.org")
-});
-/**
-* The bot's own numeric id is the prefix of the token (`<id>:<hash>`). Used to
-* drop inbound updates the bot itself produced, so a bot never echoes its own
-* sends.
-*/
-const botIdFromToken = (botToken) => botToken.split(":")[0] ?? "";
-//#endregion
 //#region src/client.ts
 const REQUEST_TIMEOUT_MS = 3e4;
 const TRAILING_SLASHES = /\/+$/;
@@ -117,6 +81,60 @@ const downloadFile = async (config, fileId) => {
 	if (!res.ok) throw new Error(`Telegram media download failed: ${res.status} ${res.statusText}`);
 	return Buffer.from(await res.arrayBuffer());
 };
+/**
+* A chat's `title` via `getChat`. Only groups/supergroups/channels have one;
+* private chats return a name instead, so those resolve `undefined`.
+*/
+const getChatDisplayName = async (config, chatId) => {
+	return (await telegramClient(config).post({
+		body: { chat_id: chatId },
+		throwOnError: true,
+		url: "/getChat"
+	})).data.result?.title ?? void 0;
+};
+//#endregion
+//#region src/config.ts
+/**
+* The platform identifier — used for ALL THREE of:
+*
+* - the `definePlatform` name (so `message.platform` / `__platform` and
+*   the `platformStates` key are this value),
+* - the `fusor(...)` routing key the handler is registered under, and
+* - the value Fusor tags inbound Telegram events with (`event.platform`).
+*
+* Spectrum's webhook delivery looks the runtime up by `event.platform` against
+* the platform name (`platformStates.get(event.platform)`), while routing is by
+* the fusor key — so these MUST be the same string. It must also match Fusor's
+* configured platform identifier for Telegram (the `<platform>` path segment
+* the webhook is delivered under).
+*/
+const TELEGRAM_PLATFORM = "telegram";
+const configSchema = z.object({
+	/**
+	* Bot token from @BotFather (outbound API calls + media downloads). Falls back
+	* to `SPECTRUM_TELEGRAM_BOT_TOKEN` when omitted (explicit config wins).
+	*/
+	botToken: z.string().regex(/^\d+:[A-Za-z0-9_-]+$/, "botToken must be in the form '<id>:<token>'"),
+	/**
+	* The `secret_token` passed to `setWebhook`. When present, inbound webhooks
+	* are verified against the `X-Telegram-Bot-Api-Secret-Token` header; when
+	* omitted, the check is skipped. Telegram does not HMAC-sign the body, so
+	* this shared token is the only inbound authentication. Falls back to
+	* `SPECTRUM_TELEGRAM_WEBHOOK_SECRET` when omitted.
+	*/
+	webhookSecret: z.string().regex(/^[A-Za-z0-9_-]{1,256}$/).optional(),
+	/**
+	* Override the Bot API base URL. Precedence is explicit config >
+	* `SPECTRUM_TELEGRAM_BASE_URL` > the `https://api.telegram.org` default.
+	*/
+	baseUrl: z.url().default("https://api.telegram.org")
+});
+/**
+* The bot's own numeric id is the prefix of the token (`<id>:<hash>`). Used to
+* drop inbound updates the bot itself produced, so a bot never echoes its own
+* sends.
+*/
+const botIdFromToken = (botToken) => botToken.split(":")[0] ?? "";
 //#endregion
 //#region src/inbound/media.ts
 const DEFAULT_VIDEO_MIME = "video/mp4";
@@ -908,6 +926,7 @@ const telegram = definePlatform(TELEGRAM_PLATFORM, {
 	} },
 	user: { resolve: resolveUser },
 	space: { create: createSpace },
+	actions: { getDisplayName: async ({ config }, space) => await getChatDisplayName(config, space.id) },
 	messages: handleMessages,
 	send
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spectrum-ts/telegram",
-  "version": "9.0.0",
+  "version": "9.3.0",
   "description": "Telegram provider for spectrum-ts.",
   "repository": {
     "type": "git",