@riktajs/queue 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Constants and DI tokens for @riktajs/queue
+ */
+/** Metadata keys for decorator reflection */
+export declare const METADATA_KEY: {
+    /** Queue class decorator options */
+    readonly QUEUE_OPTIONS: "riktajs:queue:options";
+    /** Processor class decorator options */
+    readonly PROCESSOR_OPTIONS: "riktajs:queue:processor:options";
+    /** Job handler method metadata */
+    readonly JOB_HANDLERS: "riktajs:queue:job:handlers";
+    /** Event handler method metadata */
+    readonly EVENT_HANDLERS: "riktajs:queue:event:handlers";
+};
+/** DI token for the QueueProvider */
+export declare const QUEUE_PROVIDER: unique symbol;
+/** DI token for the QueueService */
+export declare const QUEUE_SERVICE: unique symbol;
+/** DI token for the Redis connection */
+export declare const QUEUE_REDIS_CONNECTION: unique symbol;
+/** DI token for the queue configuration */
+export declare const QUEUE_CONFIG: unique symbol;
+/**
+ * Get the DI token for a named queue
+ * @param name - The queue name
+ */
+export declare function getQueueToken(name: string): symbol;
+/**
+ * Get the DI token for a named worker
+ * @param name - The queue name
+ */
+export declare function getWorkerToken(name: string): symbol;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,YAAY;IACvB,oCAAoC;;IAEpC,wCAAwC;;IAExC,kCAAkC;;IAElC,oCAAoC;;CAE5B,CAAC;AAEX,qCAAqC;AACrC,eAAO,MAAM,cAAc,eAA+B,CAAC;AAE3D,oCAAoC;AACpC,eAAO,MAAM,aAAa,eAA8B,CAAC;AAEzD,wCAAwC;AACxC,eAAO,MAAM,sBAAsB,eAAuC,CAAC;AAE3E,2CAA2C;AAC3C,eAAO,MAAM,YAAY,eAA6B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/constants.js

