@decaf-ts/integrations 0.11.0 → 0.14.0

package/lib/cjs/comms/teams/TeamsService.cjs

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamsService = void 0;
+/**
+ * @module integrations/comms/teams/service
+ * @summary Microsoft Teams integration service for webhook and Microsoft Graph channel messaging.
+ * @description Exposes two delivery paths as an undecorated client-based
+ * service built on {@link HttpApiService}: incoming-webhook
+ * `MessageCard` delivery (no Graph token required) and Microsoft Graph
+ * channel messaging, team listing, and channel listing (requires a Graph
+ * access token). Configuration comes from an explicit `TeamsServiceConfig`
+ * or the `comms.teams` environment slice, and failures are mapped to decaf
+ * errors via {@link httpError}.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const axios_1 = __importDefault(require("axios"));
+const environment_js_1 = require("./../environment.cjs");
+const environmentValue_js_1 = require("./../../shared/environmentValue.cjs");
+const index_js_1 = require("./../../shared/http/index.cjs");
+/**
+ * @description Microsoft Teams integration service
+ * @summary An undecorated HTTP service combining incoming-webhook
+ * delivery (needs only `webhookUrl`) with Microsoft Graph operations — channel
+ * messaging, team listing, and channel listing (need a Graph `token`).
+ * Webhook delivery posts an Office 365 `MessageCard` directly to the
+ * configured URL; Graph operations go through the service client with bearer
+ * auth, require a token (`requireToken()`), and map transport failures to
+ * decaf errors via {@link httpError}.
+ * @class TeamsService
+ * @category Comms
+ * @example
+ * ```ts
+ * import { TeamsService } from "@decaf-ts/integrations/comms/teams";
+ *
+ * const teams = new TeamsService();
+ * await teams.initialize({
+ *   webhookUrl: process.env.GRAPH_CREDENTIAL_TEAMS_WEBHOOK_URL,
+ *   token: process.env.GRAPH_CREDENTIAL_TEAMS_TOKEN,
+ * });
+ * await teams.sendWebhook({ title: "Deploy", text: "Release 1.2.0 is live" });
+ * ```
+ * @memberOf module:integrations/comms/teams/service
+ */
+class TeamsService extends index_js_1.HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Microsoft Teams";
+    }
+    /**
+     * @description The Microsoft Graph v1.0 base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://graph.microsoft.com/v1.0"`.
+     */
+    defaultBaseUrl() {
+        return "https://graph.microsoft.com/v1.0";
+    }
+    /**
+     * @description Builds the Microsoft Graph bearer authorization headers
+     * @summary Returns the `Authorization: Bearer <token>` header when the
+     * config carries a token, and no headers otherwise.
+     * @param {TeamsServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { Authorization: `Bearer ${config.token}` } : {};
+    }
+    /**
+     * @description Reads the Teams credentials and defaults from the environment
+     * @summary Reads the `comms.teams` environment slice and returns a partial
+     * config when a Graph token or webhook URL is configured, `undefined`
+     * otherwise. Values pass through `envString`/`envNumber` to reject
+     * unset-leaf proxies.
+     * @returns {Partial<TeamsServiceConfig> | undefined} A partial config, or `undefined` when neither token nor webhook URL is configured.
+     */
+    configFromEnvironment() {
+        const env = environment_js_1.CommsEnvironment.comms.teams;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        const webhookUrl = (0, environmentValue_js_1.envString)(env?.webhookUrl);
+        if (!token && !webhookUrl)
+            return undefined;
+        return {
+            token,
+            webhookUrl,
+            baseUrl: (0, environmentValue_js_1.envString)(env?.baseUrl),
+            timeout: (0, environmentValue_js_1.envNumber)(env?.timeout),
+        };
+    }
+    /**
+     * @description Delivers a MessageCard through the configured incoming webhook
+     * @summary Posts an Office 365 `MessageCard` (`@type: "MessageCard"`) with
+     * the title, text, and markdown flag directly to `config.webhookUrl` using
+     * a standalone Axios call (no Graph token involved). Requires a configured
+     * webhook URL.
+     * @param {TeamsWebhookMessage} input - The card title, text, and markdown flag.
+     * @returns {Promise<unknown>} The raw webhook response payload.
+     * @throws {InternalError} When no webhook URL is configured.
+     * @throws {NotFoundError} When the webhook endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the webhook endpoint answers with HTTP 409.
+     * @throws {BadRequestError} When the webhook endpoint answers with any other HTTP error status.
+     */
+    async sendWebhook(input) {
+        const webhookUrl = this.config.webhookUrl;
+        if (!webhookUrl) {
+            throw new db_decorators_1.InternalError("Microsoft Teams requires a webhook URL");
+        }
+        try {
+            const response = await axios_1.default.post(webhookUrl, {
+                "@type": "MessageCard",
+                "@context": "https://schema.org/extensions",
+                summary: input.title ?? input.text,
+                title: input.title,
+                text: input.text,
+                markdown: input.markdown ?? true,
+            }, { timeout: this.config.timeout ?? 30000 });
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Microsoft Teams", "webhook delivery", error);
+        }
+    }
+    /**
+     * @description Sends a message into a Teams channel through Microsoft Graph
+     * @summary `POST`s a chat message to
+     * `/teams/<teamId>/channels/<channelId>/messages` with the given content
+     * type (`text` by default, or `html`). Requires a Graph token and both a
+     * team and channel ID; IDs are URL-encoded.
+     * @param {TeamsChannelMessage} input - The target team/channel and the message content.
+     * @returns {Promise<unknown>} The raw Graph message payload.
+     * @throws {InternalError} When no token is configured or the team/channel IDs are missing.
+     * @throws {NotFoundError} When the team or channel does not exist (HTTP 404).
+     * @throws {ConflictError} When Graph answers with HTTP 409.
+     * @throws {BadRequestError} When Graph answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * await teams.sendChannelMessage({
+     *   teamId: "team-id",
+     *   channelId: "channel-id",
+     *   content: "<b>Release</b> 1.2.0 is live",
+     *   contentType: "html",
+     * });
+     * ```
+     */
+    async sendChannelMessage(input) {
+        this.requireToken();
+        if (!input.teamId || !input.channelId) {
+            throw new db_decorators_1.InternalError("Microsoft Teams channel messages require a team and channel");
+        }
+        try {
+            const response = await this.client.post(`/teams/${encodeURIComponent(input.teamId)}/channels/${encodeURIComponent(input.channelId)}/messages`, {
+                body: {
+                    contentType: input.contentType ?? "text",
+                    content: input.content,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Microsoft Teams", "channel message", error);
+        }
+    }
+    /**
+     * @description Lists Teams accessible to the authenticated identity
+     * @summary `GET`s `/teams` with a `$top` page size (default `50`) and
+     * returns the raw Graph `team` payloads.
+     * @param {number} [limit] - Maximum number of teams to return; defaults to `50`.
+     * @returns {Promise<Array<Record<string, unknown>>>} The raw Graph `team` payloads.
+     * @throws {InternalError} When no token is configured.
+     * @throws {NotFoundError} When Graph answers with HTTP 404.
+     * @throws {ConflictError} When Graph answers with HTTP 409.
+     * @throws {BadRequestError} When Graph answers with any other HTTP error status.
+     */
+    async listTeams(limit = 50) {
+        this.requireToken();
+        try {
+            const response = await this.client.get("/teams", { params: { $top: limit } });
+            return response.data.value ?? [];
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Microsoft Teams", "list teams", error);
+        }
+    }
+    /**
+     * @description Lists channels of a Teams team
+     * @summary `GET`s `/teams/<teamId>/channels` and returns the raw Graph
+     * `channel` payloads; the team ID is URL-encoded.
+     * @param {string} teamId - The ID of the team whose channels are listed.
+     * @returns {Promise<Array<Record<string, unknown>>>} The raw Graph `channel` payloads.
+     * @throws {InternalError} When no token is configured.
+     * @throws {NotFoundError} When the team does not exist (HTTP 404).
+     * @throws {ConflictError} When Graph answers with HTTP 409.
+     * @throws {BadRequestError} When Graph answers with any other HTTP error status.
+     */
+    async listChannels(teamId) {
+        this.requireToken();
+        try {
+            const response = await this.client.get(`/teams/${encodeURIComponent(teamId)}/channels`);
+            return response.data.value ?? [];
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Microsoft Teams", "list channels", error);
+        }
+    }
+}
+exports.TeamsService = TeamsService;
+//# sourceMappingURL=TeamsService.js.map
+//# sourceMappingURL=TeamsService.cjs.map

package/lib/cjs/comms/teams/TeamsService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms/teams/TeamsService.cjs","sourceRoot":"","sources":["comms/teams/TeamsService.js"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;GAUG;AACH,2DAAwD;AACxD,kDAA0B;AAC1B,wDAAuD;AACvD,4EAA0E;AAC1E,2DAA0E;AAC1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,YAAa,SAAQ,yBAAc;IAC5C;QACI,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;QACpB;;WAEG;QACH,IAAI,CAAC,WAAW,GAAG,iBAAiB,CAAC;IACzC,CAAC;IACD;;;;OAIG;IACH,cAAc;QACV,OAAO,kCAAkC,CAAC;IAC9C,CAAC;IACD;;;;;;OAMG;IACH,WAAW,CAAC,MAAM;QACd,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD;;;;;;;OAOG;IACH,qBAAqB;QACjB,MAAM,GAAG,GAAG,iCAAgB,CAAC,KAAK,CAAC,KAAK,CAAC;QACzC,MAAM,KAAK,GAAG,IAAA,+BAAS,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,UAAU,GAAG,IAAA,+BAAS,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU;YACrB,OAAO,SAAS,CAAC;QACrB,OAAO;YACH,KAAK;YACL,UAAU;YACV,OAAO,EAAE,IAAA,+BAAS,EAAC,GAAG,EAAE,OAAO,CAAC;YAChC,OAAO,EAAE,IAAA,+BAAS,EAAC,GAAG,EAAE,OAAO,CAAC;SACnC,CAAC;IACN,CAAC;IACD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,WAAW,CAAC,KAAK;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,6BAAa,CAAC,wCAAwC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,UAAU,EAAE;gBAC1C,OAAO,EAAE,aAAa;gBACtB,UAAU,EAAE,+BAA+B;gBAC3C,OAAO,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI;gBAClC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;aACnC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;IACL,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAAK;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,6BAAa,CAAC,6DAA6D,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;gBAC3I,IAAI,EAAE;oBACF,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,MAAM;oBACxC,OAAO,EAAE,KAAK,CAAC,OAAO;iBACzB;aACJ,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,iBAAiB,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IACD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,CAAC,KAAK,GAAG,EAAE;QACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,iBAAiB,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IACD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,MAAM;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACxF,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,iBAAiB,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;CACJ;AAlKD,oCAkKC;AACD,wCAAwC"}

package/lib/cjs/comms/teams/index.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/comms/teams
+ * @summary Microsoft Teams service (webhook posts and Graph channel messaging).
+ * @description Re-exports the Teams client-based service and its types.
+ */
+__exportStar(require("./TeamsService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/comms/teams/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms/teams/index.cjs","sourceRoot":"","sources":["comms/teams/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,oDAAkC;AAClC,iCAAiC"}

package/lib/cjs/comms/telegram/TelegramService.cjs

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramService = void 0;
+/**
+ * @module integrations/comms/telegram/service
+ * @summary Telegram Bot API integration service for sending messages and reading updates.
+ * @description Exposes the Telegram Bot API (`getMe`, `sendMessage`,
+ * `getUpdates`, `sendChatAction`) as an undecorated client-based service built
+ * on {@link HttpApiService}. The bot token is part of the request
+ * path (`/bot<token>/<method>`); configuration comes from an explicit
+ * `TelegramServiceConfig` or the `comms.telegram` environment slice, and
+ * failures are mapped to decaf errors via {@link httpError}.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const environment_js_1 = require("./../environment.cjs");
+const environmentValue_js_1 = require("./../../shared/environmentValue.cjs");
+const index_js_1 = require("./../../shared/http/index.cjs");
+/**
+ * @description Telegram Bot API integration service
+ * @summary An undecorated HTTP service for verifying the bot
+ * identity, sending messages with parse modes and reply/thread options, long
+ * or short polling `getUpdates`, and posting chat actions. The bot token is
+ * required (`requireToken()`) and embedded in the request path; non-`ok` Bot
+ * API responses raise `InternalError`, and transport failures are mapped to
+ * decaf errors via {@link httpError}.
+ * @class TelegramService
+ * @category Comms
+ * @example
+ * ```ts
+ * import { TelegramService } from "@decaf-ts/integrations/comms/telegram";
+ *
+ * const telegram = new TelegramService();
+ * await telegram.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_TELEGRAM_TOKEN,
+ * });
+ * await telegram.sendMessage({
+ *   chatId: "@mychannel",
+ *   text: "Release 1.2.0 is live",
+ *   parseMode: "HTML",
+ * });
+ * ```
+ * @memberOf module:integrations/comms/telegram/service
+ */
+class TelegramService extends index_js_1.HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Telegram";
+    }
+    /**
+     * @description The Telegram Bot API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://api.telegram.org"`.
+     */
+    defaultBaseUrl() {
+        return "https://api.telegram.org";
+    }
+    /**
+     * @description Reads the Telegram credentials and defaults from the environment
+     * @summary Reads the `comms.telegram` environment slice and returns a
+     * partial config when a token is configured, `undefined` otherwise. Values
+     * pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<TelegramServiceConfig> | undefined} A partial config, or `undefined` when no Telegram token is configured.
+     */
+    configFromEnvironment() {
+        const env = environment_js_1.CommsEnvironment.comms.telegram;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.envNumber)(env.timeout),
+        };
+    }
+    /**
+     * @description Calls a Telegram Bot API method with the configured bot token
+     * @summary Shared request path for all Telegram operations: resolves the
+     * token (`requireToken()`), `POST`s the payload to
+     * `/bot<token>/<method>`, rejects non-`ok` Bot API responses with an
+     * `InternalError`, and maps transport failures through {@link httpError}.
+     * @template T - The expected `result` payload type of the Bot API response.
+     * @param {string} method - The Bot API method name (e.g. `"sendMessage"`).
+     * @param {Record<string, unknown>} [payload] - The JSON body for the method; defaults to an empty object.
+     * @returns {Promise<T>} The `result` payload of the Bot API response.
+     * @throws {InternalError} When no token is configured or the Bot API answers with `ok: false`.
+     * @throws {NotFoundError} When the endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the endpoint answers with HTTP 409.
+     * @throws {BadRequestError} When the endpoint answers with any other HTTP error status.
+     */
+    async call(method, payload = {}) {
+        const token = this.requireToken();
+        try {
+            const response = await this.client.post(`/bot${token}/${method}`, payload);
+            const data = response.data;
+            if (!data || data.ok !== true) {
+                throw new db_decorators_1.InternalError(`Telegram Bot API ${method} failed: ${data?.description ?? "unknown error"}`);
+            }
+            return data.result;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Telegram", `Bot API ${method}`, error);
+        }
+    }
+    /**
+     * @description Fetches the authenticated bot's identity
+     * @summary Calls the `getMe` method and returns the raw bot descriptor
+     * (including `id`, `username`, and `can_join_groups` flags).
+     * @returns {Promise<Record<string, unknown>>} The raw `User` payload describing the bot.
+     * @throws {InternalError} When no token is configured or the Bot API rejects the call.
+     * @throws {NotFoundError} When the endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the endpoint answers with HTTP 409.
+     * @throws {BadRequestError} When the endpoint answers with any other HTTP error status.
+     */
+    async getMe() {
+        return this.call("getMe");
+    }
+    /**
+     * @description Sends a message to a Telegram chat
+     * @summary Calls the `sendMessage` method with the destination chat, text,
+     * and the requested parse/notification/reply/thread options, returning the
+     * sent message descriptor.
+     * @param {TelegramSendMessageInput} input - The message destination, content, and options.
+     * @returns {Promise<TelegramMessage>} The sent message descriptor.
+     * @throws {InternalError} When no token is configured or the Bot API rejects the message.
+     * @throws {NotFoundError} When the endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the endpoint answers with HTTP 409.
+     * @throws {BadRequestError} When the endpoint answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * await telegram.sendMessage({
+     *   chatId: "-1001234567890",
+     *   text: "*Release* 1.2.0 is live",
+     *   parseMode: "MarkdownV2",
+     *   disableNotification: true,
+     * });
+     * ```
+     */
+    async sendMessage(input) {
+        return this.call("sendMessage", {
+            chat_id: input.chatId,
+            text: input.text,
+            parse_mode: input.parseMode,
+            disable_notification: input.disableNotification,
+            disable_web_page_preview: input.disablePreview,
+            reply_to_message_id: input.replyToMessageId,
+            message_thread_id: input.messageThreadId,
+        });
+    }
+    /**
+     * @description Polls pending bot updates
+     * @summary Calls the `getUpdates` method, optionally with an `offset`
+     * (confirmation of processed updates), a `limit` on returned updates, and a
+     * long-polling `timeoutSeconds`. Advance `offset` past each handled
+     * update's `update_id` to avoid re-reading them.
+     * @param {object} [options] - Polling options.
+     * @param {number} [options.offset] - The first update ID to return (previous ID + 1).
+     * @param {number} [options.limit] - Maximum number of updates to return (1-100).
+     * @param {number} [options.timeoutSeconds] - Long-polling timeout in seconds.
+     * @returns {Promise<Array<Record<string, unknown>>>} The raw `Update` payloads.
+     * @throws {InternalError} When no token is configured or the Bot API rejects the call.
+     * @throws {NotFoundError} When the endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the endpoint answers with HTTP 409 (e.g. another `getUpdates` call is in flight).
+     * @throws {BadRequestError} When the endpoint answers with any other HTTP error status.
+     */
+    async getUpdates(options = {}) {
+        return this.call("getUpdates", {
+            offset: options.offset,
+            limit: options.limit,
+            timeout: options.timeoutSeconds,
+        });
+    }
+    /**
+     * @description Posts a chat action (typing indicator)
+     * @summary Calls the `sendChatAction` method so clients display the given
+     * action (e.g. `"typing"`) for up to five seconds.
+     * @param {string | number} chatId - The destination chat ID or `@channelusername`.
+     * @param {string} [action] - The action to display; defaults to `"typing"`.
+     * @returns {Promise<boolean>} Whether the action was accepted.
+     * @throws {InternalError} When no token is configured or the Bot API rejects the call.
+     * @throws {NotFoundError} When the endpoint answers with HTTP 404.
+     * @throws {ConflictError} When the endpoint answers with HTTP 409.
+     * @throws {BadRequestError} When the endpoint answers with any other HTTP error status.
+     */
+    async sendChatAction(chatId, action = "typing") {
+        return this.call("sendChatAction", {
+            chat_id: chatId,
+            action,
+        });
+    }
+}
+exports.TelegramService = TelegramService;
+//# sourceMappingURL=TelegramService.js.map
+//# sourceMappingURL=TelegramService.cjs.map

package/lib/cjs/comms/telegram/TelegramService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms/telegram/TelegramService.cjs","sourceRoot":"","sources":["comms/telegram/TelegramService.js"],"names":[],"mappings":"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"}

package/lib/cjs/comms/telegram/index.cjs

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/comms/telegram
+ * @summary Telegram Bot API service (messaging, updates, chat actions).
+ * @description Re-exports the Telegram client-based service and its types.
+ */
+__exportStar(require("./TelegramService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/comms/telegram/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"comms/telegram/index.cjs","sourceRoot":"","sources":["comms/telegram/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,uDAAqC;AACrC,iCAAiC"}