onequeue 0.0.1 → 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# ⚡ OneQueue
+
+**Background jobs in one line. Production-ready by default.**
+
+OneQueue is a modern background job framework for Node.js that removes the pain of queues, workers, retries, and scheduling. Define jobs in one line and let OneQueue handle the rest.
+
+---
+
+## ✨ Why OneQueue?
+
+Traditional job queues require:
+
+- Redis setup
+- worker wiring
+- retry plumbing
+- cron configuration
+- dashboard setup
+
+**OneQueue gives you all of this with zero config.**
+
+---
+
+## 🚀 Quick Start (30 seconds)
+
+### Install
+
+```bash
+npm install onequeue
+```
+
+### Define a job
+
+```javascript
+import { job } from "onequeue";
+
+job("sendWelcomeEmail", async (user) => {
+  await email.send(user.email);
+});
+```
+
+### Enqueue work
+
+```javascript
+import { enqueue } from "onequeue";
+
+await enqueue("sendWelcomeEmail", {
+  email: "raj@example.com",
+});
+```
+
+### Done. Background processing is live.
+
+## 🧠 Features
+
+- ⚡ One-line job definition
+- 🔁 Automatic retries with backoff
+- ⏱️ Human-friendly delays ("10s", "5m")
+- 💾 SQLite persistence (jobs survive restarts)
+- 🧵 Concurrency control
+- 📊 Live dev dashboard
+- 🛑 Graceful shutdown
+- 🔒 Zero-config by default
+- 🧩 TypeScript-first
+
+## ⏳ Delayed Jobs
+
+```javascript
+await enqueue("sendEmail", payload, {
+  delay: "10s",
+});
+```
+
+Supports:
+
+- `"500ms"`
+- `"10s"`
+- `"5m"`
+- `"1h"`
+
+## 🔁 Retries
+
+```javascript
+job("unstableTask", handler, {
+  retries: 3,
+  backoffMs: 1000,
+});
+```
+
+OneQueue automatically retries failed jobs with exponential backoff.
+
+## 🧵 Concurrency
+
+```javascript
+import { configure } from "onequeue";
+
+configure({ concurrency: 5 });
+```
+
+## 📊 Dev Dashboard
+
+Run locally:
+
+```bash
+npx onequeue dev
+```
+
+Open:
+
+```
+http://localhost:3210
+```
+
+Monitor:
+
+- queued jobs
+- running jobs
+- completed jobs
+- failed jobs
+
+Live updates included.
+
+## 🛑 Graceful Shutdown
+
+OneQueue automatically handles:
+
+- SIGINT
+- SIGTERM
+- draining active jobs
+- clean worker exit
+
+Safe for deploy restarts and containers.
+
+## 🏗️ Philosophy
+
+OneQueue is built around a simple idea:
+
+Background jobs should be boring to set up and reliable by default.
+
+The goal is to provide Express-level simplicity for background processing while remaining production-capable.
+
+## 🚧 Roadmap
+
+- [ ] Redis adapter
+- [ ] Distributed workers
+- [ ] Job priorities
+- [ ] Rate limiting
+- [ ] Production dashboard
+
+## 🤝 Contributing
+
+PRs and feedback are welcome. If you build something cool with OneQueue, open an issue or share it.
+
+## 📄 License
+
+MIT

package/dist/chunk-CKCBPWXR.js

@@ -0,0 +1,21 @@
+// src/db.ts
+import Database from "better-sqlite3";
+var db = new Database("onequeue.db");
+db.exec(`
+  CREATE TABLE IF NOT EXISTS jobs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    attempts INTEGER NOT NULL,
+    runAt INTEGER NOT NULL,
+    status TEXT NOT NULL DEFAULT 'queued',
+    startedAt INTEGER,
+    finishedAt INTEGER,
+    error TEXT
+  );
+`);
+var db_default = db;
+
+export {
+  db_default
+};

package/dist/chunk-FZMBGSEZ.js

