@fluojs/slack 1.0.0-beta.1

package/dist/index.js

@@ -0,0 +1,7 @@
+export { SlackConfigurationError, SlackMessageValidationError, SlackTransportError } from './errors.js';
+export { SlackChannel } from './channel.js';
+export { SlackModule, createSlackProviders } from './module.js';
+export { SlackService } from './service.js';
+export { createSlackPlatformStatusSnapshot } from './status.js';
+export { SLACK, SLACK_CHANNEL } from './tokens.js';
+export { createSlackWebhookTransport } from './webhook.js';

package/dist/module.d.ts

@@ -0,0 +1,49 @@
+import type { Provider } from '@fluojs/di';
+import { type ModuleType } from '@fluojs/runtime';
+import type { SlackAsyncModuleOptions, SlackModuleOptions } from './types.js';
+/**
+ * Creates Slack providers for manual module composition.
+ *
+ * @param options Static Slack module options including explicit transport wiring.
+ * @returns Provider definitions equivalent to {@link SlackModule.forRoot} wiring.
+ */
+export declare function createSlackProviders(options: SlackModuleOptions): Provider[];
+/** Runtime module entrypoint for Slack delivery and notifications integration. */
+export declare class SlackModule {
+    /**
+     * Registers Slack providers using static options.
+     *
+     * @param options Static Slack module options including transport wiring and optional template rendering behavior.
+     * @returns A global module definition that exports {@link SlackService}, {@link SlackChannel}, and compatibility tokens.
+     *
+     * @example
+     * ```ts
+     * SlackModule.forRoot({
+     *   transport: createSlackWebhookTransport({ webhookUrl: 'https://hooks.slack.com/services/...' }),
+     * });
+     * ```
+     */
+    static forRoot(options: SlackModuleOptions): ModuleType;
+    /**
+     * Registers Slack providers from an async DI factory.
+     *
+     * @param options Async module options that resolve Slack transport and renderer configuration through DI.
+     * @returns A global module definition that memoizes async option resolution per module instance.
+     *
+     * @example
+     * ```ts
+     * SlackModule.forRootAsync({
+     *   inject: [ConfigService],
+     *   useFactory: (config) => ({
+     *     defaultChannel: config.slack.channel,
+     *     transport: createSlackWebhookTransport({
+     *       fetch: config.runtime.fetch,
+     *       webhookUrl: config.slack.webhookUrl,
+     *     }),
+     *   }),
+     * });
+     * ```
+     */
+    static forRootAsync(options: SlackAsyncModuleOptions): ModuleType;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhE,OAAO,KAAK,EAGV,uBAAuB,EACvB,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AA0DpB;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CAK5E;AAsCD,kFAAkF;AAClF,qBAAa,WAAW;IACtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU;IAIvD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU;CAGlE"}

package/dist/module.js

@@ -0,0 +1,133 @@
+import { defineModule } from '@fluojs/runtime';
+import { SlackConfigurationError } from './errors.js';
+import { SlackChannel } from './channel.js';
+import { SlackService } from './service.js';
+import { SLACK, SLACK_CHANNEL, SLACK_OPTIONS } from './tokens.js';
+function normalizeOptionalString(value) {
+  const trimmed = value?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+function isTransportFactory(value) {
+  return typeof value === 'object' && value !== null && 'create' in value;
+}
+function normalizeSlackModuleOptions(options) {
+  if (!options.transport) {
+    throw new SlackConfigurationError('SlackModule requires an explicit `transport` to be configured.');
+  }
+  const transport = options.transport;
+  const createTransport = isTransportFactory(transport) ? async () => transport.create() : async () => transport;
+  return {
+    defaultChannel: normalizeOptionalString(options.defaultChannel),
+    notifications: {
+      channel: normalizeOptionalString(options.notifications?.channel) ?? 'slack'
+    },
+    renderer: options.renderer,
+    transport: {
+      create: createTransport,
+      kind: isTransportFactory(transport) ? normalizeOptionalString(transport.kind) ?? 'custom-factory' : 'custom-instance',
+      ownsResources: isTransportFactory(transport) ? transport.ownsResources ?? true : false
+    },
+    verifyOnModuleInit: options.verifyOnModuleInit ?? false
+  };
+}
+function createSlackRuntimeProviders(optionsProvider) {
+  return [optionsProvider, SlackService, SlackChannel, {
+    inject: [SlackService],
+    provide: SLACK,
+    useFactory: service => ({
+      send: (message, options) => service.send(message, options),
+      sendMany: (messages, options) => service.sendMany(messages, options),
+      sendNotification: (notification, options) => service.sendNotification(notification, options)
+    })
+  }, {
+    inject: [SlackChannel],
+    provide: SLACK_CHANNEL,
+    useFactory: channel => channel
+  }];
+}
+
+/**
+ * Creates Slack providers for manual module composition.
+ *
+ * @param options Static Slack module options including explicit transport wiring.
+ * @returns Provider definitions equivalent to {@link SlackModule.forRoot} wiring.
+ */
+export function createSlackProviders(options) {
+  return createSlackRuntimeProviders({
+    provide: SLACK_OPTIONS,
+    useValue: normalizeSlackModuleOptions(options)
+  });
+}
+function buildSlackModule(options) {
+  class SlackRootModuleDefinition {}
+  return defineModule(SlackRootModuleDefinition, {
+    exports: [SlackService, SlackChannel, SLACK, SLACK_CHANNEL],
+    global: true,
+    providers: createSlackProviders(options)
+  });
+}
+function buildSlackModuleAsync(options) {
+  class SlackAsyncModuleDefinition {}
+  const factory = options.useFactory;
+  let cachedResult;
+  const memoizedFactory = (...deps) => {
+    if (!cachedResult) {
+      cachedResult = Promise.resolve(factory(...deps)).then(resolved => normalizeSlackModuleOptions(resolved));
+    }
+    return cachedResult;
+  };
+  return defineModule(SlackAsyncModuleDefinition, {
+    exports: [SlackService, SlackChannel, SLACK, SLACK_CHANNEL],
+    global: true,
+    providers: createSlackRuntimeProviders({
+      inject: options.inject,
+      provide: SLACK_OPTIONS,
+      scope: 'singleton',
+      useFactory: (...deps) => memoizedFactory(...deps)
+    })
+  });
+}
+
+/** Runtime module entrypoint for Slack delivery and notifications integration. */
+export class SlackModule {
+  /**
+   * Registers Slack providers using static options.
+   *
+   * @param options Static Slack module options including transport wiring and optional template rendering behavior.
+   * @returns A global module definition that exports {@link SlackService}, {@link SlackChannel}, and compatibility tokens.
+   *
+   * @example
+   * ```ts
+   * SlackModule.forRoot({
+   *   transport: createSlackWebhookTransport({ webhookUrl: 'https://hooks.slack.com/services/...' }),
+   * });
+   * ```
+   */
+  static forRoot(options) {
+    return buildSlackModule(options);
+  }
+
+  /**
+   * Registers Slack providers from an async DI factory.
+   *
+   * @param options Async module options that resolve Slack transport and renderer configuration through DI.
+   * @returns A global module definition that memoizes async option resolution per module instance.
+   *
+   * @example
+   * ```ts
+   * SlackModule.forRootAsync({
+   *   inject: [ConfigService],
+   *   useFactory: (config) => ({
+   *     defaultChannel: config.slack.channel,
+   *     transport: createSlackWebhookTransport({
+   *       fetch: config.runtime.fetch,
+   *       webhookUrl: config.slack.webhookUrl,
+   *     }),
+   *   }),
+   * });
+   * ```
+   */
+  static forRootAsync(options) {
+    return buildSlackModuleAsync(options);
+  }
+}

package/dist/service.d.ts

@@ -0,0 +1,79 @@
+import type { OnApplicationShutdown, OnModuleInit } from '@fluojs/runtime';
+import type { NormalizedSlackModuleOptions, Slack, SlackMessage, SlackNotificationDispatchRequest, SlackSendBatchResult, SlackSendManyOptions, SlackSendOptions, SlackSendResult } from './types.js';
+/**
+ * Injectable Slack delivery service for standalone and notifications-backed usage.
+ *
+ * @remarks
+ * The service stays transport-agnostic at the shared package boundary, consumes only
+ * explicitly injected {@link SlackTransport} contracts, and translates
+ * `@fluojs/notifications` envelopes into concrete Slack messages.
+ */
+export declare class SlackService implements Slack, OnModuleInit, OnApplicationShutdown {
+    private readonly options;
+    private lifecycleState;
+    private resolvedTransport;
+    private transportPromise;
+    constructor(options: NormalizedSlackModuleOptions);
+    onApplicationShutdown(): Promise<void>;
+    onModuleInit(): Promise<void>;
+    /**
+     * Creates a platform status snapshot for the active Slack transport wiring.
+     *
+     * @returns A structured snapshot describing lifecycle state, resource ownership, and notifications integration details.
+     */
+    createPlatformStatusSnapshot(): import("./status.js").SlackPlatformStatusSnapshot;
+    /**
+     * 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.
+     * @throws {SlackMessageValidationError} When the resolved message does not include Slack-visible content.
+     *
+     * @example
+     * ```ts
+     * await slack.send({
+     *   channel: '#ops',
+     *   text: 'Deploy finished successfully.',
+     * });
+     * ```
+     */
+    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.
+     *
+     * @example
+     * ```ts
+     * const result = await slack.sendMany(messages, { continueOnError: true });
+     * console.log(result.succeeded, result.failed);
+     * ```
+     */
+    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.
+     * @throws {SlackMessageValidationError} When the notification cannot resolve one target channel or any Slack-visible content.
+     *
+     * @example
+     * ```ts
+     * await slack.sendNotification({
+     *   channel: 'slack',
+     *   payload: { text: 'Deploy finished successfully.' },
+     *   recipients: ['#ops'],
+     * });
+     * ```
+     */
+    sendNotification(notification: SlackNotificationDispatchRequest, options?: SlackSendOptions): Promise<SlackSendResult>;
+    private ensureTransport;
+    private normalizeMessage;
+    private resolveNotificationChannel;
+    private renderNotification;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK3E,OAAO,KAAK,EAEV,4BAA4B,EAC5B,KAAK,EACL,YAAY,EACZ,gCAAgC,EAChC,oBAAoB,EAEpB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAqBpB;;;;;;;GAOG;AACH,qBACa,YAAa,YAAW,KAAK,EAAE,YAAY,EAAE,qBAAqB;IAKjE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,gBAAgB,CAAsC;gBAEjC,OAAO,EAAE,4BAA4B;IAE5D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAqB3F;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6BpH;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,gCAAgC,EAC9C,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;YA6Bb,eAAe;IAe7B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,0BAA0B;YAkBpB,kBAAkB;CAejC"}

package/dist/service.js

@@ -0,0 +1,261 @@
+let _initClass;
+function _applyDecs(e, t, n, r, o, i) { var a, c, u, s, f, l, p, d = Symbol.metadata || Symbol.for("Symbol.metadata"), m = Object.defineProperty, h = Object.create, y = [h(null), h(null)], v = t.length; function g(t, n, r) { return function (o, i) { n && (i = o, o = e); for (var a = 0; a < t.length; a++) i = t[a].apply(o, r ? [i] : []); return r ? i : o; }; } function b(e, t, n, r) { if ("function" != typeof e && (r || void 0 !== e)) throw new TypeError(t + " must " + (n || "be") + " a function" + (r ? "" : " or undefined")); return e; } function applyDec(e, t, n, r, o, i, u, s, f, l, p) { function d(e) { if (!p(e)) throw new TypeError("Attempted to access private element on non-instance"); } var h = [].concat(t[0]), v = t[3], w = !u, D = 1 === o, S = 3 === o, j = 4 === o, E = 2 === o; function I(t, n, r) { return function (o, i) { return n && (i = o, o = e), r && r(o), P[t].call(o, i); }; } if (!w) { var P = {}, k = [], F = S ? "get" : j || D ? "set" : "value"; if (f ? (l || D ? P = { get: _setFunctionName(function () { return v(this); }, r, "get"), set: function (e) { t[4](this, e); } } : P[F] = v, l || _setFunctionName(P[F], r, E ? "" : F)) : l || (P = Object.getOwnPropertyDescriptor(e, r)), !l && !f) { if ((c = y[+s][r]) && 7 !== (c ^ o)) throw Error("Decorating two elements with the same name (" + P[F].name + ") is not supported yet"); y[+s][r] = o < 3 ? 1 : o; } } for (var N = e, O = h.length - 1; O >= 0; O -= n ? 2 : 1) { var T = b(h[O], "A decorator", "be", !0), z = n ? h[O - 1] : void 0, A = {}, H = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: r, metadata: a, addInitializer: function (e, t) { if (e.v) throw new TypeError("attempted to call addInitializer after decoration was finished"); b(t, "An initializer", "be", !0), i.push(t); }.bind(null, A) }; if (w) c = T.call(z, N, H), A.v = 1, b(c, "class decorators", "return") && (N = c);else if (H.static = s, H.private = f, c = H.access = { has: f ? p.bind() : function (e) { return r in e; } }, j || (c.get = f ? E ? function (e) { return d(e), P.value; } : I("get", 0, d) : function (e) { return e[r]; }), E || S || (c.set = f ? I("set", 0, d) : function (e, t) { e[r] = t; }), N = T.call(z, D ? { get: P.get, set: P.set } : P[F], H), A.v = 1, D) { if ("object" == typeof N && N) (c = b(N.get, "accessor.get")) && (P.get = c), (c = b(N.set, "accessor.set")) && (P.set = c), (c = b(N.init, "accessor.init")) && k.unshift(c);else if (void 0 !== N) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined"); } else b(N, (l ? "field" : "method") + " decorators", "return") && (l ? k.unshift(N) : P[F] = N); } return o < 2 && u.push(g(k, s, 1), g(i, s, 0)), l || w || (f ? D ? u.splice(-1, 0, I("get", s), I("set", s)) : u.push(E ? P[F] : b.call.bind(P[F])) : m(e, r, P)), N; } function w(e) { return m(e, d, { configurable: !0, enumerable: !0, value: a }); } return void 0 !== i && (a = i[d]), a = h(null == a ? null : a), f = [], l = function (e) { e && f.push(g(e)); }, p = function (t, r) { for (var i = 0; i < n.length; i++) { var a = n[i], c = a[1], l = 7 & c; if ((8 & c) == t && !l == r) { var p = a[2], d = !!a[3], m = 16 & c; applyDec(t ? e : e.prototype, a, m, d ? "#" + p : _toPropertyKey(p), l, l < 2 ? [] : t ? s = s || [] : u = u || [], f, !!t, d, r, t && d ? function (t) { return _checkInRHS(t) === e; } : o); } } }, p(8, 0), p(0, 0), p(8, 1), p(0, 1), l(u), l(s), c = f, v || w(e), { e: c, get c() { var n = []; return v && [w(e = applyDec(e, [t], r, e.name, 5, n)), g(n, 1)]; } }; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { Inject } from '@fluojs/core';
+import { SlackMessageValidationError } from './errors.js';
+import { createSlackPlatformStatusSnapshot } from './status.js';
+import { SLACK_OPTIONS } from './tokens.js';
+function createAbortError() {
+  const error = new Error('Slack delivery was aborted.');
+  error.name = 'AbortError';
+  return error;
+}
+function normalizeOptionalString(value) {
+  const trimmed = value?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+function assertMessageContent(message) {
+  if (!message.text && message.blocks.length === 0 && message.attachments.length === 0) {
+    throw new SlackMessageValidationError('Slack messages require `text`, `blocks`, or `attachments` content.');
+  }
+}
+
+/**
+ * Injectable Slack delivery service for standalone and notifications-backed usage.
+ *
+ * @remarks
+ * The service stays transport-agnostic at the shared package boundary, consumes only
+ * explicitly injected {@link SlackTransport} contracts, and translates
+ * `@fluojs/notifications` envelopes into concrete Slack messages.
+ */
+let _SlackService;
+class SlackService {
+  static {
+    [_SlackService, _initClass] = _applyDecs(this, [Inject(SLACK_OPTIONS)], []).c;
+  }
+  lifecycleState = 'created';
+  resolvedTransport;
+  transportPromise;
+  constructor(options) {
+    this.options = options;
+  }
+  async onApplicationShutdown() {
+    this.lifecycleState = 'stopping';
+    try {
+      if (this.resolvedTransport && this.options.transport.ownsResources && this.resolvedTransport.close) {
+        await this.resolvedTransport.close();
+      }
+      this.lifecycleState = 'stopped';
+    } catch {
+      this.lifecycleState = 'failed';
+      throw new Error('Slack transport failed to close cleanly.');
+    }
+  }
+  async onModuleInit() {
+    this.lifecycleState = 'starting';
+    try {
+      const transport = await this.ensureTransport();
+      if (this.options.verifyOnModuleInit && transport.verify) {
+        await transport.verify();
+      }
+      this.lifecycleState = 'ready';
+    } catch {
+      this.lifecycleState = 'failed';
+      throw new Error('Slack transport failed to initialize.');
+    }
+  }
+
+  /**
+   * Creates a platform status snapshot for the active Slack transport wiring.
+   *
+   * @returns A structured snapshot describing lifecycle state, resource ownership, and notifications integration details.
+   */
+  createPlatformStatusSnapshot() {
+    return createSlackPlatformStatusSnapshot({
+      channelName: this.options.notifications.channel,
+      defaultChannelConfigured: this.options.defaultChannel !== undefined,
+      lifecycleState: this.lifecycleState,
+      ownsTransportResources: this.options.transport.ownsResources,
+      transportKind: this.options.transport.kind,
+      verifiedOnModuleInit: this.options.verifyOnModuleInit
+    });
+  }
+
+  /**
+   * 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.
+   * @throws {SlackMessageValidationError} When the resolved message does not include Slack-visible content.
+   *
+   * @example
+   * ```ts
+   * await slack.send({
+   *   channel: '#ops',
+   *   text: 'Deploy finished successfully.',
+   * });
+   * ```
+   */
+  async send(message, options = {}) {
+    if (options.signal?.aborted) {
+      throw createAbortError();
+    }
+    const transport = await this.ensureTransport();
+    const normalized = this.normalizeMessage(message);
+    assertMessageContent(normalized);
+    const result = await transport.send(normalized, options);
+    return {
+      channel: result.channel ?? normalized.channel,
+      messageTs: result.messageTs,
+      metadata: result.metadata,
+      ok: result.ok ?? true,
+      response: result.response,
+      statusCode: result.statusCode,
+      warnings: result.warnings ?? []
+    };
+  }
+
+  /**
+   * 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.
+   *
+   * @example
+   * ```ts
+   * const result = await slack.sendMany(messages, { continueOnError: true });
+   * console.log(result.succeeded, result.failed);
+   * ```
+   */
+  async sendMany(messages, options = {}) {
+    const results = [];
+    const failures = [];
+    for (const message of messages) {
+      try {
+        results.push(await this.send(message, options));
+      } catch (error) {
+        const failure = {
+          error: error instanceof Error ? error : new Error('Slack delivery failed.'),
+          message
+        };
+        if (!(options.continueOnError ?? false)) {
+          throw failure.error;
+        }
+        failures.push(failure);
+      }
+    }
+    return {
+      failed: failures.length,
+      failures,
+      results,
+      succeeded: results.length
+    };
+  }
+
+  /**
+   * 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.
+   * @throws {SlackMessageValidationError} When the notification cannot resolve one target channel or any Slack-visible content.
+   *
+   * @example
+   * ```ts
+   * await slack.sendNotification({
+   *   channel: 'slack',
+   *   payload: { text: 'Deploy finished successfully.' },
+   *   recipients: ['#ops'],
+   * });
+   * ```
+   */
+  async sendNotification(notification, options = {}) {
+    const payload = notification.payload;
+    const rendered = await this.renderNotification(notification);
+    return this.send({
+      attachments: payload.attachments ?? rendered?.attachments,
+      blocks: payload.blocks ?? rendered?.blocks,
+      channel: this.resolveNotificationChannel(notification),
+      iconEmoji: payload.iconEmoji,
+      iconUrl: payload.iconUrl,
+      metadata: {
+        ...(payload.metadata ?? {}),
+        ...(notification.metadata ?? {}),
+        ...(notification.subject ? {
+          subject: notification.subject
+        } : {}),
+        ...(notification.template ? {
+          template: notification.template
+        } : {})
+      },
+      mrkdwn: payload.mrkdwn,
+      replyBroadcast: payload.replyBroadcast,
+      text: payload.text ?? rendered?.text ?? notification.subject,
+      threadTs: payload.threadTs,
+      unfurlLinks: payload.unfurlLinks,
+      unfurlMedia: payload.unfurlMedia,
+      username: payload.username
+    }, options);
+  }
+  async ensureTransport() {
+    if (this.resolvedTransport) {
+      return this.resolvedTransport;
+    }
+    if (!this.transportPromise) {
+      this.transportPromise = this.options.transport.create().then(transport => {
+        this.resolvedTransport = transport;
+        return transport;
+      });
+    }
+    return this.transportPromise;
+  }
+  normalizeMessage(message) {
+    return {
+      attachments: message.attachments ?? [],
+      blocks: message.blocks ?? [],
+      channel: normalizeOptionalString(message.channel) ?? this.options.defaultChannel,
+      iconEmoji: normalizeOptionalString(message.iconEmoji),
+      iconUrl: normalizeOptionalString(message.iconUrl),
+      metadata: message.metadata,
+      mrkdwn: message.mrkdwn,
+      replyBroadcast: message.replyBroadcast,
+      text: normalizeOptionalString(message.text),
+      threadTs: normalizeOptionalString(message.threadTs),
+      unfurlLinks: message.unfurlLinks,
+      unfurlMedia: message.unfurlMedia,
+      username: normalizeOptionalString(message.username)
+    };
+  }
+  resolveNotificationChannel(notification) {
+    const payloadChannel = normalizeOptionalString(notification.payload.channel);
+    if (payloadChannel) {
+      return payloadChannel;
+    }
+    const recipients = notification.recipients?.map(entry => entry.trim()).filter(entry => entry.length > 0) ?? [];
+    if (recipients.length > 1) {
+      throw new SlackMessageValidationError('Slack notifications accept exactly one target channel per dispatch. Use `sendMany(...)` for fan-out delivery.');
+    }
+    return recipients[0] ?? this.options.defaultChannel;
+  }
+  async renderNotification(notification) {
+    if (!notification.template || !this.options.renderer) {
+      return undefined;
+    }
+    return this.options.renderer.render({
+      locale: notification.locale,
+      metadata: notification.metadata,
+      payload: notification.payload,
+      subject: notification.subject,
+      template: notification.template
+    });
+  }
+  static {
+    _initClass();
+  }
+}
+export { _SlackService as SlackService };

package/dist/status.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformHealthReport, PlatformReadinessReport, PlatformSnapshot } from '@fluojs/runtime';
+/** Resolved Slack lifecycle state used for diagnostics and health checks. */
+export type SlackLifecycleState = 'created' | 'starting' | 'ready' | 'stopping' | 'stopped' | 'failed';
+/** Input required to describe the package health/readiness contract. */
+export interface SlackStatusAdapterInput {
+    channelName: string;
+    defaultChannelConfigured: boolean;
+    lifecycleState: SlackLifecycleState;
+    ownsTransportResources: boolean;
+    transportKind: string;
+    verifiedOnModuleInit: boolean;
+}
+/** Structured snapshot returned by {@link createSlackPlatformStatusSnapshot}. */
+export interface SlackPlatformStatusSnapshot {
+    details: Record<string, unknown>;
+    health: PlatformHealthReport;
+    ownership: PlatformSnapshot['ownership'];
+    readiness: PlatformReadinessReport;
+}
+/**
+ * Creates a health/readiness snapshot for the Slack delivery layer.
+ *
+ * @param input Lifecycle and ownership details derived from the active Slack module wiring.
+ * @returns A structured snapshot suitable for status endpoints and operational diagnostics.
+ */
+export declare function createSlackPlatformStatusSnapshot(input: SlackStatusAdapterInput): SlackPlatformStatusSnapshot;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvG,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvG,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB,EAAE,OAAO,CAAC;IAClC,cAAc,EAAE,mBAAmB,CAAC;IACpC,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,iFAAiF;AACjF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,SAAS,EAAE,uBAAuB,CAAC;CACpC;AA6DD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,uBAAuB,GAAG,2BAA2B,CAiB7G"}

package/dist/status.js

@@ -0,0 +1,82 @@
+/** Resolved Slack lifecycle state used for diagnostics and health checks. */
+
+/** Input required to describe the package health/readiness contract. */
+
+/** Structured snapshot returned by {@link createSlackPlatformStatusSnapshot}. */
+
+function createReadiness(input) {
+  if (input.lifecycleState === 'ready') {
+    return {
+      critical: true,
+      status: 'ready'
+    };
+  }
+  if (input.lifecycleState === 'starting') {
+    return {
+      critical: true,
+      reason: 'Slack transport is still starting.',
+      status: 'degraded'
+    };
+  }
+  if (input.lifecycleState === 'stopping' || input.lifecycleState === 'stopped') {
+    return {
+      critical: true,
+      reason: 'Slack transport is shutting down or already stopped.',
+      status: 'not-ready'
+    };
+  }
+  if (input.lifecycleState === 'failed') {
+    return {
+      critical: true,
+      reason: 'Slack transport failed to initialize.',
+      status: 'not-ready'
+    };
+  }
+  return {
+    critical: true,
+    reason: 'Slack transport has not started yet.',
+    status: 'not-ready'
+  };
+}
+function createHealth(input) {
+  if (input.lifecycleState === 'failed' || input.lifecycleState === 'stopped') {
+    return {
+      reason: 'Slack transport is unavailable.',
+      status: 'unhealthy'
+    };
+  }
+  if (input.lifecycleState === 'created' || input.lifecycleState === 'starting' || input.lifecycleState === 'stopping') {
+    return {
+      reason: 'Slack transport is transitioning lifecycle state.',
+      status: 'degraded'
+    };
+  }
+  return {
+    status: 'healthy'
+  };
+}
+
+/**
+ * Creates a health/readiness snapshot for the Slack delivery layer.
+ *
+ * @param input Lifecycle and ownership details derived from the active Slack module wiring.
+ * @returns A structured snapshot suitable for status endpoints and operational diagnostics.
+ */
+export function createSlackPlatformStatusSnapshot(input) {
+  return {
+    details: {
+      channelName: input.channelName,
+      defaultChannelConfigured: input.defaultChannelConfigured,
+      dependencies: ['notifications.channel', 'slack.transport'],
+      lifecycleState: input.lifecycleState,
+      transportKind: input.transportKind,
+      verifiedOnModuleInit: input.verifiedOnModuleInit
+    },
+    health: createHealth(input),
+    ownership: {
+      externallyManaged: !input.ownsTransportResources,
+      ownsResources: input.ownsTransportResources
+    },
+    readiness: createReadiness(input)
+  };
+}

package/dist/tokens.d.ts

@@ -0,0 +1,10 @@
+import type { Token } from '@fluojs/core';
+import type { NotificationChannel } from '@fluojs/notifications';
+import type { NormalizedSlackModuleOptions, Slack, SlackNotificationDispatchRequest } from './types.js';
+/** Compatibility token for the facade returned by {@link SlackModule.forRoot}. */
+export declare const SLACK: Token<Slack>;
+/** Injection token for the channel implementation consumed by `@fluojs/notifications`. */
+export declare const SLACK_CHANNEL: Token<NotificationChannel<SlackNotificationDispatchRequest>>;
+/** Injection token for normalized Slack module options consumed internally by providers. */
+export declare const SLACK_OPTIONS: Token<NormalizedSlackModuleOptions>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,4BAA4B,EAAE,KAAK,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAC;AAExG,kFAAkF;AAClF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAA4B,CAAC;AAC5D,0FAA0F;AAC1F,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,mBAAmB,CAAC,gCAAgC,CAAC,CAAoC,CAAC;AAC5H,4FAA4F;AAC5F,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,4BAA4B,CAAoC,CAAC"}