@foundryprotocol/0gkit-jobs 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Foundry Protocol contributors
+
+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,94 @@
+# `@foundryprotocol/0gkit-jobs`
+
+Durable async job runner for long-running 0G operations (inference, multi-step
+agents, batched uploads, DA publishes). Three swappable backends behind one
+interface; zod-typed `jobs.define()`; HMAC-signed webhook delivery on state
+transitions; graceful shutdown via `AbortSignal` (designed for Vercel Fluid
+Compute and similar serverless runtimes).
+
+## Install
+
+```bash
+pnpm add @foundryprotocol/0gkit-jobs @foundryprotocol/0gkit-core zod
+
+# redis backend only
+pnpm add ioredis
+```
+
+## Quickstart
+
+```ts
+import { JobRunner, jobs } from "@foundryprotocol/0gkit-jobs";
+import { MemoryBackend } from "@foundryprotocol/0gkit-jobs/backends/memory";
+import { z } from "zod";
+
+const InferenceJob = jobs.define({
+  name: "inference",
+  input: z.object({ prompt: z.string(), model: z.string() }),
+  output: z.object({ text: z.string() }),
+  handler: async ({ input, signal }) => {
+    // Use `signal` for graceful shutdown; fail-fast in long handlers.
+    if (signal.aborted) throw new Error("shutting down");
+    return { text: "..." };
+  },
+});
+
+const runner = new JobRunner({
+  backend: new MemoryBackend(),
+  signer,
+  webhook: { url: process.env.WEBHOOK_URL!, secret: process.env.WEBHOOK_SECRET! },
+});
+runner.register(InferenceJob);
+await runner.start({ concurrency: 4 });
+
+const id = await runner.enqueue(InferenceJob, { prompt: "hi", model: "..." });
+const final = await runner.waitFor(id);
+```
+
+## Backends
+
+| Backend | Install                         | When to use                      |
+| ------- | ------------------------------- | -------------------------------- |
+| memory  | (built-in)                      | dev, tests, ephemeral workflows  |
+| sqlite  | (built-in via `better-sqlite3`) | single-node prod, no extra infra |
+| redis   | optional peer `ioredis`         | multi-node prod, fan-out         |
+
+## Webhook verification (server side)
+
+```ts
+import { jobs } from "@foundryprotocol/0gkit-jobs";
+
+app.post("/api/jobs/webhook", express.text({ type: "*/*" }), (req, res) => {
+  const ok = jobs.verifyWebhook({
+    body: req.body,
+    signature: req.header("x-0gkit-signature") ?? "",
+    secret: process.env.JOBS_SECRET!,
+  });
+  if (!ok) return res.status(401).send("bad signature");
+  // ... dedupe on (jobId + newState)
+});
+```
+
+## Vercel Fluid Compute
+
+Functions get a grace period on shutdown. Register a `beforeExit` hook that
+calls `runner.stop({ drain: true, timeoutMs: 25_000 })` so in-flight jobs land
+cleanly before the instance is reaped.
+
+## Error codes
+
+- [`JOBS_BACKEND_UNREACHABLE`](https://0gkit.dev/errors/JOBS_BACKEND_UNREACHABLE)
+- [`JOBS_JOB_NOT_FOUND`](https://0gkit.dev/errors/JOBS_JOB_NOT_FOUND)
+- [`JOBS_HANDLER_THREW`](https://0gkit.dev/errors/JOBS_HANDLER_THREW)
+- [`JOBS_WEBHOOK_BAD_SIGNATURE`](https://0gkit.dev/errors/JOBS_WEBHOOK_BAD_SIGNATURE)
+
+## At-least-once delivery
+
+A worker that crashes between handler completion and `backend.complete()`
+returning will retry on next claim. **Handlers must be idempotent on their
+inputs** — use `jobId` as the idempotency key for any external side effect.
+Webhook receivers should dedupe on `(jobId, newState)`.
+
+## License
+
+MIT

package/dist/backends/memory.d.ts

@@ -0,0 +1,17 @@
+import { J as JobBackend, d as JobRecord } from '../types-CTdOcaj1.js';
+import 'zod';
+import '@foundryprotocol/0gkit-core';
+
+declare class MemoryBackend implements JobBackend {
+    private store;
+    private order;
+    enqueue<I>(name: string, input: I): Promise<string>;
+    claim(): Promise<JobRecord | null>;
+    complete<O>(jobId: string, result: O): Promise<void>;
+    fail(jobId: string, error: string, retry: boolean): Promise<void>;
+    cancel(jobId: string): Promise<void>;
+    status(jobId: string): Promise<JobRecord | null>;
+    close(): Promise<void>;
+}
+
+export { MemoryBackend };

package/dist/backends/memory.js

@@ -0,0 +1,92 @@
+import { ZeroGError } from '@foundryprotocol/0gkit-core';
+
+// src/backends/memory.ts
+function makeId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+var MemoryBackend = class {
+  store = /* @__PURE__ */ new Map();
+  order = [];
+  async enqueue(name, input) {
+    const jobId = makeId();
+    const rec = {
+      id: jobId,
+      name,
+      state: "queued",
+      input,
+      metadata: { attempts: 0, createdAt: Date.now() }
+    };
+    this.store.set(jobId, rec);
+    this.order.push(jobId);
+    return jobId;
+  }
+  async claim() {
+    for (const jobId of this.order) {
+      const rec = this.store.get(jobId);
+      if (rec && rec.state === "queued") {
+        rec.state = "running";
+        rec.metadata.attempts += 1;
+        rec.metadata.startedAt = Date.now();
+        return rec;
+      }
+    }
+    return null;
+  }
+  async complete(jobId, result) {
+    const rec = this.store.get(jobId);
+    if (!rec) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id returned by enqueue() and ensure the backend instance is the same one that enqueued it."
+      );
+    }
+    rec.state = "done";
+    rec.result = result;
+    rec.metadata.finishedAt = Date.now();
+  }
+  async fail(jobId, error, retry) {
+    const rec = this.store.get(jobId);
+    if (!rec) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    rec.metadata.lastError = error;
+    rec.metadata.finishedAt = Date.now();
+    if (retry) {
+      rec.state = "queued";
+      rec.metadata.startedAt = void 0;
+    } else {
+      rec.state = "failed";
+      rec.error = error;
+    }
+  }
+  async cancel(jobId) {
+    const rec = this.store.get(jobId);
+    if (!rec) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    if (rec.state === "running" || rec.state === "queued") {
+      rec.state = "cancelled";
+      rec.metadata.finishedAt = Date.now();
+    }
+  }
+  async status(jobId) {
+    return this.store.get(jobId) ?? null;
+  }
+  async close() {
+    this.store.clear();
+    this.order = [];
+  }
+};
+
+export { MemoryBackend };
+//# sourceMappingURL=memory.js.map
+//# sourceMappingURL=memory.js.map

package/dist/backends/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backends/memory.ts"],"names":[],"mappings":"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","file":"memory.js","sourcesContent":["import { ZeroGError } from \"@foundryprotocol/0gkit-core\";\nimport type { JobBackend, JobRecord } from \"../types.js\";\n\nfunction makeId(): string {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport class MemoryBackend implements JobBackend {\n  private store = new Map<string, JobRecord>();\n  private order: string[] = [];\n\n  async enqueue<I>(name: string, input: I): Promise<string> {\n    const jobId = makeId();\n    const rec: JobRecord<I, unknown> = {\n      id: jobId,\n      name,\n      state: \"queued\",\n      input,\n      metadata: { attempts: 0, createdAt: Date.now() },\n    };\n    this.store.set(jobId, rec as JobRecord);\n    this.order.push(jobId);\n    return jobId;\n  }\n\n  async claim(): Promise<JobRecord | null> {\n    for (const jobId of this.order) {\n      const rec = this.store.get(jobId);\n      if (rec && rec.state === \"queued\") {\n        rec.state = \"running\";\n        rec.metadata.attempts += 1;\n        rec.metadata.startedAt = Date.now();\n        return rec;\n      }\n    }\n    return null;\n  }\n\n  async complete<O>(jobId: string, result: O): Promise<void> {\n    const rec = this.store.get(jobId);\n    if (!rec) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id returned by enqueue() and ensure the backend instance is the same one that enqueued it.\"\n      );\n    }\n    rec.state = \"done\";\n    rec.result = result;\n    rec.metadata.finishedAt = Date.now();\n  }\n\n  async fail(jobId: string, error: string, retry: boolean): Promise<void> {\n    const rec = this.store.get(jobId);\n    if (!rec) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    rec.metadata.lastError = error;\n    rec.metadata.finishedAt = Date.now();\n    if (retry) {\n      rec.state = \"queued\";\n      rec.metadata.startedAt = undefined;\n    } else {\n      rec.state = \"failed\";\n      rec.error = error;\n    }\n  }\n\n  async cancel(jobId: string): Promise<void> {\n    const rec = this.store.get(jobId);\n    if (!rec) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    if (rec.state === \"running\" || rec.state === \"queued\") {\n      rec.state = \"cancelled\";\n      rec.metadata.finishedAt = Date.now();\n    }\n  }\n\n  async status(jobId: string): Promise<JobRecord | null> {\n    return this.store.get(jobId) ?? null;\n  }\n\n  async close(): Promise<void> {\n    this.store.clear();\n    this.order = [];\n  }\n}\n"]}

