@pattern-stack/codegen 0.15.0 → 0.15.2

package/dist/runtime/subsystems/events/event-bus.memory-backend.js

@@ -1,238 +1,10 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
-  return result;
-};
-var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
-
-// runtime/subsystems/events/event-bus.memory-backend.ts
-import { Inject, Injectable, Logger, Optional } from "@nestjs/common";
-
-// runtime/subsystems/events/event-keyset-cursor.ts
-var DEFAULT_EVENT_LIST_LIMIT = 50;
-var MAX_EVENT_LIST_LIMIT = 200;
-function clampEventLimit(limit) {
-  if (typeof limit !== "number" || !Number.isFinite(limit)) {
-    return DEFAULT_EVENT_LIST_LIMIT;
-  }
-  const floored = Math.floor(limit);
-  if (floored < 1) return 1;
-  if (floored > MAX_EVENT_LIST_LIMIT) return MAX_EVENT_LIST_LIMIT;
-  return floored;
-}
-function encodeEventCursor(keyset) {
-  const tuple = [keyset.occurredAt.toISOString(), keyset.id];
-  return Buffer.from(JSON.stringify(tuple), "utf8").toString("base64url");
-}
-function decodeEventCursor(cursor) {
-  try {
-    const json = Buffer.from(cursor, "base64url").toString("utf8");
-    const parsed = JSON.parse(json);
-    if (!Array.isArray(parsed) || parsed.length !== 2) return null;
-    const [iso, id] = parsed;
-    if (typeof iso !== "string" || typeof id !== "string") return null;
-    const occurredAt = new Date(iso);
-    if (Number.isNaN(occurredAt.getTime())) return null;
-    return { occurredAt, id };
-  } catch {
-    return null;
-  }
-}
-
-// runtime/subsystems/token-key.ts
-var PKG = "@pattern-stack/codegen";
-var tokenKey = (area, name) => `${PKG}.${area}.${name}`;
-
-// runtime/subsystems/events/events.tokens.ts
-var REDIS_URL = Symbol.for(tokenKey("events", "redis-url"));
-var EVENTS_MODULE_OPTIONS = "EVENTS_MODULE_OPTIONS";
-
-// runtime/subsystems/events/event-bus.memory-backend.ts
-function toEventSummary(event) {
-  const metadata = event.metadata;
-  const str = (key) => {
-    const v = metadata?.[key];
-    return typeof v === "string" ? v : null;
-  };
-  return {
-    id: event.id,
-    type: event.type,
-    aggregateId: event.aggregateId,
-    aggregateType: event.aggregateType,
-    status: "processed",
-    pool: str("pool"),
-    direction: str("direction"),
-    tier: str("tier") ?? "domain",
-    rootRunId: str("rootRunId"),
-    tenantId: str("tenantId"),
-    occurredAt: event.occurredAt,
-    processedAt: event.occurredAt
-  };
-}
-var MemoryEventBus = class {
-  logger = new Logger(MemoryEventBus.name);
-  /** All events published since construction (or last clear). */
-  publishedEvents = [];
-  handlers = /* @__PURE__ */ new Map();
-  opts;
-  constructor(opts) {
-    this.opts = opts ?? { backend: "memory" };
-  }
-  async publish(event) {
-    this.assertTierRouting(event);
-    this.publishedEvents.push(event);
-    if (this.shouldDispatch(event)) {
-      await this.dispatch(event);
-    }
-  }
-  async publishMany(events) {
-    for (const event of events) {
-      await this.publish(event);
-    }
-  }
-  async findById(eventId) {
-    return this.publishedEvents.find((e) => e.id === eventId) ?? null;
-  }
-  subscribe(eventType, handler) {
-    if (!this.handlers.has(eventType)) {
-      this.handlers.set(eventType, /* @__PURE__ */ new Set());
-    }
-    const set = this.handlers.get(eventType);
-    const h = handler;
-    set.add(h);
-    return () => {
-      set.delete(h);
-    };
-  }
-  // ============================================================================
-  // IEventReadPort (OBS-LIST-1)
-  // ============================================================================
-  async listEvents(query = {}) {
-    const limit = clampEventLimit(query.limit);
-    const keyset = query.cursor ? decodeEventCursor(query.cursor) : null;
-    const str = (e, key) => {
-      const v = e.metadata?.[key];
-      return typeof v === "string" ? v : null;
-    };
-    const matched = this.publishedEvents.filter((e) => {
-      if (query.poolId && str(e, "pool") !== query.poolId) return false;
-      if (query.direction && str(e, "direction") !== query.direction)
-        return false;
-      if (query.rootRunId && str(e, "rootRunId") !== query.rootRunId)
-        return false;
-      if (query.since && e.occurredAt.getTime() < query.since.getTime())
-        return false;
-      if (query.tenantId !== void 0) {
-        const t = str(e, "tenantId");
-        if (query.tenantId === null) {
-          if (t !== null) return false;
-        } else if (t !== query.tenantId) {
-          return false;
-        }
-      }
-      return true;
-    });
-    matched.sort((a, b) => {
-      const dt = b.occurredAt.getTime() - a.occurredAt.getTime();
-      if (dt !== 0) return dt;
-      return a.id < b.id ? 1 : a.id > b.id ? -1 : 0;
-    });
-    const seeked = keyset ? matched.filter((e) => {
-      const ct = e.occurredAt.getTime();
-      const kt = keyset.occurredAt.getTime();
-      if (ct < kt) return true;
-      if (ct > kt) return false;
-      return e.id < keyset.id;
-    }) : matched;
-    const hasMore = seeked.length > limit;
-    const page = hasMore ? seeked.slice(0, limit) : seeked;
-    const items = page.map(toEventSummary);
-    const last = page[page.length - 1];
-    const nextCursor = hasMore && last ? encodeEventCursor({ occurredAt: last.occurredAt, id: last.id }) : null;
-    return { items, nextCursor };
-  }
-  /** Remove all published events and subscriptions. Useful in beforeEach. */
-  clear() {
-    this.publishedEvents.length = 0;
-    this.handlers.clear();
-  }
-  /** Filter published events by `metadata.pool`. */
-  publishedEventsForPool(pool) {
-    return this.publishedEvents.filter((e) => e.metadata?.["pool"] === pool);
-  }
-  /** Filter published events by `metadata.direction`. */
-  publishedEventsForDirection(direction) {
-    return this.publishedEvents.filter((e) => e.metadata?.["direction"] === direction);
-  }
-  /**
-   * Decide whether `event` should be dispatched to handlers given the
-   * current pool filter.
-   *
-   * Semantics (mirroring `DrizzleEventBus.processBatch`):
-   * - `opts.pools` undefined  → dispatch everything (no filter).
-   * - `opts.pools` empty array → treated as "no filter" to match the
-   *   Drizzle backend, where `pools && pools.length > 0` is the gate on
-   *   the `inArray` WHERE clause. Empty arrays dispatch everything.
-   * - `opts.pools` non-empty  → dispatch only when `event.metadata.pool`
-   *   is in the list. Events without `metadata.pool` do NOT match — they
-   *   are out of all configured pools by definition.
-   */
-  shouldDispatch(event) {
-    const pools = this.opts.pools;
-    if (!pools || pools.length === 0) return true;
-    const eventPool = event.metadata?.["pool"];
-    return typeof eventPool === "string" && pools.includes(eventPool);
-  }
-  /**
-   * Mirror the `domain_events_tier_routing_check` DB CHECK at the memory
-   * backend (AUDIT-1). Audit-tier events MUST have null/undefined
-   * `pool` and `direction` in metadata; the bridge dispatcher relies on
-   * this invariant.
-   */
-  assertTierRouting(event) {
-    const tier = event.metadata?.["tier"];
-    if (tier !== "audit") return;
-    const pool = event.metadata?.["pool"];
-    const direction = event.metadata?.["direction"];
-    const poolIsNull = pool === null || pool === void 0;
-    const directionIsNull = direction === null || direction === void 0;
-    if (!poolIsNull || !directionIsNull) {
-      throw new Error(
-        `MemoryEventBus: tier='audit' events must have null pool and direction (got pool=${String(pool)}, direction=${String(direction)}). This mirrors the domain_events CHECK constraint.`
-      );
-    }
-  }
-  async dispatch(event) {
-    const set = this.handlers.get(event.type);
-    if (!set) return;
-    let firstError;
-    for (const handler of set) {
-      try {
-        await handler(event);
-      } catch (err) {
-        this.logger.error(
-          `Handler error for event type "${event.type}" (id: ${event.id}): ${err}`
-        );
-        if (firstError === void 0) {
-          firstError = err;
-        }
-      }
-    }
-    if (firstError !== void 0) {
-      throw firstError;
-    }
-  }
-};
-MemoryEventBus = __decorateClass([
-  Injectable(),
-  __decorateParam(0, Optional()),
-  __decorateParam(0, Inject(EVENTS_MODULE_OPTIONS))
-], MemoryEventBus);
+import {
+  MemoryEventBus
+} from "../../../chunk-Z7PQCAVK.js";
+import "../../../chunk-UQ5EHOH2.js";
+import "../../../chunk-H5NH7KPE.js";
+import "../../../chunk-GYGNEQSC.js";
+import "../../../chunk-2E224ZSN.js";
 export {
   MemoryEventBus
 };

