@marinoscar/platform-api 0.1.0-next.3 → 0.1.0-next.5

package/dist/host/event-bus/event-bus-adapter.registry.d.ts

@@ -0,0 +1,104 @@
+import type { Logger } from '@nestjs/common';
+import type { ConfigService } from '@nestjs/config';
+import { type Registry } from '../../core/index';
+import type { EventBus } from './event-bus.interface';
+import type { EventBusMetrics } from './event-bus.metrics';
+import type { EventBusSqlPublisher } from './postgres-event-bus';
+/**
+ * The id pattern of an event bus adapter: lower-case, 2 to 32 characters,
+ * starting with a letter (`in-process`, `postgres`, `redis`).
+ *
+ * @stability experimental
+ */
+export declare const EVENT_BUS_ADAPTER_ID_PATTERN: RegExp;
+/**
+ * What an adapter's {@link EventBusAdapterDef.create} receives.
+ *
+ * @stability experimental
+ */
+export interface EventBusAdapterContext {
+    /** The id the adapter was selected by (the registered `id`). */
+    readonly id: string;
+    /** The application's configuration, for the adapter's own settings (a Redis URL, a key prefix). */
+    readonly config: ConfigService;
+    /** A logger named for the bus; use it instead of creating a second one. */
+    readonly logger: Logger;
+    /**
+     * The app's Prisma client (`PLATFORM_PRISMA`) when it is bound; `undefined`
+     * otherwise. Only an adapter that rides on the database needs it.
+     */
+    readonly prisma: EventBusSqlPublisher | undefined;
+    /**
+     * The `app.event_bus.*` counters, already labelled with this adapter's id.
+     * Pass it to the adapter so its publishes and deliveries are counted.
+     */
+    readonly metrics: EventBusMetrics;
+}
+/**
+ * One event bus adapter.
+ *
+ * The bus it returns must honour the rules at the top of `event-bus.interface.ts`
+ * (local delivery on every adapter, JSON round trip, isolated handlers, a
+ * `publish` that never rejects, an oversize payload refused locally) and
+ * `describeEventBusConformance` (`@marinoscar/platform-api/host/testing`)
+ * checks them. If it needs a lifecycle, implement Nest's `OnModuleInit` and
+ * `OnModuleDestroy` on it: they run on the instance `create` returns.
+ *
+ * @stability experimental
+ */
+export interface EventBusAdapterDef {
+    /** The id operators select it by (`EVENT_BUS_ADAPTER=redis`). See {@link EVENT_BUS_ADAPTER_ID_PATTERN}. */
+    readonly id: string;
+    /** A short human label, for logs and the Doctor (`Redis pub/sub`). */
+    readonly label: string;
+    /**
+     * Builds the bus. Called once per process, while the container is created.
+     * May be async; keep it free of long I/O (start a listener from
+     * `onModuleInit`, never block boot).
+     *
+     * @param ctx - see {@link EventBusAdapterContext}.
+     * @returns the bus, or a promise of it.
+     */
+    create(ctx: EventBusAdapterContext): EventBus | Promise<EventBus>;
+}
+/**
+ * Every registered event bus adapter, in registration order (the two built-ins
+ * first). Frozen when the application has bootstrapped.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare const eventBusAdapterRegistry: Registry<EventBusAdapterDef>;
+/**
+ * Registers an event bus adapter. Call it at module load, before the
+ * application is created; a duplicate id throws.
+ *
+ * @param adapter - the adapter.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * // apps/api/src/app-registrations/host.ts
+ * registerEventBusAdapter({
+ *   id: 'redis',
+ *   label: 'Redis pub/sub',
+ *   create: ({ config, logger }) => new RedisEventBus(config.getOrThrow('redis.url'), logger),
+ * });
+ * // then: EVENT_BUS_ADAPTER=redis, or PlatformHostCoreModule.forRoot({ eventBusAdapter: 'redis' })
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerEventBusAdapter(adapter: EventBusAdapterDef): void;
+/**
+ * The boot error for an adapter id nobody registered: names the id and lists
+ * the registered ones.
+ *
+ * @param id - the id that was asked for.
+ * @returns the error.
+ *
+ * @stability experimental
+ */
+export declare function unknownEventBusAdapterError(id: string): Error;
+//# sourceMappingURL=event-bus-adapter.registry.d.ts.map

