@forinda/kickjs-queue 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Felix Orinda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+import { AppAdapter, Container } from '@forinda/kickjs-core';
+import * as bullmq from 'bullmq';
+import { JobsOptions, Queue } from 'bullmq';
+
+/** Options for configuring the QueueAdapter */
+interface QueueAdapterOptions {
+    /** Redis connection configuration */
+    redis: {
+        host: string;
+        port: number;
+        password?: string;
+    };
+    /** Queue names to pre-create (optional — queues are also created on-demand) */
+    queues?: string[];
+    /** Default worker concurrency (default: 1) */
+    concurrency?: number;
+}
+/** DI token for resolving the QueueService from the container */
+declare const QUEUE_MANAGER: unique symbol;
+
+/**
+ * BullMQ adapter for KickJS — creates queues and workers, wires @Job/@Process
+ * decorated classes as job processors, and registers a QueueService in DI.
+ *
+ * @example
+ * ```ts
+ * import { QueueAdapter } from '@forinda/kickjs-queue'
+ *
+ * bootstrap({
+ *   modules: [EmailModule],
+ *   adapters: [
+ *     new QueueAdapter({
+ *       redis: { host: 'localhost', port: 6379 },
+ *       queues: ['email', 'notifications'],
+ *       concurrency: 5,
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare class QueueAdapter implements AppAdapter {
+    private options;
+    readonly name = "QueueAdapter";
+    private workers;
+    private queueService;
+    constructor(options: QueueAdapterOptions);
+    beforeStart(_app: any, container: Container): void;
+    /** Gracefully close all workers and queues */
+    shutdown(): Promise<void>;
+}
+
+/** Data shape for bulk job insertion */
+interface BulkJobEntry {
+    name: string;
+    data: any;
+    opts?: JobsOptions;
+}
+/**
+ * Injectable service for adding jobs to BullMQ queues.
+ *
+ * Resolved from DI via `@Inject(QUEUE_MANAGER)`.
+ *
+ * @example
+ * ```ts
+ * @Service()
+ * class EmailService {
+ *   @Inject(QUEUE_MANAGER) private queue: QueueService
+ *
+ *   async sendWelcome(userId: string) {
+ *     await this.queue.add('email', 'welcome', { userId })
+ *   }
+ * }
+ * ```
+ */
+declare class QueueService {
+    private queues;
+    /** Register a queue instance (called by the adapter) */
+    registerQueue(name: string, queue: Queue): void;
+    /** Get a raw BullMQ Queue instance by name */
+    getQueue(name: string): Queue | undefined;
+    /** Add a single job to a queue */
+    add(queueName: string, jobName: string, data: any, opts?: JobsOptions): Promise<bullmq.Job<any, any, string>>;
+    /** Add multiple jobs to a queue in bulk */
+    addBulk(queueName: string, jobs: BulkJobEntry[]): Promise<bullmq.Job<any, any, string>[]>;
+    /** Get all registered queue names */
+    getQueueNames(): string[];
+    /** Close all queues gracefully */
+    closeAll(): Promise<void>;
+}
+
+/**
+ * Mark a class as a job processor for a specific BullMQ queue.
+ *
+ * The class is automatically registered in the DI container and will
+ * be discovered by the QueueAdapter during startup.
+ *
+ * @param queueName - The name of the BullMQ queue this class processes
+ *
+ * @example
+ * ```ts
+ * @Job('email')
+ * export class EmailJobProcessor {
+ *   @Process('welcome')
+ *   async sendWelcome(job: BullMQJob) {
+ *     await sendEmail(job.data.to, 'Welcome!')
+ *   }
+ *
+ *   @Process()
+ *   async handleAll(job: BullMQJob) {
+ *     console.log('Fallback handler for:', job.name)
+ *   }
+ * }
+ * ```
+ */
+declare function Job(queueName: string): ClassDecorator;
+/**
+ * Mark a method as a job processor within a @Job class.
+ *
+ * @param jobName - Specific job name to handle. Omit to handle all jobs in the queue.
+ *
+ * @example
+ * ```ts
+ * @Job('notifications')
+ * export class NotificationProcessor {
+ *   @Process('push')
+ *   async handlePush(job: BullMQJob) { ... }
+ *
+ *   @Process('sms')
+ *   async handleSms(job: BullMQJob) { ... }
+ *
+ *   @Process()
+ *   async handleDefault(job: BullMQJob) { ... }
+ * }
+ * ```
+ */
+declare function Process(jobName?: string): MethodDecorator;
+
+export { type BulkJobEntry, Job, Process, QUEUE_MANAGER, QueueAdapter, type QueueAdapterOptions, QueueService };

