@decaf-ts/integrations 0.11.0 → 0.14.0

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

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/comms/email
+ * @summary Email service (SMTP + Microsoft Graph send, Graph/IMAP inbox reads).
+ * @description Re-exports the {@link EmailService} and its config/result
+ * types, the raw MIME builder, and the nodemailer-backed {@link SmtpClient}
+ * with its {@link SmtpConfig}
+ * (also available directly from the `./smtp` subpath).
+ */
+export * from "./EmailService.d.mts";
+export * from "./mime.d.mts";
+export * from "./smtp.d.mts";

package/lib/types/comms/email/mime.d.cts

@@ -0,0 +1,84 @@
+/**
+ * @description A message attachment
+ * @summary Content is base64 text by default; with `encoding: "utf8"` the
+ * builder base64-encodes the UTF-8 content itself.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface EmailAttachment {
+    filename: string;
+    content: string;
+    encoding?: "base64" | "utf8";
+    contentType?: string;
+}
+/**
+ * @description Input for building a raw MIME message
+ * @summary Carries the sender, recipients (single address, comma-separated
+ * string, or array), subject, optional text and HTML bodies, `Reply-To`, and
+ * attachments.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface EmailMessageInput {
+    from: string;
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    replyTo?: string;
+    attachments?: EmailAttachment[];
+}
+/**
+ * @description The built MIME message ready for delivery
+ * @summary Carries the raw RFC 5322 text, the resolved sender, the flattened
+ * recipient list (To/Cc/Bcc), and the generated `Message-ID`.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface BuiltEmail {
+    raw: string;
+    from: string;
+    recipients: string[];
+    messageId: string;
+}
+/**
+ * Validates a mailbox address against the allowlist and returns it trimmed.
+ *
+ * @param value - Candidate address.
+ * @param field - Human-readable field name used in the error message.
+ * @returns The trimmed, validated mailbox address.
+ * @throws {BadRequestError} when the address contains control characters or is not a bare mailbox.
+ */
+export declare function assertEmailAddress(value: string, field?: string): string;
+/**
+ * @description Encodes a MIME header value safely
+ * @summary Pure-ASCII values pass through; anything else becomes an RFC 2047
+ * `=?UTF-8?B?...?=` encoded word.
+ * @param value - Raw header value
+ * @returns The header value safe for raw message transport
+ */
+export declare function encodeHeader(value: string): string;
+/**
+ * @description Normalizes a recipient input into an allowlisted address list
+ * @summary Splits comma-separated strings, trims entries, drops empties, and
+ * validates every remaining entry as a bare mailbox address. Values carrying
+ * CR/LF, NUL, or other control characters are rejected outright so workflow
+ * input can never inject MIME headers or SMTP envelope commands.
+ * @param value - Single address, comma-separated string, array, or `undefined`
+ * @returns The trimmed, validated list of addresses
+ * @throws {BadRequestError} when an entry is not a valid mailbox address
+ */
+export declare function parseAddressList(value: string | string[] | undefined): string[];
+/**
+ * @description Builds the complete raw MIME message
+ * @summary Generates the `Message-ID`, resolves recipients (throwing when
+ * none remain), emits the standard headers, and assembles the body entity
+ * (alternative text/HTML parts, plus attachments when present).
+ * @param input - Message input
+ * @returns The built message with raw text, sender, recipients, and `Message-ID`
+ * @throws {BadRequestError} when the message has no recipient or any address,
+ *   attachment filename, or content type fails validation
+ */
+export declare function buildEmail(input: EmailMessageInput): BuiltEmail;

package/lib/types/comms/email/mime.d.mts

