@decaf-ts/integrations 0.11.0 → 0.14.0

package/lib/esm/comms/telegram/TelegramService.js

@@ -0,0 +1,191 @@
+/**
+ * @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}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { CommsEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @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
+ */
+export class TelegramService extends 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 = CommsEnvironment.comms.telegram;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: envString(env.baseUrl),
+            timeout: 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 InternalError(`Telegram Bot API ${method} failed: ${data?.description ?? "unknown error"}`);
+            }
+            return data.result;
+        }
+        catch (error) {
+            throw 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,
+        });
+    }
+}
+//# sourceMappingURL=TelegramService.js.map

package/lib/esm/comms/telegram/TelegramService.js.map

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

package/lib/esm/comms/telegram/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/comms/telegram
+ * @summary Telegram Bot API service (messaging, updates, chat actions).
+ * @description Re-exports the Telegram client-based service and its types.
+ */
+export * from "./TelegramService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/comms/telegram/index.js.map

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

package/lib/esm/comms/whatsapp/WhatsAppService.js

@@ -0,0 +1,269 @@
+/**
+ * @module integrations/comms/whatsapp/service
+ * @summary WhatsApp Cloud API integration service for text, template, and media messages.
+ * @description Exposes the Meta WhatsApp Cloud API (Graph `v19.0`) as an
+ * undecorated client-based service built on {@link HttpApiService}.
+ * Configuration comes from an explicit `WhatsAppServiceConfig` or the
+ * `comms.whatsApp` environment slice; the access token is sent as
+ * `Authorization: Bearer <token>` and the sender is identified by the
+ * configured `phoneNumberId`. Credentials are referenced from configuration
+ * (and, from as-graph nodes, from the resolved `whatsapp` credential secret)
+ * and are never embedded in source. Failures are mapped to decaf errors via
+ * {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { CommsEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description WhatsApp Cloud API integration service
+ * @summary An undecorated HTTP service for text, template, and media
+ * messages, read receipts, and media metadata. Every message operation needs
+ * both the access token and the sender phone number ID; missing credentials or
+ * identifiers raise `InternalError`, and transport failures are mapped to decaf
+ * errors via {@link httpError}.
+ * @class WhatsAppService
+ * @extends HttpApiService
+ * @category Comms
+ * @example
+ * ```ts
+ * import { WhatsAppService } from "@decaf-ts/integrations/comms/whatsapp";
+ *
+ * const whatsapp = new WhatsAppService();
+ * await whatsapp.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_WHATSAPP_TOKEN,
+ *   phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID,
+ * });
+ * await whatsapp.sendText({ to: "15551234567", text: "Hello" });
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as WhatsAppService
+ *   participant Graph as WhatsApp Cloud API
+ *   Caller->>Service: sendText(input)
+ *   activate Service
+ *   Service->>Service: requireTokenAndPhone()
+ *   Service->>Graph: POST /{phoneNumberId}/messages
+ *   activate Graph
+ *   Graph-->>Service: message payload
+ *   deactivate Graph
+ *   Service-->>Caller: message payload
+ *   deactivate Service
+ * @memberOf module:integrations/comms/whatsapp/service
+ */
+export class WhatsAppService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "WhatsApp";
+    }
+    /**
+     * @description The WhatsApp Cloud API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://graph.facebook.com/v19.0"`.
+     */
+    defaultBaseUrl() {
+        return "https://graph.facebook.com/v19.0";
+    }
+    /**
+     * @description Builds the WhatsApp bearer authorization headers
+     * @summary Returns `Authorization: Bearer <token>` when configured, and no
+     * headers otherwise.
+     * @param {WhatsAppServiceConfig} 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 WhatsApp credentials and defaults from the environment
+     * @summary Reads the `comms.whatsApp` slice and returns a partial config
+     * when a token or phone number ID is configured, `undefined` otherwise.
+     * Values pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<WhatsAppServiceConfig> | undefined} A partial config, or `undefined` when neither credential is configured.
+     */
+    configFromEnvironment() {
+        const env = CommsEnvironment.comms.whatsApp;
+        const token = envString(env?.token);
+        const phoneNumberId = envString(env?.phoneNumberId);
+        if (!token && !phoneNumberId)
+            return undefined;
+        return {
+            token,
+            phoneNumberId,
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts the access token and sender phone number ID
+     * @summary Calls `requireToken()` and returns the configured
+     * `phoneNumberId` used to build the messages path.
+     * @returns {string} The configured sender phone number ID.
+     * @throws {InternalError} When no token or phone number ID is configured.
+     */
+    requireTokenAndPhone() {
+        this.requireToken();
+        const phoneNumberId = this.config.phoneNumberId;
+        if (!phoneNumberId) {
+            throw new InternalError("WhatsApp requires a phone number id");
+        }
+        return phoneNumberId;
+    }
+    /**
+     * @description Builds the encoded messages path for a sender
+     * @summary Encodes the phone number ID into `/<id>/messages`.
+     * @param {string} phoneNumberId - The sender phone number ID.
+     * @returns {string} The messages API path.
+     */
+    messagesPath(phoneNumberId) {
+        return `/${encodeURIComponent(phoneNumberId)}/messages`;
+    }
+    /**
+     * @description Sends a WhatsApp text message
+     * @summary `POST`s a `text` message to the sender's `/messages` endpoint
+     * and returns the WhatsApp message payload.
+     * @param {WhatsAppTextInput} input - The recipient, text, and preview flag.
+     * @returns {Promise<unknown>} The WhatsApp message payload.
+     * @throws {InternalError} When credentials or the phone number ID are missing.
+     * @throws {BadRequestError} When WhatsApp rejects the message.
+     * @example
+     * ```ts
+     * await whatsapp.sendText({ to: "15551234567", text: "Deployment finished" });
+     * ```
+     */
+    async sendText(input) {
+        const phoneNumberId = this.requireTokenAndPhone();
+        try {
+            const response = await this.client.post(this.messagesPath(phoneNumberId), {
+                messaging_product: "whatsapp",
+                recipient_type: "individual",
+                to: input.to,
+                type: "text",
+                text: {
+                    body: input.text,
+                    preview_url: input.previewUrl ?? false,
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("WhatsApp", "send text message", error);
+        }
+    }
+    /**
+     * @description Sends a WhatsApp template message
+     * @summary `POST`s a `template` message referencing an approved template
+     * name and language, with optional components.
+     * @param {WhatsAppTemplateInput} input - The recipient and template definition.
+     * @returns {Promise<unknown>} The WhatsApp message payload.
+     * @throws {InternalError} When credentials or the phone number ID are missing.
+     * @throws {BadRequestError} When WhatsApp rejects the template message.
+     */
+    async sendTemplate(input) {
+        const phoneNumberId = this.requireTokenAndPhone();
+        try {
+            const response = await this.client.post(this.messagesPath(phoneNumberId), {
+                messaging_product: "whatsapp",
+                to: input.to,
+                type: "template",
+                template: {
+                    name: input.templateName,
+                    language: { code: input.languageCode },
+                    ...(input.components ? { components: input.components } : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("WhatsApp", "send template message", error);
+        }
+    }
+    /**
+     * @description Sends a WhatsApp media message
+     * @summary `POST`s an `image`/`audio`/`video`/`document` message using
+     * either an uploaded `mediaId` or a public `link`, with optional caption and
+     * filename.
+     * @param {WhatsAppMediaInput} input - The recipient and media reference.
+     * @returns {Promise<unknown>} The WhatsApp message payload.
+     * @throws {InternalError} When credentials or the phone number ID are missing, or neither `mediaId` nor `link` is provided.
+     * @throws {BadRequestError} When WhatsApp rejects the media message.
+     */
+    async sendMedia(input) {
+        const phoneNumberId = this.requireTokenAndPhone();
+        if (!input.mediaId && !input.link) {
+            throw new InternalError("WhatsApp media messages require a media id or link");
+        }
+        try {
+            const response = await this.client.post(this.messagesPath(phoneNumberId), {
+                messaging_product: "whatsapp",
+                recipient_type: "individual",
+                to: input.to,
+                type: input.type,
+                [input.type]: {
+                    ...(input.mediaId ? { id: input.mediaId } : { link: input.link }),
+                    ...(input.caption ? { caption: input.caption } : {}),
+                    ...(input.filename ? { filename: input.filename } : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("WhatsApp", "send media message", error);
+        }
+    }
+    /**
+     * @description Marks an inbound WhatsApp message as read
+     * @summary `POST`s a `read` status for the message to the sender's
+     * `/messages` endpoint.
+     * @param {WhatsAppReadInput} input - The inbound message ID to acknowledge.
+     * @returns {Promise<unknown>} The WhatsApp status payload.
+     * @throws {InternalError} When credentials, the phone number ID, or the message ID are missing.
+     * @throws {BadRequestError} When WhatsApp rejects the request.
+     */
+    async markAsRead(input) {
+        const phoneNumberId = this.requireTokenAndPhone();
+        if (!input.messageId) {
+            throw new InternalError("WhatsApp requires a message id");
+        }
+        try {
+            const response = await this.client.post(this.messagesPath(phoneNumberId), {
+                messaging_product: "whatsapp",
+                status: "read",
+                message_id: input.messageId,
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("WhatsApp", "mark message as read", error);
+        }
+    }
+    /**
+     * @description Fetches WhatsApp media metadata
+     * @summary `GET`s the media descriptor (URL, MIME type, size) by media ID;
+     * the descriptor's URL is then used to download the binary.
+     * @param {string} mediaId - The WhatsApp media ID.
+     * @returns {Promise<unknown>} The media metadata payload.
+     * @throws {InternalError} When no token is configured or the media ID is empty.
+     * @throws {NotFoundError} When the media does not exist (HTTP 404).
+     * @throws {BadRequestError} When WhatsApp rejects the request.
+     */
+    async getMedia(mediaId) {
+        this.requireToken();
+        if (!mediaId) {
+            throw new InternalError("WhatsApp requires a media id");
+        }
+        try {
+            const response = await this.client.get(`/${encodeURIComponent(mediaId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("WhatsApp", "get media", error);
+        }
+    }
+}
+//# sourceMappingURL=WhatsAppService.js.map

package/lib/esm/comms/whatsapp/WhatsAppService.js.map

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

package/lib/esm/comms/whatsapp/index.js

@@ -0,0 +1,2 @@
+export * from "./WhatsAppService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/comms/whatsapp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/comms/whatsapp/index.ts"],"names":[],"mappings":"AAAA,qCAAkC"}

package/lib/esm/devops/environment.js

@@ -0,0 +1,39 @@
+import { LoggedEnvironment } from "@decaf-ts/logging";
+/**
+ * @description Accumulated devops environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `DevopsEnvironmentShape` contract. Devops services read their provider
+ * slice (e.g. `DevopsEnvironment.devops.github`) inside
+ * `configFromEnvironment()` and translate it into an
+ * `HttpApiServiceConfig`-derived config. Credentials come from environment
+ * variables; for as-graph node usage those are provided as
+ * `GRAPH_CREDENTIAL_*` values (placeholders in this example).
+ * @example
+ * ```ts
+ * import { GithubService } from "@decaf-ts/integrations/devops/github";
+ *
+ * // with devops.github.token / devops.github.owner / devops.github.repo configured
+ * const github = new GithubService();
+ * await github.initialize();
+ * ```
+ * @constant {LoggedEnvironment} DevopsEnvironment
+ * @memberOf module:integrations/devops/environment
+ */
+export const DevopsEnvironment = LoggedEnvironment.accumulate({
+    devops: {
+        github: {
+            token: "",
+            baseUrl: "",
+            owner: "",
+            repo: "",
+            timeout: undefined,
+        },
+        gitlab: {
+            token: "",
+            baseUrl: "",
+            projectId: "",
+            timeout: undefined,
+        },
+    },
+});
+//# sourceMappingURL=environment.js.map

package/lib/esm/devops/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/devops/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAwCtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC5D,MAAM,EAAE;QACN,MAAM,EAAE;YACN,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,SAA8B;SACxC;QACD,MAAM,EAAE;YACN,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,SAA8B;SACxC;KACF;CACwB,CAAC,CAAC"}