@pattern-stack/codegen 0.20.1 → 0.20.2

package/CHANGELOG.md

@@ -4,6 +4,53 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.20.2] — 2026-06-06
+
+Two consumer-found fixes (dogfooding swe-brain on 0.20.1).
+
+### Fixed
+
+- **ADR-039 boot tick was lost to a module-init race.** `EventSchedulerLifecycle`
+  ran `materializeBoot()` from `onModuleInit`, which fires during the EVENTS
+  module's own init — BEFORE later modules (notably `BridgeModule`, whose
+  outbox-drain hook turns a scheduled event into `bridge_delivery` rows) finish
+  wiring. With `listenNotify` the boot row drained within ~3ms and was marked
+  `processed` with ZERO deliveries and no error (verified live: slot
+  `@schedule/reconcile_due/1780707600000` processed 3ms after materialisation,
+  zero `bridge_delivery` rows for `reconcile-poll#0`; the in-loop tick at the
+  next slot boundary delivered correctly — boot-only loss). **Fix:** the
+  lifecycle now defers to `onApplicationBootstrap` (fires after all modules'
+  `onModuleInit` + every hook is attached), so the boot tick drains against the
+  fully-wired pipeline. The tick interval start moved with it (both passes live
+  in `EventScheduler.start()`). Regression tests assert the hook surface is
+  `onApplicationBootstrap` (not `onModuleInit`) and that a boot-materialised
+  scheduled event reaches a subscriber attached after init.
+- **#473 — `subsystem install observability` never wired `ObservabilityModule`.**
+  The install added `observability` to `subsystems.install` but the barrel
+  emitter had no composer, so `ObservabilityModule.forRoot` was never emitted
+  into `SUBSYSTEM_MODULES` — consumers hand-wired it in `app.module.ts` (like
+  Auth). **Fix:** added an `observability` composer. It emits
+  `ObservabilityModule.forRoot()` (no `backend`/`multiTenant` — a combiner per
+  ADR-025 owns no durable state), imported package- or vendored-aware, and is
+  ordered LAST in `COMPOSABLE_ORDER` so its `forRoot` registers AFTER the
+  events/jobs/bridge/integration read ports it composes via `@Optional()` DI.
+  The `observability.reporters` block (OBS-6) is threaded into `forRoot` only
+  when a reporter is `enabled: true` (off-by-default, mirroring the
+  `listen_notify` / `differ` clauses); the default install stays a bare
+  `ObservabilityModule.forRoot()`. Closes #473.
+
+### Tests
+
+- `subsystem-barrel-generator` tests: observability composer coverage (both
+  modes, combiner ordering after the composed siblings, reporters threaded only
+  when enabled).
+- **Subsystems smoke now asserts forRoot presence per installed subsystem** (not
+  just events' `eventRegistry`) — it installs observability too and fails if the
+  real generated barrel is missing any installed subsystem's `forRoot` or if
+  observability isn't ordered after the read ports. Both gap classes (the
+  scheduler threading and the missing observability wiring) survived because
+  nothing end-to-end checked per-subsystem wiring.
+
 ## [0.20.1] — 2026-06-06
 
 **Fix: the subsystems barrel never threaded `eventRegistry` into

package/dist/{chunk-VNBC3VXM.js → chunk-3VEVGL74.js}

@@ -1,12 +1,12 @@
-import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
 import {
   clampLimit,
   decodeKeysetCursor,
   encodeKeysetCursor,
   toJobRunSummary
 } from "./chunk-L3LZWWSX.js";