@@ -0,0 +1,17 @@
+// src/db.ts
+import Database from "better-sqlite3";
+var db = new Database("onequeue.db");
+db.exec(`
+  CREATE TABLE IF NOT EXISTS jobs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    attempts INTEGER NOT NULL,
+    runAt INTEGER NOT NULL
+  );
+`);
+var db_default = db;
+
+export {
+  db_default
+};

package/dist/cli.cjs

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/dev.ts
+var import_node_http = __toESM(require("http"), 1);
+
+// src/db.ts
+var import_better_sqlite3 = __toESM(require("better-sqlite3"), 1);
+var db = new import_better_sqlite3.default("onequeue.db");
+db.exec(`
+  CREATE TABLE IF NOT EXISTS jobs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    attempts INTEGER NOT NULL,
+    runAt INTEGER NOT NULL,
+    status TEXT NOT NULL DEFAULT 'queued',
+    startedAt INTEGER,
+    finishedAt INTEGER,
+    error TEXT
+  );
+`);
+var db_default = db;
+
+// src/dev.ts
+var PORT = 3210;
+function getStats() {
+  const total = db_default.prepare(`SELECT COUNT(*) as c FROM jobs`).get();
+  const scheduled = db_default.prepare(`SELECT COUNT(*) as c FROM jobs WHERE runAt > ?`).get(Date.now());
+  return {
+    total: total.c,
+    scheduled: scheduled.c
+  };
+}
+function getJobs() {
+  return db_default.prepare(
+    `
+      SELECT id, name, attempts, runAt, status
+      FROM jobs
+      ORDER BY id DESC
+      LIMIT 50
+    `
+  ).all();
+}
+var server = import_node_http.default.createServer((req, res) => {
+  if (req.url === "/api/jobs") {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(getJobs()));
+    return;
+  }
+  if (req.url === "/api/stats") {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(getStats()));
+    return;
+  }
+  res.setHeader("Content-Type", "text/html");
+  res.end(`
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8" />
+  <title>OneQueue Dev</title>
+  <style>
+    :root {
+      --bg: #0b0f17;
+      --card: #121826;
+      --border: #1f2937;
+      --text: #e5e7eb;
+      --muted: #9ca3af;
+      --accent: #6366f1;
+      --accent2: #22c55e;
+    }
+
+    * { box-sizing: border-box; }
+
+    body {
+      margin: 0;
+      font-family: ui-sans-serif, system-ui, -apple-system;
+      background: radial-gradient(circle at top, #111827, #020617);
+      color: var(--text);
+      padding: 40px;
+    }
+
+    .container {
+      max-width: 1100px;
+      margin: 0 auto;
+    }
+
+    .header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      margin-bottom: 28px;
+    }
+
+    .title {
+      font-size: 32px;
+      font-weight: 700;
+      letter-spacing: -0.02em;
+    }
+
+    .live {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 14px;
+      color: var(--muted);
+    }
+
+    .dot {
+      width: 10px;
+      height: 10px;
+      background: var(--accent2);
+      border-radius: 50%;
+      box-shadow: 0 0 12px var(--accent2);
+      animation: pulse 1.5s infinite;
+    }
+
+    @keyframes pulse {
+      0% { opacity: 1; }
+      50% { opacity: 0.4; }
+      100% { opacity: 1; }
+    }
+
+    .stats {
+      display: grid;
+      grid-template-columns: repeat(2, 1fr);
+      gap: 16px;
+      margin-bottom: 28px;
+    }
+
+    .card {
+      background: linear-gradient(180deg, #121826, #0f172a);
+      border: 1px solid var(--border);
+      border-radius: 16px;
+      padding: 20px;
+      box-shadow: 0 10px 30px rgba(0,0,0,0.35);
+    }
+
+    .stat-label {
+      color: var(--muted);
+      font-size: 13px;
+      margin-bottom: 6px;
+    }
+
+    .stat-value {
+      font-size: 28px;
+      font-weight: 700;
+    }
+
+    .table-card h3 {
+      margin-top: 0;
+      margin-bottom: 14px;
+    }
+
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      font-size: 14px;
+    }
+
+    th {
+      text-align: left;
+      color: var(--muted);
+      font-weight: 500;
+      padding: 10px 8px;
+      border-bottom: 1px solid var(--border);
+    }
+
+    td {
+      padding: 12px 8px;
+      border-bottom: 1px solid #111827;
+    }
+
+    tr:hover td {
+      background: rgba(99,102,241,0.06);
+    }
+
+    .footer {
+      margin-top: 18px;
+      font-size: 12px;
+      color: var(--muted);
+      text-align: right;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <div class="title">\u26A1 OneQueue Dev</div>
+      <div class="live">
+        <div class="dot"></div>
+        live
+      </div>
+    </div>
+
+    <div class="stats">
+      <div class="card">
+        <div class="stat-label">Total Jobs</div>
+        <div id="total" class="stat-value">\u2014</div>
+      </div>
+      <div class="card">
+        <div class="stat-label">Scheduled</div>
+        <div id="scheduled" class="stat-value">\u2014</div>
+      </div>
+    </div>
+
+    <div class="card table-card">
+      <h3>Recent Jobs</h3>
+      <table id="jobs"></table>
+    </div>
+
+    <div class="footer">
+      OneQueue Dev Dashboard
+    </div>
+  </div>
+
+  <script>
+    async function load() {
+      const stats = await fetch('/api/stats').then(r => r.json());
+      const jobs = await fetch('/api/jobs').then(r => r.json());
+
+      document.getElementById('total').textContent = stats.total;
+      document.getElementById('scheduled').textContent = stats.scheduled;
+
+      const table = document.getElementById('jobs');
+      table.innerHTML =
+        '<tr><th>ID</th><th>Name</th><th>Status</th><th>Attempts</th><th>Run At</th></tr>' +
+        jobs.map(j =>
+            '<tr>' +
+            '<td>' + j.id + '</td>' +
+            '<td>' + j.name + '</td>' +
+            '<td>' + j.status + '</td>' +
+            '<td>' + j.attempts + '</td>' +
+            '<td>' + new Date(j.runAt).toLocaleTimeString() + '</td>' +
+            '</tr>'
+        ).join('');
+    }
+
+    load();
+    setInterval(load, 1000);
+  </script>
+</body>
+</html>
+`);
+});
+function startDevServer() {
+  server.listen(PORT, () => {
+    console.log(`\u26A1 OneQueue Dev running at http://localhost:${PORT}`);
+  });
+}
+
+// src/cli.ts
+var cmd = process.argv[2];
+if (cmd === "dev") {
+  startDevServer();
+} else {
+  console.log("OneQueue CLI");
+}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+import {
+  db_default
+} from "./chunk-CKCBPWXR.js";
+
+// src/dev.ts
+import http from "http";
+var PORT = 3210;
+function getStats() {
+  const total = db_default.prepare(`SELECT COUNT(*) as c FROM jobs`).get();
+  const scheduled = db_default.prepare(`SELECT COUNT(*) as c FROM jobs WHERE runAt > ?`).get(Date.now());
+  return {
+    total: total.c,
+    scheduled: scheduled.c
+  };
+}
+function getJobs() {
+  return db_default.prepare(
+    `
+      SELECT id, name, attempts, runAt, status
+      FROM jobs
+      ORDER BY id DESC
+      LIMIT 50
+    `
+  ).all();
+}
+var server = http.createServer((req, res) => {
+  if (req.url === "/api/jobs") {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(getJobs()));
+    return;
+  }
+  if (req.url === "/api/stats") {
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(getStats()));
+    return;
+  }
+  res.setHeader("Content-Type", "text/html");
+  res.end(`
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8" />
+  <title>OneQueue Dev</title>
+  <style>
+    :root {
+      --bg: #0b0f17;
+      --card: #121826;
+      --border: #1f2937;
+      --text: #e5e7eb;
+      --muted: #9ca3af;
+      --accent: #6366f1;
+      --accent2: #22c55e;
+    }
+
+    * { box-sizing: border-box; }
+
+    body {
+      margin: 0;
+      font-family: ui-sans-serif, system-ui, -apple-system;
+      background: radial-gradient(circle at top, #111827, #020617);
+      color: var(--text);
+      padding: 40px;
+    }
+
+    .container {
+      max-width: 1100px;
+      margin: 0 auto;
+    }
+
+    .header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      margin-bottom: 28px;
+    }
+
+    .title {
+      font-size: 32px;
+      font-weight: 700;
+      letter-spacing: -0.02em;
+    }
+
+    .live {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 14px;
+      color: var(--muted);
+    }
+
+    .dot {
+      width: 10px;
+      height: 10px;
+      background: var(--accent2);
+      border-radius: 50%;
+      box-shadow: 0 0 12px var(--accent2);
+      animation: pulse 1.5s infinite;
+    }
+
+    @keyframes pulse {
+      0% { opacity: 1; }
+      50% { opacity: 0.4; }
+      100% { opacity: 1; }
+    }
+
+    .stats {
+      display: grid;
+      grid-template-columns: repeat(2, 1fr);
+      gap: 16px;
+      margin-bottom: 28px;
+    }
+
+    .card {
+      background: linear-gradient(180deg, #121826, #0f172a);
+      border: 1px solid var(--border);
+      border-radius: 16px;
+      padding: 20px;
+      box-shadow: 0 10px 30px rgba(0,0,0,0.35);
+    }
+
+    .stat-label {
+      color: var(--muted);
+      font-size: 13px;
+      margin-bottom: 6px;
+    }
+
+    .stat-value {
+      font-size: 28px;
+      font-weight: 700;
+    }
+
+    .table-card h3 {
+      margin-top: 0;
+      margin-bottom: 14px;
+    }
+
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      font-size: 14px;
+    }
+
+    th {
+      text-align: left;
+      color: var(--muted);
+      font-weight: 500;
+      padding: 10px 8px;
+      border-bottom: 1px solid var(--border);
+    }
+
+    td {
+      padding: 12px 8px;
+      border-bottom: 1px solid #111827;
+    }
+
+    tr:hover td {
+      background: rgba(99,102,241,0.06);
+    }
+
+    .footer {
+      margin-top: 18px;
+      font-size: 12px;
+      color: var(--muted);
+      text-align: right;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <div class="title">\u26A1 OneQueue Dev</div>
+      <div class="live">
+        <div class="dot"></div>
+        live
+      </div>
+    </div>
+
+    <div class="stats">
+      <div class="card">
+        <div class="stat-label">Total Jobs</div>
+        <div id="total" class="stat-value">\u2014</div>
+      </div>
+      <div class="card">
+        <div class="stat-label">Scheduled</div>
+        <div id="scheduled" class="stat-value">\u2014</div>
+      </div>
+    </div>
+
+    <div class="card table-card">
+      <h3>Recent Jobs</h3>
+      <table id="jobs"></table>
+    </div>
+
+    <div class="footer">
+      OneQueue Dev Dashboard
+    </div>
+  </div>
+
+  <script>
+    async function load() {
+      const stats = await fetch('/api/stats').then(r => r.json());
+      const jobs = await fetch('/api/jobs').then(r => r.json());
+
+      document.getElementById('total').textContent = stats.total;
+      document.getElementById('scheduled').textContent = stats.scheduled;
+
+      const table = document.getElementById('jobs');
+      table.innerHTML =
+        '<tr><th>ID</th><th>Name</th><th>Status</th><th>Attempts</th><th>Run At</th></tr>' +
+        jobs.map(j =>
+            '<tr>' +
+            '<td>' + j.id + '</td>' +
+            '<td>' + j.name + '</td>' +
+            '<td>' + j.status + '</td>' +
+            '<td>' + j.attempts + '</td>' +
+            '<td>' + new Date(j.runAt).toLocaleTimeString() + '</td>' +
+            '</tr>'
+        ).join('');
+    }
+
+    load();
+    setInterval(load, 1000);
+  </script>
+</body>
+</html>
+`);
+});
+function startDevServer() {
+  server.listen(PORT, () => {
+    console.log(`\u26A1 OneQueue Dev running at http://localhost:${PORT}`);
+  });
+}
+
+// src/cli.ts
+var cmd = process.argv[2];
+if (cmd === "dev") {
+  startDevServer();
+} else {
+  console.log("OneQueue CLI");
+}

