@contractspec/integration.providers-impls 3.7.7 → 3.8.2

package/dist/impls/index.d.ts

@@ -19,6 +19,7 @@ export * from './jira';
 export * from './linear';
 export * from './messaging-github';
 export * from './messaging-slack';
+export * from './messaging-telegram';
 export * from './messaging-whatsapp-meta';
 export * from './messaging-whatsapp-twilio';
 export * from './mistral-conversational';

package/dist/impls/index.js

@@ -4329,6 +4329,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -7071,6 +7115,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),
@@ -7449,6 +7499,7 @@ export {
   TwilioWhatsappMessagingProvider,
   TwilioSmsProvider,
   TldvMeetingRecorderProvider,
+  TelegramMessagingProvider,
   SupabaseVectorProvider,
   SupabasePostgresProvider,
   StripePaymentsProvider,

package/dist/impls/messaging-telegram.d.ts

@@ -0,0 +1,13 @@
+import type { MessagingProvider, MessagingSendInput, MessagingSendResult } from '../messaging';
+export interface TelegramMessagingProviderOptions {
+    botToken: string;
+    defaultChatId?: string;
+    apiBaseUrl?: string;
+}
+export declare class TelegramMessagingProvider implements MessagingProvider {
+    private readonly botToken;
+    private readonly defaultChatId?;
+    private readonly apiBaseUrl;
+    constructor(options: TelegramMessagingProviderOptions);
+    sendMessage(input: MessagingSendInput): Promise<MessagingSendResult>;
+}

package/dist/impls/messaging-telegram.js

@@ -0,0 +1,49 @@
+// @bun
+var __require = import.meta.require;
+
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+export {
+  TelegramMessagingProvider
+};

package/dist/impls/provider-factory.js

@@ -3203,6 +3203,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -5945,6 +5989,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),

package/dist/index.js

@@ -4347,6 +4347,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -7089,6 +7133,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),
@@ -7496,6 +7546,7 @@ export {
   TwilioWhatsappMessagingProvider,
   TwilioSmsProvider,
   TldvMeetingRecorderProvider,
+  TelegramMessagingProvider,
   SupabaseVectorProvider,
   SupabasePostgresProvider,
   StripePaymentsProvider,

package/dist/node/impls/index.js

@@ -4329,6 +4329,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -7071,6 +7115,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),
@@ -7449,6 +7499,7 @@ export {
   TwilioWhatsappMessagingProvider,
   TwilioSmsProvider,
   TldvMeetingRecorderProvider,
+  TelegramMessagingProvider,
   SupabaseVectorProvider,
   SupabasePostgresProvider,
   StripePaymentsProvider,

package/dist/node/impls/messaging-telegram.js

@@ -0,0 +1,49 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+export {
+  TelegramMessagingProvider
+};

package/dist/node/impls/provider-factory.js

@@ -3203,6 +3203,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -5945,6 +5989,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),

package/dist/node/index.js

@@ -4347,6 +4347,50 @@ class SlackMessagingProvider {
   }
 }
 
+// src/impls/messaging-telegram.ts
+class TelegramMessagingProvider {
+  botToken;
+  defaultChatId;
+  apiBaseUrl;
+  constructor(options) {
+    this.botToken = options.botToken;
+    this.defaultChatId = options.defaultChatId;
+    this.apiBaseUrl = options.apiBaseUrl ?? "https://api.telegram.org";
+  }
+  async sendMessage(input) {
+    const chatId = input.channelId ?? input.recipientId ?? this.defaultChatId ?? undefined;
+    if (!chatId) {
+      throw new Error("Telegram sendMessage requires channelId, recipientId, or defaultChatId.");
+    }
+    const messageThreadId = input.threadId && input.threadId !== chatId ? Number.parseInt(input.threadId, 10) : undefined;
+    const response = await fetch(`${this.apiBaseUrl}/bot${this.botToken}/sendMessage`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json"
+      },
+      body: JSON.stringify({
+        chat_id: chatId,
+        text: input.text,
+        message_thread_id: Number.isFinite(messageThreadId) ? messageThreadId : undefined
+      })
+    });
+    const body = await response.json();
+    const providerMessageId = body.result?.message_id;
+    if (!response.ok || !body.ok || providerMessageId == null) {
+      throw new Error(`Telegram sendMessage failed: ${body.description ?? `HTTP_${response.status}`}`);
+    }
+    return {
+      id: `telegram:${chatId}:${providerMessageId}`,
+      providerMessageId: String(providerMessageId),
+      status: "sent",
+      sentAt: new Date,
+      metadata: {
+        chatId: String(body.result?.chat?.id ?? chatId)
+      }
+    };
+  }
+}
+
 // src/impls/messaging-whatsapp-meta.ts
 class MetaWhatsappMessagingProvider {
   accessToken;
@@ -7089,6 +7133,12 @@ class IntegrationProviderFactory {
           defaultRepo: config?.defaultRepo,
           apiBaseUrl: config?.apiBaseUrl
         });
