@pattern-stack/codegen 0.2.0

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

@@ -0,0 +1,531 @@
+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/events.module.ts
+import { Module } from "@nestjs/common";
+
+// runtime/subsystems/events/events.tokens.ts
+var EVENT_BUS = "EVENT_BUS";
+var REDIS_URL = /* @__PURE__ */ Symbol("REDIS_URL");
+
+// runtime/subsystems/events/event-bus.drizzle-backend.ts
+import { Injectable, Inject, Logger } from "@nestjs/common";
+import { eq, and, sql } from "drizzle-orm";
+
+// runtime/subsystems/events/domain-events.schema.ts
+import {
+  jsonb,
+  pgTable,
+  text,
+  timestamp,
+  uuid
+} from "drizzle-orm/pg-core";
+var domainEvents = pgTable(
+  "domain_events",
+  {
+    id: uuid("id").primaryKey(),
+    type: text("type").notNull(),
+    aggregateId: text("aggregate_id").notNull(),
+    aggregateType: text("aggregate_type").notNull(),
+    payload: jsonb("payload").notNull().$type(),
+    occurredAt: timestamp("occurred_at", { withTimezone: true }).notNull(),
+    processedAt: timestamp("processed_at", { withTimezone: true }),
+    /** Lifecycle status: pending | processed | failed */
+    status: text("status").notNull().default("pending"),
+    /** Error message from the last failed dispatch attempt. */
+    error: text("error"),
+    metadata: jsonb("metadata").$type()
+  }
+  // Indexes: add via migration when deploying
+  // - (status, occurred_at) for polling
+  // - (aggregate_id, aggregate_type) for replay
+);
+
+// runtime/constants/tokens.ts
+var DRIZZLE = "DRIZZLE";
+
+// runtime/subsystems/events/event-bus.drizzle-backend.ts
+var POLL_INTERVAL_MS = 1e3;
+var POLL_BATCH_SIZE = 50;
+var MAX_RETRIES = 3;
+var DrizzleEventBus = class {
+  constructor(db) {
+    this.db = db;
+  }
+  db;
+  logger = new Logger(DrizzleEventBus.name);
+  polling = false;
+  pollTimer = null;
+  handlers = /* @__PURE__ */ new Map();
+  // ============================================================================
+  // Lifecycle
+  // ============================================================================
+  async onModuleInit() {
+    this.polling = true;
+    this.schedulePoll();
+  }
+  async onModuleDestroy() {
+    this.polling = false;
+    if (this.pollTimer) {
+      clearTimeout(this.pollTimer);
+      this.pollTimer = null;
+    }
+  }
+  // ============================================================================
+  // IEventBus
+  // ============================================================================
+  async publish(event, tx) {
+    const client = tx ?? this.db;
+    await client.insert(domainEvents).values({
+      id: event.id,
+      type: event.type,
+      aggregateId: event.aggregateId,
+      aggregateType: event.aggregateType,
+      payload: event.payload,
+      occurredAt: event.occurredAt,
+      processedAt: null,
+      status: "pending",
+      metadata: event.metadata
+    });
+  }
+  async publishMany(events, tx) {
+    if (events.length === 0) return;
+    const client = tx ?? this.db;
+    await client.insert(domainEvents).values(
+      events.map((e) => ({
+        id: e.id,
+        type: e.type,
+        aggregateId: e.aggregateId,
+        aggregateType: e.aggregateType,
+        payload: e.payload,
+        occurredAt: e.occurredAt,
+        processedAt: null,
+        status: "pending",
+        metadata: e.metadata
+      }))
+    );
+  }
+  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);
+    };
+  }
+  // ============================================================================
+  // Polling
+  // ============================================================================
+  schedulePoll() {
+    if (!this.polling) return;
+    this.pollTimer = setTimeout(async () => {
+      try {
+        await this.processBatch();
+      } catch (err) {
+        this.logger.error(`Poll cycle error: ${err}`);
+      } finally {
+        this.schedulePoll();
+      }
+    }, POLL_INTERVAL_MS);
+  }
+  async processBatch() {
+    const rows = await this.db.transaction(async (tx) => {
+      return tx.execute(
+        sql`SELECT * FROM domain_events WHERE status = 'pending' ORDER BY occurred_at ASC LIMIT ${POLL_BATCH_SIZE} FOR UPDATE SKIP LOCKED`
+      );
+    }).then((result) => result.rows ?? result);
+    for (const row of rows) {
+      const event = {
+        id: row["id"],
+        type: row["type"],
+        aggregateId: row["aggregate_id"],
+        aggregateType: row["aggregate_type"],
+        payload: row["payload"],
+        occurredAt: new Date(row["occurred_at"]),
+        metadata: row["metadata"]
+      };
+      let attempt = 0;
+      let lastError;
+      while (attempt < MAX_RETRIES) {
+        try {
+          await this.dispatch(event);
+          await this.db.update(domainEvents).set({ status: "processed", processedAt: /* @__PURE__ */ new Date() }).where(eq(domainEvents.id, event.id));
+          lastError = void 0;
+          break;
+        } catch (err) {
+          lastError = err;
+          attempt++;
+        }
+      }
+      if (lastError !== void 0) {
+        const errorMessage = lastError instanceof Error ? lastError.message : String(lastError);
+        await this.db.update(domainEvents).set({ status: "failed", error: errorMessage }).where(and(eq(domainEvents.id, event.id), eq(domainEvents.status, "pending")));
+      }
+    }
+  }
+  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;
+    }
+  }
+};
+DrizzleEventBus = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(DRIZZLE))
+], DrizzleEventBus);
+
+// runtime/subsystems/events/event-bus.memory-backend.ts
+import { Injectable as Injectable2, Logger as Logger2 } from "@nestjs/common";
+var MemoryEventBus = class {
+  logger = new Logger2(MemoryEventBus.name);
+  /** All events published since construction (or last clear). */
+  publishedEvents = [];
+  handlers = /* @__PURE__ */ new Map();
+  async publish(event) {
+    this.publishedEvents.push(event);
+    await this.dispatch(event);
+  }
+  async publishMany(events) {
+    for (const event of events) {
+      await this.publish(event);
+    }
+  }
+  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);
+    };
+  }
+  /** Remove all published events and subscriptions. Useful in beforeEach. */
+  clear() {
+    this.publishedEvents.length = 0;
+    this.handlers.clear();
+  }
+  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([
+  Injectable2()
+], MemoryEventBus);
+
+// runtime/subsystems/events/event-bus.redis-backend.ts
+import { Injectable as Injectable3, Inject as Inject2, Logger as Logger3 } from "@nestjs/common";
+var CHANNEL_PREFIX = "events:";
+async function createRedisClient(url) {
+  let Redis;
+  try {
+    const mod = await import("ioredis");
+    Redis = mod.default ?? mod;
+  } catch {
+    throw new Error(
+      'RedisEventBus requires the "ioredis" package. Install it with: npm install ioredis'
+    );
+  }
+  return new Redis(url);
+}
+var RedisEventBus = class {
+  constructor(redisUrl) {
+    this.redisUrl = redisUrl;
+  }
+  redisUrl;
+  logger = new Logger3(RedisEventBus.name);
+  publisher = null;
+  subscriber = null;
+  connected = false;
+  /**
+   * In-process subscriber registry. Handlers registered here are called when
+   * a message arrives on the subscriber client — keeping fan-out within the
+   * same process without an extra round-trip through Redis.
+   */
+  handlers = /* @__PURE__ */ new Map();
+  /**
+   * Track which event types have active Redis subscriptions.
+   * Used to avoid subscribing multiple times to the same type channel.
+   */
+  subscribedTypes = /* @__PURE__ */ new Set();
+  // ============================================================================
+  // Lifecycle
+  // ============================================================================
+  async onModuleInit() {
+    this.publisher = await createRedisClient(this.redisUrl);
+    this.subscriber = await createRedisClient(this.redisUrl);
+    this.publisher.on(
+      "error",
+      (err) => this.logger.error(`Redis publisher error: ${err.message}`, err.stack)
+    );
+    this.subscriber.on(
+      "error",
+      (err) => this.logger.error(`Redis subscriber error: ${err.message}`, err.stack)
+    );
+    this.subscriber.on("message", (channel, message) => {
+      void this.handleMessage(channel, message);
+    });
+    this.connected = true;
+    this.logger.log(`RedisEventBus connected to ${this.redisUrl}`);
+  }
+  async onModuleDestroy() {
+    this.connected = false;
+    if (this.subscriber) {
+      await this.subscriber.unsubscribe();
+      this.subscriber.disconnect();
+      this.subscriber = null;
+    }
+    if (this.publisher) {
+      this.publisher.disconnect();
+      this.publisher = null;
+    }
+    this.subscribedTypes.clear();
+    this.logger.log("RedisEventBus disconnected");
+  }
+  // ============================================================================
+  // IEventBus
+  // ============================================================================
+  /**
+   * Publish a single event.
+   *
+   * `tx` is accepted but ignored — see module-level JSDoc for details.
+   */
+  async publish(event, tx) {
+    void tx;
+    this.assertConnected();
+    const payload = this.serialize(event);
+    const channel = `${CHANNEL_PREFIX}${event.type}`;
+    await this.publisher.publish(channel, payload);
+  }
+  /**
+   * Publish multiple events using a pipeline so all PUBLISH commands are sent
+   * in a single round-trip.
+   *
+   * `tx` is accepted but ignored — see module-level JSDoc for details.
+   */
+  async publishMany(events, tx) {
+    void tx;
+    if (events.length === 0) return;
+    this.assertConnected();
+    const pipeline = this.publisher.pipeline();
+    for (const event of events) {
+      const payload = this.serialize(event);
+      const channel = `${CHANNEL_PREFIX}${event.type}`;
+      pipeline.publish(channel, payload);
+    }
+    await pipeline.exec();
+  }
+  /**
+   * Register a handler for a specific event type.
+   * Returns an unsubscribe function — call it to remove the handler.
+   *
+   * On first handler for a type, subscribes to the per-type Redis channel.
+   * On removal of the last handler for a type, unsubscribes from the channel.
+   */
+  subscribe(eventType, handler) {
+    if (!this.handlers.has(eventType)) {
+      this.handlers.set(eventType, /* @__PURE__ */ new Set());
+      void this.subscribeToType(eventType);
+    }
+    const set = this.handlers.get(eventType);
+    const h = handler;
+    set.add(h);
+    return () => {
+      set.delete(h);
+      if (set.size === 0) {
+        this.handlers.delete(eventType);
+        void this.unsubscribeFromType(eventType);
+      }
+    };
+  }
+  // ============================================================================
+  // Internal helpers
+  // ============================================================================
+  assertConnected() {
+    if (!this.connected || !this.publisher) {
+      throw new Error(
+        "RedisEventBus is not connected. Ensure the module has been initialised before publishing."
+      );
+    }
+  }
+  serialize(event) {
+    return JSON.stringify({
+      ...event,
+      occurredAt: event.occurredAt.toISOString()
+    });
+  }
+  deserialize(raw) {
+    const parsed = JSON.parse(raw);
+    return {
+      ...parsed,
+      occurredAt: new Date(parsed.occurredAt)
+    };
+  }
+  async handleMessage(channel, message) {
+    let event;
+    try {
+      event = this.deserialize(message);
+    } catch (err) {
+      this.logger.warn(`Failed to deserialize event on channel "${channel}": ${err}`);
+      return;
+    }
+    await this.dispatch(event);
+  }
+  async dispatch(event) {
+    const set = this.handlers.get(event.type);
+    if (!set) return;
+    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}`
+        );
+      }
+    }
+  }
+  /**
+   * Subscribe to a per-type Redis channel.
+   * Called lazily when the first handler is registered for a type.
+   */
+  async subscribeToType(eventType) {
+    if (this.subscribedTypes.has(eventType)) {
+      return;
+    }
+    const channel = `${CHANNEL_PREFIX}${eventType}`;
+    try {
+      await this.subscriber.subscribe(channel);
+      this.subscribedTypes.add(eventType);
+    } catch (err) {
+      this.logger.error(`Failed to subscribe to channel "${channel}": ${err}`);
+    }
+  }
+  /**
+   * Unsubscribe from a per-type Redis channel.
+   * Called when the last handler for a type is removed.
+   */
+  async unsubscribeFromType(eventType) {
+    if (!this.subscribedTypes.has(eventType)) {
+      return;
+    }
+    const channel = `${CHANNEL_PREFIX}${eventType}`;
+    try {
+      await this.subscriber.unsubscribe(channel);
+      this.subscribedTypes.delete(eventType);
+    } catch (err) {
+      this.logger.error(`Failed to unsubscribe from channel "${channel}": ${err}`);
+    }
+  }
+};
+RedisEventBus = __decorateClass([
+  Injectable3(),
+  __decorateParam(0, Inject2(REDIS_URL))
+], RedisEventBus);
+
+// runtime/subsystems/events/events.module.ts
+var EventsModule = class {
+  static forRootAsync(asyncOptions) {
+    return {
+      module: EventsModule,
+      global: true,
+      imports: asyncOptions.imports ?? [],
+      providers: [
+        {
+          provide: "EVENTS_MODULE_OPTIONS",
+          useFactory: asyncOptions.useFactory,
+          inject: asyncOptions.inject ?? []
+        },
+        {
+          provide: EVENT_BUS,
+          useFactory: (options) => {
+            const mod = EventsModule.forRoot(options);
+            const provider = mod.providers?.find(
+              (p) => typeof p === "object" && p !== null && "provide" in p && p.provide === EVENT_BUS
+            );
+            if (provider && typeof provider === "object" && "useClass" in provider) {
+              return new provider.useClass();
+            }
+            throw new Error("EventsModule.forRootAsync: failed to resolve provider");
+          },
+          inject: ["EVENTS_MODULE_OPTIONS"]
+        }
+      ],
+      exports: [EVENT_BUS]
+    };
+  }
+  static forRoot(options = { backend: "drizzle" }) {
+    if (options.backend === "redis") {
+      const resolvedUrl = options.redisUrl ?? process.env["REDIS_URL"] ?? "redis://localhost:6379";
+      return {
+        module: EventsModule,
+        global: true,
+        providers: [
+          { provide: REDIS_URL, useValue: resolvedUrl },
+          { provide: EVENT_BUS, useClass: RedisEventBus },
+          // Register concrete class so NestJS can resolve lifecycle hooks
+          RedisEventBus
+        ],
+        exports: [EVENT_BUS]
+      };
+    }
+    const provider = options.backend === "drizzle" ? { provide: EVENT_BUS, useClass: DrizzleEventBus } : { provide: EVENT_BUS, useClass: MemoryEventBus };
+    return {
+      module: EventsModule,
+      global: true,
+      providers: [provider],
+      exports: [EVENT_BUS]
+    };
+  }
+};
+EventsModule = __decorateClass([
+  Module({})
+], EventsModule);
+export {
+  EventsModule
+};
+//# sourceMappingURL=events.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/events/events.module.ts","../../../../runtime/subsystems/events/events.tokens.ts","../../../../runtime/subsystems/events/event-bus.drizzle-backend.ts","../../../../runtime/subsystems/events/domain-events.schema.ts","../../../../runtime/constants/tokens.ts","../../../../runtime/subsystems/events/event-bus.memory-backend.ts","../../../../runtime/subsystems/events/event-bus.redis-backend.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 * `global: true` means entity modules do not need to import EventsModule\n * individually — the EVENT_BUS token is available project-wide.\n */\nimport { Module, type DynamicModule } from '@nestjs/common';\nimport { EVENT_BUS, REDIS_URL } from './events.tokens';\nimport { DrizzleEventBus } from './event-bus.drizzle-backend';\nimport { MemoryEventBus } from './event-bus.memory-backend';\nimport { RedisEventBus } from './event-bus.redis-backend';\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\nexport interface EventsModuleAsyncOptions {\n  useFactory: (...args: unknown[]) => Promise<EventsModuleOptions> | EventsModuleOptions;\n  inject?: unknown[];\n  imports?: unknown[];\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: EVENT_BUS,\n          useFactory: (options: EventsModuleOptions) => {\n            const mod = EventsModule.forRoot(options);\n            // Return the provider instance by delegating to forRoot's logic\n            const provider = mod.providers?.find(\n              (p) => typeof p === 'object' && p !== null && 'provide' in p && p.provide === EVENT_BUS,\n            );\n            if (provider && typeof provider === 'object' && 'useClass' in provider) {\n              return new (provider.useClass as new () => unknown)();\n            }\n            throw new Error('EventsModule.forRootAsync: failed to resolve provider');\n          },\n          inject: ['EVENTS_MODULE_OPTIONS'],\n        },\n      ],\n      exports: [EVENT_BUS],\n    };\n  }\n\n  static forRoot(\n    options: EventsModuleOptions = { backend: 'drizzle' },\n  ): DynamicModule {\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: REDIS_URL, useValue: resolvedUrl },\n          { provide: EVENT_BUS, useClass: RedisEventBus },\n          // Register concrete class so NestJS can resolve lifecycle hooks\n          RedisEventBus,\n        ],\n        exports: [EVENT_BUS],\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: [provider],\n      exports: [EVENT_BUS],\n    };\n  }\n}\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 */\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n\n/**\n * Injection token for the Redis connection URL used by RedisEventBus.\n * Provided automatically by EventsModule.forRoot({ backend: 'redis' }).\n */\nexport const REDIS_URL = Symbol('REDIS_URL');\n","/**\n * DrizzleEventBus — Postgres-backed event bus using the transactional outbox pattern.\n *\n * Events are inserted into the `domain_events` table within the caller's\n * Drizzle transaction. A background polling loop (started on module init)\n * reads unprocessed events and dispatches them to registered subscribers.\n *\n * When the transaction rolls back, the event is never persisted — no\n * phantom events.\n *\n * This backend is suitable until you need real-time fan-out or very high\n * throughput. At that point, swap the backend for Redis Streams or similar\n * via EventsModule.forRoot({ backend: '...' }) without touching use cases.\n */\nimport { Injectable, OnModuleDestroy, OnModuleInit, Inject, Logger } from '@nestjs/common';\nimport { eq, and, sql } from 'drizzle-orm';\nimport type { DomainEvent, DrizzleTransaction, IEventBus } from './event-bus.protocol';\nimport type { DrizzleClient } from '../../types/drizzle';\nimport { domainEvents } from './domain-events.schema';\nimport { DRIZZLE } from '../../constants/tokens';\n\n/** How long to wait between polling cycles (ms). */\nconst POLL_INTERVAL_MS = 1_000;\n/** Max events claimed per polling cycle to bound memory usage. */\nconst POLL_BATCH_SIZE = 50;\n/** Max processing attempts before marking an event failed. */\nconst MAX_RETRIES = 3;\n\n@Injectable()\nexport class DrizzleEventBus implements IEventBus, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(DrizzleEventBus.name);\n  private polling = false;\n  private pollTimer: ReturnType<typeof setTimeout> | null = null;\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n\n  constructor(@Inject(DRIZZLE) private readonly db: DrizzleClient) {}\n\n  // ============================================================================\n  // Lifecycle\n  // ============================================================================\n\n  async onModuleInit(): Promise<void> {\n    this.polling = true;\n    this.schedulePoll();\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.polling = false;\n    if (this.pollTimer) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n  }\n\n  // ============================================================================\n  // IEventBus\n  // ============================================================================\n\n  async publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void> {\n    const client = (tx ?? this.db) as DrizzleClient;\n    await client.insert(domainEvents).values({\n      id: event.id,\n      type: event.type,\n      aggregateId: event.aggregateId,\n      aggregateType: event.aggregateType,\n      payload: event.payload,\n      occurredAt: event.occurredAt,\n      processedAt: null,\n      status: 'pending',\n      metadata: event.metadata,\n    });\n  }\n\n  async publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void> {\n    if (events.length === 0) return;\n    const client = (tx ?? this.db) as DrizzleClient;\n    await client.insert(domainEvents).values(\n      events.map((e) => ({\n        id: e.id,\n        type: e.type,\n        aggregateId: e.aggregateId,\n        aggregateType: e.aggregateType,\n        payload: e.payload,\n        occurredAt: e.occurredAt,\n        processedAt: null,\n        status: 'pending' as const,\n        metadata: e.metadata,\n      })),\n    );\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    const set = this.handlers.get(eventType)!;\n    const h = handler as (event: DomainEvent) => Promise<void>;\n    set.add(h);\n    return () => {\n      set.delete(h);\n    };\n  }\n\n  // ============================================================================\n  // Polling\n  // ============================================================================\n\n  private schedulePoll(): void {\n    if (!this.polling) return;\n    this.pollTimer = setTimeout(async () => {\n      try {\n        await this.processBatch();\n      } catch (err) {\n        this.logger.error(`Poll cycle error: ${err}`);\n      } finally {\n        this.schedulePoll();\n      }\n    }, POLL_INTERVAL_MS);\n  }\n\n  private async processBatch(): Promise<void> {\n    // Fetch a batch of pending events with FOR UPDATE SKIP LOCKED to prevent\n    // double-processing when multiple instances are polling concurrently.\n    const rows = await this.db.transaction(async (tx) => {\n      return tx.execute(\n        sql`SELECT * FROM domain_events WHERE status = 'pending' ORDER BY occurred_at ASC LIMIT ${POLL_BATCH_SIZE} FOR UPDATE SKIP LOCKED`,\n      ) as Promise<{ rows: Record<string, unknown>[] }>;\n    }).then((result) => (result as unknown as { rows: Record<string, unknown>[] }).rows ?? result as unknown as Record<string, unknown>[]);\n\n    for (const row of rows) {\n      const event: DomainEvent = {\n        id: row['id'] as string,\n        type: row['type'] as string,\n        aggregateId: row['aggregate_id'] as string,\n        aggregateType: row['aggregate_type'] as string,\n        payload: row['payload'] as Record<string, unknown>,\n        occurredAt: new Date(row['occurred_at'] as string),\n        metadata: row['metadata'] as Record<string, unknown> | undefined,\n      };\n\n      let attempt = 0;\n      let lastError: unknown;\n      while (attempt < MAX_RETRIES) {\n        try {\n          await this.dispatch(event);\n          // Mark processed\n          await this.db\n            .update(domainEvents)\n            .set({ status: 'processed', processedAt: new Date() })\n            .where(eq(domainEvents.id, event.id));\n          lastError = undefined;\n          break;\n        } catch (err) {\n          lastError = err;\n          attempt++;\n        }\n      }\n\n      if (lastError !== undefined) {\n        const errorMessage = lastError instanceof Error ? lastError.message : String(lastError);\n        await this.db\n          .update(domainEvents)\n          .set({ status: 'failed', error: errorMessage })\n          .where(and(eq(domainEvents.id, event.id), eq(domainEvents.status, 'pending')));\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 * Drizzle schema for the domain_events outbox table.\n *\n * This table backs the DrizzleEventBus. Events are inserted within the\n * same database transaction as the domain write (outbox pattern). A\n * polling process reads unprocessed rows and dispatches to subscribers.\n *\n * Indexes:\n *   - (status, occurredAt) — polling query filter\n *   - (aggregateId, aggregateType) — event replay per aggregate\n */\nimport {\n  jsonb,\n  pgTable,\n  text,\n  timestamp,\n  uuid,\n} from 'drizzle-orm/pg-core';\nimport type { InferSelectModel } from 'drizzle-orm';\n\nexport const domainEvents = pgTable(\n  'domain_events',\n  {\n    id: uuid('id').primaryKey(),\n    type: text('type').notNull(),\n    aggregateId: text('aggregate_id').notNull(),\n    aggregateType: text('aggregate_type').notNull(),\n    payload: jsonb('payload').notNull().$type<Record<string, unknown>>(),\n    occurredAt: timestamp('occurred_at', { withTimezone: true }).notNull(),\n    processedAt: timestamp('processed_at', { withTimezone: true }),\n    /** Lifecycle status: pending | processed | failed */\n    status: text('status').notNull().default('pending'),\n    /** Error message from the last failed dispatch attempt. */\n    error: text('error'),\n    metadata: jsonb('metadata').$type<Record<string, unknown>>(),\n  },\n  // Indexes: add via migration when deploying\n  // - (status, occurred_at) for polling\n  // - (aggregate_id, aggregate_type) for replay\n);\n\nexport type DomainEventRecord = InferSelectModel<typeof domainEvents>;\n","/**\n * NestJS injection tokens\n *\n * Used with @Inject() decorator in concrete repository constructors.\n */\n\n/**\n * Injection token for the Drizzle ORM database client.\n *\n * Usage in concrete repositories:\n * ```typescript\n * constructor(@Inject(DRIZZLE) db: DrizzleClient) { super(db); }\n * ```\n */\nexport const DRIZZLE = 'DRIZZLE' as const;\n\n/**\n * Injection token for the event bus (IEventBus).\n *\n * Optional — only resolved when EventsModule.forRoot() is registered.\n * BaseService uses this with @Optional() to emit lifecycle events\n * without requiring the events subsystem to be installed.\n *\n * Usage in services/use cases:\n * ```typescript\n * @Optional() @Inject(EVENT_BUS) eventBus?: IEventBus\n * ```\n */\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n","/**\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 */\nimport { Injectable, Logger } from '@nestjs/common';\nimport type { DomainEvent, IEventBus } from './event-bus.protocol';\n\n@Injectable()\nexport class MemoryEventBus implements IEventBus {\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\n  async publish(event: DomainEvent): Promise<void> {\n    this.publishedEvents.push(event);\n    await this.dispatch(event);\n  }\n\n  async publishMany(events: DomainEvent[]): Promise<void> {\n    for (const event of events) {\n      await this.publish(event);\n    }\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  /** Remove all published events and subscriptions. Useful in beforeEach. */\n  clear(): void {\n    this.publishedEvents.length = 0;\n    this.handlers.clear();\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 * 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  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":["Injectable","Logger","Logger","Injectable","Injectable","Inject","Logger","Logger","Injectable","Inject"]}

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

@@ -0,0 +1,19 @@
+/**
+ * Injection token for the event bus.
+ *
+ * String constant (not Symbol) so it matches by value across import boundaries.
+ * Matches the token in runtime/constants/tokens.ts — both are 'EVENT_BUS'.
+ *
+ * Usage in use cases:
+ * ```typescript
+ * constructor(@Inject(EVENT_BUS) private readonly eventBus: IEventBus) {}
+ * ```
+ */
+declare const EVENT_BUS: "EVENT_BUS";
+/**
+ * Injection token for the Redis connection URL used by RedisEventBus.
+ * Provided automatically by EventsModule.forRoot({ backend: 'redis' }).
+ */
+declare const REDIS_URL: unique symbol;
+
+export { EVENT_BUS, REDIS_URL };

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

@@ -0,0 +1,8 @@
+// runtime/subsystems/events/events.tokens.ts
+var EVENT_BUS = "EVENT_BUS";
+var REDIS_URL = /* @__PURE__ */ Symbol("REDIS_URL");
+export {
+  EVENT_BUS,
+  REDIS_URL
+};
+//# sourceMappingURL=events.tokens.js.map

package/dist/runtime/subsystems/events/events.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/events/events.tokens.ts"],"sourcesContent":["/**\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 */\nexport const EVENT_BUS = 'EVENT_BUS' as const;\n\n/**\n * Injection token for the Redis connection URL used by RedisEventBus.\n * Provided automatically by EventsModule.forRoot({ backend: 'redis' }).\n */\nexport const REDIS_URL = Symbol('REDIS_URL');\n"],"mappings":";AAWO,IAAM,YAAY;AAMlB,IAAM,YAAY,uBAAO,WAAW;","names":[]}

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

@@ -0,0 +1,12 @@
+export { DomainEvent, DrizzleTransaction, IEventBus } from './event-bus.protocol.js';
+export { EVENT_BUS } from './events.tokens.js';
+export { EventsModule, EventsModuleOptions } from './events.module.js';
+export { MemoryEventBus } from './event-bus.memory-backend.js';
+export { DrizzleEventBus } from './event-bus.drizzle-backend.js';
+export { RedisEventBus } from './event-bus.redis-backend.js';
+export { DomainEventRecord, domainEvents } from './domain-events.schema.js';
+import '../../types/drizzle.js';
+import 'drizzle-orm/node-postgres';
+import '@nestjs/common';
+import 'drizzle-orm/pg-core';
+import 'drizzle-orm';