@fluojs/slack 1.0.0-beta.1

package/dist/tokens.js

@@ -0,0 +1,6 @@
+/** Compatibility token for the facade returned by {@link SlackModule.forRoot}. */
+export const SLACK = Symbol.for('fluo.slack');
+/** Injection token for the channel implementation consumed by `@fluojs/notifications`. */
+export const SLACK_CHANNEL = Symbol.for('fluo.slack.channel');
+/** Injection token for normalized Slack module options consumed internally by providers. */
+export const SLACK_OPTIONS = Symbol.for('fluo.slack.options');

package/dist/types.d.ts

@@ -0,0 +1,246 @@
+import type { AsyncModuleOptions, MaybePromise } from '@fluojs/core';
+import type { NotificationDispatchRequest } from '@fluojs/notifications';
+/** Opaque Slack Block Kit object forwarded to one transport implementation. */
+export type SlackBlock = Readonly<Record<string, unknown>>;
+/** Opaque Slack attachment object forwarded to one transport implementation. */
+export type SlackAttachment = Readonly<Record<string, unknown>>;
+/** Caller-supplied Slack message shape used for standalone delivery. */
+export interface SlackMessage {
+    attachments?: readonly SlackAttachment[];
+    blocks?: readonly SlackBlock[];
+    channel?: string;
+    iconEmoji?: string;
+    iconUrl?: string;
+    metadata?: Record<string, unknown>;
+    mrkdwn?: boolean;
+    replyBroadcast?: boolean;
+    text?: string;
+    threadTs?: string;
+    unfurlLinks?: boolean;
+    unfurlMedia?: boolean;
+    username?: string;
+}
+/** Normalized Slack message passed to one transport implementation. */
+export interface NormalizedSlackMessage {
+    attachments: readonly SlackAttachment[];
+    blocks: readonly SlackBlock[];
+    channel?: string;
+    iconEmoji?: string;
+    iconUrl?: string;
+    metadata?: Record<string, unknown>;
+    mrkdwn?: boolean;
+    replyBroadcast?: boolean;
+    text?: string;
+    threadTs?: string;
+    unfurlLinks?: boolean;
+    unfurlMedia?: boolean;
+    username?: string;
+}
+/** Context object forwarded to transport implementations per delivery attempt. */
+export interface SlackTransportContext {
+    signal?: AbortSignal;
+}
+/** Provider-specific receipt returned by one Slack transport. */
+export interface SlackTransportReceipt {
+    channel?: string;
+    messageTs?: string;
+    metadata?: Record<string, unknown>;
+    ok?: boolean;
+    response?: string;
+    statusCode?: number;
+    warnings?: readonly string[];
+}
+/** Transport contract implemented by runtime-specific or provider-specific Slack adapters. */
+export interface SlackTransport {
+    /**
+     * Sends one normalized Slack message.
+     *
+     * @param message Normalized message with resolved defaults and one target channel.
+     * @param context Optional abort context propagated from the caller.
+     * @returns Provider-specific receipt details normalized for the Fluo Slack contract.
+     */
+    send(message: NormalizedSlackMessage, context: SlackTransportContext): Promise<SlackTransportReceipt>;
+    /**
+     * Verifies transport readiness during bootstrap when configured.
+     *
+     * @returns A promise that resolves when the transport is ready for delivery.
+     */
+    verify?(): MaybePromise<void>;
+    /**
+     * Closes underlying transport resources during application shutdown.
+     *
+     * @returns A promise that resolves when resource cleanup completes.
+     */
+    close?(): MaybePromise<void>;
+}
+/** Factory used to construct a transport lazily during module bootstrap. */
+export interface SlackTransportFactory {
+    /**
+     * Creates the transport instance used by {@link SlackService}.
+     *
+     * @returns The transport implementation that will own Slack delivery.
+     */
+    create(): MaybePromise<SlackTransport>;
+    /**
+     * Stable diagnostic label describing the injected transport kind.
+     *
+     * @remarks
+     * This value is surfaced through platform status snapshots so applications can
+     * tell which adapter is currently wired without the package hard-coding a
+     * provider-specific runtime dependency.
+     */
+    kind?: string;
+    /**
+     * Declares whether the factory-created transport owns resources that the package should close.
+     *
+     * @remarks
+     * Factories default to `true` because they typically allocate the transport instance.
+     * Directly injected transport instances default to `false` because the caller owns them.
+     */
+    ownsResources?: boolean;
+}
+/** Minimal fetch-compatible response contract used by the built-in webhook transport helper. */
+export interface SlackFetchResponse {
+    ok: boolean;
+    status: number;
+    statusText?: string;
+    text(): MaybePromise<string>;
+}
+/** Minimal fetch-compatible function signature used by the built-in webhook transport helper. */
+export interface SlackFetchLike {
+    (input: string, init?: {
+        body?: string;
+        headers?: Readonly<Record<string, string>>;
+        method?: string;
+        signal?: AbortSignal;
+    }): MaybePromise<SlackFetchResponse>;
+}
+/** Options accepted by {@link createSlackWebhookTransport}. */
+export interface SlackWebhookTransportOptions {
+    fetch?: SlackFetchLike;
+    webhookUrl: string;
+}
+/** Template render input used for `NotificationDispatchRequest.template` integration. */
+export interface SlackTemplateRenderInput<TPayload extends SlackNotificationPayload = SlackNotificationPayload> {
+    locale?: string;
+    metadata?: Record<string, unknown>;
+    payload: TPayload;
+    subject?: string;
+    template: string;
+}
+/** Render result returned by an optional Slack template renderer. */
+export interface SlackTemplateRenderResult {
+    attachments?: readonly SlackAttachment[];
+    blocks?: readonly SlackBlock[];
+    text?: string;
+}
+/** Optional renderer used to turn notification templates into concrete Slack content. */
+export interface SlackTemplateRenderer {
+    /**
+     * Renders one notification template into Slack text and/or Block Kit content.
+     *
+     * @typeParam TPayload Payload shape carried by the notification request.
+     * @param input Template render input including the template key and opaque payload.
+     * @returns Rendered text or block fragments that are merged with explicit payload overrides.
+     */
+    render<TPayload extends SlackNotificationPayload = SlackNotificationPayload>(input: SlackTemplateRenderInput<TPayload>): MaybePromise<SlackTemplateRenderResult>;
+}
+/** Notification payload understood by {@link SlackChannel} and {@link SlackService.sendNotification}. */
+export interface SlackNotificationPayload extends Record<string, unknown> {
+    attachments?: readonly SlackAttachment[];
+    blocks?: readonly SlackBlock[];
+    channel?: string;
+    iconEmoji?: string;
+    iconUrl?: string;
+    metadata?: Record<string, unknown>;
+    mrkdwn?: boolean;
+    replyBroadcast?: boolean;
+    text?: string;
+    threadTs?: string;
+    unfurlLinks?: boolean;
+    unfurlMedia?: boolean;
+    username?: string;
+}
+/** Shared notification request subtype consumed by the Slack channel implementation. */
+export interface SlackNotificationDispatchRequest extends NotificationDispatchRequest<SlackNotificationPayload> {
+    channel: string;
+}
+/** Caller-visible result returned by standalone and notification-backed Slack delivery. */
+export interface SlackSendResult extends SlackTransportReceipt {
+    ok: boolean;
+    warnings: readonly string[];
+}
+/** Failure entry returned by tolerant batch delivery. */
+export interface SlackSendFailure {
+    error: Error;
+    message: SlackMessage;
+}
+/** Summary returned by {@link SlackService.sendMany}. */
+export interface SlackSendBatchResult {
+    failed: number;
+    failures: readonly SlackSendFailure[];
+    results: readonly SlackSendResult[];
+    succeeded: number;
+}
+/** Additional send controls applied to one Slack delivery attempt. */
+export interface SlackSendOptions {
+    signal?: AbortSignal;
+}
+/** Additional controls applied to one batch send operation. */
+export interface SlackSendManyOptions extends SlackSendOptions {
+    continueOnError?: boolean;
+}
+/** Module options accepted by {@link SlackModule.forRoot} and `forRootAsync`. */
+export interface SlackModuleOptions {
+    defaultChannel?: string;
+    notifications?: {
+        channel?: string;
+    };
+    renderer?: SlackTemplateRenderer;
+    transport: SlackTransport | SlackTransportFactory;
+    verifyOnModuleInit?: boolean;
+}
+/** Async registration options for Slack modules that derive config through DI. */
+export type SlackAsyncModuleOptions = AsyncModuleOptions<SlackModuleOptions>;
+/** Normalized module options resolved once during module registration. */
+export interface NormalizedSlackModuleOptions {
+    defaultChannel?: string;
+    notifications: {
+        channel: string;
+    };
+    renderer?: SlackTemplateRenderer;
+    transport: {
+        create: () => Promise<SlackTransport>;
+        kind: string;
+        ownsResources: boolean;
+    };
+    verifyOnModuleInit: boolean;
+}
+/** Slack facade exposed to application code and the compatibility token. */
+export interface Slack {
+    /**
+     * Sends one Slack message directly through the configured transport.
+     *
+     * @param message Caller-supplied Slack message with text and/or block content.
+     * @param options Optional abort signal propagated to the transport.
+     * @returns A normalized delivery receipt describing the transport response.
+     */
+    send(message: SlackMessage, options?: SlackSendOptions): Promise<SlackSendResult>;
+    /**
+     * Sends multiple Slack messages in input order with optional tolerant failure handling.
+     *
+     * @param messages Ordered message list to deliver through the configured transport.
+     * @param options Optional tolerant batch controls such as `continueOnError`.
+     * @returns A batch summary containing successes and any captured failures.
+     */
+    sendMany(messages: readonly SlackMessage[], options?: SlackSendManyOptions): Promise<SlackSendBatchResult>;
+    /**
+     * Converts one notifications foundation request into a concrete Slack delivery.
+     *
+     * @param notification Shared notification envelope interpreted by the Slack package.
+     * @param options Optional abort signal propagated to rendering and transport work.
+     * @returns A normalized delivery receipt for the resulting Slack message.
+     */
+    sendNotification(notification: SlackNotificationDispatchRequest, options?: SlackSendOptions): Promise<SlackSendResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/webhook.d.ts

@@ -0,0 +1,19 @@
+import type { SlackTransport, SlackWebhookTransportOptions } from './types.js';
+/**
+ * Creates a webhook-first Slack transport backed by an explicit fetch-compatible boundary.
+ *
+ * @param options Webhook URL plus an optional injected fetch implementation for portable runtimes.
+ * @returns A Slack transport that posts JSON payloads to one Slack incoming webhook endpoint.
+ * @throws {SlackConfigurationError} When the webhook url is empty or no fetch implementation is available.
+ * @throws {SlackTransportError} When Slack responds with a non-success HTTP status.
+ *
+ * @example
+ * ```ts
+ * const transport = createSlackWebhookTransport({
+ *   fetch: runtime.fetch,
+ *   webhookUrl: 'https://hooks.slack.com/services/XXX/YYY/ZZZ',
+ * });
+ * ```
+ */
+export declare function createSlackWebhookTransport(options: SlackWebhookTransportOptions): SlackTransport;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,cAAc,EAEd,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAwFpB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,cAAc,CA6DjG"}

package/dist/webhook.js

@@ -0,0 +1,166 @@
+import { SlackConfigurationError, SlackTransportError } from './errors.js';
+const DEFAULT_RETRY_ATTEMPTS = 3;
+const DEFAULT_RETRY_DELAY_MS = 250;
+function normalizeOptionalString(value) {
+  const trimmed = value?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+function createWebhookPayload(message) {
+  return {
+    ...(message.attachments.length > 0 ? {
+      attachments: message.attachments
+    } : {}),
+    ...(message.blocks.length > 0 ? {
+      blocks: message.blocks
+    } : {}),
+    ...(message.channel ? {
+      channel: message.channel
+    } : {}),
+    ...(message.iconEmoji ? {
+      icon_emoji: message.iconEmoji
+    } : {}),
+    ...(message.iconUrl ? {
+      icon_url: message.iconUrl
+    } : {}),
+    ...(message.metadata ? {
+      metadata: message.metadata
+    } : {}),
+    ...(typeof message.mrkdwn === 'boolean' ? {
+      mrkdwn: message.mrkdwn
+    } : {}),
+    ...(typeof message.replyBroadcast === 'boolean' ? {
+      reply_broadcast: message.replyBroadcast
+    } : {}),
+    ...(message.text ? {
+      text: message.text
+    } : {}),
+    ...(message.threadTs ? {
+      thread_ts: message.threadTs
+    } : {}),
+    ...(typeof message.unfurlLinks === 'boolean' ? {
+      unfurl_links: message.unfurlLinks
+    } : {}),
+    ...(typeof message.unfurlMedia === 'boolean' ? {
+      unfurl_media: message.unfurlMedia
+    } : {}),
+    ...(message.username ? {
+      username: message.username
+    } : {})
+  };
+}
+function resolveFetch(fetchLike) {
+  if (fetchLike) {
+    return fetchLike;
+  }
+  if (typeof globalThis.fetch !== 'function') {
+    throw new SlackConfigurationError('Slack webhook transport requires an explicit fetch implementation when `globalThis.fetch` is unavailable.');
+  }
+  return (input, init) => globalThis.fetch(input, init);
+}
+async function readResponseBody(response) {
+  try {
+    return await response.text();
+  } catch {
+    return '';
+  }
+}
+function createStatusFailureMessage(response, attempt) {
+  return `Slack webhook delivery failed with status ${response.status}${response.statusText ? ` ${response.statusText}` : ''} after ${String(attempt)} attempt(s). Upstream response body was omitted from the caller-visible error.`;
+}
+function createTransportFailureMessage(attempt) {
+  return `Slack webhook delivery failed after ${String(attempt)} attempt(s). Upstream response details were omitted from the caller-visible error.`;
+}
+function isAbortError(error) {
+  return error instanceof Error && error.name === 'AbortError';
+}
+function isTransientStatus(status) {
+  return status === 408 || status === 429 || status >= 500 && status <= 599;
+}
+async function waitForRetry(delayMs, signal) {
+  if (delayMs <= 0) {
+    return;
+  }
+  await new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      signal?.removeEventListener('abort', onAbort);
+      resolve();
+    }, delayMs);
+    function onAbort() {
+      clearTimeout(timer);
+      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'));
+    }
+    if (signal) {
+      signal.addEventListener('abort', onAbort, {
+        once: true
+      });
+    }
+  });
+}
+
+/**
+ * Creates a webhook-first Slack transport backed by an explicit fetch-compatible boundary.
+ *
+ * @param options Webhook URL plus an optional injected fetch implementation for portable runtimes.
+ * @returns A Slack transport that posts JSON payloads to one Slack incoming webhook endpoint.
+ * @throws {SlackConfigurationError} When the webhook url is empty or no fetch implementation is available.
+ * @throws {SlackTransportError} When Slack responds with a non-success HTTP status.
+ *
+ * @example
+ * ```ts
+ * const transport = createSlackWebhookTransport({
+ *   fetch: runtime.fetch,
+ *   webhookUrl: 'https://hooks.slack.com/services/XXX/YYY/ZZZ',
+ * });
+ * ```
+ */
+export function createSlackWebhookTransport(options) {
+  const webhookUrl = normalizeOptionalString(options.webhookUrl);
+  if (!webhookUrl) {
+    throw new SlackConfigurationError('Slack webhook transport requires a non-empty `webhookUrl`.');
+  }
+  const fetchLike = resolveFetch(options.fetch);
+  return {
+    async send(message, context) {
+      for (let attempt = 1; attempt <= DEFAULT_RETRY_ATTEMPTS; attempt += 1) {
+        try {
+          const response = await fetchLike(webhookUrl, {
+            body: JSON.stringify(createWebhookPayload(message)),
+            headers: {
+              'content-type': 'application/json; charset=utf-8'
+            },
+            method: 'POST',
+            signal: context.signal
+          });
+          const body = await readResponseBody(response);
+          if (!response.ok) {
+            if (attempt < DEFAULT_RETRY_ATTEMPTS && isTransientStatus(response.status)) {
+              await waitForRetry(DEFAULT_RETRY_DELAY_MS * 2 ** (attempt - 1), context.signal);
+              continue;
+            }
+            throw new SlackTransportError(createStatusFailureMessage(response, attempt));
+          }
+          return {
+            channel: message.channel,
+            ok: true,
+            response: body,
+            statusCode: response.status,
+            warnings: body && body !== 'ok' ? ['Slack webhook returned a non-standard success body.'] : []
+          };
+        } catch (error) {
+          if (isAbortError(error) || context.signal?.aborted) {
+            throw error;
+          }
+          if (attempt < DEFAULT_RETRY_ATTEMPTS) {
+            await waitForRetry(DEFAULT_RETRY_DELAY_MS * 2 ** (attempt - 1), context.signal);
+            continue;
+          }
+          if (error instanceof SlackTransportError) {
+            throw error;
+          }
+          throw new SlackTransportError(createTransportFailureMessage(attempt));
+        }
+      }
+      throw new SlackTransportError(createTransportFailureMessage(DEFAULT_RETRY_ATTEMPTS));
+    }
+  };
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fluojs/slack",
+  "description": "Webhook-first, transport-agnostic Slack delivery core for Fluo with notifications integration.",
+  "keywords": [
+    "fluo",
+    "slack",
+    "webhook",
+    "notifications",
+    "portable",
+    "fetch"
+  ],
+  "version": "1.0.0-beta.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/slack"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fluojs/core": "^1.0.0-beta.1",
+    "@fluojs/runtime": "^1.0.0-beta.1",
+    "@fluojs/di": "^1.0.0-beta.1",
+    "@fluojs/notifications": "^1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "pnpm exec vitest run -c vitest.config.ts",
+    "test:watch": "pnpm exec vitest -c vitest.config.ts"
+  }
+}