@pattern-stack/codegen 0.2.0

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

@@ -0,0 +1,95 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { IEventBus, DomainEvent, DrizzleTransaction } from './event-bus.protocol.js';
+import '../../types/drizzle.js';
+import 'drizzle-orm/node-postgres';
+
+/**
+ * RedisEventBus — Redis Pub/Sub backend for the event bus.
+ *
+ * Publishes events to Redis channels and dispatches incoming messages to
+ * registered in-process subscribers. Events are serialized as JSON strings.
+ *
+ * Channel naming:
+ *   - Per-type channel:  events:{event.type}   (e.g. events:contact_created)
+ *   - Catch-all channel: events:*
+ *
+ * Transactional semantics:
+ *   The `tx` parameter (Drizzle transaction) is accepted to satisfy the
+ *   IEventBus interface but has no effect — Redis Pub/Sub is not transactional.
+ *   Events published with a `tx` argument are dispatched immediately without
+ *   waiting for the surrounding transaction to commit. If you need
+ *   at-least-once delivery tied to a database transaction, use DrizzleEventBus.
+ *
+ * Connection model:
+ *   ioredis requires a dedicated connection for subscribers (a client in
+ *   subscribe mode cannot issue regular commands). This backend creates two
+ *   clients: one for publishing (`publisher`) and one for subscribing
+ *   (`subscriber`). Both are connected on module init and disconnected on
+ *   module destroy.
+ *
+ * Usage:
+ *   EventsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })
+ *
+ * Requires `ioredis` — install it separately if you use this backend:
+ *   npm install ioredis   /   bun add ioredis
+ */
+
+declare class RedisEventBus implements IEventBus, OnModuleInit, OnModuleDestroy {
+    private readonly redisUrl;
+    private readonly logger;
+    private publisher;
+    private subscriber;
+    private connected;
+    /**
+     * 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.
+     */
+    private readonly handlers;
+    /**
+     * Track which event types have active Redis subscriptions.
+     * Used to avoid subscribing multiple times to the same type channel.
+     */
+    private readonly subscribedTypes;
+    constructor(redisUrl: string);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Publish a single event.
+     *
+     * `tx` is accepted but ignored — see module-level JSDoc for details.
+     */
+    publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void>;
+    /**
+     * 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.
+     */
+    publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void>;
+    /**
+     * 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<T extends DomainEvent = DomainEvent>(eventType: string, handler: (event: T) => Promise<void>): () => void;
+    private assertConnected;
+    private serialize;
+    private deserialize;
+    private handleMessage;
+    private dispatch;
+    /**
+     * Subscribe to a per-type Redis channel.
+     * Called lazily when the first handler is registered for a type.
+     */
+    private subscribeToType;
+    /**
+     * Unsubscribe from a per-type Redis channel.
+     * Called when the last handler for a type is removed.
+     */
+    private unsubscribeFromType;
+}
+
+export { RedisEventBus };

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

