@riktajs/queue 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-events.d.ts","sourceRoot":"","sources":["../../src/events/queue-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,mCAAmC;AACnC,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,eAAe,GACf,YAAY,GACZ,cAAc,GACd,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,GACd,eAAe,GACf,cAAc,CAAC;AAEnB,wCAAwC;AACxC,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAEX;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAyBlE;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/events/queue-events.js

@@ -0,0 +1,103 @@
+/**
+ * Queue events integration with Rikta's EventBus
+ */
+/** Event bus event names with prefix */
+export const QUEUE_EVENTS = {
+    JOB_ADDED: 'queue:job:added',
+    JOB_COMPLETED: 'queue:job:completed',
+    JOB_FAILED: 'queue:job:failed',
+    JOB_PROGRESS: 'queue:job:progress',
+    JOB_STALLED: 'queue:job:stalled',
+    JOB_DELAYED: 'queue:job:delayed',
+    JOB_REMOVED: 'queue:job:removed',
+    WORKER_READY: 'queue:worker:ready',
+    WORKER_CLOSED: 'queue:worker:closed',
+    WORKER_ERROR: 'queue:worker:error',
+};
+/**
+ * Map internal event names to EventBus event names
+ */
+export function getEventBusEventName(event) {
+    switch (event) {
+        case 'job:added':
+            return QUEUE_EVENTS.JOB_ADDED;
+        case 'job:completed':
+            return QUEUE_EVENTS.JOB_COMPLETED;
+        case 'job:failed':
+            return QUEUE_EVENTS.JOB_FAILED;
+        case 'job:progress':
+            return QUEUE_EVENTS.JOB_PROGRESS;
+        case 'job:stalled':
+            return QUEUE_EVENTS.JOB_STALLED;
+        case 'job:delayed':
+            return QUEUE_EVENTS.JOB_DELAYED;
+        case 'job:removed':
+            return QUEUE_EVENTS.JOB_REMOVED;
+        case 'worker:ready':
+            return QUEUE_EVENTS.WORKER_READY;
+        case 'worker:closed':
+            return QUEUE_EVENTS.WORKER_CLOSED;
+        case 'worker:error':
+            return QUEUE_EVENTS.WORKER_ERROR;
+        default:
+            return `queue:${event}`;
+    }
+}
+/**
+ * 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 async function publishQueueEvent(eventBus, event, queueName, ...args) {
+    if (!eventBus || typeof eventBus.emit !== 'function') {
+        return;
+    }
+    const eventName = getEventBusEventName(event);
+    const payload = createEventPayload(event, queueName, args);
+    await eventBus.emit(eventName, payload);
+}
+/**
+ * Create an event payload from event arguments
+ */
+function createEventPayload(event, queueName, args) {
+    const base = {
+        queueName,
+        jobId: '',
+        jobName: '',
+        data: null,
+        timestamp: Date.now(),
+    };
+    const job = args[0];
+    if (typeof job === 'object' && job !== null) {
+        base.jobId = job.id || '';
+        base.jobName = job.name || '';
+        base.data = job.data;
+    }
+    else if (typeof job === 'string') {
+        // For stalled events, first arg is jobId
+        base.jobId = job;
+    }
+    switch (event) {
+        case 'job:completed':
+            base.returnValue = args[1];
+            break;
+        case 'job:failed':
+            base.error = args[1] instanceof Error
+                ? args[1].message
+                : String(args[1]);
+            break;
+        case 'job:progress':
+            base.progress = args[1];
+            break;
+        case 'worker:error':
+            base.error = args[0] instanceof Error
+                ? args[0].message
+                : String(args[0]);
+            break;
+    }
+    return base;
+}
+//# sourceMappingURL=queue-events.js.map