package/dist/backends/redis.d.ts

@@ -0,0 +1,24 @@
+import { J as JobBackend, d as JobRecord } from '../types-CTdOcaj1.js';
+import 'zod';
+import '@foundryprotocol/0gkit-core';
+
+interface RedisOpts {
+    url: string;
+    keyPrefix?: string;
+}
+declare class RedisBackend implements JobBackend {
+    private client;
+    private keyPrefix;
+    private ready;
+    constructor(opts: RedisOpts);
+    private k;
+    enqueue<I>(name: string, input: I): Promise<string>;
+    claim(): Promise<JobRecord | null>;
+    complete<O>(jobId: string, result: O): Promise<void>;
+    fail(jobId: string, error: string, retry: boolean): Promise<void>;
+    cancel(jobId: string): Promise<void>;
+    status(jobId: string): Promise<JobRecord | null>;
+    close(): Promise<void>;
+}
+
+export { RedisBackend };

package/dist/backends/redis.js

@@ -0,0 +1,136 @@
+import { ZeroGError } from '@foundryprotocol/0gkit-core';
+
+// src/backends/redis.ts
+function makeId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+async function loadIoredis() {
+  try {
+    const mod = await import(["ioredis"].join("/"));
+    const Ctor = mod.default ?? mod.Redis;
+    if (!Ctor) {
+      throw new Error("ioredis loaded but no Redis constructor found");
+    }
+    return Ctor;
+  } catch {
+    throw new ZeroGError(
+      "JOBS_BACKEND_UNREACHABLE",
+      "ioredis is not installed \u2014 the redis JobBackend requires it as an optional peer.",
+      "run `pnpm add ioredis` (or `npm install ioredis`) in your project, then retry."
+    );
+  }
+}
+var RedisBackend = class {
+  client;
+  keyPrefix;
+  ready;
+  constructor(opts) {
+    this.keyPrefix = opts.keyPrefix ?? "0gkit:jobs";
+    this.ready = (async () => {
+      const Redis = await loadIoredis();
+      this.client = new Redis(opts.url);
+    })();
+  }
+  k(rest) {
+    return `${this.keyPrefix}:${rest}`;
+  }
+  async enqueue(name, input) {
+    await this.ready;
+    const jobId = makeId();
+    const rec = {
+      id: jobId,
+      name,
+      state: "queued",
+      input,
+      metadata: { attempts: 0, createdAt: Date.now() }
+    };
+    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+    await this.client.rpush(this.k("q"), jobId);
+    return jobId;
+  }
+  async claim() {
+    await this.ready;
+    const jobId = await this.client.lpop(this.k("q"));
+    if (!jobId) return null;
+    const raw = await this.client.get(this.k(`rec:${jobId}`));
+    if (!raw) return null;
+    const rec = JSON.parse(raw);
+    if (rec.state !== "queued") return null;
+    rec.state = "running";
+    rec.metadata.attempts += 1;
+    rec.metadata.startedAt = Date.now();
+    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+    return rec;
+  }
+  async complete(jobId, result) {
+    await this.ready;
+    const raw = await this.client.get(this.k(`rec:${jobId}`));
+    if (!raw) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    const rec = JSON.parse(raw);
+    rec.state = "done";
+    rec.result = result;
+    rec.metadata.finishedAt = Date.now();
+    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+  }
+  async fail(jobId, error, retry) {
+    await this.ready;
+    const raw = await this.client.get(this.k(`rec:${jobId}`));
+    if (!raw) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    const rec = JSON.parse(raw);
+    rec.metadata.lastError = error;
+    rec.metadata.finishedAt = Date.now();
+    if (retry) {
+      rec.state = "queued";
+      rec.metadata.startedAt = void 0;
+      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+      await this.client.rpush(this.k("q"), jobId);
+    } else {
+      rec.state = "failed";
+      rec.error = error;
+      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+    }
+  }
+  async cancel(jobId) {
+    await this.ready;
+    const raw = await this.client.get(this.k(`rec:${jobId}`));
+    if (!raw) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    const rec = JSON.parse(raw);
+    if (rec.state === "queued" || rec.state === "running") {
+      rec.state = "cancelled";
+      rec.metadata.finishedAt = Date.now();
+      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));
+      await this.client.lrem(this.k("q"), 0, jobId);
+    }
+  }
+  async status(jobId) {
+    await this.ready;
+    const raw = await this.client.get(this.k(`rec:${jobId}`));
+    return raw ? JSON.parse(raw) : null;
+  }
+  async close() {
+    await this.ready;
+    await this.client.quit();
+  }
+};
+
+export { RedisBackend };
+//# sourceMappingURL=redis.js.map
+//# sourceMappingURL=redis.js.map