package/dist/host/event-bus/event-bus-adapter.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-adapter.registry.d.ts","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus-adapter.registry.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAA2B,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,MAAM,CAAC,GAAG,EAAE,sBAAsB,GAAG,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,kBAAkB,CAY/D,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAK7D"}

package/dist/host/event-bus/event-bus-adapter.registry.js

@@ -0,0 +1,90 @@
+"use strict";
+// =============================================================================
+// The event bus adapter registry (PP-14.2, issue #920)
+// =============================================================================
+//
+// Rung 2 of the extension contract. `PlatformHostCoreModule.forRoot()` builds
+// the process's one bus by looking the selected adapter id up here
+// (`EVENT_BUS_ADAPTER`, or the `eventBusAdapter` option). The platform's own two
+// adapters, `in-process` and `postgres`, register through the SAME function an
+// app uses (`./builtin-event-bus-adapters.ts`), so there is no private fast path.
+//
+// An app (or a package it installs) registers an adapter AT IMPORT TIME, before
+// the application bootstraps: the bus is built while the container is being
+// created, and the registry freezes once the application has bootstrapped
+// (`RegistryFreezeService`). Registering from `apps/api/src/app-registrations/`
+// is the convention.
+//
+// Which adapter backs the bus is deployment topology, not a runtime setting, so
+// there is deliberately no settings namespace and no admin form for it.
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventBusAdapterRegistry = exports.EVENT_BUS_ADAPTER_ID_PATTERN = void 0;
+exports.registerEventBusAdapter = registerEventBusAdapter;
+exports.unknownEventBusAdapterError = unknownEventBusAdapterError;
+const index_1 = require("../../core/index");
+/**
+ * The id pattern of an event bus adapter: lower-case, 2 to 32 characters,
+ * starting with a letter (`in-process`, `postgres`, `redis`).
+ *
+ * @stability experimental
+ */
+exports.EVENT_BUS_ADAPTER_ID_PATTERN = /^[a-z][a-z0-9-]{1,31}$/;
+/**
+ * Every registered event bus adapter, in registration order (the two built-ins
+ * first). Frozen when the application has bootstrapped.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+exports.eventBusAdapterRegistry = (0, index_1.defineRegistry)({
+    name: 'host.event-bus-adapters',
+    idOf: (adapter) => adapter.id,
+    idPattern: exports.EVENT_BUS_ADAPTER_ID_PATTERN,
+    validate: (adapter) => {
+        if (typeof adapter.label !== 'string' || adapter.label.trim() === '') {
+            throw new Error(`event bus adapter "${adapter.id}": label must be a non-empty string`);
+        }
+        if (typeof adapter.create !== 'function') {
+            throw new Error(`event bus adapter "${adapter.id}": create must be a function`);
+        }
+    },
+});
+/**
+ * Registers an event bus adapter. Call it at module load, before the
+ * application is created; a duplicate id throws.
+ *
+ * @param adapter - the adapter.
+ * @throws RegistryError `INVALID_ID`, `INVALID_ENTRY`, `DUPLICATE_ID` or `FROZEN`.
+ *
+ * @example
+ * ```ts
+ * // apps/api/src/app-registrations/host.ts
+ * registerEventBusAdapter({
+ *   id: 'redis',
+ *   label: 'Redis pub/sub',
+ *   create: ({ config, logger }) => new RedisEventBus(config.getOrThrow('redis.url'), logger),
+ * });
+ * // then: EVENT_BUS_ADAPTER=redis, or PlatformHostCoreModule.forRoot({ eventBusAdapter: 'redis' })
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+function registerEventBusAdapter(adapter) {
+    exports.eventBusAdapterRegistry.register(adapter);
+}
+/**
+ * The boot error for an adapter id nobody registered: names the id and lists
+ * the registered ones.
+ *
+ * @param id - the id that was asked for.
+ * @returns the error.
+ *
+ * @stability experimental
+ */
+function unknownEventBusAdapterError(id) {
+    return new Error(`Unknown event bus adapter "${id}". Registered adapters: ${exports.eventBusAdapterRegistry.ids().join(', ') || '(none)'}. ` +
+        'Register one with registerEventBusAdapter() at import time, before the application is created.');
+}
+//# sourceMappingURL=event-bus-adapter.registry.js.map

