@archlast/server 0.1.7 → 0.1.9

package/dist/jobs/bullmq-adapter.d.ts

@@ -0,0 +1,154 @@
+import type { JobRecord, JobDLQRecord, JobStatus, EnqueueOptions, JobQueueOptions } from "./queue.js";
+interface BullMQJobQueueOptions extends JobQueueOptions {
+    queueName?: string;
+}
+interface QueueStats {
+    totalJobs: number;
+    pendingJobs: number;
+    activeJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    dlqJobs: number;
+    avgProcessingTime: number;
+    priorityDistribution: Record<string, number>;
+}
+interface DLQStats {
+    totalDLQJobs: number;
+    byStatus: Record<string, number>;
+    byErrorCategory: Record<string, number>;
+    byJobName: Record<string, number>;
+    oldestFailure: number | null;
+    recentFailures24h: number;
+}
+/**
+ * BullMQ-based implementation of the JobQueue interface.
+ * Uses BullMQ Queue for job management and a separate DLQ queue for failed jobs.
+ */
+export declare class BullMQJobQueue {
+    private readonly queue;
+    private readonly dlqQueue;
+    private readonly defaultMaxAttempts;
+    private readonly backoffBaseMs;
+    private readonly queueName;
+    private disposed;
+    constructor(options: BullMQJobQueueOptions);
+    /**
+     * Enqueue a new job
+     */
+    enqueue<Payload = unknown>(name: string, payload: Payload, options?: EnqueueOptions): Promise<string>;
+    /**
+     * Claim the next available job for execution.
+     * Note: In BullMQ, workers handle job claiming automatically.
+     * This method is kept for interface compatibility but returns null
+     * as BullMQ workers handle the actual claiming.
+     */
+    claimNext<Payload = unknown>(): Promise<JobRecord<Payload> | null>;
+    /**
+     * Mark a job as completed
+     */
+    complete(id: string, jobName?: string): Promise<void>;
+    /**
+     * Handle job failure - either retry or move to DLQ
+     */
+    fail(job: JobRecord, error: unknown, backoffMs?: number): Promise<void>;
+    /**
+     * Move a job to the Dead Letter Queue
+     */
+    private moveToDLQ;
+    /**
+     * Categorize error for DLQ classification
+     */
+    private categorizeError;
+    /**
+     * Extract diagnostic information from error
+     */
+    private extractDiagnostics;
+    /**
+     * Get a job by ID
+     */
+    getJob<Payload = unknown>(id: string): Promise<JobRecord<Payload> | null>;
+    /**
+     * List jobs by status
+     */
+    listJobs<Payload = unknown>(status?: JobStatus): Promise<JobRecord<Payload>[]>;
+    /**
+     * Map BullMQ Job to JobRecord
+     */
+    private mapBullMQJobToJobRecord;
+    /**
+     * List DLQ jobs with optional filtering and pagination
+     */
+    getDLQJobs<Payload = unknown>(options?: {
+        limit?: number;
+        offset?: number;
+        errorCategory?: string;
+        jobName?: string;
+    }): Promise<JobDLQRecord<Payload>[]>;
+    /**
+     * Map BullMQ Job to JobDLQRecord
+     */
+    private mapBullMQJobToDLQRecord;
+    /**
+     * Get specific DLQ job by ID
+     */
+    getDLQJob<Payload = unknown>(id: string): Promise<JobDLQRecord<Payload> | null>;
+    /**
+     * Get DLQ statistics
+     */
+    getDLQStats(): Promise<DLQStats>;
+    /**
+     * Reprocess a job from DLQ back to main queue
+     */
+    reprocessFromDLQ(dlqJobId: string, options?: {
+        newMaxAttempts?: number;
+        priority?: number;
+    }): Promise<string>;
+    /**
+     * Delete specific DLQ job
+     */
+    deleteFromDLQ(id: string): Promise<void>;
+    /**
+     * Purge DLQ jobs older than specified time
+     */
+    purgeDLQ(olderThanMs?: number): Promise<number>;
+    /**
+     * Get queue statistics
+     */
+    getQueueStats(): Promise<QueueStats>;
+    /**
+     * Get queue depth by priority level
+     */
+    getQueueDepthByPriority(): Promise<Array<{
+        priority: number;
+        count: number;
+        label: string;
+    }>>;
+    private getPriorityLabel;
+    /**
+     * Update job priority
+     * Note: BullMQ doesn't support changing priority after job creation,
+     * so we remove and re-add the job with the new priority.
+     */
+    updateJobPriority(jobId: string, priority: number): Promise<void>;
+    /**
+     * Find jobs that are stuck in "active" status (worker terminated)
+     */
+    findStuckJobs(timeoutMs?: number): Promise<JobRecord[]>;
+    /**
+     * Reset a stuck job from "active" to "pending" status
+     */
+    resetStuckJob(jobId: string): Promise<void>;
+    /**
+     * Bulk reset multiple stuck jobs
+     */
+    resetStuckJobs(jobIds: string[]): Promise<{
+        reset: number;
+        failed: number;
+    }>;
+    /**
+     * Dispose of the queue connections
+     */
+    dispose(): void;
+}
+export default BullMQJobQueue;
+//# sourceMappingURL=bullmq-adapter.d.ts.map

package/dist/jobs/bullmq-adapter.d.ts.map

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