package/dist/index.cjs

@@ -0,0 +1,199 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  configure: () => configure,
+  enqueue: () => enqueue,
+  job: () => job,
+  shutdown: () => shutdown
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/db.ts
+var import_better_sqlite3 = __toESM(require("better-sqlite3"), 1);
+var db = new import_better_sqlite3.default("onequeue.db");
+db.exec(`
+  CREATE TABLE IF NOT EXISTS jobs (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    payload TEXT NOT NULL,
+    attempts INTEGER NOT NULL,
+    runAt INTEGER NOT NULL,
+    status TEXT NOT NULL DEFAULT 'queued',
+    startedAt INTEGER,
+    finishedAt INTEGER,
+    error TEXT
+  );
+`);
+var db_default = db;
+
+// src/index.ts
+var registry = /* @__PURE__ */ new Map();
+var isWorkerRunning = false;
+var concurrency = 1;
+var activeCount = 0;
+var isShuttingDown = false;
+function job(name, handler, options = {}) {
+  if (registry.has(name)) {
+    throw new Error(`Job "${name}" is already registered`);
+  }
+  registry.set(name, {
+    handler,
+    options: {
+      retries: options.retries ?? 0,
+      backoffMs: options.backoffMs ?? 1e3
+    }
+  });
+  startWorker();
+}
+async function enqueue(name, payload, options = {}) {
+  if (!registry.has(name)) {
+    throw new Error(`Job "${name}" is not registered`);
+  }
+  const delayMs = parseDelay(options.delay);
+  db_default.prepare(
+    `INSERT INTO jobs (name, payload, attempts, runAt, status)
+   VALUES (?, ?, ?, ?, 'queued')`
+  ).run(name, JSON.stringify(payload), 0, Date.now() + delayMs);
+}
+function configure(options) {
+  if (options.concurrency && options.concurrency > 0) {
+    concurrency = options.concurrency;
+  }
+}
+function startWorker() {
+  if (isWorkerRunning) return;
+  isWorkerRunning = true;
+  setInterval(processQueue, 50);
+}
+async function processQueue() {
+  if (isShuttingDown) return;
+  if (activeCount >= concurrency) return;
+  const row = db_default.prepare(
+    `SELECT * FROM jobs
+     WHERE status = 'queued'
+     AND runAt <= ?
+     ORDER BY id ASC
+     LIMIT 1`
+  ).get(Date.now());
+  if (!row) return;
+  const def = registry.get(row.name);
+  if (!def) return;
+  db_default.prepare(
+    `UPDATE jobs
+   SET status = 'running',
+       startedAt = ?
+   WHERE id = ?`
+  ).run(Date.now(), row.id);
+  activeCount++;
+  try {
+    await def.handler(JSON.parse(row.payload));
+    db_default.prepare(
+      `UPDATE jobs
+   SET status = 'completed',
+       finishedAt = ?
+   WHERE id = ?`
+    ).run(Date.now(), row.id);
+  } catch (err) {
+    await handleRetry(row, def);
+  } finally {
+    activeCount--;
+  }
+}
+async function handleRetry(row, def) {
+  const attempts = row.attempts + 1;
+  const { retries, backoffMs } = def.options;
+  if (attempts > retries) {
+    db_default.prepare(
+      `UPDATE jobs
+     SET status = 'failed',
+         finishedAt = ?,
+         error = ?
+     WHERE id = ?`
+    ).run(Date.now(), String(row.error ?? "Unknown error"), row.id);
+    return;
+  }
+  const delay = backoffMs * attempts;
+  db_default.prepare(
+    `UPDATE jobs
+   SET attempts = ?,
+       runAt = ?,
+       status = 'queued'
+   WHERE id = ?`
+  ).run(attempts, Date.now() + delay, row.id);
+}
+function parseDelay(delay) {
+  if (!delay) return 0;
+  if (typeof delay === "number") return delay;
+  const match = /^(\d+)(ms|s|m|h)?$/.exec(delay.trim());
+  if (!match) {
+    throw new Error(`[OneQueue] Invalid delay format: ${delay}`);
+  }
+  const value = Number(match[1]);
+  const unit = match[2] ?? "ms";
+  switch (unit) {
+    case "ms":
+      return value;
+    case "s":
+      return value * 1e3;
+    case "m":
+      return value * 6e4;
+    case "h":
+      return value * 36e5;
+    default:
+      return value;
+  }
+}
+async function shutdown() {
+  if (isShuttingDown) return;
+  console.log("[OneQueue] Graceful shutdown started\u2026");
+  isShuttingDown = true;
+  while (activeCount > 0) {
+    await new Promise((r) => setTimeout(r, 50));
+  }
+  console.log("[OneQueue] All jobs finished. Exiting cleanly.");
+}
+function setupSignalHandlers() {
+  const handler = async () => {
+    await shutdown();
+    process.exit(0);
+  };
+  process.once("SIGINT", handler);
+  process.once("SIGTERM", handler);
+}
+setupSignalHandlers();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  configure,
+  enqueue,
+  job,
+  shutdown
+});

