@decaf-ts/integrations 0.11.0 → 0.14.0

package/lib/types/comms/teams/TeamsService.d.cts

@@ -0,0 +1,172 @@
+import { HttpApiService, type HttpApiServiceConfig } from "../../shared/http/index.d.cts";
+/**
+ * @description Configuration for the Teams service
+ * @summary Extends {@link HttpApiServiceConfig} with the Microsoft Graph
+ * access token (required for channel messaging and listings, optional when
+ * only webhooks are used) and the incoming-webhook URL. When omitted, the
+ * `comms.teams` environment slice supplies both (and optional
+ * `baseUrl`/`timeout`).
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsServiceConfig extends HttpApiServiceConfig {
+    /**
+     * @description Microsoft Graph access token
+     * @summary Sent as `Authorization: Bearer <token>` for Graph requests.
+     */
+    token?: string;
+    /**
+     * @description Incoming webhook URL for `sendWebhook`
+     * @summary Typically an Office 365 connector URL; required only for webhook delivery.
+     */
+    webhookUrl?: string;
+}
+/**
+ * @description Input for Teams incoming-webhook delivery
+ * @summary Carries the plain-text `text`, an optional card `title`, and
+ * whether the text is rendered as markdown (default `true`). Delivered as an
+ * Office 365 `MessageCard` to the configured webhook URL.
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsWebhookMessage {
+    /**
+     * @description Message body text
+     */
+    text: string;
+    /**
+     * @description Optional card title
+     */
+    title?: string;
+    /**
+     * @description Whether `text` is rendered as markdown; defaults to `true`
+     */
+    markdown?: boolean;
+}
+/**
+ * @description Input for sending a message into a Teams channel via Microsoft Graph
+ * @summary Carries the target `teamId` and `channelId`, the message
+ * `content`, and its content type (`text` by default, or `html`).
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsChannelMessage {
+    teamId: string;
+    channelId: string;
+    content: string;
+    contentType?: "text" | "html";
+}
+/**
+ * @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
+ */
+export declare class TeamsService extends HttpApiService<TeamsServiceConfig> {
+    /**
+     * @description The provider name used in error messages
+     */
+    protected readonly 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"`.
+     */
+    protected defaultBaseUrl(): string;
+    /**
+     * @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).
+     */
+    protected authHeaders(config: TeamsServiceConfig): Record<string, string>;
+    /**
+     * @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.
+     */
+    protected configFromEnvironment(): Partial<TeamsServiceConfig> | undefined;
+    /**
+     * @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.
+     */
+    sendWebhook(input: TeamsWebhookMessage): Promise<unknown>;
+    /**
+     * @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",
+     * });
+     * ```
+     */
+    sendChannelMessage(input: TeamsChannelMessage): Promise<unknown>;
+    /**
+     * @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.
+     */
+    listTeams(limit?: number): Promise<Array<Record<string, unknown>>>;
+    /**
+     * @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.
+     */
+    listChannels(teamId: string): Promise<Array<Record<string, unknown>>>;
+}

package/lib/types/comms/teams/TeamsService.d.mts

@@ -0,0 +1,172 @@
+import { HttpApiService, type HttpApiServiceConfig } from "../../shared/http/index.d.mts";
+/**
+ * @description Configuration for the Teams service
+ * @summary Extends {@link HttpApiServiceConfig} with the Microsoft Graph
+ * access token (required for channel messaging and listings, optional when
+ * only webhooks are used) and the incoming-webhook URL. When omitted, the
+ * `comms.teams` environment slice supplies both (and optional
+ * `baseUrl`/`timeout`).
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsServiceConfig extends HttpApiServiceConfig {
+    /**
+     * @description Microsoft Graph access token
+     * @summary Sent as `Authorization: Bearer <token>` for Graph requests.
+     */
+    token?: string;
+    /**
+     * @description Incoming webhook URL for `sendWebhook`
+     * @summary Typically an Office 365 connector URL; required only for webhook delivery.
+     */
+    webhookUrl?: string;
+}
+/**
+ * @description Input for Teams incoming-webhook delivery
+ * @summary Carries the plain-text `text`, an optional card `title`, and
+ * whether the text is rendered as markdown (default `true`). Delivered as an
+ * Office 365 `MessageCard` to the configured webhook URL.
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsWebhookMessage {
+    /**
+     * @description Message body text
+     */
+    text: string;
+    /**
+     * @description Optional card title
+     */
+    title?: string;
+    /**
+     * @description Whether `text` is rendered as markdown; defaults to `true`
+     */
+    markdown?: boolean;
+}
+/**
+ * @description Input for sending a message into a Teams channel via Microsoft Graph
+ * @summary Carries the target `teamId` and `channelId`, the message
+ * `content`, and its content type (`text` by default, or `html`).
+ * @category Comms
+ * @memberOf module:integrations/comms/teams/service
+ */
+export interface TeamsChannelMessage {
+    teamId: string;
+    channelId: string;
+    content: string;
+    contentType?: "text" | "html";
+}
+/**
+ * @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
+ */
+export declare class TeamsService extends HttpApiService<TeamsServiceConfig> {
+    /**
+     * @description The provider name used in error messages
+     */
+    protected readonly 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"`.
+     */
+    protected defaultBaseUrl(): string;
+    /**
+     * @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).
+     */
+    protected authHeaders(config: TeamsServiceConfig): Record<string, string>;
+    /**
+     * @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.
+     */
+    protected configFromEnvironment(): Partial<TeamsServiceConfig> | undefined;
+    /**
+     * @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.
+     */
+    sendWebhook(input: TeamsWebhookMessage): Promise<unknown>;
+    /**
+     * @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",
+     * });
+     * ```
+     */
+    sendChannelMessage(input: TeamsChannelMessage): Promise<unknown>;
+    /**
+     * @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.
+     */
+    listTeams(limit?: number): Promise<Array<Record<string, unknown>>>;
+    /**
+     * @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.
+     */
+    listChannels(teamId: string): Promise<Array<Record<string, unknown>>>;
+}