package/dist/host/event-bus/event-bus-adapter.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-adapter.registry.js","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus-adapter.registry.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,uDAAuD;AACvD,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,mEAAmE;AACnE,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,0EAA0E;AAC1E,gFAAgF;AAChF,qBAAqB;AACrB,EAAE;AACF,gFAAgF;AAChF,wEAAwE;AACxE,gFAAgF;;;AAgHhF,0DAEC;AAWD,kEAKC;AA7HD,4CAAiE;AAKjE;;;;;GAKG;AACU,QAAA,4BAA4B,GAAG,wBAAwB,CAAC;AAsDrE;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAiC,IAAA,sBAAc,EAAqB;IACtG,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE;IAC7B,SAAS,EAAE,oCAA4B;IACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;QACpB,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,CAAC,EAAE,qCAAqC,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,CAAC,EAAE,8BAA8B,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;CACF,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,uBAAuB,CAAC,OAA2B;IACjE,+BAAuB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,2BAA2B,CAAC,EAAU;IACpD,OAAO,IAAI,KAAK,CACd,8BAA8B,EAAE,2BAA2B,+BAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI;QACjH,gGAAgG,CACnG,CAAC;AACJ,CAAC"}

package/dist/host/event-bus/event-bus-core.d.ts

@@ -0,0 +1,74 @@
+import type { Logger } from '@nestjs/common';
+import { EventBusHandler, EventBusMeta } from './event-bus.interface';
+/** The wire envelope. `v` lets a later format coexist with this one during a rolling deploy. */
+export interface EventBusEnvelope {
+    v: 1;
+    /** Logical channel. */
+    c: string;
+    /** Publisher origin. */
+    o: string;
+    /** Payload. */
+    p: unknown;
+}
+/** A fresh origin id for one bus instance (one per process in production). */
+export declare function newEventBusOrigin(): string;
+export declare function isValidEventBusChannel(channel: unknown): channel is string;
+/**
+ * Serialises a message into its envelope, or throws.
+ *
+ * @throws EventBusPayloadTooLargeError when the envelope exceeds the limit.
+ * @throws TypeError when the payload cannot be serialised (a cycle, a BigInt).
+ */
+export declare function encodeEventBusEnvelope(channel: string, origin: string, payload: unknown): string;
+/**
+ * Whether `payload` would be rejected as oversize on `channel`.
+ *
+ * For a publisher that has a smaller fallback (a reference instead of the
+ * data) and wants to choose BEFORE publishing rather than lose the message.
+ *
+ * @param channel - the logical channel.
+ * @param payload - the data to publish.
+ * @returns true when it would exceed {@link EVENT_BUS_MAX_PAYLOAD_BYTES}.
+ * @stability experimental
+ */
+export declare function exceedsEventBusPayloadLimit(channel: string, payload: unknown): boolean;
+/**
+ * Parses a received envelope, or returns `null` for anything malformed.
+ *
+ * A malformed message is DROPPED, never thrown: the physical channel is
+ * readable and writable by any session with the application's credentials, so
+ * the receiver cannot assume every NOTIFY on it was sent by this code.
+ */
+export declare function decodeEventBusEnvelope(text: string | undefined): EventBusEnvelope | null;
+declare function describe(error: unknown): string;
+/**
+ * The per-process handler registry, with handler isolation.
+ *
+ * Subscribing and unsubscribing never perform I/O on any adapter: the Postgres
+ * adapter LISTENs once on one physical channel and routes by logical channel
+ * here.
+ */
+export declare class EventBusDispatcher {
+    private readonly logger;
+    private readonly handlers;
+    /** Handler invocations that threw or rejected. Diagnostics and tests. */
+    handlerFailures: number;
+    constructor(logger: Logger);
+    subscribe<T>(channel: string, handler: EventBusHandler<T>): () => void;
+    /** Drops every handler. Used by an adapter's `close()`. */
+    clear(): void;
+    /** Number of handlers on a channel. Diagnostics and tests only. */
+    handlerCount(channel: string): number;
+    /**
+     * Delivers `encoded` (the envelope text) to every handler of its channel,
+     * each with its OWN parsed copy so one handler mutating its payload cannot
+     * change what the next one sees.
+     *
+     * Runs in a microtask, never in the caller's stack. Never throws.
+     */
+    dispatch(channel: string, encoded: string, meta: EventBusMeta): void;
+    private dispatchNow;
+    private reportFailure;
+}
+export { describe as describeEventBusError };
+//# sourceMappingURL=event-bus-core.d.ts.map

