@loomwork/plugin-sqlite 0.0.0-stage → 0.1.0

package/dist/SqliteSnapshotStore.js.map

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

package/dist/SqliteTimerStore.d.ts

@@ -0,0 +1,19 @@
+import type { TimerRecord, TimerStore } from "@loomwork/event-runtime";
+/**
+ * SQLite-backed {@link TimerStore} (T1.3). Point it at the same DB file as the
+ * SqliteEventStore so a single backup captures events + timers — the full
+ * kernel state. Own idempotent migration, same pattern as SqliteBranchRegistry.
+ */
+export declare class SqliteTimerStore implements TimerStore {
+    private readonly db;
+    constructor(dbPath: string);
+    schedule(timer: TimerRecord): Promise<void>;
+    due(now: number, limit?: number, options?: {
+        redrive?: boolean;
+        inbox?: boolean;
+        refused?: boolean;
+    }): Promise<TimerRecord[]>;
+    complete(executionId: string, wakeAt: number): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteTimerStore.d.ts.map

package/dist/SqliteTimerStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteTimerStore.d.ts","sourceRoot":"","sources":["../src/SqliteTimerStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAUvE;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM;IA6CpB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B3C,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,SAAM,EACX,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAClE,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBnB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/SqliteTimerStore.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteTimerStore = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+/**
+ * SQLite-backed {@link TimerStore} (T1.3). Point it at the same DB file as the
+ * SqliteEventStore so a single backup captures events + timers — the full
+ * kernel state. Own idempotent migration, same pattern as SqliteBranchRegistry.
+ */
+class SqliteTimerStore {
+    db;
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        try {
+            this.db.pragma("journal_mode = WAL");
+            this.db.pragma("synchronous = NORMAL");
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS timers (
+          execution_id TEXT NOT NULL,
+          wake_at INTEGER NOT NULL,
+          PRIMARY KEY (execution_id, wake_at)
+        );
+        CREATE INDEX IF NOT EXISTS idx_timers_wake ON timers (wake_at ASC);
+      `);
+            // ADR 0118 D4 — `CREATE TABLE IF NOT EXISTS` never adds a column to a table an older version
+            // created, so the re-drive column is added by a guarded ALTER: only when `table_info` lacks it
+            // (SQLite has no `ADD COLUMN IF NOT EXISTS`, and a second ALTER would throw). The check and
+            // the ALTER run under ONE write lock (`BEGIN IMMEDIATE`): two processes opening the same
+            // file at once would otherwise both see the column missing and the loser's ALTER would throw
+            // `duplicate column name`, failing its boot. The error is also tolerated (belt and braces: a
+            // peer on a SQLite build whose locking differs still ends with the column present).
+            this.db
+                .transaction(() => {
+                const columns = this.db.pragma("table_info(timers)");
+                // `redrive` (ADR 0118 D4) and `refused` (ADR 0130 D10), both nullable TEXT (JSON).
+                for (const column of ["redrive", "refused"]) {
+                    if (columns.some((c) => c.name === column))
+                        continue;
+                    try {
+                        this.db.exec(`ALTER TABLE timers ADD COLUMN ${column} TEXT`);
+                    }
+                    catch (err) {
+                        if (!/duplicate column name/i.test(String(err.message)))
+                            throw err;
+                    }
+                }
+            })
+                .immediate();
+            // ADR 0130 D10 - a PARTIAL index over the (rare) refusal rows only: a scan for them
+            // (`due` with refusal rows wanted) never walks the plain timers, and a plain row pays nothing.
+            this.db.exec("CREATE INDEX IF NOT EXISTS idx_timers_refused ON timers (wake_at ASC) WHERE refused IS NOT NULL");
+        }
+        catch (err) {
+            this.db.close(); // don't leak the file handle if setup fails on a bad/locked file
+            throw err;
+        }
+    }
+    async schedule(timer) {
+        this.db
+            .prepare(
+        // Upsert (ADR 0118 D4, ADR 0130 D10): a flagged row is never downgraded, a plain one gains
+        // the flag, and a same-key `refused` upsert keeps the MAX head / MAX holds (never last-writer-wins).
+        `INSERT INTO timers (execution_id, wake_at, redrive, refused) VALUES (?, ?, ?, ?)
+         ON CONFLICT (execution_id, wake_at)
+         DO UPDATE SET redrive = COALESCE(excluded.redrive, timers.redrive),
+                       refused = CASE
+                         WHEN excluded.refused IS NULL THEN timers.refused
+                         WHEN timers.refused IS NULL THEN excluded.refused
+                         WHEN json_extract(excluded.refused, '$.holds') IS NULL
+                          AND json_extract(timers.refused, '$.holds') IS NULL
+                         THEN json_object('head', max(json_extract(excluded.refused, '$.head'),
+                                                      json_extract(timers.refused, '$.head')))
+                         ELSE json_object('head', max(json_extract(excluded.refused, '$.head'),
+                                                      json_extract(timers.refused, '$.head')),
+                                          'holds', max(COALESCE(json_extract(excluded.refused, '$.holds'), 0),
+                                                       COALESCE(json_extract(timers.refused, '$.holds'), 0)))
+                       END`)
+            .run(timer.executionId, timer.wakeAt, timer.redrive !== undefined ? JSON.stringify(timer.redrive) : null, timer.refused !== undefined ? JSON.stringify(timer.refused) : null);
+    }
+    async due(now, limit = 100, options) {
+        const rows = this.db
+            .prepare(`SELECT execution_id, wake_at, redrive, refused FROM timers WHERE wake_at <= ?${options?.redrive === false ? " AND redrive IS NULL" : ""}${options?.refused === false ? " AND refused IS NULL" : ""}${options?.inbox === false ? " AND (wake_at <> -1 OR redrive IS NOT NULL)" : ""} ORDER BY wake_at ASC LIMIT ?`)
+            .all(now, limit);
+        return rows.map((r) => ({
+            executionId: r.execution_id,
+            wakeAt: r.wake_at,
+            ...(r.redrive !== null && { redrive: JSON.parse(r.redrive) }),
+            ...(r.refused !== null && {
+                refused: JSON.parse(r.refused),
+            }),
+        }));
+    }
+    async complete(executionId, wakeAt) {
+        this.db
+            .prepare("DELETE FROM timers WHERE execution_id = ? AND wake_at = ?")
+            .run(executionId, wakeAt);
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.SqliteTimerStore = SqliteTimerStore;
+//# sourceMappingURL=SqliteTimerStore.js.map

package/dist/SqliteTimerStore.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { SqliteEventStore } from "./SqliteEventStore";
+export { SqliteBranchRegistry } from "./SqliteBranchRegistry";
+export { SqliteLeaseStore } from "./SqliteLeaseStore";
+export { SqliteTimerStore } from "./SqliteTimerStore";
+export { SqliteSnapshotStore } from "./SqliteSnapshotStore";
+export type { SqliteSnapshotStoreOptions } from "./SqliteSnapshotStore";
+export { SqliteArchiveStore } from "./SqliteArchiveStore";
+export { SqliteDurableStateStore } from "./SqliteDurableStateStore";
+export { SqliteReadModelStore } from "./SqliteReadModelStore";
+export { SqliteContentStore, type SqliteContentStoreOptions } from "./SqliteContentStore";
+export { SqliteMemoryStore } from "./SqliteMemoryStore";
+export { sqliteStorage, type SqliteStorageOptions } from "./preset";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqliteStorage = exports.SqliteMemoryStore = exports.SqliteContentStore = exports.SqliteReadModelStore = exports.SqliteDurableStateStore = exports.SqliteArchiveStore = exports.SqliteSnapshotStore = exports.SqliteTimerStore = exports.SqliteLeaseStore = exports.SqliteBranchRegistry = exports.SqliteEventStore = void 0;
+var SqliteEventStore_1 = require("./SqliteEventStore");
+Object.defineProperty(exports, "SqliteEventStore", { enumerable: true, get: function () { return SqliteEventStore_1.SqliteEventStore; } });
+var SqliteBranchRegistry_1 = require("./SqliteBranchRegistry");
+Object.defineProperty(exports, "SqliteBranchRegistry", { enumerable: true, get: function () { return SqliteBranchRegistry_1.SqliteBranchRegistry; } });
+var SqliteLeaseStore_1 = require("./SqliteLeaseStore");
+Object.defineProperty(exports, "SqliteLeaseStore", { enumerable: true, get: function () { return SqliteLeaseStore_1.SqliteLeaseStore; } });
+var SqliteTimerStore_1 = require("./SqliteTimerStore");
+Object.defineProperty(exports, "SqliteTimerStore", { enumerable: true, get: function () { return SqliteTimerStore_1.SqliteTimerStore; } });
+var SqliteSnapshotStore_1 = require("./SqliteSnapshotStore");
+Object.defineProperty(exports, "SqliteSnapshotStore", { enumerable: true, get: function () { return SqliteSnapshotStore_1.SqliteSnapshotStore; } });
+var SqliteArchiveStore_1 = require("./SqliteArchiveStore");
+Object.defineProperty(exports, "SqliteArchiveStore", { enumerable: true, get: function () { return SqliteArchiveStore_1.SqliteArchiveStore; } });
+var SqliteDurableStateStore_1 = require("./SqliteDurableStateStore");
+Object.defineProperty(exports, "SqliteDurableStateStore", { enumerable: true, get: function () { return SqliteDurableStateStore_1.SqliteDurableStateStore; } });
+var SqliteReadModelStore_1 = require("./SqliteReadModelStore");
+Object.defineProperty(exports, "SqliteReadModelStore", { enumerable: true, get: function () { return SqliteReadModelStore_1.SqliteReadModelStore; } });
+var SqliteContentStore_1 = require("./SqliteContentStore");
+Object.defineProperty(exports, "SqliteContentStore", { enumerable: true, get: function () { return SqliteContentStore_1.SqliteContentStore; } });
+var SqliteMemoryStore_1 = require("./SqliteMemoryStore");
+Object.defineProperty(exports, "SqliteMemoryStore", { enumerable: true, get: function () { return SqliteMemoryStore_1.SqliteMemoryStore; } });
+var preset_1 = require("./preset");
+Object.defineProperty(exports, "sqliteStorage", { enumerable: true, get: function () { return preset_1.sqliteStorage; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,2DAA0F;AAAjF,wHAAA,kBAAkB,OAAA;AAC3B,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,mCAAoE;AAA3D,uGAAA,aAAa,OAAA"}

package/dist/preset.d.ts

@@ -0,0 +1,31 @@
+import type { LeaseStore } from "@loomwork/event-runtime";
+import type { CustomStorage } from "@loomwork/plugin-kit";
+import type { SnapshotCodecName } from "@loomwork/snapshot-runtime";
+export interface SqliteStorageOptions {
+    /** Directory holding the `.db` files. Defaults to `.loom`. */
+    dir?: string;
+    /** Also provision a branch registry (its own DB file to avoid write contention). */
+    branching?: boolean;
+    /**
+     * ADR 0141 - opt in to zstd-compressed snapshot states (default `"none"`: JSON text, as before).
+     * Needs Node >= 22.15 (throws at construction otherwise). Old snapshots stay readable; see
+     * `SqliteSnapshotStoreOptions.codec`.
+     */
+    snapshotCodec?: SnapshotCodecName;
+}
+/**
+ * A `defineConfig({ storage })` preset for embedded SQLite. Returns a `custom`
+ * storage descriptor with the SQLite stores constructed — so `@loomwork/app` never
+ * needs to know SQLite exists (ADR 0043: 1P/3P storage backends are symmetric,
+ * each supplied as a preset, none privileged with a `kind`).
+ *
+ * `leaseStore` (ADR 0130 D11) is the heartbeat-lease store CO-LOCATED with the event store: the
+ * same `events.db`, so the lease and the log share one failure domain. It is an accessor on
+ * the factory's result, not part of `CustomStorage`, so there is no `EventStore` SPI change;
+ * `defineConfig` does not read it yet. It is opened lazily on first access (its own connection) and
+ * closed by `eventStore.close()`.
+ */
+export declare function sqliteStorage(options?: SqliteStorageOptions): CustomStorage & {
+    leaseStore: LeaseStore;
+};
+//# sourceMappingURL=preset.d.ts.map

package/dist/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAOpE,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,OAAO,GAAE,oBAAyB,GACjC,aAAa,GAAG;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,CA2B5C"}

package/dist/preset.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sqliteStorage = sqliteStorage;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const SqliteArchiveStore_1 = require("./SqliteArchiveStore");
+const SqliteBranchRegistry_1 = require("./SqliteBranchRegistry");
+const SqliteEventStore_1 = require("./SqliteEventStore");
+const SqliteLeaseStore_1 = require("./SqliteLeaseStore");
+const SqliteSnapshotStore_1 = require("./SqliteSnapshotStore");
+/**
+ * A `defineConfig({ storage })` preset for embedded SQLite. Returns a `custom`
+ * storage descriptor with the SQLite stores constructed — so `@loomwork/app` never
+ * needs to know SQLite exists (ADR 0043: 1P/3P storage backends are symmetric,
+ * each supplied as a preset, none privileged with a `kind`).
+ *
+ * `leaseStore` (ADR 0130 D11) is the heartbeat-lease store CO-LOCATED with the event store: the
+ * same `events.db`, so the lease and the log share one failure domain. It is an accessor on
+ * the factory's result, not part of `CustomStorage`, so there is no `EventStore` SPI change;
+ * `defineConfig` does not read it yet. It is opened lazily on first access (its own connection) and
+ * closed by `eventStore.close()`.
+ */
+function sqliteStorage(options = {}) {
+    const dir = options.dir ?? ".loom";
+    (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    const eventStore = new SqliteEventStore_1.SqliteEventStore((0, node_path_1.join)(dir, "events.db"));
+    // Lazy: a second events.db connection + migrate is opened only when something reads
+    // `leaseStore`, and it is closed together with the event store (as the Postgres preset does).
+    let lease;
+    const closeEvents = eventStore.close.bind(eventStore);
+    eventStore.close = async () => {
+        await closeEvents();
+        await lease?.close();
+    };
+    return {
+        kind: "custom",
+        eventStore,
+        snapshotStore: new SqliteSnapshotStore_1.SqliteSnapshotStore((0, node_path_1.join)(dir, "snapshots.db"), {
+            ...(options.snapshotCodec !== undefined && { codec: options.snapshotCodec }),
+        }),
+        archiveStore: new SqliteArchiveStore_1.SqliteArchiveStore((0, node_path_1.join)(dir, "archive.db")),
+        get leaseStore() {
+            lease ??= new SqliteLeaseStore_1.SqliteLeaseStore((0, node_path_1.join)(dir, "events.db"));
+            return lease;
+        },
+        ...(options.branching === true && {
+            branchRegistry: new SqliteBranchRegistry_1.SqliteBranchRegistry((0, node_path_1.join)(dir, "branches.db")),
+        }),
+    };
+}
+//# sourceMappingURL=preset.js.map

package/dist/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":";;AAoCA,sCA6BC;AAjED,qCAAoC;AACpC,yCAAiC;AAIjC,6DAA0D;AAC1D,iEAA8D;AAC9D,yDAAsD;AACtD,yDAAsD;AACtD,+DAA4D;AAe5D;;;;;;;;;;;GAWG;AACH,SAAgB,aAAa,CAC3B,UAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC;IACnC,IAAA,mBAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,mCAAgB,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAChE,oFAAoF;IACpF,8FAA8F;IAC9F,IAAI,KAAmC,CAAC;IACxC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,UAAU,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU;QACV,aAAa,EAAE,IAAI,yCAAmB,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,cAAc,CAAC,EAAE;YAChE,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;SAC7E,CAAC;QACF,YAAY,EAAE,IAAI,uCAAkB,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC7D,IAAI,UAAU;YACZ,KAAK,KAAK,IAAI,mCAAgB,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI;YAChC,cAAc,EAAE,IAAI,2CAAoB,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,aAAa,CAAC,CAAC;SACnE,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,3 @@
+import type Database from "better-sqlite3";
+export declare function migrate(db: Database.Database): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA6DnD"}

package/dist/schema.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrate = migrate;
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS events (
+      id TEXT NOT NULL,
+      workflow_id TEXT NOT NULL,
+      execution_id TEXT NOT NULL,
+      event_type TEXT NOT NULL,
+      sequence INTEGER NOT NULL,
+      timestamp INTEGER NOT NULL,
+      payload TEXT NOT NULL,
+      metadata TEXT,
+      PRIMARY KEY (id),
+      UNIQUE (execution_id, sequence)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_events_exec
+      ON events (execution_id, sequence ASC);
+
+    CREATE TABLE IF NOT EXISTS executions (
+      id TEXT PRIMARY KEY,
+      workflow_id TEXT NOT NULL,
+      workflow_version TEXT NOT NULL,
+      status TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+    -- Branch registry: git-style movable pointers (refs) into the event-log
+    -- topology. A ref names an execution head; promote() repoints a ref onto a
+    -- winning execution ("pick-a-winner"). No merge — see BranchRegistry.
+    CREATE TABLE IF NOT EXISTS refs (
+      name TEXT PRIMARY KEY,
+      execution_id TEXT NOT NULL,
+      tip INTEGER NOT NULL,
+      parent_execution_id TEXT,
+      fork_sequence INTEGER,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+    -- Immutable fork DAG: each forked execution records its parent and the
+    -- sequence it forked at. One row per child execution.
+    -- #380 — durable ownership of a RUNNING execution; the primary key IS the exclusion.
+    CREATE TABLE IF NOT EXISTS leases (
+      execution_id TEXT NOT NULL PRIMARY KEY,
+      owner TEXT NOT NULL,
+      expires_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_leases_expiry ON leases (expires_at ASC);
+
+    CREATE TABLE IF NOT EXISTS lineage (
+      execution_id TEXT PRIMARY KEY,
+      parent_execution_id TEXT NOT NULL,
+      fork_sequence INTEGER NOT NULL,
+      created_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_lineage_parent
+      ON lineage (parent_execution_id);
+  `);
+    migrateIncarnation(db);
+}
+/**
+ * ADR 0129 — the store-assigned incarnation of an execution, kept in STORE METADATA only (never
+ * in an envelope, so replay stays byte-identical). It lives on the sequence-0 row and is filled
+ * by a trigger from a one-row counter, so EVERY way a sequence 0 can land (append, appendBatch,
+ * copyPrefix, appendIfUnchanged, another process) assigns one. The counter is never reset, so a
+ * deleted-and-recreated id always gets a larger value. Logs created before this column existed
+ * keep NULL (no backfill): their anchor stays the legacy `timestamp:id`. All steps are
+ * idempotent and tolerate two processes migrating at once.
+ */
+function migrateIncarnation(db) {
+    const columns = db.prepare("PRAGMA table_info(events)").all();
+    if (!columns.some((c) => c.name === "incarnation")) {
+        try {
+            db.exec("ALTER TABLE events ADD COLUMN incarnation INTEGER");
+        }
+        catch (err) {
+            // A concurrent migrator added it between our check and our ALTER.
+            if (!/duplicate column name/i.test(String(err.message)))
+                throw err;
+        }
+    }
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS incarnation_counter (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      n INTEGER NOT NULL
+    );
+    INSERT OR IGNORE INTO incarnation_counter (id, n) VALUES (1, 0);
+    CREATE TRIGGER IF NOT EXISTS trg_events_incarnation
+    AFTER INSERT ON events
+    WHEN NEW.sequence = 0
+    BEGIN
+      UPDATE incarnation_counter SET n = n + 1 WHERE id = 1;
+      UPDATE events SET incarnation = (SELECT n FROM incarnation_counter WHERE id = 1)
+        WHERE id = NEW.id;
+    END;
+  `);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":";;AAEA,0BA6DC;AA7DD,SAAgB,OAAO,CAAC,EAAqB;IAC3C,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DP,CAAC,CAAC;IACH,kBAAkB,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,EAAqB;IAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAuB,2BAA2B,CAAC,CAAC,GAAG,EAAE,CAAC;IACpF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;gBAAE,MAAM,GAAG,CAAC;QAChF,CAAC;IACH,CAAC;IACD,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;GAcP,CAAC,CAAC;AACL,CAAC"}

package/dist/snapshotSchema.d.ts

@@ -0,0 +1,3 @@
+import type Database from "better-sqlite3";
+export declare function migrate(db: Database.Database): void;
+//# sourceMappingURL=snapshotSchema.d.ts.map

package/dist/snapshotSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotSchema.d.ts","sourceRoot":"","sources":["../src/snapshotSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAcnD"}

package/dist/snapshotSchema.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrate = migrate;
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS snapshots (
+      id TEXT PRIMARY KEY,
+      execution_id TEXT NOT NULL,
+      workflow_id TEXT NOT NULL,
+      sequence INTEGER NOT NULL,
+      state TEXT NOT NULL,
+      created_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_snapshots_exec
+      ON snapshots (execution_id, sequence DESC);
+  `);
+}
+//# sourceMappingURL=snapshotSchema.js.map

