@bitclaw/jobs 1.3.0 → 1.5.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, BackoffConfig, 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, JobGraphNode, JobMap, JobStats, JobStatus, ListJobsOptions, MiddlewareFn, 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,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"}
+{"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,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,SAAS,EACT,eAAe,EACf,YAAY,EACZ,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,8 +1,10 @@
 import { Database } from 'bun:sqlite';
-import type { AddJobOptions, BatchOptions, FailedJob, Job, JobBatch, JobMap, JobStats, ListJobsOptions, PaginatedResult, PurgeOptions, WorkerOptions } from './types';
+import { JobQueueEmitter } from './events';
+import type { AddJobOptions, BatchOptions, FailedJob, Job, JobBatch, JobGraphNode, JobMap, JobStats, ListJobsOptions, MiddlewareFn, 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;
+    readonly middlewares: MiddlewareFn[];
     private readonly insertJobStmt;
     private readonly selectDedupedJobStmt;
     private readonly insertDepStmt;
@@ -20,6 +22,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 +47,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;
@@ -69,6 +74,13 @@ export declare class JobQueue<TMap extends JobMap = Record<string, unknown>> {
      * 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;
+    use(fn: MiddlewareFn): void;
+    getJobGraph(rootId: number): JobGraphNode[];
+    mountAdminHandler(prefix?: string): (req: Request) => Promise<Response>;
     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":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,KAAK,EACV,aAAa,EAEb,YAAY,EACZ,SAAS,EAET,GAAG,EACH,QAAQ,EAER,YAAY,EACZ,MAAM,EAEN,QAAQ,EAER,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EAEZ,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA2DrC,qBAAa,QAAQ,CACnB,IAAI,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC7C,SAAQ,eAAe;IACvB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,CAAM;IAE1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAErC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAGhC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAEzB,MAAM,EAAE,MAAM;IAiH1B,GAAG,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,EAC/B,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM;IAIT,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAK9B,QAAQ,IAAI,QAAQ;IAwBpB,aAAa,CAAC,OAAO,CAAC,EAAE;QACtB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,eAAe,CAAC,SAAS,CAAC;IAkC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC,GAAG,CAAC;IAkCzD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS9B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASlC,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQxE,WAAW,IAAI,MAAM,EAAE;IAOvB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAiC3C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ5C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAQpC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAU,GAAG,GAAG,GAAG,IAAI;IAqBzD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAS7C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAgD/C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAiC5C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA2E9C,OAAO,CAAC,GAAG;IAUX,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYlD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAWzD,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,EACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM;IAYT,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAO1C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMlC,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,EACxC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAC5C,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IAIrB,OAAO,CAAC,SAAS;IA8EjB;;;;;OAKG;IACH,kBAAkB,CAAC,WAAW,SAAU,GAAG,MAAM;IAgBjD;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAY9D,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAMrC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAS3D,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAgC3C,gBAAgB,IAAI,MAAM;IAS1B,GAAG,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI;IAI3B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAiD3C,iBAAiB,CAAC,MAAM,SAAK,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC;IAyFnE,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,sBAAsB;CAgE/B"}

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,8 +61,9 @@ function toFailedJob(row) {
         responseLog: row.response_log
     };
 }
-export class JobQueue {
+export class JobQueue extends JobQueueEmitter {
     db;
+    middlewares = [];
     insertJobStmt;
     selectDedupedJobStmt;
     insertDepStmt;
@@ -75,6 +81,7 @@ export class JobQueue {
     countUnmetDepsStmt;
     unblockJobStmt;
     lastInsertRowIdStmt;
+    renewLeaseStmt;
     // Batch statements
     insertBatchStmt;
     selectBatchStmt;
@@ -84,13 +91,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, backoff_config)
-      VALUES ($type, $data, $status, $priority, $maxRetries, $runAt, $batchId, $uniqueKey, $backoffConfig)
+      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 +112,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(`
@@ -148,6 +161,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)
@@ -289,7 +306,9 @@ export class JobQueue {
             $runAt: now,
             $batchId: null,
             $uniqueKey: null,
-            $backoffConfig: null
+            $backoffConfig: null,
+            $expireAt: null,
+            $webhookConfig: null
         });
         const newJobId = this.lastInsertRowIdStmt.get();
         this.db
@@ -311,8 +330,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,
@@ -320,28 +340,72 @@ 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;
+        // Use container object so TypeScript tracks mutation across the closure
+        const wh = { config: null };
         this.db.transaction(() => {
             const now = nowISO();
             const row = this.selectJobStmt.get({ $id: id });
-            this.markDoneStmt.run({ $id: id, $now: now });
+            if (row?.webhook_config) {
+                try {
+                    wh.config = JSON.parse(row.webhook_config);
+                }
+                catch {
+                    // ignore malformed config
+                }
+            }
+            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);
             }
+            const updatedRow = this.selectJobStmt.get({ $id: id });
+            if (updatedRow)
+                doneJob = toJob(updatedRow);
         })();
+        if (doneJob)
+            this.emit('job:done', doneJob);
+        if (wh.config && doneJob) {
+            const cfg = wh.config;
+            const payload = doneJob;
+            void fetch(cfg.url, {
+                method: cfg.method ?? 'POST',
+                headers: { 'Content-Type': 'application/json', ...(cfg.headers ?? {}) },
+                body: JSON.stringify({ job: payload, result })
+            }).catch(() => { });
+        }
     }
     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,
@@ -362,8 +426,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 });
@@ -397,9 +464,20 @@ export class JobQueue {
                     : null;
                 let retryRunAt = now;
                 if (backoff) {
-                    const delayMs = backoff.type === 'exponential'
-                        ? Math.min(backoff.delayMs * 2 ** row.retry_count, 3_600_000)
-                        : backoff.delayMs;
+                    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({
@@ -408,8 +486,23 @@ export class JobQueue {
                     $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({
@@ -417,6 +510,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) {
@@ -455,6 +551,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),
@@ -464,7 +582,9 @@ export class JobQueue {
             $runAt: runAt,
             $batchId: batchId,
             $uniqueKey: options?.uniqueKey ?? null,
-            $backoffConfig: options?.backoff ? JSON.stringify(options.backoff) : 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.
@@ -505,7 +625,10 @@ export class JobQueue {
              updated_at = $now
          WHERE status = 'processing' AND updated_at < $cutoff`)
             .run({ $now: nowISO(), $cutoff: cutoff });
-        return result.changes;
+        const count = result.changes;
+        if (count > 0)
+            this.emit('job:stale', count);
+        return count;
     }
     /**
      * Look up a pending or processing job by its uniqueKey.
@@ -520,6 +643,163 @@ export class JobQueue {
             .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;
+    }
+    use(fn) {
+        this.middlewares.push(fn);
+    }
+    getJobGraph(rootId) {
+        const relatedRows = this.db
+            .query(`WITH RECURSIVE
+          ancestors(id) AS (
+            SELECT depends_on_id FROM job_dependencies WHERE job_id = $root
+            UNION
+            SELECT jd.depends_on_id FROM job_dependencies jd JOIN ancestors a ON jd.job_id = a.id
+          ),
+          descendants(id) AS (
+            SELECT job_id FROM job_dependencies WHERE depends_on_id = $root
+            UNION
+            SELECT jd.job_id FROM job_dependencies jd JOIN descendants d ON jd.depends_on_id = d.id
+          )
+        SELECT * FROM jobs
+        WHERE id IN (SELECT id FROM ancestors UNION SELECT $root UNION SELECT id FROM descendants)`)
+            .all({ $root: rootId });
+        if (relatedRows.length === 0)
+            return [];
+        const ids = relatedRows.map(r => r.id);
+        const namedParams = {};
+        for (let i = 0; i < ids.length; i++)
+            namedParams[`$id${i}`] = ids[i];
+        const ph = ids.map((_, i) => `$id${i}`).join(',');
+        const edges = this.db
+            .query(`SELECT job_id, depends_on_id FROM job_dependencies
+         WHERE job_id IN (${ph}) OR depends_on_id IN (${ph})`)
+            .all(namedParams);
+        return relatedRows.map(row => ({
+            id: row.id,
+            type: row.type,
+            status: row.status,
+            result: row.result ? JSON.parse(row.result) : null,
+            dependsOn: edges
+                .filter(e => e.job_id === row.id)
+                .map(e => e.depends_on_id),
+            dependents: edges
+                .filter(e => e.depends_on_id === row.id)
+                .map(e => e.job_id)
+        }));
+    }
+    mountAdminHandler(prefix = '') {
+        const base = prefix.replace(/\/$/, '');
+        return async (req) => {
+            const url = new URL(req.url);
+            const path = url.pathname.slice(base.length).replace(/^\//, '');
+            const parts = path.split('/').filter(Boolean);
+            const method = req.method.toUpperCase();
+            try {
+                if (method === 'GET' && parts[0] === 'stats' && parts.length === 1) {
+                    return Response.json(this.getStats());
+                }
+                if (method === 'GET' && parts[0] === 'jobs' && parts[1] === 'types') {
+                    return Response.json(this.getJobTypes());
+                }
+                if (method === 'GET' && parts[0] === 'jobs' && parts.length === 1) {
+                    const status = url.searchParams.get('status');
+                    const type = url.searchParams.get('type') ?? undefined;
+                    const limit = Number(url.searchParams.get('limit') ?? 50);
+                    const offset = Number(url.searchParams.get('offset') ?? 0);
+                    return Response.json(this.listJobs({ status: status ?? undefined, type, limit, offset }));
+                }
+                if (method === 'GET' && parts[0] === 'jobs' && parts.length === 2) {
+                    const id = Number(parts[1]);
+                    const job = this.getJob(id);
+                    if (!job)
+                        return Response.json({ error: 'Not found' }, { status: 404 });
+                    return Response.json(job);
+                }
+                if (method === 'GET' && parts[0] === 'jobs' && parts[2] === 'graph') {
+                    return Response.json(this.getJobGraph(Number(parts[1])));
+                }
+                if (method === 'POST' && parts[0] === 'jobs' && parts[2] === 'cancel') {
+                    return Response.json({ ok: this.cancelJob(Number(parts[1])) });
+                }
+                if (method === 'POST' &&
+                    parts[0] === 'jobs' &&
+                    parts[2] === 'force-retry') {
+                    return Response.json({ ok: this.forceRetryJob(Number(parts[1])) });
+                }
+                if (method === 'GET' && parts[0] === 'failed' && parts.length === 1) {
+                    const type = url.searchParams.get('type') ?? undefined;
+                    const limit = Number(url.searchParams.get('limit') ?? 50);
+                    const offset = Number(url.searchParams.get('offset') ?? 0);
+                    return Response.json(this.getFailedJobs({ type, limit, offset }));
+                }
+                if (method === 'POST' &&
+                    parts[0] === 'failed' &&
+                    parts[1] === 'retry-by-type') {
+                    const body = (await req.json());
+                    if (!body.type)
+                        return Response.json({ error: 'type required' }, { status: 400 });
+                    return Response.json({
+                        count: this.retryFailedJobsByType(body.type)
+                    });
+                }
+                if (method === 'POST' &&
+                    parts[0] === 'failed' &&
+                    parts[2] === 'retry') {
+                    return Response.json({ id: this.retryFailedJob(Number(parts[1])) });
+                }
+                return Response.json({ error: 'Not found' }, { status: 404 });
+            }
+            catch (err) {
+                return Response.json({ error: err instanceof Error ? err.message : 'Internal error' }, { status: 500 });
+            }
+        };
+    }
     close() {
         try {
             if (this.db.filename !== ':memory:' && this.db.filename !== '') {
@@ -558,35 +838,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,
-                $backoffConfig: 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,
-                $backoffConfig: 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;AAoG3C,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAY/C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAsBnD"}
+{"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

@@ -18,7 +18,11 @@ CREATE TABLE IF NOT EXISTS jobs (
   response_log TEXT,
   batch_id TEXT REFERENCES job_batches(id),
   unique_key TEXT,
-  backoff_config 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.
@@ -116,5 +120,17 @@ export function initializeSchema(db) {
     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;
@@ -42,7 +46,7 @@ export type FailedJob = {
     readonly responseLog: string | null;
 };
 export type BackoffConfig = {
-    type: 'exponential' | 'fixed';
+    type: 'exponential' | 'fixed' | 'jitter' | 'fibonacci';
     /** Base delay in ms. Exponential: delayMs * 2^retryCount. Fixed: always delayMs. Max 1h. */
     delayMs: number;
 };
@@ -62,18 +66,35 @@ export type AddJobOptions = {
      * 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;
     windowMs: number;
 };
+export type MiddlewareFn<T = unknown> = (job: Job<T>, next: () => Promise<unknown>) => Promise<unknown>;
+export type JobGraphNode = {
+    readonly id: number;
+    readonly type: string;
+    readonly status: JobStatus;
+    readonly result: unknown | null;
+    readonly dependsOn: number[];
+    readonly dependents: number[];
+};
 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;
@@ -81,6 +102,12 @@ export type WorkerOptions<T = unknown> = {
     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;
@@ -126,6 +153,10 @@ export type JobRow = {
     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,14 +7,18 @@ export declare class JobWorker<TMap extends JobMap = Record<string, unknown>, K
     private abortController;
     private timer;
     private running;
+    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;

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,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,KAAK,IAAI,IAAI;IAOP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B,OAAO,CAAC,YAAY;YAMN,IAAI;YAoBJ,MAAM;CAiDrB"}
+{"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,EAGV,MAAM,EAEN,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,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;YAoDJ,MAAM;CAwErB"}

package/dist/worker.js

@@ -1,5 +1,6 @@
 import { SlidingWindowRateLimiter } from './rate-limiter';
 import { NonRetryableError } from './types';
+import { nowISO } from './utils';
 export class JobWorker {
     queue;
     options;
@@ -7,6 +8,7 @@ export class JobWorker {
     abortController = null;
     timer = null;
     running = false;
+    paused = false;
     activeCount = 0;
     stopResolve = null;
     constructor(queue, options) {
@@ -19,6 +21,9 @@ export class JobWorker {
     get isRunning() {
         return this.running;
     }
+    get isPaused() {
+        return this.paused;
+    }
     start() {
         if (this.running)
             return;
@@ -41,6 +46,20 @@ export class JobWorker {
             });
         }
     }
+    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,18 +69,46 @@ export class JobWorker {
     async poll() {
         if (!this.running)
             return;
+        if (this.paused) {
+            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);
+            const job = this.queue.pollAndClaim(this.options.type, leaseMs);
             if (!job)
                 break;
             this.rateLimiter?.record();
             this.activeCount++;
             void this.runJob(job);
         }
+        // Apply priority aging if configured
+        if (this.options.aging) {
+            const { boostPerMinute, maxBoost } = this.options.aging;
+            const pollIntervalMs = this.options.pollIntervalMs ?? 1000;
+            const boostPerTick = (boostPerMinute * pollIntervalMs) / 60_000;
+            if (boostPerTick > 0) {
+                const cutoff = new Date(Date.now() - pollIntervalMs).toISOString();
+                this.queue.db.run(`UPDATE jobs
+           SET priority = MIN(priority + ?, ?),
+               updated_at = ?
+           WHERE status = 'pending'
+             AND type = ?
+             AND created_at < ?
+             AND priority < ?`, [
+                    boostPerTick,
+                    maxBoost,
+                    nowISO(),
+                    this.options.type,
+                    cutoff,
+                    maxBoost
+                ]);
+            }
+        }
         this.scheduleNext();
     }
     async runJob(job) {
@@ -70,20 +117,36 @@ export class JobWorker {
                 reportProgress: (percent) => {
                     this.queue.updateProgress(job.id, percent);
                 },
+                renewLease: () => {
+                    this.queue.renewLease(job.id, this.options.leaseMs ?? 300_000);
+                },
                 signal: this.abortController.signal
             };
-            const handlerPromise = this.options.handler(job, ctx);
+            const handler = this.options.handler;
+            const middlewares = this.queue.middlewares;
+            const chain = [...middlewares, (j) => handler(j, ctx)];
+            const execute = () => {
+                let i = 0;
+                const run = () => {
+                    const mw = chain[i++];
+                    if (!mw)
+                        return Promise.resolve(undefined);
+                    return mw(job, run);
+                };
+                return run();
+            };
+            let handlerResult;
             if (this.options.timeoutMs) {
                 const timeoutMs = this.options.timeoutMs;
-                await Promise.race([
-                    handlerPromise,
+                handlerResult = await Promise.race([
+                    execute(),
                     new Promise((_, reject) => setTimeout(() => reject(new Error(`Job timed out after ${timeoutMs}ms`)), timeoutMs))
                 ]);
             }
             else {
-                await handlerPromise;
+                handlerResult = await execute();
             }
-            this.queue.markJobDone(job.id);
+            this.queue.markJobDone(job.id, handlerResult);
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -93,7 +156,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 {

package/package.json

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