package/dist/host/event-bus/event-bus-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-core.d.ts","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAGL,eAAe,EACf,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAa/B,gGAAgG;AAChG,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,CAAC,CAAC;IACL,uBAAuB;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,OAAO,CAAC;CACZ;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,MAAM,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAUhG;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAOtF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAmBxF;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExC;AAED;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAMjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,yEAAyE;IACzE,eAAe,SAAK;gBAES,MAAM,EAAE,MAAM;IAE3C,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IA0BtE,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAIb,mEAAmE;IACnE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;IAIpE,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,aAAa;CAKtB;AAED,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/host/event-bus/event-bus-core.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBusDispatcher = void 0;
+exports.newEventBusOrigin = newEventBusOrigin;
+exports.isValidEventBusChannel = isValidEventBusChannel;
+exports.encodeEventBusEnvelope = encodeEventBusEnvelope;
+exports.exceedsEventBusPayloadLimit = exceedsEventBusPayloadLimit;
+exports.decodeEventBusEnvelope = decodeEventBusEnvelope;
+exports.describeEventBusError = describe;
+const node_crypto_1 = require("node:crypto");
+const event_bus_interface_1 = require("./event-bus.interface");
+/** A fresh origin id for one bus instance (one per process in production). */
+function newEventBusOrigin() {
+    return (0, node_crypto_1.randomUUID)();
+}
+function isValidEventBusChannel(channel) {
+    return typeof channel === 'string' && event_bus_interface_1.EVENT_BUS_CHANNEL_PATTERN.test(channel);
+}
+/**
+ * Serialises a message into its envelope, or throws.
+ *
+ * @throws EventBusPayloadTooLargeError when the envelope exceeds the limit.
+ * @throws TypeError when the payload cannot be serialised (a cycle, a BigInt).
+ */
+function encodeEventBusEnvelope(channel, origin, payload) {
+    const envelope = { v: 1, c: channel, o: origin, p: payload };
+    const text = JSON.stringify(envelope);
+    const bytes = Buffer.byteLength(text, 'utf8');
+    if (bytes > event_bus_interface_1.EVENT_BUS_MAX_PAYLOAD_BYTES) {
+        throw new event_bus_interface_1.EventBusPayloadTooLargeError(channel, bytes);
+    }
+    return text;
+}
+/** A placeholder of the same length as a real origin, for size checks before publishing. */
+const ORIGIN_PLACEHOLDER = '00000000-0000-0000-0000-000000000000';
+/**
+ * Whether `payload` would be rejected as oversize on `channel`.
+ *
+ * For a publisher that has a smaller fallback (a reference instead of the
+ * data) and wants to choose BEFORE publishing rather than lose the message.
+ *
+ * @param channel - the logical channel.
+ * @param payload - the data to publish.
+ * @returns true when it would exceed {@link EVENT_BUS_MAX_PAYLOAD_BYTES}.
+ * @stability experimental
+ */
+function exceedsEventBusPayloadLimit(channel, payload) {
+    try {
+        encodeEventBusEnvelope(channel, ORIGIN_PLACEHOLDER, payload);
+        return false;
+    }
+    catch (error) {
+        return error instanceof event_bus_interface_1.EventBusPayloadTooLargeError;
+    }
+}
+/**
+ * Parses a received envelope, or returns `null` for anything malformed.
+ *
+ * A malformed message is DROPPED, never thrown: the physical channel is
+ * readable and writable by any session with the application's credentials, so
+ * the receiver cannot assume every NOTIFY on it was sent by this code.
+ */
+function decodeEventBusEnvelope(text) {
+    if (typeof text !== 'string' || text === '')
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const candidate = parsed;
+    if (candidate.v !== 1)
+        return null;
+    if (!isValidEventBusChannel(candidate.c))
+        return null;
+    if (typeof candidate.o !== 'string' || candidate.o === '')
+        return null;
+    if (!('p' in candidate))
+        return null;
+    return candidate;
+}
+function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * The per-process handler registry, with handler isolation.
+ *
+ * Subscribing and unsubscribing never perform I/O on any adapter: the Postgres
+ * adapter LISTENs once on one physical channel and routes by logical channel
+ * here.
+ */
+class EventBusDispatcher {
+    logger;
+    handlers = new Map();
+    /** Handler invocations that threw or rejected. Diagnostics and tests. */
+    handlerFailures = 0;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    subscribe(channel, handler) {
+        if (!isValidEventBusChannel(channel)) {
+            throw new Error(`Invalid event bus channel "${String(channel)}": expected a dotted lower-case name such as "notifications.stream".`);
+        }
+        let bucket = this.handlers.get(channel);
+        if (!bucket) {
+            bucket = new Set();
+            this.handlers.set(channel, bucket);
+        }
+        // A wrapper per registration, so the same function subscribed twice is two
+        // registrations and each unsubscribe removes exactly its own.
+        const entry = (payload, meta) => handler(payload, meta);
+        bucket.add(entry);
+        return () => {
+            const current = this.handlers.get(channel);
+            if (!current)
+                return;
+            current.delete(entry);
+            if (current.size === 0)
+                this.handlers.delete(channel);
+        };
+    }
+    /** Drops every handler. Used by an adapter's `close()`. */
+    clear() {
+        this.handlers.clear();
+    }
+    /** Number of handlers on a channel. Diagnostics and tests only. */
+    handlerCount(channel) {
+        return this.handlers.get(channel)?.size ?? 0;
+    }
+    /**
+     * Delivers `encoded` (the envelope text) to every handler of its channel,
+     * each with its OWN parsed copy so one handler mutating its payload cannot
+     * change what the next one sees.
+     *
+     * Runs in a microtask, never in the caller's stack. Never throws.
+     */
+    dispatch(channel, encoded, meta) {
+        queueMicrotask(() => this.dispatchNow(channel, encoded, meta));
+    }
+    dispatchNow(channel, encoded, meta) {
+        const bucket = this.handlers.get(channel);
+        if (!bucket || bucket.size === 0)
+            return;
+        // Snapshot: a handler that unsubscribes (itself or another) mid-dispatch
+        // must not make this loop skip anyone.
+        for (const handler of [...bucket]) {
+            let payload;
+            try {
+                payload = JSON.parse(encoded).p;
+            }
+            catch {
+                return;
+            }
+            try {
+                const result = handler(payload, meta);
+                if (result && typeof result.then === 'function') {
+                    result.then(undefined, (error) => this.reportFailure(channel, error));
+                }
+            }
+            catch (error) {
+                this.reportFailure(channel, error);
+            }
+        }
+    }
+    reportFailure(channel, error) {
+        this.handlerFailures += 1;
+        // The channel, never the payload: payloads carry user content.
+        this.logger.warn(`Event bus handler on "${channel}" failed: ${describe(error)}`);
+    }
+}
+exports.EventBusDispatcher = EventBusDispatcher;
+//# sourceMappingURL=event-bus-core.js.map

