@auxiora/job-queue 1.10.0

package/dist/__tests__/integration.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { JobQueue } from '../queue.js';
+import { JobDatabase } from '../db.js';
+function makeDbPath() {
+    const dir = path.join(os.tmpdir(), `auxiora-integ-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    fs.mkdirSync(dir, { recursive: true });
+    return path.join(dir, 'jobs.db');
+}
+function cleanup(dbPath) {
+    const dir = path.dirname(dbPath);
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+describe('integration', () => {
+    let dbPath;
+    let queue;
+    afterEach(async () => {
+        if (queue) {
+            try {
+                await queue.stop(2000);
+            }
+            catch {
+                // already stopped
+            }
+            queue = undefined;
+        }
+        if (dbPath)
+            cleanup(dbPath);
+    });
+    it('recovers a job left in running state by a previous process', async () => {
+        dbPath = makeDbPath();
+        // Simulate process 1: insert job, poll it to running, then crash (close DB)
+        const db1 = new JobDatabase(dbPath);
+        db1.insertJob({
+            type: 'email',
+            payload: { to: 'test@example.com' },
+            priority: 0,
+            maxAttempts: 3,
+            scheduledAt: Date.now(),
+        });
+        const polled = db1.pollReady(1);
+        expect(polled).toHaveLength(1);
+        expect(polled[0].status).toBe('running');
+        db1.close();
+        // Simulate process 2: new JobQueue picks up the crashed job
+        const received = [];
+        queue = new JobQueue(dbPath, { pollIntervalMs: 50 });
+        queue.register('email', async (payload) => {
+            received.push(payload);
+            return 'sent';
+        });
+        queue.start();
+        await vi.waitFor(() => {
+            expect(received).toHaveLength(1);
+        }, { timeout: 2000 });
+        expect(received[0]).toEqual({ to: 'test@example.com' });
+    });
+    it('resumes from checkpoint after simulated crash', async () => {
+        dbPath = makeDbPath();
+        // Process 1: insert job, poll to running, save checkpoint at step 2, crash
+        const db1 = new JobDatabase(dbPath);
+        const jobId = db1.insertJob({
+            type: 'batch',
+            payload: { steps: ['a', 'b', 'c', 'd'] },
+            priority: 0,
+            maxAttempts: 3,
+            scheduledAt: Date.now(),
+        });
+        db1.pollReady(1);
+        db1.saveCheckpoint(jobId, { completedSteps: ['a', 'b'] });
+        db1.close();
+        // Process 2: handler reads checkpoint and continues
+        const executedSteps = [];
+        queue = new JobQueue(dbPath, { pollIntervalMs: 50 });
+        queue.register('batch', async (payload, ctx) => {
+            const checkpoint = ctx.getCheckpoint();
+            const alreadyDone = new Set(checkpoint?.completedSteps ?? []);
+            for (const step of payload.steps) {
+                if (!alreadyDone.has(step)) {
+                    executedSteps.push(step);
+                }
+            }
+            return 'done';
+        });
+        queue.start();
+        await vi.waitFor(() => {
+            expect(executedSteps.length).toBeGreaterThan(0);
+        }, { timeout: 2000 });
+        // Only steps c and d should have been executed (a and b were checkpointed)
+        expect(executedSteps).toEqual(['c', 'd']);
+    });
+    it('runs multiple job types concurrently', async () => {
+        dbPath = makeDbPath();
+        queue = new JobQueue(dbPath, { pollIntervalMs: 50, concurrency: 5 });
+        const aCalls = [];
+        const bCalls = [];
+        queue.register('type-a', async (payload) => {
+            aCalls.push(payload);
+            return 'a-done';
+        });
+        queue.register('type-b', async (payload) => {
+            bCalls.push(payload);
+            return 'b-done';
+        });
+        queue.enqueue('type-a', { idx: 1 });
+        queue.enqueue('type-b', { idx: 2 });
+        queue.enqueue('type-a', { idx: 3 });
+        queue.start();
+        await vi.waitFor(() => {
+            expect(aCalls.length + bCalls.length).toBe(3);
+        }, { timeout: 2000 });
+        expect(aCalls).toHaveLength(2);
+        expect(bCalls).toHaveLength(1);
+        expect(aCalls.map((c) => c.idx).sort()).toEqual([1, 3]);
+        expect(bCalls[0]).toEqual({ idx: 2 });
+        // Verify all jobs completed
+        const stats = queue.getStats();
+        expect(stats.pending).toBe(0);
+        expect(stats.running).toBe(0);
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/__tests__/integration.test.js.map

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

package/dist/__tests__/queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.test.d.ts.map

package/dist/__tests__/queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/queue.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/queue.test.js

@@ -0,0 +1,275 @@
+import { describe, it, expect, afterEach, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { JobQueue } from '../queue.js';
+import { NonRetryableError } from '../errors.js';
+function makeDbPath() {
+    const dir = path.join(os.tmpdir(), `auxiora-queue-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    fs.mkdirSync(dir, { recursive: true });
+    return path.join(dir, 'jobs.db');
+}
+function cleanup(dbPath) {
+    const dir = path.dirname(dbPath);
+    fs.rmSync(dir, { recursive: true, force: true });
+}
+describe('JobQueue', () => {
+    let queue;
+    let dbPath;
+    afterEach(async () => {
+        try {
+            await queue.stop(2000);
+        }
+        catch {
+            // already stopped
+        }
+        cleanup(dbPath);
+    });
+    function createQueue(opts) {
+        dbPath = makeDbPath();
+        queue = new JobQueue(dbPath, { pollIntervalMs: 50, concurrency: 2, ...opts });
+        return queue;
+    }
+    describe('register and enqueue', () => {
+        it('handler runs for enqueued job', async () => {
+            const q = createQueue();
+            const results = [];
+            q.register('greet', async (payload) => {
+                results.push(payload.name);
+                return `hello ${payload.name}`;
+            });
+            const id = q.enqueue('greet', { name: 'world' });
+            expect(id).toBeDefined();
+            q.start();
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('completed');
+            }, { timeout: 3000 });
+            expect(results).toEqual(['world']);
+            const job = q.getJob(id);
+            expect(job?.result).toBe('hello world');
+        });
+        it('throws on unregistered type', () => {
+            const q = createQueue();
+            expect(() => q.enqueue('unknown', {})).toThrow();
+        });
+    });
+    describe('scheduling', () => {
+        it('job delayed until scheduledAt', async () => {
+            const q = createQueue();
+            q.register('delayed', async () => 'done');
+            const scheduledAt = Date.now() + 500;
+            const id = q.enqueue('delayed', {}, { scheduledAt });
+            q.start();
+            // Should still be pending immediately
+            const jobEarly = q.getJob(id);
+            expect(jobEarly?.status).toBe('pending');
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('completed');
+            }, { timeout: 3000 });
+        });
+    });
+    describe('priority', () => {
+        it('higher priority jobs processed first', async () => {
+            const q = createQueue({ concurrency: 1 });
+            const order = [];
+            q.register('ordered', async (payload) => {
+                order.push(payload.label);
+            });
+            q.enqueue('ordered', { label: 'low' }, { priority: 1 });
+            q.enqueue('ordered', { label: 'high' }, { priority: 10 });
+            q.enqueue('ordered', { label: 'mid' }, { priority: 5 });
+            q.start();
+            await vi.waitFor(() => {
+                expect(order).toHaveLength(3);
+            }, { timeout: 3000 });
+            expect(order).toEqual(['high', 'mid', 'low']);
+        });
+    });
+    describe('retry on failure', () => {
+        it('failing job retries up to maxAttempts, then succeeds', { timeout: 15000 }, async () => {
+            const q = createQueue();
+            let callCount = 0;
+            q.register('flaky', async () => {
+                callCount++;
+                if (callCount < 3) {
+                    throw new Error('transient');
+                }
+                return 'ok';
+            });
+            const id = q.enqueue('flaky', {}, { maxAttempts: 5 });
+            q.start();
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('completed');
+            }, { timeout: 10000 });
+            expect(callCount).toBe(3);
+        });
+    });
+    describe('NonRetryableError', () => {
+        it('skips retries, goes straight to dead', async () => {
+            const q = createQueue();
+            let callCount = 0;
+            q.register('fatal', async () => {
+                callCount++;
+                throw new NonRetryableError('permanent failure');
+            });
+            const id = q.enqueue('fatal', {}, { maxAttempts: 5 });
+            q.start();
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('dead');
+            }, { timeout: 3000 });
+            expect(callCount).toBe(1);
+        });
+    });
+    describe('concurrency', () => {
+        it('runs up to N jobs in parallel, not more', { timeout: 15000 }, async () => {
+            const q = createQueue({ concurrency: 2 });
+            let concurrent = 0;
+            let maxConcurrent = 0;
+            let completedCount = 0;
+            q.register('slow', async () => {
+                concurrent++;
+                maxConcurrent = Math.max(maxConcurrent, concurrent);
+                await new Promise(resolve => setTimeout(resolve, 100));
+                concurrent--;
+                completedCount++;
+                return 'done';
+            });
+            for (let i = 0; i < 6; i++) {
+                q.enqueue('slow', { i });
+            }
+            q.start();
+            await vi.waitFor(() => {
+                expect(completedCount).toBe(6);
+            }, { timeout: 10000 });
+            expect(maxConcurrent).toBeLessThanOrEqual(2);
+            expect(maxConcurrent).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('events', () => {
+        it('emits job:started and job:completed', async () => {
+            const q = createQueue();
+            const events = [];
+            q.register('evented', async () => 'result');
+            q.on('job:started', () => events.push('started'));
+            q.on('job:completed', () => events.push('completed'));
+            const id = q.enqueue('evented', {});
+            q.start();
+            await vi.waitFor(() => {
+                expect(events).toContain('completed');
+            }, { timeout: 3000 });
+            expect(events).toContain('started');
+            expect(events).toContain('completed');
+        });
+        it('emits job:dead on NonRetryableError', async () => {
+            const q = createQueue();
+            const deadJobs = [];
+            q.register('doomed', async () => {
+                throw new NonRetryableError('nope');
+            });
+            q.on('job:dead', (data) => deadJobs.push(data.job.id));
+            const id = q.enqueue('doomed', {});
+            q.start();
+            await vi.waitFor(() => {
+                expect(deadJobs).toContain(id);
+            }, { timeout: 3000 });
+        });
+    });
+    describe('checkpoint', () => {
+        it('handler writes checkpoint, on retry reads it back', async () => {
+            const q = createQueue();
+            let callCount = 0;
+            const checkpointValues = [];
+            q.register('checkpointed', async (_payload, ctx) => {
+                callCount++;
+                const prev = ctx.getCheckpoint();
+                checkpointValues.push(prev);
+                if (callCount === 1) {
+                    ctx.checkpoint({ step: 1 });
+                    throw new Error('retry me');
+                }
+                return 'done';
+            });
+            const id = q.enqueue('checkpointed', {}, { maxAttempts: 3 });
+            q.start();
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('completed');
+            }, { timeout: 10000 });
+            expect(callCount).toBe(2);
+            expect(checkpointValues[0]).toBeUndefined();
+            expect(checkpointValues[1]).toEqual({ step: 1 });
+        });
+    });
+    describe('graceful shutdown', () => {
+        it('stop() waits for running jobs to complete', async () => {
+            const q = createQueue({ concurrency: 1 });
+            let finished = false;
+            q.register('longish', async () => {
+                await new Promise(resolve => setTimeout(resolve, 300));
+                finished = true;
+                return 'done';
+            });
+            q.enqueue('longish', {});
+            q.start();
+            // Give tick time to pick up the job
+            await new Promise(resolve => setTimeout(resolve, 100));
+            await q.stop(5000);
+            expect(finished).toBe(true);
+        });
+    });
+    describe('crash recovery', () => {
+        it('first attempt throws, retry succeeds', async () => {
+            const q = createQueue();
+            let callCount = 0;
+            q.register('recoverable', async () => {
+                callCount++;
+                if (callCount === 1)
+                    throw new Error('crash');
+                return 'recovered';
+            });
+            const id = q.enqueue('recoverable', {}, { maxAttempts: 3 });
+            q.start();
+            await vi.waitFor(() => {
+                const job = q.getJob(id);
+                expect(job?.status).toBe('completed');
+            }, { timeout: 10000 });
+            expect(callCount).toBe(2);
+            expect(q.getJob(id)?.result).toBe('recovered');
+        });
+    });
+    describe('getStats', () => {
+        it('returns pending/running counts', () => {
+            const q = createQueue();
+            q.register('stat-test', async () => {
+                await new Promise(resolve => setTimeout(resolve, 5000));
+            });
+            q.enqueue('stat-test', {});
+            q.enqueue('stat-test', {});
+            const stats = q.getStats();
+            expect(stats.pending).toBe(2);
+            expect(stats.running).toBe(0);
+        });
+    });
+    describe('getJob', () => {
+        it('returns job by id', () => {
+            const q = createQueue();
+            q.register('lookup', async () => 'ok');
+            const id = q.enqueue('lookup', { data: 123 });
+            const job = q.getJob(id);
+            expect(job).toBeDefined();
+            expect(job?.id).toBe(id);
+            expect(job?.type).toBe('lookup');
+            expect(job?.payload).toEqual({ data: 123 });
+            expect(job?.status).toBe('pending');
+        });
+        it('returns undefined for non-existent id', () => {
+            const q = createQueue();
+            expect(q.getJob('nonexistent')).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=queue.test.js.map

package/dist/__tests__/queue.test.js.map

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

package/dist/db.d.ts

@@ -0,0 +1,30 @@
+import type { Job, JobFilter, JobQueueStats } from './types.js';
+export interface InsertJobInput {
+    type: string;
+    payload: unknown;
+    priority: number;
+    maxAttempts: number;
+    scheduledAt: number;
+}
+export declare class JobDatabase {
+    private db;
+    constructor(dbPath: string);
+    private migrate;
+    insertJob(input: InsertJobInput): string;
+    getJob(id: string): Job | undefined;
+    pollReady(limit: number): Job[];
+    completeJob(id: string, result: unknown): void;
+    failJob(id: string, errorMsg: string): void;
+    killJob(id: string): void;
+    recoverCrashed(): number;
+    saveCheckpoint(jobId: string, data: unknown): void;
+    getCheckpoint<T = unknown>(jobId: string): T | undefined;
+    listJobs(filter?: JobFilter): Job[];
+    getStats(): JobQueueStats;
+    cleanupOld(maxAgeMs: number): number;
+    /** Test helper: force a timestamp column to a specific value. */
+    forceTimestamp(id: string, column: string, value: number): void;
+    close(): void;
+    private rowToJob;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAa,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAUD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAe;gBAEb,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,OAAO;IA6Bf,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAUxC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAKnC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE;IAoB/B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAO9C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqB3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOzB,cAAc,IAAI,MAAM;IA4BxB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IASlD,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAOxD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE;IAwBnC,QAAQ,IAAI,aAAa;IA0BzB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQpC,iEAAiE;IACjE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/D,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;CAiBjB"}

package/dist/db.js

@@ -0,0 +1,183 @@
+import { DatabaseSync } from 'node:sqlite';
+import * as crypto from 'node:crypto';
+const ALLOWED_TIMESTAMP_COLUMNS = new Set([
+    'scheduled_at',
+    'started_at',
+    'completed_at',
+    'created_at',
+    'updated_at',
+]);
+export class JobDatabase {
+    db;
+    constructor(dbPath) {
+        this.db = new DatabaseSync(dbPath);
+        this.db.exec('PRAGMA journal_mode=WAL');
+        this.db.exec('PRAGMA foreign_keys=ON');
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS jobs (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending',
+        payload TEXT NOT NULL,
+        result TEXT,
+        priority INTEGER NOT NULL DEFAULT 0,
+        attempt INTEGER NOT NULL DEFAULT 0,
+        max_attempts INTEGER NOT NULL DEFAULT 3,
+        scheduled_at INTEGER NOT NULL,
+        started_at INTEGER,
+        completed_at INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_jobs_poll ON jobs(status, scheduled_at, priority DESC);
+      CREATE INDEX IF NOT EXISTS idx_jobs_type ON jobs(type, status);
+
+      CREATE TABLE IF NOT EXISTS job_checkpoints (
+        job_id TEXT PRIMARY KEY REFERENCES jobs(id) ON DELETE CASCADE,
+        data TEXT NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+    `);
+    }
+    insertJob(input) {
+        const id = crypto.randomUUID();
+        const now = Date.now();
+        this.db.prepare(`INSERT INTO jobs (id, type, status, payload, priority, max_attempts, scheduled_at, created_at, updated_at)
+       VALUES (?, ?, 'pending', ?, ?, ?, ?, ?, ?)`).run(id, input.type, JSON.stringify(input.payload), input.priority, input.maxAttempts, input.scheduledAt, now, now);
+        return id;
+    }
+    getJob(id) {
+        const row = this.db.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+        return row ? this.rowToJob(row) : undefined;
+    }
+    pollReady(limit) {
+        const now = Date.now();
+        const rows = this.db.prepare(`SELECT * FROM jobs
+       WHERE status = 'pending' AND scheduled_at <= ?
+       ORDER BY priority DESC, scheduled_at ASC
+       LIMIT ?`).all(now, limit);
+        const jobs = [];
+        for (const row of rows) {
+            const id = row.id;
+            this.db.prepare(`UPDATE jobs SET status = 'running', started_at = ?, updated_at = ? WHERE id = ?`).run(now, now, id);
+            jobs.push(this.rowToJob({ ...row, status: 'running', started_at: now, updated_at: now }));
+        }
+        return jobs;
+    }
+    completeJob(id, result) {
+        const now = Date.now();
+        this.db.prepare(`UPDATE jobs SET status = 'completed', result = ?, completed_at = ?, updated_at = ? WHERE id = ?`).run(JSON.stringify(result), now, now, id);
+    }
+    failJob(id, errorMsg) {
+        const row = this.db.prepare('SELECT * FROM jobs WHERE id = ?').get(id);
+        if (!row)
+            return;
+        const now = Date.now();
+        const nextAttempt = row.attempt + 1;
+        const maxAttempts = row.max_attempts;
+        if (nextAttempt >= maxAttempts) {
+            this.db.prepare(`UPDATE jobs SET status = 'dead', result = ?, attempt = ?, completed_at = ?, updated_at = ? WHERE id = ?`).run(JSON.stringify(errorMsg), nextAttempt, now, now, id);
+        }
+        else {
+            const backoff = Math.pow(2, nextAttempt) * 1000;
+            const nextScheduledAt = now + backoff;
+            this.db.prepare(`UPDATE jobs SET status = 'pending', result = ?, attempt = ?, scheduled_at = ?, started_at = NULL, updated_at = ? WHERE id = ?`).run(JSON.stringify(errorMsg), nextAttempt, nextScheduledAt, now, id);
+        }
+    }
+    killJob(id) {
+        const now = Date.now();
+        this.db.prepare(`UPDATE jobs SET status = 'dead', completed_at = ?, updated_at = ? WHERE id = ?`).run(now, now, id);
+    }
+    recoverCrashed() {
+        const rows = this.db.prepare(`SELECT * FROM jobs WHERE status = 'running'`).all();
+        const now = Date.now();
+        let count = 0;
+        for (const row of rows) {
+            const id = row.id;
+            const nextAttempt = row.attempt + 1;
+            const maxAttempts = row.max_attempts;
+            if (nextAttempt >= maxAttempts) {
+                this.db.prepare(`UPDATE jobs SET status = 'dead', completed_at = ?, updated_at = ? WHERE id = ?`).run(now, now, id);
+            }
+            else {
+                this.db.prepare(`UPDATE jobs SET status = 'pending', attempt = ?, started_at = NULL, updated_at = ? WHERE id = ?`).run(nextAttempt, now, id);
+            }
+            count++;
+        }
+        return count;
+    }
+    saveCheckpoint(jobId, data) {
+        const now = Date.now();
+        this.db.prepare(`INSERT INTO job_checkpoints (job_id, data, updated_at)
+       VALUES (?, ?, ?)
+       ON CONFLICT(job_id) DO UPDATE SET data = excluded.data, updated_at = excluded.updated_at`).run(jobId, JSON.stringify(data), now);
+    }
+    getCheckpoint(jobId) {
+        const row = this.db.prepare('SELECT data FROM job_checkpoints WHERE job_id = ?').get(jobId);
+        return row ? JSON.parse(row.data) : undefined;
+    }
+    listJobs(filter) {
+        const conditions = [];
+        const params = [];
+        if (filter?.type) {
+            conditions.push('type = ?');
+            params.push(filter.type);
+        }
+        if (filter?.status) {
+            conditions.push('status = ?');
+            params.push(filter.status);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filter?.limit ?? 100;
+        params.push(limit);
+        const rows = this.db.prepare(`SELECT * FROM jobs ${where} ORDER BY created_at DESC LIMIT ?`).all(...params);
+        return rows.map(r => this.rowToJob(r));
+    }
+    getStats() {
+        const twentyFourHoursAgo = Date.now() - 24 * 60 * 60 * 1000;
+        const pending = this.db.prepare(`SELECT COUNT(*) as count FROM jobs WHERE status = 'pending'`).get().count;
+        const running = this.db.prepare(`SELECT COUNT(*) as count FROM jobs WHERE status = 'running'`).get().count;
+        const completed24h = this.db.prepare(`SELECT COUNT(*) as count FROM jobs WHERE status = 'completed' AND completed_at >= ?`).get(twentyFourHoursAgo).count;
+        const failed24h = this.db.prepare(`SELECT COUNT(*) as count FROM jobs WHERE status = 'failed' AND completed_at >= ?`).get(twentyFourHoursAgo).count;
+        const dead = this.db.prepare(`SELECT COUNT(*) as count FROM jobs WHERE status = 'dead'`).get().count;
+        return { pending, running, completed24h, failed24h, dead };
+    }
+    cleanupOld(maxAgeMs) {
+        const cutoff = Date.now() - maxAgeMs;
+        const result = this.db.prepare(`DELETE FROM jobs WHERE status IN ('completed', 'dead') AND completed_at < ?`).run(cutoff);
+        return Number(result.changes);
+    }
+    /** Test helper: force a timestamp column to a specific value. */
+    forceTimestamp(id, column, value) {
+        if (!ALLOWED_TIMESTAMP_COLUMNS.has(column)) {
+            throw new Error(`Column "${column}" is not an allowed timestamp column`);
+        }
+        // Column name is validated against whitelist above, safe to interpolate
+        this.db.prepare(`UPDATE jobs SET ${column} = ? WHERE id = ?`).run(value, id);
+    }
+    close() {
+        this.db.close();
+    }
+    rowToJob(row) {
+        return {
+            id: row.id,
+            type: row.type,
+            status: row.status,
+            payload: row.payload ? JSON.parse(row.payload) : undefined,
+            result: row.result != null ? JSON.parse(row.result) : undefined,
+            priority: row.priority,
+            attempt: row.attempt,
+            maxAttempts: row.max_attempts,
+            scheduledAt: row.scheduled_at,
+            startedAt: row.started_at ?? undefined,
+            completedAt: row.completed_at ?? undefined,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+//# sourceMappingURL=db.js.map