package/dist/index.d.cts

@@ -0,0 +1,25 @@
+type JobHandler<T = any> = (payload: T) => Promise<void> | void;
+type JobOptions = {
+    retries?: number;
+    backoffMs?: number;
+};
+type EnqueueOptions = {
+    delay?: number | string;
+};
+/**
+ * Register a job
+ */
+declare function job<T = any>(name: string, handler: JobHandler<T>, options?: JobOptions): void;
+/**
+ * Enqueue job (persistent)
+ */
+declare function enqueue<T = any>(name: string, payload: T, options?: EnqueueOptions): Promise<void>;
+/**
+ * Configure
+ */
+declare function configure(options: {
+    concurrency?: number;
+}): void;
+declare function shutdown(): Promise<void>;
+
+export { configure, enqueue, job, shutdown };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+type JobHandler<T = any> = (payload: T) => Promise<void> | void;
+type JobOptions = {
+    retries?: number;
+    backoffMs?: number;
+};
+type EnqueueOptions = {
+    delay?: number | string;
+};
+/**
+ * Register a job
+ */
+declare function job<T = any>(name: string, handler: JobHandler<T>, options?: JobOptions): void;
+/**
+ * Enqueue job (persistent)
+ */
+declare function enqueue<T = any>(name: string, payload: T, options?: EnqueueOptions): Promise<void>;
+/**
+ * Configure
+ */
+declare function configure(options: {
+    concurrency?: number;
+}): void;
+declare function shutdown(): Promise<void>;
+
+export { configure, enqueue, job, shutdown };

