@riktajs/queue 0.1.0

package/dist/providers/queue.provider.js

@@ -0,0 +1,333 @@
+/**
+ * QueueProvider - Main provider for queue lifecycle management
+ *
+ * Implements OnProviderInit and OnProviderDestroy for Rikta lifecycle integration.
+ * Not @Injectable - use createQueueProvider() factory function.
+ */
+import { Queue, Worker, QueueEvents } from 'bullmq';
+import { QUEUE_PROVIDER, QUEUE_SERVICE, getQueueToken, getWorkerToken } from '../constants.js';
+import { loadQueueConfig } from '../config/queue.config.js';
+import { RedisConnectionManager, QueueConnectionError } from '../utils/connection.js';
+import { getProcessorOptions, isProcessor } from '../decorators/processor.decorator.js';
+import { getJobHandlers } from '../decorators/process.decorator.js';
+import { getEventHandlers } from '../decorators/events.decorator.js';
+import { publishQueueEvent } from '../events/queue-events.js';
+import { QueueService } from '../services/queue.service.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 class QueueProvider {
+    connectionManager = new RedisConnectionManager();
+    config;
+    queues = new Map();
+    workers = new Map();
+    processorClasses = [];
+    initialized = false;
+    eventBus = null;
+    options = {
+        autoInitialize: true,
+        retryAttempts: 0,
+        retryDelay: 3000,
+    };
+    /**
+     * Configure the provider with options
+     */
+    configure(options) {
+        this.options = { ...this.options, ...options };
+        return this;
+    }
+    /**
+     * Register processor classes for auto-discovery
+     */
+    registerProcessors(...processors) {
+        this.processorClasses.push(...processors);
+        return this;
+    }
+    /**
+     * Set EventBus for event emission (optional)
+     */
+    setEventBus(eventBus) {
+        this.eventBus = eventBus;
+        return this;
+    }
+    /**
+     * Initialize all queues and workers (called by Rikta lifecycle)
+     */
+    async onProviderInit() {
+        console.log('🚀 Queue: Initializing queue system...');
+        try {
+            // Load configuration
+            this.config = loadQueueConfig(this.options.config);
+            // Configure Redis connection
+            this.connectionManager.configure(this.config.redis);
+            // Test connection
+            await this.testConnection();
+            // Discover and register processors
+            await this.discoverAndRegisterProcessors();
+            // Register in container
+            this.registerInContainer();
+            this.initialized = true;
+            console.log(`✅ Queue: Initialized ${this.queues.size} queue(s), ${this.workers.size} worker(s)`);
+        }
+        catch (error) {
+            console.error('❌ Queue: Failed to initialize queue system');
+            throw error;
+        }
+    }
+    /**
+     * Gracefully shutdown all workers and close connections
+     */
+    async onProviderDestroy() {
+        if (!this.initialized)
+            return;
+        console.log('🔌 Queue: Shutting down queue system...');
+        try {
+            const timeout = this.config.shutdownTimeout || 30000;
+            // Close all workers gracefully
+            const workerClosePromises = Array.from(this.workers.values()).map(async ({ worker, queueName }) => {
+                console.log(`  ⏳ Closing worker for ${queueName}...`);
+                await Promise.race([
+                    worker.close(),
+                    this.delay(timeout),
+                ]);
+            });
+            await Promise.all(workerClosePromises);
+            // Close all queue event listeners
+            for (const { queueEvents } of this.queues.values()) {
+                if (queueEvents) {
+                    await queueEvents.close();
+                }
+            }
+            // Close all queues
+            for (const { queue } of this.queues.values()) {
+                await queue.close();
+            }
+            // Close Redis connection
+            await this.connectionManager.close();
+            this.initialized = false;
+            console.log('✅ Queue: Queue system shut down');
+        }
+        catch (error) {
+            console.error('❌ Queue: Error during shutdown:', error);
+        }
+    }
+    /**
+     * Get a queue by name
+     */
+    getQueue(name) {
+        return this.queues.get(name)?.queue;
+    }
+    /**
+     * Get all registered queues
+     */
+    getAllQueues() {
+        return Array.from(this.queues.values()).map(q => q.queue);
+    }
+    /**
+     * Check if the provider is initialized
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    // --- Private methods ---
+    async testConnection() {
+        const client = this.connectionManager.getClient();
+        const { retryAttempts = 0, retryDelay = 3000 } = this.options;
+        let lastError;
+        for (let attempt = 0; attempt <= retryAttempts; attempt++) {
+            try {
+                await client.ping();
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < retryAttempts) {
+                    console.warn(`⚠️ Queue: Connection attempt ${attempt + 1}/${retryAttempts + 1} failed. Retrying in ${retryDelay}ms...`);
+                    await this.delay(retryDelay);
+                }
+            }
+        }
+        throw new QueueConnectionError(`Failed to connect to Redis: ${lastError?.message}`, this.config.redis.host, this.config.redis.port, lastError);
+    }
+    async discoverAndRegisterProcessors() {
+        for (const processorClass of this.processorClasses) {
+            if (!isProcessor(processorClass)) {
+                console.warn(`⚠️ Queue: ${processorClass.name} is not decorated with @Processor, skipping`);
+                continue;
+            }
+            const options = getProcessorOptions(processorClass);
+            if (!options)
+                continue;
+            await this.registerProcessor(processorClass, options);
+        }
+    }
+    async registerProcessor(processorClass, options) {
+        const { queueName, concurrency, rateLimiter, workerOptions } = options;
+        // Create queue if not exists
+        if (!this.queues.has(queueName)) {
+            await this.createQueue(queueName);
+        }
+        // Get job handlers
+        const jobHandlers = getJobHandlers(processorClass);
+        const eventHandlers = getEventHandlers(processorClass);
+        // Create processor instance
+        const processor = new processorClass();
+        // Create worker
+        const worker = new Worker(queueName, async (job) => {
+            // Find handler for this job
+            const handler = jobHandlers.find(h => h.name === job.name);
+            if (!handler) {
+                throw new Error(`No handler found for job: ${job.name}`);
+            }
+            // Call handler method
+            const method = processor[handler.methodName];
+            if (typeof method !== 'function') {
+                throw new Error(`Handler method ${handler.methodName} not found`);
+            }
+            return method.call(processor, job);
+        }, {
+            connection: this.connectionManager.getClient(),
+            concurrency: concurrency || this.config.defaultConcurrency || 1,
+            limiter: rateLimiter || this.config.defaultRateLimiter,
+            ...workerOptions,
+        });
+        // Attach event handlers
+        this.attachWorkerEvents(worker, queueName, processor, eventHandlers);
+        // Store worker
+        this.workers.set(queueName, {
+            queueName,
+            worker,
+            processor,
+            processorClass,
+        });
+        console.log(`  📦 Registered processor for queue: ${queueName} (${jobHandlers.length} handlers)`);
+    }
+    async createQueue(name) {
+        const queue = new Queue(name, {
+            connection: this.connectionManager.getClient(),
+        });
+        // Create queue events for monitoring
+        const queueEvents = new QueueEvents(name, {
+            connection: this.connectionManager.getClient(),
+        });
+        this.queues.set(name, { name, queue, queueEvents });
+    }
+    attachWorkerEvents(worker, queueName, processor, eventHandlers) {
+        worker.on('completed', async (job, result) => {
+            await this.handleEvent('job:completed', queueName, processor, eventHandlers, job, result);
+        });
+        worker.on('failed', async (job, error) => {
+            await this.handleEvent('job:failed', queueName, processor, eventHandlers, job, error);
+        });
+        worker.on('progress', async (job, progress) => {
+            await this.handleEvent('job:progress', queueName, processor, eventHandlers, job, progress);
+        });
+        worker.on('stalled', async (jobId) => {
+            await this.handleEvent('job:stalled', queueName, processor, eventHandlers, jobId);
+        });
+        worker.on('ready', async () => {
+            await this.handleEvent('worker:ready', queueName, processor, eventHandlers);
+        });
+        worker.on('error', async (error) => {
+            await this.handleEvent('worker:error', queueName, processor, eventHandlers, error);
+        });
+    }
+    async handleEvent(event, queueName, processor, eventHandlers, ...args) {
+        // Call processor event handlers
+        const handlers = eventHandlers.filter(h => h.event === event);
+        for (const handler of handlers) {
+            const method = processor[handler.methodName];
+            if (typeof method === 'function') {
+                try {
+                    await method.call(processor, ...args);
+                }
+                catch (error) {
+                    console.error(`Error in event handler ${handler.methodName}:`, error);
+                }
+            }
+        }
+        // Emit to EventBus if available
+        if (this.eventBus) {
+            try {
+                await publishQueueEvent(this.eventBus, event, queueName, ...args);
+            }
+            catch {
+                // Ignore EventBus errors
+            }
+        }
+    }
+    registerInContainer() {
+        try {
+            // Dynamic import to avoid circular dependency
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { Container } = require('@riktajs/core');
+            const container = Container.getInstance();
+            // Register provider
+            container.registerValue(QUEUE_PROVIDER, this);
+            // Register queues
+            for (const [name, { queue }] of this.queues) {
+                container.registerValue(getQueueToken(name), queue);
+            }
+            // Register workers
+            for (const [name, { worker }] of this.workers) {
+                container.registerValue(getWorkerToken(name), worker);
+            }
+            // Create and register QueueService
+            const queueService = new QueueService(this);
+            container.registerValue(QUEUE_SERVICE, queueService);
+        }
+        catch {
+            // Container not available, skip registration
+        }
+    }
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+/**
+ * Factory function to create a QueueProvider
+ */
+export function createQueueProvider(options) {
+    const provider = new QueueProvider();
+    if (options) {
+        provider.configure(options);
+    }
+    return provider;
+}
+/**
+ * Error thrown when queue initialization fails
+ */
+export class QueueInitializationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'QueueInitializationError';
+    }
+}
+/**
+ * Error thrown when a duplicate queue is detected
+ */
+export class DuplicateQueueError extends Error {
+    constructor(queueName) {
+        super(`Duplicate queue registration: ${queueName}`);
+        this.name = 'DuplicateQueueError';
+    }
+}
+//# sourceMappingURL=queue.provider.js.map