package/dist/snapshotSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotSchema.js","sourceRoot":"","sources":["../src/snapshotSchema.ts"],"names":[],"mappings":";;AAEA,0BAcC;AAdD,SAAgB,OAAO,CAAC,EAAqB;IAC3C,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;GAYP,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@loomwork/plugin-sqlite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "SQLite store plugin for Loom — embedded EventStore, SnapshotStore, BranchRegistry, TimerStore, DurableStateStore, ReadModelStore, ContentStore and MemoryStore over better-sqlite3, behind the same interfaces as the in-memory reference. The zero-server durable backend; keeps the native driver out of the kernel packages.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.5.0",
+    "@loomwork/core": "^0.1.0",
+    "@loomwork/event-runtime": "^0.1.0",
+    "@loomwork/snapshot-runtime": "^0.1.0",
+    "@loomwork/plugin-read-model": "^0.1.0",
+    "@loomwork/plugin-content": "^0.1.0",
+    "@loomwork/memory": "^0.1.0",
+    "@loomwork/plugin-durable-state": "^0.1.0",
+    "@loomwork/plugin-kit": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8",
+    "@loomwork/conformance": "0.1.0"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chhetrisushil/loom.git",
+    "directory": "plugins/sqlite"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "!src/**/__fixtures__",
+    "!src/**/__snapshots__",
+    "!src/**/__golden__",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "dev": "tsc --build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
+  }
 }