@@ -0,0 +1,84 @@
+/**
+ * @description A message attachment
+ * @summary Content is base64 text by default; with `encoding: "utf8"` the
+ * builder base64-encodes the UTF-8 content itself.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface EmailAttachment {
+    filename: string;
+    content: string;
+    encoding?: "base64" | "utf8";
+    contentType?: string;
+}
+/**
+ * @description Input for building a raw MIME message
+ * @summary Carries the sender, recipients (single address, comma-separated
+ * string, or array), subject, optional text and HTML bodies, `Reply-To`, and
+ * attachments.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface EmailMessageInput {
+    from: string;
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    replyTo?: string;
+    attachments?: EmailAttachment[];
+}
+/**
+ * @description The built MIME message ready for delivery
+ * @summary Carries the raw RFC 5322 text, the resolved sender, the flattened
+ * recipient list (To/Cc/Bcc), and the generated `Message-ID`.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/mime
+ */
+export interface BuiltEmail {
+    raw: string;
+    from: string;
+    recipients: string[];
+    messageId: string;
+}
+/**
+ * Validates a mailbox address against the allowlist and returns it trimmed.
+ *
+ * @param value - Candidate address.
+ * @param field - Human-readable field name used in the error message.
+ * @returns The trimmed, validated mailbox address.
+ * @throws {BadRequestError} when the address contains control characters or is not a bare mailbox.
+ */
+export declare function assertEmailAddress(value: string, field?: string): string;
+/**
+ * @description Encodes a MIME header value safely
+ * @summary Pure-ASCII values pass through; anything else becomes an RFC 2047
+ * `=?UTF-8?B?...?=` encoded word.
+ * @param value - Raw header value
+ * @returns The header value safe for raw message transport
+ */
+export declare function encodeHeader(value: string): string;
+/**
+ * @description Normalizes a recipient input into an allowlisted address list
+ * @summary Splits comma-separated strings, trims entries, drops empties, and
+ * validates every remaining entry as a bare mailbox address. Values carrying
+ * CR/LF, NUL, or other control characters are rejected outright so workflow
+ * input can never inject MIME headers or SMTP envelope commands.
+ * @param value - Single address, comma-separated string, array, or `undefined`
+ * @returns The trimmed, validated list of addresses
+ * @throws {BadRequestError} when an entry is not a valid mailbox address
+ */
+export declare function parseAddressList(value: string | string[] | undefined): string[];
+/**
+ * @description Builds the complete raw MIME message
+ * @summary Generates the `Message-ID`, resolves recipients (throwing when
+ * none remain), emits the standard headers, and assembles the body entity
+ * (alternative text/HTML parts, plus attachments when present).
+ * @param input - Message input
+ * @returns The built message with raw text, sender, recipients, and `Message-ID`
+ * @throws {BadRequestError} when the message has no recipient or any address,
+ *   attachment filename, or content type fails validation
+ */
+export declare function buildEmail(input: EmailMessageInput): BuiltEmail;

package/lib/types/comms/email/smtp.d.cts

@@ -0,0 +1,107 @@
+/**
+ * @description SMTP connection configuration
+ * @summary Carries the server address, optional implicit-TLS/STARTTLS
+ * selection, credentials, and timeouts.
+ *
+ * `secure` selects implicit TLS: `true` opens a TLS socket from the first byte
+ * (default port 465). `false` connects in plaintext and upgrades with STARTTLS
+ * when the server advertises it (default port 587). When credentials are
+ * configured, `connect()` refuses to authenticate unless the session is
+ * encrypted; `allowPlaintextAuth` is the explicit, documented opt-out for
+ * servers that cannot offer TLS.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/smtp
+ */
+export interface SmtpConfig {
+    /** @description SMTP server hostname (required) */
+    host: string;
+    /** @description Server port; defaults to `465` when `secure` is `true`, `587` otherwise */
+    port?: number;
+    /** @description `true` opens an implicit-TLS socket from the first byte; `false` (default) connects in plaintext and upgrades via STARTTLS */
+    secure?: boolean;
+    /** @description Username for `AUTH LOGIN`; when set with `password`, enables the fail-closed plaintext-AUTH check */
+    username?: string;
+    /** @description Password for `AUTH LOGIN` */
+    password?: string;
+    /** @description Connection, greeting, and socket timeout in milliseconds (default `30000`) */
+    timeout?: number;
+    /** @description Explicitly permit `AUTH LOGIN` over a plaintext session (default `false`) */
+    allowPlaintextAuth?: boolean;
+    /** @description Explicitly accept an otherwise-invalid TLS certificate (default `false`) */
+    allowUnauthorizedCerts?: boolean;
+    /** @description Client hostname announced in `EHLO` (default `as-graph`) */
+    clientHostname?: string;
+}
+/**
+ * @description SMTP client for raw MIME delivery
+ * @summary Connects and authenticates through a nodemailer SMTP transport
+ * (implicit TLS on `secure`, STARTTLS otherwise), then delivers a pre-built
+ * message with the envelope sender/recipients and the raw RFC 5322 source.
+ * Credentials are never sent over a plaintext session unless
+ * `allowPlaintextAuth` is set, and every envelope address is validated before
+ * it reaches the transport.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/smtp
+ * @example
+ * ```ts
+ * import { SmtpClient, buildEmail } from "@decaf-ts/integrations/comms/email";
+ *
+ * const client = new SmtpClient({
+ *   host: "smtp.example.com",
+ *   port: 587,
+ *   username: "noreply@example.com",
+ *   password: process.env.SMTP_PASSWORD,
+ * });
+ * await client.connect();
+ * const mail = buildEmail({
+ *   from: "noreply@example.com",
+ *   to: ["ops@example.com"],
+ *   subject: "Nightly report",
+ *   text: "All systems nominal.",
+ * });
+ * await client.send(mail.from, mail.recipients, mail.raw);
+ * await client.close();
+ * ```
+ */
+export declare class SmtpClient {
+    private config;
+    private transporter?;
+    /**
+     * @description Creates an SMTP client
+     * @summary Stores the config; the nodemailer transport is only created and
+     * verified by {@link SmtpClient.connect}.
+     * @param config - Server address, optional credentials, and TLS/timeout options
+     */
+    constructor(config: SmtpConfig);
+    private transportOptions;
+    private transportError;
+    /**
+     * @description Opens the SMTP session
+     * @summary Lazily loads the optional `nodemailer` peer, builds the SMTP
+     * transport for the configured host/credentials, and verifies it
+     * (`EHLO` + TLS upgrade + `AUTH LOGIN` when credentials are configured).
+     * Authentication fails closed: with credentials configured and no encrypted
+     * session, the transport requires STARTTLS and verification fails unless
+     * `allowPlaintextAuth` was set on the config.
+     * @throws {InternalError} when `nodemailer` is not installed, or on
+     * connection, TLS, or auth failures
+     */
+    connect(): Promise<void>;
+    /**
+     * @description Delivers a raw message over the established session
+     * @summary Validates the envelope, then hands the sender, recipients, and
+     * raw RFC 5322 source to nodemailer's `sendMail` (the transport performs
+     * queueing, dot-stuffing, and CRLF normalization).
+     * @param from - Envelope sender address
+     * @param recipients - Envelope recipient addresses
+     * @param raw - Raw RFC 5322 message text
+     * @throws {InternalError} when not connected or the server rejects delivery
+     * @throws {BadRequestError} when the envelope sender or a recipient is not an allowlisted mailbox
+     */
+    send(from: string, recipients: string[], raw: string): Promise<void>;
+    /**
+     * @description Closes the session gracefully
+     * @summary Closes the nodemailer transport, ignoring shutdown failures.
+     */
+    close(): Promise<void>;
+}

