@pattern-stack/codegen 0.18.0 → 0.20.0

package/dist/runtime/subsystems/bridge/bridge.module.js

@@ -1,37 +1,37 @@
 import {
   BridgeModule
-} from "../../../chunk-YZLBU6O2.js";
+} from "../../../chunk-WKNOEVWQ.js";
 import "../../../chunk-5A432NZJ.js";
-import "../../../chunk-2VGVSL2D.js";
+import "../../../chunk-LQXBQO72.js";
 import "../../../chunk-5RT7JGKT.js";
 import "../../../chunk-EDKJU5BO.js";
-import "../../../chunk-TBGTMALE.js";
-import "../../../chunk-K2I6XIK5.js";
+import "../../../chunk-SGSWVNNB.js";
+import "../../../chunk-MVKW2BCR.js";
 import "../../../chunk-6DWFJNIK.js";
 import "../../../chunk-4DOJBQTP.js";
-import "../../../chunk-2TVVBC53.js";
 import "../../../chunk-NXXDZ6ZF.js";
-import "../../../chunk-X6BP6LI5.js";
-import "../../../chunk-C5E7H553.js";
-import "../../../chunk-EWYI5GGJ.js";
-import "../../../chunk-VQOAATIG.js";
-import "../../../chunk-PNZSGAB2.js";
-import "../../../chunk-3A34R6CI.js";
-import "../../../chunk-IN3EWFB4.js";
-import "../../../chunk-SNQ3TOWP.js";
+import "../../../chunk-BORNCTH3.js";
+import "../../../chunk-3YCUIGPG.js";
+import "../../../chunk-KBO5OOON.js";
+import "../../../chunk-NYJYK6J4.js";
+import "../../../chunk-5LXOJGO2.js";
+import "../../../chunk-QSJ3J4HE.js";
 import "../../../chunk-L3LZWWSX.js";
 import "../../../chunk-DV4RV2DC.js";
-import "../../../chunk-7MMS36AN.js";
-import "../../../chunk-T4BIIU5E.js";
 import "../../../chunk-I6MVCB5A.js";
 import "../../../chunk-RHVN6NA7.js";
-import "../../../chunk-7P5ODGLA.js";
+import "../../../chunk-CUSMC2KK.js";
 import "../../../chunk-OKXZ63IA.js";
+import "../../../chunk-FLYF76CU.js";
+import "../../../chunk-PNZSGAB2.js";
+import "../../../chunk-SNQ3TOWP.js";
 import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-T4BIIU5E.js";
+import "../../../chunk-7P5ODGLA.js";
 import "../../../chunk-4LH67P4U.js";
+import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-E2BRT5IB.js";
 import "../../../chunk-H5NH7KPE.js";
-import "../../../chunk-OFRRBC7M.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/bridge/index.js

@@ -1,10 +1,10 @@
 import {
   BridgeModule
-} from "../../../chunk-YZLBU6O2.js";
+} from "../../../chunk-WKNOEVWQ.js";
 import "../../../chunk-5A432NZJ.js";
 import {
   BridgeOutboxDrainHook
-} from "../../../chunk-2VGVSL2D.js";
+} from "../../../chunk-LQXBQO72.js";
 import {
   EventFlowService
 } from "../../../chunk-5RT7JGKT.js";
@@ -14,43 +14,42 @@ import {
 import {
   BRIDGE_DELIVERY_JOB_TYPE,
   BridgeDeliveryHandler
-} from "../../../chunk-TBGTMALE.js";
+} from "../../../chunk-SGSWVNNB.js";
 import {
   DrizzleBridgeDeliveryRepo
-} from "../../../chunk-K2I6XIK5.js";
+} from "../../../chunk-MVKW2BCR.js";
 import {
   assertTenantId
 } from "../../../chunk-6DWFJNIK.js";
 import {
   MemoryBridgeDeliveryRepo
 } from "../../../chunk-4DOJBQTP.js";
-import {
-  bridgeDelivery,
-  bridgeDeliveryStatusEnum
-} from "../../../chunk-2TVVBC53.js";
 import {
   BridgeReservedPoolsNotPolledError,
   MissingTenantIdError,
   UniqueConstraintError
 } from "../../../chunk-NXXDZ6ZF.js";