package/dist/backends/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backends/redis.ts"],"names":[],"mappings":"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","file":"redis.js","sourcesContent":["import { ZeroGError } from \"@foundryprotocol/0gkit-core\";\nimport type { JobBackend, JobRecord } from \"../types.js\";\n\ninterface RedisOpts {\n  url: string;\n  keyPrefix?: string;\n}\n\nfunction makeId(): string {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\ntype RedisLike = {\n  set: (key: string, value: string) => Promise<unknown>;\n  get: (key: string) => Promise<string | null>;\n  rpush: (key: string, value: string) => Promise<unknown>;\n  lpop: (key: string) => Promise<string | null>;\n  lrem: (key: string, count: number, value: string) => Promise<unknown>;\n  quit: () => Promise<unknown>;\n};\n\nasync function loadIoredis(): Promise<new (url: string) => RedisLike> {\n  try {\n    // Computed specifier so the dep graph stays clean and the peer is truly optional.\n    const mod = (await import([\"ioredis\"].join(\"/\"))) as {\n      default?: new (url: string) => RedisLike;\n      Redis?: new (url: string) => RedisLike;\n    };\n    const Ctor = mod.default ?? mod.Redis;\n    if (!Ctor) {\n      throw new Error(\"ioredis loaded but no Redis constructor found\");\n    }\n    return Ctor;\n  } catch {\n    throw new ZeroGError(\n      \"JOBS_BACKEND_UNREACHABLE\",\n      \"ioredis is not installed — the redis JobBackend requires it as an optional peer.\",\n      \"run `pnpm add ioredis` (or `npm install ioredis`) in your project, then retry.\"\n    );\n  }\n}\n\nexport class RedisBackend implements JobBackend {\n  private client!: RedisLike;\n  private keyPrefix: string;\n  private ready: Promise<void>;\n\n  constructor(opts: RedisOpts) {\n    this.keyPrefix = opts.keyPrefix ?? \"0gkit:jobs\";\n    this.ready = (async () => {\n      const Redis = await loadIoredis();\n      this.client = new Redis(opts.url);\n    })();\n  }\n\n  private k(rest: string): string {\n    return `${this.keyPrefix}:${rest}`;\n  }\n\n  async enqueue<I>(name: string, input: I): Promise<string> {\n    await this.ready;\n    const jobId = makeId();\n    const rec: JobRecord<I, unknown> = {\n      id: jobId,\n      name,\n      state: \"queued\",\n      input,\n      metadata: { attempts: 0, createdAt: Date.now() },\n    };\n    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n    await this.client.rpush(this.k(\"q\"), jobId);\n    return jobId;\n  }\n\n  async claim(): Promise<JobRecord | null> {\n    await this.ready;\n    const jobId = await this.client.lpop(this.k(\"q\"));\n    if (!jobId) return null;\n    const raw = await this.client.get(this.k(`rec:${jobId}`));\n    if (!raw) return null;\n    const rec = JSON.parse(raw) as JobRecord;\n    if (rec.state !== \"queued\") return null;\n    rec.state = \"running\";\n    rec.metadata.attempts += 1;\n    rec.metadata.startedAt = Date.now();\n    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n    return rec;\n  }\n\n  async complete<O>(jobId: string, result: O): Promise<void> {\n    await this.ready;\n    const raw = await this.client.get(this.k(`rec:${jobId}`));\n    if (!raw) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    const rec = JSON.parse(raw) as JobRecord;\n    rec.state = \"done\";\n    rec.result = result;\n    rec.metadata.finishedAt = Date.now();\n    await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n  }\n\n  async fail(jobId: string, error: string, retry: boolean): Promise<void> {\n    await this.ready;\n    const raw = await this.client.get(this.k(`rec:${jobId}`));\n    if (!raw) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    const rec = JSON.parse(raw) as JobRecord;\n    rec.metadata.lastError = error;\n    rec.metadata.finishedAt = Date.now();\n    if (retry) {\n      rec.state = \"queued\";\n      rec.metadata.startedAt = undefined;\n      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n      await this.client.rpush(this.k(\"q\"), jobId);\n    } else {\n      rec.state = \"failed\";\n      rec.error = error;\n      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n    }\n  }\n\n  async cancel(jobId: string): Promise<void> {\n    await this.ready;\n    const raw = await this.client.get(this.k(`rec:${jobId}`));\n    if (!raw) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    const rec = JSON.parse(raw) as JobRecord;\n    if (rec.state === \"queued\" || rec.state === \"running\") {\n      rec.state = \"cancelled\";\n      rec.metadata.finishedAt = Date.now();\n      await this.client.set(this.k(`rec:${jobId}`), JSON.stringify(rec));\n      await this.client.lrem(this.k(\"q\"), 0, jobId);\n    }\n  }\n\n  async status(jobId: string): Promise<JobRecord | null> {\n    await this.ready;\n    const raw = await this.client.get(this.k(`rec:${jobId}`));\n    return raw ? (JSON.parse(raw) as JobRecord) : null;\n  }\n\n  async close(): Promise<void> {\n    await this.ready;\n    await this.client.quit();\n  }\n}\n"]}