package/dist/runtime/subsystems/events/event-bus.memory-backend.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../runtime/subsystems/events/event-bus.memory-backend.ts","../../../../runtime/subsystems/events/event-keyset-cursor.ts","../../../../runtime/subsystems/token-key.ts","../../../../runtime/subsystems/events/events.tokens.ts"],"sourcesContent":["/**\n * MemoryEventBus — in-memory backend for the event bus.\n *\n * Dispatches events synchronously to registered subscribers. The `tx`\n * parameter is ignored — all events are dispatched immediately.\n *\n * Use this backend in tests to assert event publication without a database.\n * Swap via EventsModule.forRoot({ backend: 'memory' }).\n *\n * Pool awareness (EVT-5):\n * - Mirrors the `DrizzleEventBus` per-process restriction (EVT-4). When\n *   `opts.pools` is set, `publish`/`publishMany` still push the event into\n *   `publishedEvents` (so test code can assert the full set of emitted\n *   events regardless of pool filter), but handlers are NOT invoked for\n *   events whose `metadata.pool` is outside the configured pools.\n * - `publishedEventsForPool(pool)` and `publishedEventsForDirection(dir)`\n *   helpers are provided for targeted assertions.\n * - Shares the `EventsModuleOptions` shape (same token as Drizzle) rather\n *   than introducing a memory-only options type — the surface is the same\n *   and keeping them unified avoids drift between backends.\n */\nimport { Inject, Injectable, Logger, Optional } from '@nestjs/common';\nimport type { DomainEvent, IEventBus } from './event-bus.protocol';\nimport type {\n  EventPage,\n  EventSummary,\n  IEventReadPort,\n  ListEventsQuery,\n} from './event-read.protocol';\nimport {\n  clampEventLimit,\n  decodeEventCursor,\n  encodeEventCursor,\n} from './event-keyset-cursor';\nimport { EVENTS_MODULE_OPTIONS } from './events.tokens';\nimport type { EventsModuleOptions } from './events.module';\n\n/**\n * Project an in-memory `DomainEvent` into the narrow `EventSummary` shape.\n * The memory backend has no first-class columns, so `pool` / `direction` /\n * `tier` / `tenantId` / `rootRunId` are read from `metadata` (mirroring how\n * the Drizzle backend stamps them onto columns at publish time). `status`\n * is reported as `'processed'` — the memory bus dispatches synchronously,\n * so once an event is in `publishedEvents` it has been handled.\n */\nfunction toEventSummary(event: DomainEvent): EventSummary {\n  const metadata = event.metadata;\n  const str = (key: string): string | null => {\n    const v = metadata?.[key];\n    return typeof v === 'string' ? v : null;\n  };\n  return {\n    id: event.id,\n    type: event.type,\n    aggregateId: event.aggregateId,\n    aggregateType: event.aggregateType,\n    status: 'processed',\n    pool: str('pool'),\n    direction: str('direction'),\n    tier: str('tier') ?? 'domain',\n    rootRunId: str('rootRunId'),\n    tenantId: str('tenantId'),\n    occurredAt: event.occurredAt,\n    processedAt: event.occurredAt,\n  };\n}\n\n@Injectable()\nexport class MemoryEventBus implements IEventBus, IEventReadPort {\n  private readonly logger = new Logger(MemoryEventBus.name);\n\n  /** All events published since construction (or last clear). */\n  readonly publishedEvents: DomainEvent[] = [];\n\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n  private readonly opts: EventsModuleOptions;\n\n  constructor(\n    @Optional() @Inject(EVENTS_MODULE_OPTIONS) opts?: EventsModuleOptions,\n  ) {\n    // Default so direct construction (e.g. `new MemoryEventBus()` from a\n    // unit test outside NestJS DI) keeps working without an explicit\n    // options object.\n    this.opts = opts ?? { backend: 'memory' };\n  }\n\n  async publish(event: DomainEvent): Promise<void> {\n    // Mirror the `domain_events_tier_routing_check` DB constraint at the\n    // memory backend boundary so misuse fails the same way regardless of\n    // backend (AUDIT-1).\n    this.assertTierRouting(event);\n\n    // Always record the event — even if this process is configured with a\n    // pool filter that excludes it. Test code relies on `publishedEvents`\n    // being a complete log of what was published, not a filtered view.\n    this.publishedEvents.push(event);\n\n    if (this.shouldDispatch(event)) {\n      await this.dispatch(event);\n    }\n  }\n\n  async publishMany(events: DomainEvent[]): Promise<void> {\n    for (const event of events) {\n      await this.publish(event);\n    }\n  }\n\n  async findById(eventId: string): Promise<DomainEvent | null> {\n    return this.publishedEvents.find((e) => e.id === eventId) ?? null;\n  }\n\n  subscribe<T extends DomainEvent = DomainEvent>(\n    eventType: string,\n    handler: (event: T) => Promise<void>,\n  ): () => void {\n    if (!this.handlers.has(eventType)) {\n      this.handlers.set(eventType, new Set());\n    }\n    // Cast is safe — callers pass a typed handler; we store as the base type\n    const set = this.handlers.get(eventType)!;\n    const h = handler as (event: DomainEvent) => Promise<void>;\n    set.add(h);\n\n    return () => {\n      set.delete(h);\n    };\n  }\n\n  // ============================================================================\n  // IEventReadPort (OBS-LIST-1)\n  // ============================================================================\n\n  async listEvents(query: ListEventsQuery = {}): Promise<EventPage> {\n    const limit = clampEventLimit(query.limit);\n    const keyset = query.cursor ? decodeEventCursor(query.cursor) : null;\n\n    const str = (e: DomainEvent, key: string): string | null => {\n      const v = e.metadata?.[key];\n      return typeof v === 'string' ? v : null;\n    };\n\n    const matched = this.publishedEvents.filter((e) => {\n      if (query.poolId && str(e, 'pool') !== query.poolId) return false;\n      if (query.direction && str(e, 'direction') !== query.direction)\n        return false;\n      if (query.rootRunId && str(e, 'rootRunId') !== query.rootRunId)\n        return false;\n      if (query.since && e.occurredAt.getTime() < query.since.getTime())\n        return false;\n      if (query.tenantId !== undefined) {\n        const t = str(e, 'tenantId');\n        if (query.tenantId === null) {\n          if (t !== null) return false;\n        } else if (t !== query.tenantId) {\n          return false;\n        }\n      }\n      return true;\n    });\n\n    // Order occurred_at DESC, id DESC to match the Drizzle backend keyset.\n    matched.sort((a, b) => {\n      const dt = b.occurredAt.getTime() - a.occurredAt.getTime();\n      if (dt !== 0) return dt;\n      return a.id < b.id ? 1 : a.id > b.id ? -1 : 0;\n    });\n\n    const seeked = keyset\n      ? matched.filter((e) => {\n          const ct = e.occurredAt.getTime();\n          const kt = keyset.occurredAt.getTime();\n          if (ct < kt) return true;\n          if (ct > kt) return false;\n          return e.id < keyset.id;\n        })\n      : matched;\n\n    const hasMore = seeked.length > limit;\n    const page = hasMore ? seeked.slice(0, limit) : seeked;\n    const items = page.map(toEventSummary);\n    const last = page[page.length - 1];\n    const nextCursor =\n      hasMore && last\n        ? encodeEventCursor({ occurredAt: last.occurredAt, id: last.id })\n        : null;\n\n    return { items, nextCursor };\n  }\n\n  /** Remove all published events and subscriptions. Useful in beforeEach. */\n  clear(): void {\n    this.publishedEvents.length = 0;\n    this.handlers.clear();\n  }\n\n  /** Filter published events by `metadata.pool`. */\n  publishedEventsForPool(pool: string): DomainEvent[] {\n    return this.publishedEvents.filter((e) => e.metadata?.['pool'] === pool);\n  }\n\n  /** Filter published events by `metadata.direction`. */\n  publishedEventsForDirection(direction: string): DomainEvent[] {\n    return this.publishedEvents.filter((e) => e.metadata?.['direction'] === direction);\n  }\n\n  /**\n   * Decide whether `event` should be dispatched to handlers given the\n   * current pool filter.\n   *\n   * Semantics (mirroring `DrizzleEventBus.processBatch`):\n   * - `opts.pools` undefined  → dispatch everything (no filter).\n   * - `opts.pools` empty array → treated as \"no filter\" to match the\n   *   Drizzle backend, where `pools && pools.length > 0` is the gate on\n   *   the `inArray` WHERE clause. Empty arrays dispatch everything.\n   * - `opts.pools` non-empty  → dispatch only when `event.metadata.pool`\n   *   is in the list. Events without `metadata.pool` do NOT match — they\n   *   are out of all configured pools by definition.\n   */\n  private shouldDispatch(event: DomainEvent): boolean {\n    const pools = this.opts.pools;\n    if (!pools || pools.length === 0) return true;\n    const eventPool = event.metadata?.['pool'];\n    return typeof eventPool === 'string' && pools.includes(eventPool);\n  }\n\n  /**\n   * Mirror the `domain_events_tier_routing_check` DB CHECK at the memory\n   * backend (AUDIT-1). Audit-tier events MUST have null/undefined\n   * `pool` and `direction` in metadata; the bridge dispatcher relies on\n   * this invariant.\n   */\n  private assertTierRouting(event: DomainEvent): void {\n    const tier = event.metadata?.['tier'];\n    if (tier !== 'audit') return;\n    const pool = event.metadata?.['pool'];\n    const direction = event.metadata?.['direction'];\n    const poolIsNull = pool === null || pool === undefined;\n    const directionIsNull = direction === null || direction === undefined;\n    if (!poolIsNull || !directionIsNull) {\n      throw new Error(\n        `MemoryEventBus: tier='audit' events must have null pool and direction ` +\n          `(got pool=${String(pool)}, direction=${String(direction)}). ` +\n          `This mirrors the domain_events CHECK constraint.`,\n      );\n    }\n  }\n\n  private async dispatch(event: DomainEvent): Promise<void> {\n    const set = this.handlers.get(event.type);\n    if (!set) return;\n\n    let firstError: unknown;\n    for (const handler of set) {\n      try {\n        await handler(event);\n      } catch (err) {\n        this.logger.error(\n          `Handler error for event type \"${event.type}\" (id: ${event.id}): ${err}`,\n        );\n        if (firstError === undefined) {\n          firstError = err;\n        }\n      }\n    }\n\n    if (firstError !== undefined) {\n      throw firstError;\n    }\n  }\n}\n","/**\n * Keyset (seek) cursor codec for `IEventReadPort.listEvents` (OBS-LIST-1).\n *\n * The list is ordered `occurred_at DESC, id DESC`. The cursor encodes the\n * `(occurredAt, id)` of the last row on the previous page so the next page\n * seeks with `WHERE (occurred_at, id) < (cursorOccurredAt, cursorId)`.\n *\n * The cursor is opaque to consumers: a base64url-encoded JSON tuple. Shape\n * is an implementation detail — never parse it outside this module.\n *\n * Mirrors the jobs keyset codec; kept separate because the events subsystem\n * must not depend on `runtime/subsystems/jobs/`.\n */\n\nexport interface EventKeyset {\n  occurredAt: Date;\n  id: string;\n}\n\n/** Default page size when `limit` is omitted. */\nexport const DEFAULT_EVENT_LIST_LIMIT = 50;\n/** Hard upper bound on page size. */\nexport const MAX_EVENT_LIST_LIMIT = 200;\n\n/** Clamp a caller-supplied `limit` into `[1, MAX_EVENT_LIST_LIMIT]`. */\nexport function clampEventLimit(limit: number | undefined): number {\n  if (typeof limit !== 'number' || !Number.isFinite(limit)) {\n    return DEFAULT_EVENT_LIST_LIMIT;\n  }\n  const floored = Math.floor(limit);\n  if (floored < 1) return 1;\n  if (floored > MAX_EVENT_LIST_LIMIT) return MAX_EVENT_LIST_LIMIT;\n  return floored;\n}\n\nexport function encodeEventCursor(keyset: EventKeyset): string {\n  const tuple = [keyset.occurredAt.toISOString(), keyset.id];\n  return Buffer.from(JSON.stringify(tuple), 'utf8').toString('base64url');\n}\n\n/**\n * Decode an opaque cursor back into its `(occurredAt, id)` keyset. Returns\n * `null` for malformed input so user-supplied garbage is treated as \"start\n * from the beginning\" rather than throwing.\n */\nexport function decodeEventCursor(cursor: string): EventKeyset | null {\n  try {\n    const json = Buffer.from(cursor, 'base64url').toString('utf8');\n    const parsed = JSON.parse(json) as unknown;\n    if (!Array.isArray(parsed) || parsed.length !== 2) return null;\n    const [iso, id] = parsed;\n    if (typeof iso !== 'string' || typeof id !== 'string') return null;\n    const occurredAt = new Date(iso);\n    if (Number.isNaN(occurredAt.getTime())) return null;\n    return { occurredAt, id };\n  } catch {\n    return null;\n  }\n}\n","/** Canonical package namespace for cross-boundary DI token keys. MUST be a hardcoded\n *  constant (NOT derived from package.json) so a vendored copy — which lives inside the\n *  CONSUMER's package — produces the identical key and the two copies share the symbol. */\nexport const PKG = '@pattern-stack/codegen';\n// TODO(token-version): if/when a runtime contract version is adopted, inject it HERE only\n//   (e.g. `${PKG}#${ABI}.${area}.${name}`) — this helper is the single chokepoint.\nexport const tokenKey = (area: string, name: string): string => `${PKG}.${area}.${name}`;\n","/**\n * Injection token for the event bus.\n *\n * String constant (not Symbol) so it matches by value across import boundaries.\n * Matches the token in runtime/constants/tokens.ts — both are 'EVENT_BUS'.\n *\n * Usage in use cases:\n * ```typescript\n * constructor(@Inject(EVENT_BUS) private readonly eventBus: IEventBus) {}\n * ```\n */\nimport { tokenKey } from '../token-key';\n\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n\n/**\n * Injection token for the read-side `IEventReadPort` over `domain_events`\n * (OBS-LIST-1).\n *\n * Bound by `EventsModule.forRoot` to the same backend instance as\n * `EVENT_BUS` for the `drizzle` and `memory` backends (both implement\n * `IEventReadPort`). The `redis` backend retains no history and therefore\n * does NOT provide this token — consumers composing it (e.g. the\n * observability combiner) inject it `@Optional()` and degrade to empty\n * results.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n */\nexport const EVENT_READ_PORT = 'EVENT_READ_PORT' as const;\n\n/**\n * Injection token for the generated `TypedEventBus` facade.\n *\n * `TypedEventBus` lives in `runtime/subsystems/events/generated/bus.ts` and\n * wraps `IEventBus` with project-specific `AppDomainEvent`-typed `publish<T>()`\n * and `subscribe<T>()`. Use cases inject this token in preference to\n * `EVENT_BUS` when they want compile-time type safety on event shapes.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n *\n * Provider registration lands in EVT-6 (EventsModule wiring); the token is\n * declared here so generated code can import it without depending on the\n * still-being-formalised module.\n */\nexport const TYPED_EVENT_BUS = 'TYPED_EVENT_BUS' as const;\n\n/**\n * Injection token for the resolved multi-tenancy flag.\n *\n * Provided by `EventsModule.forRoot(...)` as `options.multiTenant ?? false`.\n * Consumed by `TypedEventBus` to enforce the tenantId-is-required rule at\n * publish time.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as the other events tokens. (The jobs\n * subsystem uses Symbols for the analogous token; events chose strings\n * from the start and we keep the file internally consistent.)\n */\nexport const EVENTS_MULTI_TENANT = 'EVENTS_MULTI_TENANT' as const;\n\n/**\n * Injection token for the Redis connection URL used by RedisEventBus.\n * Provided automatically by EventsModule.forRoot({ backend: 'redis' }).\n *\n * ADR-037: namespaced `Symbol.for(...)` (via `tokenKey()`) so it matches by value\n * across runtime copies (the sibling string tokens above are already value-stable).\n * Note the jobs subsystem defines its own `REDIS_URL`-equivalent; this is the\n * events one.\n */\nexport const REDIS_URL = Symbol.for(tokenKey('events', 'redis-url'));\n\n/**\n * Injection token for the resolved `EventsModuleOptions` object.\n *\n * Provided automatically by `EventsModule.forRoot(...)` /\n * `EventsModule.forRootAsync(...)`. Backends that need to observe module\n * configuration (e.g. `DrizzleEventBus` reading `opts.pools` for\n * pool-filtered drain) inject via this token.\n *\n * String-valued (not `Symbol`) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n */\nexport const EVENTS_MODULE_OPTIONS = 'EVENTS_MODULE_OPTIONS' as const;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/subsystems/events/event-bus.redis-backend.js

@@ -1,26 +1,14 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
-  return result;
-};
-var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+import {
+  REDIS_URL
+} from "../../../chunk-H5NH7KPE.js";
+import "../../../chunk-GYGNEQSC.js";
+import {
+  __decorateClass,
+  __decorateParam
+} from "../../../chunk-2E224ZSN.js";
 
 // runtime/subsystems/events/event-bus.redis-backend.ts
 import { Injectable, Inject, Logger } from "@nestjs/common";
-
-// runtime/subsystems/token-key.ts
-var PKG = "@pattern-stack/codegen";
-var tokenKey = (area, name) => `${PKG}.${area}.${name}`;
-
-// runtime/subsystems/events/events.tokens.ts
-var REDIS_URL = Symbol.for(tokenKey("events", "redis-url"));
-
-// runtime/subsystems/events/event-bus.redis-backend.ts
 var CHANNEL_PREFIX = "events:";
 async function createRedisClient(url) {
   let Redis;

package/dist/runtime/subsystems/events/event-bus.redis-backend.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../runtime/subsystems/events/event-bus.redis-backend.ts","../../../../runtime/subsystems/token-key.ts","../../../../runtime/subsystems/events/events.tokens.ts"],"sourcesContent":["/**\n * RedisEventBus — Redis Pub/Sub backend for the event bus.\n *\n * Publishes events to Redis channels and dispatches incoming messages to\n * registered in-process subscribers. Events are serialized as JSON strings.\n *\n * Channel naming:\n *   - Per-type channel:  events:{event.type}   (e.g. events:contact_created)\n *   - Catch-all channel: events:*\n *\n * Transactional semantics:\n *   The `tx` parameter (Drizzle transaction) is accepted to satisfy the\n *   IEventBus interface but has no effect — Redis Pub/Sub is not transactional.\n *   Events published with a `tx` argument are dispatched immediately without\n *   waiting for the surrounding transaction to commit. If you need\n *   at-least-once delivery tied to a database transaction, use DrizzleEventBus.\n *\n * Connection model:\n *   ioredis requires a dedicated connection for subscribers (a client in\n *   subscribe mode cannot issue regular commands). This backend creates two\n *   clients: one for publishing (`publisher`) and one for subscribing\n *   (`subscriber`). Both are connected on module init and disconnected on\n *   module destroy.\n *\n * Usage:\n *   EventsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })\n *\n * Requires `ioredis` — install it separately if you use this backend:\n *   npm install ioredis   /   bun add ioredis\n */\nimport { Injectable, OnModuleInit, OnModuleDestroy, Inject, Logger } from '@nestjs/common';\nimport type { DomainEvent, DrizzleTransaction, IEventBus } from './event-bus.protocol';\nimport { REDIS_URL } from './events.tokens';\n\n/** Redis channel prefix for all domain events. */\nconst CHANNEL_PREFIX = 'events:';\n/** Catch-all channel that receives every published event. */\nconst WILDCARD_CHANNEL = 'events:*';\n\n// ioredis is an optional peer dependency; import lazily so consumers who do\n// not use this backend do not need it on their classpath.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RedisClient = any;\n\nasync function createRedisClient(url: string): Promise<RedisClient> {\n  let Redis: { new (url: string): RedisClient };\n  try {\n    const mod = await import('ioredis');\n    Redis = mod.default ?? mod;\n  } catch {\n    throw new Error(\n      'RedisEventBus requires the \"ioredis\" package. Install it with: npm install ioredis',\n    );\n  }\n  return new Redis(url);\n}\n\n@Injectable()\nexport class RedisEventBus implements IEventBus, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisEventBus.name);\n\n  private publisher: RedisClient | null = null;\n  private subscriber: RedisClient | null = null;\n  private connected = false;\n\n  /**\n   * In-process subscriber registry. Handlers registered here are called when\n   * a message arrives on the subscriber client — keeping fan-out within the\n   * same process without an extra round-trip through Redis.\n   */\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n\n  /**\n   * Track which event types have active Redis subscriptions.\n   * Used to avoid subscribing multiple times to the same type channel.\n   */\n  private readonly subscribedTypes = new Set<string>();\n\n  constructor(@Inject(REDIS_URL) private readonly redisUrl: string) {}\n\n  // ============================================================================\n  // Lifecycle\n  // ============================================================================\n\n  async onModuleInit(): Promise<void> {\n    this.publisher = await createRedisClient(this.redisUrl);\n    this.subscriber = await createRedisClient(this.redisUrl);\n\n    // Surface connection errors without crashing the process.\n    this.publisher.on('error', (err: Error) =>\n      this.logger.error(`Redis publisher error: ${err.message}`, err.stack),\n    );\n    this.subscriber.on('error', (err: Error) =>\n      this.logger.error(`Redis subscriber error: ${err.message}`, err.stack),\n    );\n\n    // Set up message listener for per-type subscriptions.\n    // Subscriptions are created lazily when the first handler is registered for a type.\n    this.subscriber.on('message', (channel: string, message: string) => {\n      void this.handleMessage(channel, message);\n    });\n\n    this.connected = true;\n    this.logger.log(`RedisEventBus connected to ${this.redisUrl}`);\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.connected = false;\n\n    if (this.subscriber) {\n      // Unsubscribe from all channels and disconnect the subscriber.\n      // unsubscribe() with no args unsubscribes from all channels.\n      await this.subscriber.unsubscribe();\n      this.subscriber.disconnect();\n      this.subscriber = null;\n    }\n\n    if (this.publisher) {\n      this.publisher.disconnect();\n      this.publisher = null;\n    }\n\n    this.subscribedTypes.clear();\n    this.logger.log('RedisEventBus disconnected');\n  }\n\n  // ============================================================================\n  // IEventBus\n  // ============================================================================\n\n  /**\n   * Publish a single event.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    this.assertConnected();\n\n    const payload = this.serialize(event);\n    const channel = `${CHANNEL_PREFIX}${event.type}`;\n\n    await this.publisher!.publish(channel, payload);\n  }\n\n  /**\n   * Publish multiple events using a pipeline so all PUBLISH commands are sent\n   * in a single round-trip.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    if (events.length === 0) return;\n    this.assertConnected();\n\n    const pipeline = this.publisher!.pipeline();\n    for (const event of events) {\n      const payload = this.serialize(event);\n      const channel = `${CHANNEL_PREFIX}${event.type}`;\n      pipeline.publish(channel, payload);\n    }\n    await pipeline.exec();\n  }\n\n  /**\n   * Register a handler for a specific event type.\n   * Returns an unsubscribe function — call it to remove the handler.\n   *\n   * On first handler for a type, subscribes to the per-type Redis channel.\n   * On removal of the last handler for a type, unsubscribes from the channel.\n   */\n  /**\n   * Lookup by id is unsupported on the Redis Pub/Sub backend — Pub/Sub\n   * does not retain history. Always returns `null`. Logs a warning the\n   * first time it's called so a misconfiguration surfaces visibly. Using\n   * the bridge with the Redis backend is unsupported (the bridge requires\n   * a durable event store).\n   */\n  private warnedFindById = false;\n  async findById(_eventId: string): Promise<DomainEvent | null> {\n    if (!this.warnedFindById) {\n      this.warnedFindById = true;\n      this.logger.warn(\n        'RedisEventBus.findById is unsupported (Pub/Sub has no history). ' +\n          'The bridge subsystem requires a durable event store; switch to ' +\n          'DrizzleEventBus if you need bridge fanout.',\n      );\n    }\n    return null;\n  }\n\n  subscribe<T extends DomainEvent = DomainEvent>(\n    eventType: string,\n    handler: (event: T) => Promise<void>,\n  ): () => void {\n    if (!this.handlers.has(eventType)) {\n      this.handlers.set(eventType, new Set());\n      // First handler for this type — subscribe to the per-type channel in Redis.\n      void this.subscribeToType(eventType);\n    }\n    const set = this.handlers.get(eventType)!;\n    const h = handler as (event: DomainEvent) => Promise<void>;\n    set.add(h);\n\n    return () => {\n      set.delete(h);\n      // If no more handlers for this type, unsubscribe from the Redis channel.\n      if (set.size === 0) {\n        this.handlers.delete(eventType);\n        void this.unsubscribeFromType(eventType);\n      }\n    };\n  }\n\n  // ============================================================================\n  // Internal helpers\n  // ============================================================================\n\n  private assertConnected(): void {\n    if (!this.connected || !this.publisher) {\n      throw new Error(\n        'RedisEventBus is not connected. Ensure the module has been initialised before publishing.',\n      );\n    }\n  }\n\n  private serialize(event: DomainEvent): string {\n    return JSON.stringify({\n      ...event,\n      occurredAt: event.occurredAt.toISOString(),\n    });\n  }\n\n  private deserialize(raw: string): DomainEvent {\n    const parsed = JSON.parse(raw) as DomainEvent & { occurredAt: string };\n    return {\n      ...parsed,\n      occurredAt: new Date(parsed.occurredAt),\n    };\n  }\n\n  private async handleMessage(channel: string, message: string): Promise<void> {\n    let event: DomainEvent;\n    try {\n      event = this.deserialize(message);\n    } catch (err) {\n      this.logger.warn(`Failed to deserialize event on channel \"${channel}\": ${err}`);\n      return;\n    }\n\n    await this.dispatch(event);\n  }\n\n  private async dispatch(event: DomainEvent): Promise<void> {\n    const set = this.handlers.get(event.type);\n    if (!set) return;\n    for (const handler of set) {\n      try {\n        await handler(event);\n      } catch (err) {\n        this.logger.error(\n          `Handler error for event type \"${event.type}\" (id: ${event.id}): ${err}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Subscribe to a per-type Redis channel.\n   * Called lazily when the first handler is registered for a type.\n   */\n  private async subscribeToType(eventType: string): Promise<void> {\n    if (this.subscribedTypes.has(eventType)) {\n      return; // Already subscribed to this type.\n    }\n\n    const channel = `${CHANNEL_PREFIX}${eventType}`;\n    try {\n      await this.subscriber!.subscribe(channel);\n      this.subscribedTypes.add(eventType);\n    } catch (err) {\n      this.logger.error(`Failed to subscribe to channel \"${channel}\": ${err}`);\n    }\n  }\n\n  /**\n   * Unsubscribe from a per-type Redis channel.\n   * Called when the last handler for a type is removed.\n   */\n  private async unsubscribeFromType(eventType: string): Promise<void> {\n    if (!this.subscribedTypes.has(eventType)) {\n      return; // Not subscribed to this type.\n    }\n\n    const channel = `${CHANNEL_PREFIX}${eventType}`;\n    try {\n      await this.subscriber!.unsubscribe(channel);\n      this.subscribedTypes.delete(eventType);\n    } catch (err) {\n      this.logger.error(`Failed to unsubscribe from channel \"${channel}\": ${err}`);\n    }\n  }\n}\n","/** Canonical package namespace for cross-boundary DI token keys. MUST be a hardcoded\n *  constant (NOT derived from package.json) so a vendored copy — which lives inside the\n *  CONSUMER's package — produces the identical key and the two copies share the symbol. */\nexport const PKG = '@pattern-stack/codegen';\n// TODO(token-version): if/when a runtime contract version is adopted, inject it HERE only\n//   (e.g. `${PKG}#${ABI}.${area}.${name}`) — this helper is the single chokepoint.\nexport const tokenKey = (area: string, name: string): string => `${PKG}.${area}.${name}`;\n","/**\n * Injection token for the event bus.\n *\n * String constant (not Symbol) so it matches by value across import boundaries.\n * Matches the token in runtime/constants/tokens.ts — both are 'EVENT_BUS'.\n *\n * Usage in use cases:\n * ```typescript\n * constructor(@Inject(EVENT_BUS) private readonly eventBus: IEventBus) {}\n * ```\n */\nimport { tokenKey } from '../token-key';\n\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n\n/**\n * Injection token for the read-side `IEventReadPort` over `domain_events`\n * (OBS-LIST-1).\n *\n * Bound by `EventsModule.forRoot` to the same backend instance as\n * `EVENT_BUS` for the `drizzle` and `memory` backends (both implement\n * `IEventReadPort`). The `redis` backend retains no history and therefore\n * does NOT provide this token — consumers composing it (e.g. the\n * observability combiner) inject it `@Optional()` and degrade to empty\n * results.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n */\nexport const EVENT_READ_PORT = 'EVENT_READ_PORT' as const;\n\n/**\n * Injection token for the generated `TypedEventBus` facade.\n *\n * `TypedEventBus` lives in `runtime/subsystems/events/generated/bus.ts` and\n * wraps `IEventBus` with project-specific `AppDomainEvent`-typed `publish<T>()`\n * and `subscribe<T>()`. Use cases inject this token in preference to\n * `EVENT_BUS` when they want compile-time type safety on event shapes.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n *\n * Provider registration lands in EVT-6 (EventsModule wiring); the token is\n * declared here so generated code can import it without depending on the\n * still-being-formalised module.\n */\nexport const TYPED_EVENT_BUS = 'TYPED_EVENT_BUS' as const;\n\n/**\n * Injection token for the resolved multi-tenancy flag.\n *\n * Provided by `EventsModule.forRoot(...)` as `options.multiTenant ?? false`.\n * Consumed by `TypedEventBus` to enforce the tenantId-is-required rule at\n * publish time.\n *\n * String constant (not Symbol) so it matches by value across import\n * boundaries — same convention as the other events tokens. (The jobs\n * subsystem uses Symbols for the analogous token; events chose strings\n * from the start and we keep the file internally consistent.)\n */\nexport const EVENTS_MULTI_TENANT = 'EVENTS_MULTI_TENANT' as const;\n\n/**\n * Injection token for the Redis connection URL used by RedisEventBus.\n * Provided automatically by EventsModule.forRoot({ backend: 'redis' }).\n *\n * ADR-037: namespaced `Symbol.for(...)` (via `tokenKey()`) so it matches by value\n * across runtime copies (the sibling string tokens above are already value-stable).\n * Note the jobs subsystem defines its own `REDIS_URL`-equivalent; this is the\n * events one.\n */\nexport const REDIS_URL = Symbol.for(tokenKey('events', 'redis-url'));\n\n/**\n * Injection token for the resolved `EventsModuleOptions` object.\n *\n * Provided automatically by `EventsModule.forRoot(...)` /\n * `EventsModule.forRootAsync(...)`. Backends that need to observe module\n * configuration (e.g. `DrizzleEventBus` reading `opts.pools` for\n * pool-filtered drain) inject via this token.\n *\n * String-valued (not `Symbol`) so it matches by value across import\n * boundaries — same convention as `EVENT_BUS`.\n */\nexport const EVENTS_MODULE_OPTIONS = 'EVENTS_MODULE_OPTIONS' as const;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../runtime/subsystems/events/event-bus.redis-backend.ts"],"sourcesContent":["/**\n * RedisEventBus — Redis Pub/Sub backend for the event bus.\n *\n * Publishes events to Redis channels and dispatches incoming messages to\n * registered in-process subscribers. Events are serialized as JSON strings.\n *\n * Channel naming:\n *   - Per-type channel:  events:{event.type}   (e.g. events:contact_created)\n *   - Catch-all channel: events:*\n *\n * Transactional semantics:\n *   The `tx` parameter (Drizzle transaction) is accepted to satisfy the\n *   IEventBus interface but has no effect — Redis Pub/Sub is not transactional.\n *   Events published with a `tx` argument are dispatched immediately without\n *   waiting for the surrounding transaction to commit. If you need\n *   at-least-once delivery tied to a database transaction, use DrizzleEventBus.\n *\n * Connection model:\n *   ioredis requires a dedicated connection for subscribers (a client in\n *   subscribe mode cannot issue regular commands). This backend creates two\n *   clients: one for publishing (`publisher`) and one for subscribing\n *   (`subscriber`). Both are connected on module init and disconnected on\n *   module destroy.\n *\n * Usage:\n *   EventsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })\n *\n * Requires `ioredis` — install it separately if you use this backend:\n *   npm install ioredis   /   bun add ioredis\n */\nimport { Injectable, OnModuleInit, OnModuleDestroy, Inject, Logger } from '@nestjs/common';\nimport type { DomainEvent, DrizzleTransaction, IEventBus } from './event-bus.protocol';\nimport { REDIS_URL } from './events.tokens';\n\n/** Redis channel prefix for all domain events. */\nconst CHANNEL_PREFIX = 'events:';\n/** Catch-all channel that receives every published event. */\nconst WILDCARD_CHANNEL = 'events:*';\n\n// ioredis is an optional peer dependency; import lazily so consumers who do\n// not use this backend do not need it on their classpath.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RedisClient = any;\n\nasync function createRedisClient(url: string): Promise<RedisClient> {\n  let Redis: { new (url: string): RedisClient };\n  try {\n    const mod = await import('ioredis');\n    Redis = mod.default ?? mod;\n  } catch {\n    throw new Error(\n      'RedisEventBus requires the \"ioredis\" package. Install it with: npm install ioredis',\n    );\n  }\n  return new Redis(url);\n}\n\n@Injectable()\nexport class RedisEventBus implements IEventBus, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisEventBus.name);\n\n  private publisher: RedisClient | null = null;\n  private subscriber: RedisClient | null = null;\n  private connected = false;\n\n  /**\n   * In-process subscriber registry. Handlers registered here are called when\n   * a message arrives on the subscriber client — keeping fan-out within the\n   * same process without an extra round-trip through Redis.\n   */\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n\n  /**\n   * Track which event types have active Redis subscriptions.\n   * Used to avoid subscribing multiple times to the same type channel.\n   */\n  private readonly subscribedTypes = new Set<string>();\n\n  constructor(@Inject(REDIS_URL) private readonly redisUrl: string) {}\n\n  // ============================================================================\n  // Lifecycle\n  // ============================================================================\n\n  async onModuleInit(): Promise<void> {\n    this.publisher = await createRedisClient(this.redisUrl);\n    this.subscriber = await createRedisClient(this.redisUrl);\n\n    // Surface connection errors without crashing the process.\n    this.publisher.on('error', (err: Error) =>\n      this.logger.error(`Redis publisher error: ${err.message}`, err.stack),\n    );\n    this.subscriber.on('error', (err: Error) =>\n      this.logger.error(`Redis subscriber error: ${err.message}`, err.stack),\n    );\n\n    // Set up message listener for per-type subscriptions.\n    // Subscriptions are created lazily when the first handler is registered for a type.\n    this.subscriber.on('message', (channel: string, message: string) => {\n      void this.handleMessage(channel, message);\n    });\n\n    this.connected = true;\n    this.logger.log(`RedisEventBus connected to ${this.redisUrl}`);\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.connected = false;\n\n    if (this.subscriber) {\n      // Unsubscribe from all channels and disconnect the subscriber.\n      // unsubscribe() with no args unsubscribes from all channels.\n      await this.subscriber.unsubscribe();\n      this.subscriber.disconnect();\n      this.subscriber = null;\n    }\n\n    if (this.publisher) {\n      this.publisher.disconnect();\n      this.publisher = null;\n    }\n\n    this.subscribedTypes.clear();\n    this.logger.log('RedisEventBus disconnected');\n  }\n\n  // ============================================================================\n  // IEventBus\n  // ============================================================================\n\n  /**\n   * Publish a single event.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    this.assertConnected();\n\n    const payload = this.serialize(event);\n    const channel = `${CHANNEL_PREFIX}${event.type}`;\n\n    await this.publisher!.publish(channel, payload);\n  }\n\n  /**\n   * Publish multiple events using a pipeline so all PUBLISH commands are sent\n   * in a single round-trip.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    if (events.length === 0) return;\n    this.assertConnected();\n\n    const pipeline = this.publisher!.pipeline();\n    for (const event of events) {\n      const payload = this.serialize(event);\n      const channel = `${CHANNEL_PREFIX}${event.type}`;\n      pipeline.publish(channel, payload);\n    }\n    await pipeline.exec();\n  }\n\n  /**\n   * Register a handler for a specific event type.\n   * Returns an unsubscribe function — call it to remove the handler.\n   *\n   * On first handler for a type, subscribes to the per-type Redis channel.\n   * On removal of the last handler for a type, unsubscribes from the channel.\n   */\n  /**\n   * Lookup by id is unsupported on the Redis Pub/Sub backend — Pub/Sub\n   * does not retain history. Always returns `null`. Logs a warning the\n   * first time it's called so a misconfiguration surfaces visibly. Using\n   * the bridge with the Redis backend is unsupported (the bridge requires\n   * a durable event store).\n   */\n  private warnedFindById = false;\n  async findById(_eventId: string): Promise<DomainEvent | null> {\n    if (!this.warnedFindById) {\n      this.warnedFindById = true;\n      this.logger.warn(\n        'RedisEventBus.findById is unsupported (Pub/Sub has no history). ' +\n          'The bridge subsystem requires a durable event store; switch to ' +\n          'DrizzleEventBus if you need bridge fanout.',\n      );\n    }\n    return null;\n  }\n\n  subscribe<T extends DomainEvent = DomainEvent>(\n    eventType: string,\n    handler: (event: T) => Promise<void>,\n  ): () => void {\n    if (!this.handlers.has(eventType)) {\n      this.handlers.set(eventType, new Set());\n      // First handler for this type — subscribe to the per-type channel in Redis.\n      void this.subscribeToType(eventType);\n    }\n    const set = this.handlers.get(eventType)!;\n    const h = handler as (event: DomainEvent) => Promise<void>;\n    set.add(h);\n\n    return () => {\n      set.delete(h);\n      // If no more handlers for this type, unsubscribe from the Redis channel.\n      if (set.size === 0) {\n        this.handlers.delete(eventType);\n        void this.unsubscribeFromType(eventType);\n      }\n    };\n  }\n\n  // ============================================================================\n  // Internal helpers\n  // ============================================================================\n\n  private assertConnected(): void {\n    if (!this.connected || !this.publisher) {\n      throw new Error(\n        'RedisEventBus is not connected. Ensure the module has been initialised before publishing.',\n      );\n    }\n  }\n\n  private serialize(event: DomainEvent): string {\n    return JSON.stringify({\n      ...event,\n      occurredAt: event.occurredAt.toISOString(),\n    });\n  }\n\n  private deserialize(raw: string): DomainEvent {\n    const parsed = JSON.parse(raw) as DomainEvent & { occurredAt: string };\n    return {\n      ...parsed,\n      occurredAt: new Date(parsed.occurredAt),\n    };\n  }\n\n  private async handleMessage(channel: string, message: string): Promise<void> {\n    let event: DomainEvent;\n    try {\n      event = this.deserialize(message);\n    } catch (err) {\n      this.logger.warn(`Failed to deserialize event on channel \"${channel}\": ${err}`);\n      return;\n    }\n\n    await this.dispatch(event);\n  }\n\n  private async dispatch(event: DomainEvent): Promise<void> {\n    const set = this.handlers.get(event.type);\n    if (!set) return;\n    for (const handler of set) {\n      try {\n        await handler(event);\n      } catch (err) {\n        this.logger.error(\n          `Handler error for event type \"${event.type}\" (id: ${event.id}): ${err}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Subscribe to a per-type Redis channel.\n   * Called lazily when the first handler is registered for a type.\n   */\n  private async subscribeToType(eventType: string): Promise<void> {\n    if (this.subscribedTypes.has(eventType)) {\n      return; // Already subscribed to this type.\n    }\n\n    const channel = `${CHANNEL_PREFIX}${eventType}`;\n    try {\n      await this.subscriber!.subscribe(channel);\n      this.subscribedTypes.add(eventType);\n    } catch (err) {\n      this.logger.error(`Failed to subscribe to channel \"${channel}\": ${err}`);\n    }\n  }\n\n  /**\n   * Unsubscribe from a per-type Redis channel.\n   * Called when the last handler for a type is removed.\n   */\n  private async unsubscribeFromType(eventType: string): Promise<void> {\n    if (!this.subscribedTypes.has(eventType)) {\n      return; // Not subscribed to this type.\n    }\n\n    const channel = `${CHANNEL_PREFIX}${eventType}`;\n    try {\n      await this.subscriber!.unsubscribe(channel);\n      this.subscribedTypes.delete(eventType);\n    } catch (err) {\n      this.logger.error(`Failed to unsubscribe from channel \"${channel}\": ${err}`);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/runtime/subsystems/events/event-keyset-cursor.js

@@ -1,33 +1,11 @@
-// runtime/subsystems/events/event-keyset-cursor.ts
-var DEFAULT_EVENT_LIST_LIMIT = 50;
-var MAX_EVENT_LIST_LIMIT = 200;
-function clampEventLimit(limit) {
-  if (typeof limit !== "number" || !Number.isFinite(limit)) {
-    return DEFAULT_EVENT_LIST_LIMIT;
-  }
-  const floored = Math.floor(limit);
-  if (floored < 1) return 1;
-  if (floored > MAX_EVENT_LIST_LIMIT) return MAX_EVENT_LIST_LIMIT;
-  return floored;
-}
-function encodeEventCursor(keyset) {
-  const tuple = [keyset.occurredAt.toISOString(), keyset.id];
-  return Buffer.from(JSON.stringify(tuple), "utf8").toString("base64url");
-}
-function decodeEventCursor(cursor) {
-  try {
-    const json = Buffer.from(cursor, "base64url").toString("utf8");
-    const parsed = JSON.parse(json);
-    if (!Array.isArray(parsed) || parsed.length !== 2) return null;
-    const [iso, id] = parsed;
-    if (typeof iso !== "string" || typeof id !== "string") return null;
-    const occurredAt = new Date(iso);
-    if (Number.isNaN(occurredAt.getTime())) return null;
-    return { occurredAt, id };
-  } catch {
-    return null;
-  }
-}
+import {
+  DEFAULT_EVENT_LIST_LIMIT,
+  MAX_EVENT_LIST_LIMIT,
+  clampEventLimit,
+  decodeEventCursor,
+  encodeEventCursor
+} from "../../../chunk-UQ5EHOH2.js";
+import "../../../chunk-2E224ZSN.js";
 export {
   DEFAULT_EVENT_LIST_LIMIT,
   MAX_EVENT_LIST_LIMIT,

package/dist/runtime/subsystems/events/event-keyset-cursor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../runtime/subsystems/events/event-keyset-cursor.ts"],"sourcesContent":["/**\n * Keyset (seek) cursor codec for `IEventReadPort.listEvents` (OBS-LIST-1).\n *\n * The list is ordered `occurred_at DESC, id DESC`. The cursor encodes the\n * `(occurredAt, id)` of the last row on the previous page so the next page\n * seeks with `WHERE (occurred_at, id) < (cursorOccurredAt, cursorId)`.\n *\n * The cursor is opaque to consumers: a base64url-encoded JSON tuple. Shape\n * is an implementation detail — never parse it outside this module.\n *\n * Mirrors the jobs keyset codec; kept separate because the events subsystem\n * must not depend on `runtime/subsystems/jobs/`.\n */\n\nexport interface EventKeyset {\n  occurredAt: Date;\n  id: string;\n}\n\n/** Default page size when `limit` is omitted. */\nexport const DEFAULT_EVENT_LIST_LIMIT = 50;\n/** Hard upper bound on page size. */\nexport const MAX_EVENT_LIST_LIMIT = 200;\n\n/** Clamp a caller-supplied `limit` into `[1, MAX_EVENT_LIST_LIMIT]`. */\nexport function clampEventLimit(limit: number | undefined): number {\n  if (typeof limit !== 'number' || !Number.isFinite(limit)) {\n    return DEFAULT_EVENT_LIST_LIMIT;\n  }\n  const floored = Math.floor(limit);\n  if (floored < 1) return 1;\n  if (floored > MAX_EVENT_LIST_LIMIT) return MAX_EVENT_LIST_LIMIT;\n  return floored;\n}\n\nexport function encodeEventCursor(keyset: EventKeyset): string {\n  const tuple = [keyset.occurredAt.toISOString(), keyset.id];\n  return Buffer.from(JSON.stringify(tuple), 'utf8').toString('base64url');\n}\n\n/**\n * Decode an opaque cursor back into its `(occurredAt, id)` keyset. Returns\n * `null` for malformed input so user-supplied garbage is treated as \"start\n * from the beginning\" rather than throwing.\n */\nexport function decodeEventCursor(cursor: string): EventKeyset | null {\n  try {\n    const json = Buffer.from(cursor, 'base64url').toString('utf8');\n    const parsed = JSON.parse(json) as unknown;\n    if (!Array.isArray(parsed) || parsed.length !== 2) return null;\n    const [iso, id] = parsed;\n    if (typeof iso !== 'string' || typeof id !== 'string') return null;\n    const occurredAt = new Date(iso);\n    if (Number.isNaN(occurredAt.getTime())) return null;\n    return { occurredAt, id };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":";AAoBO,IAAM,2BAA2B;AAEjC,IAAM,uBAAuB;AAG7B,SAAS,gBAAgB,OAAmC;AACjE,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD,WAAO;AAAA,EACT;AACA,QAAM,UAAU,KAAK,MAAM,KAAK;AAChC,MAAI,UAAU,EAAG,QAAO;AACxB,MAAI,UAAU,qBAAsB,QAAO;AAC3C,SAAO;AACT;AAEO,SAAS,kBAAkB,QAA6B;AAC7D,QAAM,QAAQ,CAAC,OAAO,WAAW,YAAY,GAAG,OAAO,EAAE;AACzD,SAAO,OAAO,KAAK,KAAK,UAAU,KAAK,GAAG,MAAM,EAAE,SAAS,WAAW;AACxE;AAOO,SAAS,kBAAkB,QAAoC;AACpE,MAAI;AACF,UAAM,OAAO,OAAO,KAAK,QAAQ,WAAW,EAAE,SAAS,MAAM;AAC7D,UAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,OAAO,WAAW,EAAG,QAAO;AAC1D,UAAM,CAAC,KAAK,EAAE,IAAI;AAClB,QAAI,OAAO,QAAQ,YAAY,OAAO,OAAO,SAAU,QAAO;AAC9D,UAAM,aAAa,IAAI,KAAK,GAAG;AAC/B,QAAI,OAAO,MAAM,WAAW,QAAQ,CAAC,EAAG,QAAO;AAC/C,WAAO,EAAE,YAAY,GAAG;AAAA,EAC1B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/subsystems/events/event-read.protocol.js

@@ -1,3 +1,5 @@
+import "../../../chunk-2E224ZSN.js";
+
 // runtime/subsystems/events/event-read.protocol.ts
 function rootRunIdOf(event) {
   const v = event.metadata?.["rootRunId"];

package/dist/runtime/subsystems/events/event-read.protocol.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../runtime/subsystems/events/event-read.protocol.ts"],"sourcesContent":["/**\n * IEventReadPort — read-side port over `domain_events` (OBS-LIST-1).\n *\n * The publish/subscribe `IEventBus` (EVENT_BUS) is a *write + dispatch*\n * port; it deliberately does not expose tabular reads beyond `findById`.\n * The observability combiner needs a paginated, filterable list of\n * `domain_events` for its events viewer, so we add a dedicated read port\n * rather than overloading `IEventBus`.\n *\n * Keeping reads on a separate port means:\n *   - the combiner can compose it `@Optional()` independently of EVENT_BUS;\n *   - the Redis backend (which retains no history) simply does not provide\n *     it — there is no \"list\" semantics to fake;\n *   - the write/dispatch surface stays minimal.\n *\n * Both `DrizzleEventBus` and `MemoryEventBus` implement this port (they\n * already hold the rows / in-memory log); `EventsModule.forRoot` binds the\n * `EVENT_READ_PORT` token to the same instance for drizzle/memory backends.\n */\n\nimport type { DomainEvent } from './event-bus.protocol';\n\n/**\n * Filter + keyset-pagination input for `IEventReadPort.listEvents`.\n *\n * Ordered `occurred_at DESC, id DESC`. `rootRunId` filters on the JSON\n * `metadata->>'rootRunId'` — the correlation id stamped by the jobs/bridge\n * machinery so an event can be traced back to the run tree that emitted it.\n */\nexport interface ListEventsQuery {\n  /** Filter on `metadata->>'rootRunId'` (correlation id). */\n  rootRunId?: string;\n  /** Filter on the first-class `pool` column. */\n  poolId?: string;\n  /** Filter on the first-class `direction` column (inbound|change|outbound). */\n  direction?: string;\n  /** Lower bound on `occurred_at` (inclusive). */\n  since?: Date;\n  /** Opaque keyset cursor from a previous page's `nextCursor`. */\n  cursor?: string;\n  /** Page size. Backend clamps to a sane default + max. */\n  limit?: number;\n  /**\n   * Multi-tenancy filter on the first-class `tenant_id` column. Only\n   * meaningful when the consumer publishes tenant-scoped events\n   * (`events.multi_tenant: true`); otherwise leave undefined.\n   *   - `string` — filter `tenant_id = :tenantId`.\n   *   - `null`   — filter `tenant_id IS NULL`.\n   *   - `undefined` — no tenant filter.\n   */\n  tenantId?: string | null;\n}\n\n/**\n * Summary row for the events list. A narrow projection over `domain_events`\n * carrying what the viewer + correlation timeline need. `rootRunId` is\n * surfaced (lifted out of `metadata`) so the timeline can stitch without a\n * second metadata dig.\n */\nexport interface EventSummary {\n  id: string;\n  type: string;\n  aggregateId: string;\n  aggregateType: string;\n  status: string;\n  pool: string | null;\n  direction: string | null;\n  tier: string;\n  rootRunId: string | null;\n  tenantId: string | null;\n  occurredAt: Date;\n  processedAt: Date | null;\n}\n\n/**\n * One page of `listEvents` results. `nextCursor` is `null` when there are\n * no more rows.\n */\nexport interface EventPage {\n  items: EventSummary[];\n  nextCursor: string | null;\n}\n\nexport interface IEventReadPort {\n  /**\n   * Paginated, filterable list of `domain_events` (OBS-LIST-1). Newest\n   * first (`occurred_at` desc, `id` desc keyset tie-break). Returns an\n   * `EventPage` with an opaque `nextCursor` for keyset pagination.\n   */\n  listEvents(query?: ListEventsQuery): Promise<EventPage>;\n}\n\n/** A `DomainEvent` whose metadata may carry a `rootRunId` correlation id. */\nexport function rootRunIdOf(event: DomainEvent): string | null {\n  const v = event.metadata?.['rootRunId'];\n  return typeof v === 'string' ? v : null;\n}\n"],"mappings":";AA6FO,SAAS,YAAY,OAAmC;AAC7D,QAAM,IAAI,MAAM,WAAW,WAAW;AACtC,SAAO,OAAO,MAAM,WAAW,IAAI;AACrC;","names":[]}
+{"version":3,"sources":["../../../../runtime/subsystems/events/event-read.protocol.ts"],"sourcesContent":["/**\n * IEventReadPort — read-side port over `domain_events` (OBS-LIST-1).\n *\n * The publish/subscribe `IEventBus` (EVENT_BUS) is a *write + dispatch*\n * port; it deliberately does not expose tabular reads beyond `findById`.\n * The observability combiner needs a paginated, filterable list of\n * `domain_events` for its events viewer, so we add a dedicated read port\n * rather than overloading `IEventBus`.\n *\n * Keeping reads on a separate port means:\n *   - the combiner can compose it `@Optional()` independently of EVENT_BUS;\n *   - the Redis backend (which retains no history) simply does not provide\n *     it — there is no \"list\" semantics to fake;\n *   - the write/dispatch surface stays minimal.\n *\n * Both `DrizzleEventBus` and `MemoryEventBus` implement this port (they\n * already hold the rows / in-memory log); `EventsModule.forRoot` binds the\n * `EVENT_READ_PORT` token to the same instance for drizzle/memory backends.\n */\n\nimport type { DomainEvent } from './event-bus.protocol';\n\n/**\n * Filter + keyset-pagination input for `IEventReadPort.listEvents`.\n *\n * Ordered `occurred_at DESC, id DESC`. `rootRunId` filters on the JSON\n * `metadata->>'rootRunId'` — the correlation id stamped by the jobs/bridge\n * machinery so an event can be traced back to the run tree that emitted it.\n */\nexport interface ListEventsQuery {\n  /** Filter on `metadata->>'rootRunId'` (correlation id). */\n  rootRunId?: string;\n  /** Filter on the first-class `pool` column. */\n  poolId?: string;\n  /** Filter on the first-class `direction` column (inbound|change|outbound). */\n  direction?: string;\n  /** Lower bound on `occurred_at` (inclusive). */\n  since?: Date;\n  /** Opaque keyset cursor from a previous page's `nextCursor`. */\n  cursor?: string;\n  /** Page size. Backend clamps to a sane default + max. */\n  limit?: number;\n  /**\n   * Multi-tenancy filter on the first-class `tenant_id` column. Only\n   * meaningful when the consumer publishes tenant-scoped events\n   * (`events.multi_tenant: true`); otherwise leave undefined.\n   *   - `string` — filter `tenant_id = :tenantId`.\n   *   - `null`   — filter `tenant_id IS NULL`.\n   *   - `undefined` — no tenant filter.\n   */\n  tenantId?: string | null;\n}\n\n/**\n * Summary row for the events list. A narrow projection over `domain_events`\n * carrying what the viewer + correlation timeline need. `rootRunId` is\n * surfaced (lifted out of `metadata`) so the timeline can stitch without a\n * second metadata dig.\n */\nexport interface EventSummary {\n  id: string;\n  type: string;\n  aggregateId: string;\n  aggregateType: string;\n  status: string;\n  pool: string | null;\n  direction: string | null;\n  tier: string;\n  rootRunId: string | null;\n  tenantId: string | null;\n  occurredAt: Date;\n  processedAt: Date | null;\n}\n\n/**\n * One page of `listEvents` results. `nextCursor` is `null` when there are\n * no more rows.\n */\nexport interface EventPage {\n  items: EventSummary[];\n  nextCursor: string | null;\n}\n\nexport interface IEventReadPort {\n  /**\n   * Paginated, filterable list of `domain_events` (OBS-LIST-1). Newest\n   * first (`occurred_at` desc, `id` desc keyset tie-break). Returns an\n   * `EventPage` with an opaque `nextCursor` for keyset pagination.\n   */\n  listEvents(query?: ListEventsQuery): Promise<EventPage>;\n}\n\n/** A `DomainEvent` whose metadata may carry a `rootRunId` correlation id. */\nexport function rootRunIdOf(event: DomainEvent): string | null {\n  const v = event.metadata?.['rootRunId'];\n  return typeof v === 'string' ? v : null;\n}\n"],"mappings":";;;AA6FO,SAAS,YAAY,OAAmC;AAC7D,QAAM,IAAI,MAAM,WAAW,WAAW;AACtC,SAAO,OAAO,MAAM,WAAW,IAAI;AACrC;","names":[]}

package/dist/runtime/subsystems/events/event-registry.d.ts

@@ -0,0 +1,77 @@
+import { DomainEvent } from './event-bus.protocol.js';
+import '../../types/drizzle.js';
+import 'drizzle-orm/node-postgres';
+
+/**
+ * Augmentable domain-event registry (ADR-037, package-mode trigger typing).
+ *
+ * This is the seam that lets the bridge + job-trigger types see a PACKAGE-MODE
+ * consumer's OWN events with full per-event payload typing — without the
+ * package shipping (and leaking) its internal test-fixture event union.
+ *
+ * ── The problem ──────────────────────────────────────────────────────────────
+ * In vendored mode, `bridge.protocol.ts` / `job-handler.base.ts` could import
+ * `EventTypeName` / `EventOfType` straight from the consumer's vendored
+ * `./generated/types` (a sibling file). In package mode the runtime is consumed
+ * from the published `@pattern-stack/codegen`, whose bundled
+ * `events/generated/types.ts` is the codegen-patterns repo's OWN fixture union
+ * (`contact_created`, `deal_created`, …). Keying the bridge/trigger types off
+ * THAT union rejects the consumer's events (`'inbound_webhook_received' is not
+ * assignable to '"contact_created" | …'`).
+ *
+ * ── The fix ──────────────────────────────────────────────────────────────────
+ * `EventTypeName` (as used by the bridge/trigger types) derives from an EMPTY,
+ * augmentable `DomainEventRegistry` interface instead of the bundled concrete
+ * union. A package-mode consumer's generated events code emits a
+ * `declare module '@pattern-stack/codegen/runtime/subsystems/events/index' {
+ *    interface DomainEventRegistry { <their_event>: <TheirEvent>; … } }`
+ * augmentation, so in the consumer's tsc program `keyof DomainEventRegistry`
+ * picks up THEIR events and `EventOfType<T>` resolves THEIR concrete payloads.
+ *
+ * In the package's OWN program (and any consumer that authors no events) the
+ * interface is never augmented, so `keyof DomainEventRegistry` is `never` and
+ * `EventTypeName` falls back to `string` — the bridge/trigger types degrade to
+ * `Record<string, …>` / `(event: DomainEvent) => …`, exactly the loose-but-
+ * sound shape that keeps the package's fixture-based runtime tests green.
+ *
+ * The bundled `events/generated/{types,bus,schemas}.ts` keep their concrete
+ * fixture union locally (the bundled `TypedEventBus` keys off `./types`, NOT
+ * this file), so they do NOT augment `DomainEventRegistry` and never leak the
+ * fixtures into a consumer's `EventTypeName` — even though the consumer pulls
+ * `generated/types.d.ts` in transitively via the events index barrel.
+ */
+
+/**
+ * Empty marker interface, augmented by a consumer's generated events code via
+ * declaration merging on the events index module specifier
+ * (`@pattern-stack/codegen/runtime/subsystems/events/index`). Each key is an
+ * event `type` literal; each value is the event's concrete interface (extends
+ * `DomainEvent`). Empty in the package and in any project that declares no
+ * `events/*.yaml`.
+ *
+ * Intentionally NOT augmented by the package's own bundled
+ * `events/generated/types.ts` — those fixtures stay local to the bundled
+ * `TypedEventBus` so they never widen a consumer's `EventTypeName`.
+ *
+ * Must be an `interface` (only interfaces merge across module boundaries) and
+ * empty by design — a consumer augments it via declaration merging.
+ */
+interface DomainEventRegistry {
+}
+/**
+ * Union of registered event `type` literals. When the registry is augmented
+ * (package-mode consumer with events) this is their event-type union; when it's
+ * empty (the package itself, or a no-events project) it falls back to `string`
+ * so the bridge/trigger types stay sound rather than collapsing to `never`.
+ */
+type EventTypeName = keyof DomainEventRegistry extends never ? string : keyof DomainEventRegistry & string;
+/**
+ * The concrete event interface for a given `type`. Resolves to the consumer's
+ * registered interface when the registry knows `T`; otherwise (the fallback
+ * `string` case, or an unregistered literal) widens to the structural
+ * `DomainEvent` base so `event.type` / `event.id` / `event.payload` are still
+ * typed (payloads as `Record<string, unknown>`).
+ */
+type EventOfType<T extends EventTypeName> = T extends keyof DomainEventRegistry ? DomainEventRegistry[T] : DomainEvent;
+
+export type { DomainEventRegistry, EventOfType, EventTypeName };

package/dist/runtime/subsystems/events/event-registry.js

@@ -0,0 +1 @@
+//# sourceMappingURL=event-registry.js.map

package/dist/runtime/subsystems/events/event-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/subsystems/events/events-errors.js

@@ -1,14 +1,7 @@
-// runtime/subsystems/events/events-errors.ts
-var MissingTenantIdError = class extends Error {
-  constructor(eventType) {
-    super(
-      `Missing tenantId for event '${eventType}'. EventsModule is configured with multiTenant: true \u2014 every publish must include opts.metadata.tenantId. Either pass the tenantId or disable multi-tenancy on the module.`
-    );
-    this.eventType = eventType;
-  }
-  eventType;
-  name = "MissingTenantIdError";
-};
+import {
+  MissingTenantIdError
+} from "../../../chunk-V4AF6DI4.js";
+import "../../../chunk-2E224ZSN.js";
 export {
   MissingTenantIdError
 };

package/dist/runtime/subsystems/events/events-errors.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../runtime/subsystems/events/events-errors.ts"],"sourcesContent":["/**\n * Typed errors for the events subsystem (ADR-024, EVT-6).\n *\n * All thrown from the publish path of `TypedEventBus`. They exist as\n * classes so consumers can `instanceof` them in catch blocks and\n * exception filters can map them to HTTP codes.\n */\n\n/**\n * Thrown by `TypedEventBus.publish()` when the EventsModule is configured\n * with `multiTenant: true` and the caller did not supply\n * `opts.metadata.tenantId`. Multi-tenant mode requires every outbox row to\n * be attributable to a tenant — the `domain_events.tenant_id` column is\n * populated from this value and the drain loop uses it for future\n * tenant-scoped filtering (deferred — see ADR-024 §Multi-tenancy).\n *\n * Disable multi-tenancy at the module level (`multiTenant: false`, the\n * default) to opt out of the requirement entirely.\n */\nexport class MissingTenantIdError extends Error {\n  override readonly name = 'MissingTenantIdError';\n  constructor(public readonly eventType: string) {\n    super(\n      `Missing tenantId for event '${eventType}'. EventsModule is configured ` +\n        `with multiTenant: true — every publish must include ` +\n        `opts.metadata.tenantId. Either pass the tenantId or disable ` +\n        `multi-tenancy on the module.`,\n    );\n  }\n}\n"],"mappings":";AAmBO,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAE9C,YAA4B,WAAmB;AAC7C;AAAA,MACE,+BAA+B,SAAS;AAAA,IAI1C;AAN0B;AAAA,EAO5B;AAAA,EAP4B;AAAA,EADV,OAAO;AAS3B;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}