@riktajs/queue 0.1.0

package/README.md

@@ -0,0 +1,476 @@
+# @riktajs/queue
+
+BullMQ-based job queue integration for Rikta Framework with lifecycle management, event-driven processing, and optional Bull Board monitoring.
+
+## Features
+
+- 🚀 **High Performance** - Built on BullMQ for distributed job processing
+- 🎯 **Decorator-based API** - `@Processor`, `@Process`, `@OnJobComplete`, etc.
+- 🔄 **Lifecycle Integration** - Seamless integration with Rikta's lifecycle hooks
+- 📡 **Event System** - Queue events emitted via Rikta's EventBus
+- ⚡ **Connection Pooling** - Shared Redis connections for optimal performance
+- 📊 **Optional Monitoring** - Bull Board integration (bring your own dependency)
+- 🛡️ **Type-safe** - Full TypeScript support with generics and Zod validation
+- ⏰ **Scheduling** - Delayed jobs, repeatable jobs, cron patterns
+
+## Installation
+
+```bash
+npm install @riktajs/queue bullmq
+```
+
+> **Note:** `ioredis` is included as a direct dependency and will be installed automatically.
+
+### Optional: Bull Board Monitoring
+
+```bash
+npm install @bull-board/api @bull-board/fastify
+```
+
+## Quick Start
+
+### 1. Create a Processor
+
+```typescript
+import { Processor, Process, OnJobComplete, OnJobFailed } from '@riktajs/queue';
+import { Job } from 'bullmq';
+
+interface EmailJobData {
+  to: string;
+  subject: string;
+  body: string;
+}
+
+@Processor('email-queue', { concurrency: 5 })
+class EmailProcessor {
+  @Process('send')
+  async handleSendEmail(job: Job<EmailJobData>) {
+    console.log(`📧 Sending email to ${job.data.to}`);
+    
+    // Your email sending logic here
+    await this.sendEmail(job.data);
+    
+    return { sent: true, messageId: `msg-${job.id}` };
+  }
+
+  @Process('bulk-send')
+  async handleBulkSend(job: Job<{ emails: EmailJobData[] }>) {
+    for (const email of job.data.emails) {
+      await this.sendEmail(email);
+      await job.updateProgress(/* calculate progress */);
+    }
+    return { sent: job.data.emails.length };
+  }
+
+  @OnJobComplete()
+  async onComplete(job: Job, result: unknown) {
+    console.log(`✅ Job ${job.id} completed:`, result);
+  }
+
+  @OnJobFailed()
+  async onFailed(job: Job | undefined, error: Error) {
+    console.error(`❌ Job ${job?.id} failed:`, error.message);
+  }
+
+  private async sendEmail(data: EmailJobData): Promise<void> {
+    // Implementation
+  }
+}
+```
+
+### 2. Configure the Provider
+
+```typescript
+import { Rikta } from '@riktajs/core';
+import { createQueueProvider } from '@riktajs/queue';
+
+// Create and configure provider
+const queueProvider = createQueueProvider({
+  config: {
+    redis: {
+      host: process.env.REDIS_HOST || 'localhost',
+      port: parseInt(process.env.REDIS_PORT || '6379'),
+      password: process.env.REDIS_PASSWORD,
+    },
+    defaultConcurrency: 3,
+    shutdownTimeout: 30000,
+  },
+});
+
+// Register your processors
+queueProvider.registerProcessors(EmailProcessor);
+
+// Bootstrap your app
+const app = await Rikta.create();
+// Register the provider for lifecycle management
+```
+
+### 3. Add Jobs from Services
+
+```typescript
+import { Injectable, Autowired } from '@riktajs/core';
+import { QueueService } from '@riktajs/queue';
+
+@Injectable()
+class NotificationService {
+  @Autowired()
+  private queueService!: QueueService;
+
+  async sendWelcomeEmail(userEmail: string) {
+    // Add a single job
+    await this.queueService.addJob('email-queue', 'send', {
+      to: userEmail,
+      subject: 'Welcome!',
+      body: 'Thanks for signing up!',
+    });
+  }
+
+  async sendDelayedReminder(userEmail: string) {
+    // Add a delayed job (sends after 1 hour)
+    await this.queueService.addDelayedJob(
+      'email-queue',
+      'send',
+      {
+        to: userEmail,
+        subject: 'Don\'t forget!',
+        body: 'Complete your profile.',
+      },
+      60 * 60 * 1000 // 1 hour
+    );
+  }
+
+  async sendDailyDigest() {
+    // Add a repeatable job (runs daily at 9am)
+    await this.queueService.addRepeatableJob(
+      'email-queue',
+      'bulk-send',
+      { emails: [] }, // Data populated at runtime
+      { pattern: '0 9 * * *' } // Cron pattern
+    );
+  }
+
+  async sendBulkEmails(emails: EmailJobData[]) {
+    // Add multiple jobs in bulk
+    const jobs = emails.map(email => ({
+      name: 'send',
+      data: email,
+    }));
+    
+    await this.queueService.addJobs('email-queue', jobs);
+  }
+}
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `QUEUE_REDIS_HOST` | Redis host | `localhost` |
+| `QUEUE_REDIS_PORT` | Redis port | `6379` |
+| `QUEUE_REDIS_PASSWORD` | Redis password | - |
+| `QUEUE_REDIS_DB` | Redis database number | `0` |
+| `QUEUE_REDIS_USERNAME` | Redis username (ACL) | - |
+| `QUEUE_DEFAULT_CONCURRENCY` | Default worker concurrency | `1` |
+| `QUEUE_SHUTDOWN_TIMEOUT` | Graceful shutdown timeout (ms) | `30000` |
+| `QUEUE_DASHBOARD_PATH` | Bull Board path | `/admin/queues` |
+| `QUEUE_DASHBOARD_ENABLED` | Enable Bull Board | `false` |
+
+### Programmatic Configuration
+
+```typescript
+const provider = createQueueProvider({
+  config: {
+    redis: {
+      host: 'redis.example.com',
+      port: 6379,
+      password: 'secret',
+      tls: true,
+    },
+    defaultConcurrency: 5,
+    defaultRateLimiter: {
+      max: 100,
+      duration: 60000, // 100 jobs per minute
+    },
+    shutdownTimeout: 60000,
+  },
+  retryAttempts: 3,
+  retryDelay: 5000,
+});
+```
+
+## Decorators
+
+### `@Processor(queueName, options?)`
+
+Marks a class as a job processor for a specific queue.
+
+```typescript
+@Processor('my-queue', {
+  concurrency: 10,
+  rateLimiter: { max: 100, duration: 60000 },
+})
+class MyProcessor { }
+```
+
+### `@Process(jobName?)`
+
+Marks a method as a job handler. If no name is provided, uses the method name.
+
+```typescript
+@Process('send-email')
+async handleSendEmail(job: Job) { }
+
+@Process() // Uses 'processOrder' as job name
+async processOrder(job: Job) { }
+```
+
+### Event Decorators
+
+| Decorator | Event | Signature |
+|-----------|-------|-----------|
+| `@OnJobComplete()` | Job completed | `(job: Job, result: unknown)` |
+| `@OnJobFailed()` | Job failed | `(job: Job \| undefined, error: Error)` |
+| `@OnJobProgress()` | Job progress updated | `(job: Job, progress: number \| object)` |
+| `@OnJobStalled()` | Job stalled | `(jobId: string)` |
+| `@OnWorkerReady()` | Worker ready | `()` |
+| `@OnWorkerError()` | Worker error | `(error: Error)` |
+
+## Validation with Zod
+
+Use built-in Zod utilities for type-safe job validation:
+
+```typescript
+import { createJobSchema, z, CommonJobSchemas } from '@riktajs/queue';
+
+// Create custom schema
+const OrderJobSchema = createJobSchema(z.object({
+  orderId: z.string().uuid(),
+  items: z.array(z.object({
+    productId: z.string(),
+    quantity: z.number().positive(),
+  })),
+  total: z.number().positive(),
+}));
+
+// Validate in processor
+@Processor('orders')
+class OrderProcessor {
+  @Process('process')
+  async handleOrder(job: Job) {
+    const data = OrderJobSchema.validate(job.data);
+    // data is now typed as { orderId: string, items: [...], total: number }
+  }
+}
+
+// Use common schemas
+const emailData = CommonJobSchemas.email.parse({
+  to: 'user@example.com',
+  subject: 'Hello',
+  body: 'World',
+});
+```
+
+### Common Job Schemas
+
+- `CommonJobSchemas.email` - Email job with to, subject, body, attachments
+- `CommonJobSchemas.notification` - User notifications
+- `CommonJobSchemas.fileProcessing` - File operations
+- `CommonJobSchemas.webhook` - HTTP webhook calls
+
+## Event System
+
+Queue events are emitted to Rikta's EventBus:
+
+```typescript
+import { EventBus } from '@riktajs/core';
+import { QUEUE_EVENTS } from '@riktajs/queue';
+
+@Injectable()
+class MonitoringService {
+  constructor(private eventBus: EventBus) {
+    // Listen to queue events
+    eventBus.on(QUEUE_EVENTS.JOB_COMPLETED, (payload) => {
+      console.log(`Job ${payload.jobId} completed in ${payload.queueName}`);
+    });
+
+    eventBus.on(QUEUE_EVENTS.JOB_FAILED, (payload) => {
+      console.error(`Job ${payload.jobId} failed: ${payload.error}`);
+    });
+  }
+}
+```
+
+### Available Events
+
+| Event | Description |
+|-------|-------------|
+| `queue:job:added` | Job added to queue |
+| `queue:job:completed` | Job completed successfully |
+| `queue:job:failed` | Job failed |
+| `queue:job:progress` | Job progress updated |
+| `queue:job:stalled` | Job stalled |
+| `queue:job:delayed` | Job delayed |
+| `queue:worker:ready` | Worker ready |
+| `queue:worker:error` | Worker error |
+
+## Bull Board Dashboard (Optional)
+
+```typescript
+import { registerBullBoard } from '@riktajs/queue';
+
+// After app is created and queue provider initialized
+await registerBullBoard(app.server, {
+  queues: queueProvider.getAllQueues(),
+  path: '/admin/queues',
+  readOnly: false,
+  auth: async (request) => {
+    // Your authentication logic
+    const token = request.headers.authorization;
+    return validateAdminToken(token);
+  },
+});
+```
+
+**Note:** Bull Board packages must be installed separately:
+
+```bash
+npm install @bull-board/api @bull-board/fastify
+```
+
+## QueueService API
+
+### Adding Jobs
+
+```typescript
+// Single job
+await queueService.addJob(queueName, jobName, data, options?);
+
+// Multiple jobs (bulk)
+await queueService.addJobs(queueName, [{ name, data, options? }]);
+
+// Delayed job
+await queueService.addDelayedJob(queueName, jobName, data, delayMs, options?);
+
+// Repeatable job
+await queueService.addRepeatableJob(queueName, jobName, data, repeatOptions);
+```
+
+### Job Options
+
+```typescript
+await queueService.addJob('queue', 'job', data, {
+  attempts: 3,              // Retry attempts
+  backoff: {
+    type: 'exponential',    // 'fixed' | 'exponential'
+    delay: 1000,
+  },
+  priority: 1,              // Lower = higher priority
+  delay: 5000,              // Delay in ms
+  deduplicationKey: 'id',   // Prevent duplicates
+  removeOnComplete: true,   // Clean up completed jobs
+  removeOnFail: false,      // Keep failed jobs for debugging
+});
+```
+
+### Queue Management
+
+```typescript
+// Get job by ID
+const job = await queueService.getJob(queueName, jobId);
+
+// Get queue statistics
+const stats = await queueService.getQueueStats(queueName);
+// { waiting: 5, active: 2, completed: 100, failed: 3, delayed: 1, paused: 0 }
+
+// Pause/Resume
+await queueService.pauseQueue(queueName);
+await queueService.resumeQueue(queueName);
+
+// Clear jobs
+await queueService.clearQueue(queueName, 'completed');
+await queueService.clearQueue(queueName); // Clear all
+
+// Get all queue names
+const names = queueService.getQueueNames();
+```
+
+## Error Handling
+
+```typescript
+import {
+  QueueNotFoundError,
+  QueueConnectionError,
+  QueueInitializationError,
+  JobSchemaValidationError,
+} from '@riktajs/queue';
+
+try {
+  await queueService.addJob('unknown-queue', 'job', {});
+} catch (error) {
+  if (error instanceof QueueNotFoundError) {
+    console.error('Queue does not exist:', error.message);
+  }
+}
+```
+
+## Best Practices
+
+### 1. Use Type-Safe Job Data
+
+```typescript
+interface MyJobData {
+  userId: string;
+  action: 'create' | 'update' | 'delete';
+}
+
+@Process('my-job')
+async handle(job: Job<MyJobData>) {
+  const { userId, action } = job.data; // Fully typed
+}
+```
+
+### 2. Handle Failures Gracefully
+
+```typescript
+@Process('risky-job')
+async handle(job: Job) {
+  try {
+    await this.riskyOperation(job.data);
+  } catch (error) {
+    // Log for debugging
+    console.error('Job failed:', error);
+    // Re-throw to trigger retry
+    throw error;
+  }
+}
+```
+
+### 3. Use Progress Updates for Long Jobs
+
+```typescript
+@Process('long-job')
+async handle(job: Job<{ items: string[] }>) {
+  const { items } = job.data;
+  
+  for (let i = 0; i < items.length; i++) {
+    await this.processItem(items[i]);
+    await job.updateProgress(Math.round((i + 1) / items.length * 100));
+  }
+}
+```
+
+### 4. Configure Appropriate Concurrency
+
+```typescript
+// CPU-intensive tasks: lower concurrency
+@Processor('image-processing', { concurrency: 2 })
+
+// I/O-bound tasks: higher concurrency
+@Processor('api-calls', { concurrency: 20 })
+```
+
+## License
+
+MIT

package/dist/config/queue.config.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Queue configuration schema and loader
+ */
+import { z } from 'zod';
+import type { QueueConfig } from '../types.js';
+/** Zod schema for queue configuration */
+export declare const QueueConfigSchema: z.ZodObject<{
+    redis: z.ZodObject<{
+        host: z.ZodDefault<z.ZodString>;
+        port: z.ZodDefault<z.ZodNumber>;
+        password: z.ZodOptional<z.ZodString>;
+        db: z.ZodDefault<z.ZodNumber>;
+        username: z.ZodOptional<z.ZodString>;
+        tls: z.ZodOptional<z.ZodBoolean>;
+        cluster: z.ZodOptional<z.ZodObject<{
+            nodes: z.ZodArray<z.ZodObject<{
+                host: z.ZodString;
+                port: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                host: string;
+                port: number;
+            }, {
+                host: string;
+                port: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        }, {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        host: string;
+        port: number;
+        db: number;
+        password?: string | undefined;
+        username?: string | undefined;
+        tls?: boolean | undefined;
+        cluster?: {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        } | undefined;
+    }, {
+        host?: string | undefined;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        username?: string | undefined;
+        tls?: boolean | undefined;
+        cluster?: {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        } | undefined;
+    }>;
+    defaultConcurrency: z.ZodDefault<z.ZodNumber>;
+    defaultRateLimiter: z.ZodOptional<z.ZodObject<{
+        max: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        max: number;
+        duration: number;
+    }, {
+        max: number;
+        duration: number;
+    }>>;
+    dashboardPath: z.ZodDefault<z.ZodString>;
+    dashboardEnabled: z.ZodDefault<z.ZodBoolean>;
+    shutdownTimeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    redis: {
+        host: string;
+        port: number;
+        db: number;
+        password?: string | undefined;
+        username?: string | undefined;
+        tls?: boolean | undefined;
+        cluster?: {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        } | undefined;
+    };
+    defaultConcurrency: number;
+    dashboardPath: string;
+    dashboardEnabled: boolean;
+    shutdownTimeout: number;
+    defaultRateLimiter?: {
+        max: number;
+        duration: number;
+    } | undefined;
+}, {
+    redis: {
+        host?: string | undefined;
+        port?: number | undefined;
+        password?: string | undefined;
+        db?: number | undefined;
+        username?: string | undefined;
+        tls?: boolean | undefined;
+        cluster?: {
+            nodes: {
+                host: string;
+                port: number;
+            }[];
+        } | undefined;
+    };
+    defaultConcurrency?: number | undefined;
+    defaultRateLimiter?: {
+        max: number;
+        duration: number;
+    } | undefined;
+    dashboardPath?: string | undefined;
+    dashboardEnabled?: boolean | undefined;
+    shutdownTimeout?: number | undefined;
+}>;
+export type QueueConfigInput = z.input<typeof QueueConfigSchema>;
+/**
+ * Load queue configuration from environment variables
+ * @param overrides - Optional configuration overrides
+ */
+export declare function loadQueueConfig(overrides?: Partial<QueueConfigInput>): QueueConfig;
+/**
+ * Error thrown when queue configuration is invalid
+ */
+export declare class QueueConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=queue.config.d.ts.map

package/dist/config/queue.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.config.d.ts","sourceRoot":"","sources":["../../src/config/queue.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA2B/C,yCAAyC;AACzC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAoClF;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/config/queue.config.js

@@ -0,0 +1,82 @@
+/**
+ * Queue configuration schema and loader
+ */
+import { z } from 'zod';
+/** Zod schema for Redis cluster node */
+const RedisClusterNodeSchema = z.object({
+    host: z.string(),
+    port: z.number().int().positive(),
+});
+/** Zod schema for Redis connection options */
+const RedisConnectionSchema = z.object({
+    host: z.string().default('localhost'),
+    port: z.number().int().positive().default(6379),
+    password: z.string().optional(),
+    db: z.number().int().min(0).default(0),
+    username: z.string().optional(),
+    tls: z.boolean().optional(),
+    cluster: z.object({
+        nodes: z.array(RedisClusterNodeSchema).min(1),
+    }).optional(),
+});
+/** Zod schema for rate limiter */
+const RateLimiterSchema = z.object({
+    max: z.number().int().positive(),
+    duration: z.number().int().positive(),
+});
+/** Zod schema for queue configuration */
+export const QueueConfigSchema = z.object({
+    redis: RedisConnectionSchema,
+    defaultConcurrency: z.number().int().positive().default(1),
+    defaultRateLimiter: RateLimiterSchema.optional(),
+    dashboardPath: z.string().default('/admin/queues'),
+    dashboardEnabled: z.boolean().default(false),
+    shutdownTimeout: z.number().int().positive().default(30000),
+});
+/**
+ * Load queue configuration from environment variables
+ * @param overrides - Optional configuration overrides
+ */
+export function loadQueueConfig(overrides) {
+    const envConfig = {
+        redis: {
+            host: process.env['QUEUE_REDIS_HOST'] || 'localhost',
+            port: parseInt(process.env['QUEUE_REDIS_PORT'] || '6379', 10),
+            password: process.env['QUEUE_REDIS_PASSWORD'] || undefined,
+            db: parseInt(process.env['QUEUE_REDIS_DB'] || '0', 10),
+            username: process.env['QUEUE_REDIS_USERNAME'] || undefined,
+        },
+        defaultConcurrency: parseInt(process.env['QUEUE_DEFAULT_CONCURRENCY'] || '1', 10),
+        dashboardPath: process.env['QUEUE_DASHBOARD_PATH'] || '/admin/queues',
+        dashboardEnabled: process.env['QUEUE_DASHBOARD_ENABLED'] === 'true',
+        shutdownTimeout: parseInt(process.env['QUEUE_SHUTDOWN_TIMEOUT'] || '30000', 10),
+    };
+    // Merge with overrides
+    const merged = {
+        ...envConfig,
+        ...overrides,
+        redis: {
+            ...envConfig.redis,
+            ...overrides?.redis,
+        },
+    };
+    // Validate and return
+    const result = QueueConfigSchema.safeParse(merged);
+    if (!result.success) {
+        const errors = result.error.errors
+            .map(e => `${e.path.join('.')}: ${e.message}`)
+            .join(', ');
+        throw new QueueConfigError(`Invalid queue configuration: ${errors}`);
+    }
+    return result.data;
+}
+/**
+ * Error thrown when queue configuration is invalid
+ */
+export class QueueConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'QueueConfigError';
+    }
+}
+//# sourceMappingURL=queue.config.js.map

package/dist/config/queue.config.js.map

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