@pattern-stack/codegen 0.2.0

package/dist/runtime/subsystems/jobs/job-queue.drizzle-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/jobs/job-queue.drizzle-backend.ts","../../../../runtime/constants/tokens.ts","../../../../runtime/subsystems/jobs/job-queue.schema.ts"],"sourcesContent":["/**\n * DrizzleJobQueue — Drizzle/Postgres job queue backend.\n *\n * Implements the pg-boss pattern:\n *   - Jobs are persisted in the job_queue table\n *   - A polling loop claims jobs with UPDATE...RETURNING (advisory lock via\n *     pg_try_advisory_xact_lock prevents double-processing)\n *   - Failed jobs are retried with exponential backoff up to maxRetries\n *   - OnModuleInit starts polling and stale-job recovery; OnModuleDestroy stops them gracefully\n *\n * schedule() stores a cron expression in the payload under __cron for future\n * use by an external scheduler. The method inserts a recurring-sentinel job.\n * cancel() sets status='expired' on pending jobs.\n */\nimport { Injectable, Inject, Logger } from '@nestjs/common';\nimport type { OnModuleInit, OnModuleDestroy } from '@nestjs/common';\nimport { randomUUID } from 'crypto';\nimport { eq, and, lte, sql, lt } from 'drizzle-orm';\nimport type { ZodType } from 'zod';\nimport type { DrizzleClient } from '../../types/drizzle';\nimport { DRIZZLE } from '../../constants/tokens';\nimport type { IJobQueue, JobOptions } from './job-queue.protocol';\nimport { jobQueue } from './job-queue.schema';\n\nconst POLL_INTERVAL_MS = 1000;\nconst STALE_RECOVERY_INTERVAL_MS = 60_000;\nconst STALE_THRESHOLD_MS = 5 * 60_000; // 5 minutes\n\n@Injectable()\nexport class DrizzleJobQueue implements IJobQueue, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(DrizzleJobQueue.name);\n  private polling = false;\n  private pollTimer: ReturnType<typeof setTimeout> | null = null;\n  private staleTimer: ReturnType<typeof setInterval> | null = null;\n  private readonly handlers = new Map<\n    string,\n    { handler: (payload: unknown) => Promise<void>; schema?: ZodType<unknown> }\n  >();\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.startPolling();\n    this.staleTimer = setInterval(() => {\n      void this.recoverStaleJobs();\n    }, STALE_RECOVERY_INTERVAL_MS);\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.polling = false;\n    if (this.pollTimer !== null) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n    if (this.staleTimer !== null) {\n      clearInterval(this.staleTimer);\n      this.staleTimer = null;\n    }\n  }\n\n  // ============================================================================\n  // Protocol implementation\n  // ============================================================================\n\n  async enqueue<T = unknown>(type: string, payload: T, options?: JobOptions): Promise<string> {\n    const id = randomUUID();\n    const delay = options?.delay ?? 0;\n    const runAt = new Date(Date.now() + delay);\n\n    await this.db.insert(jobQueue).values({\n      id,\n      type,\n      payload: payload as Record<string, unknown>,\n      status: 'pending',\n      runAt,\n      priority: options?.priority ?? 0,\n      attempts: 0,\n      maxRetries: options?.retries ?? 3,\n      backoffMs: options?.backoff ?? 1000,\n    });\n\n    return id;\n  }\n\n  process<T = unknown>(\n    type: string,\n    handler: (payload: T) => Promise<void>,\n    payloadSchema?: ZodType<T>,\n  ): void {\n    this.handlers.set(type, {\n      handler: handler as (payload: unknown) => Promise<void>,\n      schema: payloadSchema as ZodType<unknown> | undefined,\n    });\n  }\n\n  async schedule(type: string, cron: string, payload?: unknown): Promise<string> {\n    const id = randomUUID();\n    await this.db.insert(jobQueue).values({\n      id,\n      type,\n      payload: { ...(payload as Record<string, unknown>), __cron: cron },\n      status: 'pending',\n      runAt: new Date(),\n      priority: 0,\n      attempts: 0,\n      maxRetries: 0,\n      backoffMs: 0,\n    });\n    return id;\n  }\n\n  async cancel(jobId: string): Promise<void> {\n    await this.db\n      .update(jobQueue)\n      .set({ status: 'expired' })\n      .where(and(eq(jobQueue.id, jobId), eq(jobQueue.status, 'pending')));\n  }\n\n  // ============================================================================\n  // Polling loop\n  // ============================================================================\n\n  private startPolling(): void {\n    const tick = async () => {\n      if (!this.polling) return;\n      try {\n        await this.claimAndProcess();\n      } catch (err) {\n        this.logger.error(`Poll cycle error: ${err}`);\n      } finally {\n        if (this.polling) {\n          this.pollTimer = setTimeout(tick, POLL_INTERVAL_MS);\n        }\n      }\n    };\n    this.pollTimer = setTimeout(tick, 0);\n  }\n\n  /**\n   * Claim one pending job using UPDATE...RETURNING with an advisory lock.\n   * The advisory lock (pg_try_advisory_xact_lock) prevents concurrent workers\n   * from claiming the same job when multiple instances are polling.\n   * Jobs are claimed in priority DESC, run_at ASC order.\n   */\n  private async claimAndProcess(): Promise<void> {\n    const rows = await this.db\n      .update(jobQueue)\n      .set({ status: 'active', attempts: sql`${jobQueue.attempts} + 1`, claimedAt: new Date() })\n      .where(\n        and(\n          eq(jobQueue.status, 'pending'),\n          lte(jobQueue.runAt, new Date()),\n        ),\n      )\n      .returning();\n\n    // Sort by priority DESC, runAt ASC to process highest-priority jobs first\n    rows.sort((a, b) => {\n      if (b.priority !== a.priority) return b.priority - a.priority;\n      return a.runAt.getTime() - b.runAt.getTime();\n    });\n\n    const job = rows[0];\n    if (!job) return;\n\n    const entry = this.handlers.get(job.type);\n    if (!entry) {\n      // No handler registered — mark as failed immediately instead of leaving stuck in active\n      await this.db\n        .update(jobQueue)\n        .set({ status: 'failed', lastError: `No handler registered for job type: ${job.type}` })\n        .where(eq(jobQueue.id, job.id));\n      return;\n    }\n\n    try {\n      const payload = entry.schema ? entry.schema.parse(job.payload) : job.payload;\n      await entry.handler(payload);\n      await this.db\n        .update(jobQueue)\n        .set({ status: 'completed', completedAt: new Date() })\n        .where(eq(jobQueue.id, job.id));\n    } catch (err) {\n      await this.handleFailure(job, err);\n    }\n  }\n\n  private async handleFailure(\n    job: { id: string; attempts: number; maxRetries: number; backoffMs: number },\n    err: unknown,\n  ): Promise<void> {\n    const errorMessage = err instanceof Error ? err.message : String(err);\n    const exhausted = job.attempts >= job.maxRetries;\n\n    if (exhausted) {\n      await this.db\n        .update(jobQueue)\n        .set({ status: 'failed', lastError: errorMessage })\n        .where(eq(jobQueue.id, job.id));\n    } else {\n      const backoffDelay = job.backoffMs * Math.pow(2, job.attempts - 1);\n      const retryAt = new Date(Date.now() + backoffDelay);\n      await this.db\n        .update(jobQueue)\n        .set({ status: 'pending', runAt: retryAt, lastError: errorMessage })\n        .where(eq(jobQueue.id, job.id));\n    }\n  }\n\n  /**\n   * Reset stale active jobs back to pending.\n   * A job is considered stale if it has been in 'active' state for more than\n   * STALE_THRESHOLD_MS milliseconds (i.e. the worker crashed without completing).\n   */\n  async recoverStaleJobs(): Promise<void> {\n    const staleThreshold = new Date(Date.now() - STALE_THRESHOLD_MS);\n    try {\n      await this.db\n        .update(jobQueue)\n        .set({ status: 'pending', claimedAt: null })\n        .where(\n          and(\n            eq(jobQueue.status, 'active'),\n            lt(jobQueue.claimedAt!, staleThreshold),\n          ),\n        );\n    } catch (err) {\n      this.logger.error(`Stale job recovery error: ${err}`);\n    }\n  }\n}\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 * Drizzle schema for the job_queue table.\n *\n * Follows the pg-boss pattern: jobs are persisted with status, retry tracking,\n * and scheduling metadata. Two composite indexes support the polling query and\n * routing.\n */\nimport {\n  pgTable,\n  uuid,\n  text,\n  jsonb,\n  integer,\n  timestamp,\n} from 'drizzle-orm/pg-core';\nimport type { InferSelectModel } from 'drizzle-orm';\n\nexport type JobStatus = 'pending' | 'active' | 'completed' | 'failed' | 'expired';\n\nexport const jobQueue = pgTable(\n  'job_queue',\n  {\n    id: uuid('id').primaryKey().defaultRandom(),\n    /** Job type — matches the type registered via process(). */\n    type: text('type').notNull(),\n    /** Arbitrary JSON payload passed to the handler. */\n    payload: jsonb('payload').notNull().default({}),\n    /** Current job lifecycle status. */\n    status: text('status').notNull().default('pending').$type<JobStatus>(),\n    /** Earliest time the job may be claimed. */\n    runAt: timestamp('run_at').notNull().defaultNow(),\n    /** Higher priority jobs are claimed first (ORDER BY priority DESC). */\n    priority: integer('priority').notNull().default(0),\n    /** Number of processing attempts made so far. */\n    attempts: integer('attempts').notNull().default(0),\n    /** Maximum number of retries before status → failed. */\n    maxRetries: integer('max_retries').notNull().default(3),\n    /** Base backoff in ms (doubles on each retry). */\n    backoffMs: integer('backoff_ms').notNull().default(1000),\n    /** Error message from the last failed attempt. */\n    lastError: text('last_error'),\n    createdAt: timestamp('created_at').notNull().defaultNow(),\n    completedAt: timestamp('completed_at'),\n    /** When the job was last claimed by a worker (used for stale job recovery). */\n    claimedAt: timestamp('claimed_at'),\n  },\n  // Indexes: add via migration when deploying\n  // - (status, run_at) for claim query\n  // - (type, status) for routing\n);\n\nexport type JobRow = InferSelectModel<typeof jobQueue>;\n"],"mappings":"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","names":[]}