package/dist/host/event-bus/event-bus-core.js.map

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

package/dist/host/event-bus/event-bus.config.d.ts

@@ -0,0 +1,46 @@
+import './builtin-event-bus-adapters';
+import type { EventBusAdapterName } from './event-bus.interface';
+/**
+ * The adapter when `EVENT_BUS_ADAPTER` is unset or unrecognised.
+ *
+ * @stability experimental
+ */
+export declare const DEFAULT_EVENT_BUS_ADAPTER: EventBusAdapterName;
+/**
+ * DI token for the parsed selection, read by the bus factory and the Doctor check.
+ *
+ * @stability experimental
+ */
+export declare const EVENT_BUS_SELECTION: unique symbol;
+/**
+ * The selection reported when the app bound a whole bus (`forRoot({ eventBus })`):
+ * no adapter was looked up, so there is nothing to recognise or misconfigure.
+ *
+ * @stability experimental
+ */
+export declare const BOUND_EVENT_BUS_SELECTION: EventBusSelection;
+/**
+ * Which adapter this process runs, and what was configured.
+ *
+ * @stability experimental
+ */
+export interface EventBusSelection {
+    /** The adapter in use. */
+    adapter: EventBusAdapterName;
+    /** False when the configured value was not a registered adapter (and `in-process` was used). */
+    recognised: boolean;
+    /** What was configured, trimmed. Empty when unset. Never secret material. */
+    configured: string;
+}
+/**
+ * The adapter for a configured value. Unset or blank is the default (and is
+ * recognised); anything else must be the id of a REGISTERED adapter
+ * (`eventBusAdapterRegistry`: the built-ins and whatever the app registered),
+ * case-insensitively.
+ *
+ * @param raw - the configured value (`EVENT_BUS_ADAPTER`).
+ * @returns the selection; never throws.
+ * @stability experimental
+ */
+export declare function parseEventBusAdapter(raw: unknown): EventBusSelection;
+//# sourceMappingURL=event-bus.config.d.ts.map