@@ -0,0 +1,229 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// runtime/subsystems/events/event-bus.redis-backend.ts
+import { Injectable, Inject, Logger } from "@nestjs/common";
+
+// runtime/subsystems/events/events.tokens.ts
+var REDIS_URL = /* @__PURE__ */ Symbol("REDIS_URL");
+
+// runtime/subsystems/events/event-bus.redis-backend.ts
+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 Logger(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([
+  Injectable(),
+  __decorateParam(0, Inject(REDIS_URL))
+], RedisEventBus);
+export {
+  RedisEventBus
+};
+//# sourceMappingURL=event-bus.redis-backend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/events/event-bus.redis-backend.ts","../../../../runtime/subsystems/events/events.tokens.ts"],"sourcesContent":["/**\n * RedisEventBus — Redis Pub/Sub backend for the event bus.\n *\n * Publishes events to Redis channels and dispatches incoming messages to\n * registered in-process subscribers. Events are serialized as JSON strings.\n *\n * Channel naming:\n *   - Per-type channel:  events:{event.type}   (e.g. events:contact_created)\n *   - Catch-all channel: events:*\n *\n * Transactional semantics:\n *   The `tx` parameter (Drizzle transaction) is accepted to satisfy the\n *   IEventBus interface but has no effect — Redis Pub/Sub is not transactional.\n *   Events published with a `tx` argument are dispatched immediately without\n *   waiting for the surrounding transaction to commit. If you need\n *   at-least-once delivery tied to a database transaction, use DrizzleEventBus.\n *\n * Connection model:\n *   ioredis requires a dedicated connection for subscribers (a client in\n *   subscribe mode cannot issue regular commands). This backend creates two\n *   clients: one for publishing (`publisher`) and one for subscribing\n *   (`subscriber`). Both are connected on module init and disconnected on\n *   module destroy.\n *\n * Usage:\n *   EventsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })\n *\n * Requires `ioredis` — install it separately if you use this backend:\n *   npm install ioredis   /   bun add ioredis\n */\nimport { Injectable, OnModuleInit, OnModuleDestroy, Inject, Logger } from '@nestjs/common';\nimport type { DomainEvent, DrizzleTransaction, IEventBus } from './event-bus.protocol';\nimport { REDIS_URL } from './events.tokens';\n\n/** Redis channel prefix for all domain events. */\nconst CHANNEL_PREFIX = 'events:';\n/** Catch-all channel that receives every published event. */\nconst WILDCARD_CHANNEL = 'events:*';\n\n// ioredis is an optional peer dependency; import lazily so consumers who do\n// not use this backend do not need it on their classpath.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype RedisClient = any;\n\nasync function createRedisClient(url: string): Promise<RedisClient> {\n  let Redis: { new (url: string): RedisClient };\n  try {\n    const mod = await import('ioredis');\n    Redis = mod.default ?? mod;\n  } catch {\n    throw new Error(\n      'RedisEventBus requires the \"ioredis\" package. Install it with: npm install ioredis',\n    );\n  }\n  return new Redis(url);\n}\n\n@Injectable()\nexport class RedisEventBus implements IEventBus, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisEventBus.name);\n\n  private publisher: RedisClient | null = null;\n  private subscriber: RedisClient | null = null;\n  private connected = false;\n\n  /**\n   * In-process subscriber registry. Handlers registered here are called when\n   * a message arrives on the subscriber client — keeping fan-out within the\n   * same process without an extra round-trip through Redis.\n   */\n  private readonly handlers = new Map<string, Set<(event: DomainEvent) => Promise<void>>>();\n\n  /**\n   * Track which event types have active Redis subscriptions.\n   * Used to avoid subscribing multiple times to the same type channel.\n   */\n  private readonly subscribedTypes = new Set<string>();\n\n  constructor(@Inject(REDIS_URL) private readonly redisUrl: string) {}\n\n  // ============================================================================\n  // Lifecycle\n  // ============================================================================\n\n  async onModuleInit(): Promise<void> {\n    this.publisher = await createRedisClient(this.redisUrl);\n    this.subscriber = await createRedisClient(this.redisUrl);\n\n    // Surface connection errors without crashing the process.\n    this.publisher.on('error', (err: Error) =>\n      this.logger.error(`Redis publisher error: ${err.message}`, err.stack),\n    );\n    this.subscriber.on('error', (err: Error) =>\n      this.logger.error(`Redis subscriber error: ${err.message}`, err.stack),\n    );\n\n    // Set up message listener for per-type subscriptions.\n    // Subscriptions are created lazily when the first handler is registered for a type.\n    this.subscriber.on('message', (channel: string, message: string) => {\n      void this.handleMessage(channel, message);\n    });\n\n    this.connected = true;\n    this.logger.log(`RedisEventBus connected to ${this.redisUrl}`);\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.connected = false;\n\n    if (this.subscriber) {\n      // Unsubscribe from all channels and disconnect the subscriber.\n      // unsubscribe() with no args unsubscribes from all channels.\n      await this.subscriber.unsubscribe();\n      this.subscriber.disconnect();\n      this.subscriber = null;\n    }\n\n    if (this.publisher) {\n      this.publisher.disconnect();\n      this.publisher = null;\n    }\n\n    this.subscribedTypes.clear();\n    this.logger.log('RedisEventBus disconnected');\n  }\n\n  // ============================================================================\n  // IEventBus\n  // ============================================================================\n\n  /**\n   * Publish a single event.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publish(event: DomainEvent, tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    this.assertConnected();\n\n    const payload = this.serialize(event);\n    const channel = `${CHANNEL_PREFIX}${event.type}`;\n\n    await this.publisher!.publish(channel, payload);\n  }\n\n  /**\n   * Publish multiple events using a pipeline so all PUBLISH commands are sent\n   * in a single round-trip.\n   *\n   * `tx` is accepted but ignored — see module-level JSDoc for details.\n   */\n  async publishMany(events: DomainEvent[], tx?: DrizzleTransaction): Promise<void> {\n    void tx; // intentionally unused — Redis Pub/Sub is not transactional\n    if (events.length === 0) return;\n    this.assertConnected();\n\n    const pipeline = this.publisher!.pipeline();\n    for (const event of events) {\n      const payload = this.serialize(event);\n      const channel = `${CHANNEL_PREFIX}${event.type}`;\n      pipeline.publish(channel, payload);\n    }\n    await pipeline.exec();\n  }\n\n  /**\n   * Register a handler for a specific event type.\n   * Returns an unsubscribe function — call it to remove the handler.\n   *\n   * On first handler for a type, subscribes to the per-type Redis channel.\n   * On removal of the last handler for a type, unsubscribes from the channel.\n   */\n  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","/**\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":"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","names":[]}

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

@@ -0,0 +1,46 @@
+import { DynamicModule } from '@nestjs/common';
+
+/**
+ * EventsModule — DynamicModule factory for the event bus subsystem.
+ *
+ * Register once in AppModule:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     EventsModule.forRoot({ backend: 'drizzle' }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * Tests swap to the memory backend without touching application code:
+ * ```typescript
+ * Test.createTestingModule({
+ *   imports: [EventsModule.forRoot({ backend: 'memory' })],
+ * });
+ * ```
+ *
+ * `global: true` means entity modules do not need to import EventsModule
+ * individually — the EVENT_BUS token is available project-wide.
+ */
+
+interface EventsModuleOptions {
+    backend: 'drizzle' | 'memory' | 'redis';
+    /**
+     * Redis connection URL used when `backend` is `'redis'`.
+     * Falls back to the REDIS_URL environment variable, then
+     * `redis://localhost:6379` if neither is set.
+     */
+    redisUrl?: string;
+}
+interface EventsModuleAsyncOptions {
+    useFactory: (...args: unknown[]) => Promise<EventsModuleOptions> | EventsModuleOptions;
+    inject?: unknown[];
+    imports?: unknown[];
+}
+declare class EventsModule {
+    static forRootAsync(asyncOptions: EventsModuleAsyncOptions): DynamicModule;
+    static forRoot(options?: EventsModuleOptions): DynamicModule;
+}
+
+export { EventsModule, type EventsModuleAsyncOptions, type EventsModuleOptions };