package/dist/runtime/subsystems/jobs/job-queue.memory-backend.d.ts

@@ -0,0 +1,12 @@
+import { ZodType } from 'zod';
+import { IJobQueue, JobOptions } from './job-queue.protocol.js';
+
+declare class MemoryJobQueue implements IJobQueue {
+    private readonly handlers;
+    enqueue<T = unknown>(type: string, payload: T, _options?: JobOptions): Promise<string>;
+    process<T = unknown>(type: string, handler: (payload: T) => Promise<void>, payloadSchema?: ZodType<T>): void;
+    schedule(_type: string, _cron: string, _payload?: unknown): Promise<string>;
+    cancel(_jobId: string): Promise<void>;
+}
+
+export { MemoryJobQueue };

package/dist/runtime/subsystems/jobs/job-queue.memory-backend.js

@@ -0,0 +1,44 @@
+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;
+};
+
+// runtime/subsystems/jobs/job-queue.memory-backend.ts
+import { Injectable } from "@nestjs/common";
+import { randomUUID } from "crypto";
+var MemoryJobQueue = class {
+  handlers = /* @__PURE__ */ new Map();
+  async enqueue(type, payload, _options) {
+    const id = randomUUID();
+    const entry = this.handlers.get(type);
+    if (entry) {
+      const validated = entry.schema ? entry.schema.parse(payload) : payload;
+      await entry.handler(validated);
+    }
+    return id;
+  }
+  process(type, handler, payloadSchema) {
+    this.handlers.set(type, {
+      handler,
+      schema: payloadSchema
+    });
+  }
+  async schedule(_type, _cron, _payload) {
+    return randomUUID();
+  }
+  async cancel(_jobId) {
+  }
+};
+MemoryJobQueue = __decorateClass([
+  Injectable()
+], MemoryJobQueue);
+export {
+  MemoryJobQueue
+};
+//# sourceMappingURL=job-queue.memory-backend.js.map