package/dist/backends/sqlite.d.ts

@@ -0,0 +1,21 @@
+import { J as JobBackend, d as JobRecord } from '../types-CTdOcaj1.js';
+import 'zod';
+import '@foundryprotocol/0gkit-core';
+
+interface SqliteOpts {
+    path: string;
+}
+declare class SqliteBackend implements JobBackend {
+    private db;
+    constructor(opts: SqliteOpts);
+    enqueue<I>(name: string, input: I): Promise<string>;
+    claim(): Promise<JobRecord | null>;
+    complete<O>(jobId: string, result: O): Promise<void>;
+    fail(jobId: string, error: string, retry: boolean): Promise<void>;
+    cancel(jobId: string): Promise<void>;
+    status(jobId: string): Promise<JobRecord | null>;
+    close(): Promise<void>;
+    private rowToRecord;
+}
+
+export { SqliteBackend };

package/dist/backends/sqlite.js

@@ -0,0 +1,113 @@
+import Database from 'better-sqlite3';
+import { ZeroGError } from '@foundryprotocol/0gkit-core';
+
+// src/backends/sqlite.ts
+function makeId() {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+var SqliteBackend = class {
+  db;
+  constructor(opts) {
+    this.db = new Database(opts.path);
+    this.db.pragma("journal_mode = WAL");
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS jobs (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        state TEXT NOT NULL,
+        input TEXT NOT NULL,
+        result TEXT,
+        error TEXT,
+        attempts INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        started_at INTEGER,
+        finished_at INTEGER,
+        last_error TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_jobs_state_created ON jobs(state, created_at);
+    `);
+  }
+  async enqueue(name, input) {
+    const jobId = makeId();
+    this.db.prepare(
+      "INSERT INTO jobs (id, name, state, input, attempts, created_at) VALUES (?, ?, 'queued', ?, 0, ?)"
+    ).run(jobId, name, JSON.stringify(input), Date.now());
+    return jobId;
+  }
+  async claim() {
+    const row = this.db.prepare(
+      `UPDATE jobs SET state='running', attempts=attempts+1, started_at=?
+         WHERE id = (SELECT id FROM jobs WHERE state='queued' ORDER BY created_at LIMIT 1)
+         RETURNING *`
+    ).get(Date.now());
+    if (!row) return null;
+    return this.rowToRecord(row);
+  }
+  async complete(jobId, result) {
+    const res = this.db.prepare("UPDATE jobs SET state='done', result=?, finished_at=? WHERE id=?").run(JSON.stringify(result), Date.now(), jobId);
+    if (res.changes === 0) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+  }
+  async fail(jobId, error, retry) {
+    const next = retry ? "queued" : "failed";
+    const errorCol = retry ? null : error;
+    const res = this.db.prepare(
+      `UPDATE jobs
+         SET state=?, error=COALESCE(?, error), last_error=?, finished_at=?, started_at=NULL
+         WHERE id=?`
+    ).run(next, errorCol, error, Date.now(), jobId);
+    if (res.changes === 0) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+  }
+  async cancel(jobId) {
+    const row = this.db.prepare("SELECT * FROM jobs WHERE id=?").get(jobId);
+    if (!row) {
+      throw new ZeroGError(
+        "JOBS_JOB_NOT_FOUND",
+        `job ${jobId} not found`,
+        "verify the id"
+      );
+    }
+    this.db.prepare(
+      "UPDATE jobs SET state='cancelled', finished_at=? WHERE id=? AND state IN ('queued','running')"
+    ).run(Date.now(), jobId);
+  }
+  async status(jobId) {
+    const row = this.db.prepare("SELECT * FROM jobs WHERE id=?").get(jobId);
+    return row ? this.rowToRecord(row) : null;
+  }
+  async close() {
+    this.db.close();
+  }
+  rowToRecord(r) {
+    return {
+      id: r.id,
+      name: r.name,
+      state: r.state,
+      input: JSON.parse(r.input),
+      result: r.result ? JSON.parse(r.result) : void 0,
+      error: r.error ?? void 0,
+      metadata: {
+        attempts: r.attempts,
+        createdAt: r.created_at,
+        startedAt: r.started_at ?? void 0,
+        finishedAt: r.finished_at ?? void 0,
+        lastError: r.last_error ?? void 0
+      }
+    };
+  }
+};
+
+export { SqliteBackend };
+//# sourceMappingURL=sqlite.js.map
+//# sourceMappingURL=sqlite.js.map

package/dist/backends/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/backends/sqlite.ts"],"names":[],"mappings":"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","file":"sqlite.js","sourcesContent":["import Database from \"better-sqlite3\";\nimport { ZeroGError } from \"@foundryprotocol/0gkit-core\";\nimport type { JobBackend, JobRecord, JobState } from \"../types.js\";\n\ninterface SqliteOpts {\n  path: string;\n}\n\ninterface JobRow {\n  id: string;\n  name: string;\n  state: JobState;\n  input: string;\n  result: string | null;\n  error: string | null;\n  attempts: number;\n  created_at: number;\n  started_at: number | null;\n  finished_at: number | null;\n  last_error: string | null;\n}\n\nfunction makeId(): string {\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport class SqliteBackend implements JobBackend {\n  private db: Database.Database;\n\n  constructor(opts: SqliteOpts) {\n    this.db = new Database(opts.path);\n    this.db.pragma(\"journal_mode = WAL\");\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS jobs (\n        id TEXT PRIMARY KEY,\n        name TEXT NOT NULL,\n        state TEXT NOT NULL,\n        input TEXT NOT NULL,\n        result TEXT,\n        error TEXT,\n        attempts INTEGER NOT NULL DEFAULT 0,\n        created_at INTEGER NOT NULL,\n        started_at INTEGER,\n        finished_at INTEGER,\n        last_error TEXT\n      );\n      CREATE INDEX IF NOT EXISTS idx_jobs_state_created ON jobs(state, created_at);\n    `);\n  }\n\n  async enqueue<I>(name: string, input: I): Promise<string> {\n    const jobId = makeId();\n    this.db\n      .prepare(\n        \"INSERT INTO jobs (id, name, state, input, attempts, created_at) VALUES (?, ?, 'queued', ?, 0, ?)\"\n      )\n      .run(jobId, name, JSON.stringify(input), Date.now());\n    return jobId;\n  }\n\n  async claim(): Promise<JobRecord | null> {\n    const row = this.db\n      .prepare(\n        `UPDATE jobs SET state='running', attempts=attempts+1, started_at=?\n         WHERE id = (SELECT id FROM jobs WHERE state='queued' ORDER BY created_at LIMIT 1)\n         RETURNING *`\n      )\n      .get(Date.now()) as JobRow | undefined;\n    if (!row) return null;\n    return this.rowToRecord(row);\n  }\n\n  async complete<O>(jobId: string, result: O): Promise<void> {\n    const res = this.db\n      .prepare(\"UPDATE jobs SET state='done', result=?, finished_at=? WHERE id=?\")\n      .run(JSON.stringify(result), Date.now(), jobId);\n    if (res.changes === 0) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n  }\n\n  async fail(jobId: string, error: string, retry: boolean): Promise<void> {\n    const next = retry ? \"queued\" : \"failed\";\n    const errorCol = retry ? null : error;\n    const res = this.db\n      .prepare(\n        `UPDATE jobs\n         SET state=?, error=COALESCE(?, error), last_error=?, finished_at=?, started_at=NULL\n         WHERE id=?`\n      )\n      .run(next, errorCol, error, Date.now(), jobId);\n    if (res.changes === 0) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n  }\n\n  async cancel(jobId: string): Promise<void> {\n    const row = this.db.prepare(\"SELECT * FROM jobs WHERE id=?\").get(jobId) as\n      | JobRow\n      | undefined;\n    if (!row) {\n      throw new ZeroGError(\n        \"JOBS_JOB_NOT_FOUND\",\n        `job ${jobId} not found`,\n        \"verify the id\"\n      );\n    }\n    this.db\n      .prepare(\n        \"UPDATE jobs SET state='cancelled', finished_at=? WHERE id=? AND state IN ('queued','running')\"\n      )\n      .run(Date.now(), jobId);\n  }\n\n  async status(jobId: string): Promise<JobRecord | null> {\n    const row = this.db.prepare(\"SELECT * FROM jobs WHERE id=?\").get(jobId) as\n      | JobRow\n      | undefined;\n    return row ? this.rowToRecord(row) : null;\n  }\n\n  async close(): Promise<void> {\n    this.db.close();\n  }\n\n  private rowToRecord(r: JobRow): JobRecord {\n    return {\n      id: r.id,\n      name: r.name,\n      state: r.state,\n      input: JSON.parse(r.input),\n      result: r.result ? JSON.parse(r.result) : undefined,\n      error: r.error ?? undefined,\n      metadata: {\n        attempts: r.attempts,\n        createdAt: r.created_at,\n        startedAt: r.started_at ?? undefined,\n        finishedAt: r.finished_at ?? undefined,\n        lastError: r.last_error ?? undefined,\n      },\n    };\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { b as JobHandlerContext, a as JobDefinition, R as RunnerConfig, d as JobRecord } from './types-CTdOcaj1.js';
+export { C as ClaimOpts, J as JobBackend, c as JobMetadata, e as JobState, W as WebhookConfig } from './types-CTdOcaj1.js';
+import '@foundryprotocol/0gkit-core';
+
+interface DefineArgs<I, O> {
+    name: string;
+    input: z.ZodType<I>;
+    output: z.ZodType<O>;
+    handler: (ctx: JobHandlerContext<I>) => Promise<O>;
+    maxAttempts?: number;
+    backoffMs?: (attempt: number) => number;
+}
+declare function define<I, O>(args: DefineArgs<I, O>): JobDefinition<I, O>;
+
+declare function signWebhookBody(body: string, secret: string): string;
+declare function verifyWebhook(args: {
+    body: string;
+    signature: string;
+    secret: string;
+}): boolean;
+
+interface StartOpts {
+    concurrency?: number;
+}
+interface StopOpts {
+    drain?: boolean;
+    timeoutMs?: number;
+}
+interface WaitOpts {
+    timeoutMs?: number;
+    pollMs?: number;
+}
+declare class JobRunner {
+    private config;
+    private definitions;
+    private abortController;
+    private workers;
+    private running;
+    constructor(config: RunnerConfig);
+    register<I, O>(def: JobDefinition<I, O>): this;
+    enqueue<I, O>(def: JobDefinition<I, O>, input: I): Promise<string>;
+    start(opts?: StartOpts): Promise<void>;
+    stop(opts?: StopOpts): Promise<void>;
+    waitFor(id: string, opts?: WaitOpts): Promise<JobRecord>;
+    private claimSafe;
+    private workerLoop;
+    private runOne;
+    private sleep;
+    private fireWebhook;
+    /** Look up a registered definition by name (test/inspection helper). */
+    hasDefinition(name: string): boolean;
+}
+
+declare const jobs: {
+    define: typeof define;
+    signWebhookBody: typeof signWebhookBody;
+    verifyWebhook: typeof verifyWebhook;
+};
+
+export { JobDefinition, JobHandlerContext, JobRecord, JobRunner, RunnerConfig, jobs };

package/dist/index.js

@@ -0,0 +1,215 @@
+import { createHmac, timingSafeEqual } from 'crypto';
+import { ZeroGError } from '@foundryprotocol/0gkit-core';
+
+// src/define.ts
+function defaultBackoff(attempt) {
+  const base = 500;
+  const cap = 6e4;
+  const upper = Math.min(base * Math.pow(2, attempt), cap);
+  const lower = upper / 2;
+  return Math.floor(lower + Math.random() * (upper - lower));
+}
+function define(args) {
+  return {
+    name: args.name,
+    inputSchema: args.input,
+    outputSchema: args.output,
+    handler: args.handler,
+    maxAttempts: args.maxAttempts ?? 3,
+    backoffMs: args.backoffMs ?? defaultBackoff
+  };
+}
+function signWebhookBody(body, secret) {
+  return createHmac("sha256", secret).update(body, "utf8").digest("hex");
+}
+function verifyWebhook(args) {
+  try {
+    const provided = args.signature.startsWith("sha256=") ? args.signature.slice(7) : args.signature;
+    const expected = signWebhookBody(args.body, args.secret);
+    if (provided.length !== expected.length) return false;
+    return timingSafeEqual(Buffer.from(provided, "hex"), Buffer.from(expected, "hex"));
+  } catch {
+    return false;
+  }
+}
+var JobRunner = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  definitions = /* @__PURE__ */ new Map();
+  abortController = new AbortController();
+  workers = [];
+  running = false;
+  register(def) {
+    this.definitions.set(def.name, def);
+    return this;
+  }
+  async enqueue(def, input) {
+    def.inputSchema.parse(input);
+    return this.config.backend.enqueue(def.name, input);
+  }
+  async start(opts = {}) {
+    if (this.running) return;
+    this.running = true;
+    this.abortController = new AbortController();
+    const concurrency = Math.max(1, opts.concurrency ?? 1);
+    for (let i = 0; i < concurrency; i++) {
+      this.workers.push(this.workerLoop(`w${i}`));
+    }
+  }
+  async stop(opts = {}) {
+    if (!this.running) return;
+    this.running = false;
+    const drain = opts.drain ?? true;
+    if (!drain) {
+      this.abortController.abort();
+    }
+    const timeoutMs = opts.timeoutMs ?? 5e3;
+    await Promise.race([
+      Promise.all(this.workers),
+      new Promise((res) => setTimeout(res, timeoutMs))
+    ]);
+    this.workers = [];
+  }
+  async waitFor(id, opts = {}) {
+    const deadline = Date.now() + (opts.timeoutMs ?? 3e4);
+    const poll = opts.pollMs ?? 25;
+    while (Date.now() < deadline) {
+      const rec = await this.config.backend.status(id);
+      if (rec && (rec.state === "done" || rec.state === "failed" || rec.state === "cancelled")) {
+        return rec;
+      }
+      await new Promise((r) => setTimeout(r, poll));
+    }
+    throw new ZeroGError(
+      "JOBS_BACKEND_UNREACHABLE",
+      `waitFor timed out for job ${id}`,
+      "increase timeoutMs or check the backend is reachable and a worker is running."
+    );
+  }
+  async claimSafe(workerId) {
+    try {
+      return await this.config.backend.claim({ workerId });
+    } catch (err) {
+      if (err instanceof ZeroGError) return null;
+      throw err;
+    }
+  }
+  async workerLoop(workerId) {
+    const pollMs = this.config.pollIntervalMs ?? 50;
+    while (this.running) {
+      if (this.abortController.signal.aborted) return;
+      const rec = await this.claimSafe(workerId);
+      if (!rec) {
+        await this.sleep(pollMs);
+        continue;
+      }
+      await this.runOne(rec);
+    }
+  }
+  async runOne(rec) {
+    const def = this.definitions.get(rec.name);
+    if (!def) {
+      await this.config.backend.fail(
+        rec.id,
+        `no definition registered for "${rec.name}"`,
+        false
+      );
+      await this.fireWebhook(
+        rec.id,
+        rec.name,
+        "running",
+        "failed",
+        void 0,
+        "no def"
+      );
+      return;
+    }
+    try {
+      const result = await def.handler({
+        input: rec.input,
+        jobId: rec.id,
+        signer: this.config.signer,
+        signal: this.abortController.signal,
+        attempt: rec.metadata.attempts,
+        metadata: rec.metadata
+      });
+      def.outputSchema.parse(result);
+      await this.config.backend.complete(rec.id, result);
+      await this.fireWebhook(rec.id, rec.name, "running", "done", result, void 0);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      const aborted = this.abortController.signal.aborted;
+      const willRetry = rec.metadata.attempts < def.maxAttempts && !aborted;
+      if (willRetry) {
+        await this.sleep(def.backoffMs(rec.metadata.attempts));
+        if (this.abortController.signal.aborted) {
+          await this.config.backend.fail(rec.id, msg, false);
+          await this.fireWebhook(rec.id, rec.name, "running", "failed", void 0, msg);
+          return;
+        }
+      }
+      await this.config.backend.fail(rec.id, msg, willRetry);
+      await this.fireWebhook(
+        rec.id,
+        rec.name,
+        "running",
+        willRetry ? "queued" : "failed",
+        void 0,
+        msg
+      );
+    }
+  }
+  sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+  }
+  async fireWebhook(jobId, jobName, previousState, newState, result, error) {
+    if (!this.config.webhook) return;
+    const body = JSON.stringify({
+      jobId,
+      jobName,
+      previousState,
+      newState,
+      result,
+      error,
+      ts: Date.now()
+    });
+    const signature = signWebhookBody(body, this.config.webhook.secret);
+    const retries = this.config.webhook.retries ?? 2;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      try {
+        const res = await fetch(this.config.webhook.url, {
+          method: "POST",
+          headers: {
+            "content-type": "application/json",
+            "x-0gkit-signature": `sha256=${signature}`,
+            "x-0gkit-job-id": jobId,
+            "x-0gkit-event": "state-change"
+          },
+          body
+        });
+        if (res.ok) return;
+      } catch {
+      }
+      if (attempt < retries) {
+        await this.sleep(250 * (attempt + 1));
+      }
+    }
+  }
+  /** Look up a registered definition by name (test/inspection helper). */
+  hasDefinition(name) {
+    return this.definitions.has(name);
+  }
+};
+
+// src/index.ts
+var jobs = {
+  define,
+  signWebhookBody,
+  verifyWebhook
+};
+
+export { JobRunner, jobs };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/define.ts","../src/webhook.ts","../src/runner.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { z } from \"zod\";\nimport type { JobDefinition, JobHandlerContext } from \"./types.js\";\n\ninterface DefineArgs<I, O> {\n  name: string;\n  input: z.ZodType<I>;\n  output: z.ZodType<O>;\n  handler: (ctx: JobHandlerContext<I>) => Promise<O>;\n  maxAttempts?: number;\n  backoffMs?: (attempt: number) => number;\n}\n\nfunction defaultBackoff(attempt: number): number {\n  const base = 500;\n  const cap = 60_000;\n  const upper = Math.min(base * Math.pow(2, attempt), cap);\n  const lower = upper / 2;\n  return Math.floor(lower + Math.random() * (upper - lower));\n}\n\nexport function define<I, O>(args: DefineArgs<I, O>): JobDefinition<I, O> {\n  return {\n    name: args.name,\n    inputSchema: args.input,\n    outputSchema: args.output,\n    handler: args.handler,\n    maxAttempts: args.maxAttempts ?? 3,\n    backoffMs: args.backoffMs ?? defaultBackoff,\n  };\n}\n","import { createHmac, timingSafeEqual } from \"node:crypto\";\n\nexport function signWebhookBody(body: string, secret: string): string {\n  return createHmac(\"sha256\", secret).update(body, \"utf8\").digest(\"hex\");\n}\n\nexport function verifyWebhook(args: {\n  body: string;\n  signature: string;\n  secret: string;\n}): boolean {\n  try {\n    const provided = args.signature.startsWith(\"sha256=\")\n      ? args.signature.slice(7)\n      : args.signature;\n    const expected = signWebhookBody(args.body, args.secret);\n    if (provided.length !== expected.length) return false;\n    return timingSafeEqual(Buffer.from(provided, \"hex\"), Buffer.from(expected, \"hex\"));\n  } catch {\n    return false;\n  }\n}\n","import { ZeroGError } from \"@foundryprotocol/0gkit-core\";\nimport type { JobBackend, JobDefinition, JobRecord, RunnerConfig } from \"./types.js\";\nimport { signWebhookBody } from \"./webhook.js\";\n\ninterface StartOpts {\n  concurrency?: number;\n}\n\ninterface StopOpts {\n  drain?: boolean;\n  timeoutMs?: number;\n}\n\ninterface WaitOpts {\n  timeoutMs?: number;\n  pollMs?: number;\n}\n\nexport class JobRunner {\n  private definitions = new Map<string, JobDefinition<unknown, unknown>>();\n  private abortController = new AbortController();\n  private workers: Promise<void>[] = [];\n  private running = false;\n\n  constructor(private config: RunnerConfig) {}\n\n  register<I, O>(def: JobDefinition<I, O>): this {\n    this.definitions.set(def.name, def as unknown as JobDefinition<unknown, unknown>);\n    return this;\n  }\n\n  async enqueue<I, O>(def: JobDefinition<I, O>, input: I): Promise<string> {\n    def.inputSchema.parse(input);\n    return this.config.backend.enqueue(def.name, input);\n  }\n\n  async start(opts: StartOpts = {}): Promise<void> {\n    if (this.running) return;\n    this.running = true;\n    this.abortController = new AbortController();\n    const concurrency = Math.max(1, opts.concurrency ?? 1);\n    for (let i = 0; i < concurrency; i++) {\n      this.workers.push(this.workerLoop(`w${i}`));\n    }\n  }\n\n  async stop(opts: StopOpts = {}): Promise<void> {\n    if (!this.running) return;\n    this.running = false;\n    const drain = opts.drain ?? true;\n    if (!drain) {\n      this.abortController.abort();\n    }\n    const timeoutMs = opts.timeoutMs ?? 5000;\n    await Promise.race([\n      Promise.all(this.workers),\n      new Promise<void>((res) => setTimeout(res, timeoutMs)),\n    ]);\n    this.workers = [];\n  }\n\n  async waitFor(id: string, opts: WaitOpts = {}): Promise<JobRecord> {\n    const deadline = Date.now() + (opts.timeoutMs ?? 30_000);\n    const poll = opts.pollMs ?? 25;\n    while (Date.now() < deadline) {\n      const rec = await this.config.backend.status(id);\n      if (\n        rec &&\n        (rec.state === \"done\" || rec.state === \"failed\" || rec.state === \"cancelled\")\n      ) {\n        return rec;\n      }\n      await new Promise((r) => setTimeout(r, poll));\n    }\n    throw new ZeroGError(\n      \"JOBS_BACKEND_UNREACHABLE\",\n      `waitFor timed out for job ${id}`,\n      \"increase timeoutMs or check the backend is reachable and a worker is running.\"\n    );\n  }\n\n  private async claimSafe(workerId: string): Promise<JobRecord | null> {\n    try {\n      return await this.config.backend.claim({ workerId });\n    } catch (err) {\n      if (err instanceof ZeroGError) return null;\n      throw err;\n    }\n  }\n\n  private async workerLoop(workerId: string): Promise<void> {\n    const pollMs = this.config.pollIntervalMs ?? 50;\n    while (this.running) {\n      if (this.abortController.signal.aborted) return;\n      const rec = await this.claimSafe(workerId);\n      if (!rec) {\n        await this.sleep(pollMs);\n        continue;\n      }\n      await this.runOne(rec);\n    }\n  }\n\n  private async runOne(rec: JobRecord): Promise<void> {\n    const def = this.definitions.get(rec.name);\n    if (!def) {\n      await this.config.backend.fail(\n        rec.id,\n        `no definition registered for \"${rec.name}\"`,\n        false\n      );\n      await this.fireWebhook(\n        rec.id,\n        rec.name,\n        \"running\",\n        \"failed\",\n        undefined,\n        \"no def\"\n      );\n      return;\n    }\n    try {\n      const result = await def.handler({\n        input: rec.input,\n        jobId: rec.id,\n        signer: this.config.signer,\n        signal: this.abortController.signal,\n        attempt: rec.metadata.attempts,\n        metadata: rec.metadata,\n      });\n      def.outputSchema.parse(result);\n      await this.config.backend.complete(rec.id, result);\n      await this.fireWebhook(rec.id, rec.name, \"running\", \"done\", result, undefined);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      const aborted = this.abortController.signal.aborted;\n      const willRetry = rec.metadata.attempts < def.maxAttempts && !aborted;\n      if (willRetry) {\n        await this.sleep(def.backoffMs(rec.metadata.attempts));\n        if (this.abortController.signal.aborted) {\n          await this.config.backend.fail(rec.id, msg, false);\n          await this.fireWebhook(rec.id, rec.name, \"running\", \"failed\", undefined, msg);\n          return;\n        }\n      }\n      await this.config.backend.fail(rec.id, msg, willRetry);\n      await this.fireWebhook(\n        rec.id,\n        rec.name,\n        \"running\",\n        willRetry ? \"queued\" : \"failed\",\n        undefined,\n        msg\n      );\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((res) => setTimeout(res, ms));\n  }\n\n  private async fireWebhook(\n    jobId: string,\n    jobName: string,\n    previousState: JobRecord[\"state\"],\n    newState: JobRecord[\"state\"],\n    result: unknown,\n    error: string | undefined\n  ): Promise<void> {\n    if (!this.config.webhook) return;\n    const body = JSON.stringify({\n      jobId,\n      jobName,\n      previousState,\n      newState,\n      result,\n      error,\n      ts: Date.now(),\n    });\n    const signature = signWebhookBody(body, this.config.webhook.secret);\n    const retries = this.config.webhook.retries ?? 2;\n    for (let attempt = 0; attempt <= retries; attempt++) {\n      try {\n        const res = await fetch(this.config.webhook.url, {\n          method: \"POST\",\n          headers: {\n            \"content-type\": \"application/json\",\n            \"x-0gkit-signature\": `sha256=${signature}`,\n            \"x-0gkit-job-id\": jobId,\n            \"x-0gkit-event\": \"state-change\",\n          },\n          body,\n        });\n        if (res.ok) return;\n      } catch {\n        // swallow & retry\n      }\n      if (attempt < retries) {\n        await this.sleep(250 * (attempt + 1));\n      }\n    }\n  }\n\n  /** Look up a registered definition by name (test/inspection helper). */\n  hasDefinition(name: string): boolean {\n    return this.definitions.has(name);\n  }\n}\n\nexport type { JobBackend, JobDefinition };\n","import { define } from \"./define.js\";\nimport { signWebhookBody, verifyWebhook } from \"./webhook.js\";\n\nexport { JobRunner } from \"./runner.js\";\nexport type {\n  JobState,\n  JobRecord,\n  JobMetadata,\n  JobDefinition,\n  JobHandlerContext,\n  JobBackend,\n  WebhookConfig,\n  RunnerConfig,\n  ClaimOpts,\n} from \"./types.js\";\n\nexport const jobs = {\n  define,\n  signWebhookBody,\n  verifyWebhook,\n};\n"]}

