@bitclaw/jobs 1.2.0 → 1.4.0

package/dist/events.d.ts

@@ -0,0 +1,20 @@
+import type { Job, JobBatch } from './types';
+export type JobQueueEventMap = {
+    'job:done': (job: Job) => void;
+    'job:failed': (job: Job, error: string) => void;
+    'job:dead': (job: Job, error: string) => void;
+    'job:progress': (job: Job, progress: number) => void;
+    'job:stale': (count: number) => void;
+    'batch:complete': (batch: JobBatch) => void;
+    'batch:failed': (batch: JobBatch) => void;
+};
+type Handler<K extends keyof JobQueueEventMap> = JobQueueEventMap[K];
+export declare class JobQueueEmitter {
+    private readonly listeners;
+    on<K extends keyof JobQueueEventMap>(event: K, handler: Handler<K>): () => void;
+    off<K extends keyof JobQueueEventMap>(event: K, handler: Handler<K>): void;
+    once<K extends keyof JobQueueEventMap>(event: K, handler: Handler<K>): void;
+    emit<K extends keyof JobQueueEventMap>(event: K, ...args: Parameters<JobQueueEventMap[K]>): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,gBAAgB,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAErE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,MAAM,IAAI;IAQb,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1E,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ3E,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACnC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GACvC,IAAI;CAWR"}

package/dist/events.js

@@ -0,0 +1,33 @@
+export class JobQueueEmitter {
+    listeners = new Map();
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        this.listeners.get(event)?.delete(handler);
+    }
+    once(event, handler) {
+        const wrapper = ((...args) => {
+            this.off(event, wrapper);
+            handler(...args);
+        });
+        this.on(event, wrapper);
+    }
+    emit(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        for (const handler of handlers) {
+            try {
+                handler(...args);
+            }
+            catch {
+                // silently swallow listener errors
+            }
+        }
+    }
+}

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export type { ParsedCron } from './cron';
 export { cronMatches, nextCronOccurrence, parseCron } from './cron';
+export type { JobQueueEventMap } from './events';
+export { JobQueueEmitter } from './events';
 export { JobQueue } from './queue';
 export { SlidingWindowRateLimiter } from './rate-limiter';
 export { Scheduler } from './scheduler';
 export { applyPragmas, initializeSchema } from './schema';
-export type { AddJobOptions, AddScheduleOptions, BatchOptions, FailedJob, Job, JobBatch, JobContext, JobMap, JobStats, JobStatus, ListJobsOptions, PaginatedResult, PurgeOptions, RateLimit, Schedule, WorkerOptions } from './types';
+export type { AddJobOptions, AddScheduleOptions, BackoffConfig, BatchOptions, FailedJob, Job, JobBatch, JobContext, JobMap, JobStats, JobStatus, ListJobsOptions, PaginatedResult, PurgeOptions, RateLimit, Schedule, WorkerOptions } from './types';
 export { NonRetryableError } from './types';
 export { JobWorker } from './worker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,GAAG,EACH,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,GAAG,EACH,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 // packages/jobs/src/index.ts
 // Barrel export for @bitclaw/jobs
 export { cronMatches, nextCronOccurrence, parseCron } from './cron';
+export { JobQueueEmitter } from './events';
 export { JobQueue } from './queue';
 export { SlidingWindowRateLimiter } from './rate-limiter';
 export { Scheduler } from './scheduler';

package/dist/queue.d.ts

@@ -1,7 +1,8 @@
 import { Database } from 'bun:sqlite';
+import { JobQueueEmitter } from './events';
 import type { AddJobOptions, BatchOptions, FailedJob, Job, JobBatch, JobMap, JobStats, ListJobsOptions, PaginatedResult, PurgeOptions, WorkerOptions } from './types';
 import { JobWorker } from './worker';