@@ -0,0 +1,37 @@
+/**
+ * Constants and DI tokens for @riktajs/queue
+ */
+/** Metadata keys for decorator reflection */
+export const METADATA_KEY = {
+    /** Queue class decorator options */
+    QUEUE_OPTIONS: 'riktajs:queue:options',
+    /** Processor class decorator options */
+    PROCESSOR_OPTIONS: 'riktajs:queue:processor:options',
+    /** Job handler method metadata */
+    JOB_HANDLERS: 'riktajs:queue:job:handlers',
+    /** Event handler method metadata */
+    EVENT_HANDLERS: 'riktajs:queue:event:handlers',
+};
+/** DI token for the QueueProvider */
+export const QUEUE_PROVIDER = Symbol.for('QUEUE_PROVIDER');
+/** DI token for the QueueService */
+export const QUEUE_SERVICE = Symbol.for('QUEUE_SERVICE');
+/** DI token for the Redis connection */
+export const QUEUE_REDIS_CONNECTION = Symbol.for('QUEUE_REDIS_CONNECTION');
+/** DI token for the queue configuration */
+export const QUEUE_CONFIG = Symbol.for('QUEUE_CONFIG');
+/**
+ * Get the DI token for a named queue
+ * @param name - The queue name
+ */
+export function getQueueToken(name) {
+    return Symbol.for(`QUEUE:${name}`);
+}
+/**
+ * Get the DI token for a named worker
+ * @param name - The queue name
+ */
+export function getWorkerToken(name) {
+    return Symbol.for(`WORKER:${name}`);
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oCAAoC;IACpC,aAAa,EAAE,uBAAuB;IACtC,wCAAwC;IACxC,iBAAiB,EAAE,iCAAiC;IACpD,kCAAkC;IAClC,YAAY,EAAE,4BAA4B;IAC1C,oCAAoC;IACpC,cAAc,EAAE,8BAA8B;CACtC,CAAC;AAEX,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE3D,oCAAoC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAEzD,wCAAwC;AACxC,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAE3E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/decorators/events.decorator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Event decorators for job lifecycle events
+ */
+import 'reflect-metadata';
+import type { EventHandlerMeta, QueueEventName } from '../types.js';
+/**
+ * Decorator for handling job completion events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobComplete()
+ *   async handleComplete(job: Job, result: unknown) {
+ *     console.log(`Job ${job.id} completed with:`, result);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnJobComplete(): MethodDecorator;
+/**
+ * Decorator for handling job failure events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobFailed()
+ *   async handleFailed(job: Job, error: Error) {
+ *     console.error(`Job ${job.id} failed:`, error);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnJobFailed(): MethodDecorator;
+/**
+ * Decorator for handling job progress events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobProgress()
+ *   async handleProgress(job: Job, progress: number | object) {
+ *     console.log(`Job ${job.id} progress:`, progress);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnJobProgress(): MethodDecorator;
+/**
+ * Decorator for handling job stalled events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobStalled()
+ *   async handleStalled(jobId: string) {
+ *     console.warn(`Job ${jobId} stalled`);
+ *   }
+ * }
+ * ```
+ */
+export declare function OnJobStalled(): MethodDecorator;
+/**
+ * Decorator for handling worker ready events
+ */
+export declare function OnWorkerReady(): MethodDecorator;
+/**
+ * Decorator for handling worker error events
+ */
+export declare function OnWorkerError(): MethodDecorator;
+/**
+ * Get all event handlers from a processor class
+ * @param target - The processor class
+ */
+export declare function getEventHandlers(target: Function): EventHandlerMeta[];
+/**
+ * Get event handlers for a specific event
+ * @param target - The processor class
+ * @param event - The event name
+ */
+export declare function getEventHandlersFor(target: Function, event: QueueEventName): EventHandlerMeta[];
+//# sourceMappingURL=events.decorator.d.ts.map

package/dist/decorators/events.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/events.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmCpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,IAAI,eAAe,CAE7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAE/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,EAAE,CAErE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,cAAc,GACpB,gBAAgB,EAAE,CAEpB"}

package/dist/decorators/events.decorator.js

@@ -0,0 +1,120 @@
+/**
+ * Event decorators for job lifecycle events
+ */
+import 'reflect-metadata';
+import { METADATA_KEY } from '../constants.js';
+/**
+ * Factory function to create event decorators
+ * @internal
+ */
+function createEventDecorator(event) {
+    return (target, propertyKey, _descriptor) => {
+        const methodName = String(propertyKey);
+        // Get existing handlers or create new array
+        const existingHandlers = Reflect.getMetadata(METADATA_KEY.EVENT_HANDLERS, target.constructor) || [];
+        // Add this handler
+        const handler = {
+            event,
+            methodName,
+        };
+        existingHandlers.push(handler);
+        // Store updated handlers
+        Reflect.defineMetadata(METADATA_KEY.EVENT_HANDLERS, existingHandlers, target.constructor);
+    };
+}
+/**
+ * Decorator for handling job completion events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobComplete()
+ *   async handleComplete(job: Job, result: unknown) {
+ *     console.log(`Job ${job.id} completed with:`, result);
+ *   }
+ * }
+ * ```
+ */
+export function OnJobComplete() {
+    return createEventDecorator('job:completed');
+}
+/**
+ * Decorator for handling job failure events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobFailed()
+ *   async handleFailed(job: Job, error: Error) {
+ *     console.error(`Job ${job.id} failed:`, error);
+ *   }
+ * }
+ * ```
+ */
+export function OnJobFailed() {
+    return createEventDecorator('job:failed');
+}
+/**
+ * Decorator for handling job progress events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobProgress()
+ *   async handleProgress(job: Job, progress: number | object) {
+ *     console.log(`Job ${job.id} progress:`, progress);
+ *   }
+ * }
+ * ```
+ */
+export function OnJobProgress() {
+    return createEventDecorator('job:progress');
+}
+/**
+ * Decorator for handling job stalled events
+ *
+ * @example
+ * ```typescript
+ * @Processor('my-queue')
+ * class MyProcessor {
+ *   @OnJobStalled()
+ *   async handleStalled(jobId: string) {
+ *     console.warn(`Job ${jobId} stalled`);
+ *   }
+ * }
+ * ```
+ */
+export function OnJobStalled() {
+    return createEventDecorator('job:stalled');
+}
+/**
+ * Decorator for handling worker ready events
+ */
+export function OnWorkerReady() {
+    return createEventDecorator('worker:ready');
+}
+/**
+ * Decorator for handling worker error events
+ */
+export function OnWorkerError() {
+    return createEventDecorator('worker:error');
+}
+/**
+ * Get all event handlers from a processor class
+ * @param target - The processor class
+ */
+export function getEventHandlers(target) {
+    return Reflect.getMetadata(METADATA_KEY.EVENT_HANDLERS, target) || [];
+}
+/**
+ * Get event handlers for a specific event
+ * @param target - The processor class
+ * @param event - The event name
+ */
+export function getEventHandlersFor(target, event) {
+    return getEventHandlers(target).filter(h => h.event === event);
+}
+//# sourceMappingURL=events.decorator.js.map

package/dist/decorators/events.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.decorator.js","sourceRoot":"","sources":["../../src/decorators/events.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;GAGG;AACH,SAAS,oBAAoB,CAAC,KAAqB;IACjD,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,WAA+B,EAC/B,EAAE;QACF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvC,4CAA4C;QAC5C,MAAM,gBAAgB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAE7E,mBAAmB;QACnB,MAAM,OAAO,GAAqB;YAChC,KAAK;YACL,UAAU;SACX,CAAC;QAEF,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/B,yBAAyB;QACzB,OAAO,CAAC,cAAc,CACpB,YAAY,CAAC,cAAc,EAC3B,gBAAgB,EAChB,MAAM,CAAC,WAAW,CACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,CAAC,eAAe,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,oBAAoB,CAAC,cAAc,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAgB,EAChB,KAAqB;IAErB,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;AACjE,CAAC"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Decorators for @riktajs/queue
+ */
+export * from './queue.decorator.js';
+export * from './processor.decorator.js';
+export * from './process.decorator.js';
+export * from './events.decorator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/decorators/index.js

@@ -0,0 +1,8 @@
+/**
+ * Decorators for @riktajs/queue
+ */
+export * from './queue.decorator.js';
+export * from './processor.decorator.js';
+export * from './process.decorator.js';
+export * from './events.decorator.js';
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/decorators/process.decorator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @Process decorator - marks a method as a job handler
+ */
+import 'reflect-metadata';
+import type { JobHandlerMeta } from '../types.js';
+/**
+ * Decorator to define a job handler method
+ *
+ * @param jobName - The name of the job to handle (default: method name)
+ * @returns MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * @Processor('email-queue')
+ * class EmailProcessor {
+ *   @Process('send')
+ *   async handleSendEmail(job: Job<EmailData>) {
+ *     await sendEmail(job.data);
+ *     return { sent: true };
+ *   }
+ *
+ *   @Process() // Uses method name as job name
+ *   async welcome(job: Job<WelcomeData>) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare function Process(jobName?: string): MethodDecorator;
+/**
+ * Get all job handlers from a processor class
+ * @param target - The processor class
+ */
+export declare function getJobHandlers(target: Function): JobHandlerMeta[];
+/**
+ * Check if a method is decorated with @Process
+ * @param target - The class
+ * @param methodName - The method name
+ */
+export declare function isJobHandler(target: Function, methodName: string): boolean;
+//# sourceMappingURL=process.decorator.d.ts.map

package/dist/decorators/process.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/process.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CA4BzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,EAAE,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAG1E"}

package/dist/decorators/process.decorator.js

@@ -0,0 +1,61 @@
+/**
+ * @Process decorator - marks a method as a job handler
+ */
+import 'reflect-metadata';
+import { METADATA_KEY } from '../constants.js';
+/**
+ * Decorator to define a job handler method
+ *
+ * @param jobName - The name of the job to handle (default: method name)
+ * @returns MethodDecorator
+ *
+ * @example
+ * ```typescript
+ * @Processor('email-queue')
+ * class EmailProcessor {
+ *   @Process('send')
+ *   async handleSendEmail(job: Job<EmailData>) {
+ *     await sendEmail(job.data);
+ *     return { sent: true };
+ *   }
+ *
+ *   @Process() // Uses method name as job name
+ *   async welcome(job: Job<WelcomeData>) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export function Process(jobName) {
+    return (target, propertyKey, _descriptor) => {
+        const methodName = String(propertyKey);
+        const name = jobName || methodName;
+        // Get existing handlers or create new array
+        const existingHandlers = Reflect.getMetadata(METADATA_KEY.JOB_HANDLERS, target.constructor) || [];
+        // Add this handler
+        const handler = {
+            name,
+            methodName,
+        };
+        existingHandlers.push(handler);
+        // Store updated handlers
+        Reflect.defineMetadata(METADATA_KEY.JOB_HANDLERS, existingHandlers, target.constructor);
+    };
+}
+/**
+ * Get all job handlers from a processor class
+ * @param target - The processor class
+ */
+export function getJobHandlers(target) {
+    return Reflect.getMetadata(METADATA_KEY.JOB_HANDLERS, target) || [];
+}
+/**
+ * Check if a method is decorated with @Process
+ * @param target - The class
+ * @param methodName - The method name
+ */
+export function isJobHandler(target, methodName) {
+    const handlers = getJobHandlers(target);
+    return handlers.some(h => h.methodName === methodName);
+}
+//# sourceMappingURL=process.decorator.js.map

package/dist/decorators/process.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.decorator.js","sourceRoot":"","sources":["../../src/decorators/process.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,WAA+B,EAC/B,EAAE;QACF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,OAAO,IAAI,UAAU,CAAC;QAEnC,4CAA4C;QAC5C,MAAM,gBAAgB,GACpB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAE3E,mBAAmB;QACnB,MAAM,OAAO,GAAmB;YAC9B,IAAI;YACJ,UAAU;SACX,CAAC;QAEF,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE/B,yBAAyB;QACzB,OAAO,CAAC,cAAc,CACpB,YAAY,CAAC,YAAY,EACzB,gBAAgB,EAChB,MAAM,CAAC,WAAW,CACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAgB,EAAE,UAAkB;IAC/D,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;AACzD,CAAC"}

package/dist/decorators/processor.decorator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @Processor decorator - marks a class as a job processor
+ */
+import 'reflect-metadata';
+import type { ProcessorOptions } from '../types.js';
+/**
+ * Decorator to define a job processor for a queue
+ *
+ * @param queueName - The name of the queue to process
+ * @param options - Optional processor configuration
+ * @returns ClassDecorator
+ *
+ * @example
+ * ```typescript
+ * @Processor('email-queue', { concurrency: 5 })
+ * class EmailProcessor {
+ *   @Process('send')
+ *   async handleSendEmail(job: Job) {
+ *     // process job
+ *   }
+ * }
+ * ```
+ */
+export declare function Processor(queueName: string, options?: Omit<ProcessorOptions, 'queueName'>): ClassDecorator;
+/**
+ * Get processor options from a decorated class
+ * @param target - The decorated class
+ */
+export declare function getProcessorOptions(target: Function): ProcessorOptions | undefined;
+/**
+ * Check if a class is decorated with @Processor
+ * @param target - The class to check
+ */
+export declare function isProcessor(target: Function): boolean;
+/**
+ * Error thrown when @Processor decorator is used incorrectly
+ */
+export declare class ProcessorDecoratorError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=processor.decorator.d.ts.map

package/dist/decorators/processor.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/processor.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAC5C,cAAc,CAahB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/decorators/processor.decorator.js

@@ -0,0 +1,59 @@
+/**
+ * @Processor decorator - marks a class as a job processor
+ */
+import 'reflect-metadata';
+import { METADATA_KEY } from '../constants.js';
+/**
+ * Decorator to define a job processor for a queue
+ *
+ * @param queueName - The name of the queue to process
+ * @param options - Optional processor configuration
+ * @returns ClassDecorator
+ *
+ * @example
+ * ```typescript
+ * @Processor('email-queue', { concurrency: 5 })
+ * class EmailProcessor {
+ *   @Process('send')
+ *   async handleSendEmail(job: Job) {
+ *     // process job
+ *   }
+ * }
+ * ```
+ */
+export function Processor(queueName, options) {
+    if (!queueName) {
+        throw new ProcessorDecoratorError('Queue name is required for @Processor');
+    }
+    const processorOptions = {
+        queueName,
+        ...options,
+    };
+    return (target) => {
+        Reflect.defineMetadata(METADATA_KEY.PROCESSOR_OPTIONS, processorOptions, target);
+    };
+}
+/**
+ * Get processor options from a decorated class
+ * @param target - The decorated class
+ */
+export function getProcessorOptions(target) {
+    return Reflect.getMetadata(METADATA_KEY.PROCESSOR_OPTIONS, target);
+}
+/**
+ * Check if a class is decorated with @Processor
+ * @param target - The class to check
+ */
+export function isProcessor(target) {
+    return Reflect.hasMetadata(METADATA_KEY.PROCESSOR_OPTIONS, target);
+}
+/**
+ * Error thrown when @Processor decorator is used incorrectly
+ */
+export class ProcessorDecoratorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ProcessorDecoratorError';
+    }
+}
+//# sourceMappingURL=processor.decorator.js.map