-import "../../../chunk-X6BP6LI5.js";
-import "../../../chunk-C5E7H553.js";
-import "../../../chunk-EWYI5GGJ.js";
-import "../../../chunk-VQOAATIG.js";
-import "../../../chunk-PNZSGAB2.js";
-import "../../../chunk-3A34R6CI.js";
-import "../../../chunk-IN3EWFB4.js";
-import "../../../chunk-SNQ3TOWP.js";
+import {
+  bridgeDelivery,
+  bridgeDeliveryStatusEnum
+} from "../../../chunk-BORNCTH3.js";
+import "../../../chunk-3YCUIGPG.js";
+import "../../../chunk-KBO5OOON.js";
+import "../../../chunk-NYJYK6J4.js";
+import "../../../chunk-5LXOJGO2.js";
+import "../../../chunk-QSJ3J4HE.js";
 import "../../../chunk-L3LZWWSX.js";
 import "../../../chunk-DV4RV2DC.js";
-import "../../../chunk-7MMS36AN.js";
-import "../../../chunk-T4BIIU5E.js";
 import "../../../chunk-I6MVCB5A.js";
 import "../../../chunk-RHVN6NA7.js";
-import "../../../chunk-7P5ODGLA.js";
+import "../../../chunk-CUSMC2KK.js";
 import "../../../chunk-OKXZ63IA.js";
+import "../../../chunk-FLYF76CU.js";
+import "../../../chunk-PNZSGAB2.js";
+import "../../../chunk-SNQ3TOWP.js";
 import "../../../chunk-ZPL74UQN.js";
-import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-T4BIIU5E.js";
+import "../../../chunk-7P5ODGLA.js";
 import {
   BRIDGE_DELIVERY_REPO,
   BRIDGE_MODULE_OPTIONS,
@@ -59,8 +58,9 @@ import {
   BRIDGE_REGISTRY,
   EVENT_FLOW
 } from "../../../chunk-4LH67P4U.js";
+import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-E2BRT5IB.js";
 import "../../../chunk-H5NH7KPE.js";
-import "../../../chunk-OFRRBC7M.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/cache/cache.drizzle-backend.js

@@ -1,10 +1,10 @@
 import {
   DrizzleCacheService
-} from "../../../chunk-T6C4LFLC.js";
-import "../../../chunk-FASRXRX5.js";
+} from "../../../chunk-7YGORYZD.js";
 import {
   CACHE_DEFAULT_TTL
 } from "../../../chunk-L6FTY45T.js";
+import "../../../chunk-FASRXRX5.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/cache/cache.module.js

@@ -1,10 +1,10 @@
 import {
   CacheModule
-} from "../../../chunk-COGHTKXY.js";
-import "../../../chunk-T6C4LFLC.js";
+} from "../../../chunk-27ETSJ2X.js";
+import "../../../chunk-7YGORYZD.js";
 import "../../../chunk-IF5I3DAA.js";
-import "../../../chunk-FASRXRX5.js";
 import "../../../chunk-L6FTY45T.js";
+import "../../../chunk-FASRXRX5.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/cache/index.js

@@ -1,20 +1,20 @@
 import "../../../chunk-IWAOY6KC.js";
 import {
   CacheModule
-} from "../../../chunk-COGHTKXY.js";
+} from "../../../chunk-27ETSJ2X.js";
 import {
   DrizzleCacheService
-} from "../../../chunk-T6C4LFLC.js";
+} from "../../../chunk-7YGORYZD.js";
 import {
   MemoryCacheService
 } from "../../../chunk-IF5I3DAA.js";
-import {
-  cacheEntries
-} from "../../../chunk-FASRXRX5.js";
 import {
   CACHE,
   CACHE_DEFAULT_TTL
 } from "../../../chunk-L6FTY45T.js";
+import {
+  cacheEntries
+} from "../../../chunk-FASRXRX5.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

package/dist/runtime/subsystems/events/domain-events.schema.js

