@morojs/moro 1.6.8 → 1.7.0

package/dist/core/queue/queue-manager.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Queue Manager
+ * Central manager for all queue operations in MoroJS
+ */
+import type { IQueueManager, QueueOptions, Job, JobOptions, JobHandler, BulkJobData, QueueStatus } from './types.js';
+import type { EventEmitter } from 'events';
+/**
+ * Queue Manager
+ * Manages multiple queues with different adapters
+ */
+export declare class QueueManager implements IQueueManager {
+    private queues;
+    private eventEmitter?;
+    private isShuttingDown;
+    constructor(eventEmitter?: EventEmitter);
+    /**
+     * Register a new queue
+     */
+    registerQueue(name: string, options: QueueOptions): Promise<void>;
+    /**
+     * Add a job to a queue
+     */
+    addToQueue<T = any>(queueName: string, data: T, options?: JobOptions): Promise<Job<T>>;
+    /**
+     * Add multiple jobs to a queue in bulk
+     */
+    addBulkToQueue<T = any>(queueName: string, jobs: BulkJobData<T>[]): Promise<Job<T>[]>;
+    /**
+     * Register a processor for a queue
+     */
+    processQueue<T = any, R = any>(queueName: string, concurrencyOrHandler: number | JobHandler<T, R>, handler?: JobHandler<T, R>): Promise<void>;
+    /**
+     * Get queue status
+     */
+    getQueueStatus(queueName: string): Promise<QueueStatus>;
+    /**
+     * Get a specific job
+     */
+    getJob(queueName: string, jobId: string): Promise<Job | null>;
+    /**
+     * Get jobs by status
+     */
+    getJobs(queueName: string, status?: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused', start?: number, end?: number): Promise<Job[]>;
+    /**
+     * Remove a job
+     */
+    removeJob(queueName: string, jobId: string): Promise<void>;
+    /**
+     * Retry a failed job
+     */
+    retryJob(queueName: string, jobId: string): Promise<void>;
+    /**
+     * Pause a queue
+     */
+    pauseQueue(queueName: string): Promise<void>;
+    /**
+     * Resume a queue
+     */
+    resumeQueue(queueName: string): Promise<void>;
+    /**
+     * Clean old jobs from a queue
+     */
+    cleanQueue(queueName: string, gracePeriod: number, status?: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused'): Promise<void>;
+    /**
+     * Obliterate a queue (delete all data)
+     */
+    obliterateQueue(queueName: string): Promise<void>;
+    /**
+     * Get all registered queues
+     */
+    getQueueNames(): string[];
+    /**
+     * Check if a queue is registered
+     */
+    hasQueue(queueName: string): boolean;
+    /**
+     * Shutdown all queues gracefully
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Create an adapter instance based on options
+     */
+    private createAdapter;
+    /**
+     * Get a registered queue
+     */
+    private getQueue;
+    /**
+     * Emit a queue event
+     */
+    private emitEvent;
+}

package/dist/core/queue/queue-manager.js

@@ -0,0 +1,327 @@
+/**
+ * Queue Manager
+ * Central manager for all queue operations in MoroJS
+ */
+import { MemoryAdapter } from './adapters/memory-adapter.js';
+import { BullAdapter } from './adapters/bull-adapter.js';
+import { RabbitMQAdapter } from './adapters/rabbitmq-adapter.js';
+import { SQSAdapter } from './adapters/sqs-adapter.js';
+import { KafkaAdapter } from './adapters/kafka-adapter.js';
+import { createFrameworkLogger } from '../logger/index.js';
+const logger = createFrameworkLogger('QueueManager');
+/**
+ * Queue Manager
+ * Manages multiple queues with different adapters
+ */
+export class QueueManager {
+    queues = new Map();
+    eventEmitter;
+    isShuttingDown = false;
+    constructor(eventEmitter) {
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Register a new queue
+     */
+    async registerQueue(name, options) {
+        if (this.queues.has(name)) {
+            throw new Error(`Queue "${name}" is already registered`);
+        }
+        // Create adapter based on type
+        const adapter = this.createAdapter(options);
+        // Initialize adapter
+        await adapter.initialize();
+        // Register queue
+        this.queues.set(name, {
+            name,
+            options,
+            adapter,
+            processors: new Map(),
+        });
+        this.emitEvent('queue:created', {
+            queueName: name,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Add a job to a queue
+     */
+    async addToQueue(queueName, data, options) {
+        const queue = this.getQueue(queueName);
+        // Merge with default options
+        const finalOptions = {
+            ...queue.options.defaultJobOptions,
+            ...options,
+        };
+        const job = await queue.adapter.addJob(queueName, data, finalOptions);
+        this.emitEvent('queue:job:added', {
+            queueName,
+            jobId: job.id,
+            job,
+            timestamp: Date.now(),
+        });
+        return job;
+    }
+    /**
+     * Add multiple jobs to a queue in bulk
+     */
+    async addBulkToQueue(queueName, jobs) {
+        const queue = this.getQueue(queueName);
+        // Merge with default options for each job
+        const jobsWithDefaults = jobs.map(job => ({
+            ...job,
+            options: {
+                ...queue.options.defaultJobOptions,
+                ...job.options,
+            },
+        }));
+        const addedJobs = await queue.adapter.addBulkJobs(queueName, jobsWithDefaults);
+        for (const job of addedJobs) {
+            this.emitEvent('queue:job:added', {
+                queueName,
+                jobId: job.id,
+                job,
+                timestamp: Date.now(),
+            });
+        }
+        return addedJobs;
+    }
+    /**
+     * Register a processor for a queue
+     */
+    async processQueue(queueName, concurrencyOrHandler, handler) {
+        const queue = this.getQueue(queueName);
+        // Parse arguments
+        let concurrency;
+        let actualHandler;
+        if (typeof concurrencyOrHandler === 'function') {
+            concurrency = queue.options.concurrency || 1;
+            actualHandler = concurrencyOrHandler;
+        }
+        else {
+            concurrency = concurrencyOrHandler;
+            if (!handler) {
+                throw new Error('Handler function is required when concurrency is specified');
+            }
+            actualHandler = handler;
+        }
+        // Wrap handler to emit events
+        const wrappedHandler = async (job) => {
+            try {
+                this.emitEvent('queue:job:active', {
+                    queueName,
+                    jobId: job.id,
+                    job,
+                    timestamp: Date.now(),
+                });
+                // Wrap updateProgress to emit events
+                const originalUpdateProgress = job.updateProgress;
+                job.updateProgress = async (progress) => {
+                    await originalUpdateProgress.call(job, progress);
+                    this.emitEvent('queue:job:progress', {
+                        queueName,
+                        jobId: job.id,
+                        progress,
+                        timestamp: Date.now(),
+                    });
+                };
+                const result = await actualHandler(job);
+                this.emitEvent('queue:job:completed', {
+                    queueName,
+                    jobId: job.id,
+                    job,
+                    result,
+                    timestamp: Date.now(),
+                });
+                return result;
+            }
+            catch (error) {
+                this.emitEvent('queue:job:failed', {
+                    queueName,
+                    jobId: job.id,
+                    job,
+                    error: error,
+                    timestamp: Date.now(),
+                });
+                throw error;
+            }
+        };
+        // Store processor
+        queue.processors.set(queueName, wrappedHandler);
+        // Register with adapter
+        await queue.adapter.process(queueName, concurrency, wrappedHandler);
+    }
+    /**
+     * Get queue status
+     */
+    async getQueueStatus(queueName) {
+        const queue = this.getQueue(queueName);
+        const metrics = await queue.adapter.getMetrics(queueName);
+        return {
+            name: queueName,
+            adapter: queue.options.adapter,
+            isPaused: metrics.paused > 0,
+            metrics,
+            workers: queue.processors.size,
+        };
+    }
+    /**
+     * Get a specific job
+     */
+    async getJob(queueName, jobId) {
+        const queue = this.getQueue(queueName);
+        return await queue.adapter.getJob(queueName, jobId);
+    }
+    /**
+     * Get jobs by status
+     */
+    async getJobs(queueName, status, start = 0, end = -1) {
+        const queue = this.getQueue(queueName);
+        return await queue.adapter.getJobs(queueName, status, start, end);
+    }
+    /**
+     * Remove a job
+     */
+    async removeJob(queueName, jobId) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.removeJob(queueName, jobId);
+        this.emitEvent('queue:job:removed', {
+            queueName,
+            jobId,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Retry a failed job
+     */
+    async retryJob(queueName, jobId) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.retryJob(queueName, jobId);
+    }
+    /**
+     * Pause a queue
+     */
+    async pauseQueue(queueName) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.pauseQueue(queueName);
+        this.emitEvent('queue:paused', {
+            queueName,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Resume a queue
+     */
+    async resumeQueue(queueName) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.resumeQueue(queueName);
+        this.emitEvent('queue:resumed', {
+            queueName,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Clean old jobs from a queue
+     */
+    async cleanQueue(queueName, gracePeriod, status) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.clean(queueName, gracePeriod, status);
+        this.emitEvent('queue:cleaned', {
+            queueName,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Obliterate a queue (delete all data)
+     */
+    async obliterateQueue(queueName) {
+        const queue = this.getQueue(queueName);
+        await queue.adapter.obliterate(queueName);
+        this.emitEvent('queue:drained', {
+            queueName,
+            timestamp: Date.now(),
+        });
+        this.queues.delete(queueName);
+    }
+    /**
+     * Get all registered queues
+     */
+    getQueueNames() {
+        return Array.from(this.queues.keys());
+    }
+    /**
+     * Check if a queue is registered
+     */
+    hasQueue(queueName) {
+        return this.queues.has(queueName);
+    }
+    /**
+     * Shutdown all queues gracefully
+     */
+    async shutdown() {
+        if (this.isShuttingDown) {
+            return;
+        }
+        this.isShuttingDown = true;
+        // Close all adapters
+        const shutdownPromises = Array.from(this.queues.values()).map(async (queue) => {
+            try {
+                await queue.adapter.close();
+            }
+            catch (error) {
+                logger.error(`Error closing queue ${queue.name}: ${error}`);
+            }
+        });
+        await Promise.all(shutdownPromises);
+        this.queues.clear();
+        this.isShuttingDown = false;
+    }
+    /**
+     * Create an adapter instance based on options
+     */
+    createAdapter(options) {
+        switch (options.adapter) {
+            case 'memory':
+                return new MemoryAdapter();
+            case 'bull':
+                return new BullAdapter(options.connection);
+            case 'rabbitmq':
+                return new RabbitMQAdapter(options.connection);
+            case 'sqs':
+                return new SQSAdapter(options.connection);
+            case 'kafka':
+                return new KafkaAdapter(options.connection);
+            default:
+                throw new Error(`Unknown queue adapter: ${options.adapter}`);
+        }
+    }
+    /**
+     * Get a registered queue
+     */
+    getQueue(queueName) {
+        const queue = this.queues.get(queueName);
+        if (!queue) {
+            throw new Error(`Queue "${queueName}" is not registered. Call app.queue('${queueName}', options) first.`);
+        }
+        return queue;
+    }
+    /**
+     * Emit a queue event
+     */
+    emitEvent(eventType, payload) {
+        if (!this.eventEmitter) {
+            return;
+        }
+        const event = {
+            queueName: payload.queueName || '',
+            jobId: payload.jobId,
+            job: payload.job,
+            result: payload.result,
+            error: payload.error,
+            progress: payload.progress,
+            timestamp: payload.timestamp || Date.now(),
+        };
+        this.eventEmitter.emit(eventType, event);
+    }
+}
+//# sourceMappingURL=queue-manager.js.map

package/dist/core/queue/queue-manager.js.map

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

package/dist/core/queue/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Message Queue System - Type Definitions
+ * Pure ESM module with comprehensive types for queue operations
+ */
+/**
+ * Supported queue adapter types
+ */
+export type QueueAdapterType = 'bull' | 'rabbitmq' | 'sqs' | 'kafka' | 'memory';
+/**
+ * Job status states
+ */
+export type JobStatus = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused';
+/**
+ * Backoff strategy for job retries
+ */
+export type BackoffStrategy = 'fixed' | 'exponential' | 'linear';
+/**
+ * Queue adapter connection configuration
+ */
+export interface QueueConnectionConfig {
+    host?: string;
+    port?: number;
+    username?: string;
+    password?: string;
+    database?: number;
+    brokers?: string[];
+    groupId?: string;
+    region?: string;
+    queueUrl?: string;
+    [key: string]: any;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    backoff: BackoffStrategy;
+    initialDelay: number;
+    maxDelay?: number;
+}
+/**
+ * Dead letter queue configuration
+ */
+export interface DeadLetterQueueConfig {
+    enabled: boolean;
+    maxRetries: number;
+    queueName?: string;
+}
+/**
+ * Job options for individual jobs
+ */
+export interface JobOptions {
+    priority?: number;
+    delay?: number;
+    attempts?: number;
+    backoff?: {
+        type: BackoffStrategy;
+        delay: number;
+    };
+    timeout?: number;
+    removeOnComplete?: boolean | number;
+    removeOnFail?: boolean | number;
+    repeat?: {
+        cron?: string;
+        every?: number;
+        limit?: number;
+        endDate?: Date | string;
+    };
+    jobId?: string;
+    [key: string]: any;
+}
+/**
+ * Default job options for a queue
+ */
+export interface DefaultJobOptions {
+    removeOnComplete?: boolean | number;
+    removeOnFail?: boolean | number;
+    attempts?: number;
+    backoff?: {
+        type: BackoffStrategy;
+        delay: number;
+    };
+}
+/**
+ * Queue configuration options
+ */
+export interface QueueOptions {
+    adapter: QueueAdapterType;
+    connection?: QueueConnectionConfig;
+    concurrency?: number;
+    retry?: RetryConfig;
+    deadLetterQueue?: DeadLetterQueueConfig;
+    defaultJobOptions?: DefaultJobOptions;
+    prefix?: string;
+    limiter?: {
+        max: number;
+        duration: number;
+    };
+}
+/**
+ * Job data structure
+ */
+export interface Job<T = any> {
+    id: string;
+    name: string;
+    data: T;
+    progress: number;
+    attemptsMade: number;
+    timestamp: number;
+    processedOn?: number;
+    finishedOn?: number;
+    failedReason?: string;
+    stacktrace?: string[];
+    returnvalue?: any;
+    opts: JobOptions;
+}
+/**
+ * Job context with helper methods
+ */
+export interface JobContext<T = any> extends Job<T> {
+    updateProgress(progress: number): Promise<void>;
+    log(message: string): void;
+}
+/**
+ * Job handler function
+ */
+export type JobHandler<T = any, R = any> = (job: JobContext<T>) => Promise<R>;
+/**
+ * Bulk job data
+ */
+export interface BulkJobData<T = any> {
+    data: T;
+    options?: JobOptions;
+}
+/**
+ * Queue metrics
+ */
+export interface QueueMetrics {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+    paused: number;
+}
+/**
+ * Queue event types
+ */
+export type QueueEventType = 'queue:created' | 'queue:job:added' | 'queue:job:active' | 'queue:job:completed' | 'queue:job:failed' | 'queue:job:progress' | 'queue:job:stalled' | 'queue:job:removed' | 'queue:paused' | 'queue:resumed' | 'queue:cleaned' | 'queue:drained' | 'queue:error';
+/**
+ * Queue event payload
+ */
+export interface QueueEvent {
+    queueName: string;
+    jobId?: string;
+    job?: Job;
+    result?: any;
+    error?: Error;
+    progress?: number;
+    timestamp: number;
+}
+/**
+ * Queue status
+ */
+export interface QueueStatus {
+    name: string;
+    adapter: QueueAdapterType;
+    isPaused: boolean;
+    metrics: QueueMetrics;
+    workers: number;
+}
+/**
+ * Base queue adapter interface
+ */
+export interface IQueueAdapter {
+    name: string;
+    isReady: boolean;
+    initialize(): Promise<void>;
+    addJob<T = any>(queueName: string, data: T, options?: JobOptions): Promise<Job<T>>;
+    addBulkJobs<T = any>(queueName: string, jobs: BulkJobData<T>[]): Promise<Job<T>[]>;
+    process<T = any, R = any>(queueName: string, concurrency: number, handler: JobHandler<T, R>): Promise<void>;
+    getJob(queueName: string, jobId: string): Promise<Job | null>;
+    getJobs(queueName: string, status?: JobStatus, start?: number, end?: number): Promise<Job[]>;
+    removeJob(queueName: string, jobId: string): Promise<void>;
+    retryJob(queueName: string, jobId: string): Promise<void>;
+    pauseQueue(queueName: string): Promise<void>;
+    resumeQueue(queueName: string): Promise<void>;
+    getMetrics(queueName: string): Promise<QueueMetrics>;
+    clean(queueName: string, gracePeriod: number, status?: JobStatus): Promise<void>;
+    obliterate(queueName: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Queue manager interface
+ */
+export interface IQueueManager {
+    registerQueue(name: string, options: QueueOptions): Promise<void>;
+    addToQueue<T = any>(queueName: string, data: T, options?: JobOptions): Promise<Job<T>>;
+    addBulkToQueue<T = any>(queueName: string, jobs: BulkJobData<T>[]): Promise<Job<T>[]>;
+    processQueue<T = any, R = any>(queueName: string, concurrencyOrHandler: number | JobHandler<T, R>, handler?: JobHandler<T, R>): Promise<void>;
+    getQueueStatus(queueName: string): Promise<QueueStatus>;
+    pauseQueue(queueName: string): Promise<void>;
+    resumeQueue(queueName: string): Promise<void>;
+    shutdown(): Promise<void>;
+}

package/dist/core/queue/types.js

@@ -0,0 +1,6 @@
+/**
+ * Message Queue System - Type Definitions
+ * Pure ESM module with comprehensive types for queue operations
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/queue/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/queue/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}