@vercel/connect 2.6.0 → 2.7.0-snapshot-c4002eb2617b

package/README.md

@@ -224,6 +224,21 @@ export default teamsChannel({
 });
 ```
 
+For Telegram, `connectTelegramCredentials` resolves the bot token and verifies
+updates that Connect forwards with Vercel OIDC. Connect registers the bot's
+webhook and checks Telegram's secret-token header, so the deployment holds no
+bot token or webhook secret.
+
+```ts
+import { connectTelegramCredentials } from '@vercel/connect/eve';
+import { telegramChannel } from 'eve/channels/telegram';
+
+export default telegramChannel({
+  botUsername: 'my_bot',
+  credentials: connectTelegramCredentials('telegram/my-agent'),
+});
+```
+
 ```ts
 import { defineMcpClientConnection } from 'eve/connections';
 import { connect } from '@vercel/connect/eve';

package/dist/eve/index.d.ts

@@ -17,3 +17,4 @@ export { connectTeamsCredentials, type ConnectTeamsCredentialsParams, } from './
 export { connectPhotonCredentials, type ConnectPhotonCredentialProvider, type PhotonCredentials, type ConnectPhotonCredentialsParams, } from './photon-credentials.js';
 export { connectSlackCredentials, type ConnectSlackCredentialsParams, } from './slack-credentials.js';
 export { connectSendblueCredentials, type ConnectSendblueCredentials, type ConnectSendblueCredentialsParams, } from './sendblue-credentials.js';
+export { connectTelegramCredentials, type ConnectTelegramCredentialsParams, } from './telegram-credentials.js';

package/dist/eve/index.js

@@ -17,3 +17,4 @@ export { connectTeamsCredentials, } from './microsoft-teams-credentials.js';
 export { connectPhotonCredentials, } from './photon-credentials.js';
 export { connectSlackCredentials, } from './slack-credentials.js';
 export { connectSendblueCredentials, } from './sendblue-credentials.js';
+export { connectTelegramCredentials, } from './telegram-credentials.js';

package/dist/eve/telegram-credentials.d.ts

@@ -0,0 +1,30 @@
+import type { TelegramChannelCredentials } from 'eve/channels/telegram';
+import { type ConnectOptions, type ConnectTokenParams } from '../index.js';
+/**
+ * Token parameters accepted by {@link connectTelegramCredentials}.
+ *
+ * Mirrors {@link ConnectTokenParams} from `@vercel/connect`, minus
+ * `subject`. Telegram bot tokens are app-scoped, so this helper pins the
+ * subject to `{ type: "app" }`.
+ */
+export type ConnectTelegramCredentialsParams = Omit<ConnectTokenParams, 'subject'>;
+/**
+ * Build {@link TelegramChannelCredentials} backed by a Vercel Connect
+ * Telegram connector.
+ *
+ * Connect registers the bot's webhook, checks Telegram's secret-token header,
+ * and forwards each update with a Vercel OIDC token. `webhookVerifier`
+ * validates that token, so the eve deployment needs neither
+ * `TELEGRAM_BOT_TOKEN` nor `TELEGRAM_WEBHOOK_SECRET_TOKEN`.
+ *
+ * ```ts
+ * import { connectTelegramCredentials } from '@vercel/connect/eve';
+ * import { telegramChannel } from 'eve/channels/telegram';
+ *
+ * export default telegramChannel({
+ *   botUsername: 'my_bot',
+ *   credentials: connectTelegramCredentials('telegram/my-agent'),
+ * });
+ * ```
+ */
+export declare function connectTelegramCredentials(connector: string, params?: ConnectTelegramCredentialsParams, options?: ConnectOptions): TelegramChannelCredentials;

package/dist/eve/telegram-credentials.js

@@ -0,0 +1,27 @@
+import { createConnectWebhookVerifier } from '../chat/webhook-verifier.js';
+import { getToken, } from '../index.js';
+/**
+ * Build {@link TelegramChannelCredentials} backed by a Vercel Connect
+ * Telegram connector.
+ *
+ * Connect registers the bot's webhook, checks Telegram's secret-token header,
+ * and forwards each update with a Vercel OIDC token. `webhookVerifier`
+ * validates that token, so the eve deployment needs neither
+ * `TELEGRAM_BOT_TOKEN` nor `TELEGRAM_WEBHOOK_SECRET_TOKEN`.
+ *
+ * ```ts
+ * import { connectTelegramCredentials } from '@vercel/connect/eve';
+ * import { telegramChannel } from 'eve/channels/telegram';
+ *
+ * export default telegramChannel({
+ *   botUsername: 'my_bot',
+ *   credentials: connectTelegramCredentials('telegram/my-agent'),
+ * });
+ * ```
+ */
+export function connectTelegramCredentials(connector, params = {}, options) {
+    return {
+        botToken: () => getToken(connector, { ...params, subject: { type: 'app' } }, options),
+        webhookVerifier: createConnectWebhookVerifier(),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/connect",
-  "version": "2.6.0",
+  "version": "2.7.0-snapshot-c4002eb2617b",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -59,7 +59,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ai": "^6 || ^7.0.0-beta.0",
     "better-auth": ">=1.5.0",
-    "eve": ">=0.39.1"
+    "eve": ">=0.39.1 || >=1.0.0-0"
   },
   "peerDependenciesMeta": {
     "@ai-sdk/mcp": {