@@ -1,6 +1,6 @@
 import {
   domainEvents
-} from "../../../chunk-OFRRBC7M.js";
+} from "../../../chunk-E2BRT5IB.js";
 import "../../../chunk-2E224ZSN.js";
 export {
   domainEvents

package/dist/runtime/subsystems/events/event-bus.drizzle-backend.d.ts

@@ -1,46 +1,16 @@
 import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
-import { IEventBus, DomainEvent, DrizzleTransaction } from './event-bus.protocol.js';
+import { IEventBus, DomainEvent, DrizzleTransaction, ScheduledEventSpec } from './event-bus.protocol.js';
 import { IEventReadPort, ListEventsQuery, EventPage } from './event-read.protocol.js';
 import { DrizzleClient } from '../../types/drizzle.js';
 import { EventsModuleOptions } from './events.module.js';
 import { IBridgeOutboxDrainHook } from '../bridge/bridge.protocol.js';
 import 'drizzle-orm/node-postgres';
+import './event-scheduler.js';
 import 'drizzle-orm';
 import './event-registry.js';
 import '../bridge/bridge-delivery.schema.js';
 import 'drizzle-orm/pg-core';
 
-/**
- * DrizzleEventBus — Postgres-backed event bus using the transactional outbox pattern.
- *
- * Events are inserted into the `domain_events` table within the caller's
- * Drizzle transaction. A background polling loop (started on module init)
- * reads unprocessed events and dispatches them to registered subscribers.
- *
- * When the transaction rolls back, the event is never persisted — no
- * phantom events.
- *
- * Pool awareness (EVT-4):
- * - On `publish`/`publishMany` the backend writes `metadata.pool`,
- *   `metadata.direction`, and `metadata.tenantId` into the first-class
- *   `pool` / `direction` / `tenant_id` columns (metadata JSON is still
- *   written unchanged for protocol stability).
- * - The drain loop filters by `opts.pools` when provided, so separate
- *   processes (e.g. one per `events_inbound` / `events_change` /
- *   `events_outbound`) can claim only their own lane. `pools: undefined`
- *   drains all pending rows (backwards-compatible behaviour).
- *
- * EVT-Q7: No stale-event sweeper. `FOR UPDATE SKIP LOCKED` is
- * self-healing — the row is only locked for the duration of the
- * enclosing polling transaction; the `status='processed'` update happens
- * within that same transaction. There is no `claimed_at` semantic (unlike
- * jobs), so no stale rows can exist.
- *
- * This backend is suitable until you need real-time fan-out or very high
- * throughput. At that point, swap the backend for Redis Streams or similar
- * via EventsModule.forRoot({ backend: '...' }) without touching use cases.
- */
-
 declare class DrizzleEventBus implements IEventBus, IEventReadPort, OnModuleInit, OnModuleDestroy {
     private readonly db;
     /**
@@ -99,6 +69,23 @@ declare class DrizzleEventBus implements IEventBus, IEventReadPort, OnModuleInit
     private emitWakeNotify;
     findById(eventId: string): Promise<DomainEvent | null>;
     subscribe<T extends DomainEvent = DomainEvent>(eventType: string, handler: (event: T) => Promise<void>): () => void;
+    /**
+     * Insert one scheduled tick event idempotently. The slot key is stamped onto
+     * `metadata.scheduleSlot`; `ON CONFLICT DO NOTHING` against the partial UNIQUE
+     * expression index `idx_domain_events_schedule_slot` makes a duplicate insert
+     * a no-op — the DB constraint is the exactly-one-event-per-slot invariant.
+     *
+     * Reuses the standard outbox row shape (pool/direction/metadata) so the
+     * existing drain carries the tick like any other event. A LISTEN/NOTIFY wake
+     * fires for an immediately-due tick (boot/catch-up rows whose slot is already
+     * in the past); a future slot is claimed by polling once `occurred_at` passes.
+     */
+    materializeScheduledEvent(spec: ScheduledEventSpec): Promise<{
+        created: boolean;
+    }>;
+    /** Most recent scheduled tick's `occurred_at` (epoch ms) for `type`, or null.
+     *  Read by the scheduler's catch-up backfill. */
+    lastScheduledSlotMs(type: string): Promise<number | null>;
     listEvents(query?: ListEventsQuery): Promise<EventPage>;
     /**
      * Test-only hook. Runs exactly one drain cycle and returns. Production

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

@@ -1,11 +1,11 @@
 import {
   DrizzleEventBus
-} from "../../../chunk-RKNW56RU.js";
-import "../../../chunk-Q6LRJ4VI.js";
+} from "../../../chunk-LARB26EI.js";
 import "../../../chunk-4LH67P4U.js";
+import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-E2BRT5IB.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-UQ5EHOH2.js";
-import "../../../chunk-OFRRBC7M.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";

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

@@ -1,9 +1,10 @@
-import { IEventBus, DomainEvent } from './event-bus.protocol.js';
+import { IEventBus, DomainEvent, ScheduledEventSpec } from './event-bus.protocol.js';
 import { IEventReadPort, ListEventsQuery, EventPage } from './event-read.protocol.js';
 import { EventsModuleOptions } from './events.module.js';
 import '../../types/drizzle.js';
 import 'drizzle-orm/node-postgres';
 import '@nestjs/common';
+import './event-scheduler.js';
 
 declare class MemoryEventBus implements IEventBus, IEventReadPort {
     private readonly logger;
@@ -15,6 +16,22 @@ declare class MemoryEventBus implements IEventBus, IEventReadPort {
     publish(event: DomainEvent): Promise<void>;
     publishMany(events: DomainEvent[]): Promise<void>;
     findById(eventId: string): Promise<DomainEvent | null>;
+    /** Slot keys already materialised — the in-memory mirror of the partial
+     *  UNIQUE expression index `idx_domain_events_schedule_slot`. */
+    private readonly materialisedSlots;
+    /**
+     * Mirror of the Drizzle `ON CONFLICT DO NOTHING` insert: emit one payload-free
+     * tick event per slot key, no-op if the slot was already materialised. The
+     * "constraint" is the `materialisedSlots` set. The tick is published through
+     * the normal `publish` path so subscribers fire synchronously (the memory bus
+     * has no future-slot/poll concept — a materialised slot dispatches now, which
+     * is the behaviour the unit suite pins).
+     */
+    materializeScheduledEvent(spec: ScheduledEventSpec): Promise<{
+        created: boolean;
+    }>;
+    /** Most recent scheduled tick's `occurred_at` (epoch ms) for `type`, or null. */
+    lastScheduledSlotMs(type: string): Promise<number | null>;
     subscribe<T extends DomainEvent = DomainEvent>(eventType: string, handler: (event: T) => Promise<void>): () => void;
     listEvents(query?: ListEventsQuery): Promise<EventPage>;
     /** Remove all published events and subscriptions. Useful in beforeEach. */

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

@@ -1,6 +1,6 @@
 import {
   MemoryEventBus
-} from "../../../chunk-LQ6PYFU6.js";
+} from "../../../chunk-4OC5MSHO.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-UQ5EHOH2.js";
 import "../../../chunk-GYGNEQSC.js";

package/dist/runtime/subsystems/events/event-bus.protocol.d.ts

@@ -65,6 +65,50 @@ interface IEventBus {
      *     of Redis backend is unsupported.
      */
     findById(eventId: string): Promise<DomainEvent | null>;
+    /**
+     * Materialise exactly one scheduled tick event (ADR-039 — time as an event
+     * source). Called by the framework `EventScheduler` on its boot + tick passes.
+     *
+     * The `slotKey` (`@schedule/<type>/<slotStartMs>`) is a pure function of
+     * (type, slot) — every instance computes the same key — and is stamped onto
+     * `metadata.scheduleSlot` (+ `metadata.triggerSource='schedule'`). The insert
+     * is deterministic and idempotent:
+     *   - Drizzle: `INSERT … ON CONFLICT DO NOTHING` against the partial UNIQUE
+     *     expression index on `(type, metadata->>'scheduleSlot')`. The DB
+     *     constraint — not a read, not a lock — is the exactly-one-event-per-slot
+     *     invariant across multi-instance deploys and boot/tick races.
+     *   - Memory: a slot-key marker set mirrors the constraint.
+     *
+     * Returns `created: false` when the slot event already existed (the no-op
+     * case). Optional on the protocol — only the scheduler calls it, and the
+     * Redis backend (no outbox history) does not implement it (the scheduler is
+     * drizzle/memory only).
+     */
+    materializeScheduledEvent?(spec: ScheduledEventSpec): Promise<{
+        created: boolean;
+    }>;
+    /**
+     * Optional (ADR-039) — `occurred_at` (epoch ms) of the most recent scheduled
+     * tick for `type`, or `null`. Read by the scheduler's catch-up backfill as
+     * `MAX(occurred_at) WHERE type=? AND metadata->>'triggerSource'='schedule'`.
+     */
+    lastScheduledSlotMs?(type: string): Promise<number | null>;
+}
+/**
+ * The fully-resolved shape the scheduler hands a backend to materialise one
+ * tick. Carries the routing fields the outbox row needs (direction/pool from
+ * the event's registry metadata) plus the slot key + boundary.
+ */
+interface ScheduledEventSpec {
+    type: string;
+    /** `@schedule/<type>/<slotStartMs>` — the idempotency key. */
+    slotKey: string;
+    /** Slot boundary → the event's `occurred_at`. */
+    slotStart: Date;
+    /** `inbound | change | outbound` from the event's registry metadata. */
+    direction: string;
+    /** `events_inbound | events_change | events_outbound` from the registry. */
+    pool: string;
 }
 
-export type { DomainEvent, DrizzleTransaction, IEventBus };
+export type { DomainEvent, DrizzleTransaction, IEventBus, ScheduledEventSpec };

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

@@ -0,0 +1,96 @@
+import { IEventBus } from './event-bus.protocol.js';
+import '../../types/drizzle.js';
+import 'drizzle-orm/node-postgres';
+
+/**
+ * Parse a `schedule.every` into milliseconds. Accepts a positive number (ms) or
+ * a duration string `<number><unit>` (unit ∈ ms|s|m|h|d; decimals allowed).
+ * Throws `ScheduleConfigError` synchronously on anything unparseable, ≤0, or
+ * non-finite — so a bad schedule surfaces at boot before the tick loop starts.
+ */
+declare function parseEvery(every: string | number, eventType?: string): number;
+/**
+ * The start of the slot containing `atMs`, for a schedule of `everyMs`.
+ *   - `align: true` (default) — epoch-anchored: `floor(at / every) * every`.
+ *   - `align: false` — anchored to `anchorMs` (the scheduler's first-run time).
+ */
+declare function slotStartFor(atMs: number, everyMs: number, align: boolean, anchorMs: number): number;
+/** The start of the slot AFTER the one containing `atMs`. */
+declare function nextSlotStart(atMs: number, everyMs: number, align: boolean, anchorMs: number): number;
+/** Prefix every scheduler-materialised `metadata.scheduleSlot` carries — the
+ *  partial UNIQUE index is scoped to non-null slot keys; this prefix keeps the
+ *  key namespace unambiguous and greppable. */
+declare const SCHEDULE_KEY_PREFIX = "@schedule/";
+/** Deterministic slot key. Pure function of (type, slotStart) — every instance
+ *  computes the same value, which is what makes the idempotent insert
+ *  exactly-once. */
+declare function slotKeyFor(type: string, slotStartMs: number): string;
+/** Below this floor (== the default outbox poll interval) materialise/drain
+ *  latency dominates the cadence; allowed but warned once at boot. */
+declare const SCHEDULE_FLOOR_MS = 1000;
+/** One scheduled event the scheduler will materialise. Built from the generated
+ *  event registry (`schedule` block + direction/pool routing metadata). */
+interface ScheduledEvent {
+    type: string;
+    everyMs: number;
+    align: boolean;
+    catchUp: boolean;
+    maxCatchUpSlots: number;
+    /** Routing — from the event's registry metadata (a scheduled event is
+     *  domain-tier, so both are always present). */
+    direction: string;
+    pool: string;
+}
+/** The raw `schedule` block as it appears in the generated registry entry. */
+interface RegistrySchedule {
+    every: string | number;
+    align?: boolean;
+    catchUp?: boolean;
+    maxCatchUpSlots?: number;
+}
+/** Validate + normalise one registry entry's `schedule` into a `ScheduledEvent`.
+ *  Throws `ScheduleConfigError` on a malformed `every` (boot backstop — codegen
+ *  already validated, this catches hand-edits / version skew). */
+declare function resolveScheduledEvent(type: string, schedule: RegistrySchedule, direction: string | null, pool: string | null): ScheduledEvent;
+/**
+ * Read the scheduled-event set from a generated `eventRegistry`. The registry
+ * value shape is structural (`{ schedule?, direction, pool }`) so this stays
+ * decoupled from the generated `EventMetadata` type. Returns `[]` when nothing
+ * declared `schedule:`.
+ */
+declare function scheduledEventsFromRegistry(registry: Record<string, {
+    schedule?: RegistrySchedule;
+    direction: string | null;
+    pool: string | null;
+}>): ScheduledEvent[];
+interface EventSchedulerOptions {
+    /** Tick cadence (ms). Default = smallest scheduled `every`, floored. Test override. */
+    tickIntervalMs?: number;
+    /** Injectable clock for deterministic tests. Default `Date.now`. */
+    now?: () => number;
+}
+declare class EventScheduler {
+    private readonly bus;
+    private readonly schedules;
+    private readonly logger;
+    private readonly now;
+    private timer;
+    private readonly anchorMs;
+    private readonly tickIntervalMs;
+    constructor(bus: IEventBus, schedules: ReadonlyArray<ScheduledEvent>, opts?: EventSchedulerOptions);
+    /** Reconcile-on-boot, then start the tick interval. Idempotent. */
+    start(): Promise<void>;
+    /** Stop the tick interval. Idempotent. */
+    stop(): void;
+    /** Boot pass — materialise the current slot (or bounded backfill) per event. */
+    materializeBoot(): Promise<void>;
+    /** Tick pass — materialise the current + next slot per event (current covers a
+     *  tick landing in a fresh slot the boot pass missed). */
+    materializeTick(): Promise<void>;
+    private materializeOne;
+    /** Backfill missed slots from the last emitted slot to the current one,
+     *  bounded by `maxCatchUpSlots`. */
+    private backfill;
+}
+
+export { EventScheduler, type EventSchedulerOptions, type RegistrySchedule, SCHEDULE_FLOOR_MS, SCHEDULE_KEY_PREFIX, type ScheduledEvent, nextSlotStart, parseEvery, resolveScheduledEvent, scheduledEventsFromRegistry, slotKeyFor, slotStartFor };

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

@@ -0,0 +1,25 @@
+import {
+  EventScheduler,
+  SCHEDULE_FLOOR_MS,
+  SCHEDULE_KEY_PREFIX,
+  nextSlotStart,
+  parseEvery,
+  resolveScheduledEvent,
+  scheduledEventsFromRegistry,
+  slotKeyFor,
+  slotStartFor
+} from "../../../chunk-DUUCU77W.js";
+import "../../../chunk-DUBZOXJC.js";
+import "../../../chunk-2E224ZSN.js";
+export {
+  EventScheduler,
+  SCHEDULE_FLOOR_MS,
+  SCHEDULE_KEY_PREFIX,
+  nextSlotStart,
+  parseEvery,
+  resolveScheduledEvent,
+  scheduledEventsFromRegistry,
+  slotKeyFor,
+  slotStartFor
+};
+//# sourceMappingURL=event-scheduler.js.map

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

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

package/dist/runtime/subsystems/events/events-errors.d.ts

@@ -21,5 +21,16 @@ declare class MissingTenantIdError extends Error {
     readonly name = "MissingTenantIdError";
     constructor(eventType: string);
 }
+/**
+ * Thrown (ADR-039) when a scheduled event's `schedule` config is invalid at
+ * runtime — a malformed `schedule.every` duration, or a scheduled event with no
+ * direction/pool to route by. Codegen validates `schedule` at `gen-all` time;
+ * this is the boot backstop for a hand-edited registry or version skew. Raised
+ * by `EventScheduler` construction / `parseEvery`.
+ */
+declare class ScheduleConfigError extends Error {
+    readonly name = "ScheduleConfigError";
+    constructor(message: string);
+}
 
-export { MissingTenantIdError };
+export { MissingTenantIdError, ScheduleConfigError };

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

@@ -1,8 +1,10 @@
 import {
-  MissingTenantIdError
-} from "../../../chunk-V4AF6DI4.js";
+  MissingTenantIdError,
+  ScheduleConfigError
+} from "../../../chunk-DUBZOXJC.js";
 import "../../../chunk-2E224ZSN.js";
 export {
-  MissingTenantIdError
+  MissingTenantIdError,
+  ScheduleConfigError
 };
 //# sourceMappingURL=events-errors.js.map