package/dist/events/queue-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-events.js","sourceRoot":"","sources":["../../src/events/queue-events.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @riktajs/queue
+ *
+ * BullMQ-based job queue integration for Rikta Framework.
+ *
+ * @packageDocumentation
+ */
+export * from './constants.js';
+export * from './types.js';
+export * from './config/queue.config.js';
+export { Queue, getQueueOptions, isQueue, QueueDecoratorError, } from './decorators/queue.decorator.js';
+export { Processor, getProcessorOptions, isProcessor, ProcessorDecoratorError, } from './decorators/processor.decorator.js';
+export { Process, getJobHandlers, isJobHandler, } from './decorators/process.decorator.js';
+export { OnJobComplete, OnJobFailed, OnJobProgress, OnJobStalled, OnWorkerReady, OnWorkerError, getEventHandlers, getEventHandlersFor, } from './decorators/events.decorator.js';
+export * from './providers/queue.provider.js';
+export * from './services/queue.service.js';
+export { QUEUE_EVENTS, getEventBusEventName, publishQueueEvent, } from './events/queue-events.js';
+export type { QueueEventName } from './events/queue-events.js';
+export * from './monitoring/bull-board.js';
+export * from './utils/connection.js';
+export * from './utils/validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EACL,KAAK,EACL,eAAe,EACf,OAAO,EACP,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,cAAc,EACd,YAAY,GACb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAG1C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,6BAA6B,CAAC;AAG5C,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * @riktajs/queue
+ *
+ * BullMQ-based job queue integration for Rikta Framework.
+ *
+ * @packageDocumentation
+ */
+// Constants and tokens
+export * from './constants.js';
+// Types
+export * from './types.js';
+// Configuration
+export * from './config/queue.config.js';
+// Decorators
+export { Queue, getQueueOptions, isQueue, QueueDecoratorError, } from './decorators/queue.decorator.js';
+export { Processor, getProcessorOptions, isProcessor, ProcessorDecoratorError, } from './decorators/processor.decorator.js';
+export { Process, getJobHandlers, isJobHandler, } from './decorators/process.decorator.js';
+export { OnJobComplete, OnJobFailed, OnJobProgress, OnJobStalled, OnWorkerReady, OnWorkerError, getEventHandlers, getEventHandlersFor, } from './decorators/events.decorator.js';
+// Providers
+export * from './providers/queue.provider.js';
+// Services
+export * from './services/queue.service.js';
+// Events
+export { QUEUE_EVENTS, getEventBusEventName, publishQueueEvent, } from './events/queue-events.js';
+// Monitoring (optional Bull Board integration)
+export * from './monitoring/bull-board.js';
+// Utils
+export * from './utils/connection.js';
+export * from './utils/validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uBAAuB;AACvB,cAAc,gBAAgB,CAAC;AAE/B,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,gBAAgB;AAChB,cAAc,0BAA0B,CAAC;AAEzC,aAAa;AACb,OAAO,EACL,KAAK,EACL,eAAe,EACf,OAAO,EACP,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,cAAc,EACd,YAAY,GACb,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,YAAY;AACZ,cAAc,+BAA+B,CAAC;AAE9C,WAAW;AACX,cAAc,6BAA6B,CAAC;AAE5C,SAAS;AACT,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,+CAA+C;AAC/C,cAAc,4BAA4B,CAAC;AAE3C,QAAQ;AACR,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/monitoring/bull-board.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Bull Board integration for queue monitoring
+ *
+ * This module provides optional Bull Board dashboard integration.
+ * Bull Board packages are NOT included as dependencies - install them separately:
+ *
+ * npm install @bull-board/api @bull-board/fastify
+ *
+ * @example
+ * ```typescript
+ * import { registerBullBoard } from '@riktajs/queue';
+ *
+ * // In your Rikta bootstrap:
+ * const app = await Rikta.create();
+ *
+ * // After queue provider is initialized:
+ * await registerBullBoard(app.server, {
+ *   queues: queueProvider.getAllQueues(),
+ *   path: '/admin/queues',
+ *   auth: async (req) => {
+ *     // Your auth logic here
+ *     return req.headers.authorization === 'Bearer secret';
+ *   },
+ * });
+ * ```
+ */
+import type { FastifyInstance, FastifyRequest } from 'fastify';
+import type { Queue } from 'bullmq';
+/** Options for Bull Board registration */
+export interface BullBoardOptions {
+    /** Queues to display in the dashboard */
+    queues: Queue[];
+    /** Base path for the dashboard (default: '/admin/queues') */
+    path?: string;
+    /** Authentication function - return true to allow access */
+    auth?: (request: FastifyRequest) => boolean | Promise<boolean>;
+    /** Whether to use read-only mode */
+    readOnly?: boolean;
+}
+/** Result of Bull Board registration */
+export interface BullBoardResult {
+    /** The path where the dashboard is mounted */
+    path: string;
+    /** Function to add more queues dynamically */
+    addQueue: (queue: Queue) => void;
+    /** Function to remove a queue from the dashboard */
+    removeQueue: (queueName: string) => void;
+}
+/**
+ * Register Bull Board dashboard with Fastify
+ *
+ * @param app - Fastify instance
+ * @param options - Dashboard configuration
+ * @returns Bull Board control object
+ *
+ * @throws BullBoardNotInstalledError if @bull-board packages are not installed
+ *
+ * @example
+ * ```typescript
+ * const board = await registerBullBoard(app.server, {
+ *   queues: queueProvider.getAllQueues(),
+ *   path: '/admin/queues',
+ *   auth: (req) => checkAdminAuth(req),
+ * });
+ *
+ * // Add more queues later
+ * board.addQueue(newQueue);
+ * ```
+ */
+export declare function registerBullBoard(app: FastifyInstance, options: BullBoardOptions): Promise<BullBoardResult>;
+/**
+ * Error thrown when Bull Board packages are not installed
+ */
+export declare class BullBoardNotInstalledError extends Error {
+    constructor();
+}
+//# sourceMappingURL=bull-board.d.ts.map