package/dist/index.js

@@ -0,0 +1,145 @@
+import {
+  db_default
+} from "./chunk-CKCBPWXR.js";
+
+// src/index.ts
+var registry = /* @__PURE__ */ new Map();
+var isWorkerRunning = false;
+var concurrency = 1;
+var activeCount = 0;
+var isShuttingDown = false;
+function job(name, handler, options = {}) {
+  if (registry.has(name)) {
+    throw new Error(`Job "${name}" is already registered`);
+  }
+  registry.set(name, {
+    handler,
+    options: {
+      retries: options.retries ?? 0,
+      backoffMs: options.backoffMs ?? 1e3
+    }
+  });
+  startWorker();
+}
+async function enqueue(name, payload, options = {}) {
+  if (!registry.has(name)) {
+    throw new Error(`Job "${name}" is not registered`);
+  }
+  const delayMs = parseDelay(options.delay);
+  db_default.prepare(
+    `INSERT INTO jobs (name, payload, attempts, runAt, status)
+   VALUES (?, ?, ?, ?, 'queued')`
+  ).run(name, JSON.stringify(payload), 0, Date.now() + delayMs);
+}
+function configure(options) {
+  if (options.concurrency && options.concurrency > 0) {
+    concurrency = options.concurrency;
+  }
+}
+function startWorker() {
+  if (isWorkerRunning) return;
+  isWorkerRunning = true;
+  setInterval(processQueue, 50);
+}
+async function processQueue() {
+  if (isShuttingDown) return;
+  if (activeCount >= concurrency) return;
+  const row = db_default.prepare(
+    `SELECT * FROM jobs
+     WHERE status = 'queued'
+     AND runAt <= ?
+     ORDER BY id ASC
+     LIMIT 1`
+  ).get(Date.now());
+  if (!row) return;
+  const def = registry.get(row.name);
+  if (!def) return;
+  db_default.prepare(
+    `UPDATE jobs
+   SET status = 'running',
+       startedAt = ?
+   WHERE id = ?`
+  ).run(Date.now(), row.id);
+  activeCount++;
+  try {
+    await def.handler(JSON.parse(row.payload));
+    db_default.prepare(
+      `UPDATE jobs
+   SET status = 'completed',
+       finishedAt = ?
+   WHERE id = ?`
+    ).run(Date.now(), row.id);
+  } catch (err) {
+    await handleRetry(row, def);
+  } finally {
+    activeCount--;
+  }
+}
+async function handleRetry(row, def) {
+  const attempts = row.attempts + 1;
+  const { retries, backoffMs } = def.options;
+  if (attempts > retries) {
+    db_default.prepare(
+      `UPDATE jobs
+     SET status = 'failed',
+         finishedAt = ?,
+         error = ?
+     WHERE id = ?`
+    ).run(Date.now(), String(row.error ?? "Unknown error"), row.id);
+    return;
+  }
+  const delay = backoffMs * attempts;
+  db_default.prepare(
+    `UPDATE jobs
+   SET attempts = ?,
+       runAt = ?,
+       status = 'queued'
+   WHERE id = ?`
+  ).run(attempts, Date.now() + delay, row.id);
+}
+function parseDelay(delay) {
+  if (!delay) return 0;
+  if (typeof delay === "number") return delay;
+  const match = /^(\d+)(ms|s|m|h)?$/.exec(delay.trim());
+  if (!match) {
+    throw new Error(`[OneQueue] Invalid delay format: ${delay}`);
+  }
+  const value = Number(match[1]);
+  const unit = match[2] ?? "ms";
+  switch (unit) {
+    case "ms":
+      return value;
+    case "s":
+      return value * 1e3;
+    case "m":
+      return value * 6e4;
+    case "h":
+      return value * 36e5;
+    default:
+      return value;
+  }
+}
+async function shutdown() {
+  if (isShuttingDown) return;
+  console.log("[OneQueue] Graceful shutdown started\u2026");
+  isShuttingDown = true;
+  while (activeCount > 0) {
+    await new Promise((r) => setTimeout(r, 50));
+  }
+  console.log("[OneQueue] All jobs finished. Exiting cleanly.");
+}
+function setupSignalHandlers() {
+  const handler = async () => {
+    await shutdown();
+    process.exit(0);
+  };
+  process.once("SIGINT", handler);
+  process.once("SIGTERM", handler);
+}
+setupSignalHandlers();
+export {
+  configure,
+  enqueue,
+  job,
+  shutdown
+};

package/package.json

@@ -1,13 +1,47 @@
 {
   "name": "onequeue",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Background jobs in one line",
-  "main": "index.js",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --watch",
+    "prepublishOnly": "npm run build"
   },
-  "keywords": [],
+  "keywords": [
+    "background-jobs",
+    "queue",
+    "nodejs",
+    "typescript",
+    "async",
+    "job-queue"
+  ],
   "author": "",
   "license": "MIT",
-  "type": "module"
-}
+  "type": "module",
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.6.2",
+    "sirv": "^3.0.2"
+  },
+  "bin": {
+    "onequeue": "dist/cli.js"
+  }
+}

package/index.js

@@ -1,3 +0,0 @@
-export const hello = () => {
-  console.log("OneQueue coming soon 🚀");
-};