package/lib/types/comms/teams/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * @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.
+ */
+export * from "./TeamsService.d.cts";

package/lib/types/comms/teams/index.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @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.
+ */
+export * from "./TeamsService.d.mts";

package/lib/types/comms/telegram/TelegramService.d.cts

@@ -0,0 +1,202 @@
+import { HttpApiService, type HttpApiServiceConfig } from "../../shared/http/index.d.cts";
+/**
+ * @description Configuration for the Telegram service
+ * @summary Extends {@link HttpApiServiceConfig} with the Telegram bot token
+ * used to build the `/bot<token>` request path. When omitted, the
+ * `comms.telegram` environment slice supplies the token (and optional
+ * `baseUrl`/`timeout`).
+ * @category Comms
+ * @memberOf module:integrations/comms/telegram/service
+ */
+export interface TelegramServiceConfig extends HttpApiServiceConfig {
+    /**
+     * @description Telegram bot token
+     * @summary Issued by BotFather; embedded in the request path for every call.
+     */
+    token?: string;
+}
+/**
+ * @description Input for sending a Telegram message
+ * @summary Carries the destination `chatId`, the message `text`, the optional
+ * parse mode (`Markdown`, `MarkdownV2`, or `HTML`), and the notification,
+ * preview, reply, and forum-thread options.
+ * @category Comms
+ * @memberOf module:integrations/comms/telegram/service
+ */
+export interface TelegramSendMessageInput {
+    /**
+     * @description Destination chat ID or `@channelusername`
+     */
+    chatId: string | number;
+    /**
+     * @description Message text (up to 4096 characters)
+     */
+    text: string;
+    /**
+     * @description Parse mode for entity recognition in `text`
+     */
+    parseMode?: "Markdown" | "MarkdownV2" | "HTML";
+    /**
+     * @description Whether the message is sent silently
+     */
+    disableNotification?: boolean;
+    /**
+     * @description Whether link previews are disabled
+     */
+    disablePreview?: boolean;
+    /**
+     * @description Message to reply to
+     */
+    replyToMessageId?: number;
+    /**
+     * @description Forum thread to post into
+     */
+    messageThreadId?: number;
+}
+/**
+ * @description Normalized Telegram message descriptor
+ * @summary The relevant subset of the Telegram `Message` object: identifiers
+ * (`message_id`, `date`), the sending `chat`, and the message `text`.
+ * @category Comms
+ * @memberOf module:integrations/comms/telegram/service
+ */
+export interface TelegramMessage {
+    message_id: number;
+    date: number;
+    chat: {
+        id: number;
+        type?: string;
+        title?: string;
+        username?: string;
+    };
+    text?: string;
+}
+/**
+ * @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 declare class TelegramService extends HttpApiService<TelegramServiceConfig> {
+    /**
+     * @description The provider name used in error messages
+     */
+    protected readonly serviceName = "Telegram";
+    /**
+     * @description The Telegram Bot API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://api.telegram.org"`.
+     */
+    protected defaultBaseUrl(): string;
+    /**
+     * @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.
+     */
+    protected configFromEnvironment(): Partial<TelegramServiceConfig> | undefined;
+    /**
+     * @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.
+     */
+    protected call<T>(method: string, payload?: Record<string, unknown>): Promise<T>;
+    /**
+     * @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.
+     */
+    getMe(): Promise<Record<string, unknown>>;
+    /**
+     * @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,
+     * });
+     * ```
+     */
+    sendMessage(input: TelegramSendMessageInput): Promise<TelegramMessage>;
+    /**
+     * @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.
+     */
+    getUpdates(options?: {
+        offset?: number;
+        limit?: number;
+        timeoutSeconds?: number;
+    }): Promise<Array<Record<string, unknown>>>;
+    /**
+     * @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.
+     */
+    sendChatAction(chatId: string | number, action?: string): Promise<boolean>;
+}