package/dist/monitoring/bull-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-board.d.ts","sourceRoot":"","sources":["../../src/monitoring/bull-board.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEpC,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,oDAAoD;IACpD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA+D1B;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;;CAQpD"}

package/dist/monitoring/bull-board.js

@@ -0,0 +1,112 @@
+/**
+ * Bull Board integration for queue monitoring
+ *
+ * This module provides optional Bull Board dashboard integration.
+ * Bull Board packages are NOT included as dependencies - install them separately:
+ *
+ * npm install @bull-board/api @bull-board/fastify
+ *
+ * @example
+ * ```typescript
+ * import { registerBullBoard } from '@riktajs/queue';
+ *
+ * // In your Rikta bootstrap:
+ * const app = await Rikta.create();
+ *
+ * // After queue provider is initialized:
+ * await registerBullBoard(app.server, {
+ *   queues: queueProvider.getAllQueues(),
+ *   path: '/admin/queues',
+ *   auth: async (req) => {
+ *     // Your auth logic here
+ *     return req.headers.authorization === 'Bearer secret';
+ *   },
+ * });
+ * ```
+ */
+/**
+ * Register Bull Board dashboard with Fastify
+ *
+ * @param app - Fastify instance
+ * @param options - Dashboard configuration
+ * @returns Bull Board control object
+ *
+ * @throws BullBoardNotInstalledError if @bull-board packages are not installed
+ *
+ * @example
+ * ```typescript
+ * const board = await registerBullBoard(app.server, {
+ *   queues: queueProvider.getAllQueues(),
+ *   path: '/admin/queues',
+ *   auth: (req) => checkAdminAuth(req),
+ * });
+ *
+ * // Add more queues later
+ * board.addQueue(newQueue);
+ * ```
+ */
+export async function registerBullBoard(app, options) {
+    const { queues, path = '/admin/queues', auth, readOnly = false } = options;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let createBullBoard;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let BullMQAdapter;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let FastifyAdapter;
+    try {
+        // Dynamic imports - these will fail if packages not installed
+        // Use require for better compatibility
+        createBullBoard = require('@bull-board/api').createBullBoard;
+        FastifyAdapter = require('@bull-board/fastify').FastifyAdapter;
+        BullMQAdapter = require('@bull-board/api/bullMQAdapter').BullMQAdapter;
+    }
+    catch {
+        throw new BullBoardNotInstalledError();
+    }
+    // Create adapters for all queues
+    const queueAdapters = queues.map(queue => new BullMQAdapter(queue, { readOnlyMode: readOnly }));
+    // Create the server adapter
+    const serverAdapter = new FastifyAdapter();
+    serverAdapter.setBasePath(path);
+    // Create Bull Board
+    const board = createBullBoard({
+        queues: queueAdapters,
+        serverAdapter,
+    });
+    // Add auth hook if provided
+    if (auth) {
+        app.addHook('preHandler', async (request, reply) => {
+            const url = request.url;
+            if (url.startsWith(path)) {
+                const isAuthorized = await auth(request);
+                if (!isAuthorized) {
+                    reply.code(403).send({ error: 'Forbidden' });
+                }
+            }
+        });
+    }
+    // Register the plugin
+    await app.register(serverAdapter.registerPlugin(), { basePath: path, prefix: path });
+    console.log(`📊 Bull Board: Dashboard available at ${path}`);
+    return {
+        path,
+        addQueue: (queue) => {
+            const adapter = new BullMQAdapter(queue, { readOnlyMode: readOnly });
+            board.addQueue(adapter);
+        },
+        removeQueue: (queueName) => {
+            board.removeQueue(queueName);
+        },
+    };
+}
+/**
+ * Error thrown when Bull Board packages are not installed
+ */
+export class BullBoardNotInstalledError extends Error {
+    constructor() {
+        super('Bull Board packages are not installed. ' +
+            'Install them with: npm install @bull-board/api @bull-board/fastify');
+        this.name = 'BullBoardNotInstalledError';
+    }
+}
+//# sourceMappingURL=bull-board.js.map