package/dist/index.js

@@ -0,0 +1,178 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/queue.adapter.ts
+import { Queue, Worker } from "bullmq";
+import { Logger as Logger2, Scope } from "@forinda/kickjs-core";
+
+// src/types.ts
+import "reflect-metadata";
+var QUEUE_MANAGER = /* @__PURE__ */ Symbol("QueueManager");
+var QUEUE_METADATA = {
+  JOB: /* @__PURE__ */ Symbol("queue:job"),
+  PROCESS: /* @__PURE__ */ Symbol("queue:process")
+};
+var jobRegistry = /* @__PURE__ */ new Set();
+
+// src/queue.service.ts
+import { Logger } from "@forinda/kickjs-core";
+var log = Logger.for("QueueService");
+var QueueService = class {
+  static {
+    __name(this, "QueueService");
+  }
+  queues = /* @__PURE__ */ new Map();
+  /** Register a queue instance (called by the adapter) */
+  registerQueue(name, queue) {
+    this.queues.set(name, queue);
+    log.debug(`Queue registered: ${name}`);
+  }
+  /** Get a raw BullMQ Queue instance by name */
+  getQueue(name) {
+    return this.queues.get(name);
+  }
+  /** Add a single job to a queue */
+  async add(queueName, jobName, data, opts) {
+    const queue = this.queues.get(queueName);
+    if (!queue) {
+      throw new Error(`Queue "${queueName}" not found. Did you register it in QueueAdapter?`);
+    }
+    const job = await queue.add(jobName, data, opts);
+    log.debug(`Job added: ${queueName}/${jobName} (id: ${job.id})`);
+    return job;
+  }
+  /** Add multiple jobs to a queue in bulk */
+  async addBulk(queueName, jobs) {
+    const queue = this.queues.get(queueName);
+    if (!queue) {
+      throw new Error(`Queue "${queueName}" not found. Did you register it in QueueAdapter?`);
+    }
+    const result = await queue.addBulk(jobs);
+    log.debug(`Bulk jobs added: ${queueName} (count: ${result.length})`);
+    return result;
+  }
+  /** Get all registered queue names */
+  getQueueNames() {
+    return Array.from(this.queues.keys());
+  }
+  /** Close all queues gracefully */
+  async closeAll() {
+    for (const [name, queue] of this.queues) {
+      await queue.close();
+      log.debug(`Queue closed: ${name}`);
+    }
+    this.queues.clear();
+  }
+};
+
+// src/queue.adapter.ts
+var log2 = Logger2.for("QueueAdapter");
+var QueueAdapter = class {
+  static {
+    __name(this, "QueueAdapter");
+  }
+  options;
+  name = "QueueAdapter";
+  workers = [];
+  queueService = new QueueService();
+  constructor(options) {
+    this.options = options;
+  }
+  beforeStart(_app, container) {
+    const { redis, queues: preCreateQueues = [], concurrency = 1 } = this.options;
+    const connection = {
+      host: redis.host,
+      port: redis.port,
+      password: redis.password
+    };
+    for (const name of preCreateQueues) {
+      if (!this.queueService.getQueue(name)) {
+        const queue = new Queue(name, {
+          connection
+        });
+        this.queueService.registerQueue(name, queue);
+      }
+    }
+    for (const jobClass of jobRegistry) {
+      const queueName = Reflect.getMetadata(QUEUE_METADATA.JOB, jobClass);
+      if (queueName === void 0) continue;
+      const handlers = Reflect.getMetadata(QUEUE_METADATA.PROCESS, jobClass) || [];
+      if (handlers.length === 0) {
+        log2.warn(`@Job('${queueName}') class ${jobClass.name} has no @Process methods \u2014 skipping`);
+        continue;
+      }
+      if (!this.queueService.getQueue(queueName)) {
+        const queue = new Queue(queueName, {
+          connection
+        });
+        this.queueService.registerQueue(queueName, queue);
+      }
+      const processor = container.resolve(jobClass);
+      const worker = new Worker(queueName, async (job) => {
+        const specific = handlers.find((h) => h.jobName === job.name);
+        const handler = specific || handlers.find((h) => h.jobName === void 0);
+        if (handler) {
+          await processor[handler.handlerName](job);
+        } else {
+          log2.warn(`No handler for job "${job.name}" in queue "${queueName}"`);
+        }
+      }, {
+        connection,
+        concurrency
+      });
+      worker.on("failed", (job, err) => {
+        log2.error({
+          err
+        }, `Job failed: ${queueName}/${job?.name} (id: ${job?.id})`);
+      });
+      worker.on("completed", (job) => {
+        log2.debug(`Job completed: ${queueName}/${job.name} (id: ${job.id})`);
+      });
+      this.workers.push(worker);
+      log2.info(`Worker started: ${queueName} (${jobClass.name}, ${handlers.length} handler(s), concurrency: ${concurrency})`);
+    }
+    container.registerFactory(QUEUE_MANAGER, () => this.queueService, Scope.SINGLETON);
+    log2.info(`QueueAdapter ready \u2014 ${this.queueService.getQueueNames().length} queue(s), ${this.workers.length} worker(s)`);
+  }
+  /** Gracefully close all workers and queues */
+  async shutdown() {
+    for (const worker of this.workers) {
+      await worker.close();
+    }
+    log2.info(`Closed ${this.workers.length} worker(s)`);
+    this.workers = [];
+    await this.queueService.closeAll();
+    log2.info("All queues closed");
+  }
+};
+
+// src/decorators.ts
+import "reflect-metadata";
+import { Service } from "@forinda/kickjs-core";
+function Job(queueName) {
+  return (target) => {
+    Service()(target);
+    Reflect.defineMetadata(QUEUE_METADATA.JOB, queueName, target);
+    jobRegistry.add(target);
+  };
+}
+__name(Job, "Job");
+function Process(jobName) {
+  return (target, propertyKey) => {
+    const handlers = Reflect.getMetadata(QUEUE_METADATA.PROCESS, target.constructor) || [];
+    handlers.push({
+      handlerName: propertyKey,
+      jobName
+    });
+    Reflect.defineMetadata(QUEUE_METADATA.PROCESS, handlers, target.constructor);
+  };
+}
+__name(Process, "Process");
+export {
+  Job,
+  Process,
+  QUEUE_MANAGER,
+  QueueAdapter,
+  QueueService
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queue.adapter.ts","../src/types.ts","../src/queue.service.ts","../src/decorators.ts"],"sourcesContent":["import { Queue, Worker, type Job as BullMQJob } from 'bullmq'\nimport { Logger, type AppAdapter, type Container, Scope } from '@forinda/kickjs-core'\nimport {\n  QUEUE_MANAGER,\n  QUEUE_METADATA,\n  jobRegistry,\n  type QueueAdapterOptions,\n  type ProcessDefinition,\n} from './types'\nimport { QueueService } from './queue.service'\n\nconst log = Logger.for('QueueAdapter')\n\n/**\n * BullMQ adapter for KickJS — creates queues and workers, wires @Job/@Process\n * decorated classes as job processors, and registers a QueueService in DI.\n *\n * @example\n * ```ts\n * import { QueueAdapter } from '@forinda/kickjs-queue'\n *\n * bootstrap({\n *   modules: [EmailModule],\n *   adapters: [\n *     new QueueAdapter({\n *       redis: { host: 'localhost', port: 6379 },\n *       queues: ['email', 'notifications'],\n *       concurrency: 5,\n *     }),\n *   ],\n * })\n * ```\n */\nexport class QueueAdapter implements AppAdapter {\n  readonly name = 'QueueAdapter'\n\n  private workers: Worker[] = []\n  private queueService = new QueueService()\n\n  constructor(private options: QueueAdapterOptions) {}\n\n  beforeStart(_app: any, container: Container): void {\n    const { redis, queues: preCreateQueues = [], concurrency = 1 } = this.options\n\n    const connection = { host: redis.host, port: redis.port, password: redis.password }\n\n    // Pre-create any explicitly listed queues\n    for (const name of preCreateQueues) {\n      if (!this.queueService.getQueue(name)) {\n        const queue = new Queue(name, { connection })\n        this.queueService.registerQueue(name, queue)\n      }\n    }\n\n    // Discover all @Job-decorated classes and wire workers\n    for (const jobClass of jobRegistry) {\n      const queueName: string | undefined = Reflect.getMetadata(QUEUE_METADATA.JOB, jobClass)\n      if (queueName === undefined) continue\n\n      const handlers: ProcessDefinition[] =\n        Reflect.getMetadata(QUEUE_METADATA.PROCESS, jobClass) || []\n\n      if (handlers.length === 0) {\n        log.warn(`@Job('${queueName}') class ${jobClass.name} has no @Process methods — skipping`)\n        continue\n      }\n\n      // Ensure the queue exists\n      if (!this.queueService.getQueue(queueName)) {\n        const queue = new Queue(queueName, { connection })\n        this.queueService.registerQueue(queueName, queue)\n      }\n\n      // Resolve the processor instance from DI\n      const processor = container.resolve(jobClass)\n\n      // Build the worker processor function\n      const worker = new Worker(\n        queueName,\n        async (job: BullMQJob) => {\n          // Find a handler matching the job name\n          const specific = handlers.find((h) => h.jobName === job.name)\n          // Fall back to the catch-all handler (no jobName)\n          const handler = specific || handlers.find((h) => h.jobName === undefined)\n\n          if (handler) {\n            await processor[handler.handlerName](job)\n          } else {\n            log.warn(`No handler for job \"${job.name}\" in queue \"${queueName}\"`)\n          }\n        },\n        { connection, concurrency },\n      )\n\n      worker.on('failed', (job, err) => {\n        log.error({ err }, `Job failed: ${queueName}/${job?.name} (id: ${job?.id})`)\n      })\n\n      worker.on('completed', (job) => {\n        log.debug(`Job completed: ${queueName}/${job.name} (id: ${job.id})`)\n      })\n\n      this.workers.push(worker)\n      log.info(\n        `Worker started: ${queueName} (${jobClass.name}, ${handlers.length} handler(s), concurrency: ${concurrency})`,\n      )\n    }\n\n    // Register the QueueService in DI\n    container.registerFactory(QUEUE_MANAGER, () => this.queueService, Scope.SINGLETON)\n\n    log.info(\n      `QueueAdapter ready — ${this.queueService.getQueueNames().length} queue(s), ${this.workers.length} worker(s)`,\n    )\n  }\n\n  /** Gracefully close all workers and queues */\n  async shutdown(): Promise<void> {\n    // Close workers first so they stop picking up new jobs\n    for (const worker of this.workers) {\n      await worker.close()\n    }\n    log.info(`Closed ${this.workers.length} worker(s)`)\n    this.workers = []\n\n    // Then close queues\n    await this.queueService.closeAll()\n    log.info('All queues closed')\n  }\n}\n","import 'reflect-metadata'\n\n/** Options for configuring the QueueAdapter */\nexport interface QueueAdapterOptions {\n  /** Redis connection configuration */\n  redis: {\n    host: string\n    port: number\n    password?: string\n  }\n  /** Queue names to pre-create (optional — queues are also created on-demand) */\n  queues?: string[]\n  /** Default worker concurrency (default: 1) */\n  concurrency?: number\n}\n\n/** DI token for resolving the QueueService from the container */\nexport const QUEUE_MANAGER = Symbol('QueueManager')\n\n/** Metadata keys for queue decorators */\nexport const QUEUE_METADATA = {\n  JOB: Symbol('queue:job'),\n  PROCESS: Symbol('queue:process'),\n} as const\n\n/** Metadata stored by @Process decorator */\nexport interface ProcessDefinition {\n  /** Method name on the controller class */\n  handlerName: string\n  /** Job name to handle (undefined = handle all jobs in the queue) */\n  jobName?: string\n}\n\n/** Global registry of @Job-decorated classes */\nexport const jobRegistry = new Set<any>()\n","import type { Queue, JobsOptions } from 'bullmq'\nimport { Logger } from '@forinda/kickjs-core'\n\nconst log = Logger.for('QueueService')\n\n/** Data shape for bulk job insertion */\nexport interface BulkJobEntry {\n  name: string\n  data: any\n  opts?: JobsOptions\n}\n\n/**\n * Injectable service for adding jobs to BullMQ queues.\n *\n * Resolved from DI via `@Inject(QUEUE_MANAGER)`.\n *\n * @example\n * ```ts\n * @Service()\n * class EmailService {\n *   @Inject(QUEUE_MANAGER) private queue: QueueService\n *\n *   async sendWelcome(userId: string) {\n *     await this.queue.add('email', 'welcome', { userId })\n *   }\n * }\n * ```\n */\nexport class QueueService {\n  private queues = new Map<string, Queue>()\n\n  /** Register a queue instance (called by the adapter) */\n  registerQueue(name: string, queue: Queue): void {\n    this.queues.set(name, queue)\n    log.debug(`Queue registered: ${name}`)\n  }\n\n  /** Get a raw BullMQ Queue instance by name */\n  getQueue(name: string): Queue | undefined {\n    return this.queues.get(name)\n  }\n\n  /** Add a single job to a queue */\n  async add(queueName: string, jobName: string, data: any, opts?: JobsOptions) {\n    const queue = this.queues.get(queueName)\n    if (!queue) {\n      throw new Error(`Queue \"${queueName}\" not found. Did you register it in QueueAdapter?`)\n    }\n    const job = await queue.add(jobName, data, opts)\n    log.debug(`Job added: ${queueName}/${jobName} (id: ${job.id})`)\n    return job\n  }\n\n  /** Add multiple jobs to a queue in bulk */\n  async addBulk(queueName: string, jobs: BulkJobEntry[]) {\n    const queue = this.queues.get(queueName)\n    if (!queue) {\n      throw new Error(`Queue \"${queueName}\" not found. Did you register it in QueueAdapter?`)\n    }\n    const result = await queue.addBulk(jobs)\n    log.debug(`Bulk jobs added: ${queueName} (count: ${result.length})`)\n    return result\n  }\n\n  /** Get all registered queue names */\n  getQueueNames(): string[] {\n    return Array.from(this.queues.keys())\n  }\n\n  /** Close all queues gracefully */\n  async closeAll(): Promise<void> {\n    for (const [name, queue] of this.queues) {\n      await queue.close()\n      log.debug(`Queue closed: ${name}`)\n    }\n    this.queues.clear()\n  }\n}\n","import 'reflect-metadata'\nimport { Service } from '@forinda/kickjs-core'\nimport { QUEUE_METADATA, jobRegistry, type ProcessDefinition } from './types'\n\n/**\n * Mark a class as a job processor for a specific BullMQ queue.\n *\n * The class is automatically registered in the DI container and will\n * be discovered by the QueueAdapter during startup.\n *\n * @param queueName - The name of the BullMQ queue this class processes\n *\n * @example\n * ```ts\n * @Job('email')\n * export class EmailJobProcessor {\n *   @Process('welcome')\n *   async sendWelcome(job: BullMQJob) {\n *     await sendEmail(job.data.to, 'Welcome!')\n *   }\n *\n *   @Process()\n *   async handleAll(job: BullMQJob) {\n *     console.log('Fallback handler for:', job.name)\n *   }\n * }\n * ```\n */\nexport function Job(queueName: string): ClassDecorator {\n  return (target: any) => {\n    Service()(target)\n    Reflect.defineMetadata(QUEUE_METADATA.JOB, queueName, target)\n    jobRegistry.add(target)\n  }\n}\n\n/**\n * Mark a method as a job processor within a @Job class.\n *\n * @param jobName - Specific job name to handle. Omit to handle all jobs in the queue.\n *\n * @example\n * ```ts\n * @Job('notifications')\n * export class NotificationProcessor {\n *   @Process('push')\n *   async handlePush(job: BullMQJob) { ... }\n *\n *   @Process('sms')\n *   async handleSms(job: BullMQJob) { ... }\n *\n *   @Process()\n *   async handleDefault(job: BullMQJob) { ... }\n * }\n * ```\n */\nexport function Process(jobName?: string): MethodDecorator {\n  return (target, propertyKey) => {\n    const handlers: ProcessDefinition[] =\n      Reflect.getMetadata(QUEUE_METADATA.PROCESS, target.constructor) || []\n    handlers.push({\n      handlerName: propertyKey as string,\n      jobName,\n    })\n    Reflect.defineMetadata(QUEUE_METADATA.PROCESS, handlers, target.constructor)\n  }\n}\n"],"mappings":";;;;AAAA,SAASA,OAAOC,cAAqC;AACrD,SAASC,UAAAA,SAAyCC,aAAa;;;ACD/D,OAAO;AAiBA,IAAMC,gBAAgBC,uBAAO,cAAA;AAG7B,IAAMC,iBAAiB;EAC5BC,KAAKF,uBAAO,WAAA;EACZG,SAASH,uBAAO,eAAA;AAClB;AAWO,IAAMI,cAAc,oBAAIC,IAAAA;;;ACjC/B,SAASC,cAAc;AAEvB,IAAMC,MAAMC,OAAOC,IAAI,cAAA;AA0BhB,IAAMC,eAAN,MAAMA;EA5Bb,OA4BaA;;;EACHC,SAAS,oBAAIC,IAAAA;;EAGrBC,cAAcC,MAAcC,OAAoB;AAC9C,SAAKJ,OAAOK,IAAIF,MAAMC,KAAAA;AACtBR,QAAIU,MAAM,qBAAqBH,IAAAA,EAAM;EACvC;;EAGAI,SAASJ,MAAiC;AACxC,WAAO,KAAKH,OAAOQ,IAAIL,IAAAA;EACzB;;EAGA,MAAMM,IAAIC,WAAmBC,SAAiBC,MAAWC,MAAoB;AAC3E,UAAMT,QAAQ,KAAKJ,OAAOQ,IAAIE,SAAAA;AAC9B,QAAI,CAACN,OAAO;AACV,YAAM,IAAIU,MAAM,UAAUJ,SAAAA,mDAA4D;IACxF;AACA,UAAMK,MAAM,MAAMX,MAAMK,IAAIE,SAASC,MAAMC,IAAAA;AAC3CjB,QAAIU,MAAM,cAAcI,SAAAA,IAAaC,OAAAA,SAAgBI,IAAIC,EAAE,GAAG;AAC9D,WAAOD;EACT;;EAGA,MAAME,QAAQP,WAAmBQ,MAAsB;AACrD,UAAMd,QAAQ,KAAKJ,OAAOQ,IAAIE,SAAAA;AAC9B,QAAI,CAACN,OAAO;AACV,YAAM,IAAIU,MAAM,UAAUJ,SAAAA,mDAA4D;IACxF;AACA,UAAMS,SAAS,MAAMf,MAAMa,QAAQC,IAAAA;AACnCtB,QAAIU,MAAM,oBAAoBI,SAAAA,YAAqBS,OAAOC,MAAM,GAAG;AACnE,WAAOD;EACT;;EAGAE,gBAA0B;AACxB,WAAOC,MAAMC,KAAK,KAAKvB,OAAOwB,KAAI,CAAA;EACpC;;EAGA,MAAMC,WAA0B;AAC9B,eAAW,CAACtB,MAAMC,KAAAA,KAAU,KAAKJ,QAAQ;AACvC,YAAMI,MAAMsB,MAAK;AACjB9B,UAAIU,MAAM,iBAAiBH,IAAAA,EAAM;IACnC;AACA,SAAKH,OAAO2B,MAAK;EACnB;AACF;;;AFnEA,IAAMC,OAAMC,QAAOC,IAAI,cAAA;AAsBhB,IAAMC,eAAN,MAAMA;EAjCb,OAiCaA;;;;EACFC,OAAO;EAERC,UAAoB,CAAA;EACpBC,eAAe,IAAIC,aAAAA;EAE3B,YAAoBC,SAA8B;SAA9BA,UAAAA;EAA+B;EAEnDC,YAAYC,MAAWC,WAA4B;AACjD,UAAM,EAAEC,OAAOC,QAAQC,kBAAkB,CAAA,GAAIC,cAAc,EAAC,IAAK,KAAKP;AAEtE,UAAMQ,aAAa;MAAEC,MAAML,MAAMK;MAAMC,MAAMN,MAAMM;MAAMC,UAAUP,MAAMO;IAAS;AAGlF,eAAWf,QAAQU,iBAAiB;AAClC,UAAI,CAAC,KAAKR,aAAac,SAAShB,IAAAA,GAAO;AACrC,cAAMiB,QAAQ,IAAIC,MAAMlB,MAAM;UAAEY;QAAW,CAAA;AAC3C,aAAKV,aAAaiB,cAAcnB,MAAMiB,KAAAA;MACxC;IACF;AAGA,eAAWG,YAAYC,aAAa;AAClC,YAAMC,YAAgCC,QAAQC,YAAYC,eAAeC,KAAKN,QAAAA;AAC9E,UAAIE,cAAcK,OAAW;AAE7B,YAAMC,WACJL,QAAQC,YAAYC,eAAeI,SAAST,QAAAA,KAAa,CAAA;AAE3D,UAAIQ,SAASE,WAAW,GAAG;AACzBlC,QAAAA,KAAImC,KAAK,SAAST,SAAAA,YAAqBF,SAASpB,IAAI,0CAAqC;AACzF;MACF;AAGA,UAAI,CAAC,KAAKE,aAAac,SAASM,SAAAA,GAAY;AAC1C,cAAML,QAAQ,IAAIC,MAAMI,WAAW;UAAEV;QAAW,CAAA;AAChD,aAAKV,aAAaiB,cAAcG,WAAWL,KAAAA;MAC7C;AAGA,YAAMe,YAAYzB,UAAU0B,QAAQb,QAAAA;AAGpC,YAAMc,SAAS,IAAIC,OACjBb,WACA,OAAOc,QAAAA;AAEL,cAAMC,WAAWT,SAASU,KAAK,CAACC,MAAMA,EAAEC,YAAYJ,IAAIpC,IAAI;AAE5D,cAAMyC,UAAUJ,YAAYT,SAASU,KAAK,CAACC,MAAMA,EAAEC,YAAYb,MAAAA;AAE/D,YAAIc,SAAS;AACX,gBAAMT,UAAUS,QAAQC,WAAW,EAAEN,GAAAA;QACvC,OAAO;AACLxC,UAAAA,KAAImC,KAAK,uBAAuBK,IAAIpC,IAAI,eAAesB,SAAAA,GAAY;QACrE;MACF,GACA;QAAEV;QAAYD;MAAY,CAAA;AAG5BuB,aAAOS,GAAG,UAAU,CAACP,KAAKQ,QAAAA;AACxBhD,QAAAA,KAAIiD,MAAM;UAAED;QAAI,GAAG,eAAetB,SAAAA,IAAac,KAAKpC,IAAAA,SAAaoC,KAAKU,EAAAA,GAAK;MAC7E,CAAA;AAEAZ,aAAOS,GAAG,aAAa,CAACP,QAAAA;AACtBxC,QAAAA,KAAImD,MAAM,kBAAkBzB,SAAAA,IAAac,IAAIpC,IAAI,SAASoC,IAAIU,EAAE,GAAG;MACrE,CAAA;AAEA,WAAK7C,QAAQ+C,KAAKd,MAAAA;AAClBtC,MAAAA,KAAIqD,KACF,mBAAmB3B,SAAAA,KAAcF,SAASpB,IAAI,KAAK4B,SAASE,MAAM,6BAA6BnB,WAAAA,GAAc;IAEjH;AAGAJ,cAAU2C,gBAAgBC,eAAe,MAAM,KAAKjD,cAAckD,MAAMC,SAAS;AAEjFzD,IAAAA,KAAIqD,KACF,6BAAwB,KAAK/C,aAAaoD,cAAa,EAAGxB,MAAM,cAAc,KAAK7B,QAAQ6B,MAAM,YAAY;EAEjH;;EAGA,MAAMyB,WAA0B;AAE9B,eAAWrB,UAAU,KAAKjC,SAAS;AACjC,YAAMiC,OAAOsB,MAAK;IACpB;AACA5D,IAAAA,KAAIqD,KAAK,UAAU,KAAKhD,QAAQ6B,MAAM,YAAY;AAClD,SAAK7B,UAAU,CAAA;AAGf,UAAM,KAAKC,aAAauD,SAAQ;AAChC7D,IAAAA,KAAIqD,KAAK,mBAAA;EACX;AACF;;;AGjIA,OAAO;AACP,SAASS,eAAe;AA2BjB,SAASC,IAAIC,WAAiB;AACnC,SAAO,CAACC,WAAAA;AACNC,YAAAA,EAAUD,MAAAA;AACVE,YAAQC,eAAeC,eAAeC,KAAKN,WAAWC,MAAAA;AACtDM,gBAAYC,IAAIP,MAAAA;EAClB;AACF;AANgBF;AA4BT,SAASU,QAAQC,SAAgB;AACtC,SAAO,CAACT,QAAQU,gBAAAA;AACd,UAAMC,WACJT,QAAQU,YAAYR,eAAeS,SAASb,OAAO,WAAW,KAAK,CAAA;AACrEW,aAASG,KAAK;MACZC,aAAaL;MACbD;IACF,CAAA;AACAP,YAAQC,eAAeC,eAAeS,SAASF,UAAUX,OAAO,WAAW;EAC7E;AACF;AAVgBQ;","names":["Queue","Worker","Logger","Scope","QUEUE_MANAGER","Symbol","QUEUE_METADATA","JOB","PROCESS","jobRegistry","Set","Logger","log","Logger","for","QueueService","queues","Map","registerQueue","name","queue","set","debug","getQueue","get","add","queueName","jobName","data","opts","Error","job","id","addBulk","jobs","result","length","getQueueNames","Array","from","keys","closeAll","close","clear","log","Logger","for","QueueAdapter","name","workers","queueService","QueueService","options","beforeStart","_app","container","redis","queues","preCreateQueues","concurrency","connection","host","port","password","getQueue","queue","Queue","registerQueue","jobClass","jobRegistry","queueName","Reflect","getMetadata","QUEUE_METADATA","JOB","undefined","handlers","PROCESS","length","warn","processor","resolve","worker","Worker","job","specific","find","h","jobName","handler","handlerName","on","err","error","id","debug","push","info","registerFactory","QUEUE_MANAGER","Scope","SINGLETON","getQueueNames","shutdown","close","closeAll","Service","Job","queueName","target","Service","Reflect","defineMetadata","QUEUE_METADATA","JOB","jobRegistry","add","Process","jobName","propertyKey","handlers","getMetadata","PROCESS","push","handlerName"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@forinda/kickjs-queue",
+  "version": "0.6.0",
+  "description": "BullMQ queue/worker adapter with decorator-driven job processing for KickJS",
+  "keywords": [
+    "kickjs",
+    "nodejs",
+    "typescript",
+    "queue",
+    "worker",
+    "bullmq",
+    "jobs",
+    "background-jobs",
+    "adapter",
+    "@forinda/kickjs-core"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "@forinda/kickjs-core": "0.7.0"
+  },
+  "peerDependencies": {
+    "bullmq": ">=5.0.0",
+    "ioredis": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Felix Orinda",
+  "engines": {
+    "node": ">=20.0"
+  },
+  "homepage": "https://forinda.github.io/kick-js/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/forinda/kick-js.git",
+    "directory": "packages/queue"
+  },
+  "bugs": {
+    "url": "https://github.com/forinda/kick-js/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo",
+    "lint": "tsc --noEmit"
+  }
+}