package/dist/host/event-bus/event-bus.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.config.d.ts","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus.config.ts"],"names":[],"mappings":"AAAA,OAAO,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAsBjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAAkC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,MAA+D,CAAC;AAEzG;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,iBAItC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gGAAgG;IAChG,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAYpE"}

package/dist/host/event-bus/event-bus.config.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOUND_EVENT_BUS_SELECTION = exports.EVENT_BUS_SELECTION = exports.DEFAULT_EVENT_BUS_ADAPTER = void 0;
+exports.parseEventBusAdapter = parseEventBusAdapter;
+require("./builtin-event-bus-adapters");
+const event_bus_adapter_registry_1 = require("./event-bus-adapter.registry");
+// =============================================================================
+// `EVENT_BUS_ADAPTER` (PP-1.11, issue #682)
+// =============================================================================
+//
+// DEPLOYMENT TOPOLOGY, NOT A RUNTIME SETTING. Which bus a process uses decides
+// how replicas talk to each other, so it must be known before any of them
+// boots and must agree across all of them; an admin toggle that flipped one
+// replica at a time would split the fleet. Read once, at module init, from
+// `configuration.ts` (`eventBus.adapter`).
+//
+// FAILS SAFE TOWARDS `in-process`, the same direction as `JOBS_WORKER_MODE`: an
+// unregistered value of the ENVIRONMENT VARIABLE logs ONE warning and runs the
+// single-process bus. (The `eventBusAdapter` OPTION of `forRoot` is code, so a
+// wrong id there is a programming error and fails the boot instead: see
+// `selectEventBus`.) Losing
+// cross-replica liveness is a degradation (every consumer has a durable
+// fallback); refusing to boot over a typo would be an outage. The Doctor's
+// `core.event-bus` check keeps the typo visible after the boot log scrolls away.
+// =============================================================================
+/**
+ * The adapter when `EVENT_BUS_ADAPTER` is unset or unrecognised.
+ *
+ * @stability experimental
+ */
+exports.DEFAULT_EVENT_BUS_ADAPTER = 'in-process';
+/**
+ * DI token for the parsed selection, read by the bus factory and the Doctor check.
+ *
+ * @stability experimental
+ */
+exports.EVENT_BUS_SELECTION = Symbol.for('@marinoscar/platform/EVENT_BUS_SELECTION');
+/**
+ * The selection reported when the app bound a whole bus (`forRoot({ eventBus })`):
+ * no adapter was looked up, so there is nothing to recognise or misconfigure.
+ *
+ * @stability experimental
+ */
+exports.BOUND_EVENT_BUS_SELECTION = Object.freeze({
+    adapter: 'bound',
+    recognised: true,
+    configured: 'eventBus binding',
+});
+/**
+ * The adapter for a configured value. Unset or blank is the default (and is
+ * recognised); anything else must be the id of a REGISTERED adapter
+ * (`eventBusAdapterRegistry`: the built-ins and whatever the app registered),
+ * case-insensitively.
+ *
+ * @param raw - the configured value (`EVENT_BUS_ADAPTER`).
+ * @returns the selection; never throws.
+ * @stability experimental
+ */
+function parseEventBusAdapter(raw) {
+    const configured = typeof raw === 'string' ? raw.trim() : '';
+    if (configured === '') {
+        return { adapter: exports.DEFAULT_EVENT_BUS_ADAPTER, recognised: true, configured };
+    }
+    const value = configured.toLowerCase();
+    return event_bus_adapter_registry_1.eventBusAdapterRegistry.has(value)
+        ? { adapter: value, recognised: true, configured }
+        : { adapter: exports.DEFAULT_EVENT_BUS_ADAPTER, recognised: false, configured };
+}
+//# sourceMappingURL=event-bus.config.js.map