package/lib/types/comms/email/smtp.d.mts

@@ -0,0 +1,107 @@
+/**
+ * @description SMTP connection configuration
+ * @summary Carries the server address, optional implicit-TLS/STARTTLS
+ * selection, credentials, and timeouts.
+ *
+ * `secure` selects implicit TLS: `true` opens a TLS socket from the first byte
+ * (default port 465). `false` connects in plaintext and upgrades with STARTTLS
+ * when the server advertises it (default port 587). When credentials are
+ * configured, `connect()` refuses to authenticate unless the session is
+ * encrypted; `allowPlaintextAuth` is the explicit, documented opt-out for
+ * servers that cannot offer TLS.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/smtp
+ */
+export interface SmtpConfig {
+    /** @description SMTP server hostname (required) */
+    host: string;
+    /** @description Server port; defaults to `465` when `secure` is `true`, `587` otherwise */
+    port?: number;
+    /** @description `true` opens an implicit-TLS socket from the first byte; `false` (default) connects in plaintext and upgrades via STARTTLS */
+    secure?: boolean;
+    /** @description Username for `AUTH LOGIN`; when set with `password`, enables the fail-closed plaintext-AUTH check */
+    username?: string;
+    /** @description Password for `AUTH LOGIN` */
+    password?: string;
+    /** @description Connection, greeting, and socket timeout in milliseconds (default `30000`) */
+    timeout?: number;
+    /** @description Explicitly permit `AUTH LOGIN` over a plaintext session (default `false`) */
+    allowPlaintextAuth?: boolean;
+    /** @description Explicitly accept an otherwise-invalid TLS certificate (default `false`) */
+    allowUnauthorizedCerts?: boolean;
+    /** @description Client hostname announced in `EHLO` (default `as-graph`) */
+    clientHostname?: string;
+}
+/**
+ * @description SMTP client for raw MIME delivery
+ * @summary Connects and authenticates through a nodemailer SMTP transport
+ * (implicit TLS on `secure`, STARTTLS otherwise), then delivers a pre-built
+ * message with the envelope sender/recipients and the raw RFC 5322 source.
+ * Credentials are never sent over a plaintext session unless
+ * `allowPlaintextAuth` is set, and every envelope address is validated before
+ * it reaches the transport.
+ * @category Comms
+ * @memberOf module:integrations/comms/email/smtp
+ * @example
+ * ```ts
+ * import { SmtpClient, buildEmail } from "@decaf-ts/integrations/comms/email";
+ *
+ * const client = new SmtpClient({
+ *   host: "smtp.example.com",
+ *   port: 587,
+ *   username: "noreply@example.com",
+ *   password: process.env.SMTP_PASSWORD,
+ * });
+ * await client.connect();
+ * const mail = buildEmail({
+ *   from: "noreply@example.com",
+ *   to: ["ops@example.com"],
+ *   subject: "Nightly report",
+ *   text: "All systems nominal.",
+ * });
+ * await client.send(mail.from, mail.recipients, mail.raw);
+ * await client.close();
+ * ```
+ */
+export declare class SmtpClient {
+    private config;
+    private transporter?;
+    /**
+     * @description Creates an SMTP client
+     * @summary Stores the config; the nodemailer transport is only created and
+     * verified by {@link SmtpClient.connect}.
+     * @param config - Server address, optional credentials, and TLS/timeout options
+     */
+    constructor(config: SmtpConfig);
+    private transportOptions;
+    private transportError;
+    /**
+     * @description Opens the SMTP session
+     * @summary Lazily loads the optional `nodemailer` peer, builds the SMTP
+     * transport for the configured host/credentials, and verifies it
+     * (`EHLO` + TLS upgrade + `AUTH LOGIN` when credentials are configured).
+     * Authentication fails closed: with credentials configured and no encrypted
+     * session, the transport requires STARTTLS and verification fails unless
+     * `allowPlaintextAuth` was set on the config.
+     * @throws {InternalError} when `nodemailer` is not installed, or on
+     * connection, TLS, or auth failures
+     */
+    connect(): Promise<void>;
+    /**
+     * @description Delivers a raw message over the established session
+     * @summary Validates the envelope, then hands the sender, recipients, and
+     * raw RFC 5322 source to nodemailer's `sendMail` (the transport performs
+     * queueing, dot-stuffing, and CRLF normalization).
+     * @param from - Envelope sender address
+     * @param recipients - Envelope recipient addresses
+     * @param raw - Raw RFC 5322 message text
+     * @throws {InternalError} when not connected or the server rejects delivery
+     * @throws {BadRequestError} when the envelope sender or a recipient is not an allowlisted mailbox
+     */
+    send(from: string, recipients: string[], raw: string): Promise<void>;
+    /**
+     * @description Closes the session gracefully
+     * @summary Closes the nodemailer transport, ignoring shutdown failures.
+     */
+    close(): Promise<void>;
+}

