@torkbot/sledge 0.1.0

package/dist/runtime/virtual-runtime.js

@@ -0,0 +1,116 @@
+class VirtualRuntimeClock {
+    #nowMs;
+    constructor(nowMs) {
+        this.#nowMs = nowMs;
+    }
+    nowMs() {
+        return this.#nowMs;
+    }
+    advanceByMs(ms) {
+        this.#nowMs += ms;
+    }
+}
+class VirtualRuntimeScheduler {
+    #clock;
+    #entries = new Map();
+    #nextId = 1;
+    constructor(clock) {
+        this.#clock = clock;
+    }
+    scheduleOnce(delayMs, task) {
+        return this.#schedule(delayMs, null, task);
+    }
+    scheduleRepeating(everyMs, task) {
+        return this.#schedule(everyMs, everyMs, task);
+    }
+    runDue() {
+        while (true) {
+            const dueEntry = this.#nextDueEntry();
+            if (dueEntry === null) {
+                return;
+            }
+            dueEntry.task();
+            if (dueEntry.cancelled) {
+                this.#entries.delete(dueEntry.id);
+                continue;
+            }
+            if (dueEntry.everyMs === null) {
+                this.#entries.delete(dueEntry.id);
+                continue;
+            }
+            dueEntry.dueAtMs += dueEntry.everyMs;
+        }
+    }
+    #schedule(delayMs, everyMs, task) {
+        const id = this.#nextId;
+        this.#nextId += 1;
+        const entry = {
+            id,
+            dueAtMs: this.#clock.nowMs() + delayMs,
+            everyMs,
+            task,
+            cancelled: false,
+        };
+        this.#entries.set(id, entry);
+        return {
+            cancel: () => {
+                entry.cancelled = true;
+            },
+        };
+    }
+    #nextDueEntry() {
+        let selected = null;
+        for (const entry of this.#entries.values()) {
+            if (entry.cancelled) {
+                continue;
+            }
+            if (entry.dueAtMs > this.#clock.nowMs()) {
+                continue;
+            }
+            if (selected === null) {
+                selected = entry;
+                continue;
+            }
+            if (entry.dueAtMs < selected.dueAtMs) {
+                selected = entry;
+                continue;
+            }
+            if (entry.dueAtMs === selected.dueAtMs && entry.id < selected.id) {
+                selected = entry;
+            }
+        }
+        return selected;
+    }
+}
+/**
+ * Deterministic runtime harness for contract and integration tests.
+ */
+export class VirtualRuntimeHarness {
+    #clock;
+    #scheduler;
+    constructor(nowMs) {
+        this.#clock = new VirtualRuntimeClock(nowMs);
+        this.#scheduler = new VirtualRuntimeScheduler(this.#clock);
+    }
+    get clock() {
+        return this.#clock;
+    }
+    get scheduler() {
+        return this.#scheduler;
+    }
+    nowMs() {
+        return this.#clock.nowMs();
+    }
+    async advanceByMs(ms) {
+        this.#clock.advanceByMs(ms);
+        this.#scheduler.runDue();
+        await this.flush();
+    }
+    async flush() {
+        this.#scheduler.runDue();
+        for (let i = 0; i < 5; i += 1) {
+            await Promise.resolve();
+        }
+    }
+}
+//# sourceMappingURL=virtual-runtime.js.map

package/dist/runtime/virtual-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-runtime.js","sourceRoot":"","sources":["../../src/runtime/virtual-runtime.ts"],"names":[],"mappings":"AAMA,MAAM,mBAAmB;IACvB,MAAM,CAAS;IAEf,YAAY,KAAa;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACpB,CAAC;CACF;AAUD,MAAM,uBAAuB;IAClB,MAAM,CAAsB;IAC5B,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAEtD,OAAO,GAAG,CAAC,CAAC;IAEZ,YAAY,KAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,OAAe,EAAE,IAAgB;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,iBAAiB,CAAC,OAAe,EAAE,IAAgB;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAEtC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEhB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClC,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;QACvC,CAAC;IACH,CAAC;IAED,SAAS,CACP,OAAe,EACf,OAAsB,EACtB,IAAgB;QAEhB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAElB,MAAM,KAAK,GAAmB;YAC5B,EAAE;YACF,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,OAAO;YACtC,OAAO;YACP,IAAI;YACJ,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAE7B,OAAO;YACL,MAAM,EAAE,GAAG,EAAE;gBACX,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACzB,CAAC;SACF,CAAC;IACJ,CAAC;IAED,aAAa;QACX,IAAI,QAAQ,GAA0B,IAAI,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxC,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,QAAQ,GAAG,KAAK,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrC,QAAQ,GAAG,KAAK,CAAC;gBACjB,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjE,QAAQ,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,MAAM,CAAsB;IAC5B,UAAU,CAA0B;IAE7C,YAAY,KAAa;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@torkbot/sledge",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "A SQLite-backed event and work engine that stays consistent across retries, restarts, and failures.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./ledger": {
+      "types": "./dist/ledger/ledger.d.ts",
+      "default": "./dist/ledger/ledger.js"
+    },
+    "./database-ledger-engine": {
+      "types": "./dist/ledger/database-ledger-engine.d.ts",
+      "default": "./dist/ledger/database-ledger-engine.js"
+    },
+    "./better-sqlite3-ledger": {
+      "types": "./dist/ledger/better-sqlite3-ledger.d.ts",
+      "default": "./dist/ledger/better-sqlite3-ledger.js"
+    },
+    "./turso-ledger": {
+      "types": "./dist/ledger/turso-ledger.d.ts",
+      "default": "./dist/ledger/turso-ledger.js"
+    },
+    "./runtime/contracts": {
+      "types": "./dist/runtime/contracts.d.ts",
+      "default": "./dist/runtime/contracts.js"
+    },
+    "./runtime/node-runtime": {
+      "types": "./dist/runtime/node-runtime.d.ts",
+      "default": "./dist/runtime/node-runtime.js"
+    },
+    "./runtime/virtual-runtime": {
+      "types": "./dist/runtime/virtual-runtime.d.ts",
+      "default": "./dist/runtime/virtual-runtime.js"
+    }
+  },
+  "types": "./dist/ledger/ledger.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc --project tsconfig.build.json --pretty",
+    "test": "node --test src/**/*.test.ts",
+    "typecheck": "tsc --noEmit --pretty",
+    "lint": "prettier -c README.md package.json tsconfig.json tsconfig.build.json src/**/*.ts",
+    "prepublishOnly": "node --run build"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
+    "@tursodatabase/database": "^0.5.1",
+    "better-sqlite3": "^12.6.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.12.0",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.6.0"
+  }
+}