package/dist/providers/queue.provider.js.map

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

package/dist/services/queue.service.d.ts

@@ -0,0 +1,133 @@
+/**
+ * QueueService - Injectable service for adding jobs to queues
+ */
+import type { Job, JobsOptions, RepeatOptions } from 'bullmq';
+import type { QueueProvider } from '../providers/queue.provider.js';
+import type { AddJobOptions, ScheduleOptions } from '../types.js';
+/**
+ * Service for adding jobs to queues from anywhere in the application.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   @Autowired()
+ *   private queueService!: QueueService;
+ *
+ *   async sendNotification(userId: string, message: string) {
+ *     await this.queueService.addJob('notifications', 'send', {
+ *       userId,
+ *       message,
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export declare class QueueService {
+    private readonly provider;
+    constructor(provider: QueueProvider);
+    /**
+     * Add a job to a queue
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job (matches @Process decorator)
+     * @param data - Job payload data
+     * @param options - Optional job options
+     * @returns The created job
+     */
+    addJob<TData = unknown, TResult = unknown>(queueName: string, jobName: string, data: TData, options?: AddJobOptions): Promise<Job<TData, TResult>>;
+    /**
+     * Add multiple jobs to a queue in bulk
+     *
+     * @param queueName - Name of the queue
+     * @param jobs - Array of jobs to add
+     * @returns Array of created jobs
+     */
+    addJobs<TData = unknown, TResult = unknown>(queueName: string, jobs: Array<{
+        name: string;
+        data: TData;
+        options?: JobsOptions;
+    }>): Promise<Job<TData, TResult>[]>;
+    /**
+     * Add a delayed job
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param data - Job payload data
+     * @param delay - Delay in milliseconds
+     * @param options - Optional job options
+     */
+    addDelayedJob<TData = unknown, TResult = unknown>(queueName: string, jobName: string, data: TData, delay: number, options?: JobsOptions): Promise<Job<TData, TResult>>;
+    /**
+     * Add a repeatable job (scheduled)
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param data - Job payload data
+     * @param repeat - Repeat options (cron pattern, interval, etc.)
+     * @param options - Optional schedule options
+     */
+    addRepeatableJob<TData = unknown, TResult = unknown>(queueName: string, jobName: string, data: TData, repeat: RepeatOptions, options?: ScheduleOptions): Promise<Job<TData, TResult>>;
+    /**
+     * Remove a repeatable job
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param repeat - The repeat options used when creating the job
+     */
+    removeRepeatableJob(queueName: string, jobName: string, repeat: RepeatOptions): Promise<boolean>;
+    /**
+     * Get a job by ID
+     *
+     * @param queueName - Name of the queue
+     * @param jobId - Job ID
+     */
+    getJob<TData = unknown, TResult = unknown>(queueName: string, jobId: string): Promise<Job<TData, TResult> | undefined>;
+    /**
+     * Get queue statistics
+     *
+     * @param queueName - Name of the queue
+     */
+    getQueueStats(queueName: string): Promise<{
+        waiting: number;
+        active: number;
+        completed: number;
+        failed: number;
+        delayed: number;
+        paused: number;
+    }>;
+    /**
+     * Pause a queue
+     */
+    pauseQueue(queueName: string): Promise<void>;
+    /**
+     * Resume a queue
+     */
+    resumeQueue(queueName: string): Promise<void>;
+    /**
+     * Clear all jobs from a queue
+     *
+     * @param queueName - Name of the queue
+     * @param status - Which jobs to clear (default: all)
+     */
+    clearQueue(queueName: string, status?: 'completed' | 'failed' | 'delayed' | 'wait' | 'active'): Promise<void>;
+    /**
+     * Get all queue names
+     */
+    getQueueNames(): string[];
+    private getQueueOrThrow;
+}
+/**
+ * Error thrown when a queue is not found
+ */
+export declare class QueueNotFoundError extends Error {
+    constructor(queueName: string);
+}
+/**
+ * Error thrown when job validation fails
+ */
+export declare class JobValidationError extends Error {
+    readonly errors: unknown[];
+    constructor(message: string, errors: unknown[]);
+}
+//# sourceMappingURL=queue.service.d.ts.map