package/dist/host/event-bus/event-bus.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.config.js","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus.config.ts"],"names":[],"mappings":";;;AA0EA,oDAYC;AAtFD,wCAAsC;AACtC,6EAAuE;AAGvE,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,2CAA2C;AAC3C,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,wEAAwE;AACxE,4BAA4B;AAC5B,wEAAwE;AACxE,2EAA2E;AAC3E,iFAAiF;AACjF,gFAAgF;AAEhF;;;;GAIG;AACU,QAAA,yBAAyB,GAAwB,YAAY,CAAC;AAE3E;;;;GAIG;AACU,QAAA,mBAAmB,GAAkB,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;AAEzG;;;;;GAKG;AACU,QAAA,yBAAyB,GAAsB,MAAM,CAAC,MAAM,CAAC;IACxE,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,kBAAkB;CAC/B,CAAC,CAAC;AAgBH;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,GAAY;IAC/C,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,iCAAyB,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9E,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAEvC,OAAO,oDAAuB,CAAC,GAAG,CAAC,KAAK,CAAC;QACvC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;QAClD,CAAC,CAAC,EAAE,OAAO,EAAE,iCAAyB,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC5E,CAAC"}

package/dist/host/event-bus/event-bus.factory.d.ts

@@ -0,0 +1,42 @@
+import { ConfigService } from '@nestjs/config';
+import { AppMetricsService } from '../metrics/app-metrics.service';
+import './builtin-event-bus-adapters';
+import { type EventBusSelection } from './event-bus.config';
+import type { EventBus } from './event-bus.interface';
+import type { EventBusSqlPublisher } from './postgres-event-bus';
+/**
+ * What {@link selectEventBus} may be told.
+ *
+ * @stability experimental
+ */
+export interface SelectEventBusOptions {
+    /**
+     * Throw for an unregistered id instead of falling back to `in-process`.
+     * `PlatformHostCoreModule` sets it for the `eventBusAdapter` option (code, so
+     * a wrong id is a programming error) and leaves it off for the
+     * `EVENT_BUS_ADAPTER` environment variable (a typo there must not take the
+     * API down).
+     */
+    strict?: boolean;
+}
+/**
+ * Parses the configured adapter and warns once about an unregistered value.
+ *
+ * @param raw - the configured value (`EVENT_BUS_ADAPTER`, or the `eventBusAdapter` option).
+ * @param options - see {@link SelectEventBusOptions}.
+ * @returns the selection.
+ * @throws Error naming the id and the registered ids, when `strict` and the id is not registered.
+ */
+export declare function selectEventBus(raw: string | undefined, options?: SelectEventBusOptions): EventBusSelection;
+/**
+ * Builds the bus for a selection by calling its registered adapter.
+ *
+ * @param selection - which adapter.
+ * @param sql - the app's Prisma client (`PLATFORM_PRISMA`); required by `postgres`.
+ * @param appMetrics - where the `app.event_bus.*` counters go.
+ * @param config - the application's configuration, handed to the adapter.
+ * @returns the bus (a promise of it when the adapter is async).
+ * @throws Error naming the id and listing the registered ones when no adapter has that id; or whatever the adapter throws (`postgres` without a client).
+ */
+export declare function createEventBus(selection: EventBusSelection, sql: EventBusSqlPublisher | undefined, appMetrics?: AppMetricsService, config?: ConfigService): EventBus | Promise<EventBus>;
+//# sourceMappingURL=event-bus.factory.d.ts.map

package/dist/host/event-bus/event-bus.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.factory.d.ts","sourceRoot":"","sources":["../../../src/host/event-bus/event-bus.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAsB,MAAM,gCAAgC,CAAC;AACvF,OAAO,8BAA8B,CAAC;AAEtC,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA0BjE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,qBAA0B,GAAG,iBAAiB,CAU9G;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,oBAAoB,GAAG,SAAS,EACrC,UAAU,GAAE,iBAAwC,EACpD,MAAM,GAAE,aAAmC,GAC1C,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS9B"}