package/lib/types/comms/environment.d.cts

@@ -0,0 +1,110 @@
+/**
+ * @module integrations/comms/environment
+ * @summary Environment contract and accumulated environment for the comms integration services.
+ * @description Declares the `CommsEnvironmentShape` consumed by the Slack,
+ * Telegram, Teams, Gmail, Discord, WhatsApp, and Outlook services'
+ * `configFromEnvironment()` implementations and the `CommsEnvironment`
+ * singleton created via `LoggedEnvironment.accumulate`. Services read their
+ * credentials and defaults from the matching `comms.<provider>` slice, using
+ * the `envString`/`envNumber` helpers from `shared/environmentValue` to reject
+ * unset-leaf proxies. The matching public subpath exports are
+ * `@decaf-ts/integrations/comms/discord`,
+ * `@decaf-ts/integrations/comms/whatsapp`, and
+ * `@decaf-ts/integrations/comms/outlook`.
+ */
+/**
+ * @description Environment shape for the comms integration services
+ * @summary Defines the `comms` root with one slice per provider (`slack`,
+ * `telegram`, `teams`, `email`, `gmail`, `discord`, `whatsApp`, `outlook`).
+ * Each slice carries the provider's required credentials (e.g. `token`,
+ * `webhookUrl`, `phoneNumberId`) plus optional `baseUrl` override and
+ * `timeout`. Fields are typed as required here so
+ * `LoggedEnvironment.accumulate` registers them; absent values resolve to
+ * proxy placeholders at runtime and must pass through `envString`/`envNumber`.
+ * Values are credential references supplied by the environment, never literals
+ * embedded in source.
+ * @memberOf module:integrations/comms/environment
+ */
+export interface CommsEnvironmentShape {
+    comms: {
+        slack: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        telegram: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        teams: {
+            token: string;
+            webhookUrl: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        email: {
+            provider: string;
+            host: string;
+            port?: number;
+            secure?: boolean;
+            username: string;
+            password: string;
+            from: string;
+            token: string;
+            graphBaseUrl: string;
+            /** Explicit opt-in for SMTP AUTH over a plaintext session (default false). */
+            allowPlaintextAuth?: boolean;
+            timeout?: number;
+        };
+        gmail: {
+            token: string;
+            userId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** Discord bot token and optional API overrides (`comms/discord`). */
+        discord: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** WhatsApp Cloud API token and sender phone number ID (`comms/whatsapp`). */
+        whatsApp: {
+            token: string;
+            phoneNumberId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** Microsoft Graph access token for Outlook mail/calendar (`comms/outlook`). */
+        outlook: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+    };
+}
+/**
+ * @description Accumulated comms environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `CommsEnvironmentShape` contract. Comms services read their provider slice
+ * (e.g. `CommsEnvironment.comms.slack`) 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 { SlackService } from "@decaf-ts/integrations/comms/slack";
+ *
+ * // with comms.slack.token / comms.slack.baseUrl configured in the environment
+ * const slack = new SlackService();
+ * await slack.initialize();
+ * ```
+ * @constant {LoggedEnvironment} CommsEnvironment
+ * @memberOf module:integrations/comms/environment
+ */
+export declare const CommsEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & CommsEnvironmentShape>;

package/lib/types/comms/environment.d.mts

@@ -0,0 +1,110 @@
+/**
+ * @module integrations/comms/environment
+ * @summary Environment contract and accumulated environment for the comms integration services.
+ * @description Declares the `CommsEnvironmentShape` consumed by the Slack,
+ * Telegram, Teams, Gmail, Discord, WhatsApp, and Outlook services'
+ * `configFromEnvironment()` implementations and the `CommsEnvironment`
+ * singleton created via `LoggedEnvironment.accumulate`. Services read their
+ * credentials and defaults from the matching `comms.<provider>` slice, using
+ * the `envString`/`envNumber` helpers from `shared/environmentValue` to reject
+ * unset-leaf proxies. The matching public subpath exports are
+ * `@decaf-ts/integrations/comms/discord`,
+ * `@decaf-ts/integrations/comms/whatsapp`, and
+ * `@decaf-ts/integrations/comms/outlook`.
+ */
+/**
+ * @description Environment shape for the comms integration services
+ * @summary Defines the `comms` root with one slice per provider (`slack`,
+ * `telegram`, `teams`, `email`, `gmail`, `discord`, `whatsApp`, `outlook`).
+ * Each slice carries the provider's required credentials (e.g. `token`,
+ * `webhookUrl`, `phoneNumberId`) plus optional `baseUrl` override and
+ * `timeout`. Fields are typed as required here so
+ * `LoggedEnvironment.accumulate` registers them; absent values resolve to
+ * proxy placeholders at runtime and must pass through `envString`/`envNumber`.
+ * Values are credential references supplied by the environment, never literals
+ * embedded in source.
+ * @memberOf module:integrations/comms/environment
+ */
+export interface CommsEnvironmentShape {
+    comms: {
+        slack: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        telegram: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        teams: {
+            token: string;
+            webhookUrl: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        email: {
+            provider: string;
+            host: string;
+            port?: number;
+            secure?: boolean;
+            username: string;
+            password: string;
+            from: string;
+            token: string;
+            graphBaseUrl: string;
+            /** Explicit opt-in for SMTP AUTH over a plaintext session (default false). */
+            allowPlaintextAuth?: boolean;
+            timeout?: number;
+        };
+        gmail: {
+            token: string;
+            userId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** Discord bot token and optional API overrides (`comms/discord`). */
+        discord: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** WhatsApp Cloud API token and sender phone number ID (`comms/whatsapp`). */
+        whatsApp: {
+            token: string;
+            phoneNumberId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+        /** Microsoft Graph access token for Outlook mail/calendar (`comms/outlook`). */
+        outlook: {
+            token: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+    };
+}
+/**
+ * @description Accumulated comms environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `CommsEnvironmentShape` contract. Comms services read their provider slice
+ * (e.g. `CommsEnvironment.comms.slack`) 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 { SlackService } from "@decaf-ts/integrations/comms/slack";
+ *
+ * // with comms.slack.token / comms.slack.baseUrl configured in the environment
+ * const slack = new SlackService();
+ * await slack.initialize();
+ * ```
+ * @constant {LoggedEnvironment} CommsEnvironment
+ * @memberOf module:integrations/comms/environment
+ */
+export declare const CommsEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & CommsEnvironmentShape>;