@buenojs/bueno 0.8.10 → 0.8.11

package/dist/jobs/drivers/redis.js

@@ -0,0 +1,355 @@
+/**
+ * Redis Job Queue Driver
+ *
+ * Production-grade driver using Bun's native Redis client.
+ * Supports atomic operations via Lua scripts.
+ */
+// ============= Lua Scripts =============
+/**
+ * Atomic job claim script
+ * Moves a job from pending to processing with ownership verification
+ */
+const CLAIM_JOB_SCRIPT = `
+local jobId = KEYS[1]
+local processingKey = KEYS[2]
+local jobKey = KEYS[3]
+
+local jobData = redis.call("ZRANGE", processingKey, 0, 0)[1]
+if jobData then
+  return nil
+end
+
+-- Get the job from pending
+local job = redis.call("GET", jobKey)
+if not job then
+  return nil
+end
+
+-- Move to processing with expiry timestamp
+local expiryMs = tonumber(ARGV[1])
+redis.call("ZADD", processingKey, expiryMs, jobId)
+redis.call("ZREM", ARGV[2], jobId)
+
+return job
+`;
+/**
+ * Atomic job completion script
+ */
+const COMPLETE_JOB_SCRIPT = `
+local jobId = KEYS[1]
+local jobKey = KEYS[2]
+local processingKey = KEYS[3]
+
+local job = redis.call("GET", jobKey)
+if not job then
+  return nil
+end
+
+-- Update job status in JSON
+local decoded = cjson.decode(job)
+decoded.status = "completed"
+decoded.completedAt = ARGV[1]
+decoded.updatedAt = ARGV[1]
+
+if decoded.startedAt then
+  local started = tonumber(string.sub(decoded.startedAt, 1, -5))
+  local ended = tonumber(string.sub(ARGV[1], 1, -5))
+  decoded.duration = ended - started
+end
+
+local updated = cjson.encode(decoded)
+redis.call("SET", jobKey, updated)
+redis.call("ZREM", processingKey, jobId)
+
+return updated
+`;
+/**
+ * Atomic job failure script
+ */
+const FAIL_JOB_SCRIPT = `
+local jobId = KEYS[1]
+local jobKey = KEYS[2]
+local processingKey = KEYS[3]
+local failedKey = KEYS[4]
+
+local job = redis.call("GET", jobKey)
+if not job then
+  return nil
+end
+
+local decoded = cjson.decode(job)
+decoded.status = "failed"
+decoded.error = ARGV[1]
+if ARGV[2] and ARGV[2] ~= "" then
+  decoded.stackTrace = ARGV[2]
+end
+decoded.updatedAt = ARGV[3]
+
+local updated = cjson.encode(decoded)
+redis.call("SET", jobKey, updated)
+redis.call("ZREM", processingKey, jobId)
+redis.call("ZADD", failedKey, tonumber(ARGV[3]), jobId)
+
+return updated
+`;
+/**
+ * Schedule retry script
+ */
+const SCHEDULE_RETRY_SCRIPT = `
+local jobId = KEYS[1]
+local jobKey = KEYS[2]
+local processingKey = KEYS[3]
+local failedKey = KEYS[4]
+local pendingKey = KEYS[5]
+
+local job = redis.call("GET", jobKey)
+if not job then
+  return nil
+end
+
+local decoded = cjson.decode(job)
+decoded.status = "delayed"
+decoded.error = ARGV[1]
+decoded.scheduledFor = ARGV[2]
+decoded.updatedAt = ARGV[3]
+
+local updated = cjson.encode(decoded)
+redis.call("SET", jobKey, updated)
+redis.call("ZREM", processingKey, jobId)
+redis.call("ZREM", failedKey, jobId)
+-- Add to pending with scheduled timestamp
+redis.call("ZADD", pendingKey, tonumber(ARGV[4]), jobId)
+
+return updated
+`;
+// ============= Redis Job Queue Driver =============
+export class RedisJobQueueDriver {
+    config;
+    client = null;
+    _isConnected = false;
+    keyPrefix;
+    constructor(config = {}) {
+        this.config = config;
+        this.keyPrefix = config.keyPrefix ?? "jobs:";
+    }
+    /**
+     * Get prefixed key name
+     */
+    key(suffix) {
+        return `${this.keyPrefix}${suffix}`;
+    }
+    /**
+     * Type-safe Redis client getter
+     */
+    getClient() {
+        return this.client;
+    }
+    async connect() {
+        try {
+            // @ts-ignore - Bun runtime API
+            const { RedisClient } = await import("bun");
+            if (!this.config.url) {
+                throw new Error("Redis URL is required for RedisJobQueueDriver");
+            }
+            this.client = new RedisClient(this.config.url);
+            this._isConnected = true;
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to Redis: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async disconnect() {
+        this._isConnected = false;
+        this.client = null;
+    }
+    async isConnected() {
+        return this._isConnected;
+    }
+    async enqueue(name, data, options) {
+        const client = this.getClient();
+        const jobId = `${name}:${Date.now()}:${Math.random().toString(36).slice(2)}`;
+        const now = new Date();
+        const job = {
+            id: jobId,
+            name,
+            data,
+            status: "pending",
+            attempts: 0,
+            maxRetries: options?.maxRetries ?? this.config.maxRetries ?? 3,
+            createdAt: now.toISOString(),
+            updatedAt: now.toISOString(),
+            priority: options?.priority ?? 0,
+            metadata: options?.metadata,
+        };
+        // Handle delayed jobs
+        let scheduledScore = now.getTime();
+        if (options?.delay) {
+            const delayMs = options.delay instanceof Date
+                ? options.delay.getTime() - Date.now()
+                : options.delay;
+            if (delayMs > 0) {
+                job.status = "delayed";
+                job.scheduledFor = new Date(now.getTime() + delayMs).toISOString();
+                scheduledScore = now.getTime() + delayMs;
+            }
+        }
+        // Store job data
+        await client.set(this.key(`job:${jobId}`), JSON.stringify(job));
+        // Add to pending queue (sorted by creation time for FIFO)
+        await client.zadd(this.key("queue:pending"), scheduledScore, jobId);
+        // Update metrics
+        await client.hincrby(this.key("metrics"), "enqueued", 1);
+        return jobId;
+    }
+    async claim(count, timeout) {
+        const client = this.getClient();
+        const now = Date.now();
+        const claimed = [];
+        try {
+            // Get pending jobs (oldest first - FIFO)
+            const jobIds = await client.zrange(this.key("queue:pending"), 0, count - 1);
+            for (const jobId of jobIds) {
+                if (claimed.length >= count)
+                    break;
+                const jobKey = this.key(`job:${jobId}`);
+                const jobData = await client.get(jobKey);
+                if (!jobData)
+                    continue;
+                const job = JSON.parse(jobData);
+                job.status = "processing";
+                job.attempts = (job.attempts || 0) + 1;
+                job.startedAt = new Date().toISOString();
+                job.claimExpiresAt = new Date(now + timeout).toISOString();
+                job.updatedAt = new Date().toISOString();
+                // Atomically move to processing
+                await client.set(jobKey, JSON.stringify(job));
+                await client.zadd(this.key("queue:processing"), now + timeout, jobId);
+                await client.zrem(this.key("queue:pending"), jobId);
+                claimed.push(job);
+            }
+            return claimed;
+        }
+        catch (error) {
+            console.error("Error claiming jobs:", error);
+            return [];
+        }
+    }
+    async complete(jobId) {
+        const client = this.getClient();
+        const jobKey = this.key(`job:${jobId}`);
+        const jobData = await client.get(jobKey);
+        if (!jobData)
+            return;
+        const job = JSON.parse(jobData);
+        const now = new Date();
+        job.status = "completed";
+        job.completedAt = now.toISOString();
+        job.updatedAt = now.toISOString();
+        if (job.startedAt) {
+            job.duration =
+                new Date(job.completedAt).getTime() - new Date(job.startedAt).getTime();
+        }
+        // Update job and remove from processing
+        await client.set(jobKey, JSON.stringify(job));
+        await client.zrem(this.key("queue:processing"), jobId);
+        // Update metrics
+        await client.hincrby(this.key("metrics"), "processed", 1);
+        if (job.duration) {
+            await client.hincrby(this.key("metrics"), "totalLatency", Math.floor(job.duration));
+        }
+    }
+    async fail(jobId, error, stackTrace) {
+        const client = this.getClient();
+        const jobKey = this.key(`job:${jobId}`);
+        const jobData = await client.get(jobKey);
+        if (!jobData)
+            return;
+        const job = JSON.parse(jobData);
+        job.error = error;
+        job.stackTrace = stackTrace;
+        job.status = "failed";
+        job.updatedAt = new Date().toISOString();
+        await client.set(jobKey, JSON.stringify(job));
+        await client.zrem(this.key("queue:processing"), jobId);
+        await client.zadd(this.key("queue:failed"), Date.now(), jobId);
+        // Update metrics
+        await client.hincrby(this.key("metrics"), "failed", 1);
+    }
+    async scheduleRetry(jobId, delayMs, error) {
+        const client = this.getClient();
+        const jobKey = this.key(`job:${jobId}`);
+        const jobData = await client.get(jobKey);
+        if (!jobData)
+            return;
+        const job = JSON.parse(jobData);
+        job.status = "delayed";
+        job.error = error;
+        job.scheduledFor = new Date(Date.now() + delayMs).toISOString();
+        job.updatedAt = new Date().toISOString();
+        await client.set(jobKey, JSON.stringify(job));
+        await client.zrem(this.key("queue:processing"), jobId);
+        // Re-add to pending with scheduled timestamp
+        await client.zadd(this.key("queue:pending"), Date.now() + delayMs, jobId);
+        // Update metrics
+        await client.hincrby(this.key("metrics"), "retried", 1);
+    }
+    async getJob(jobId) {
+        const client = this.getClient();
+        const jobData = await client.get(this.key(`job:${jobId}`));
+        if (!jobData)
+            return null;
+        return JSON.parse(jobData);
+    }
+    async getMetrics() {
+        const client = this.getClient();
+        const metricsData = await client.hgetall(this.key("metrics"));
+        const pendingCount = await client.zcard(this.key("queue:pending"));
+        const processingCount = await client.zcard(this.key("queue:processing"));
+        const enqueued = Number.parseInt(metricsData.enqueued || "0");
+        const processed = Number.parseInt(metricsData.processed || "0");
+        const failed = Number.parseInt(metricsData.failed || "0");
+        const totalLatency = Number.parseInt(metricsData.totalLatency || "0");
+        const retried = Number.parseInt(metricsData.retried || "0");
+        const total = enqueued;
+        const successRate = total > 0 ? processed / total : 0;
+        const avgLatency = processed > 0 ? totalLatency / processed : 0;
+        return {
+            enqueued,
+            processed,
+            failed,
+            pending: pendingCount,
+            processing: processingCount,
+            avgLatency,
+            totalLatency,
+            retried,
+            successRate,
+            avgAttempts: enqueued > 0 ? (processed + failed) / enqueued : 0,
+        };
+    }
+    async clear() {
+        const client = this.getClient();
+        const keys = [
+            this.key("queue:pending"),
+            this.key("queue:processing"),
+            this.key("queue:failed"),
+            this.key("metrics"),
+        ];
+        // Also clear all job data
+        const pendingJobs = await client.zrange(this.key("queue:pending"), 0, -1);
+        for (const jobId of pendingJobs) {
+            keys.push(this.key(`job:${jobId}`));
+        }
+        const processingJobs = await client.zrange(this.key("queue:processing"), 0, -1);
+        for (const jobId of processingJobs) {
+            keys.push(this.key(`job:${jobId}`));
+        }
+        const failedJobs = await client.zrange(this.key("queue:failed"), 0, -1);
+        for (const jobId of failedJobs) {
+            keys.push(this.key(`job:${jobId}`));
+        }
+        if (keys.length > 0) {
+            await client.del(...keys);
+        }
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/jobs/drivers/redis.js.map

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

package/dist/jobs/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Background Jobs Module
+ *
+ * Complete job queue system with Redis/Memory drivers,
+ * handler registration, and event system.
+ */
+export type { Job, JobStatus, JobQueueConfig, QueueOptions, JobHandler, QueueMetrics, JobEvent, JobEventType, JobClaimHandle, JobQueueDriver, HandlerRegistryEntry, JobConfigValidationResult, } from "./types";
+export { JobQueue, createJobQueue } from "./queue";
+export { JobWorker, startWorker } from "./worker";
+export { MemoryJobQueueDriver } from "./drivers/memory";
+export { RedisJobQueueDriver } from "./drivers/redis";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACX,GAAG,EACH,SAAS,EACT,cAAc,EACd,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,GACzB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElD,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/jobs/queue.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Job Queue Factory and API
+ *
+ * Main public interface for enqueueing and managing background jobs.
+ * Supports both Redis and in-memory drivers.
+ */
+import type { Job, JobEvent, JobEventType, JobHandler, JobQueueConfig, QueueMetrics, QueueOptions } from "./types";
+export declare class JobQueue {
+    private driver;
+    private handlers;
+    private handlerRegistry;
+    private eventListeners;
+    private isRunning;
+    constructor(config?: JobQueueConfig);
+    /**
+     * Initialize the queue (connect to backend)
+     */
+    init(): Promise<void>;
+    /**
+     * Shutdown the queue gracefully
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Enqueue a job
+     * @param name - Job name/type (e.g., "email.welcome")
+     * @param data - Job payload
+     * @param options - Queue options (delay, priority, timeout)
+     * @returns Job ID
+     */
+    enqueue<T = unknown>(name: string, data: T, options?: QueueOptions): Promise<string>;
+    /**
+     * Register a handler for a job type
+     * Supports wildcards: "email.*" matches "email.welcome", "email.reset", etc.
+     */
+    on(pattern: string, handler: JobHandler<unknown>): void;
+    /**
+     * Remove a handler
+     */
+    off(pattern: string): void;
+    /**
+     * Find the best matching handler for a job
+     */
+    private findHandler;
+    /**
+     * Check if a pattern matches a job name (supports wildcards)
+     */
+    private _patternMatches;
+    /**
+     * Listen for queue events
+     */
+    onEvent(event: JobEventType, listener: (event: JobEvent) => void): void;
+    /**
+     * Stop listening for queue events
+     */
+    offEvent(event: JobEventType, listener: (event: JobEvent) => void): void;
+    /**
+     * Emit a queue event
+     */
+    private _emitEvent;
+    /**
+     * Start the polling loop (for tests/manual control)
+     * Note: In production, use a separate worker process
+     */
+    start(options?: {
+        pollInterval?: number;
+        concurrency?: number;
+    }): Promise<void>;
+    /**
+     * Stop the polling loop
+     */
+    stop(): Promise<void>;
+    /**
+     * Get a job by ID
+     */
+    getJob(jobId: string): Promise<Job | null>;
+    /**
+     * Get queue metrics
+     */
+    getMetrics(): Promise<QueueMetrics>;
+    /**
+     * Clear all jobs (use with caution!)
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if queue is connected
+     */
+    isConnected(): Promise<boolean>;
+}
+/**
+ * Create a new job queue instance
+ */
+export declare function createJobQueue(config?: JobQueueConfig): JobQueue;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEX,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,cAAc,EAEd,YAAY,EACZ,YAAY,EACZ,MAAM,SAAS,CAAC;AAIjB,qBAAa,QAAQ;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,cAAc,CACX;IACX,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,cAAmB;IAcvC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC;IAMlB;;;OAGG;IACH,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI;IAkBvD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ1B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAOvE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAIxE;;OAEG;IACH,OAAO,CAAC,UAAU;IAmBlB;;;OAGG;IACG,KAAK,CACV,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3D,OAAO,CAAC,IAAI,CAAC;IAqDhB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAIhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAIzC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGrC;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CAEhE"}