@monlite/queue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emad Jumaah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @monlite/queue
+
+A **durable job queue** for [`@monlite/core`](https://www.npmjs.com/package/@monlite/core), backed by SQLite — retries, backoff, delayed jobs, priorities, and concurrency, with no separate server. Part of the [local AI-agent harness](https://github.com/qataruts/monlite#readme) (the BullMQ/Redis role, locally).
+
+```bash
+npm install @monlite/core @monlite/queue
+```
+
+## Quick start
+
+```ts
+import { createDb } from "@monlite/core";
+import { createQueue } from "@monlite/queue";
+
+const db = createDb("app.db");
+const queue = createQueue(db, { maxAttempts: 3 });
+
+// Worker
+queue.process("email", async (job) => {
+  await sendEmail(job.payload);
+}, { concurrency: 5 });
+
+queue.on("completed", (job) => console.log("sent", job.id));
+queue.on("failed", (job, err) => console.warn("failed", job.id, err.message));
+
+// Producer
+queue.add("email", { to: "ali@example.com" });
+queue.add("digest", { day: "mon" }, { delay: 60_000, priority: 10 });
+```
+
+## Features
+
+- **Durable & transactional** — jobs live in SQLite, so nothing is lost on crash.
+- **Atomic claim** — workers grab jobs with a single `UPDATE … RETURNING`, so it's
+  **multi-process safe** (run workers in several processes against the same db).
+- **Retries with backoff** — failed jobs retry up to `maxAttempts`; backoff is
+  exponential by default (override with `backoff(attempt) => ms`).
+- **Delayed / scheduled** — `{ delay }` or `{ runAt }`.
+- **Priorities** — higher `priority` runs first.
+- **Concurrency** — `{ concurrency }` per worker.
+- **Dead-letter** — exhausted jobs become `status: "failed"` and are kept for inspection.
+
+## API
+
+```ts
+const queue = createQueue(db, {
+  maxAttempts,      // default attempts before dead-lettering (default 1)
+  backoff,          // (attempt) => ms; default exponential capped at 30s
+  removeOnComplete, // delete finished jobs instead of keeping them (default false)
+});
+
+queue.add(name, payload, { delay, runAt, priority, maxAttempts }); // → Job
+queue.process(name, handler, { concurrency, pollInterval });       // → Worker
+queue.on("completed" | "failed", (job, resultOrError) => {});
+queue.getJob(id);                  // Job | undefined
+queue.counts(name?);               // { pending, active, done, failed }
+queue.recover(olderThanMs);        // requeue jobs stuck "active" from a crash
+await worker.stop();               // stop one worker (drains in-flight)
+await queue.close();               // stop all workers
+```
+
+## Recovering crashed jobs
+
+A worker that dies mid-job leaves the job `active`. Call `queue.recover()` on
+startup (or periodically) to requeue jobs that have been `active` longer than a
+threshold:
+
+```ts
+queue.recover(60_000); // requeue anything stuck > 60s
+```
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,222 @@
+'use strict';
+
+var events = require('events');
+
+// src/index.ts
+var ensured = /* @__PURE__ */ new WeakSet();
+var now = () => Date.now();
+var defaultBackoff = (attempt) => Math.min(3e4, 1e3 * 2 ** (attempt - 1));
+function deserialize(row) {
+  return {
+    id: row.id,
+    queue: row.queue,
+    status: row.status,
+    priority: row.priority,
+    payload: JSON.parse(row.payload),
+    attempts: row.attempts,
+    maxAttempts: row.max_attempts,
+    runAt: row.run_at,
+    result: row.result != null ? JSON.parse(row.result) : void 0,
+    error: row.error ?? void 0,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+var WorkerImpl = class {
+  constructor(q, name, handler, opts) {
+    this.q = q;
+    this.name = name;
+    this.handler = handler;
+    this.concurrency = Math.max(1, opts.concurrency ?? 1);
+    this.pollInterval = opts.pollInterval ?? 500;
+    this.kick();
+  }
+  q;
+  name;
+  handler;
+  running = true;
+  inFlight = 0;
+  timer;
+  drainResolve;
+  concurrency;
+  pollInterval;
+  /** Fill spare capacity with claimable jobs; otherwise schedule a poll. */
+  kick() {
+    if (!this.running) return;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    while (this.running && this.inFlight < this.concurrency) {
+      const job = this.q.claimInternal(this.name);
+      if (!job) break;
+      this.inFlight++;
+      Promise.resolve().then(() => this.handler(job)).then(
+        (result) => {
+          this.q.completeInternal(job, result);
+          this.q.emit("completed", job, result);
+        },
+        (err) => {
+          this.q.failInternal(job, err);
+          this.q.emit("failed", job, err);
+        }
+      ).finally(() => {
+        this.inFlight--;
+        if (this.running) this.kick();
+        else this.checkDrained();
+      });
+    }
+    if (this.running && this.inFlight < this.concurrency) {
+      this.timer = setTimeout(() => this.kick(), this.pollInterval);
+      this.timer.unref?.();
+    }
+  }
+  checkDrained() {
+    if (!this.running && this.inFlight === 0 && this.drainResolve) {
+      this.drainResolve();
+      this.drainResolve = void 0;
+    }
+  }
+  async stop() {
+    this.running = false;
+    if (this.timer) clearTimeout(this.timer);
+    if (this.inFlight === 0) return;
+    await new Promise((resolve) => {
+      this.drainResolve = resolve;
+    });
+  }
+};
+var Queue = class extends events.EventEmitter {
+  driver;
+  maxAttempts;
+  backoff;
+  removeOnComplete;
+  workerId;
+  workers = [];
+  constructor(db, opts = {}) {
+    super();
+    this.driver = db.driver;
+    this.maxAttempts = opts.maxAttempts ?? 1;
+    this.backoff = opts.backoff ?? defaultBackoff;
+    this.removeOnComplete = opts.removeOnComplete ?? false;
+    this.workerId = opts.workerId ?? `w-${process.pid}`;
+    if (!ensured.has(db)) {
+      this.driver.exec(
+        `CREATE TABLE IF NOT EXISTS _jobs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          queue TEXT NOT NULL, status TEXT NOT NULL, priority INTEGER NOT NULL,
+          run_at INTEGER NOT NULL, attempts INTEGER NOT NULL, max_attempts INTEGER NOT NULL,
+          payload TEXT NOT NULL, result TEXT, error TEXT, locked_by TEXT,
+          created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
+        )`
+      );
+      this.driver.exec(
+        `CREATE INDEX IF NOT EXISTS _jobs_claim ON _jobs (queue, status, priority, run_at)`
+      );
+      ensured.add(db);
+    }
+  }
+  /** Enqueue a job. */
+  add(name, payload, opts = {}) {
+    const t = now();
+    const runAt = opts.runAt ?? (opts.delay ? t + opts.delay : t);
+    const info = this.driver.prepare(
+      `INSERT INTO _jobs (queue, status, priority, run_at, attempts, max_attempts, payload, created_at, updated_at)
+         VALUES (?, 'pending', ?, ?, 0, ?, ?, ?, ?)`
+    ).run(
+      name,
+      opts.priority ?? 0,
+      runAt,
+      opts.maxAttempts ?? this.maxAttempts,
+      JSON.stringify(payload ?? null),
+      t,
+      t
+    );
+    const job = this.getJob(Number(info.lastInsertRowid));
+    for (const w of this.workers) if (w.name === name) w.kick();
+    return job;
+  }
+  /** Register a worker for a queue. Returns a handle with `stop()`. */
+  process(name, handler, opts = {}) {
+    const w = new WorkerImpl(this, name, handler, opts);
+    this.workers.push(w);
+    return w;
+  }
+  getJob(id) {
+    const row = this.driver.prepare(`SELECT * FROM _jobs WHERE id = ?`).get(id);
+    return row ? deserialize(row) : void 0;
+  }
+  /** Count jobs by status (optionally for one queue). */
+  counts(name) {
+    const rows = name ? this.driver.prepare(
+      `SELECT status, COUNT(*) AS n FROM _jobs WHERE queue = ? GROUP BY status`
+    ).all(name) : this.driver.prepare(`SELECT status, COUNT(*) AS n FROM _jobs GROUP BY status`).all();
+    const out = {
+      pending: 0,
+      active: 0,
+      done: 0,
+      failed: 0
+    };
+    for (const r of rows) out[r.status] = r.n;
+    return out;
+  }
+  /**
+   * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`
+   * if they haven't been touched in `olderThanMs`. Returns the count recovered.
+   */
+  recover(olderThanMs = 6e4) {
+    return this.driver.prepare(
+      `UPDATE _jobs SET status='pending', locked_by=NULL, updated_at=?
+         WHERE status='active' AND updated_at < ?`
+    ).run(now(), now() - olderThanMs).changes;
+  }
+  /** Stop all workers and wait for in-flight jobs to finish. */
+  async close() {
+    await Promise.all(this.workers.map((w) => w.stop()));
+  }
+  /** @internal Atomically claim the next due job, counting the attempt. */
+  claimInternal(name) {
+    const t = now();
+    const row = this.driver.prepare(
+      `UPDATE _jobs SET status='active', attempts=attempts+1, locked_by=?, updated_at=?
+         WHERE id = (
+           SELECT id FROM _jobs
+           WHERE queue=? AND status='pending' AND run_at<=?
+           ORDER BY priority DESC, id ASC LIMIT 1
+         )
+         RETURNING *`
+    ).get(this.workerId, t, name, t);
+    return row ? deserialize(row) : null;
+  }
+  /** @internal */
+  completeInternal(job, result) {
+    if (this.removeOnComplete) {
+      this.driver.prepare(`DELETE FROM _jobs WHERE id = ?`).run(job.id);
+    } else {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='done', result=?, error=NULL, updated_at=? WHERE id=?`
+      ).run(JSON.stringify(result ?? null), now(), job.id);
+    }
+  }
+  /** @internal */
+  failInternal(job, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (job.attempts < job.maxAttempts) {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='pending', run_at=?, error=?, locked_by=NULL, updated_at=? WHERE id=?`
+      ).run(now() + this.backoff(job.attempts), message, now(), job.id);
+    } else {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='failed', error=?, updated_at=? WHERE id=?`
+      ).run(message, now(), job.id);
+    }
+  }
+};
+function createQueue(db, opts) {
+  return new Queue(db, opts);
+}
+
+exports.Queue = Queue;
+exports.createQueue = createQueue;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["EventEmitter"],"mappings":"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","file":"index.cjs","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport type { Monlite } from \"@monlite/core\";\n\nexport type JobStatus = \"pending\" | \"active\" | \"done\" | \"failed\";\n\nexport interface Job<T = any> {\n  id: number;\n  queue: string;\n  status: JobStatus;\n  priority: number;\n  payload: T;\n  /** Number of attempts already made (0 until the first run). */\n  attempts: number;\n  maxAttempts: number;\n  runAt: number;\n  result?: any;\n  error?: string;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface AddOptions {\n  /** Delay before the job becomes runnable (ms). */\n  delay?: number;\n  /** Explicit epoch-ms run time (overrides `delay`). */\n  runAt?: number;\n  /** Higher runs first. Default 0. */\n  priority?: number;\n  /** Total attempts before dead-lettering. Default: the queue's `maxAttempts`. */\n  maxAttempts?: number;\n}\n\nexport interface ProcessOptions {\n  /** Jobs run concurrently per worker. Default 1. */\n  concurrency?: number;\n  /** How often to poll for due jobs when idle (ms). Default 500. */\n  pollInterval?: number;\n}\n\nexport interface QueueOptions {\n  /** Default attempts before dead-lettering. Default 1 (no retry). */\n  maxAttempts?: number;\n  /** Backoff before retry N (ms). Default: exponential, capped at 30s. */\n  backoff?: (attempt: number) => number;\n  /** Delete jobs once completed instead of keeping them as `done`. Default false. */\n  removeOnComplete?: boolean;\n  /** Identifies this worker process in the `locked_by` column. */\n  workerId?: string;\n}\n\nexport type Handler<T = any, R = any> = (job: Job<T>) => Promise<R> | R;\n\nexport interface Worker {\n  /** Stop claiming new jobs and wait for in-flight ones to finish. */\n  stop(): Promise<void>;\n}\n\ninterface Row {\n  id: number;\n  queue: string;\n  status: JobStatus;\n  priority: number;\n  run_at: number;\n  attempts: number;\n  max_attempts: number;\n  payload: string;\n  result: string | null;\n  error: string | null;\n  created_at: number;\n  updated_at: number;\n}\n\nconst ensured = new WeakSet<object>();\nconst now = () => Date.now();\nconst defaultBackoff = (attempt: number) =>\n  Math.min(30_000, 1000 * 2 ** (attempt - 1));\n\nfunction deserialize(row: Row): Job {\n  return {\n    id: row.id,\n    queue: row.queue,\n    status: row.status,\n    priority: row.priority,\n    payload: JSON.parse(row.payload),\n    attempts: row.attempts,\n    maxAttempts: row.max_attempts,\n    runAt: row.run_at,\n    result: row.result != null ? JSON.parse(row.result) : undefined,\n    error: row.error ?? undefined,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  };\n}\n\nclass WorkerImpl implements Worker {\n  private running = true;\n  private inFlight = 0;\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private drainResolve: (() => void) | undefined;\n  private readonly concurrency: number;\n  private readonly pollInterval: number;\n\n  constructor(\n    private readonly q: Queue,\n    readonly name: string,\n    private readonly handler: Handler,\n    opts: ProcessOptions,\n  ) {\n    this.concurrency = Math.max(1, opts.concurrency ?? 1);\n    this.pollInterval = opts.pollInterval ?? 500;\n    this.kick();\n  }\n\n  /** Fill spare capacity with claimable jobs; otherwise schedule a poll. */\n  kick(): void {\n    if (!this.running) return;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = undefined;\n    }\n    while (this.running && this.inFlight < this.concurrency) {\n      const job = this.q.claimInternal(this.name);\n      if (!job) break;\n      this.inFlight++;\n      Promise.resolve()\n        .then(() => this.handler(job))\n        .then(\n          (result) => {\n            this.q.completeInternal(job, result);\n            this.q.emit(\"completed\", job, result);\n          },\n          (err) => {\n            this.q.failInternal(job, err);\n            this.q.emit(\"failed\", job, err);\n          },\n        )\n        .finally(() => {\n          this.inFlight--;\n          if (this.running) this.kick();\n          else this.checkDrained();\n        });\n    }\n    if (this.running && this.inFlight < this.concurrency) {\n      this.timer = setTimeout(() => this.kick(), this.pollInterval);\n      this.timer.unref?.();\n    }\n  }\n\n  private checkDrained(): void {\n    if (!this.running && this.inFlight === 0 && this.drainResolve) {\n      this.drainResolve();\n      this.drainResolve = undefined;\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.running = false;\n    if (this.timer) clearTimeout(this.timer);\n    if (this.inFlight === 0) return;\n    await new Promise<void>((resolve) => {\n      this.drainResolve = resolve;\n    });\n  }\n}\n\n/**\n * A durable, multi-process-safe job queue backed by SQLite. Producers `add`\n * jobs; workers `process` them with retries, backoff, delays, and concurrency.\n * Emits `\"completed\"` (job, result) and `\"failed\"` (job, error).\n */\nexport class Queue extends EventEmitter {\n  private readonly driver: Monlite[\"driver\"];\n  private readonly maxAttempts: number;\n  private readonly backoff: (attempt: number) => number;\n  private readonly removeOnComplete: boolean;\n  readonly workerId: string;\n  private readonly workers: WorkerImpl[] = [];\n\n  constructor(db: Monlite, opts: QueueOptions = {}) {\n    super();\n    this.driver = db.driver;\n    this.maxAttempts = opts.maxAttempts ?? 1;\n    this.backoff = opts.backoff ?? defaultBackoff;\n    this.removeOnComplete = opts.removeOnComplete ?? false;\n    this.workerId = opts.workerId ?? `w-${process.pid}`;\n\n    if (!ensured.has(db)) {\n      this.driver.exec(\n        `CREATE TABLE IF NOT EXISTS _jobs (\n          id INTEGER PRIMARY KEY AUTOINCREMENT,\n          queue TEXT NOT NULL, status TEXT NOT NULL, priority INTEGER NOT NULL,\n          run_at INTEGER NOT NULL, attempts INTEGER NOT NULL, max_attempts INTEGER NOT NULL,\n          payload TEXT NOT NULL, result TEXT, error TEXT, locked_by TEXT,\n          created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL\n        )`,\n      );\n      this.driver.exec(\n        `CREATE INDEX IF NOT EXISTS _jobs_claim ON _jobs (queue, status, priority, run_at)`,\n      );\n      ensured.add(db);\n    }\n  }\n\n  /** Enqueue a job. */\n  add<T = any>(name: string, payload: T, opts: AddOptions = {}): Job<T> {\n    const t = now();\n    const runAt = opts.runAt ?? (opts.delay ? t + opts.delay : t);\n    const info = this.driver\n      .prepare(\n        `INSERT INTO _jobs (queue, status, priority, run_at, attempts, max_attempts, payload, created_at, updated_at)\n         VALUES (?, 'pending', ?, ?, 0, ?, ?, ?, ?)`,\n      )\n      .run(\n        name,\n        opts.priority ?? 0,\n        runAt,\n        opts.maxAttempts ?? this.maxAttempts,\n        JSON.stringify(payload ?? null),\n        t,\n        t,\n      );\n    const job = this.getJob(Number(info.lastInsertRowid))!;\n    for (const w of this.workers) if (w.name === name) w.kick();\n    return job as Job<T>;\n  }\n\n  /** Register a worker for a queue. Returns a handle with `stop()`. */\n  process<T = any, R = any>(\n    name: string,\n    handler: Handler<T, R>,\n    opts: ProcessOptions = {},\n  ): Worker {\n    const w = new WorkerImpl(this, name, handler as Handler, opts);\n    this.workers.push(w);\n    return w;\n  }\n\n  getJob<T = any>(id: number): Job<T> | undefined {\n    const row = this.driver\n      .prepare(`SELECT * FROM _jobs WHERE id = ?`)\n      .get(id) as Row | undefined;\n    return row ? (deserialize(row) as Job<T>) : undefined;\n  }\n\n  /** Count jobs by status (optionally for one queue). */\n  counts(name?: string): Record<JobStatus, number> {\n    const rows = (\n      name\n        ? this.driver\n            .prepare(\n              `SELECT status, COUNT(*) AS n FROM _jobs WHERE queue = ? GROUP BY status`,\n            )\n            .all(name)\n        : this.driver\n            .prepare(`SELECT status, COUNT(*) AS n FROM _jobs GROUP BY status`)\n            .all()\n    ) as Array<{ status: JobStatus; n: number }>;\n    const out: Record<JobStatus, number> = {\n      pending: 0,\n      active: 0,\n      done: 0,\n      failed: 0,\n    };\n    for (const r of rows) out[r.status] = r.n;\n    return out;\n  }\n\n  /**\n   * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`\n   * if they haven't been touched in `olderThanMs`. Returns the count recovered.\n   */\n  recover(olderThanMs = 60_000): number {\n    return this.driver\n      .prepare(\n        `UPDATE _jobs SET status='pending', locked_by=NULL, updated_at=?\n         WHERE status='active' AND updated_at < ?`,\n      )\n      .run(now(), now() - olderThanMs).changes;\n  }\n\n  /** Stop all workers and wait for in-flight jobs to finish. */\n  async close(): Promise<void> {\n    await Promise.all(this.workers.map((w) => w.stop()));\n  }\n\n  /** @internal Atomically claim the next due job, counting the attempt. */\n  claimInternal(name: string): Job | null {\n    const t = now();\n    const row = this.driver\n      .prepare(\n        `UPDATE _jobs SET status='active', attempts=attempts+1, locked_by=?, updated_at=?\n         WHERE id = (\n           SELECT id FROM _jobs\n           WHERE queue=? AND status='pending' AND run_at<=?\n           ORDER BY priority DESC, id ASC LIMIT 1\n         )\n         RETURNING *`,\n      )\n      .get(this.workerId, t, name, t) as Row | undefined;\n    return row ? deserialize(row) : null;\n  }\n\n  /** @internal */\n  completeInternal(job: Job, result: unknown): void {\n    if (this.removeOnComplete) {\n      this.driver.prepare(`DELETE FROM _jobs WHERE id = ?`).run(job.id);\n    } else {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='done', result=?, error=NULL, updated_at=? WHERE id=?`,\n        )\n        .run(JSON.stringify(result ?? null), now(), job.id);\n    }\n  }\n\n  /** @internal */\n  failInternal(job: Job, err: unknown): void {\n    // `job.attempts` was already incremented at claim time.\n    const message = err instanceof Error ? err.message : String(err);\n    if (job.attempts < job.maxAttempts) {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='pending', run_at=?, error=?, locked_by=NULL, updated_at=? WHERE id=?`,\n        )\n        .run(now() + this.backoff(job.attempts), message, now(), job.id);\n    } else {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='failed', error=?, updated_at=? WHERE id=?`,\n        )\n        .run(message, now(), job.id);\n    }\n  }\n}\n\n/** Create a job queue over a monlite database. */\nexport function createQueue(db: Monlite, opts?: QueueOptions): Queue {\n  return new Queue(db, opts);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,88 @@
+import { EventEmitter } from 'node:events';
+import { Monlite } from '@monlite/core';
+
+type JobStatus = "pending" | "active" | "done" | "failed";
+interface Job<T = any> {
+    id: number;
+    queue: string;
+    status: JobStatus;
+    priority: number;
+    payload: T;
+    /** Number of attempts already made (0 until the first run). */
+    attempts: number;
+    maxAttempts: number;
+    runAt: number;
+    result?: any;
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface AddOptions {
+    /** Delay before the job becomes runnable (ms). */
+    delay?: number;
+    /** Explicit epoch-ms run time (overrides `delay`). */
+    runAt?: number;
+    /** Higher runs first. Default 0. */
+    priority?: number;
+    /** Total attempts before dead-lettering. Default: the queue's `maxAttempts`. */
+    maxAttempts?: number;
+}
+interface ProcessOptions {
+    /** Jobs run concurrently per worker. Default 1. */
+    concurrency?: number;
+    /** How often to poll for due jobs when idle (ms). Default 500. */
+    pollInterval?: number;
+}
+interface QueueOptions {
+    /** Default attempts before dead-lettering. Default 1 (no retry). */
+    maxAttempts?: number;
+    /** Backoff before retry N (ms). Default: exponential, capped at 30s. */
+    backoff?: (attempt: number) => number;
+    /** Delete jobs once completed instead of keeping them as `done`. Default false. */
+    removeOnComplete?: boolean;
+    /** Identifies this worker process in the `locked_by` column. */
+    workerId?: string;
+}
+type Handler<T = any, R = any> = (job: Job<T>) => Promise<R> | R;
+interface Worker {
+    /** Stop claiming new jobs and wait for in-flight ones to finish. */
+    stop(): Promise<void>;
+}
+/**
+ * A durable, multi-process-safe job queue backed by SQLite. Producers `add`
+ * jobs; workers `process` them with retries, backoff, delays, and concurrency.
+ * Emits `"completed"` (job, result) and `"failed"` (job, error).
+ */
+declare class Queue extends EventEmitter {
+    private readonly driver;
+    private readonly maxAttempts;
+    private readonly backoff;
+    private readonly removeOnComplete;
+    readonly workerId: string;
+    private readonly workers;
+    constructor(db: Monlite, opts?: QueueOptions);
+    /** Enqueue a job. */
+    add<T = any>(name: string, payload: T, opts?: AddOptions): Job<T>;
+    /** Register a worker for a queue. Returns a handle with `stop()`. */
+    process<T = any, R = any>(name: string, handler: Handler<T, R>, opts?: ProcessOptions): Worker;
+    getJob<T = any>(id: number): Job<T> | undefined;
+    /** Count jobs by status (optionally for one queue). */
+    counts(name?: string): Record<JobStatus, number>;
+    /**
+     * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`
+     * if they haven't been touched in `olderThanMs`. Returns the count recovered.
+     */
+    recover(olderThanMs?: number): number;
+    /** Stop all workers and wait for in-flight jobs to finish. */
+    close(): Promise<void>;
+    /** @internal Atomically claim the next due job, counting the attempt. */
+    claimInternal(name: string): Job | null;
+    /** @internal */
+    completeInternal(job: Job, result: unknown): void;
+    /** @internal */
+    failInternal(job: Job, err: unknown): void;
+}
+/** Create a job queue over a monlite database. */
+declare function createQueue(db: Monlite, opts?: QueueOptions): Queue;
+
+export { type AddOptions, type Handler, type Job, type JobStatus, type ProcessOptions, Queue, type QueueOptions, type Worker, createQueue };

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+import { EventEmitter } from 'node:events';
+import { Monlite } from '@monlite/core';
+
+type JobStatus = "pending" | "active" | "done" | "failed";
+interface Job<T = any> {
+    id: number;
+    queue: string;
+    status: JobStatus;
+    priority: number;
+    payload: T;
+    /** Number of attempts already made (0 until the first run). */
+    attempts: number;
+    maxAttempts: number;
+    runAt: number;
+    result?: any;
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface AddOptions {
+    /** Delay before the job becomes runnable (ms). */
+    delay?: number;
+    /** Explicit epoch-ms run time (overrides `delay`). */
+    runAt?: number;
+    /** Higher runs first. Default 0. */
+    priority?: number;
+    /** Total attempts before dead-lettering. Default: the queue's `maxAttempts`. */
+    maxAttempts?: number;
+}
+interface ProcessOptions {
+    /** Jobs run concurrently per worker. Default 1. */
+    concurrency?: number;
+    /** How often to poll for due jobs when idle (ms). Default 500. */
+    pollInterval?: number;
+}
+interface QueueOptions {
+    /** Default attempts before dead-lettering. Default 1 (no retry). */
+    maxAttempts?: number;
+    /** Backoff before retry N (ms). Default: exponential, capped at 30s. */
+    backoff?: (attempt: number) => number;
+    /** Delete jobs once completed instead of keeping them as `done`. Default false. */
+    removeOnComplete?: boolean;
+    /** Identifies this worker process in the `locked_by` column. */
+    workerId?: string;
+}
+type Handler<T = any, R = any> = (job: Job<T>) => Promise<R> | R;
+interface Worker {
+    /** Stop claiming new jobs and wait for in-flight ones to finish. */
+    stop(): Promise<void>;
+}
+/**
+ * A durable, multi-process-safe job queue backed by SQLite. Producers `add`
+ * jobs; workers `process` them with retries, backoff, delays, and concurrency.
+ * Emits `"completed"` (job, result) and `"failed"` (job, error).
+ */
+declare class Queue extends EventEmitter {
+    private readonly driver;
+    private readonly maxAttempts;
+    private readonly backoff;
+    private readonly removeOnComplete;
+    readonly workerId: string;
+    private readonly workers;
+    constructor(db: Monlite, opts?: QueueOptions);
+    /** Enqueue a job. */
+    add<T = any>(name: string, payload: T, opts?: AddOptions): Job<T>;
+    /** Register a worker for a queue. Returns a handle with `stop()`. */
+    process<T = any, R = any>(name: string, handler: Handler<T, R>, opts?: ProcessOptions): Worker;
+    getJob<T = any>(id: number): Job<T> | undefined;
+    /** Count jobs by status (optionally for one queue). */
+    counts(name?: string): Record<JobStatus, number>;
+    /**
+     * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`
+     * if they haven't been touched in `olderThanMs`. Returns the count recovered.
+     */
+    recover(olderThanMs?: number): number;
+    /** Stop all workers and wait for in-flight jobs to finish. */
+    close(): Promise<void>;
+    /** @internal Atomically claim the next due job, counting the attempt. */
+    claimInternal(name: string): Job | null;
+    /** @internal */
+    completeInternal(job: Job, result: unknown): void;
+    /** @internal */
+    failInternal(job: Job, err: unknown): void;
+}
+/** Create a job queue over a monlite database. */
+declare function createQueue(db: Monlite, opts?: QueueOptions): Queue;
+
+export { type AddOptions, type Handler, type Job, type JobStatus, type ProcessOptions, Queue, type QueueOptions, type Worker, createQueue };

package/dist/index.js

@@ -0,0 +1,219 @@
+import { EventEmitter } from 'events';
+
+// src/index.ts
+var ensured = /* @__PURE__ */ new WeakSet();
+var now = () => Date.now();
+var defaultBackoff = (attempt) => Math.min(3e4, 1e3 * 2 ** (attempt - 1));
+function deserialize(row) {
+  return {
+    id: row.id,
+    queue: row.queue,
+    status: row.status,
+    priority: row.priority,
+    payload: JSON.parse(row.payload),
+    attempts: row.attempts,
+    maxAttempts: row.max_attempts,
+    runAt: row.run_at,
+    result: row.result != null ? JSON.parse(row.result) : void 0,
+    error: row.error ?? void 0,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at
+  };
+}
+var WorkerImpl = class {
+  constructor(q, name, handler, opts) {
+    this.q = q;
+    this.name = name;
+    this.handler = handler;
+    this.concurrency = Math.max(1, opts.concurrency ?? 1);
+    this.pollInterval = opts.pollInterval ?? 500;
+    this.kick();
+  }
+  q;
+  name;
+  handler;
+  running = true;
+  inFlight = 0;
+  timer;
+  drainResolve;
+  concurrency;
+  pollInterval;
+  /** Fill spare capacity with claimable jobs; otherwise schedule a poll. */
+  kick() {
+    if (!this.running) return;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = void 0;
+    }
+    while (this.running && this.inFlight < this.concurrency) {
+      const job = this.q.claimInternal(this.name);
+      if (!job) break;
+      this.inFlight++;
+      Promise.resolve().then(() => this.handler(job)).then(
+        (result) => {
+          this.q.completeInternal(job, result);
+          this.q.emit("completed", job, result);
+        },
+        (err) => {
+          this.q.failInternal(job, err);
+          this.q.emit("failed", job, err);
+        }
+      ).finally(() => {
+        this.inFlight--;
+        if (this.running) this.kick();
+        else this.checkDrained();
+      });
+    }
+    if (this.running && this.inFlight < this.concurrency) {
+      this.timer = setTimeout(() => this.kick(), this.pollInterval);
+      this.timer.unref?.();
+    }
+  }
+  checkDrained() {
+    if (!this.running && this.inFlight === 0 && this.drainResolve) {
+      this.drainResolve();
+      this.drainResolve = void 0;
+    }
+  }
+  async stop() {
+    this.running = false;
+    if (this.timer) clearTimeout(this.timer);
+    if (this.inFlight === 0) return;
+    await new Promise((resolve) => {
+      this.drainResolve = resolve;
+    });
+  }
+};
+var Queue = class extends EventEmitter {
+  driver;
+  maxAttempts;
+  backoff;
+  removeOnComplete;
+  workerId;
+  workers = [];
+  constructor(db, opts = {}) {
+    super();
+    this.driver = db.driver;
+    this.maxAttempts = opts.maxAttempts ?? 1;
+    this.backoff = opts.backoff ?? defaultBackoff;
+    this.removeOnComplete = opts.removeOnComplete ?? false;
+    this.workerId = opts.workerId ?? `w-${process.pid}`;
+    if (!ensured.has(db)) {
+      this.driver.exec(
+        `CREATE TABLE IF NOT EXISTS _jobs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          queue TEXT NOT NULL, status TEXT NOT NULL, priority INTEGER NOT NULL,
+          run_at INTEGER NOT NULL, attempts INTEGER NOT NULL, max_attempts INTEGER NOT NULL,
+          payload TEXT NOT NULL, result TEXT, error TEXT, locked_by TEXT,
+          created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL
+        )`
+      );
+      this.driver.exec(
+        `CREATE INDEX IF NOT EXISTS _jobs_claim ON _jobs (queue, status, priority, run_at)`
+      );
+      ensured.add(db);
+    }
+  }
+  /** Enqueue a job. */
+  add(name, payload, opts = {}) {
+    const t = now();
+    const runAt = opts.runAt ?? (opts.delay ? t + opts.delay : t);
+    const info = this.driver.prepare(
+      `INSERT INTO _jobs (queue, status, priority, run_at, attempts, max_attempts, payload, created_at, updated_at)
+         VALUES (?, 'pending', ?, ?, 0, ?, ?, ?, ?)`
+    ).run(
+      name,
+      opts.priority ?? 0,
+      runAt,
+      opts.maxAttempts ?? this.maxAttempts,
+      JSON.stringify(payload ?? null),
+      t,
+      t
+    );
+    const job = this.getJob(Number(info.lastInsertRowid));
+    for (const w of this.workers) if (w.name === name) w.kick();
+    return job;
+  }
+  /** Register a worker for a queue. Returns a handle with `stop()`. */
+  process(name, handler, opts = {}) {
+    const w = new WorkerImpl(this, name, handler, opts);
+    this.workers.push(w);
+    return w;
+  }
+  getJob(id) {
+    const row = this.driver.prepare(`SELECT * FROM _jobs WHERE id = ?`).get(id);
+    return row ? deserialize(row) : void 0;
+  }
+  /** Count jobs by status (optionally for one queue). */
+  counts(name) {
+    const rows = name ? this.driver.prepare(
+      `SELECT status, COUNT(*) AS n FROM _jobs WHERE queue = ? GROUP BY status`
+    ).all(name) : this.driver.prepare(`SELECT status, COUNT(*) AS n FROM _jobs GROUP BY status`).all();
+    const out = {
+      pending: 0,
+      active: 0,
+      done: 0,
+      failed: 0
+    };
+    for (const r of rows) out[r.status] = r.n;
+    return out;
+  }
+  /**
+   * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`
+   * if they haven't been touched in `olderThanMs`. Returns the count recovered.
+   */
+  recover(olderThanMs = 6e4) {
+    return this.driver.prepare(
+      `UPDATE _jobs SET status='pending', locked_by=NULL, updated_at=?
+         WHERE status='active' AND updated_at < ?`
+    ).run(now(), now() - olderThanMs).changes;
+  }
+  /** Stop all workers and wait for in-flight jobs to finish. */
+  async close() {
+    await Promise.all(this.workers.map((w) => w.stop()));
+  }
+  /** @internal Atomically claim the next due job, counting the attempt. */
+  claimInternal(name) {
+    const t = now();
+    const row = this.driver.prepare(
+      `UPDATE _jobs SET status='active', attempts=attempts+1, locked_by=?, updated_at=?
+         WHERE id = (
+           SELECT id FROM _jobs
+           WHERE queue=? AND status='pending' AND run_at<=?
+           ORDER BY priority DESC, id ASC LIMIT 1
+         )
+         RETURNING *`
+    ).get(this.workerId, t, name, t);
+    return row ? deserialize(row) : null;
+  }
+  /** @internal */
+  completeInternal(job, result) {
+    if (this.removeOnComplete) {
+      this.driver.prepare(`DELETE FROM _jobs WHERE id = ?`).run(job.id);
+    } else {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='done', result=?, error=NULL, updated_at=? WHERE id=?`
+      ).run(JSON.stringify(result ?? null), now(), job.id);
+    }
+  }
+  /** @internal */
+  failInternal(job, err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (job.attempts < job.maxAttempts) {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='pending', run_at=?, error=?, locked_by=NULL, updated_at=? WHERE id=?`
+      ).run(now() + this.backoff(job.attempts), message, now(), job.id);
+    } else {
+      this.driver.prepare(
+        `UPDATE _jobs SET status='failed', error=?, updated_at=? WHERE id=?`
+      ).run(message, now(), job.id);
+    }
+  }
+};
+function createQueue(db, opts) {
+  return new Queue(db, opts);
+}
+
+export { Queue, createQueue };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAwEA,IAAM,OAAA,uBAAc,OAAA,EAAgB;AACpC,IAAM,GAAA,GAAM,MAAM,IAAA,CAAK,GAAA,EAAI;AAC3B,IAAM,cAAA,GAAiB,CAAC,OAAA,KACtB,IAAA,CAAK,IAAI,GAAA,EAAQ,GAAA,GAAO,CAAA,KAAM,OAAA,GAAU,CAAA,CAAE,CAAA;AAE5C,SAAS,YAAY,GAAA,EAAe;AAClC,EAAA,OAAO;AAAA,IACL,IAAI,GAAA,CAAI,EAAA;AAAA,IACR,OAAO,GAAA,CAAI,KAAA;AAAA,IACX,QAAQ,GAAA,CAAI,MAAA;AAAA,IACZ,UAAU,GAAA,CAAI,QAAA;AAAA,IACd,OAAA,EAAS,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AAAA,IAC/B,UAAU,GAAA,CAAI,QAAA;AAAA,IACd,aAAa,GAAA,CAAI,YAAA;AAAA,IACjB,OAAO,GAAA,CAAI,MAAA;AAAA,IACX,MAAA,EAAQ,IAAI,MAAA,IAAU,IAAA,GAAO,KAAK,KAAA,CAAM,GAAA,CAAI,MAAM,CAAA,GAAI,MAAA;AAAA,IACtD,KAAA,EAAO,IAAI,KAAA,IAAS,MAAA;AAAA,IACpB,WAAW,GAAA,CAAI,UAAA;AAAA,IACf,WAAW,GAAA,CAAI;AAAA,GACjB;AACF;AAEA,IAAM,aAAN,MAAmC;AAAA,EAQjC,WAAA,CACmB,CAAA,EACR,IAAA,EACQ,OAAA,EACjB,IAAA,EACA;AAJiB,IAAA,IAAA,CAAA,CAAA,GAAA,CAAA;AACR,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACQ,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAGjB,IAAA,IAAA,CAAK,cAAc,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,eAAe,CAAC,CAAA;AACpD,IAAA,IAAA,CAAK,YAAA,GAAe,KAAK,YAAA,IAAgB,GAAA;AACzC,IAAA,IAAA,CAAK,IAAA,EAAK;AAAA,EACZ;AAAA,EARmB,CAAA;AAAA,EACR,IAAA;AAAA,EACQ,OAAA;AAAA,EAVX,OAAA,GAAU,IAAA;AAAA,EACV,QAAA,GAAW,CAAA;AAAA,EACX,KAAA;AAAA,EACA,YAAA;AAAA,EACS,WAAA;AAAA,EACA,YAAA;AAAA;AAAA,EAcjB,IAAA,GAAa;AACX,IAAA,IAAI,CAAC,KAAK,OAAA,EAAS;AACnB,IAAA,IAAI,KAAK,KAAA,EAAO;AACd,MAAA,YAAA,CAAa,KAAK,KAAK,CAAA;AACvB,MAAA,IAAA,CAAK,KAAA,GAAQ,MAAA;AAAA,IACf;AACA,IAAA,OAAO,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,QAAA,GAAW,KAAK,WAAA,EAAa;AACvD,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,CAAA,CAAE,aAAA,CAAc,KAAK,IAAI,CAAA;AAC1C,MAAA,IAAI,CAAC,GAAA,EAAK;AACV,MAAA,IAAA,CAAK,QAAA,EAAA;AACL,MAAA,OAAA,CAAQ,OAAA,GACL,IAAA,CAAK,MAAM,KAAK,OAAA,CAAQ,GAAG,CAAC,CAAA,CAC5B,IAAA;AAAA,QACC,CAAC,MAAA,KAAW;AACV,UAAA,IAAA,CAAK,CAAA,CAAE,gBAAA,CAAiB,GAAA,EAAK,MAAM,CAAA;AACnC,UAAA,IAAA,CAAK,CAAA,CAAE,IAAA,CAAK,WAAA,EAAa,GAAA,EAAK,MAAM,CAAA;AAAA,QACtC,CAAA;AAAA,QACA,CAAC,GAAA,KAAQ;AACP,UAAA,IAAA,CAAK,CAAA,CAAE,YAAA,CAAa,GAAA,EAAK,GAAG,CAAA;AAC5B,UAAA,IAAA,CAAK,CAAA,CAAE,IAAA,CAAK,QAAA,EAAU,GAAA,EAAK,GAAG,CAAA;AAAA,QAChC;AAAA,OACF,CACC,QAAQ,MAAM;AACb,QAAA,IAAA,CAAK,QAAA,EAAA;AACL,QAAA,IAAI,IAAA,CAAK,OAAA,EAAS,IAAA,CAAK,IAAA,EAAK;AAAA,kBAClB,YAAA,EAAa;AAAA,MACzB,CAAC,CAAA;AAAA,IACL;AACA,IAAA,IAAI,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,QAAA,GAAW,KAAK,WAAA,EAAa;AACpD,MAAA,IAAA,CAAK,QAAQ,UAAA,CAAW,MAAM,KAAK,IAAA,EAAK,EAAG,KAAK,YAAY,CAAA;AAC5D,MAAA,IAAA,CAAK,MAAM,KAAA,IAAQ;AAAA,IACrB;AAAA,EACF;AAAA,EAEQ,YAAA,GAAqB;AAC3B,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,IAAW,KAAK,QAAA,KAAa,CAAA,IAAK,KAAK,YAAA,EAAc;AAC7D,MAAA,IAAA,CAAK,YAAA,EAAa;AAClB,MAAA,IAAA,CAAK,YAAA,GAAe,MAAA;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,IAAA,GAAsB;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,KAAA;AACf,IAAA,IAAI,IAAA,CAAK,KAAA,EAAO,YAAA,CAAa,IAAA,CAAK,KAAK,CAAA;AACvC,IAAA,IAAI,IAAA,CAAK,aAAa,CAAA,EAAG;AACzB,IAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACnC,MAAA,IAAA,CAAK,YAAA,GAAe,OAAA;AAAA,IACtB,CAAC,CAAA;AAAA,EACH;AACF,CAAA;AAOO,IAAM,KAAA,GAAN,cAAoB,YAAA,CAAa;AAAA,EACrB,MAAA;AAAA,EACA,WAAA;AAAA,EACA,OAAA;AAAA,EACA,gBAAA;AAAA,EACR,QAAA;AAAA,EACQ,UAAwB,EAAC;AAAA,EAE1C,WAAA,CAAY,EAAA,EAAa,IAAA,GAAqB,EAAC,EAAG;AAChD,IAAA,KAAA,EAAM;AACN,IAAA,IAAA,CAAK,SAAS,EAAA,CAAG,MAAA;AACjB,IAAA,IAAA,CAAK,WAAA,GAAc,KAAK,WAAA,IAAe,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,GAAU,KAAK,OAAA,IAAW,cAAA;AAC/B,IAAA,IAAA,CAAK,gBAAA,GAAmB,KAAK,gBAAA,IAAoB,KAAA;AACjD,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,CAAA,EAAA,EAAK,QAAQ,GAAG,CAAA,CAAA;AAEjD,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,EAAE,CAAA,EAAG;AACpB,MAAA,IAAA,CAAK,MAAA,CAAO,IAAA;AAAA,QACV,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAA;AAAA,OAOF;AACA,MAAA,IAAA,CAAK,MAAA,CAAO,IAAA;AAAA,QACV,CAAA,iFAAA;AAAA,OACF;AACA,MAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,IAChB;AAAA,EACF;AAAA;AAAA,EAGA,GAAA,CAAa,IAAA,EAAc,OAAA,EAAY,IAAA,GAAmB,EAAC,EAAW;AACpE,IAAA,MAAM,IAAI,GAAA,EAAI;AACd,IAAA,MAAM,QAAQ,IAAA,CAAK,KAAA,KAAU,KAAK,KAAA,GAAQ,CAAA,GAAI,KAAK,KAAA,GAAQ,CAAA,CAAA;AAC3D,IAAA,MAAM,IAAA,GAAO,KAAK,MAAA,CACf,OAAA;AAAA,MACC,CAAA;AAAA,mDAAA;AAAA,KAEF,CACC,GAAA;AAAA,MACC,IAAA;AAAA,MACA,KAAK,QAAA,IAAY,CAAA;AAAA,MACjB,KAAA;AAAA,MACA,IAAA,CAAK,eAAe,IAAA,CAAK,WAAA;AAAA,MACzB,IAAA,CAAK,SAAA,CAAU,OAAA,IAAW,IAAI,CAAA;AAAA,MAC9B,CAAA;AAAA,MACA;AAAA,KACF;AACF,IAAA,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAA,CAAK,eAAe,CAAC,CAAA;AACpD,IAAA,KAAA,MAAW,CAAA,IAAK,KAAK,OAAA,EAAS,IAAI,EAAE,IAAA,KAAS,IAAA,IAAQ,IAAA,EAAK;AAC1D,IAAA,OAAO,GAAA;AAAA,EACT;AAAA;AAAA,EAGA,OAAA,CACE,IAAA,EACA,OAAA,EACA,IAAA,GAAuB,EAAC,EAChB;AACR,IAAA,MAAM,IAAI,IAAI,UAAA,CAAW,IAAA,EAAM,IAAA,EAAM,SAAoB,IAAI,CAAA;AAC7D,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAC,CAAA;AACnB,IAAA,OAAO,CAAA;AAAA,EACT;AAAA,EAEA,OAAgB,EAAA,EAAgC;AAC9C,IAAA,MAAM,MAAM,IAAA,CAAK,MAAA,CACd,QAAQ,CAAA,gCAAA,CAAkC,CAAA,CAC1C,IAAI,EAAE,CAAA;AACT,IAAA,OAAO,GAAA,GAAO,WAAA,CAAY,GAAG,CAAA,GAAe,MAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,OAAO,IAAA,EAA0C;AAC/C,IAAA,MAAM,IAAA,GACJ,IAAA,GACI,IAAA,CAAK,MAAA,CACF,OAAA;AAAA,MACC,CAAA,uEAAA;AAAA,KACF,CACC,IAAI,IAAI,CAAA,GACX,KAAK,MAAA,CACF,OAAA,CAAQ,CAAA,uDAAA,CAAyD,CAAA,CACjE,GAAA,EAAI;AAEb,IAAA,MAAM,GAAA,GAAiC;AAAA,MACrC,OAAA,EAAS,CAAA;AAAA,MACT,MAAA,EAAQ,CAAA;AAAA,MACR,IAAA,EAAM,CAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AACA,IAAA,KAAA,MAAW,KAAK,IAAA,EAAM,GAAA,CAAI,CAAA,CAAE,MAAM,IAAI,CAAA,CAAE,CAAA;AACxC,IAAA,OAAO,GAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAA,CAAQ,cAAc,GAAA,EAAgB;AACpC,IAAA,OAAO,KAAK,MAAA,CACT,OAAA;AAAA,MACC,CAAA;AAAA,iDAAA;AAAA,MAGD,GAAA,CAAI,GAAA,IAAO,GAAA,EAAI,GAAI,WAAW,CAAA,CAAE,OAAA;AAAA,EACrC;AAAA;AAAA,EAGA,MAAM,KAAA,GAAuB;AAC3B,IAAA,MAAM,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,cAAc,IAAA,EAA0B;AACtC,IAAA,MAAM,IAAI,GAAA,EAAI;AACd,IAAA,MAAM,GAAA,GAAM,KAAK,MAAA,CACd,OAAA;AAAA,MACC,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAA;AAAA,MAQD,GAAA,CAAI,IAAA,CAAK,QAAA,EAAU,CAAA,EAAG,MAAM,CAAC,CAAA;AAChC,IAAA,OAAO,GAAA,GAAM,WAAA,CAAY,GAAG,CAAA,GAAI,IAAA;AAAA,EAClC;AAAA;AAAA,EAGA,gBAAA,CAAiB,KAAU,MAAA,EAAuB;AAChD,IAAA,IAAI,KAAK,gBAAA,EAAkB;AACzB,MAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,CAAA,8BAAA,CAAgC,CAAA,CAAE,GAAA,CAAI,IAAI,EAAE,CAAA;AAAA,IAClE,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,MAAA,CACF,OAAA;AAAA,QACC,CAAA,6EAAA;AAAA,OACF,CACC,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,MAAA,IAAU,IAAI,CAAA,EAAG,GAAA,EAAI,EAAG,GAAA,CAAI,EAAE,CAAA;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGA,YAAA,CAAa,KAAU,GAAA,EAAoB;AAEzC,IAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,IAAA,IAAI,GAAA,CAAI,QAAA,GAAW,GAAA,CAAI,WAAA,EAAa;AAClC,MAAA,IAAA,CAAK,MAAA,CACF,OAAA;AAAA,QACC,CAAA,6FAAA;AAAA,OACF,CACC,GAAA,CAAI,GAAA,EAAI,GAAI,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,QAAQ,CAAA,EAAG,OAAA,EAAS,GAAA,EAAI,EAAG,IAAI,EAAE,CAAA;AAAA,IACnE,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,MAAA,CACF,OAAA;AAAA,QACC,CAAA,kEAAA;AAAA,QAED,GAAA,CAAI,OAAA,EAAS,GAAA,EAAI,EAAG,IAAI,EAAE,CAAA;AAAA,IAC/B;AAAA,EACF;AACF;AAGO,SAAS,WAAA,CAAY,IAAa,IAAA,EAA4B;AACnE,EAAA,OAAO,IAAI,KAAA,CAAM,EAAA,EAAI,IAAI,CAAA;AAC3B","file":"index.js","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport type { Monlite } from \"@monlite/core\";\n\nexport type JobStatus = \"pending\" | \"active\" | \"done\" | \"failed\";\n\nexport interface Job<T = any> {\n  id: number;\n  queue: string;\n  status: JobStatus;\n  priority: number;\n  payload: T;\n  /** Number of attempts already made (0 until the first run). */\n  attempts: number;\n  maxAttempts: number;\n  runAt: number;\n  result?: any;\n  error?: string;\n  createdAt: number;\n  updatedAt: number;\n}\n\nexport interface AddOptions {\n  /** Delay before the job becomes runnable (ms). */\n  delay?: number;\n  /** Explicit epoch-ms run time (overrides `delay`). */\n  runAt?: number;\n  /** Higher runs first. Default 0. */\n  priority?: number;\n  /** Total attempts before dead-lettering. Default: the queue's `maxAttempts`. */\n  maxAttempts?: number;\n}\n\nexport interface ProcessOptions {\n  /** Jobs run concurrently per worker. Default 1. */\n  concurrency?: number;\n  /** How often to poll for due jobs when idle (ms). Default 500. */\n  pollInterval?: number;\n}\n\nexport interface QueueOptions {\n  /** Default attempts before dead-lettering. Default 1 (no retry). */\n  maxAttempts?: number;\n  /** Backoff before retry N (ms). Default: exponential, capped at 30s. */\n  backoff?: (attempt: number) => number;\n  /** Delete jobs once completed instead of keeping them as `done`. Default false. */\n  removeOnComplete?: boolean;\n  /** Identifies this worker process in the `locked_by` column. */\n  workerId?: string;\n}\n\nexport type Handler<T = any, R = any> = (job: Job<T>) => Promise<R> | R;\n\nexport interface Worker {\n  /** Stop claiming new jobs and wait for in-flight ones to finish. */\n  stop(): Promise<void>;\n}\n\ninterface Row {\n  id: number;\n  queue: string;\n  status: JobStatus;\n  priority: number;\n  run_at: number;\n  attempts: number;\n  max_attempts: number;\n  payload: string;\n  result: string | null;\n  error: string | null;\n  created_at: number;\n  updated_at: number;\n}\n\nconst ensured = new WeakSet<object>();\nconst now = () => Date.now();\nconst defaultBackoff = (attempt: number) =>\n  Math.min(30_000, 1000 * 2 ** (attempt - 1));\n\nfunction deserialize(row: Row): Job {\n  return {\n    id: row.id,\n    queue: row.queue,\n    status: row.status,\n    priority: row.priority,\n    payload: JSON.parse(row.payload),\n    attempts: row.attempts,\n    maxAttempts: row.max_attempts,\n    runAt: row.run_at,\n    result: row.result != null ? JSON.parse(row.result) : undefined,\n    error: row.error ?? undefined,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n  };\n}\n\nclass WorkerImpl implements Worker {\n  private running = true;\n  private inFlight = 0;\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private drainResolve: (() => void) | undefined;\n  private readonly concurrency: number;\n  private readonly pollInterval: number;\n\n  constructor(\n    private readonly q: Queue,\n    readonly name: string,\n    private readonly handler: Handler,\n    opts: ProcessOptions,\n  ) {\n    this.concurrency = Math.max(1, opts.concurrency ?? 1);\n    this.pollInterval = opts.pollInterval ?? 500;\n    this.kick();\n  }\n\n  /** Fill spare capacity with claimable jobs; otherwise schedule a poll. */\n  kick(): void {\n    if (!this.running) return;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = undefined;\n    }\n    while (this.running && this.inFlight < this.concurrency) {\n      const job = this.q.claimInternal(this.name);\n      if (!job) break;\n      this.inFlight++;\n      Promise.resolve()\n        .then(() => this.handler(job))\n        .then(\n          (result) => {\n            this.q.completeInternal(job, result);\n            this.q.emit(\"completed\", job, result);\n          },\n          (err) => {\n            this.q.failInternal(job, err);\n            this.q.emit(\"failed\", job, err);\n          },\n        )\n        .finally(() => {\n          this.inFlight--;\n          if (this.running) this.kick();\n          else this.checkDrained();\n        });\n    }\n    if (this.running && this.inFlight < this.concurrency) {\n      this.timer = setTimeout(() => this.kick(), this.pollInterval);\n      this.timer.unref?.();\n    }\n  }\n\n  private checkDrained(): void {\n    if (!this.running && this.inFlight === 0 && this.drainResolve) {\n      this.drainResolve();\n      this.drainResolve = undefined;\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.running = false;\n    if (this.timer) clearTimeout(this.timer);\n    if (this.inFlight === 0) return;\n    await new Promise<void>((resolve) => {\n      this.drainResolve = resolve;\n    });\n  }\n}\n\n/**\n * A durable, multi-process-safe job queue backed by SQLite. Producers `add`\n * jobs; workers `process` them with retries, backoff, delays, and concurrency.\n * Emits `\"completed\"` (job, result) and `\"failed\"` (job, error).\n */\nexport class Queue extends EventEmitter {\n  private readonly driver: Monlite[\"driver\"];\n  private readonly maxAttempts: number;\n  private readonly backoff: (attempt: number) => number;\n  private readonly removeOnComplete: boolean;\n  readonly workerId: string;\n  private readonly workers: WorkerImpl[] = [];\n\n  constructor(db: Monlite, opts: QueueOptions = {}) {\n    super();\n    this.driver = db.driver;\n    this.maxAttempts = opts.maxAttempts ?? 1;\n    this.backoff = opts.backoff ?? defaultBackoff;\n    this.removeOnComplete = opts.removeOnComplete ?? false;\n    this.workerId = opts.workerId ?? `w-${process.pid}`;\n\n    if (!ensured.has(db)) {\n      this.driver.exec(\n        `CREATE TABLE IF NOT EXISTS _jobs (\n          id INTEGER PRIMARY KEY AUTOINCREMENT,\n          queue TEXT NOT NULL, status TEXT NOT NULL, priority INTEGER NOT NULL,\n          run_at INTEGER NOT NULL, attempts INTEGER NOT NULL, max_attempts INTEGER NOT NULL,\n          payload TEXT NOT NULL, result TEXT, error TEXT, locked_by TEXT,\n          created_at INTEGER NOT NULL, updated_at INTEGER NOT NULL\n        )`,\n      );\n      this.driver.exec(\n        `CREATE INDEX IF NOT EXISTS _jobs_claim ON _jobs (queue, status, priority, run_at)`,\n      );\n      ensured.add(db);\n    }\n  }\n\n  /** Enqueue a job. */\n  add<T = any>(name: string, payload: T, opts: AddOptions = {}): Job<T> {\n    const t = now();\n    const runAt = opts.runAt ?? (opts.delay ? t + opts.delay : t);\n    const info = this.driver\n      .prepare(\n        `INSERT INTO _jobs (queue, status, priority, run_at, attempts, max_attempts, payload, created_at, updated_at)\n         VALUES (?, 'pending', ?, ?, 0, ?, ?, ?, ?)`,\n      )\n      .run(\n        name,\n        opts.priority ?? 0,\n        runAt,\n        opts.maxAttempts ?? this.maxAttempts,\n        JSON.stringify(payload ?? null),\n        t,\n        t,\n      );\n    const job = this.getJob(Number(info.lastInsertRowid))!;\n    for (const w of this.workers) if (w.name === name) w.kick();\n    return job as Job<T>;\n  }\n\n  /** Register a worker for a queue. Returns a handle with `stop()`. */\n  process<T = any, R = any>(\n    name: string,\n    handler: Handler<T, R>,\n    opts: ProcessOptions = {},\n  ): Worker {\n    const w = new WorkerImpl(this, name, handler as Handler, opts);\n    this.workers.push(w);\n    return w;\n  }\n\n  getJob<T = any>(id: number): Job<T> | undefined {\n    const row = this.driver\n      .prepare(`SELECT * FROM _jobs WHERE id = ?`)\n      .get(id) as Row | undefined;\n    return row ? (deserialize(row) as Job<T>) : undefined;\n  }\n\n  /** Count jobs by status (optionally for one queue). */\n  counts(name?: string): Record<JobStatus, number> {\n    const rows = (\n      name\n        ? this.driver\n            .prepare(\n              `SELECT status, COUNT(*) AS n FROM _jobs WHERE queue = ? GROUP BY status`,\n            )\n            .all(name)\n        : this.driver\n            .prepare(`SELECT status, COUNT(*) AS n FROM _jobs GROUP BY status`)\n            .all()\n    ) as Array<{ status: JobStatus; n: number }>;\n    const out: Record<JobStatus, number> = {\n      pending: 0,\n      active: 0,\n      done: 0,\n      failed: 0,\n    };\n    for (const r of rows) out[r.status] = r.n;\n    return out;\n  }\n\n  /**\n   * Reset jobs stuck in `active` (e.g. from a crashed worker) back to `pending`\n   * if they haven't been touched in `olderThanMs`. Returns the count recovered.\n   */\n  recover(olderThanMs = 60_000): number {\n    return this.driver\n      .prepare(\n        `UPDATE _jobs SET status='pending', locked_by=NULL, updated_at=?\n         WHERE status='active' AND updated_at < ?`,\n      )\n      .run(now(), now() - olderThanMs).changes;\n  }\n\n  /** Stop all workers and wait for in-flight jobs to finish. */\n  async close(): Promise<void> {\n    await Promise.all(this.workers.map((w) => w.stop()));\n  }\n\n  /** @internal Atomically claim the next due job, counting the attempt. */\n  claimInternal(name: string): Job | null {\n    const t = now();\n    const row = this.driver\n      .prepare(\n        `UPDATE _jobs SET status='active', attempts=attempts+1, locked_by=?, updated_at=?\n         WHERE id = (\n           SELECT id FROM _jobs\n           WHERE queue=? AND status='pending' AND run_at<=?\n           ORDER BY priority DESC, id ASC LIMIT 1\n         )\n         RETURNING *`,\n      )\n      .get(this.workerId, t, name, t) as Row | undefined;\n    return row ? deserialize(row) : null;\n  }\n\n  /** @internal */\n  completeInternal(job: Job, result: unknown): void {\n    if (this.removeOnComplete) {\n      this.driver.prepare(`DELETE FROM _jobs WHERE id = ?`).run(job.id);\n    } else {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='done', result=?, error=NULL, updated_at=? WHERE id=?`,\n        )\n        .run(JSON.stringify(result ?? null), now(), job.id);\n    }\n  }\n\n  /** @internal */\n  failInternal(job: Job, err: unknown): void {\n    // `job.attempts` was already incremented at claim time.\n    const message = err instanceof Error ? err.message : String(err);\n    if (job.attempts < job.maxAttempts) {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='pending', run_at=?, error=?, locked_by=NULL, updated_at=? WHERE id=?`,\n        )\n        .run(now() + this.backoff(job.attempts), message, now(), job.id);\n    } else {\n      this.driver\n        .prepare(\n          `UPDATE _jobs SET status='failed', error=?, updated_at=? WHERE id=?`,\n        )\n        .run(message, now(), job.id);\n    }\n  }\n}\n\n/** Create a job queue over a monlite database. */\nexport function createQueue(db: Monlite, opts?: QueueOptions): Queue {\n  return new Queue(db, opts);\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@monlite/queue",
+  "version": "0.1.0",
+  "description": "Durable job queue for @monlite/core: retries, backoff, delayed jobs, concurrency — on SQLite.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "monlite",
+    "queue",
+    "jobs",
+    "worker",
+    "bullmq",
+    "tasks",
+    "sqlite"
+  ],
+  "license": "MIT",
+  "author": "Emad Jumaah <emadjumaah@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qataruts/monlite.git",
+    "directory": "packages/kv"
+  },
+  "homepage": "https://github.com/qataruts/monlite/tree/main/packages/kv#readme",
+  "bugs": {
+    "url": "https://github.com/qataruts/monlite/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@monlite/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "better-sqlite3": "^11.8.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}