@decaf-ts/integrations 0.10.8 → 0.12.0

package/lib/cjs/comms/slack/SlackService.cjs

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackService = void 0;
+/**
+ * @module integrations/comms/slack/service
+ * @summary Slack Web API integration service for posting messages and reading conversations and users.
+ * @description Exposes the Slack Web API (`chat.postMessage`, `conversations.*`, `users.info`)
+ * as an undecorated client-based service built on {@link HttpApiService}.
+ * Configuration comes from an explicit `SlackServiceConfig` or the `comms.slack`
+ * environment slice; every response is normalized 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 Slack Web API integration service
+ * @summary An undecorated HTTP service for posting messages,
+ * listing conversations with cursor paging, fetching a single conversation,
+ * and looking up users. The Slack Bot token is sent as a bearer token, every
+ * call requires it (`requireToken()`), non-`ok` Slack responses raise
+ * `InternalError`, and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class SlackService
+ * @category Comms
+ * @example
+ * ```ts
+ * import { SlackService } from "@decaf-ts/integrations/comms/slack";
+ *
+ * const slack = new SlackService();
+ * await slack.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_SLACK_TOKEN,
+ * });
+ * await slack.postMessage({
+ *   channel: "#general",
+ *   text: "Deployment finished",
+ * });
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as SlackService
+ *   participant Slack as Slack Web API
+ *   Caller->>Service: postMessage(input)
+ *   activate Service
+ *   Service->>Service: requireToken()
+ *   Service->>Slack: POST /chat.postMessage
+ *   activate Slack
+ *   Slack-->>Service: { ok, channel, ts }
+ *   deactivate Slack
+ *   alt ok
+ *     Service-->>Caller: SlackPostMessageResult
+ *   else error
+ *     Service--xCaller: InternalError / mapped decaf error
+ *   end
+ *   deactivate Service
+ * @memberOf module:integrations/comms/slack/service
+ */
+class SlackService extends index_js_1.HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Slack";
+    }
+    /**
+     * @description The Slack Web API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://slack.com/api"`.
+     */
+    defaultBaseUrl() {
+        return "https://slack.com/api";
+    }
+    /**
+     * @description Builds the Slack bearer authorization headers
+     * @summary Returns the `Authorization: Bearer <token>` header when the
+     * config carries a token, and no headers otherwise.
+     * @param {SlackServiceConfig} 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 Slack credentials and defaults from the environment
+     * @summary Reads the `comms.slack` 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<SlackServiceConfig> | undefined} A partial config, or `undefined` when no Slack token is configured.
+     */
+    configFromEnvironment() {
+        const env = environment_js_1.CommsEnvironment.comms.slack;
+        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 Posts a request to a Slack Web API method
+     * @summary Shared request path for all Slack operations: asserts a token is
+     * configured, `POST`s the payload to `/<method>`, rejects non-`ok` Slack
+     * responses with an `InternalError`, and maps transport failures through
+     * {@link httpError}.
+     * @template T - The expected Slack response shape, extending `SlackApiResponse`.
+     * @param {string} method - The Slack Web API method name (e.g. `"chat.postMessage"`).
+     * @param {Record<string, unknown>} payload - The JSON body for the method.
+     * @returns {Promise<T>} The parsed Slack response payload.
+     * @throws {InternalError} When no token is configured or Slack answers with `ok: false`.
+     * @throws {NotFoundError} When Slack answers with HTTP 404.
+     * @throws {ConflictError} When Slack answers with HTTP 409.
+     * @throws {BadRequestError} When Slack answers with any other HTTP error status.
+     */
+    async call(method, payload) {
+        this.requireToken();
+        try {
+            const response = await this.client.post(`/${method}`, payload);
+            const data = response.data;
+            if (!data || data.ok !== true) {
+                throw new db_decorators_1.InternalError(`Slack API ${method} failed: ${data?.error ?? "unknown error"}`);
+            }
+            return data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Slack", `API ${method}`, error);
+        }
+    }
+    /**
+     * @description Posts a message to a Slack channel or thread
+     * @summary Sends the input to Slack's `chat.postMessage` method and returns
+     * the destination channel and message timestamp; use the returned `ts` as
+     * `threadTs` to reply in the same thread. Provide `blocks` for Block Kit
+     * layouts (with `text` as the fallback), or plain text alone.
+     * @param {SlackPostMessageInput} input - The message destination and content.
+     * @returns {Promise<SlackPostMessageResult>} The posted message's channel, timestamp, text, and raw payload.
+     * @throws {InternalError} When no token is configured or Slack rejects the message.
+     * @throws {NotFoundError} When the channel cannot be found (HTTP 404).
+     * @throws {ConflictError} When Slack answers with HTTP 409.
+     * @throws {BadRequestError} When Slack answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * await slack.postMessage({
+     *   channel: "#deploys",
+     *   text: "Release 1.2.0 is live",
+     *   unfurlLinks: false,
+     * });
+     * ```
+     */
+    async postMessage(input) {
+        const data = await this.call("chat.postMessage", {
+            channel: input.channel,
+            text: input.text,
+            blocks: input.blocks,
+            thread_ts: input.threadTs,
+            reply_broadcast: input.replyBroadcast,
+            unfurl_links: input.unfurlLinks,
+            unfurl_media: input.unfurlMedia,
+        });
+        return {
+            channel: data.channel,
+            ts: data.ts,
+            text: data.text,
+            message: data.message,
+        };
+    }
+    /**
+     * @description Lists Slack conversations with cursor paging
+     * @summary Calls `conversations.list` with a page size (default `100`),
+     * conversation `types` (default public and private channels), and archived
+     * exclusion (default `true`), returning normalized channels and the
+     * `nextCursor` to pass back as `cursor` for the next page.
+     * @param {object} [options] - Paging and filter options.
+     * @param {number} [options.limit] - Page size; defaults to `100`.
+     * @param {string} [options.cursor] - The `nextCursor` from the previous page.
+     * @param {string} [options.types] - Comma-separated conversation types (e.g. `"public_channel,private_channel"`); defaults to `"public_channel,private_channel"`.
+     * @param {boolean} [options.excludeArchived] - Whether archived channels are excluded; defaults to `true`.
+     * @returns {Promise<{channels: SlackChannel[], nextCursor?: string}>} The page of channels and the cursor for the next page, when more pages exist.
+     * @throws {InternalError} When no token is configured or Slack rejects the call.
+     * @throws {NotFoundError} When Slack answers with HTTP 404.
+     * @throws {ConflictError} When Slack answers with HTTP 409.
+     * @throws {BadRequestError} When Slack answers with any other HTTP error status.
+     * @example
+     * ```ts
+     * let cursor: string | undefined;
+     * do {
+     *   const page = await slack.listConversations({ limit: 200, cursor });
+     *   console.log(page.channels.map((channel) => channel.name));
+     *   cursor = page.nextCursor;
+     * } while (cursor);
+     * ```
+     */
+    async listConversations(options = {}) {
+        const data = await this.call("conversations.list", {
+            limit: options.limit ?? 100,
+            cursor: options.cursor,
+            types: options.types ?? "public_channel,private_channel",
+            exclude_archived: options.excludeArchived ?? true,
+        });
+        return {
+            channels: (data.channels ?? []).map((channel) => ({
+                id: String(channel["id"] ?? ""),
+                name: (0, environmentValue_js_1.envString)(channel["name"]),
+                isPrivate: channel["is_private"] === true,
+                isArchived: channel["is_archived"] === true,
+                memberCount: typeof channel["num_members"] === "number"
+                    ? channel["num_members"]
+                    : undefined,
+                topic: channel["topic"]?.value,
+                purpose: channel["purpose"]?.value,
+            })),
+            nextCursor: (0, environmentValue_js_1.envString)(data.response_metadata?.next_cursor),
+        };
+    }
+    /**
+     * @description Fetches a single Slack conversation
+     * @summary Calls `conversations.info` for the given channel ID (or
+     * `#name`) and returns the normalized channel descriptor.
+     * @param {string} channel - The channel ID or `#name` to look up.
+     * @returns {Promise<SlackChannel>} The normalized conversation descriptor.
+     * @throws {InternalError} When no token is configured or Slack rejects the call.
+     * @throws {NotFoundError} When the channel does not exist (HTTP 404).
+     * @throws {ConflictError} When Slack answers with HTTP 409.
+     * @throws {BadRequestError} When Slack answers with any other HTTP error status.
+     */
+    async getConversation(channel) {
+        const data = await this.call("conversations.info", { channel });
+        const found = data.channel ?? {};
+        return {
+            id: String(found["id"] ?? channel),
+            name: (0, environmentValue_js_1.envString)(found["name"]),
+            isPrivate: found["is_private"] === true,
+            isArchived: found["is_archived"] === true,
+            memberCount: typeof found["num_members"] === "number"
+                ? found["num_members"]
+                : undefined,
+            topic: found["topic"]?.value,
+            purpose: found["purpose"]?.value,
+        };
+    }
+    /**
+     * @description Fetches a Slack user profile
+     * @summary Calls `users.info` for the given user ID and returns the raw
+     * user payload, or `undefined` when Slack reports no user.
+     * @param {string} userId - The Slack user ID to look up (e.g. `"U12345678"`).
+     * @returns {Promise<Record<string, unknown> | undefined>} The raw user payload, or `undefined` when the user is not found.
+     * @throws {InternalError} When no token is configured or Slack rejects the call.
+     * @throws {NotFoundError} When the user does not exist (HTTP 404).
+     * @throws {ConflictError} When Slack answers with HTTP 409.
+     * @throws {BadRequestError} When Slack answers with any other HTTP error status.
+     */
+    async getUser(userId) {
+        const data = await this.call("users.info", { user: userId });
+        return data.user;
+    }
+}
+exports.SlackService = SlackService;
+//# sourceMappingURL=SlackService.js.map
+//# sourceMappingURL=SlackService.cjs.map

package/lib/cjs/comms/slack/SlackService.cjs.map

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

package/lib/cjs/comms/slack/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/slack
+ * @summary Slack Web API service (posting, conversations, users).
+ * @description Re-exports the Slack client-based service and its types.
+ */
+__exportStar(require("./SlackService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

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

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

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":"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"}

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"}