+import {
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
@@ -198,4 +198,4 @@ DrizzleJobRunService = __decorateClass([
 export {
   DrizzleJobRunService
 };
-//# sourceMappingURL=chunk-VNBC3VXM.js.map
+//# sourceMappingURL=chunk-3VEVGL74.js.map

package/dist/{chunk-I6UXRJ3Q.js → chunk-43SBT72G.js}

@@ -1,9 +1,9 @@
-import {
-  WebhookChangeSource
-} from "./chunk-TIZXQU26.js";
 import {
   PollChangeSource
 } from "./chunk-4MF3HKJA.js";
+import {
+  WebhookChangeSource
+} from "./chunk-TIZXQU26.js";
 
 // runtime/subsystems/integration/build-change-source.ts
 function buildChangeSource(cfg, fetch, middlewares = []) {
@@ -26,4 +26,4 @@ function buildChangeSource(cfg, fetch, middlewares = []) {
 export {
   buildChangeSource
 };
-//# sourceMappingURL=chunk-I6UXRJ3Q.js.map
+//# sourceMappingURL=chunk-43SBT72G.js.map

package/dist/{chunk-BK5ICA2F.js → chunk-4MVGAMUA.js}

@@ -1,12 +1,12 @@
-import {
-  STORAGE
-} from "./chunk-NYBCQZC7.js";
 import {
   LocalStorageBackend
 } from "./chunk-JWNHNUYL.js";
 import {
   MemoryStorageBackend
 } from "./chunk-3SZFUTXE.js";
+import {
+  STORAGE
+} from "./chunk-NYBCQZC7.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -37,4 +37,4 @@ StorageModule = __decorateClass([
 export {
   StorageModule
 };
-//# sourceMappingURL=chunk-BK5ICA2F.js.map
+//# sourceMappingURL=chunk-4MVGAMUA.js.map

package/dist/{chunk-5RT7JGKT.js → chunk-7OVCARTQ.js}

@@ -4,14 +4,14 @@ import {
 import {
   JOB_ORCHESTRATOR
 } from "./chunk-ZPL74UQN.js";
+import {
+  EVENT_BUS
+} from "./chunk-H5NH7KPE.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MULTI_TENANT,
   BRIDGE_REGISTRY
 } from "./chunk-4LH67P4U.js";
-import {
-  EVENT_BUS
-} from "./chunk-H5NH7KPE.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -106,4 +106,4 @@ EventFlowService = __decorateClass([
 export {
   EventFlowService
 };
-//# sourceMappingURL=chunk-5RT7JGKT.js.map
+//# sourceMappingURL=chunk-7OVCARTQ.js.map

package/dist/{chunk-AJILKWGO.js → chunk-BKP72EDW.js}

@@ -1,29 +1,29 @@
+import {
+  DrizzleJobRunService
+} from "./chunk-3VEVGL74.js";
+import {
+  MemoryJobRunService
+} from "./chunk-CDLWYZVQ.js";
 import {
   DrizzleJobStepService
 } from "./chunk-DV4RV2DC.js";
+import {
+  BULLMQ_CONNECTION,
+  BULLMQ_RESOLVED_CONFIG,
+  resolveBullMqConfig
+} from "./chunk-I6MVCB5A.js";
 import {
   DrizzleJobOrchestrator
-} from "./chunk-MB5VVG4Z.js";
+} from "./chunk-E6PLM6QG.js";
 import {
   MemoryJobOrchestrator
-} from "./chunk-DUMI2J5M.js";
+} from "./chunk-VQOAATIG.js";
 import {
   MemoryJobStepService
 } from "./chunk-PNZSGAB2.js";
-import {
-  DrizzleJobRunService
-} from "./chunk-VNBC3VXM.js";
-import {
-  MemoryJobRunService
-} from "./chunk-BHZP6LOV.js";
 import {
   MemoryJobStore
 } from "./chunk-SNQ3TOWP.js";
-import {
-  BULLMQ_CONNECTION,
-  BULLMQ_RESOLVED_CONFIG,
-  resolveBullMqConfig
-} from "./chunk-I6MVCB5A.js";
 import {
   JOBS_LISTEN_NOTIFY,
   JOBS_MULTI_TENANT,
@@ -114,4 +114,4 @@ JobsDomainModule = __decorateClass([
 export {
   JobsDomainModule
 };
-//# sourceMappingURL=chunk-AJILKWGO.js.map
+//# sourceMappingURL=chunk-BKP72EDW.js.map

package/dist/{chunk-BHZP6LOV.js → chunk-CDLWYZVQ.js}

@@ -1,15 +1,15 @@
-import {
-  MemoryJobStore
-} from "./chunk-SNQ3TOWP.js";
-import {
-  MissingTenantIdError
-} from "./chunk-T4BIIU5E.js";
 import {
   clampLimit,
   decodeKeysetCursor,
   encodeKeysetCursor,
   toJobRunSummary
 } from "./chunk-L3LZWWSX.js";
+import {
+  MemoryJobStore
+} from "./chunk-SNQ3TOWP.js";
+import {
+  MissingTenantIdError
+} from "./chunk-T4BIIU5E.js";
 import {
   JOBS_MULTI_TENANT,
   JOB_ORCHESTRATOR
@@ -209,4 +209,4 @@ function compareBy(a, b, order) {
 export {
   MemoryJobRunService
 };
-//# sourceMappingURL=chunk-BHZP6LOV.js.map
+//# sourceMappingURL=chunk-CDLWYZVQ.js.map

package/dist/{chunk-W2UIDI3R.js → chunk-CLWBNXKF.js}

@@ -1,12 +1,12 @@
 import {
   JOB_RUN_SERVICE
 } from "./chunk-ZPL74UQN.js";
-import {
-  BRIDGE_DELIVERY_REPO
-} from "./chunk-4LH67P4U.js";
 import {
   EVENT_READ_PORT
 } from "./chunk-H5NH7KPE.js";
+import {
+  BRIDGE_DELIVERY_REPO
+} from "./chunk-4LH67P4U.js";
 import {
   INTEGRATION_CURSOR_STORE,
   INTEGRATION_RUN_RECORDER
@@ -181,4 +181,4 @@ ObservabilityService = __decorateClass([
 export {
   ObservabilityService
 };
-//# sourceMappingURL=chunk-W2UIDI3R.js.map
+//# sourceMappingURL=chunk-CLWBNXKF.js.map

package/dist/{chunk-SZYZ4SHF.js → chunk-D44QFQJZ.js}

@@ -1,13 +1,9 @@
 import {
   JobWorker
-} from "./chunk-P7EZCTIN.js";
+} from "./chunk-VDL5CJ5C.js";
 import {
   JobsDomainModule
-} from "./chunk-AJILKWGO.js";
-import {
-  BootValidationError,
-  ReservedPoolViolationError
-} from "./chunk-T4BIIU5E.js";
+} from "./chunk-BKP72EDW.js";
 import {
   BULLMQ_CONNECTION,
   BULLMQ_RESOLVED_CONFIG,
@@ -18,14 +14,18 @@ import {
   allPoolNames,
   loadPoolConfig
 } from "./chunk-RHVN6NA7.js";
+import {
+  BootValidationError,
+  ReservedPoolViolationError
+} from "./chunk-T4BIIU5E.js";
+import {
+  HandlerRegistry
+} from "./chunk-7P5ODGLA.js";
 import {
   JOB_ORCHESTRATOR,
   JOB_RUN_SERVICE,
   JOB_STEP_SERVICE
 } from "./chunk-ZPL74UQN.js";
-import {
-  HandlerRegistry
-} from "./chunk-7P5ODGLA.js";
 import {
   tokenKey
 } from "./chunk-GYGNEQSC.js";
@@ -290,4 +290,4 @@ export {
   JobWorkerOrchestrator,
   JobWorkerModule
 };
-//# sourceMappingURL=chunk-SZYZ4SHF.js.map
+//# sourceMappingURL=chunk-D44QFQJZ.js.map

package/dist/{chunk-HCAKMT64.js → chunk-DB5UXJC3.js}

@@ -1,22 +1,22 @@
+import {
+  clampEventLimit,
+  decodeEventCursor,
+  encodeEventCursor
+} from "./chunk-UQ5EHOH2.js";
 import {
   EVENTS_WAKE_CHANNEL,
   PgNotifyListener,
   pgNotify
 } from "./chunk-Q6LRJ4VI.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   BRIDGE_OUTBOX_DRAIN_HOOK
 } from "./chunk-4LH67P4U.js";
 import {
   domainEvents
 } from "./chunk-E2BRT5IB.js";
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
-import {
-  clampEventLimit,
-  decodeEventCursor,
-  encodeEventCursor
-} from "./chunk-UQ5EHOH2.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -460,4 +460,4 @@ DrizzleEventBus = __decorateClass([
 export {
   DrizzleEventBus
 };
-//# sourceMappingURL=chunk-HCAKMT64.js.map
+//# sourceMappingURL=chunk-DB5UXJC3.js.map

package/dist/{chunk-M3TIZGIB.js → chunk-E5FJWOMP.js}

@@ -1,22 +1,22 @@
 import {
   BRIDGE_DELIVERY_JOB_TYPE
-} from "./chunk-SGSWVNNB.js";
+} from "./chunk-R6F6KFIL.js";
 import {
   bridgeDelivery
 } from "./chunk-BORNCTH3.js";
-import {
-  JOBS_LISTEN_NOTIFY
-} from "./chunk-ZPL74UQN.js";
-import {
-  jobRuns
-} from "./chunk-OKXZ63IA.js";
 import {
   JOBS_WAKE_CHANNEL,
   pgNotify
 } from "./chunk-Q6LRJ4VI.js";
+import {
+  JOBS_LISTEN_NOTIFY
+} from "./chunk-ZPL74UQN.js";
 import {
   BRIDGE_REGISTRY
 } from "./chunk-4LH67P4U.js";
+import {
+  jobRuns
+} from "./chunk-OKXZ63IA.js";
 import {
   __decorateClass,
   __decorateParam
@@ -151,4 +151,4 @@ BridgeOutboxDrainHook = __decorateClass([
 export {
   BridgeOutboxDrainHook
 };
-//# sourceMappingURL=chunk-M3TIZGIB.js.map
+//# sourceMappingURL=chunk-E5FJWOMP.js.map

package/dist/{chunk-MB5VVG4Z.js → chunk-E6PLM6QG.js}

@@ -6,22 +6,22 @@ import {
   MissingTenantIdError
 } from "./chunk-T4BIIU5E.js";
 import {
-  JOBS_LISTEN_NOTIFY,
-  JOBS_MULTI_TENANT
-} from "./chunk-ZPL74UQN.js";
+  JOBS_WAKE_CHANNEL,
+  pgNotify
+} from "./chunk-Q6LRJ4VI.js";
 import {
   keySelectorToTemplate,
   resolveJobKey
 } from "./chunk-7P5ODGLA.js";
+import {
+  JOBS_LISTEN_NOTIFY,
+  JOBS_MULTI_TENANT
+} from "./chunk-ZPL74UQN.js";
 import {
   jobRuns,
   jobSteps,
   jobs
 } from "./chunk-OKXZ63IA.js";
-import {
-  JOBS_WAKE_CHANNEL,
-  pgNotify
-} from "./chunk-Q6LRJ4VI.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -393,4 +393,4 @@ export {
   evaluateKeyTemplate,
   DrizzleJobOrchestrator
 };
-//# sourceMappingURL=chunk-MB5VVG4Z.js.map
+//# sourceMappingURL=chunk-E6PLM6QG.js.map

package/dist/{chunk-YK5JEVLX.js → chunk-FFUDEIFF.js}

@@ -1,3 +1,8 @@
+import {
+  integrationRunItems,
+  integrationRuns,
+  integrationSubscriptions
+} from "./chunk-HNWZFNKP.js";
 import {
   FieldDiffSchema
 } from "./chunk-SQDOBLBP.js";
@@ -7,11 +12,6 @@ import {
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
-import {
-  integrationRunItems,
-  integrationRuns,
-  integrationSubscriptions
-} from "./chunk-HNWZFNKP.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -127,4 +127,4 @@ DrizzleIntegrationRunRecorder = __decorateClass([
 export {
   DrizzleIntegrationRunRecorder
 };
-//# sourceMappingURL=chunk-YK5JEVLX.js.map
+//# sourceMappingURL=chunk-FFUDEIFF.js.map

package/dist/{chunk-4OC5MSHO.js → chunk-GOO5ZMYO.js}

@@ -1,11 +1,11 @@
-import {
-  EVENTS_MODULE_OPTIONS
-} from "./chunk-H5NH7KPE.js";
 import {
   clampEventLimit,
   decodeEventCursor,
   encodeEventCursor
 } from "./chunk-UQ5EHOH2.js";
+import {
+  EVENTS_MODULE_OPTIONS
+} from "./chunk-H5NH7KPE.js";
 import {
   __decorateClass,
   __decorateParam
@@ -243,4 +243,4 @@ MemoryEventBus = __decorateClass([
 export {
   MemoryEventBus
 };
-//# sourceMappingURL=chunk-4OC5MSHO.js.map
+//# sourceMappingURL=chunk-GOO5ZMYO.js.map

package/dist/{chunk-CZQUOIDY.js → chunk-J7JMVS2B.js}

@@ -1,14 +1,14 @@
 import {
   CubeAnalyticsBackend
 } from "./chunk-7B3RYX45.js";
+import {
+  NoopAnalyticsBackend
+} from "./chunk-J37YWU7Y.js";
 import {
   ANALYTICS_QUERY,
   CUBE_API_SECRET,
   CUBE_API_URL
 } from "./chunk-6I7ULIN6.js";
-import {
-  NoopAnalyticsBackend
-} from "./chunk-J37YWU7Y.js";
 import {
   __decorateClass
 } from "./chunk-2E224ZSN.js";
@@ -50,4 +50,4 @@ AnalyticsModule = __decorateClass([
 export {
   AnalyticsModule
 };
-//# sourceMappingURL=chunk-CZQUOIDY.js.map
+//# sourceMappingURL=chunk-J7JMVS2B.js.map

package/dist/{chunk-T6SCOJF4.js → chunk-JGGZUP64.js}

@@ -1,9 +1,9 @@
-import {
-  EnvEncryptionKey
-} from "./chunk-IP4OO26U.js";
 import {
   AuthController
 } from "./chunk-SZVPIHWE.js";
+import {
+  EnvEncryptionKey
+} from "./chunk-IP4OO26U.js";
 import {
   DrizzleOAuthStateStore
 } from "./chunk-N5OTOWTP.js";
@@ -89,4 +89,4 @@ AuthModule = __decorateClass([
 export {
   AuthModule
 };
-//# sourceMappingURL=chunk-T6SCOJF4.js.map
+//# sourceMappingURL=chunk-JGGZUP64.js.map

package/dist/{chunk-VOYFPR3S.js → chunk-NR7QQ6ZI.js}

@@ -7,10 +7,10 @@ import {
 } from "./chunk-DUUCU77W.js";
 import {
   DrizzleEventBus
-} from "./chunk-HCAKMT64.js";
+} from "./chunk-DB5UXJC3.js";
 import {
   MemoryEventBus
-} from "./chunk-4OC5MSHO.js";
+} from "./chunk-GOO5ZMYO.js";
 import {
   EVENTS_MODULE_OPTIONS,
   EVENTS_MULTI_TENANT,
@@ -49,7 +49,7 @@ var EventSchedulerLifecycle = class {
   opts;
   logger = new Logger(EventSchedulerLifecycle.name);
   scheduler = null;
-  async onModuleInit() {
+  async onApplicationBootstrap() {
     const registry = this.opts?.eventRegistry;
     if (!registry) return;
     if (typeof this.bus.materializeScheduledEvent !== "function") return;
@@ -200,4 +200,4 @@ export {
   EventSchedulerLifecycle,
   EventsModule
 };
-//# sourceMappingURL=chunk-VOYFPR3S.js.map
+//# sourceMappingURL=chunk-NR7QQ6ZI.js.map

package/dist/chunk-NR7QQ6ZI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../runtime/subsystems/events/events.module.ts"],"sourcesContent":["/**\n * EventsModule — DynamicModule factory for the event bus subsystem.\n *\n * Register once in AppModule:\n * ```typescript\n * @Module({\n *   imports: [\n *     EventsModule.forRoot({ backend: 'drizzle' }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n *\n * Tests swap to the memory backend without touching application code:\n * ```typescript\n * Test.createTestingModule({\n *   imports: [EventsModule.forRoot({ backend: 'memory' })],\n * });\n * ```\n *\n * Per-pool drain isolation (EVT-4):\n * ```typescript\n * EventsModule.forRoot({ backend: 'drizzle', pools: ['events_change'] });\n * ```\n * Each process restricts its drain loop to the pools listed here. `pools`\n * is undefined by default → drain all pending rows (backwards-compatible).\n *\n * Typed facade + multi-tenancy (EVT-6):\n * - `TYPED_EVENT_BUS` resolves to the generated `TypedEventBus` wrapping\n *   whichever backend is selected.\n * - `multiTenant: true` makes `TypedEventBus.publish` throw\n *   `MissingTenantIdError` when the caller forgets `metadata.tenantId`.\n *\n * `global: true` means entity modules do not need to import EventsModule\n * individually — the EVENT_BUS and TYPED_EVENT_BUS tokens are available\n * project-wide.\n *\n * Async configuration (`forRootAsync`):\n * The async factory returns `EventsModuleOptions`; the EVENT_BUS provider\n * then receives its backend dependencies — DRIZZLE for the drizzle\n * backend, REDIS_URL for the redis backend, the resolved options for the\n * memory backend — through a proper `useFactory` so Nest DI wires them\n * correctly. Earlier revisions hand-constructed backends with\n * `new Class()` which silently left `db` / `redisUrl` undefined\n * (issue #108).\n */\nimport {\n  Inject,\n  Injectable,\n  Logger,\n  Module,\n  Optional,\n  type DynamicModule,\n  type OnApplicationBootstrap,\n  type OnModuleDestroy,\n  type Provider,\n  type Type,\n} from '@nestjs/common';\nimport {\n  EVENT_BUS,\n  EVENT_READ_PORT,\n  EVENTS_MODULE_OPTIONS,\n  EVENTS_MULTI_TENANT,\n  REDIS_URL,\n  TYPED_EVENT_BUS,\n} from './events.tokens';\nimport { DRIZZLE } from '../../constants/tokens';\nimport type { DrizzleClient } from '../../types/drizzle';\nimport { DrizzleEventBus } from './event-bus.drizzle-backend';\nimport { MemoryEventBus } from './event-bus.memory-backend';\nimport type { IEventBus } from './event-bus.protocol';\nimport {\n  EventScheduler,\n  scheduledEventsFromRegistry,\n  type RegistrySchedule,\n} from './event-scheduler';\n// #6 — `RedisEventBus` is lazy-loaded only when `backend: 'redis'` is selected.\n// The file is filtered out of the vendor set for non-redis installs (see\n// `backendFileFilter` in src/cli/commands/subsystem.ts); the dynamic-string\n// import below makes TS treat the specifier as `any` so the consumer's tsc\n// never tries to resolve the absent file.\nimport { TypedEventBus } from './generated/bus';\n\n/**\n * Lazy-load the Redis backend. Routed through a non-literal specifier so\n * the consumer's `tsc` doesn't resolve `./event-bus.redis-backend` at type\n * check time — important because that file is filtered out of drizzle/\n * memory installs (#6).\n */\nasync function loadRedisEventBus(): Promise<new (url: string) => object> {\n  // Non-literal specifier — TS gives this an `any` module type, sidestepping\n  // resolution of a file that may not be vendored.\n  const specifier = './event-bus.redis-backend';\n  const mod = (await import(specifier)) as { RedisEventBus: new (url: string) => object };\n  return mod.RedisEventBus;\n}\n\nexport interface EventsModuleOptions {\n  backend: 'drizzle' | 'memory' | 'redis';\n  /**\n   * Redis connection URL used when `backend` is `'redis'`.\n   * Falls back to the REDIS_URL environment variable, then\n   * `redis://localhost:6379` if neither is set.\n   */\n  redisUrl?: string;\n  /**\n   * Restrict the drain loop to these pools. Each pool name matches the\n   * `domain_events.pool` column (populated from `event.metadata.pool` at\n   * publish time). Leave undefined to drain all pending rows.\n   *\n   * Typical lane split: one process per `events_inbound` /\n   * `events_change` / `events_outbound` so a slow outbound handler\n   * cannot stall change-event propagation (see ADR-022).\n   */\n  pools?: string[];\n  /**\n   * LISTEN-NOTIFY-1 — when `true` (drizzle backend only), the drainer holds a\n   * dedicated listener connection and LISTENs on `codegen_events_wake`. Each\n   * `publish`/`publishMany` emits an in-tx `pg_notify(codegen_events_wake,\n   * <pool>)` so the drainer wakes the moment the publishing transaction commits,\n   * instead of waiting for the next poll tick. Polling continues unchanged as\n   * the fallback heartbeat; a lost notify degrades to poll latency, never to\n   * lost work. Defaults to `false`.\n   *\n   * Ignored by the memory + redis backends (memory dispatches inline; redis has\n   * its own fan-out). Requires a direct (non-transaction-pooler) connection —\n   * see the events/jobs config block re: PgBouncer.\n   */\n  listenNotify?: boolean;\n  /**\n   * Multi-tenancy opt-in (EVT-6).\n   *\n   * When `true`, every `TypedEventBus.publish()` call must supply\n   * `opts.metadata.tenantId` — otherwise it throws `MissingTenantIdError`.\n   * The tenantId is preserved on `event.metadata` and, for the Drizzle\n   * backend, written to `domain_events.tenant_id` (EVT-4).\n   *\n   * Drain-side tenant filtering is deferred — the tenant-context model\n   * (per-process vs. per-request vs. async-local-storage) is still\n   * unsettled; see ADR-024 §Multi-tenancy. Only the publish-side\n   * requirement ships here.\n   *\n   * Defaults to `false`.\n   */\n  multiTenant?: boolean;\n  /**\n   * The generated `TypedEventBus` class to bind to `TYPED_EVENT_BUS`.\n   *\n   * **Package mode (ADR-037).** When the runtime is imported from\n   * `@pattern-stack/codegen` (not vendored), the bundled `./generated/bus`\n   * `TypedEventBus` is typed to an EMPTY event union and reads the bundled\n   * empty `eventRegistry` — a consumer's `events/*.yaml` are scanned into\n   * `src/generated/events/bus.ts` (typed to THEIR union, reading THEIR\n   * registry), which the package can't import. The generated subsystem barrel\n   * therefore threads that class in here:\n   * `EventsModule.forRoot({ ..., typedBus: TypedEventBus })`. Nest constructs\n   * it with this module's `EVENT_BUS` + `EVENTS_MULTI_TENANT` providers (the\n   * generated class injects the same string-valued tokens, which match across\n   * the package boundary).\n   *\n   * Omitted (vendored mode / tests) ⇒ falls back to the bundled\n   * `./generated/bus`, which in a vendored tree IS the consumer's generated\n   * file. Without this, a package-mode consumer's typed `publish<'…'>()` calls\n   * resolve against the empty union and their events never get the right\n   * `pool` / `direction` stamped.\n   *\n   * Only consulted by `forRoot` (the path the barrel emits); `forRootAsync`\n   * keeps the bundled bus.\n   */\n  typedBus?: Type<unknown>;\n  /**\n   * ADR-039 — the consumer's generated `eventRegistry`, threaded so the\n   * `EventScheduler` can read the `schedule:` block + routing metadata of every\n   * scheduled event. Package mode: the generated subsystem barrel passes the\n   * consumer's `eventRegistry` (the bundled one is the package's empty/fixture\n   * registry, which the package can't see the consumer's events through — same\n   * reason `typedBus` is threaded). Omitted ⇒ no scheduler is spawned (vendored\n   * tree reads its own bundled registry only if the barrel passes it; tests\n   * pass a registry directly).\n   *\n   * Structural shape: each value needs `schedule?` + `direction` + `pool`. The\n   * generated `EventMetadata` satisfies it; typing it loosely here avoids a\n   * runtime dependency on the generated types from the module file.\n   */\n  eventRegistry?: Record<\n    string,\n    { schedule?: RegistrySchedule; direction: string | null; pool: string | null }\n  >;\n}\n\n/**\n * Lifecycle holder for the `EventScheduler` (ADR-039). Registered as a provider\n * on the drizzle/memory `forRoot` branches. Reads the scheduled-event set from\n * the threaded `eventRegistry` and starts the materialiser. No-op when nothing\n * declared `schedule:`, or under the redis backend (no outbox history).\n *\n * **Why `onApplicationBootstrap`, not `onModuleInit` (boot-tick race fix).**\n * `start()` runs `materializeBoot()`, which inserts the current slot's\n * `domain_events` row. With `listenNotify` enabled the outbox drain consumes\n * that row within milliseconds — so it MUST NOT run until every other module\n * has attached its outbox hooks. `onModuleInit` fires during the EVENTS\n * module's own init, BEFORE later modules (notably `BridgeModule`, which\n * attaches the bridge outbox-drain hook) finish initialising. The result was a\n * silent boot-only loss: the boot tick drained to `processed` with ZERO\n * `bridge_delivery` rows and no error (verified live in swe-brain on 0.20.1 —\n * slot `@schedule/reconcile_due/...` processed 3ms after materialisation, no\n * deliveries; the in-loop tick at the next slot delivered correctly).\n *\n * `onApplicationBootstrap` fires AFTER all modules' `onModuleInit` complete and\n * every hook is attached — the boot tick is then drained against the fully\n * wired pipeline. The tick interval starts here too (it lives inside `start()`,\n * and keeping both passes on the same hook keeps the boot/interval contract in\n * one place).\n */\n@Injectable()\nexport class EventSchedulerLifecycle implements OnApplicationBootstrap, OnModuleDestroy {\n  private readonly logger = new Logger(EventSchedulerLifecycle.name);\n  private scheduler: EventScheduler | null = null;\n\n  constructor(\n    @Inject(EVENT_BUS) private readonly bus: IEventBus,\n    @Optional()\n    @Inject(EVENTS_MODULE_OPTIONS)\n    private readonly opts: EventsModuleOptions | null = null,\n  ) {}\n\n  async onApplicationBootstrap(): Promise<void> {\n    const registry = this.opts?.eventRegistry;\n    if (!registry) return;\n    if (typeof this.bus.materializeScheduledEvent !== 'function') return; // redis\n    const schedules = scheduledEventsFromRegistry(registry);\n    if (schedules.length === 0) return;\n    this.scheduler = new EventScheduler(this.bus, schedules);\n    await this.scheduler.start();\n    this.logger.log(`EventScheduler wired for ${schedules.length} scheduled event(s).`);\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    if (this.scheduler) {\n      this.scheduler.stop();\n      this.scheduler = null;\n    }\n  }\n}\n\nexport interface EventsModuleAsyncOptions {\n  useFactory: (...args: unknown[]) => Promise<EventsModuleOptions> | EventsModuleOptions;\n  inject?: unknown[];\n  imports?: unknown[];\n}\n\n/**\n * Shared provider set: `TypedEventBus` itself, the `TYPED_EVENT_BUS` token\n * binding, and the resolved `EVENTS_MULTI_TENANT` flag. Returned from one\n * place so every `forRoot` branch and `forRootAsync` agree.\n */\nfunction buildTypedBusProviders(\n  multiTenant: boolean,\n  typedBus?: Type<unknown>,\n): Provider[] {\n  // Package mode threads the consumer's generated `TypedEventBus` (typed to\n  // their event union, reading their registry) via `typedBus`; vendored mode\n  // omits it and we fall back to the bundled `./generated/bus` (which IS the\n  // consumer's generated file in a vendored tree). See `EventsModuleOptions.typedBus`.\n  const BusClass = typedBus ?? TypedEventBus;\n  return [\n    BusClass,\n    { provide: TYPED_EVENT_BUS, useExisting: BusClass },\n    { provide: EVENTS_MULTI_TENANT, useValue: multiTenant },\n  ];\n}\n\n/**\n * Construct the backend instance for the async path, routing constructor\n * arguments through Nest-resolved dependencies.\n *\n * DRIZZLE is declared optional at inject time so that memory-backend\n * consumers aren't required to also import `DatabaseModule`. If the\n * drizzle backend is selected but no DRIZZLE provider is registered, we\n * throw a clear error instead of silently constructing a broken bus.\n */\nasync function buildEventBusAsync(\n  options: EventsModuleOptions,\n  db: DrizzleClient | null,\n  redisUrl: string,\n): Promise<unknown> {\n  if (options.backend === 'drizzle') {\n    if (!db) {\n      throw new Error(\n        \"EventsModule.forRootAsync: backend: 'drizzle' selected but DRIZZLE provider is not available. \" +\n          'Ensure DatabaseModule (or another provider exposing DRIZZLE) is imported before EventsModule.forRootAsync.',\n      );\n    }\n    return new DrizzleEventBus(db, options);\n  }\n  if (options.backend === 'redis') {\n    // #6: lazy import — the redis backend ships only with `--backend redis`\n    // installs; drizzle/memory consumers never touch the file.\n    const RedisEventBus = await loadRedisEventBus();\n    return new RedisEventBus(redisUrl);\n  }\n  return new MemoryEventBus(options);\n}\n\n@Module({})\nexport class EventsModule {\n  static forRootAsync(asyncOptions: EventsModuleAsyncOptions): DynamicModule {\n    return {\n      module: EventsModule,\n      global: true,\n      imports: (asyncOptions.imports ?? []) as Parameters<typeof Module>[0]['imports'],\n      providers: [\n        {\n          provide: EVENTS_MODULE_OPTIONS,\n          useFactory: asyncOptions.useFactory,\n          inject: (asyncOptions.inject ?? []) as (string | symbol | Function)[],\n        },\n        {\n          provide: EVENTS_MULTI_TENANT,\n          useFactory: (options: EventsModuleOptions) => options.multiTenant ?? false,\n          inject: [EVENTS_MODULE_OPTIONS],\n        },\n        {\n          provide: REDIS_URL,\n          useFactory: (options: EventsModuleOptions) =>\n            options.redisUrl ?? process.env['REDIS_URL'] ?? 'redis://localhost:6379',\n          inject: [EVENTS_MODULE_OPTIONS],\n        },\n        {\n          provide: EVENT_BUS,\n          useFactory: (\n            options: EventsModuleOptions,\n            db: DrizzleClient | null,\n            redisUrl: string,\n          ) => buildEventBusAsync(options, db, redisUrl),\n          inject: [\n            EVENTS_MODULE_OPTIONS,\n            { token: DRIZZLE, optional: true },\n            REDIS_URL,\n          ],\n        },\n        {\n          // Read port (OBS-LIST-1). Drizzle + memory backends implement\n          // IEventReadPort on the EVENT_BUS instance; the redis backend\n          // retains no history, so EVENT_READ_PORT resolves to `null` and\n          // optional consumers (the observability combiner) degrade to\n          // empty results.\n          provide: EVENT_READ_PORT,\n          useFactory: (options: EventsModuleOptions, bus: unknown) =>\n            options.backend === 'redis' ? null : bus,\n          inject: [EVENTS_MODULE_OPTIONS, EVENT_BUS],\n        },\n        TypedEventBus,\n        { provide: TYPED_EVENT_BUS, useExisting: TypedEventBus },\n      ],\n      exports: [EVENT_BUS, EVENT_READ_PORT, TYPED_EVENT_BUS, EVENTS_MULTI_TENANT],\n    };\n  }\n\n  static forRoot(\n    options: EventsModuleOptions = { backend: 'drizzle' },\n  ): DynamicModule {\n    const multiTenant = options.multiTenant ?? false;\n\n    if (options.backend === 'redis') {\n      const resolvedUrl =\n        options.redisUrl ?? process.env['REDIS_URL'] ?? 'redis://localhost:6379';\n\n      return {\n        module: EventsModule,\n        global: true,\n        providers: [\n          { provide: EVENTS_MODULE_OPTIONS, useValue: options },\n          { provide: REDIS_URL, useValue: resolvedUrl },\n          {\n            // #6: useFactory + dynamic import so the consumer's tsc never\n            // needs to resolve `event-bus.redis-backend.ts` for drizzle/\n            // memory installs (the file is filtered out by\n            // `backendFileFilter`). Nest awaits async factories + manages\n            // lifecycle on the returned instance, so we drop the old bare\n            // `RedisEventBus` provider entry.\n            provide: EVENT_BUS,\n            useFactory: async (url: string): Promise<object> => {\n              const RedisEventBus = await loadRedisEventBus();\n              return new RedisEventBus(url);\n            },\n            inject: [REDIS_URL],\n          },\n          ...buildTypedBusProviders(multiTenant, options.typedBus),\n        ],\n        exports: [EVENT_BUS, TYPED_EVENT_BUS, EVENTS_MULTI_TENANT],\n      };\n    }\n\n    const provider =\n      options.backend === 'drizzle'\n        ? { provide: EVENT_BUS, useClass: DrizzleEventBus }\n        : { provide: EVENT_BUS, useClass: MemoryEventBus };\n\n    return {\n      module: EventsModule,\n      global: true,\n      providers: [\n        { provide: EVENTS_MODULE_OPTIONS, useValue: options },\n        provider,\n        // Read port (OBS-LIST-1): drizzle + memory backends implement\n        // IEventReadPort on the same instance as EVENT_BUS. The redis\n        // backend retains no history and does not provide this token.\n        { provide: EVENT_READ_PORT, useExisting: EVENT_BUS },\n        // ADR-039 — the scheduler lifecycle. No-op unless `eventRegistry` was\n        // threaded AND some event declared `schedule:`. Drizzle/memory only\n        // (the redis branch above never reaches here).\n        EventSchedulerLifecycle,\n        ...buildTypedBusProviders(multiTenant, options.typedBus),\n      ],\n      exports: [EVENT_BUS, EVENT_READ_PORT, TYPED_EVENT_BUS, EVENTS_MULTI_TENANT],\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-XWBK3XJK.js → chunk-O2A6XHGD.js}

@@ -1,12 +1,12 @@
+import {
+  integrationSubscriptions
+} from "./chunk-HNWZFNKP.js";
 import {
   INTEGRATION_MULTI_TENANT
 } from "./chunk-S7C6TIIF.js";
 import {
   assertTenantId
 } from "./chunk-MZ6GV4YF.js";
-import {
-  integrationSubscriptions
-} from "./chunk-HNWZFNKP.js";
 import {
   DRIZZLE
 } from "./chunk-U64T4YZE.js";
@@ -97,4 +97,4 @@ PostgresCursorStore = __decorateClass([
 export {
   PostgresCursorStore
 };
-//# sourceMappingURL=chunk-XWBK3XJK.js.map
+//# sourceMappingURL=chunk-O2A6XHGD.js.map

package/dist/{chunk-ATVGYF3D.js → chunk-QFUIE37H.js}

@@ -1,12 +1,12 @@
 import {
   DrizzleIntegrationRunRecorder
-} from "./chunk-YK5JEVLX.js";
+} from "./chunk-FFUDEIFF.js";
 import {
   MemoryRunRecorder
 } from "./chunk-EO2QPOKH.js";
 import {
   PostgresCursorStore
-} from "./chunk-XWBK3XJK.js";
+} from "./chunk-O2A6XHGD.js";
 import {
   MemoryCursorStore
 } from "./chunk-AHV4GDYM.js";
@@ -84,4 +84,4 @@ IntegrationModule = __decorateClass([
 export {
   IntegrationModule
 };
-//# sourceMappingURL=chunk-ATVGYF3D.js.map
+//# sourceMappingURL=chunk-QFUIE37H.js.map

package/dist/{chunk-AODME4YK.js → chunk-QMN3LQR3.js}

@@ -1,30 +1,30 @@
 import {
   bridgeRegistry
 } from "./chunk-5A432NZJ.js";
+import {
+  BridgeOutboxDrainHook
+} from "./chunk-E5FJWOMP.js";
 import {
   EventFlowService
-} from "./chunk-5RT7JGKT.js";
+} from "./chunk-7OVCARTQ.js";
 import {
   BRIDGE_RESERVED_POOLS
 } from "./chunk-EDKJU5BO.js";
+import {
+  BridgeDeliveryHandler
+} from "./chunk-R6F6KFIL.js";
 import {
   DrizzleBridgeDeliveryRepo
 } from "./chunk-MVKW2BCR.js";
 import {
   MemoryBridgeDeliveryRepo
 } from "./chunk-4DOJBQTP.js";
-import {
-  BridgeOutboxDrainHook
-} from "./chunk-M3TIZGIB.js";
-import {
-  BridgeDeliveryHandler
-} from "./chunk-SGSWVNNB.js";
 import {
   BridgeReservedPoolsNotPolledError
 } from "./chunk-NXXDZ6ZF.js";
 import {
   JOB_WORKER_MODULE_OPTIONS
-} from "./chunk-SZYZ4SHF.js";
+} from "./chunk-D44QFQJZ.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MODULE_OPTIONS,
@@ -119,4 +119,4 @@ BridgeModule = __decorateClass([
 export {
   BridgeModule
 };
-//# sourceMappingURL=chunk-AODME4YK.js.map
+//# sourceMappingURL=chunk-QMN3LQR3.js.map