@bitclaw/jobs 1.1.0

package/dist/scheduler.js

@@ -0,0 +1,176 @@
+// packages/jobs/src/scheduler.ts
+// Cron scheduler — hybrid register/upsert pattern for recurring jobs
+import { nextCronOccurrence, parseCron } from './cron';
+import { nowISO } from './utils';
+function toSchedule(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        type: row.type,
+        data: JSON.parse(row.data),
+        cron: row.cron,
+        timezone: row.timezone,
+        enabled: row.enabled === 1,
+        overlap: row.overlap === 1,
+        maxRetries: row.max_retries,
+        lastRunAt: row.last_run_at,
+        nextRunAt: row.next_run_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at
+    };
+}
+export class Scheduler {
+    queue;
+    timer = null;
+    upsertStmt;
+    selectByNameStmt;
+    selectAllStmt;
+    selectDueStmt;
+    updateLastRunStmt;
+    pauseStmt;
+    resumeStmt;
+    removeStmt;
+    constructor(queue) {
+        this.queue = queue;
+        const db = queue.db;
+        this.upsertStmt = db.query(`
+      INSERT INTO schedules (name, type, data, cron, timezone, overlap, max_retries, next_run_at, created_at, updated_at)
+      VALUES ($name, $type, $data, $cron, $timezone, $overlap, $maxRetries, $nextRunAt, $now, $now)
+      ON CONFLICT(name) DO UPDATE SET
+        type = $type,
+        data = $data,
+        cron = $cron,
+        timezone = $timezone,
+        overlap = $overlap,
+        max_retries = $maxRetries,
+        next_run_at = CASE WHEN schedules.cron != $cron THEN $nextRunAt ELSE schedules.next_run_at END,
+        updated_at = $now
+    `);
+        this.selectByNameStmt = db.query('SELECT * FROM schedules WHERE name = $name');
+        this.selectAllStmt = db.query('SELECT * FROM schedules ORDER BY name');
+        this.selectDueStmt = db.query(`
+      SELECT * FROM schedules
+      WHERE enabled = 1 AND next_run_at IS NOT NULL AND next_run_at <= $now
+    `);
+        this.updateLastRunStmt = db.query(`
+      UPDATE schedules
+      SET last_run_at = $now, next_run_at = $nextRunAt, updated_at = $now
+      WHERE id = $id
+    `);
+        this.pauseStmt = db.query(`
+      UPDATE schedules SET enabled = 0, updated_at = $now WHERE name = $name
+    `);
+        this.resumeStmt = db.query(`
+      UPDATE schedules SET enabled = 1, updated_at = $now WHERE name = $name
+    `);
+        this.removeStmt = db.query('DELETE FROM schedules WHERE name = $name');
+    }
+    register(name, type, cron, options) {
+        const parsed = parseCron(cron);
+        const nextRunAt = nextCronOccurrence(parsed, new Date()).toISOString();
+        const now = nowISO();
+        this.upsertStmt.run({
+            $name: name,
+            $type: type,
+            $data: JSON.stringify(options?.data ?? {}),
+            $cron: cron,
+            $timezone: options?.timezone ?? 'UTC',
+            $overlap: options?.overlap ? 1 : 0,
+            $maxRetries: options?.maxRetries ?? 3,
+            $nextRunAt: nextRunAt,
+            $now: now
+        });
+        return this.getSchedule(name);
+    }
+    cleanup(registeredNames) {
+        if (registeredNames.length === 0) {
+            const result = this.queue.db.query('DELETE FROM schedules').run();
+            return result.changes;
+        }
+        // Build parameterized query for the IN clause
+        const placeholders = registeredNames.map((_, i) => `$p${i}`).join(', ');
+        const params = {};
+        for (let i = 0; i < registeredNames.length; i++) {
+            params[`$p${i}`] = registeredNames[i];
+        }
+        const result = this.queue.db
+            .query(`DELETE FROM schedules WHERE name NOT IN (${placeholders})`)
+            .run(params);
+        return result.changes;
+    }
+    pauseSchedule(name) {
+        this.pauseStmt.run({ $name: name, $now: nowISO() });
+    }
+    resumeSchedule(name) {
+        this.resumeStmt.run({ $name: name, $now: nowISO() });
+    }
+    getSchedules() {
+        const rows = this.selectAllStmt.all();
+        return rows.map(toSchedule);
+    }
+    getSchedule(name) {
+        const row = this.selectByNameStmt.get({
+            $name: name
+        });
+        return row ? toSchedule(row) : null;
+    }
+    removeSchedule(name) {
+        const result = this.removeStmt.run({ $name: name });
+        return result.changes > 0;
+    }
+    tick() {
+        const now = nowISO();
+        const dueSchedules = this.selectDueStmt.all({ $now: now });
+        let enqueued = 0;
+        for (const row of dueSchedules) {
+            // Overlap check: if overlap=false, skip if there's a pending/processing job of this type
+            if (row.overlap === 0) {
+                const active = this.queue.db
+                    .query("SELECT 1 FROM jobs WHERE type = $type AND status IN ('pending', 'processing') LIMIT 1")
+                    .get({ $type: row.type });
+                if (active) {
+                    // Skip this tick, recalculate next_run_at
+                    const parsed = parseCron(row.cron);
+                    const nextRunAt = nextCronOccurrence(parsed, new Date()).toISOString();
+                    this.updateLastRunStmt.run({
+                        $id: row.id,
+                        $now: now,
+                        $nextRunAt: nextRunAt
+                    });
+                    continue;
+                }
+            }
+            // Enqueue the job
+            this.queue.db
+                .query(`INSERT INTO jobs (type, data, status, priority, max_retries, run_at, batch_id)
+           VALUES ($type, $data, 'pending', 0, $maxRetries, $now, NULL)`)
+                .run({
+                $type: row.type,
+                $data: row.data,
+                $maxRetries: row.max_retries,
+                $now: now
+            });
+            // Update schedule timestamps
+            const parsed = parseCron(row.cron);
+            const nextRunAt = nextCronOccurrence(parsed, new Date()).toISOString();
+            this.updateLastRunStmt.run({
+                $id: row.id,
+                $now: now,
+                $nextRunAt: nextRunAt
+            });
+            enqueued++;
+        }
+        return enqueued;
+    }
+    start(intervalMs = 60_000) {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.tick(), intervalMs);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}

