@mastra/telegram 0.1.2 → 0.1.3-alpha.0

package/dist/index.cjs

@@ -19375,7 +19375,7 @@ function isUint8Array(value) {
 	return Boolean(value && typeof value === "object" && "byteLength" in value && "byteOffset" in value);
 }
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/14ee40448e72892ca6b1a79ce3c73cfcc07649680e91ea4aeca432057a591587/node_modules/chat/dist/chunk-VB76CUI4.js
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/bf8128214e5ca45222a909d8e82dc4a6bbc779eb9b510d06add2841f98f9c957/node_modules/chat/dist/chunk-VB76CUI4.js
 function isListNode(node) {
 	return node.type === "list";
 }
@@ -20276,7 +20276,7 @@ var vn = (n, r) => {
 };
 var $e = vn;
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/14ee40448e72892ca6b1a79ce3c73cfcc07649680e91ea4aeca432057a591587/node_modules/chat/dist/chunk-BKACWYIW.js
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/bf8128214e5ca45222a909d8e82dc4a6bbc779eb9b510d06add2841f98f9c957/node_modules/chat/dist/chunk-BKACWYIW.js
 var adapterMap = /* @__PURE__ */ new WeakMap();
 var Message = class _Message {
 	/** Unique message ID */
@@ -20687,7 +20687,7 @@ function wrapTablesForAppend(text2, closeFences = false) {
 new AbortController().signal;
 new async_hooks.AsyncLocalStorage();
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/14ee40448e72892ca6b1a79ce3c73cfcc07649680e91ea4aeca432057a591587/node_modules/chat/dist/index.js
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@/chat/4.40.0/bf8128214e5ca45222a909d8e82dc4a6bbc779eb9b510d06add2841f98f9c957/node_modules/chat/dist/index.js
 var emojiRegistry = /* @__PURE__ */ new Map();
 function getEmoji(name) {
 	let emojiValue = emojiRegistry.get(name);
@@ -21353,7 +21353,7 @@ createEmoji();
 var cardChildToFallbackText2 = cardChildToFallbackText;
 var isCardElement2 = isCardElement;
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@chat-adapter/shared/4.40.0/f50d930fcde2981b5b16c44b7c4dcb90d9d0c5a07fcd239473ab6681cefdd7e6/node_modules/@chat-adapter/shared/dist/index.js
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@chat-adapter/shared/4.40.0/b8d1ffb3606d5fbc146955d209d67d901e1ac7e62c614258eabf21f6794389e3/node_modules/@chat-adapter/shared/dist/index.js
 function extractCard(message) {
 	if (isCardElement2(message)) return message;
 	if (typeof message === "object" && message !== null && "card" in message) return message.card;
@@ -21493,7 +21493,7 @@ function blocklist(ranges, family) {
 blocklist(IPV4, "ipv4");
 blocklist(IPV6, "ipv6");
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@chat-adapter/telegram/4.40.0/18bd366f4b53a423ff29d71914ab396f3b6c56390c99cb0e17b91653ebac5d68/node_modules/@chat-adapter/telegram/dist/index.js
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@chat-adapter/telegram/4.40.0/117ee55721c79f2050c97f5568d59cc1a8a9476541dcbc8fcd32561f0bae25c7/node_modules/@chat-adapter/telegram/dist/index.js
 var CALLBACK_DATA_PREFIX = "chat:";
 var TELEGRAM_CALLBACK_DATA_LIMIT_BYTES = 64;
 function convertLabel(label) {
@@ -24432,6 +24432,7 @@ var TelegramProvider = class {
 	/** Cached sync view of whether any active bot is registered (for {@link getInfo}). */
 	#configured = false;
 	#initPromise = null;
+	#connectingBotTokens = /* @__PURE__ */ new Set();
 	constructor(config = {}) {
 		this.#config = config;
 	}
@@ -24480,7 +24481,7 @@ var TelegramProvider = class {
 				properties: {
 					botToken: {
 						type: "string",
-						description: "BotFather bot token. Omit to receive a BotFather deep link instead."
+						description: "BotFather bot token. Omit to use the provider default token. If neither is set, returns a BotFather deep link."
 					},
 					name: {
 						type: "string",
@@ -24516,12 +24517,21 @@ var TelegramProvider = class {
 		}
 	}
 	/**
-	* Update runtime provider settings. Telegram has no global auth credential to
-	* clear (per-bot tokens are managed via {@link connect}/{@link disconnect}),
-	* so `null` is a no-op; an object merges `apiBaseUrl`/`baseUrl` overrides.
+	* Update runtime provider settings. Pass `botToken` to change the default
+	* bot token new {@link connect} calls fall back to when none is supplied
+	* per-agent (matching {@link SlackProvider.configure}'s rotation pattern);
+	* pass `apiBaseUrl`/`baseUrl` to point the adapter at a different host.
+	* `null` clears the default `botToken` only — per-bot installs are managed
+	* via {@link connect}/{@link disconnect}.
 	*/
 	async configure(credentials) {
-		if (credentials === null) return;
+		if (credentials === null) {
+			this.#config = {
+				...this.#config,
+				botToken: void 0
+			};
+			return;
+		}
 		const apiBaseUrlChanged = credentials.apiBaseUrl !== void 0 && credentials.apiBaseUrl !== this.#config.apiBaseUrl;
 		this.#config = {
 			...this.#config,
@@ -24541,17 +24551,18 @@ var TelegramProvider = class {
 	/**
 	* Connect an agent to a Telegram bot.
 	*
-	* - With `options.botToken`: validate via `getMe`, mint a per-bot webhook
-	*   secret, persist the installation, register the transport (webhook or
-	*   polling), and return `{ type: 'immediate' }`.
-	* - Without a token: persist a pending installation and return
+	* - With `options.botToken` or a provider default token: validate via `getMe`,
+	*   mint a per-bot webhook secret, persist the installation, register the
+	*   transport (webhook or polling), and return `{ type: 'immediate' }`.
+	* - Without either token: persist a pending installation and return
 	*   `{ type: 'deep_link' }` pointing at BotFather.
 	*/
 	async connect(agentId, options = {}) {
 		const store = await this.#getStore();
 		const existing = await store.getByAgent(agentId);
 		if (existing?.status === "active") throw new Error(`Agent "${agentId}" is already connected to Telegram. Disconnect first to reconnect.`);
-		if (!options.botToken) {
+		const botToken = options.botToken ?? this.#config.botToken;
+		if (!botToken) {
 			const installationId = existing?.id ?? (0, crypto$1.randomUUID)();
 			await store.save({
 				id: installationId,
@@ -24566,36 +24577,48 @@ var TelegramProvider = class {
 				installationId
 			};
 		}
-		const me = await getMe(options.botToken, this.#apiBaseUrl());
-		const installationId = existing?.id ?? (0, crypto$1.randomUUID)();
-		const webhookId = existing?.webhookId ?? (0, crypto$1.randomUUID)();
 		const baseUrl = this.#getBaseUrl();
 		const mode = this.#resolveMode(baseUrl);
 		if (mode === "webhook" && !baseUrl) throw new Error("TelegramProvider needs a baseUrl to register a webhook. Set `baseUrl`, configure the Mastra server, or use `mode: \"polling\"`.");
-		const webhookUrl = mode === "webhook" ? `${baseUrl}/${PLATFORM}/events/${webhookId}` : void 0;
-		const commands = normalizeCommands(options.commands ?? this.#config.commands ?? DEFAULT_COMMANDS);
-		const installation = {
-			id: installationId,
-			agentId,
-			webhookId,
-			status: "active",
-			botToken: options.botToken,
-			secretToken: generateSecretToken(),
-			username: options.name ?? me.username ?? me.first_name,
-			webhookUrl,
-			commands: commands.length ? commands : void 0,
-			installedAt: existing?.installedAt ?? /* @__PURE__ */ new Date()
-		};
-		await this.#registerTransport(installation, mode);
-		await this.#registerCommands(installation);
-		await store.save(installation);
-		await this.#activateInstallation(installation);
-		this.#configured = true;
-		await this.#config.onInstall?.(installation);
-		return {
-			type: "immediate",
-			installationId
-		};
+		if (mode === "webhook") {
+			if (this.#connectingBotTokens.has(botToken)) throw new Error("This Telegram bot is already being connected. Wait for that connection to finish.");
+			this.#connectingBotTokens.add(botToken);
+		}
+		try {
+			if (mode === "webhook") {
+				const duplicate = (await store.list()).find((i) => i.status === "active" && i.botToken === botToken);
+				if (duplicate) throw new Error(`This Telegram bot is already connected to agent "${duplicate.agentId}". Disconnect it before connecting another agent.`);
+			}
+			const me = await getMe(botToken, this.#apiBaseUrl());
+			const installationId = existing?.id ?? (0, crypto$1.randomUUID)();
+			const webhookId = existing?.webhookId ?? (0, crypto$1.randomUUID)();
+			const webhookUrl = mode === "webhook" ? `${baseUrl}/${PLATFORM}/events/${webhookId}` : void 0;
+			const commands = normalizeCommands(options.commands ?? this.#config.commands ?? DEFAULT_COMMANDS);
+			const installation = {
+				id: installationId,
+				agentId,
+				webhookId,
+				status: "active",
+				botToken,
+				secretToken: generateSecretToken(),
+				username: options.name ?? me.username ?? me.first_name,
+				webhookUrl,
+				commands: commands.length ? commands : void 0,
+				installedAt: existing?.installedAt ?? /* @__PURE__ */ new Date()
+			};
+			await this.#registerTransport(installation, mode);
+			await this.#registerCommands(installation);
+			await store.save(installation);
+			await this.#activateInstallation(installation);
+			this.#configured = true;
+			await this.#config.onInstall?.(installation);
+			return {
+				type: "immediate",
+				installationId
+			};
+		} finally {
+			if (mode === "webhook") this.#connectingBotTokens.delete(botToken);
+		}
 	}
 	/** Disconnect an agent from Telegram, removing its webhook and installation. */
 	async disconnect(agentId) {