-export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> {
+export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> extends JobQueueEmitter {
     readonly db: Database;
     private readonly insertJobStmt;
     private readonly selectDedupedJobStmt;
@@ -20,6 +21,7 @@ export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> {
     private readonly countUnmetDepsStmt;
     private readonly unblockJobStmt;
     private readonly lastInsertRowIdStmt;
+    private readonly renewLeaseStmt;
     private readonly insertBatchStmt;
     private readonly selectBatchStmt;
     private readonly decrementBatchPendingStmt;
@@ -44,10 +46,12 @@ export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> {
     retryFailedJob(failedJobId: number): number;
     purgeFailedJobs(olderThanMs: number): number;
     purge(options: PurgeOptions): number;
-    pollAndClaim(type: string): Job | null;
-    markJobDone(id: number): void;
+    pollAndClaim(type: string, leaseMs?: number): Job | null;
+    renewLease(id: number, leaseMs: number): void;
+    markJobDone(id: number, result?: unknown): void;
     markJobDead(id: number, error: string): void;
     markJobFailed(id: number, error: string): void;
+    private fib;
     updateProgress(id: number, progress: number): void;
     createBatch(name: string, options?: BatchOptions): string;
     addToBatch<K extends string & keyof TMap>(batchId: string, type: K, data: TMap[K], options?: AddJobOptions): number;
@@ -57,6 +61,22 @@ export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> {
         type: K;
     }): JobWorker<TMap, K>;
     private insertJob;
+    /**
+     * Reset stuck `processing` jobs back to `pending`. Call at startup to recover
+     * from server crashes that left jobs claimed but never completed.
+     * @param thresholdMs Jobs processing longer than this (ms) are reset. Default 5min.
+     * @returns Number of jobs reset.
+     */
+    reconcileStaleJobs(thresholdMs?: number): number;
+    /**
+     * Look up a pending or processing job by its uniqueKey.
+     * Returns null if no such job exists (completed, dead-lettered, or never queued).
+     */
+    getJobByUniqueKey(type: string, uniqueKey: string): Job | null;
+    getJobResult<T>(id: number): T | null;
+    cancelByUniqueKey(type: string, uniqueKey: string): boolean;
+    retryFailedJobsByType(type: string): number;
+    purgeExpiredJobs(): number;
     close(): void;
     private unblockDependents;
     private handleBatchJobComplete;

package/dist/queue.d.ts.map

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

package/dist/queue.js

@@ -3,6 +3,7 @@
 import { Database } from 'bun:sqlite';
 import { mkdirSync } from 'node:fs';
 import { dirname } from 'node:path';
+import { JobQueueEmitter } from './events';
 import { applyPragmas, initializeSchema } from './schema';
 import { nowISO } from './utils';
 import { JobWorker } from './worker';
@@ -24,7 +25,11 @@ function toJob(row) {
         error: row.error,
         batchId: row.batch_id,
         requestLog: row.request_log,
-        responseLog: row.response_log
+        responseLog: row.response_log,
+        uniqueKey: row.unique_key,
+        claimedUntil: row.claimed_until,
+        result: row.result ? JSON.parse(row.result) : null,
+        expireAt: row.expire_at
     };
 }
 function toBatch(row) {
@@ -56,7 +61,7 @@ function toFailedJob(row) {
         responseLog: row.response_log
     };
 }
-export class JobQueue {
+export class JobQueue extends JobQueueEmitter {
     db;
     insertJobStmt;
     selectDedupedJobStmt;
@@ -75,6 +80,7 @@ export class JobQueue {
     countUnmetDepsStmt;
     unblockJobStmt;
     lastInsertRowIdStmt;
+    renewLeaseStmt;
     // Batch statements
     insertBatchStmt;
     selectBatchStmt;
@@ -84,13 +90,14 @@ export class JobQueue {
     cancelBatchStmt;
     cancelBatchJobsStmt;
     constructor(dbPath) {
+        super();
         mkdirSync(dirname(dbPath), { recursive: true });
         this.db = new Database(dbPath, { create: true });
         applyPragmas(this.db);
         initializeSchema(this.db);
         this.insertJobStmt = this.db.query(`
-      INSERT OR IGNORE INTO jobs (type, data, status, priority, max_retries, run_at, batch_id, unique_key)
-      VALUES ($type, $data, $status, $priority, $maxRetries, $runAt, $batchId, $uniqueKey)
+      INSERT OR IGNORE INTO jobs (type, data, status, priority, max_retries, run_at, batch_id, unique_key, backoff_config, expire_at, webhook_config)
+      VALUES ($type, $data, $status, $priority, $maxRetries, $runAt, $batchId, $uniqueKey, $backoffConfig, $expireAt, $webhookConfig)
     `);
         this.selectDedupedJobStmt = this.db.query(`
       SELECT id FROM jobs
@@ -104,16 +111,21 @@ export class JobQueue {
         this.selectJobStmt = this.db.query('SELECT * FROM jobs WHERE id = $id');
         this.selectPendingStmt = this.db.query(`
       SELECT * FROM jobs
-      WHERE status = 'pending' AND type = $type AND run_at <= $now
+      WHERE type = $type AND run_at <= $now
+        AND (expire_at IS NULL OR expire_at > $now)
+        AND (
+          (status = 'pending')
+          OR (status = 'processing' AND claimed_until IS NOT NULL AND claimed_until < $now)
+        )
       ORDER BY priority DESC, created_at ASC
       LIMIT 1
     `);
         this.markProcessingStmt = this.db.query(`
-      UPDATE jobs SET status = 'processing', started_at = $now, updated_at = $now
+      UPDATE jobs SET status = 'processing', started_at = $now, updated_at = $now, claimed_until = $claimedUntil
       WHERE id = $id
     `);
         this.markDoneStmt = this.db.query(`
-      UPDATE jobs SET status = 'done', completed_at = $now, updated_at = $now, progress = 100
+      UPDATE jobs SET status = 'done', completed_at = $now, updated_at = $now, progress = 100, result = $result
       WHERE id = $id
     `);
         this.markFailedStmt = this.db.query(`
@@ -121,6 +133,7 @@ export class JobQueue {
       SET status = 'pending',
           retry_count = retry_count + 1,
           error = $error,
+          run_at = $runAt,
           updated_at = $now
       WHERE id = $id
     `);
@@ -147,6 +160,10 @@ export class JobQueue {
       WHERE id = $id AND status = 'blocked'
     `);
         this.lastInsertRowIdStmt = this.db.query('SELECT last_insert_rowid() as id');
+        this.renewLeaseStmt = this.db.query(`
+      UPDATE jobs SET claimed_until = $claimedUntil, updated_at = $now
+      WHERE id = $id AND status = 'processing'
+    `);
         // Batch statements
         this.insertBatchStmt = this.db.query(`
       INSERT INTO job_batches (id, name, options, created_at)
@@ -287,7 +304,10 @@ export class JobQueue {
             $maxRetries: row.max_retries,
             $runAt: now,
             $batchId: null,
-            $uniqueKey: null
+            $uniqueKey: null,
+            $backoffConfig: null,
+            $expireAt: null,
+            $webhookConfig: null
         });
         const newJobId = this.lastInsertRowIdStmt.get();
         this.db
@@ -309,8 +329,9 @@ export class JobQueue {
             .run({ $status: options.status, $cutoff: cutoff });
         return result.changes;
     }
-    pollAndClaim(type) {
+    pollAndClaim(type, leaseMs = 300_000) {
         const now = nowISO();
+        const claimedUntil = new Date(Date.now() + leaseMs).toISOString();
         const claimTx = this.db.transaction(() => {
             const row = this.selectPendingStmt.get({
                 $type: type,
@@ -318,28 +339,54 @@ export class JobQueue {
             });
             if (!row)
                 return null;
-            this.markProcessingStmt.run({ $id: row.id, $now: now });
+            this.markProcessingStmt.run({
+                $id: row.id,
+                $now: now,
+                $claimedUntil: claimedUntil
+            });
             return row;
         });
         const row = claimTx.immediate();
         return row ? toJob(row) : null;
     }
-    markJobDone(id) {
+    renewLease(id, leaseMs) {
+        const claimedUntil = new Date(Date.now() + leaseMs).toISOString();
+        this.renewLeaseStmt.run({
+            $id: id,
+            $claimedUntil: claimedUntil,
+            $now: nowISO()
+        });
+    }
+    markJobDone(id, result) {
+        let doneJob = null;
         this.db.transaction(() => {
             const now = nowISO();
             const row = this.selectJobStmt.get({ $id: id });
-            this.markDoneStmt.run({ $id: id, $now: now });
+            this.markDoneStmt.run({
+                $id: id,
+                $now: now,
+                $result: result !== undefined ? JSON.stringify(result) : null
+            });
             this.unblockDependents(id);
             if (row?.batch_id) {
                 this.handleBatchJobComplete(row.batch_id);
             }
+            // capture for post-tx emit
+            const updatedRow = this.selectJobStmt.get({ $id: id });
+            if (updatedRow)
+                doneJob = toJob(updatedRow);
         })();
+        if (doneJob)
+            this.emit('job:done', doneJob);
     }
     markJobDead(id, error) {
+        let deadJob = null;
         this.db.transaction(() => {
             const row = this.selectJobStmt.get({ $id: id });
             if (!row)
                 return;
+            // capture before delete
+            deadJob = toJob(row);
             this.insertFailedJobStmt.run({
                 $originalJobId: row.id,
                 $type: row.type,
@@ -360,8 +407,11 @@ export class JobQueue {
                 this.handleBatchJobComplete(row.batch_id);
             }
         })();
+        if (deadJob)
+            this.emit('job:dead', deadJob, error);
     }
     markJobFailed(id, error) {
+        let failedJob = null;
         this.db.transaction(() => {
             const now = nowISO();
             const row = this.selectJobStmt.get({ $id: id });
@@ -390,9 +440,50 @@ export class JobQueue {
                 }
             }
             else {
-                this.markFailedStmt.run({ $id: id, $error: error, $now: now });
+                const backoff = row.backoff_config
+                    ? JSON.parse(row.backoff_config)
+                    : null;
+                let retryRunAt = now;
+                if (backoff) {
+                    let delayMs;
+                    switch (backoff.type) {
+                        case 'exponential':
+                            delayMs = Math.min(backoff.delayMs * 2 ** row.retry_count, 3_600_000);
+                            break;
+                        case 'jitter':
+                            delayMs = Math.min(backoff.delayMs * 2 ** row.retry_count * (0.5 + Math.random()), 3_600_000);
+                            break;
+                        case 'fibonacci':
+                            delayMs = Math.min(backoff.delayMs * this.fib(row.retry_count), 3_600_000);
+                            break;
+                        default: // 'fixed'
+                            delayMs = backoff.delayMs;
+                    }
+                    retryRunAt = new Date(Date.now() + delayMs).toISOString();
+                }
+                this.markFailedStmt.run({
+                    $id: id,
+                    $error: error,
+                    $runAt: retryRunAt,
+                    $now: now
+                });
+                // capture updated job for post-tx emit
+                const updatedRow = this.selectJobStmt.get({ $id: id });
+                if (updatedRow)
+                    failedJob = toJob(updatedRow);
             }
         })();
+        if (failedJob)
+            this.emit('job:failed', failedJob, error);
+    }
+    fib(n) {
+        if (n <= 1)
+            return 1;
+        let a = 1, b = 1;
+        for (let i = 2; i <= n; i++) {
+            [a, b] = [b, a + b];
+        }
+        return b;
     }
     updateProgress(id, progress) {
         this.updateProgressStmt.run({
@@ -400,6 +491,9 @@ export class JobQueue {
             $progress: progress,
             $now: nowISO()
         });
+        const row = this.selectJobStmt.get({ $id: id });
+        if (row)
+            this.emit('job:progress', toJob(row), progress);
     }
     // --- Batch API ---
     createBatch(name, options) {
@@ -438,6 +532,28 @@ export class JobQueue {
         const runAt = options?.runAt ? options.runAt.toISOString() : now;
         const hasDeps = options?.dependsOn && options.dependsOn.length > 0;
         const status = hasDeps ? 'blocked' : 'pending';
+        const expireAt = options?.expireAt ? options.expireAt.toISOString() : null;
+        const webhookConfig = options?.onComplete
+            ? JSON.stringify(options.onComplete)
+            : null;
+        // dedup='replace': update existing pending job's data + run_at
+        if (options?.dedup === 'replace' && options.uniqueKey) {
+            const existing = this.selectDedupedJobStmt.get({
+                $type: type,
+                $uniqueKey: options.uniqueKey
+            });
+            if (existing) {
+                this.db
+                    .query('UPDATE jobs SET data = $data, run_at = $runAt, updated_at = $now WHERE id = $id')
+                    .run({
+                    $id: existing.id,
+                    $data: JSON.stringify(data),
+                    $runAt: runAt,
+                    $now: now
+                });
+                return existing.id;
+            }
+        }
         const result = this.insertJobStmt.run({
             $type: type,
             $data: JSON.stringify(data),
@@ -446,7 +562,10 @@ export class JobQueue {
             $maxRetries: options?.maxRetries ?? 3,
             $runAt: runAt,
             $batchId: batchId,
-            $uniqueKey: options?.uniqueKey ?? null
+            $uniqueKey: options?.uniqueKey ?? null,
+            $backoffConfig: options?.backoff ? JSON.stringify(options.backoff) : null,
+            $expireAt: expireAt,
+            $webhookConfig: webhookConfig
         });
         // INSERT OR IGNORE: if a pending/processing job with same (type, uniqueKey)
         // already exists, the insert is a no-op. Return the existing job id.
@@ -472,6 +591,86 @@ export class JobQueue {
         }
         return jobId.id;
     }
+    /**
+     * Reset stuck `processing` jobs back to `pending`. Call at startup to recover
+     * from server crashes that left jobs claimed but never completed.
+     * @param thresholdMs Jobs processing longer than this (ms) are reset. Default 5min.
+     * @returns Number of jobs reset.
+     */
+    reconcileStaleJobs(thresholdMs = 300_000) {
+        const cutoff = new Date(Date.now() - thresholdMs).toISOString();
+        const result = this.db
+            .query(`UPDATE jobs
+         SET status = 'pending',
+             error = 'stale: worker crash or restart — reset for retry',
+             updated_at = $now
+         WHERE status = 'processing' AND updated_at < $cutoff`)
+            .run({ $now: nowISO(), $cutoff: cutoff });
+        const count = result.changes;
+        if (count > 0)
+            this.emit('job:stale', count);
+        return count;
+    }
+    /**
+     * Look up a pending or processing job by its uniqueKey.
+     * Returns null if no such job exists (completed, dead-lettered, or never queued).
+     */
+    getJobByUniqueKey(type, uniqueKey) {
+        const row = this.db
+            .query(`SELECT * FROM jobs
+         WHERE type = $type AND unique_key = $uniqueKey
+           AND status IN ('pending', 'processing')
+         LIMIT 1`)
+            .get({ $type: type, $uniqueKey: uniqueKey });
+        return row ? toJob(row) : null;
+    }
+    getJobResult(id) {
+        const row = this.selectJobStmt.get({ $id: id });
+        if (!row?.result)
+            return null;
+        return JSON.parse(row.result);
+    }
+    cancelByUniqueKey(type, uniqueKey) {
+        const result = this.db
+            .query("UPDATE jobs SET status = 'cancelled', updated_at = $now WHERE type = $type AND unique_key = $uniqueKey AND status IN ('pending', 'blocked')")
+            .run({ $type: type, $uniqueKey: uniqueKey, $now: nowISO() });
+        return result.changes > 0;
+    }
+    retryFailedJobsByType(type) {
+        const rows = this.db
+            .query('SELECT * FROM failed_jobs WHERE type = $type')
+            .all({ $type: type });
+        if (rows.length === 0)
+            return 0;
+        const now = nowISO();
+        this.db.transaction(() => {
+            for (const row of rows) {
+                this.insertJobStmt.run({
+                    $type: row.type,
+                    $data: row.data,
+                    $status: 'pending',
+                    $priority: 0,
+                    $maxRetries: row.max_retries,
+                    $runAt: now,
+                    $batchId: null,
+                    $uniqueKey: null,
+                    $backoffConfig: null,
+                    $expireAt: null,
+                    $webhookConfig: null
+                });
+                this.db
+                    .query('DELETE FROM failed_jobs WHERE id = $id')
+                    .run({ $id: row.id });
+            }
+        })();
+        return rows.length;
+    }
+    purgeExpiredJobs() {
+        const result = this.db
+            .query("DELETE FROM jobs WHERE expire_at IS NOT NULL AND expire_at <= $now AND status = 'pending'")
+            .run({ $now: nowISO() });
+        return result.changes;
+    }
     close() {
         try {
             if (this.db.filename !== ':memory:' && this.db.filename !== '') {
@@ -510,33 +709,51 @@ export class JobQueue {
         const options = batch.options
             ? JSON.parse(batch.options)
             : null;
-        if (!options)
-            return;
-        // Enqueue "then" callback job only if zero failures
-        if (batch.failed_jobs === 0 && options.thenType) {
-            this.insertJobStmt.run({
-                $type: options.thenType,
-                $data: JSON.stringify(options.thenData ?? {}),
-                $status: 'pending',
-                $priority: 0,
-                $maxRetries: 3,
-                $runAt: now,
-                $batchId: null,
-                $uniqueKey: null
-            });
+        if (options) {
+            // Enqueue "then" callback job only if zero failures
+            if (batch.failed_jobs === 0 && options.thenType) {
+                this.insertJobStmt.run({
+                    $type: options.thenType,
+                    $data: JSON.stringify(options.thenData ?? {}),
+                    $status: 'pending',
+                    $priority: 0,
+                    $maxRetries: 3,
+                    $runAt: now,
+                    $batchId: null,
+                    $uniqueKey: null,
+                    $backoffConfig: null,
+                    $expireAt: null,
+                    $webhookConfig: null
+                });
+            }
+            // Enqueue "finally" callback job regardless of failures
+            if (options.finallyType) {
+                this.insertJobStmt.run({
+                    $type: options.finallyType,
+                    $data: JSON.stringify(options.finallyData ?? {}),
+                    $status: 'pending',
+                    $priority: 0,
+                    $maxRetries: 3,
+                    $runAt: now,
+                    $batchId: null,
+                    $uniqueKey: null,
+                    $backoffConfig: null,
+                    $expireAt: null,
+                    $webhookConfig: null
+                });
+            }
         }
-        // Enqueue "finally" callback job regardless of failures
-        if (options.finallyType) {
-            this.insertJobStmt.run({
-                $type: options.finallyType,
-                $data: JSON.stringify(options.finallyData ?? {}),
-                $status: 'pending',
-                $priority: 0,
-                $maxRetries: 3,
-                $runAt: now,
-                $batchId: null,
-                $uniqueKey: null
-            });
+        const finishedBatch = this.selectBatchStmt.get({
+            $id: batchId
+        });
+        if (finishedBatch) {
+            const b = toBatch(finishedBatch);
+            if (b.failedJobs === 0) {
+                this.emit('batch:complete', b);
+            }
+            else {
+                this.emit('batch:failed', b);
+            }
         }
     }
 }

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmG3C,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAY/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAmBnD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAwG3C,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAY/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAkCnD"}

package/dist/schema.js

@@ -17,7 +17,12 @@ CREATE TABLE IF NOT EXISTS jobs (
   request_log TEXT,
   response_log TEXT,
   batch_id TEXT REFERENCES job_batches(id),
-  unique_key TEXT
+  unique_key TEXT,
+  backoff_config TEXT,
+  claimed_until TEXT,
+  result TEXT,
+  expire_at TEXT,
+  webhook_config TEXT
 )`;
 // State-aware dedup: same (type, unique_key) cannot be both pending/processing at once.
 // Once the job completes, the same key can be re-enqueued.
@@ -107,12 +112,25 @@ export function initializeSchema(db) {
     db.run(FAILED_JOBS_TABLE);
     db.run(SCHEDULES_TABLE);
     db.run(SCHEDULES_NEXT_RUN_INDEX);
-    // Migration: add unique_key to existing DBs that were created before v1.2.0
-    const cols = db
-        .prepare("PRAGMA table_info(jobs)")
-        .all();
+    // Migrations for columns added after initial schema creation
+    const cols = db.prepare('PRAGMA table_info(jobs)').all();
     if (!cols.some(c => c.name === 'unique_key')) {
         db.run('ALTER TABLE jobs ADD COLUMN unique_key TEXT');
     }
+    if (!cols.some(c => c.name === 'backoff_config')) {
+        db.run('ALTER TABLE jobs ADD COLUMN backoff_config TEXT');
+    }
+    if (!cols.some(c => c.name === 'claimed_until')) {
+        db.run('ALTER TABLE jobs ADD COLUMN claimed_until TEXT');
+    }
+    if (!cols.some(c => c.name === 'result')) {
+        db.run('ALTER TABLE jobs ADD COLUMN result TEXT');
+    }
+    if (!cols.some(c => c.name === 'expire_at')) {
+        db.run('ALTER TABLE jobs ADD COLUMN expire_at TEXT');
+    }
+    if (!cols.some(c => c.name === 'webhook_config')) {
+        db.run('ALTER TABLE jobs ADD COLUMN webhook_config TEXT');
+    }
     db.run(JOBS_UNIQUE_KEY_INDEX);
 }

package/dist/types.d.ts

@@ -27,6 +27,10 @@ export type Job<T = unknown> = {
     readonly batchId: string | null;
     readonly requestLog: string | null;
     readonly responseLog: string | null;
+    readonly uniqueKey: string | null;
+    readonly claimedUntil: string | null;
+    readonly result: unknown | null;
+    readonly expireAt: string | null;
 };
 export type FailedJob = {
     readonly id: number;
@@ -41,6 +45,11 @@ export type FailedJob = {
     readonly requestLog: string | null;
     readonly responseLog: string | null;
 };
+export type BackoffConfig = {
+    type: 'exponential' | 'fixed' | 'jitter' | 'fibonacci';
+    /** Base delay in ms. Exponential: delayMs * 2^retryCount. Fixed: always delayMs. Max 1h. */
+    delayMs: number;
+};
 export type AddJobOptions = {
     priority?: number;
     runAt?: Date;
@@ -52,10 +61,23 @@ export type AddJobOptions = {
      * existing job id is returned. Once the job completes, the same key can be re-used.
      */
     uniqueKey?: string;
+    /**
+     * Backoff strategy for retries. Exponential: delayMs * 2^retryCount, capped at 1h.
+     * Fixed: always delayMs between retries. Default: retry immediately.
+     */
+    backoff?: BackoffConfig;
+    dedup?: 'ignore' | 'replace';
+    expireAt?: Date;
+    onComplete?: {
+        url: string;
+        method?: string;
+        headers?: Record<string, string>;
+    };
 };
 export type JobContext = {
     reportProgress: (percent: number) => void;
     signal: AbortSignal;
+    renewLease(): void;
 };
 export type RateLimit = {
     count: number;
@@ -63,12 +85,20 @@ export type RateLimit = {
 };
 export type WorkerOptions<T = unknown> = {
     type: string;
-    handler: (job: Job<T>, ctx: JobContext) => Promise<void>;
+    handler: (job: Job<T>, ctx: JobContext) => Promise<unknown>;
     pollIntervalMs?: number;
     maxRate?: RateLimit;
     onError?: (job: Job<T>, error: unknown) => void;
     /** Hard wall-clock limit per job execution in ms. Job is marked failed on timeout. */
     timeoutMs?: number;
+    /** Max concurrent jobs this worker runs simultaneously. Default: 1. */
+    concurrency?: number;
+    leaseMs?: number;
+    retryIf?: (error: unknown, job: Job<T>) => boolean;
+    aging?: {
+        boostPerMinute: number;
+        maxBoost: number;
+    };
 };
 export type JobStats = {
     pending: number;
@@ -113,6 +143,11 @@ export type JobRow = {
     request_log: string | null;
     response_log: string | null;
     unique_key: string | null;
+    backoff_config: string | null;
+    claimed_until: string | null;
+    result: string | null;
+    expire_at: string | null;
+    webhook_config: string | null;
 };
 export type FailedJobRow = {
     id: number;

package/dist/types.d.ts.map

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

package/dist/worker.d.ts

@@ -7,15 +7,20 @@ export declare class JobWorker<TMap extends JobMap = Record<string, unknown>, K
     private abortController;
     private timer;
     private running;
-    private processing;
+    private paused;
+    private activeCount;
     private stopResolve;
     constructor(queue: JobQueue<TMap>, options: WorkerOptions<TMap[K]> & {
         type: K;
     });
     get isRunning(): boolean;
+    get isPaused(): boolean;
     start(): void;
     stop(): Promise<void>;
+    pause(): void;
+    resume(): void;
     private scheduleNext;
     private poll;
+    private runJob;
 }
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAmB,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGtE,qBAAa,SAAS,CACpB,IAAI,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,IAAI;IAEnD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA6B;gBAG9C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EACrB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE;IAY/C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,OAAO,CAAC,YAAY;YAMN,IAAI;CAqEnB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAmB,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGtE,qBAAa,SAAS,CACpB,IAAI,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7C,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,IAAI;IAEnD,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAA6B;gBAG9C,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EACrB,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE;IAY/C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAYd,OAAO,CAAC,YAAY;YAMN,IAAI;YAyBJ,MAAM;CA0DrB"}

package/dist/worker.js

@@ -7,7 +7,8 @@ export class JobWorker {
     abortController = null;
     timer = null;
     running = false;
-    processing = false;
+    paused = false;
+    activeCount = 0;
     stopResolve = null;
     constructor(queue, options) {
         this.queue = queue;
@@ -19,6 +20,9 @@ export class JobWorker {
     get isRunning() {
         return this.running;
     }
+    get isPaused() {
+        return this.paused;
+    }
     start() {
         if (this.running)
             return;
@@ -35,12 +39,26 @@ export class JobWorker {
             this.timer = null;
         }
         this.abortController?.abort();
-        if (this.processing) {
+        if (this.activeCount > 0) {
             return new Promise(resolve => {
                 this.stopResolve = resolve;
             });
         }
     }
+    pause() {
+        this.paused = true;
+    }
+    resume() {
+        this.paused = false;
+        if (this.running) {
+            // Cancel existing timer and poll immediately
+            if (this.timer) {
+                clearTimeout(this.timer);
+                this.timer = null;
+            }
+            void this.poll();
+        }
+    }
     scheduleNext() {
         if (!this.running)
             return;
@@ -50,36 +68,49 @@ export class JobWorker {
     async poll() {
         if (!this.running)
             return;
-        if (this.rateLimiter && !this.rateLimiter.canProceed()) {
+        if (this.paused) {
             this.scheduleNext();
             return;
         }
-        const job = this.queue.pollAndClaim(this.options.type);
-        if (!job) {
-            this.scheduleNext();
-            return;
+        const concurrency = this.options.concurrency ?? 1;
+        const leaseMs = this.options.leaseMs ?? 300_000;
+        // Drain available jobs up to available capacity in one poll tick
+        while (this.activeCount < concurrency) {
+            if (this.rateLimiter && !this.rateLimiter.canProceed())
+                break;
+            const job = this.queue.pollAndClaim(this.options.type, leaseMs);
+            if (!job)
+                break;
+            this.rateLimiter?.record();
+            this.activeCount++;
+            void this.runJob(job);
         }
-        this.processing = true;
+        this.scheduleNext();
+    }
+    async runJob(job) {
         try {
             const ctx = {
                 reportProgress: (percent) => {
                     this.queue.updateProgress(job.id, percent);
                 },
+                renewLease: () => {
+                    this.queue.renewLease(job.id, this.options.leaseMs ?? 300_000);
+                },
                 signal: this.abortController.signal
             };
-            this.rateLimiter?.record();
             const handlerPromise = this.options.handler(job, ctx);
+            let handlerResult;
             if (this.options.timeoutMs) {
                 const timeoutMs = this.options.timeoutMs;
-                await Promise.race([
+                handlerResult = await Promise.race([
                     handlerPromise,
                     new Promise((_, reject) => setTimeout(() => reject(new Error(`Job timed out after ${timeoutMs}ms`)), timeoutMs))
                 ]);
             }
             else {
-                await handlerPromise;
+                handlerResult = await handlerPromise;
             }
-            this.queue.markJobDone(job.id);
+            this.queue.markJobDone(job.id, handlerResult);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -89,7 +120,10 @@ export class JobWorker {
                 (typeof error === 'object' &&
                     error !== null &&
                     error.isNonRetryable === true);
-            if (isNonRetryable) {
+            const shouldRetry = this.options.retryIf
+                ? this.options.retryIf(error, job)
+                : true;
+            if (isNonRetryable || !shouldRetry) {
                 this.queue.markJobDead(job.id, message);
             }
             else {
@@ -98,14 +132,11 @@ export class JobWorker {
             this.options.onError?.(job, error);
         }
         finally {
-            this.processing = false;
-            if (this.stopResolve) {
+            this.activeCount--;
+            if (!this.running && this.activeCount === 0 && this.stopResolve) {
                 this.stopResolve();
                 this.stopResolve = null;
             }
-            else {
-                this.scheduleNext();
-            }
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitclaw/jobs",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "SQLite-backed background job queue using bun:sqlite",
   "files": [
     "dist",