@fluojs/discord 1.0.0-beta.1

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMhE,OAAO,KAAK,EAEV,yBAAyB,EACzB,oBAAoB,EAIrB,MAAM,YAAY,CAAC;AA2GpB,oFAAoF;AACpF,qBAAa,aAAa;IACxB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU;IAIzD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU;CAGpE"}

package/dist/module.js

@@ -0,0 +1,133 @@
+import { defineModule } from '@fluojs/runtime';
+import { DiscordChannel } from './channel.js';
+import { DiscordConfigurationError } from './errors.js';
+import { DiscordService } from './service.js';
+import { DISCORD, DISCORD_CHANNEL, DISCORD_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 normalizeDiscordModuleOptions(options) {
+  if (!options.transport) {
+    throw new DiscordConfigurationError('DiscordModule requires an explicit `transport` to be configured.');
+  }
+  const transport = options.transport;
+  const createTransport = isTransportFactory(transport) ? async () => transport.create() : async () => transport;
+  return {
+    defaultThreadId: normalizeOptionalString(options.defaultThreadId),
+    notifications: {
+      channel: normalizeOptionalString(options.notifications?.channel) ?? 'discord'
+    },
+    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 createDiscordRuntimeProviders(optionsProvider) {
+  return [optionsProvider, DiscordService, DiscordChannel, {
+    inject: [DiscordService],
+    provide: DISCORD,
+    useFactory: service => ({
+      send: (message, options) => service.send(message, options),
+      sendMany: (messages, options) => service.sendMany(messages, options),
+      sendNotification: (notification, options) => service.sendNotification(notification, options)
+    })
+  }, {
+    inject: [DiscordChannel],
+    provide: DISCORD_CHANNEL,
+    useFactory: channel => channel
+  }];
+}
+
+/**
+ * Creates Discord providers for manual module composition.
+ *
+ * @param options Static Discord module options including explicit transport wiring.
+ * @returns Provider definitions equivalent to {@link DiscordModule.forRoot} wiring.
+ */
+function createDiscordProviders(options) {
+  return createDiscordRuntimeProviders({
+    provide: DISCORD_OPTIONS,
+    useValue: normalizeDiscordModuleOptions(options)
+  });
+}
+function buildDiscordModule(options) {
+  class DiscordRootModuleDefinition {}
+  return defineModule(DiscordRootModuleDefinition, {
+    exports: [DiscordService, DiscordChannel, DISCORD, DISCORD_CHANNEL],
+    global: true,
+    providers: createDiscordProviders(options)
+  });
+}
+function buildDiscordModuleAsync(options) {
+  class DiscordAsyncModuleDefinition {}
+  const factory = options.useFactory;
+  let cachedResult;
+  const memoizedFactory = (...deps) => {
+    if (!cachedResult) {
+      cachedResult = Promise.resolve(factory(...deps)).then(resolved => normalizeDiscordModuleOptions(resolved));
+    }
+    return cachedResult;
+  };
+  return defineModule(DiscordAsyncModuleDefinition, {
+    exports: [DiscordService, DiscordChannel, DISCORD, DISCORD_CHANNEL],
+    global: true,
+    providers: createDiscordRuntimeProviders({
+      inject: options.inject,
+      provide: DISCORD_OPTIONS,
+      scope: 'singleton',
+      useFactory: (...deps) => memoizedFactory(...deps)
+    })
+  });
+}
+
+/** Runtime module entrypoint for Discord delivery and notifications integration. */
+export class DiscordModule {
+  /**
+   * Registers Discord providers using static options.
+   *
+   * @param options Static Discord module options including transport wiring and optional template rendering behavior.
+   * @returns A global module definition that exports {@link DiscordService}, {@link DiscordChannel}, and compatibility tokens.
+   *
+   * @example
+   * ```ts
+   * DiscordModule.forRoot({
+   *   transport: createDiscordWebhookTransport({ webhookUrl: 'https://discord.com/api/webhooks/...' }),
+   * });
+   * ```
+   */
+  static forRoot(options) {
+    return buildDiscordModule(options);
+  }
+
+  /**
+   * Registers Discord providers from an async DI factory.
+   *
+   * @param options Async module options that resolve Discord transport and renderer configuration through DI.
+   * @returns A global module definition that memoizes async option resolution per module instance.
+   *
+   * @example
+   * ```ts
+   * DiscordModule.forRootAsync({
+   *   inject: [ConfigService],
+   *   useFactory: (config) => ({
+   *     defaultThreadId: config.discord.threadId,
+   *     transport: createDiscordWebhookTransport({
+   *       fetch: config.runtime.fetch,
+   *       webhookUrl: config.discord.webhookUrl,
+   *     }),
+   *   }),
+   * });
+   * ```
+   */
+  static forRootAsync(options) {
+    return buildDiscordModuleAsync(options);
+  }
+}

package/dist/service.d.ts

@@ -0,0 +1,78 @@
+import type { OnApplicationShutdown, OnModuleInit } from '@fluojs/runtime';
+import type { Discord, DiscordMessage, DiscordNotificationDispatchRequest, DiscordSendBatchResult, DiscordSendManyOptions, DiscordSendOptions, DiscordSendResult, NormalizedDiscordModuleOptions } from './types.js';
+/**
+ * Injectable Discord delivery service for standalone and notifications-backed usage.
+ *
+ * @remarks
+ * The service stays transport-agnostic at the shared package boundary, consumes only
+ * explicitly injected {@link DiscordTransport} contracts, and translates
+ * `@fluojs/notifications` envelopes into concrete Discord messages.
+ */
+export declare class DiscordService implements Discord, OnModuleInit, OnApplicationShutdown {
+    private readonly options;
+    private lifecycleState;
+    private resolvedTransport;
+    private transportPromise;
+    constructor(options: NormalizedDiscordModuleOptions);
+    onApplicationShutdown(): Promise<void>;
+    onModuleInit(): Promise<void>;
+    /**
+     * Creates a platform status snapshot for the active Discord transport wiring.
+     *
+     * @returns A structured snapshot describing lifecycle state, resource ownership, and notifications integration details.
+     */
+    createPlatformStatusSnapshot(): import("./status.js").DiscordPlatformStatusSnapshot;
+    /**
+     * Sends one Discord message directly through the configured transport.
+     *
+     * @param message Caller-supplied Discord message with content, embeds, or component payloads.
+     * @param options Optional abort signal propagated to the transport.
+     * @returns A normalized delivery receipt describing the transport response.
+     * @throws {DiscordMessageValidationError} When the resolved message does not include Discord-visible content.
+     *
+     * @example
+     * ```ts
+     * await discord.send({
+     *   content: 'Deploy finished successfully.',
+     * });
+     * ```
+     */
+    send(message: DiscordMessage, options?: DiscordSendOptions): Promise<DiscordSendResult>;
+    /**
+     * Sends multiple Discord 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 discord.sendMany(messages, { continueOnError: true });
+     * console.log(result.succeeded, result.failed);
+     * ```
+     */
+    sendMany(messages: readonly DiscordMessage[], options?: DiscordSendManyOptions): Promise<DiscordSendBatchResult>;
+    /**
+     * Converts one notifications foundation request into a concrete Discord delivery.
+     *
+     * @param notification Shared notification envelope interpreted by the Discord package.
+     * @param options Optional abort signal propagated to rendering and transport work.
+     * @returns A normalized delivery receipt for the resulting Discord message.
+     * @throws {DiscordMessageValidationError} When the notification cannot resolve one target thread or any Discord-visible content.
+     *
+     * @example
+     * ```ts
+     * await discord.sendNotification({
+     *   channel: 'discord',
+     *   payload: { content: 'Deploy finished successfully.' },
+     *   recipients: ['release-thread-id'],
+     * });
+     * ```
+     */
+    sendNotification(notification: DiscordNotificationDispatchRequest, options?: DiscordSendOptions): Promise<DiscordSendResult>;
+    private ensureTransport;
+    private normalizeMessage;
+    private resolveNotificationThreadId;
+    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,EACV,OAAO,EACP,cAAc,EACd,kCAAkC,EAClC,sBAAsB,EAEtB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAIjB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAqBpB;;;;;;;GAOG;AACH,qBACa,cAAe,YAAW,OAAO,EAAE,YAAY,EAAE,qBAAqB;IAKrE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,cAAc,CAAmF;IACzG,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAAwC;gBAEnC,OAAO,EAAE,8BAA8B;IAE9D,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAetC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC;;;;OAIG;IACH,4BAA4B;IAW5B;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuBjG;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6B1H;;;;;;;;;;;;;;;;OAgBG;IACG,gBAAgB,CACpB,YAAY,EAAE,kCAAkC,EAChD,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YA6Bf,eAAe;IAe7B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,2BAA2B;YAkBrB,kBAAkB;CAejC"}

package/dist/service.js

@@ -0,0 +1,262 @@
+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 { DiscordMessageValidationError } from './errors.js';
+import { createDiscordPlatformStatusSnapshot } from './status.js';
+import { DISCORD_OPTIONS } from './tokens.js';
+function createAbortError() {
+  const error = new Error('Discord 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.content && message.embeds.length === 0 && message.components.length === 0 && message.attachments.length === 0) {
+    throw new DiscordMessageValidationError('Discord messages require `content`, `embeds`, `components`, or `attachments` content.');
+  }
+}
+
+/**
+ * Injectable Discord delivery service for standalone and notifications-backed usage.
+ *
+ * @remarks
+ * The service stays transport-agnostic at the shared package boundary, consumes only
+ * explicitly injected {@link DiscordTransport} contracts, and translates
+ * `@fluojs/notifications` envelopes into concrete Discord messages.
+ */
+let _DiscordService;
+class DiscordService {
+  static {
+    [_DiscordService, _initClass] = _applyDecs(this, [Inject(DISCORD_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('Discord 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('Discord transport failed to initialize.');
+    }
+  }
+
+  /**
+   * Creates a platform status snapshot for the active Discord transport wiring.
+   *
+   * @returns A structured snapshot describing lifecycle state, resource ownership, and notifications integration details.
+   */
+  createPlatformStatusSnapshot() {
+    return createDiscordPlatformStatusSnapshot({
+      channelName: this.options.notifications.channel,
+      defaultThreadConfigured: this.options.defaultThreadId !== undefined,
+      lifecycleState: this.lifecycleState,
+      ownsTransportResources: this.options.transport.ownsResources,
+      transportKind: this.options.transport.kind,
+      verifiedOnModuleInit: this.options.verifyOnModuleInit
+    });
+  }
+
+  /**
+   * Sends one Discord message directly through the configured transport.
+   *
+   * @param message Caller-supplied Discord message with content, embeds, or component payloads.
+   * @param options Optional abort signal propagated to the transport.
+   * @returns A normalized delivery receipt describing the transport response.
+   * @throws {DiscordMessageValidationError} When the resolved message does not include Discord-visible content.
+   *
+   * @example
+   * ```ts
+   * await discord.send({
+   *   content: '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 {
+      channelId: result.channelId,
+      guildId: result.guildId,
+      messageId: result.messageId,
+      metadata: result.metadata,
+      ok: result.ok ?? true,
+      response: result.response,
+      statusCode: result.statusCode,
+      threadId: result.threadId ?? normalized.threadId,
+      warnings: result.warnings ?? []
+    };
+  }
+
+  /**
+   * Sends multiple Discord 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 discord.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('Discord 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 Discord delivery.
+   *
+   * @param notification Shared notification envelope interpreted by the Discord package.
+   * @param options Optional abort signal propagated to rendering and transport work.
+   * @returns A normalized delivery receipt for the resulting Discord message.
+   * @throws {DiscordMessageValidationError} When the notification cannot resolve one target thread or any Discord-visible content.
+   *
+   * @example
+   * ```ts
+   * await discord.sendNotification({
+   *   channel: 'discord',
+   *   payload: { content: 'Deploy finished successfully.' },
+   *   recipients: ['release-thread-id'],
+   * });
+   * ```
+   */
+  async sendNotification(notification, options = {}) {
+    const payload = notification.payload;
+    const rendered = await this.renderNotification(notification);
+    return this.send({
+      allowedMentions: payload.allowedMentions,
+      attachments: payload.attachments ?? [],
+      avatarUrl: payload.avatarUrl,
+      components: payload.components ?? rendered?.components,
+      content: payload.content ?? rendered?.content ?? notification.subject,
+      embeds: payload.embeds ?? rendered?.embeds,
+      flags: payload.flags,
+      metadata: {
+        ...(payload.metadata ?? {}),
+        ...(notification.metadata ?? {}),
+        ...(notification.subject ? {
+          subject: notification.subject
+        } : {}),
+        ...(notification.template ? {
+          template: notification.template
+        } : {})
+      },
+      poll: payload.poll,
+      threadId: this.resolveNotificationThreadId(notification),
+      threadName: payload.threadName,
+      tts: payload.tts,
+      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 {
+      allowedMentions: message.allowedMentions,
+      attachments: message.attachments ?? [],
+      avatarUrl: normalizeOptionalString(message.avatarUrl),
+      components: message.components ?? [],
+      content: normalizeOptionalString(message.content),
+      embeds: message.embeds ?? [],
+      flags: message.flags,
+      metadata: message.metadata,
+      poll: message.poll,
+      threadId: normalizeOptionalString(message.threadId) ?? this.options.defaultThreadId,
+      threadName: normalizeOptionalString(message.threadName),
+      tts: message.tts,
+      username: normalizeOptionalString(message.username)
+    };
+  }
+  resolveNotificationThreadId(notification) {
+    const payloadThreadId = normalizeOptionalString(notification.payload.threadId);
+    if (payloadThreadId) {
+      return payloadThreadId;
+    }
+    const recipients = notification.recipients?.map(entry => entry.trim()).filter(entry => entry.length > 0) ?? [];
+    if (recipients.length > 1) {
+      throw new DiscordMessageValidationError('Discord notifications accept exactly one target thread per dispatch. Use `sendMany(...)` for fan-out delivery.');
+    }
+    return recipients[0] ?? this.options.defaultThreadId;
+  }
+  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 { _DiscordService as DiscordService };

package/dist/status.d.ts

@@ -0,0 +1,27 @@
+import type { PlatformHealthReport, PlatformReadinessReport, PlatformSnapshot } from '@fluojs/runtime';
+/** Resolved Discord lifecycle state used for diagnostics and health checks. */
+export type DiscordLifecycleState = 'created' | 'starting' | 'ready' | 'stopping' | 'stopped' | 'failed';
+/** Input required to describe the package health/readiness contract. */
+export interface DiscordStatusAdapterInput {
+    channelName: string;
+    defaultThreadConfigured: boolean;
+    lifecycleState: DiscordLifecycleState;
+    ownsTransportResources: boolean;
+    transportKind: string;
+    verifiedOnModuleInit: boolean;
+}
+/** Structured snapshot returned by {@link createDiscordPlatformStatusSnapshot}. */
+export interface DiscordPlatformStatusSnapshot {
+    details: Record<string, unknown>;
+    health: PlatformHealthReport;
+    ownership: PlatformSnapshot['ownership'];
+    readiness: PlatformReadinessReport;
+}
+/**
+ * Creates a health/readiness snapshot for the Discord delivery layer.
+ *
+ * @param input Lifecycle and ownership details derived from the active Discord module wiring.
+ * @returns A structured snapshot suitable for status endpoints and operational diagnostics.
+ */
+export declare function createDiscordPlatformStatusSnapshot(input: DiscordStatusAdapterInput): DiscordPlatformStatusSnapshot;
+//# 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,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzG,wEAAwE;AACxE,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,OAAO,CAAC;IACjC,cAAc,EAAE,qBAAqB,CAAC;IACtC,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,6BAA6B;IAC5C,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,mCAAmC,CAAC,KAAK,EAAE,yBAAyB,GAAG,6BAA6B,CAiBnH"}

package/dist/status.js

@@ -0,0 +1,82 @@
+/** Resolved Discord lifecycle state used for diagnostics and health checks. */
+
+/** Input required to describe the package health/readiness contract. */
+
+/** Structured snapshot returned by {@link createDiscordPlatformStatusSnapshot}. */
+
+function createReadiness(input) {
+  if (input.lifecycleState === 'ready') {
+    return {
+      critical: true,
+      status: 'ready'
+    };
+  }
+  if (input.lifecycleState === 'starting') {
+    return {
+      critical: true,
+      reason: 'Discord transport is still starting.',
+      status: 'degraded'
+    };
+  }
+  if (input.lifecycleState === 'stopping' || input.lifecycleState === 'stopped') {
+    return {
+      critical: true,
+      reason: 'Discord transport is shutting down or already stopped.',
+      status: 'not-ready'
+    };
+  }
+  if (input.lifecycleState === 'failed') {
+    return {
+      critical: true,
+      reason: 'Discord transport failed to initialize.',
+      status: 'not-ready'
+    };
+  }
+  return {
+    critical: true,
+    reason: 'Discord transport has not started yet.',
+    status: 'not-ready'
+  };
+}
+function createHealth(input) {
+  if (input.lifecycleState === 'failed' || input.lifecycleState === 'stopped') {
+    return {
+      reason: 'Discord transport is unavailable.',
+      status: 'unhealthy'
+    };
+  }
+  if (input.lifecycleState === 'created' || input.lifecycleState === 'starting' || input.lifecycleState === 'stopping') {
+    return {
+      reason: 'Discord transport is transitioning lifecycle state.',
+      status: 'degraded'
+    };
+  }
+  return {
+    status: 'healthy'
+  };
+}
+
+/**
+ * Creates a health/readiness snapshot for the Discord delivery layer.
+ *
+ * @param input Lifecycle and ownership details derived from the active Discord module wiring.
+ * @returns A structured snapshot suitable for status endpoints and operational diagnostics.
+ */
+export function createDiscordPlatformStatusSnapshot(input) {
+  return {
+    details: {
+      channelName: input.channelName,
+      defaultThreadConfigured: input.defaultThreadConfigured,
+      dependencies: ['notifications.channel', 'discord.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 { Discord, DiscordNotificationDispatchRequest, NormalizedDiscordModuleOptions } from './types.js';
+/** Compatibility token for the facade returned by {@link DiscordModule.forRoot}. */
+export declare const DISCORD: Token<Discord>;
+/** Injection token for the channel implementation consumed by `@fluojs/notifications`. */
+export declare const DISCORD_CHANNEL: Token<NotificationChannel<DiscordNotificationDispatchRequest>>;
+/** Injection token for normalized Discord module options consumed internally by providers. */
+export declare const DISCORD_OPTIONS: Token<NormalizedDiscordModuleOptions>;
+//# 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,OAAO,EAAE,kCAAkC,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE9G,oFAAoF;AACpF,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,OAAO,CAA8B,CAAC;AAClE,0FAA0F;AAC1F,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,mBAAmB,CAAC,kCAAkC,CAAC,CAE1F,CAAC;AACF,8FAA8F;AAC9F,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,8BAA8B,CAAsC,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,6 @@
+/** Compatibility token for the facade returned by {@link DiscordModule.forRoot}. */
+export const DISCORD = Symbol.for('fluo.discord');
+/** Injection token for the channel implementation consumed by `@fluojs/notifications`. */
+export const DISCORD_CHANNEL = Symbol.for('fluo.discord.channel');
+/** Injection token for normalized Discord module options consumed internally by providers. */
+export const DISCORD_OPTIONS = Symbol.for('fluo.discord.options');