package/dist/decorators/processor.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.decorator.js","sourceRoot":"","sources":["../../src/decorators/processor.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,OAA6C;IAE7C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,uBAAuB,CAAC,uCAAuC,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,gBAAgB,GAAqB;QACzC,SAAS;QACT,GAAG,OAAO;KACX,CAAC;IAEF,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB;IAC1C,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/decorators/queue.decorator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @Queue decorator - marks a class as a queue definition
+ */
+import 'reflect-metadata';
+import type { QueueDecoratorOptions } from '../types.js';
+/**
+ * Decorator to define a queue
+ *
+ * @param options - Queue configuration options
+ * @returns ClassDecorator
+ *
+ * @example
+ * ```typescript
+ * @Queue({ name: 'email-queue' })
+ * class EmailQueue {}
+ * ```
+ */
+export declare function Queue(options: QueueDecoratorOptions): ClassDecorator;
+/**
+ * Get queue options from a decorated class
+ * @param target - The decorated class
+ */
+export declare function getQueueOptions(target: Function): QueueDecoratorOptions | undefined;
+/**
+ * Check if a class is decorated with @Queue
+ * @param target - The class to check
+ */
+export declare function isQueue(target: Function): boolean;
+/**
+ * Error thrown when @Queue decorator is used incorrectly
+ */
+export declare class QueueDecoratorError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=queue.decorator.d.ts.map