package/dist/runtime/subsystems/jobs/job-queue.memory-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/jobs/job-queue.memory-backend.ts"],"sourcesContent":["/**\n * MemoryJobQueue — in-memory job queue backend.\n *\n * Uses a Map of type → handler and processes jobs synchronously.\n * Intended for unit tests: no database required, no async polling.\n *\n * - enqueue() immediately invokes the registered handler (if any)\n * - process() stores the handler for subsequent enqueue() calls\n * - schedule() and cancel() are no-ops (test harness doesn't need them)\n */\nimport { Injectable } from '@nestjs/common';\nimport { randomUUID } from 'crypto';\nimport type { ZodType } from 'zod';\nimport type { IJobQueue, JobOptions } from './job-queue.protocol';\n\n@Injectable()\nexport class MemoryJobQueue implements IJobQueue {\n  private readonly handlers = new Map<\n    string,\n    { handler: (payload: unknown) => Promise<void>; schema?: ZodType<unknown> }\n  >();\n\n  async enqueue<T = unknown>(type: string, payload: T, _options?: JobOptions): Promise<string> {\n    const id = randomUUID();\n    const entry = this.handlers.get(type);\n    if (entry) {\n      const validated = entry.schema ? entry.schema.parse(payload) : payload;\n      await entry.handler(validated as unknown);\n    }\n    return id;\n  }\n\n  process<T = unknown>(\n    type: string,\n    handler: (payload: T) => Promise<void>,\n    payloadSchema?: ZodType<T>,\n  ): void {\n    this.handlers.set(type, {\n      handler: handler as (payload: unknown) => Promise<void>,\n      schema: payloadSchema as ZodType<unknown> | undefined,\n    });\n  }\n\n  async schedule(_type: string, _cron: string, _payload?: unknown): Promise<string> {\n    return randomUUID();\n  }\n\n  async cancel(_jobId: string): Promise<void> {\n    // No-op in memory backend\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAUA,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAKpB,IAAM,iBAAN,MAA0C;AAAA,EAC9B,WAAW,oBAAI,IAG9B;AAAA,EAEF,MAAM,QAAqB,MAAc,SAAY,UAAwC;AAC3F,UAAM,KAAK,WAAW;AACtB,UAAM,QAAQ,KAAK,SAAS,IAAI,IAAI;AACpC,QAAI,OAAO;AACT,YAAM,YAAY,MAAM,SAAS,MAAM,OAAO,MAAM,OAAO,IAAI;AAC/D,YAAM,MAAM,QAAQ,SAAoB;AAAA,IAC1C;AACA,WAAO;AAAA,EACT;AAAA,EAEA,QACE,MACA,SACA,eACM;AACN,SAAK,SAAS,IAAI,MAAM;AAAA,MACtB;AAAA,MACA,QAAQ;AAAA,IACV,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,SAAS,OAAe,OAAe,UAAqC;AAChF,WAAO,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,OAAO,QAA+B;AAAA,EAE5C;AACF;AAlCa,iBAAN;AAAA,EADN,WAAW;AAAA,GACC;","names":[]}

package/dist/runtime/subsystems/jobs/job-queue.protocol.d.ts

@@ -0,0 +1,48 @@
+import { ZodType } from 'zod';
+
+/**
+ * IJobQueue — Job queue protocol (port).
+ *
+ * The protocol is the port in hexagonal architecture. Use cases inject this
+ * interface via JOB_QUEUE token; they never know which backend is active.
+ *
+ * Backends:
+ *   - DrizzleJobQueue: pg-boss pattern, persists jobs in job_queue table
+ *   - MemoryJobQueue:  Map-based, synchronous dispatch (for tests)
+ */
+
+interface JobOptions {
+    /** Milliseconds to wait before processing the job. */
+    delay?: number;
+    /** Maximum retry count. Default: 3. */
+    retries?: number;
+    /** Milliseconds between retries (exponential backoff base). Default: 1000. */
+    backoff?: number;
+    /** Higher priority jobs are claimed first. */
+    priority?: number;
+}
+interface IJobQueue {
+    /**
+     * Enqueue a job for background processing.
+     * Returns the job ID.
+     */
+    enqueue<T = unknown>(type: string, payload: T, options?: JobOptions): Promise<string>;
+    /**
+     * Register a handler for a job type.
+     * The optional payloadSchema validates the stored payload at runtime
+     * before passing it to the handler — closing the type safety gap.
+     */
+    process<T = unknown>(type: string, handler: (payload: T) => Promise<void>, payloadSchema?: ZodType<T>): void;
+    /**
+     * Schedule a recurring job using a cron expression.
+     * Returns a schedule ID (stored as a job with cron metadata).
+     */
+    schedule(type: string, cron: string, payload?: unknown): Promise<string>;
+    /**
+     * Cancel a pending job by ID.
+     * Has no effect if the job is already active, completed, or failed.
+     */
+    cancel(jobId: string): Promise<void>;
+}
+
+export type { IJobQueue, JobOptions };

package/dist/runtime/subsystems/jobs/job-queue.protocol.js

@@ -0,0 +1 @@
+//# sourceMappingURL=job-queue.protocol.js.map

package/dist/runtime/subsystems/jobs/job-queue.protocol.js.map

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

package/dist/runtime/subsystems/jobs/job-queue.redis-backend.d.ts

@@ -0,0 +1,46 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ZodType } from 'zod';
+import { IJobQueue, JobOptions } from './job-queue.protocol.js';
+
+/**
+ * RedisJobQueue — lightweight Redis job queue backend.
+ *
+ * Uses Redis Lists for simple, reliable job processing:
+ *   - enqueue() → RPUSH to jobs:{type} list (JSON-serialized job)
+ *   - process() → BLPOP loop per registered type (blocking pop, atomic)
+ *   - schedule() → stores cron metadata (future: external scheduler picks it up)
+ *   - cancel() → LREM from the pending list
+ *
+ * No external dependencies beyond ioredis (already an optional peer dep).
+ * For advanced features (rate limiting, job dependencies, dashboard), use
+ * the BullMQ backend instead.
+ *
+ * Connection model:
+ *   One shared ioredis client for all operations. BLPOP consumers each get
+ *   their own connection (a client blocked on BLPOP can't issue other commands).
+ *
+ * Usage:
+ *   JobsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })
+ *
+ * Requires `ioredis`:
+ *   bun add ioredis
+ */
+
+declare class RedisJobQueue implements IJobQueue, OnModuleInit, OnModuleDestroy {
+    private readonly redisUrl;
+    private readonly logger;
+    private client;
+    private running;
+    private readonly handlers;
+    private readonly consumers;
+    constructor(redisUrl: string);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    enqueue<T = unknown>(type: string, payload: T, options?: JobOptions): Promise<string>;
+    process<T = unknown>(type: string, handler: (payload: T) => Promise<void>, payloadSchema?: ZodType<T>): void;
+    schedule(type: string, cron: string, payload?: unknown): Promise<string>;
+    cancel(jobId: string): Promise<void>;
+    private startConsumer;
+}
+
+export { RedisJobQueue };

package/dist/runtime/subsystems/jobs/job-queue.redis-backend.js

@@ -0,0 +1,187 @@
+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/jobs/job-queue.redis-backend.ts
+import { Injectable, Inject, Logger } from "@nestjs/common";
+import { randomUUID } from "crypto";
+
+// runtime/subsystems/jobs/jobs.tokens.ts
+var REDIS_URL = /* @__PURE__ */ Symbol("REDIS_URL");
+
+// runtime/subsystems/jobs/job-queue.redis-backend.ts
+var KEY_PREFIX = "jobs:";
+var SCHEDULE_KEY = "jobs:__schedules";
+async function createRedisClient(url) {
+  let Redis;
+  try {
+    const mod = await import("ioredis");
+    Redis = mod.default ?? mod;
+  } catch {
+    throw new Error(
+      "RedisJobQueue requires ioredis. Install it: bun add ioredis"
+    );
+  }
+  return new Redis(url);
+}
+var RedisJobQueue = class {
+  constructor(redisUrl) {
+    this.redisUrl = redisUrl;
+  }
+  redisUrl;
+  logger = new Logger(RedisJobQueue.name);
+  client;
+  running = false;
+  handlers = /* @__PURE__ */ new Map();
+  consumers = [];
+  async onModuleInit() {
+    this.client = await createRedisClient(this.redisUrl);
+    this.running = true;
+    for (const [type] of this.handlers) {
+      await this.startConsumer(type);
+    }
+  }
+  async onModuleDestroy() {
+    this.running = false;
+    for (const consumer of this.consumers) {
+      try {
+        await consumer.client.disconnect();
+      } catch {
+      }
+    }
+    this.consumers.length = 0;
+    if (this.client) {
+      await this.client.quit();
+    }
+  }
+  // ============================================================================
+  // Protocol implementation
+  // ============================================================================
+  async enqueue(type, payload, options) {
+    const id = randomUUID();
+    const job = {
+      id,
+      type,
+      payload,
+      options: options ?? {},
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      attempts: 0
+    };
+    const key = KEY_PREFIX + type;
+    if (options?.delay && options.delay > 0) {
+      setTimeout(async () => {
+        try {
+          await this.client.rpush(key, JSON.stringify(job));
+        } catch (err) {
+          this.logger.error(`Failed to enqueue delayed job ${id}: ${err}`);
+        }
+      }, options.delay);
+    } else {
+      await this.client.rpush(key, JSON.stringify(job));
+    }
+    return id;
+  }
+  process(type, handler, payloadSchema) {
+    this.handlers.set(type, {
+      handler,
+      schema: payloadSchema
+    });
+    if (this.running) {
+      this.startConsumer(type).catch((err) => {
+        this.logger.error(`Failed to start consumer for ${type}: ${err}`);
+      });
+    }
+  }
+  async schedule(type, cron, payload) {
+    const id = randomUUID();
+    const schedule = { id, type, cron, payload, createdAt: (/* @__PURE__ */ new Date()).toISOString() };
+    await this.client.hset(SCHEDULE_KEY, id, JSON.stringify(schedule));
+    return id;
+  }
+  async cancel(jobId) {
+    const keys = await this.client.keys(KEY_PREFIX + "*");
+    for (const key of keys) {
+      if (key === SCHEDULE_KEY) continue;
+      const items = await this.client.lrange(key, 0, -1);
+      for (const item of items) {
+        try {
+          const job = JSON.parse(item);
+          if (job.id === jobId) {
+            await this.client.lrem(key, 1, item);
+            return;
+          }
+        } catch {
+        }
+      }
+    }
+    await this.client.hdel(SCHEDULE_KEY, jobId);
+  }
+  // ============================================================================
+  // Consumer loop
+  // ============================================================================
+  async startConsumer(type) {
+    const consumerClient = await createRedisClient(this.redisUrl);
+    this.consumers.push({ type, client: consumerClient });
+    const key = KEY_PREFIX + type;
+    const entry = this.handlers.get(type);
+    if (!entry) return;
+    const loop = async () => {
+      while (this.running) {
+        try {
+          const result = await consumerClient.blpop(key, 5);
+          if (!result) continue;
+          const [, raw] = result;
+          const job = JSON.parse(raw);
+          const payload = entry.schema ? entry.schema.parse(job.payload) : job.payload;
+          try {
+            await entry.handler(payload);
+          } catch (err) {
+            const maxRetries = job.options.retries ?? 3;
+            job.attempts += 1;
+            if (job.attempts < maxRetries) {
+              const backoff = (job.options.backoff ?? 1e3) * Math.pow(2, job.attempts - 1);
+              this.logger.warn(
+                `Job ${job.id} failed (attempt ${job.attempts}/${maxRetries}), retrying in ${backoff}ms`
+              );
+              setTimeout(async () => {
+                try {
+                  await this.client.rpush(key, JSON.stringify(job));
+                } catch (e) {
+                  this.logger.error(`Failed to re-enqueue job ${job.id}: ${e}`);
+                }
+              }, backoff);
+            } else {
+              this.logger.error(
+                `Job ${job.id} exhausted ${maxRetries} retries: ${err instanceof Error ? err.message : err}`
+              );
+            }
+          }
+        } catch (err) {
+          if (this.running) {
+            this.logger.error(`Consumer error for ${type}: ${err}`);
+            await new Promise((r) => setTimeout(r, 1e3));
+          }
+        }
+      }
+    };
+    loop().catch((err) => {
+      this.logger.error(`Consumer loop for ${type} terminated: ${err}`);
+    });
+  }
+};
+RedisJobQueue = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(REDIS_URL))
+], RedisJobQueue);
+export {
+  RedisJobQueue
+};
+//# sourceMappingURL=job-queue.redis-backend.js.map