package/dist/monitoring/bull-board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bull-board.js","sourceRoot":"","sources":["../../src/monitoring/bull-board.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA2BH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAoB,EACpB,OAAyB;IAEzB,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,eAAe,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE3E,8DAA8D;IAC9D,IAAI,eAAoB,CAAC;IACzB,8DAA8D;IAC9D,IAAI,aAAkB,CAAC;IACvB,8DAA8D;IAC9D,IAAI,cAAmB,CAAC;IAExB,IAAI,CAAC;QACH,8DAA8D;QAC9D,uCAAuC;QACvC,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,eAAe,CAAC;QAC7D,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,cAAc,CAAC;QAC/D,aAAa,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC,aAAa,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,0BAA0B,EAAE,CAAC;IACzC,CAAC;IAED,iCAAiC;IACjC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAC9B,KAAK,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAC9D,CAAC;IAEF,4BAA4B;IAC5B,MAAM,aAAa,GAAG,IAAI,cAAc,EAAE,CAAC;IAC3C,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEhC,oBAAoB;IACpB,MAAM,KAAK,GAAG,eAAe,CAAC;QAC5B,MAAM,EAAE,aAAa;QACrB,aAAa;KACd,CAAC,CAAC;IAEH,4BAA4B;IAC5B,IAAI,IAAI,EAAE,CAAC;QACT,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;YAC/E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YACxB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,MAAM,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErF,OAAO,CAAC,GAAG,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;IAE7D,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,CAAC,KAAY,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,WAAW,EAAE,CAAC,SAAiB,EAAE,EAAE;YACjC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD;QACE,KAAK,CACH,yCAAyC;YACzC,oEAAoE,CACrE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/providers/queue.provider.d.ts

@@ -0,0 +1,94 @@
+/**
+ * QueueProvider - Main provider for queue lifecycle management
+ *
+ * Implements OnProviderInit and OnProviderDestroy for Rikta lifecycle integration.
+ * Not @Injectable - use createQueueProvider() factory function.
+ */
+import type { OnProviderInit, OnProviderDestroy } from '@riktajs/core';
+import { Queue } from 'bullmq';
+import type { QueueProviderOptions, QueueConfig } from '../types.js';
+/**
+ * QueueProvider manages the lifecycle of all queues and workers.
+ *
+ * @example
+ * ```typescript
+ * const provider = createQueueProvider({
+ *   config: { redis: { host: 'localhost', port: 6379 } }
+ * });
+ *
+ * // In Rikta bootstrap:
+ * await app.register(provider);
+ * ```
+ */
+export declare class QueueProvider implements OnProviderInit, OnProviderDestroy {
+    private connectionManager;
+    private config;
+    private queues;
+    private workers;
+    private processorClasses;
+    private initialized;
+    private eventBus;
+    private options;
+    /**
+     * Configure the provider with options
+     */
+    configure(options: QueueProviderOptions): this;
+    /**
+     * Register processor classes for auto-discovery
+     */
+    registerProcessors(...processors: Function[]): this;
+    /**
+     * Set EventBus for event emission (optional)
+     */
+    setEventBus(eventBus: unknown): this;
+    /**
+     * Initialize all queues and workers (called by Rikta lifecycle)
+     */
+    onProviderInit(): Promise<void>;
+    /**
+     * Gracefully shutdown all workers and close connections
+     */
+    onProviderDestroy(): Promise<void>;
+    /**
+     * Get a queue by name
+     */
+    getQueue(name: string): Queue | undefined;
+    /**
+     * Get all registered queues
+     */
+    getAllQueues(): Queue[];
+    /**
+     * Check if the provider is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get configuration
+     */
+    getConfig(): QueueConfig;
+    private testConnection;
+    private discoverAndRegisterProcessors;
+    private registerProcessor;
+    private createQueue;
+    private attachWorkerEvents;
+    private handleEvent;
+    private registerInContainer;
+    private delay;
+}
+/**
+ * Factory function to create a QueueProvider
+ */
+export declare function createQueueProvider(options?: QueueProviderOptions): QueueProvider;
+/**
+ * Error thrown when queue initialization fails
+ */
+export declare class QueueInitializationError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a duplicate queue is detected
+ */
+export declare class DuplicateQueueError extends Error {
+    constructor(queueName: string);
+}
+//# sourceMappingURL=queue.provider.d.ts.map

package/dist/providers/queue.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.provider.d.ts","sourceRoot":"","sources":["../../src/providers/queue.provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,KAAK,EAAuB,MAAM,QAAQ,CAAC;AAOpD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EAGZ,MAAM,aAAa,CAAC;AAwBrB;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,cAAc,EAAE,iBAAiB;IACrE,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAiB;IAEjC,OAAO,CAAC,OAAO,CAIb;IAEF;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAK9C;;OAEG;IACH,kBAAkB,CAAC,GAAG,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI;IAKnD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKpC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BrC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIzC;;OAEG;IACH,YAAY,IAAI,KAAK,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,IAAI,WAAW;YAMV,cAAc;YA2Bd,6BAA6B;YAc7B,iBAAiB;YA0DjB,WAAW;IAazB,OAAO,CAAC,kBAAkB;YA+BZ,WAAW;IA8BzB,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAMjF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;aACJ,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAI3D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,SAAS,EAAE,MAAM;CAI9B"}