package/dist/types-CTdOcaj1.d.ts

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { Signer } from '@foundryprotocol/0gkit-core';
+
+type JobState = "queued" | "running" | "done" | "failed" | "cancelled";
+interface JobMetadata {
+    attempts: number;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    lastError?: string;
+}
+interface JobRecord<I = unknown, O = unknown> {
+    id: string;
+    name: string;
+    state: JobState;
+    input: I;
+    result?: O;
+    error?: string;
+    metadata: JobMetadata;
+}
+interface JobHandlerContext<I> {
+    input: I;
+    jobId: string;
+    signer: Signer;
+    signal: AbortSignal;
+    attempt: number;
+    metadata: JobMetadata;
+}
+interface JobDefinition<I, O> {
+    readonly name: string;
+    readonly inputSchema: z.ZodType<I>;
+    readonly outputSchema: z.ZodType<O>;
+    readonly handler: (ctx: JobHandlerContext<I>) => Promise<O>;
+    readonly maxAttempts: number;
+    readonly backoffMs: (attempt: number) => number;
+}
+interface ClaimOpts {
+    workerId: string;
+}
+interface JobBackend {
+    enqueue<I>(name: string, input: I): Promise<string>;
+    claim(opts: ClaimOpts): Promise<JobRecord | null>;
+    complete<O>(id: string, result: O): Promise<void>;
+    fail(id: string, error: string, retry: boolean): Promise<void>;
+    cancel(id: string): Promise<void>;
+    status(id: string): Promise<JobRecord | null>;
+    close(): Promise<void>;
+}
+interface WebhookConfig {
+    url: string;
+    secret: string;
+    retries?: number;
+}
+interface RunnerConfig {
+    backend: JobBackend;
+    signer: Signer;
+    webhook?: WebhookConfig;
+    pollIntervalMs?: number;
+}
+
+export type { ClaimOpts as C, JobBackend as J, RunnerConfig as R, WebhookConfig as W, JobDefinition as a, JobHandlerContext as b, JobMetadata as c, JobRecord as d, JobState as e };

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@foundryprotocol/0gkit-jobs",
+  "version": "0.5.0",
+  "description": "Durable async job runner for 0G compute / storage / DA workflows. Memory / SQLite / Redis backends, zod-typed job definitions, HMAC-signed webhooks, graceful shutdown.",
+  "license": "MIT",
+  "homepage": "https://github.com/rajkaria/0gkit/tree/main/packages/0gkit-jobs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rajkaria/0gkit.git",
+    "directory": "packages/0gkit-jobs"
+  },
+  "bugs": {
+    "url": "https://github.com/rajkaria/0gkit/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./backends/memory": {
+      "types": "./dist/backends/memory.d.ts",
+      "import": "./dist/backends/memory.js"
+    },
+    "./backends/sqlite": {
+      "types": "./dist/backends/sqlite.d.ts",
+      "import": "./dist/backends/sqlite.js"
+    },
+    "./backends/redis": {
+      "types": "./dist/backends/redis.d.ts",
+      "import": "./dist/backends/redis.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^11.5.0",
+    "zod": "^3.23.0",
+    "@foundryprotocol/0gkit-core": "0.4.0"
+  },
+  "peerDependencies": {
+    "ioredis": "^5.4.1"
+  },
+  "peerDependenciesMeta": {
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.8",
+    "dependency-cruiser": "^16.0.0",
+    "ioredis": "^5.4.1",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8",
+    "@foundryprotocol/0gkit-testing": "0.4.0"
+  },
+  "keywords": [
+    "0g",
+    "0g-network",
+    "jobs",
+    "queue",
+    "worker",
+    "durable",
+    "webhook",
+    "toolkit"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "lint": "depcruise src --config ../../.dependency-cruiser.cjs",
+    "clean": "rimraf dist"
+  }
+}