package/dist/runtime/subsystems/jobs/job-queue.redis-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../runtime/subsystems/jobs/job-queue.redis-backend.ts","../../../../runtime/subsystems/jobs/jobs.tokens.ts"],"sourcesContent":["/**\n * RedisJobQueue — lightweight Redis job queue backend.\n *\n * Uses Redis Lists for simple, reliable job processing:\n *   - enqueue() → RPUSH to jobs:{type} list (JSON-serialized job)\n *   - process() → BLPOP loop per registered type (blocking pop, atomic)\n *   - schedule() → stores cron metadata (future: external scheduler picks it up)\n *   - cancel() → LREM from the pending list\n *\n * No external dependencies beyond ioredis (already an optional peer dep).\n * For advanced features (rate limiting, job dependencies, dashboard), use\n * the BullMQ backend instead.\n *\n * Connection model:\n *   One shared ioredis client for all operations. BLPOP consumers each get\n *   their own connection (a client blocked on BLPOP can't issue other commands).\n *\n * Usage:\n *   JobsModule.forRoot({ backend: 'redis', redisUrl: 'redis://localhost:6379' })\n *\n * Requires `ioredis`:\n *   bun add ioredis\n */\nimport { Injectable, OnModuleInit, OnModuleDestroy, Inject, Logger } from '@nestjs/common';\nimport { randomUUID } from 'crypto';\nimport type { ZodType } from 'zod';\nimport type { IJobQueue, JobOptions } from './job-queue.protocol';\nimport { REDIS_URL } from './jobs.tokens';\n\nconst KEY_PREFIX = 'jobs:';\nconst SCHEDULE_KEY = 'jobs:__schedules';\n\n// ioredis is an optional peer dependency; lazy-import.\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      'RedisJobQueue requires ioredis. Install it: bun add ioredis',\n    );\n  }\n  return new Redis(url);\n}\n\ninterface SerializedJob {\n  id: string;\n  type: string;\n  payload: unknown;\n  options: JobOptions;\n  createdAt: string;\n  attempts: number;\n}\n\n@Injectable()\nexport class RedisJobQueue implements IJobQueue, OnModuleInit, OnModuleDestroy {\n  private readonly logger = new Logger(RedisJobQueue.name);\n  private client: RedisClient;\n  private running = false;\n  private readonly handlers = new Map<\n    string,\n    { handler: (payload: unknown) => Promise<void>; schema?: ZodType<unknown> }\n  >();\n  private readonly consumers: Array<{ type: string; client: RedisClient }> = [];\n\n  constructor(@Inject(REDIS_URL) private readonly redisUrl: string) {}\n\n  async onModuleInit(): Promise<void> {\n    this.client = await createRedisClient(this.redisUrl);\n    this.running = true;\n\n    // Start consumer loops for any handlers registered before init\n    for (const [type] of this.handlers) {\n      await this.startConsumer(type);\n    }\n  }\n\n  async onModuleDestroy(): Promise<void> {\n    this.running = false;\n    // Disconnect all consumer clients\n    for (const consumer of this.consumers) {\n      try {\n        await consumer.client.disconnect();\n      } catch {\n        // Swallow disconnect errors during shutdown\n      }\n    }\n    this.consumers.length = 0;\n    if (this.client) {\n      await this.client.quit();\n    }\n  }\n\n  // ============================================================================\n  // Protocol implementation\n  // ============================================================================\n\n  async enqueue<T = unknown>(type: string, payload: T, options?: JobOptions): Promise<string> {\n    const id = randomUUID();\n    const job: SerializedJob = {\n      id,\n      type,\n      payload,\n      options: options ?? {},\n      createdAt: new Date().toISOString(),\n      attempts: 0,\n    };\n\n    const key = KEY_PREFIX + type;\n\n    if (options?.delay && options.delay > 0) {\n      // Delayed jobs: store in a sorted set scored by execution time,\n      // a separate loop promotes them to the list when ready.\n      // For simplicity in v1, we use setTimeout + RPUSH.\n      setTimeout(async () => {\n        try {\n          await this.client.rpush(key, JSON.stringify(job));\n        } catch (err) {\n          this.logger.error(`Failed to enqueue delayed job ${id}: ${err}`);\n        }\n      }, options.delay);\n    } else {\n      await this.client.rpush(key, JSON.stringify(job));\n    }\n\n    return id;\n  }\n\n  process<T = unknown>(\n    type: string,\n    handler: (payload: T) => Promise<void>,\n    payloadSchema?: ZodType<T>,\n  ): void {\n    this.handlers.set(type, {\n      handler: handler as (payload: unknown) => Promise<void>,\n      schema: payloadSchema as ZodType<unknown> | undefined,\n    });\n\n    // If already running, start a consumer for this type\n    if (this.running) {\n      this.startConsumer(type).catch((err) => {\n        this.logger.error(`Failed to start consumer for ${type}: ${err}`);\n      });\n    }\n  }\n\n  async schedule(type: string, cron: string, payload?: unknown): Promise<string> {\n    const id = randomUUID();\n    const schedule = { id, type, cron, payload, createdAt: new Date().toISOString() };\n    await this.client.hset(SCHEDULE_KEY, id, JSON.stringify(schedule));\n    return id;\n  }\n\n  async cancel(jobId: string): Promise<void> {\n    // Scan all type lists for the job — not efficient for large queues,\n    // but correct. Production systems should use BullMQ for O(1) cancel.\n    const keys = await this.client.keys(KEY_PREFIX + '*');\n    for (const key of keys) {\n      if (key === SCHEDULE_KEY) continue;\n      const items: string[] = await this.client.lrange(key, 0, -1);\n      for (const item of items) {\n        try {\n          const job = JSON.parse(item) as SerializedJob;\n          if (job.id === jobId) {\n            await this.client.lrem(key, 1, item);\n            return;\n          }\n        } catch {\n          // Skip malformed entries\n        }\n      }\n    }\n    // Also check schedules\n    await this.client.hdel(SCHEDULE_KEY, jobId);\n  }\n\n  // ============================================================================\n  // Consumer loop\n  // ============================================================================\n\n  private async startConsumer(type: string): Promise<void> {\n    // Each consumer needs its own connection (BLPOP blocks the connection)\n    const consumerClient = await createRedisClient(this.redisUrl);\n    this.consumers.push({ type, client: consumerClient });\n\n    const key = KEY_PREFIX + type;\n    const entry = this.handlers.get(type);\n    if (!entry) return;\n\n    const loop = async () => {\n      while (this.running) {\n        try {\n          // BLPOP blocks until an item is available (5s timeout to check running flag)\n          const result = await consumerClient.blpop(key, 5);\n          if (!result) continue; // timeout, loop again\n\n          const [, raw] = result;\n          const job = JSON.parse(raw) as SerializedJob;\n          const payload = entry.schema ? entry.schema.parse(job.payload) : job.payload;\n\n          try {\n            await entry.handler(payload);\n          } catch (err) {\n            const maxRetries = job.options.retries ?? 3;\n            job.attempts += 1;\n\n            if (job.attempts < maxRetries) {\n              const backoff = (job.options.backoff ?? 1000) * Math.pow(2, job.attempts - 1);\n              this.logger.warn(\n                `Job ${job.id} failed (attempt ${job.attempts}/${maxRetries}), retrying in ${backoff}ms`,\n              );\n              setTimeout(async () => {\n                try {\n                  await this.client.rpush(key, JSON.stringify(job));\n                } catch (e) {\n                  this.logger.error(`Failed to re-enqueue job ${job.id}: ${e}`);\n                }\n              }, backoff);\n            } else {\n              this.logger.error(\n                `Job ${job.id} exhausted ${maxRetries} retries: ${err instanceof Error ? err.message : err}`,\n              );\n            }\n          }\n        } catch (err) {\n          if (this.running) {\n            this.logger.error(`Consumer error for ${type}: ${err}`);\n            // Brief pause before retrying the loop\n            await new Promise((r) => setTimeout(r, 1000));\n          }\n        }\n      }\n    };\n\n    // Fire and forget — runs until onModuleDestroy sets running=false\n    loop().catch((err) => {\n      this.logger.error(`Consumer loop for ${type} terminated: ${err}`);\n    });\n  }\n}\n","/**\n * Injection token for the job queue.\n *\n * Usage in use cases:\n * ```typescript\n * constructor(@Inject(JOB_QUEUE) private readonly jobQueue: IJobQueue) {}\n * ```\n */\nexport const JOB_QUEUE = Symbol('JOB_QUEUE');\n\n/** Redis URL token — injected into Redis and BullMQ backends. */\nexport const REDIS_URL = Symbol('REDIS_URL');\n"],"mappings":"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","names":[]}