package/dist/runtime/subsystems/events/events.module.d.ts

@@ -1,4 +1,8 @@
-import { Type, DynamicModule } from '@nestjs/common';
+import { Type, OnModuleInit, OnModuleDestroy, DynamicModule } from '@nestjs/common';
+import { IEventBus } from './event-bus.protocol.js';
+import { RegistrySchedule } from './event-scheduler.js';
+import '../../types/drizzle.js';
+import 'drizzle-orm/node-postgres';
 
 /**
  * EventsModule — DynamicModule factory for the event bus subsystem.
@@ -120,6 +124,41 @@ interface EventsModuleOptions {
      * keeps the bundled bus.
      */
     typedBus?: Type<unknown>;
+    /**
+     * ADR-039 — the consumer's generated `eventRegistry`, threaded so the
+     * `EventScheduler` can read the `schedule:` block + routing metadata of every
+     * scheduled event. Package mode: the generated subsystem barrel passes the
+     * consumer's `eventRegistry` (the bundled one is the package's empty/fixture
+     * registry, which the package can't see the consumer's events through — same
+     * reason `typedBus` is threaded). Omitted ⇒ no scheduler is spawned (vendored
+     * tree reads its own bundled registry only if the barrel passes it; tests
+     * pass a registry directly).
+     *
+     * Structural shape: each value needs `schedule?` + `direction` + `pool`. The
+     * generated `EventMetadata` satisfies it; typing it loosely here avoids a
+     * runtime dependency on the generated types from the module file.
+     */
+    eventRegistry?: Record<string, {
+        schedule?: RegistrySchedule;
+        direction: string | null;
+        pool: string | null;
+    }>;
+}
+/**
+ * Lifecycle holder for the `EventScheduler` (ADR-039). Registered as a provider
+ * on the drizzle/memory `forRoot` branches; Nest drives `onModuleInit` (after
+ * the bus is constructed) and `onModuleDestroy`. Reads the scheduled-event set
+ * from the threaded `eventRegistry` and starts the materialiser. No-op when
+ * nothing declared `schedule:`, or under the redis backend (no outbox history).
+ */
+declare class EventSchedulerLifecycle implements OnModuleInit, OnModuleDestroy {
+    private readonly bus;
+    private readonly opts;
+    private readonly logger;
+    private scheduler;
+    constructor(bus: IEventBus, opts?: EventsModuleOptions | null);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
 }
 interface EventsModuleAsyncOptions {
     useFactory: (...args: unknown[]) => Promise<EventsModuleOptions> | EventsModuleOptions;
@@ -131,4 +170,4 @@ declare class EventsModule {
     static forRoot(options?: EventsModuleOptions): DynamicModule;
 }
 
-export { EventsModule, type EventsModuleAsyncOptions, type EventsModuleOptions };
+export { EventSchedulerLifecycle, EventsModule, type EventsModuleAsyncOptions, type EventsModuleOptions };

package/dist/runtime/subsystems/events/events.module.js

@@ -1,21 +1,24 @@
 import {
+  EventSchedulerLifecycle,
   EventsModule
-} from "../../../chunk-R4BPUUB5.js";
-import "../../../chunk-VHAR2BGH.js";
-import "../../../chunk-BGULBWKJ.js";
+} from "../../../chunk-KHQ72A5F.js";
+import "../../../chunk-INO47JXD.js";
+import "../../../chunk-JOBQ6RUU.js";
 import "../../../chunk-JRQO2IOF.js";
-import "../../../chunk-RKNW56RU.js";
-import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-DUUCU77W.js";
+import "../../../chunk-DUBZOXJC.js";
+import "../../../chunk-LARB26EI.js";
 import "../../../chunk-4LH67P4U.js";
-import "../../../chunk-LQ6PYFU6.js";
+import "../../../chunk-Q6LRJ4VI.js";
+import "../../../chunk-E2BRT5IB.js";
+import "../../../chunk-4OC5MSHO.js";
 import "../../../chunk-H5NH7KPE.js";
 import "../../../chunk-UQ5EHOH2.js";
-import "../../../chunk-V4AF6DI4.js";
-import "../../../chunk-OFRRBC7M.js";
 import "../../../chunk-GYGNEQSC.js";
 import "../../../chunk-U64T4YZE.js";
 import "../../../chunk-2E224ZSN.js";
 export {
+  EventSchedulerLifecycle,
   EventsModule
 };
 //# sourceMappingURL=events.module.js.map