package/dist/services/queue.service.d.ts.map

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

package/dist/services/queue.service.js

@@ -0,0 +1,192 @@
+/**
+ * QueueService - Injectable service for adding jobs to queues
+ */
+/**
+ * Service for adding jobs to queues from anywhere in the application.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * class NotificationService {
+ *   @Autowired()
+ *   private queueService!: QueueService;
+ *
+ *   async sendNotification(userId: string, message: string) {
+ *     await this.queueService.addJob('notifications', 'send', {
+ *       userId,
+ *       message,
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export class QueueService {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /**
+     * Add a job to a queue
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job (matches @Process decorator)
+     * @param data - Job payload data
+     * @param options - Optional job options
+     * @returns The created job
+     */
+    async addJob(queueName, jobName, data, options) {
+        const queue = this.getQueueOrThrow(queueName);
+        // Handle deduplication
+        const jobOptions = { ...options };
+        if (options?.deduplicationKey) {
+            jobOptions.jobId = options.deduplicationKey;
+        }
+        return queue.add(jobName, data, jobOptions);
+    }
+    /**
+     * Add multiple jobs to a queue in bulk
+     *
+     * @param queueName - Name of the queue
+     * @param jobs - Array of jobs to add
+     * @returns Array of created jobs
+     */
+    async addJobs(queueName, jobs) {
+        const queue = this.getQueueOrThrow(queueName);
+        const bulkJobs = jobs.map(j => ({
+            name: j.name,
+            data: j.data,
+            opts: j.options,
+        }));
+        return queue.addBulk(bulkJobs);
+    }
+    /**
+     * Add a delayed job
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param data - Job payload data
+     * @param delay - Delay in milliseconds
+     * @param options - Optional job options
+     */
+    async addDelayedJob(queueName, jobName, data, delay, options) {
+        return this.addJob(queueName, jobName, data, { ...options, delay });
+    }
+    /**
+     * Add a repeatable job (scheduled)
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param data - Job payload data
+     * @param repeat - Repeat options (cron pattern, interval, etc.)
+     * @param options - Optional schedule options
+     */
+    async addRepeatableJob(queueName, jobName, data, repeat, options) {
+        const queue = this.getQueueOrThrow(queueName);
+        return queue.add(jobName, data, {
+            ...options,
+            repeat,
+            jobId: options?.jobId,
+        });
+    }
+    /**
+     * Remove a repeatable job
+     *
+     * @param queueName - Name of the queue
+     * @param jobName - Name of the job
+     * @param repeat - The repeat options used when creating the job
+     */
+    async removeRepeatableJob(queueName, jobName, repeat) {
+        const queue = this.getQueueOrThrow(queueName);
+        return queue.removeRepeatableByKey(`${jobName}:${JSON.stringify(repeat)}`);
+    }
+    /**
+     * Get a job by ID
+     *
+     * @param queueName - Name of the queue
+     * @param jobId - Job ID
+     */
+    async getJob(queueName, jobId) {
+        const queue = this.getQueueOrThrow(queueName);
+        return queue.getJob(jobId);
+    }
+    /**
+     * Get queue statistics
+     *
+     * @param queueName - Name of the queue
+     */
+    async getQueueStats(queueName) {
+        const queue = this.getQueueOrThrow(queueName);
+        const [waiting, active, completed, failed, delayed, paused] = await Promise.all([
+            queue.getWaitingCount(),
+            queue.getActiveCount(),
+            queue.getCompletedCount(),
+            queue.getFailedCount(),
+            queue.getDelayedCount(),
+            queue.isPaused().then(p => (p ? 1 : 0)),
+        ]);
+        return { waiting, active, completed, failed, delayed, paused };
+    }
+    /**
+     * Pause a queue
+     */
+    async pauseQueue(queueName) {
+        const queue = this.getQueueOrThrow(queueName);
+        await queue.pause();
+    }
+    /**
+     * Resume a queue
+     */
+    async resumeQueue(queueName) {
+        const queue = this.getQueueOrThrow(queueName);
+        await queue.resume();
+    }
+    /**
+     * Clear all jobs from a queue
+     *
+     * @param queueName - Name of the queue
+     * @param status - Which jobs to clear (default: all)
+     */
+    async clearQueue(queueName, status) {
+        const queue = this.getQueueOrThrow(queueName);
+        if (status) {
+            await queue.clean(0, 0, status);
+        }
+        else {
+            await queue.obliterate({ force: true });
+        }
+    }
+    /**
+     * Get all queue names
+     */
+    getQueueNames() {
+        return this.provider.getAllQueues().map(q => q.name);
+    }
+    getQueueOrThrow(queueName) {
+        const queue = this.provider.getQueue(queueName);
+        if (!queue) {
+            throw new QueueNotFoundError(queueName);
+        }
+        return queue;
+    }
+}
+/**
+ * Error thrown when a queue is not found
+ */
+export class QueueNotFoundError extends Error {
+    constructor(queueName) {
+        super(`Queue not found: ${queueName}`);
+        this.name = 'QueueNotFoundError';
+    }
+}
+/**
+ * Error thrown when job validation fails
+ */
+export class JobValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = 'JobValidationError';
+    }
+}
+//# sourceMappingURL=queue.service.js.map