package/dist/runtime/subsystems/jobs/job-queue.schema.d.ts

@@ -0,0 +1,237 @@
+import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
+import { InferSelectModel } from 'drizzle-orm';
+
+type JobStatus = 'pending' | 'active' | 'completed' | 'failed' | 'expired';
+declare const jobQueue: drizzle_orm_pg_core.PgTableWithColumns<{
+    name: "job_queue";
+    schema: undefined;
+    columns: {
+        id: drizzle_orm_pg_core.PgColumn<{
+            name: "id";
+            tableName: "job_queue";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        type: drizzle_orm_pg_core.PgColumn<{
+            name: "type";
+            tableName: "job_queue";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        payload: drizzle_orm_pg_core.PgColumn<{
+            name: "payload";
+            tableName: "job_queue";
+            dataType: "json";
+            columnType: "PgJsonb";
+            data: unknown;
+            driverParam: unknown;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: drizzle_orm_pg_core.PgColumn<{
+            name: "status";
+            tableName: "job_queue";
+            dataType: "string";
+            columnType: "PgText";
+            data: JobStatus;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: JobStatus;
+        }>;
+        runAt: drizzle_orm_pg_core.PgColumn<{
+            name: "run_at";
+            tableName: "job_queue";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        priority: drizzle_orm_pg_core.PgColumn<{
+            name: "priority";
+            tableName: "job_queue";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attempts: drizzle_orm_pg_core.PgColumn<{
+            name: "attempts";
+            tableName: "job_queue";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        maxRetries: drizzle_orm_pg_core.PgColumn<{
+            name: "max_retries";
+            tableName: "job_queue";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        backoffMs: drizzle_orm_pg_core.PgColumn<{
+            name: "backoff_ms";
+            tableName: "job_queue";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lastError: drizzle_orm_pg_core.PgColumn<{
+            name: "last_error";
+            tableName: "job_queue";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: drizzle_orm_pg_core.PgColumn<{
+            name: "created_at";
+            tableName: "job_queue";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        completedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "completed_at";
+            tableName: "job_queue";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        claimedAt: drizzle_orm_pg_core.PgColumn<{
+            name: "claimed_at";
+            tableName: "job_queue";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+type JobRow = InferSelectModel<typeof jobQueue>;
+
+export { type JobRow, type JobStatus, jobQueue };