package/dist/decorators/queue.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/queue.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAQpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,qBAAqB,GAAG,SAAS,CAEnF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/decorators/queue.decorator.js

@@ -0,0 +1,49 @@
+/**
+ * @Queue decorator - marks a class as a queue definition
+ */
+import 'reflect-metadata';
+import { METADATA_KEY } from '../constants.js';
+/**
+ * Decorator to define a queue
+ *
+ * @param options - Queue configuration options
+ * @returns ClassDecorator
+ *
+ * @example
+ * ```typescript
+ * @Queue({ name: 'email-queue' })
+ * class EmailQueue {}
+ * ```
+ */
+export function Queue(options) {
+    if (!options.name) {
+        throw new QueueDecoratorError('Queue name is required');
+    }
+    return (target) => {
+        Reflect.defineMetadata(METADATA_KEY.QUEUE_OPTIONS, options, target);
+    };
+}
+/**
+ * Get queue options from a decorated class
+ * @param target - The decorated class
+ */
+export function getQueueOptions(target) {
+    return Reflect.getMetadata(METADATA_KEY.QUEUE_OPTIONS, target);
+}
+/**
+ * Check if a class is decorated with @Queue
+ * @param target - The class to check
+ */
+export function isQueue(target) {
+    return Reflect.hasMetadata(METADATA_KEY.QUEUE_OPTIONS, target);
+}
+/**
+ * Error thrown when @Queue decorator is used incorrectly
+ */
+export class QueueDecoratorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'QueueDecoratorError';
+    }
+}
+//# sourceMappingURL=queue.decorator.js.map