+      case "messaging.telegram":
+        return new TelegramMessagingProvider({
+          botToken: requireSecret(secrets, "botToken", "Telegram bot token is required"),
+          defaultChatId: config?.defaultChatId,
+          apiBaseUrl: config?.apiBaseUrl
+        });
       case "messaging.whatsapp.meta":
         return new MetaWhatsappMessagingProvider({
           accessToken: requireSecret(secrets, "accessToken", "Meta WhatsApp access token is required"),
@@ -7496,6 +7546,7 @@ export {
   TwilioWhatsappMessagingProvider,
   TwilioSmsProvider,
   TldvMeetingRecorderProvider,
+  TelegramMessagingProvider,
   SupabaseVectorProvider,
   SupabasePostgresProvider,
   StripePaymentsProvider,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/integration.providers-impls",
-  "version": "3.7.7",
+  "version": "3.8.2",
   "description": "Integration provider implementations for email, payments, storage, and more",
   "keywords": [
     "contractspec",
@@ -32,9 +32,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "4.0.0",
-    "@contractspec/lib.contracts-integrations": "3.7.7",
-    "@contractspec/integration.runtime": "3.7.7",
+    "@contractspec/lib.contracts-spec": "4.1.2",
+    "@contractspec/lib.contracts-integrations": "3.8.2",
+    "@contractspec/integration.runtime": "3.8.2",
     "@elevenlabs/elevenlabs-js": "^2.38.1",
     "@fal-ai/client": "^1.9.4",
     "@google-cloud/storage": "^7.19.0",
@@ -56,9 +56,9 @@
   },
   "devDependencies": {
     "@types/bun": "1.3.11",
-    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.typescript": "3.7.8",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.6"
+    "@contractspec/tool.bun": "3.7.8"
   },
   "exports": {
     ".": {
@@ -319,6 +319,12 @@
       "node": "./dist/node/impls/messaging-slack.js",
       "default": "./dist/impls/messaging-slack.js"
     },
+    "./impls/messaging-telegram": {
+      "types": "./dist/impls/messaging-telegram.d.ts",
+      "bun": "./dist/impls/messaging-telegram.js",
+      "node": "./dist/node/impls/messaging-telegram.js",
+      "default": "./dist/impls/messaging-telegram.js"
+    },
     "./impls/messaging-whatsapp-meta": {
       "types": "./dist/impls/messaging-whatsapp-meta.d.ts",
       "bun": "./dist/impls/messaging-whatsapp-meta.js",
@@ -779,6 +785,12 @@
         "node": "./dist/node/impls/messaging-slack.js",
         "default": "./dist/impls/messaging-slack.js"
       },
+      "./impls/messaging-telegram": {
+        "types": "./dist/impls/messaging-telegram.d.ts",
+        "bun": "./dist/impls/messaging-telegram.js",
+        "node": "./dist/node/impls/messaging-telegram.js",
+        "default": "./dist/impls/messaging-telegram.js"
+      },
       "./impls/messaging-whatsapp-meta": {
         "types": "./dist/impls/messaging-whatsapp-meta.d.ts",
         "bun": "./dist/impls/messaging-whatsapp-meta.js",