package/dist/schema.d.ts

@@ -0,0 +1,4 @@
+import type { Database } from 'bun:sqlite';
+export declare function applyPragmas(db: Database): void;
+export declare function initializeSchema(db: Database): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -0,0 +1,103 @@
+const JOBS_TABLE = `
+CREATE TABLE IF NOT EXISTS jobs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  type TEXT NOT NULL,
+  data TEXT NOT NULL DEFAULT '{}',
+  status TEXT NOT NULL DEFAULT 'pending',
+  priority INTEGER NOT NULL DEFAULT 0,
+  progress INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 3,
+  retry_count INTEGER NOT NULL DEFAULT 0,
+  run_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  started_at TEXT,
+  completed_at TEXT,
+  error TEXT,
+  request_log TEXT,
+  response_log TEXT,
+  batch_id TEXT REFERENCES job_batches(id)
+)`;
+const JOBS_POLL_INDEX = `
+CREATE INDEX IF NOT EXISTS idx_jobs_poll
+  ON jobs (status, type, run_at, priority DESC, created_at ASC)`;
+const JOBS_STATUS_INDEX = `
+CREATE INDEX IF NOT EXISTS idx_jobs_status ON jobs (status)`;
+const JOB_DEPENDENCIES_TABLE = `
+CREATE TABLE IF NOT EXISTS job_dependencies (
+  job_id INTEGER NOT NULL REFERENCES jobs(id) ON DELETE CASCADE,
+  depends_on_id INTEGER NOT NULL REFERENCES jobs(id) ON DELETE CASCADE,
+  PRIMARY KEY (job_id, depends_on_id)
+)`;
+const JOB_DEPS_INDEX = `
+CREATE INDEX IF NOT EXISTS idx_job_deps_depends_on
+  ON job_dependencies (depends_on_id)`;
+const FAILED_JOBS_TABLE = `
+CREATE TABLE IF NOT EXISTS failed_jobs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  original_job_id INTEGER NOT NULL,
+  type TEXT NOT NULL,
+  data TEXT NOT NULL,
+  error TEXT,
+  retry_count INTEGER NOT NULL,
+  max_retries INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  failed_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  request_log TEXT,
+  response_log TEXT
+)`;
+const JOB_BATCHES_TABLE = `
+CREATE TABLE IF NOT EXISTS job_batches (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  total_jobs INTEGER NOT NULL DEFAULT 0,
+  pending_jobs INTEGER NOT NULL DEFAULT 0,
+  failed_jobs INTEGER NOT NULL DEFAULT 0,
+  failed_job_ids TEXT NOT NULL DEFAULT '[]',
+  options TEXT,
+  cancelled_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  finished_at TEXT
+)`;
+const SCHEDULES_TABLE = `
+CREATE TABLE IF NOT EXISTS schedules (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  type TEXT NOT NULL,
+  data TEXT NOT NULL DEFAULT '{}',
+  cron TEXT NOT NULL,
+  timezone TEXT NOT NULL DEFAULT 'UTC',
+  enabled INTEGER NOT NULL DEFAULT 1,
+  overlap INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 3,
+  last_run_at TEXT,
+  next_run_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+)`;
+const SCHEDULES_NEXT_RUN_INDEX = `
+CREATE INDEX IF NOT EXISTS idx_schedules_next_run
+  ON schedules (enabled, next_run_at)`;
+export function applyPragmas(db) {
+    if (db.filename !== ':memory:' && db.filename !== '') {
+        db.run('PRAGMA journal_mode = WAL');
+        db.run('PRAGMA busy_timeout = 5000');
+    }
+    db.run('PRAGMA foreign_keys = ON');
+    db.run('PRAGMA synchronous = NORMAL');
+    db.run('PRAGMA cache_size = -4000');
+    db.run('PRAGMA temp_store = MEMORY');
+    db.run('PRAGMA mmap_size = 16777216'); // 16MB — jobs rows are small, no blobs
+    db.run('PRAGMA wal_autocheckpoint = 0'); // Litestream controls checkpointing
+}
+export function initializeSchema(db) {
+    db.run(JOB_BATCHES_TABLE);
+    db.run(JOBS_TABLE);
+    db.run(JOBS_POLL_INDEX);
+    db.run(JOBS_STATUS_INDEX);
+    db.run(JOB_DEPENDENCIES_TABLE);
+    db.run(JOB_DEPS_INDEX);
+    db.run(FAILED_JOBS_TABLE);
+    db.run(SCHEDULES_TABLE);
+    db.run(SCHEDULES_NEXT_RUN_INDEX);
+}

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Throw this from a job handler to skip all retries and move immediately to
+ * the dead-letter (failed_jobs) table. Use for permanent configuration errors
+ * like missing SSH keys, bad tokens, or invalid input that will never succeed
+ * no matter how many times the job runs.
+ */
+export declare class NonRetryableError extends Error {
+    readonly isNonRetryable = true;
+    constructor(message: string);
+}
+export type JobStatus = 'pending' | 'processing' | 'done' | 'failed' | 'blocked' | 'cancelled';
+export type Job<T = unknown> = {
+    readonly id: number;
+    readonly type: string;
+    readonly data: T;
+    readonly status: JobStatus;
+    readonly priority: number;
+    readonly progress: number;
+    readonly maxRetries: number;
+    readonly retryCount: number;
+    readonly runAt: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly startedAt: string | null;
+    readonly completedAt: string | null;
+    readonly error: string | null;
+    readonly batchId: string | null;
+    readonly requestLog: string | null;
+    readonly responseLog: string | null;
+};
+export type FailedJob = {
+    readonly id: number;
+    readonly originalJobId: number;
+    readonly type: string;
+    readonly data: unknown;
+    readonly error: string | null;
+    readonly retryCount: number;
+    readonly maxRetries: number;
+    readonly createdAt: string;
+    readonly failedAt: string;
+    readonly requestLog: string | null;
+    readonly responseLog: string | null;
+};
+export type AddJobOptions = {
+    priority?: number;
+    runAt?: Date;
+    maxRetries?: number;
+    dependsOn?: number[];
+};
+export type JobContext = {
+    reportProgress: (percent: number) => void;
+    signal: AbortSignal;
+};
+export type RateLimit = {
+    count: number;
+    windowMs: number;
+};
+export type WorkerOptions<T = unknown> = {
+    type: string;
+    handler: (job: Job<T>, ctx: JobContext) => Promise<void>;
+    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;
+};
+export type JobStats = {
+    pending: number;
+    blocked: number;
+    processing: number;
+    done: number;
+    failed: number;
+    cancelled: number;
+    dead: number;
+};
+export type PurgeOptions = {
+    status: 'done' | 'failed';
+    olderThanMs: number;
+};
+export type ListJobsOptions = {
+    status?: JobStatus;
+    type?: string;
+    limit?: number;
+    offset?: number;
+};
+export type PaginatedResult<T> = {
+    items: T[];
+    total: number;
+};
+export type JobMap = Record<string, unknown>;
+export type JobRow = {
+    id: number;
+    type: string;
+    data: string;
+    status: string;
+    priority: number;
+    progress: number;
+    max_retries: number;
+    retry_count: number;
+    run_at: string;
+    created_at: string;
+    updated_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    error: string | null;
+    batch_id: string | null;
+    request_log: string | null;
+    response_log: string | null;
+};
+export type FailedJobRow = {
+    id: number;
+    original_job_id: number;
+    type: string;
+    data: string;
+    error: string | null;
+    retry_count: number;
+    max_retries: number;
+    created_at: string;
+    failed_at: string;
+    request_log: string | null;
+    response_log: string | null;
+};
+export type StatsRow = {
+    status: string;
+    count: number;
+};
+export type BatchOptions = {
+    thenType?: string;
+    thenData?: unknown;
+    finallyType?: string;
+    finallyData?: unknown;
+};
+export type JobBatch = {
+    readonly id: string;
+    readonly name: string;
+    readonly totalJobs: number;
+    readonly pendingJobs: number;
+    readonly failedJobs: number;
+    readonly failedJobIds: number[];
+    readonly options: BatchOptions | null;
+    readonly cancelledAt: string | null;
+    readonly createdAt: string;
+    readonly finishedAt: string | null;
+};
+export type JobBatchRow = {
+    id: string;
+    name: string;
+    total_jobs: number;
+    pending_jobs: number;
+    failed_jobs: number;
+    failed_job_ids: string;
+    options: string | null;
+    cancelled_at: string | null;
+    created_at: string;
+    finished_at: string | null;
+};
+export type Schedule = {
+    readonly id: number;
+    readonly name: string;
+    readonly type: string;
+    readonly data: unknown;
+    readonly cron: string;
+    readonly timezone: string;
+    readonly enabled: boolean;
+    readonly overlap: boolean;
+    readonly maxRetries: number;
+    readonly lastRunAt: string | null;
+    readonly nextRunAt: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+};
+export type ScheduleRow = {
+    id: number;
+    name: string;
+    type: string;
+    data: string;
+    cron: string;
+    timezone: string;
+    enabled: number;
+    overlap: number;
+    max_retries: number;
+    last_run_at: string | null;
+    next_run_at: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type AddScheduleOptions = {
+    data?: unknown;
+    timezone?: string;
+    overlap?: boolean;
+    maxRetries?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,15 @@
+// packages/jobs/src/types.ts
+// All type definitions for the SQLite background job queue
+/**
+ * Throw this from a job handler to skip all retries and move immediately to
+ * the dead-letter (failed_jobs) table. Use for permanent configuration errors
+ * like missing SSH keys, bad tokens, or invalid input that will never succeed
+ * no matter how many times the job runs.
+ */
+export class NonRetryableError extends Error {
+    isNonRetryable = true;
+    constructor(message) {
+        super(message);
+        this.name = 'NonRetryableError';
+    }
+}

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+export declare function nowISO(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/utils.js

@@ -0,0 +1,5 @@
+// packages/jobs/src/utils.ts
+// Shared utilities for the jobs package
+export function nowISO() {
+    return `${new Date().toISOString().replace('Z', '').slice(0, 23)}Z`;
+}

package/dist/worker.d.ts

@@ -0,0 +1,21 @@
+import type { JobQueue } from './queue';
+import type { JobMap, WorkerOptions } from './types';
+export declare class JobWorker<TMap extends JobMap = Record<string, unknown>, K extends string & keyof TMap = string & keyof TMap> {
+    private queue;
+    private options;
+    private rateLimiter;
+    private abortController;
+    private timer;
+    private running;
+    private processing;
+    private stopResolve;
+    constructor(queue: JobQueue<TMap>, options: WorkerOptions<TMap[K]> & {
+        type: K;
+    });
+    get isRunning(): boolean;
+    start(): void;
+    stop(): Promise<void>;
+    private scheduleNext;
+    private poll;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +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"}

package/dist/worker.js

@@ -0,0 +1,111 @@
+import { SlidingWindowRateLimiter } from './rate-limiter';
+import { NonRetryableError } from './types';
+export class JobWorker {
+    queue;
+    options;
+    rateLimiter;
+    abortController = null;
+    timer = null;
+    running = false;
+    processing = false;
+    stopResolve = null;
+    constructor(queue, options) {
+        this.queue = queue;
+        this.options = options;
+        this.rateLimiter = options.maxRate
+            ? new SlidingWindowRateLimiter(options.maxRate.count, options.maxRate.windowMs)
+            : null;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.abortController = new AbortController();
+        this.scheduleNext();
+    }
+    async stop() {
+        if (!this.running)
+            return;
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.abortController?.abort();
+        if (this.processing) {
+            return new Promise(resolve => {
+                this.stopResolve = resolve;
+            });
+        }
+    }
+    scheduleNext() {
+        if (!this.running)
+            return;
+        const interval = this.options.pollIntervalMs ?? 1000;
+        this.timer = setTimeout(() => this.poll(), interval);
+    }
+    async poll() {
+        if (!this.running)
+            return;
+        if (this.rateLimiter && !this.rateLimiter.canProceed()) {
+            this.scheduleNext();
+            return;
+        }
+        const job = this.queue.pollAndClaim(this.options.type);
+        if (!job) {
+            this.scheduleNext();
+            return;
+        }
+        this.processing = true;
+        try {
+            const ctx = {
+                reportProgress: (percent) => {
+                    this.queue.updateProgress(job.id, percent);
+                },
+                signal: this.abortController.signal
+            };
+            this.rateLimiter?.record();
+            const handlerPromise = this.options.handler(job, ctx);
+            if (this.options.timeoutMs) {
+                const timeoutMs = this.options.timeoutMs;
+                await Promise.race([
+                    handlerPromise,
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Job timed out after ${timeoutMs}ms`)), timeoutMs))
+                ]);
+            }
+            else {
+                await handlerPromise;
+            }
+            this.queue.markJobDone(job.id);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            // Check both instanceof (same bundle) and the isNonRetryable property
+            // (duck-type fallback in case module deduplication fails across Vite chunks)
+            const isNonRetryable = error instanceof NonRetryableError ||
+                (typeof error === 'object' &&
+                    error !== null &&
+                    error.isNonRetryable === true);
+            if (isNonRetryable) {
+                this.queue.markJobDead(job.id, message);
+            }
+            else {
+                this.queue.markJobFailed(job.id, message);
+            }
+            this.options.onError?.(job, error);
+        }
+        finally {
+            this.processing = false;
+            if (this.stopResolve) {
+                this.stopResolve();
+                this.stopResolve = null;
+            }
+            else {
+                this.scheduleNext();
+            }
+        }
+    }
+}