package/dist/decorators/queue.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.decorator.js","sourceRoot":"","sources":["../../src/decorators/queue.decorator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,OAA8B;IAClD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,mBAAmB,CAAC,wBAAwB,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,cAAc,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgB;IAC9C,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAgB;IACtC,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/events/queue-events.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Queue events integration with Rikta's EventBus
+ */
+/** Event names for queue events */
+export type QueueEventName = 'job:added' | 'job:completed' | 'job:failed' | 'job:progress' | 'job:stalled' | 'job:delayed' | 'job:removed' | 'worker:ready' | 'worker:closed' | 'worker:error';
+/** Event bus event names with prefix */
+export declare const QUEUE_EVENTS: {
+    readonly JOB_ADDED: "queue:job:added";
+    readonly JOB_COMPLETED: "queue:job:completed";
+    readonly JOB_FAILED: "queue:job:failed";
+    readonly JOB_PROGRESS: "queue:job:progress";
+    readonly JOB_STALLED: "queue:job:stalled";
+    readonly JOB_DELAYED: "queue:job:delayed";
+    readonly JOB_REMOVED: "queue:job:removed";
+    readonly WORKER_READY: "queue:worker:ready";
+    readonly WORKER_CLOSED: "queue:worker:closed";
+    readonly WORKER_ERROR: "queue:worker:error";
+};
+/**
+ * Map internal event names to EventBus event names
+ */
+export declare function getEventBusEventName(event: QueueEventName): string;
+/**
+ * Publish a queue event to the EventBus
+ *
+ * @param eventBus - Rikta's EventBus instance
+ * @param event - The event name
+ * @param queueName - The queue name
+ * @param args - Event arguments (job, result, error, etc.)
+ */
+export declare function publishQueueEvent(eventBus: unknown, event: QueueEventName, queueName: string, ...args: unknown[]): Promise<void>;
+//# sourceMappingURL=queue-events.d.ts.map