@archlast/server 0.1.7 → 0.1.9

package/dist/jobs/circuit-breaker.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Circuit Breaker Pattern Implementation
+ *
+ * Prevents cascading failures by temporarily blocking execution
+ * of job types that are experiencing repeated failures.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Blocking requests after threshold failures
+ * - HALF_OPEN: Testing if service has recovered
+ */
+import type { Registry } from "prom-client";
+export interface CircuitBreakerConfig {
+    /**
+     * Number of consecutive failures before tripping to OPEN state
+     * Default: 5
+     */
+    failureThreshold: number;
+    /**
+     * Number of consecutive successes needed to reset to CLOSED
+     * Default: 2
+     */
+    successThreshold: number;
+    /**
+     * Time in ms before attempting reset from OPEN to HALF_OPEN
+     * Default: 30000 (30 seconds)
+     */
+    resetTimeoutMs: number;
+    /**
+     * Maximum concurrent calls allowed in HALF_OPEN state
+     * Default: 3
+     */
+    halfOpenMaxCalls: number;
+}
+export type CircuitState = "closed" | "open" | "half_open";
+export interface CircuitBreakerState {
+    state: CircuitState;
+    failureCount: number;
+    successCount: number;
+    lastFailureTime: number;
+    lastStateChange: number;
+    halfOpenCalls: number;
+}
+export interface CircuitBreakerMetrics {
+    circuitBreakerState: any;
+    circuitBreakerOpened: any;
+}
+/**
+ * Error thrown when circuit breaker is OPEN
+ */
+export declare class CircuitBreakerOpenError extends Error {
+    constructor(jobName: string);
+}
+/**
+ * Circuit Breaker implementation for job execution protection
+ */
+export declare class CircuitBreaker {
+    private readonly config;
+    private readonly breakers;
+    private metrics?;
+    constructor(config: CircuitBreakerConfig, metricsRegistry?: Registry);
+    /**
+     * Execute a job with circuit breaker protection
+     *
+     * @param jobName - Name of the job type
+     * @param fn - Async function to execute
+     * @returns Result of the function
+     * @throws {CircuitBreakerOpenError} If circuit is open
+     * @throws {Error} If the function itself fails
+     */
+    execute<T>(jobName: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get or create a circuit breaker for a job type
+     */
+    private getOrCreateBreaker;
+    /**
+     * Check if enough time has passed to attempt reset
+     */
+    private shouldAttemptReset;
+    /**
+     * Transition breaker to half_open state
+     */
+    private transitionToHalfOpen;
+    /**
+     * Handle successful execution
+     */
+    private onSuccess;
+    /**
+     * Transition breaker to closed state
+     */
+    private transitionToClosed;
+    /**
+     * Handle failed execution
+     */
+    private onFailure;
+    /**
+     * Transition breaker to open state
+     */
+    private transitionToOpen;
+    /**
+     * Get current state of circuit breaker for a job type
+     */
+    getState(jobName: string): CircuitBreakerState | null;
+    /**
+     * Manually reset circuit breaker for a job type
+     */
+    reset(jobName: string): void;
+    /**
+     * Get all circuit breaker states
+     */
+    getAllStates(): Map<string, CircuitBreakerState>;
+    /**
+     * Get statistics about all circuit breakers
+     */
+    getStats(): {
+        total: number;
+        byState: Record<CircuitState, number>;
+    };
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/jobs/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/jobs/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACjC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IAClC,mBAAmB,EAAE,GAAG,CAAC;IACzB,oBAAoB,EAAE,GAAG,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI9B;AAED;;GAEG;AACH,qBAAa,cAAc;IAKnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,OAAO,CAAC,CAAwB;gBAGnB,MAAM,EAAE,oBAAoB,EAC7C,eAAe,CAAC,EAAE,QAAQ;IA0B9B;;;;;;;;OAQG;IACG,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA8BnE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAmBjB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIrD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B;;OAEG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAQhD;;OAEG;IACH,QAAQ,IAAI;QACR,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;KACzC;CAgBJ"}

package/dist/jobs/circuit-breaker.js

@@ -0,0 +1,262 @@
+"use strict";
+/**
+ * Circuit Breaker Pattern Implementation
+ *
+ * Prevents cascading failures by temporarily blocking execution
+ * of job types that are experiencing repeated failures.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Blocking requests after threshold failures
+ * - HALF_OPEN: Testing if service has recovered
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitBreakerOpenError = void 0;
+const logger_js_1 = require("../logging/logger.js");
+/**
+ * Error thrown when circuit breaker is OPEN
+ */
+class CircuitBreakerOpenError extends Error {
+    constructor(jobName) {
+        super(`Circuit breaker is OPEN for job type: ${jobName}`);
+        this.name = "CircuitBreakerOpenError";
+    }
+}
+exports.CircuitBreakerOpenError = CircuitBreakerOpenError;
+/**
+ * Circuit Breaker implementation for job execution protection
+ */
+class CircuitBreaker {
+    config;
+    breakers = new Map();
+    metrics;
+    constructor(config, metricsRegistry) {
+        this.config = config;
+        // Initialize metrics if registry provided
+        if (metricsRegistry) {
+            // Dynamic import to avoid issues if prom-client not available
+            import("prom-client").then(({ Gauge, Counter }) => {
+                this.metrics = {
+                    circuitBreakerState: new Gauge({
+                        name: "archlast_circuit_breaker_state",
+                        help: "Circuit breaker state (0=closed, 1=half_open, 2=open)",
+                        labelNames: ["job_name", "state"],
+                        registers: [metricsRegistry],
+                    }),
+                    circuitBreakerOpened: new Counter({
+                        name: "archlast_circuit_breaker_opened_total",
+                        help: "Total number of times circuit breaker opened",
+                        labelNames: ["job_name"],
+                        registers: [metricsRegistry],
+                    }),
+                };
+            }).catch(() => {
+                // Silently fail if metrics not available
+            });
+        }
+    }
+    /**
+     * Execute a job with circuit breaker protection
+     *
+     * @param jobName - Name of the job type
+     * @param fn - Async function to execute
+     * @returns Result of the function
+     * @throws {CircuitBreakerOpenError} If circuit is open
+     * @throws {Error} If the function itself fails
+     */
+    async execute(jobName, fn) {
+        const breaker = this.getOrCreateBreaker(jobName);
+        // Check if circuit is open
+        if (breaker.state === "open") {
+            if (this.shouldAttemptReset(breaker)) {
+                this.transitionToHalfOpen(breaker, jobName);
+            }
+            else {
+                throw new CircuitBreakerOpenError(jobName);
+            }
+        }
+        // Check half-open call limit
+        if (breaker.state === "half_open") {
+            if (breaker.halfOpenCalls >= this.config.halfOpenMaxCalls) {
+                throw new CircuitBreakerOpenError(jobName);
+            }
+            breaker.halfOpenCalls++;
+        }
+        try {
+            const result = await fn();
+            this.onSuccess(jobName);
+            return result;
+        }
+        catch (error) {
+            this.onFailure(jobName);
+            throw error;
+        }
+    }
+    /**
+     * Get or create a circuit breaker for a job type
+     */
+    getOrCreateBreaker(jobName) {
+        if (!this.breakers.has(jobName)) {
+            const initialState = {
+                state: "closed",
+                failureCount: 0,
+                successCount: 0,
+                lastFailureTime: 0,
+                lastStateChange: Date.now(),
+                halfOpenCalls: 0,
+            };
+            this.breakers.set(jobName, initialState);
+            // Initialize state metric
+            if (this.metrics) {
+                this.metrics.circuitBreakerState?.set({ job_name: jobName, state: "closed" }, 1);
+            }
+        }
+        return this.breakers.get(jobName);
+    }
+    /**
+     * Check if enough time has passed to attempt reset
+     */
+    shouldAttemptReset(breaker) {
+        const timeSinceFailure = Date.now() - breaker.lastFailureTime;
+        return timeSinceFailure >= this.config.resetTimeoutMs;
+    }
+    /**
+     * Transition breaker to half_open state
+     */
+    transitionToHalfOpen(breaker, jobName) {
+        breaker.state = "half_open";
+        breaker.successCount = 0;
+        breaker.halfOpenCalls = 0;
+        breaker.lastStateChange = Date.now();
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "warn",
+            kind: "system",
+            message: `[CircuitBreaker] Transitioned to HALF_OPEN for job: ${jobName}`,
+        });
+        // Emit metric
+        if (this.metrics) {
+            this.metrics.circuitBreakerState?.set({ job_name: jobName, state: "half_open" }, 1);
+        }
+    }
+    /**
+     * Handle successful execution
+     */
+    onSuccess(jobName) {
+        const breaker = this.breakers.get(jobName);
+        if (!breaker)
+            return;
+        if (breaker.state === "half_open") {
+            breaker.successCount++;
+            if (breaker.successCount >= this.config.successThreshold) {
+                // Reset to closed
+                this.transitionToClosed(breaker, jobName);
+            }
+        }
+        else if (breaker.state === "closed") {
+            // Reset failure count on success in closed state
+            breaker.failureCount = 0;
+        }
+    }
+    /**
+     * Transition breaker to closed state
+     */
+    transitionToClosed(breaker, jobName) {
+        breaker.state = "closed";
+        breaker.failureCount = 0;
+        breaker.successCount = 0;
+        breaker.halfOpenCalls = 0;
+        breaker.lastStateChange = Date.now();
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "info",
+            kind: "system",
+            message: `[CircuitBreaker] Reset to CLOSED for job: ${jobName}`,
+        });
+        // Emit metric
+        if (this.metrics) {
+            this.metrics.circuitBreakerState?.set({ job_name: jobName, state: "closed" }, 1);
+        }
+    }
+    /**
+     * Handle failed execution
+     */
+    onFailure(jobName) {
+        const breaker = this.breakers.get(jobName);
+        if (!breaker)
+            return;
+        breaker.failureCount++;
+        breaker.lastFailureTime = Date.now();
+        // Check if should trip to open
+        if (breaker.state === "closed" &&
+            breaker.failureCount >= this.config.failureThreshold) {
+            this.transitionToOpen(breaker, jobName);
+        }
+        else if (breaker.state === "half_open") {
+            // Back to open on failure in half_open
+            this.transitionToOpen(breaker, jobName);
+        }
+    }
+    /**
+     * Transition breaker to open state
+     */
+    transitionToOpen(breaker, jobName) {
+        breaker.state = "open";
+        breaker.lastStateChange = Date.now();
+        logger_js_1.logger.log({
+            timestamp: Date.now(),
+            level: "error",
+            kind: "system",
+            message: `[CircuitBreaker] Tripped to OPEN for job: ${jobName} after ${breaker.failureCount} failures`,
+        });
+        // Emit metrics
+        if (this.metrics) {
+            this.metrics.circuitBreakerOpened?.inc({ job_name: jobName });
+            this.metrics.circuitBreakerState?.set({ job_name: jobName, state: "open" }, 1);
+        }
+    }
+    /**
+     * Get current state of circuit breaker for a job type
+     */
+    getState(jobName) {
+        return this.breakers.get(jobName) || null;
+    }
+    /**
+     * Manually reset circuit breaker for a job type
+     */
+    reset(jobName) {
+        const breaker = this.breakers.get(jobName);
+        if (breaker) {
+            this.transitionToClosed(breaker, jobName);
+        }
+    }
+    /**
+     * Get all circuit breaker states
+     */
+    getAllStates() {
+        const result = new Map();
+        this.breakers.forEach((value, key) => {
+            result.set(key, value);
+        });
+        return result;
+    }
+    /**
+     * Get statistics about all circuit breakers
+     */
+    getStats() {
+        const byState = {
+            closed: 0,
+            open: 0,
+            half_open: 0,
+        };
+        this.breakers.forEach((breaker) => {
+            byState[breaker.state]++;
+        });
+        return {
+            total: this.breakers.size,
+            byState,
+        };
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/jobs/circuit-breaker.js.map

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

package/dist/jobs/index.d.ts

@@ -3,5 +3,5 @@ import { Scheduler, SchedulePreset, intervalToCron, type ScheduledJob } from "./
 /**
  * Public API for Archlast job system.
  */
-export { JobQueue, Scheduler, SchedulePreset, intervalToCron, ScheduledJob, };
+export { JobQueue, Scheduler, SchedulePreset, intervalToCron, ScheduledJob };
 //# sourceMappingURL=index.d.ts.map

package/dist/jobs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9F;;GAEG;AACH,OAAO,EACH,QAAQ,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,YAAY,GACf,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9F;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC"}

package/dist/jobs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAOlC,yFAPK,mBAAQ,OAOL;AANZ,iDAA8F;AAO1F,0FAPK,wBAAS,OAOL;AACT,+FARgB,6BAAc,OAQhB;AACd,+FATgC,6BAAc,OAShC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAM7B,yFANA,mBAAQ,OAMA;AALjB,iDAA8F;AAK3E,0FALV,wBAAS,OAKU;AAAE,+FALV,6BAAc,OAKU;AAAE,+FALV,6BAAc,OAKU"}

package/dist/jobs/queue.d.ts

@@ -1,6 +1,14 @@
 import type { IDatabaseClient } from "../db/interfaces.js";
 import type { CacheClient } from "../cache/client.js";
 export declare const JOBS_COLLECTION = "_jobs";
+export declare const JOBS_DLQ_COLLECTION = "_jobs_dlq";
+export interface JobDLQRecord<Payload = unknown> extends JobRecord<Payload> {
+    originalJobId: string;
+    deadLetteredAt: number;
+    errorCategory: "timeout" | "validation" | "dependency" | "system";
+    diagnostics: Record<string, unknown>;
+    reprocessCount: number;
+}
 export type JobStatus = "pending" | "active" | "completed" | "failed";
 export interface JobRecord<Payload = unknown> {
     _id: string;
@@ -14,10 +22,16 @@ export interface JobRecord<Payload = unknown> {
     createdAt: number;
     updatedAt: number;
     lastError?: string | null;
+    priority?: number;
+    timeoutMs?: number;
+    dependsOn?: string[];
 }
 export interface EnqueueOptions {
     runAfterMs?: number;
     maxAttempts?: number;
+    priority?: number;
+    timeoutMs?: number;
+    dependsOn?: string[];
 }
 export interface JobQueueOptions {
     /**
@@ -47,16 +61,121 @@ export declare class JobQueue {
     constructor(options: JobQueueOptions);
     private emitRevalidation;
     enqueue<Payload = unknown>(name: string, payload: Payload, options?: EnqueueOptions): Promise<string>;
+    /**
+     * Calculate effective priority with aging to prevent starvation.
+     * Low-priority jobs gain priority over time (1 point every 15 minutes, max 5 points).
+     */
+    private calculateEffectivePriority;
+    /**
+     * Apply aging boost to old pending jobs to prevent starvation.
+     * This updates the priority field in the database for jobs that have been waiting too long.
+     */
+    private applyAgingToPendingJobs;
     /**
      * Claim the next available job for execution.
      * Returns null if none are ready.
      */
     claimNext<Payload = unknown>(): Promise<JobRecord<Payload> | null>;
-    complete(id: string): Promise<void>;
+    complete(id: string, jobName?: string): Promise<void>;
     fail(job: JobRecord, error: unknown, backoffMs?: number): Promise<void>;
+    /**
+     * Categorize error for DLQ classification
+     */
+    private categorizeError;
+    /**
+     * Extract diagnostic information from error
+     */
+    private extractDiagnostics;
     getJob<Payload = unknown>(id: string): Promise<JobRecord<Payload> | null>;
     listJobs<Payload = unknown>(status?: JobStatus): Promise<JobRecord<Payload>[]>;
     dispose(): void;
     private mapDoc;
+    /**
+     * List DLQ jobs with optional filtering and pagination
+     */
+    getDLQJobs<Payload = unknown>(options?: {
+        limit?: number;
+        offset?: number;
+        errorCategory?: string;
+        jobName?: string;
+    }): Promise<JobDLQRecord<Payload>[]>;
+    /**
+     * Get specific DLQ job by ID
+     */
+    getDLQJob<Payload = unknown>(id: string): Promise<JobDLQRecord<Payload> | null>;
+    /**
+     * Get DLQ statistics
+     */
+    getDLQStats(): Promise<{
+        totalDLQJobs: number;
+        byStatus: Record<string, number>;
+        byErrorCategory: Record<string, number>;
+        byJobName: Record<string, number>;
+        oldestFailure: number | null;
+        recentFailures24h: number;
+    }>;
+    /**
+     * Reprocess a job from DLQ back to main queue
+     * @param dlqJobId - ID of DLQ job
+     * @param options - Reprocessing options
+     * @returns ID of new job in 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
+     * @param olderThanMs - Age in milliseconds (default: 30 days)
+     * @returns Number of jobs purged
+     */
+    purgeDLQ(olderThanMs?: number): Promise<number>;
+    /**
+     * Get queue statistics
+     */
+    getQueueStats(): Promise<{
+        totalJobs: number;
+        pendingJobs: number;
+        activeJobs: number;
+        completedJobs: number;
+        failedJobs: number;
+        dlqJobs: number;
+        avgProcessingTime: number;
+        priorityDistribution: Record<string, number>;
+    }>;
+    /**
+     * Get queue depth by priority level
+     */
+    getQueueDepthByPriority(): Promise<Array<{
+        priority: number;
+        count: number;
+        label: string;
+    }>>;
+    /**
+     * Update job priority
+     */
+    updateJobPriority(jobId: string, priority: number): Promise<void>;
+    private getPriorityLabel;
+    /**
+     * Find jobs that are stuck in "active" status (worker terminated)
+     * Returns jobs that have been active longer than the specified timeout
+     */
+    findStuckJobs(timeoutMs?: number): Promise<JobRecord[]>;
+    /**
+     * Reset a stuck job from "active" to "pending" status
+     * Use this when a worker has terminated and left jobs in active state
+     */
+    resetStuckJob(jobId: string): Promise<void>;
+    /**
+     * Bulk reset multiple stuck jobs
+     */
+    resetStuckJobs(jobIds: string[]): Promise<{
+        reset: number;
+        failed: number;
+    }>;
 }
 //# sourceMappingURL=queue.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,OAAO;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,EAAE,EAAE,eAAe,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC7B;AAED,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAc;gBAE/B,OAAO,EAAE,eAAe;IAOpC,OAAO,CAAC,gBAAgB;IAOlB,OAAO,CAAC,OAAO,GAAG,OAAO,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IA+BlB;;;OAGG;IACG,SAAS,CAAC,OAAO,GAAG,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAgElE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvE,MAAM,CAAC,OAAO,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAMzE,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;IAapF,OAAO;IAIP,OAAO,CAAC,MAAM;CAejB"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"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"}