@loomwork/plugin-sqlite 0.0.0-stage → 0.1.1

package/dist/SqliteEventStore.js

@@ -0,0 +1,297 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteEventStore = void 0;
+const event_runtime_1 = require("@loomwork/event-runtime");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const schema_1 = require("./schema");
+/**
+ * #306 — normalize the `UNIQUE (execution_id, sequence)` violation to the portable
+ * {@link DuplicateSequenceError} every backend raises, so a caller need not know which
+ * store it is talking to (or match on driver text) to recognise a lost sequence race.
+ *
+ * Narrowed to THAT constraint by name: the table also has a PRIMARY KEY on `id`, and a
+ * duplicate id is a different bug (a re-used envelope id) that must not be reported as a
+ * sequence conflict. Anything else propagates untouched.
+ */
+function isDuplicateSequenceViolation(err) {
+    if (!isConstraintViolation(err))
+        return false;
+    return err.message.includes("execution_id") && err.message.includes("sequence");
+}
+/**
+ * #309 — the table's OTHER key: `PRIMARY KEY (id)`. Distinguished from the sequence
+ * constraint by the column named in the violation, so each maps to its own error and
+ * neither is reported as the other.
+ */
+function isDuplicateIdViolation(err) {
+    if (!isConstraintViolation(err))
+        return false;
+    return err.message.includes("events.id") && !err.message.includes("execution_id");
+}
+function isConstraintViolation(err) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.code;
+    return typeof code === "string" && code.startsWith("SQLITE_CONSTRAINT");
+}
+function rowToEnvelope(row) {
+    return {
+        id: row.id,
+        workflowId: row.workflow_id,
+        executionId: row.execution_id,
+        eventType: row.event_type,
+        sequence: row.sequence,
+        timestamp: row.timestamp,
+        payload: JSON.parse(row.payload),
+        ...(row.metadata !== null && { metadata: JSON.parse(row.metadata) }),
+    };
+}
+class SqliteEventStore {
+    db;
+    pageFirstStmt;
+    pageAfterStmt;
+    subscribers = new event_runtime_1.SubscriberRegistry();
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        try {
+            this.db.pragma("journal_mode = WAL");
+            this.db.pragma("synchronous = NORMAL");
+            (0, schema_1.migrate)(this.db);
+        }
+        catch (err) {
+            this.db.close(); // don't leak the file handle if setup fails on a bad/locked file
+            throw err;
+        }
+    }
+    async append(envelope) {
+        const stmt = this.db.prepare(`
+      INSERT INTO events (id, workflow_id, execution_id, event_type, sequence, timestamp, payload, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        try {
+            stmt.run(envelope.id, envelope.workflowId, envelope.executionId, envelope.eventType, envelope.sequence, envelope.timestamp, JSON.stringify(envelope.payload), envelope.metadata !== undefined ? JSON.stringify(envelope.metadata) : null);
+        }
+        catch (err) {
+            if (isDuplicateSequenceViolation(err)) {
+                throw new event_runtime_1.DuplicateSequenceError(envelope.executionId, envelope.sequence, err);
+            }
+            if (isDuplicateIdViolation(err)) {
+                throw new event_runtime_1.DuplicateEnvelopeIdError(envelope.id, envelope.executionId, err);
+            }
+            throw err;
+        }
+        this.notify(envelope.executionId, envelope);
+    }
+    /**
+     * ADR 0074 D1 — bulk append in ONE transaction. better-sqlite3's `transaction()` wrapper
+     * is synchronous and rolls back on throw, which gives the required atomicity directly:
+     * a UNIQUE(execution_id, sequence) violation part-way aborts the whole statement group,
+     * so no execution is left with a hole.
+     *
+     * Subscribers fire only after the transaction commits — a subscriber must never observe
+     * a batch that could still roll back.
+     */
+    async appendBatch(envelopes) {
+        if (envelopes.length === 0)
+            return;
+        const stmt = this.db.prepare(`
+      INSERT INTO events (id, workflow_id, execution_id, event_type, sequence, timestamp, payload, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertAll = this.db.transaction((batch) => {
+            for (const envelope of batch) {
+                stmt.run(envelope.id, envelope.workflowId, envelope.executionId, envelope.eventType, envelope.sequence, envelope.timestamp, JSON.stringify(envelope.payload), envelope.metadata !== undefined ? JSON.stringify(envelope.metadata) : null);
+            }
+        });
+        try {
+            insertAll(envelopes);
+        }
+        catch (err) {
+            if (isDuplicateSequenceViolation(err) || isDuplicateIdViolation(err)) {
+                // SQLite names the constraint, not the row, so locate the offender ourselves —
+                // an error that cannot say WHICH slot was taken sends the reader back to the log.
+                // Error path only, so the extra query costs nothing on the hot path. The
+                // transaction has rolled back, so a slot found occupied now was occupied before.
+                throw this.duplicateIn(envelopes, err);
+            }
+            throw err;
+        }
+        for (const envelope of envelopes)
+            this.notify(envelope.executionId, envelope);
+    }
+    /**
+     * Which envelope in a rejected batch claimed something already taken — a
+     * `(executionId, sequence)` slot or an envelope `id`, either because the log already held
+     * it or because another envelope in the SAME batch did. Slot first, so a writer that lost
+     * a sequence race is told THAT rather than told about the id its own naming convention
+     * derived from the sequence it lost.
+     */
+    duplicateIn(envelopes, cause) {
+        const taken = this.db.prepare("SELECT 1 AS one FROM events WHERE execution_id = ? AND sequence = ?");
+        const idTaken = this.db.prepare("SELECT 1 AS one FROM events WHERE id = ?");
+        const claimedIds = new Set();
+        const claimed = new Set();
+        for (const e of envelopes) {
+            const key = `${e.executionId}\u0000${e.sequence}`;
+            if (claimed.has(key) || taken.get(e.executionId, e.sequence) !== undefined) {
+                return new event_runtime_1.DuplicateSequenceError(e.executionId, e.sequence, cause);
+            }
+            if (claimedIds.has(e.id) || idTaken.get(e.id) !== undefined) {
+                return new event_runtime_1.DuplicateEnvelopeIdError(e.id, e.executionId, cause);
+            }
+            claimed.add(key);
+            claimedIds.add(e.id);
+        }
+        return cause instanceof Error ? cause : new Error(String(cause));
+    }
+    /**
+     * SPI 2.2.0 (ADR 0116 amendment) — existence, head and the (always 0: SQLite does not fence)
+     * token are checked and the row inserted inside ONE `BEGIN IMMEDIATE` transaction, so a
+     * retention delete or another process's append cannot slip between the check and the write.
+     */
+    async appendIfUnchanged(executionId, event, expect) {
+        if (event !== null && (expect === undefined || event.executionId !== executionId)) {
+            throw new TypeError("appendIfUnchanged: an event needs `expect` and the matching executionId");
+        }
+        const run = this.db.transaction(() => {
+            const first = this.db
+                .prepare("SELECT id, timestamp, incarnation FROM events WHERE execution_id = ? AND sequence = 0")
+                .get(executionId);
+            if (first === undefined) {
+                return { appended: false, reason: "gone", head: null, fence: 0, anchor: null };
+            }
+            // ADR 0129: the store-assigned incarnation; a pre-migration log keeps the legacy marker.
+            const anchor = first.incarnation === null ? (0, event_runtime_1.creationMarker)(first) : String(first.incarnation);
+            const tip = this.db
+                .prepare("SELECT MAX(sequence) AS tip FROM events WHERE execution_id = ?")
+                .get(executionId);
+            const head = tip?.tip ?? 0;
+            if (event === null)
+                return { appended: false, reason: "observed", head, fence: 0, anchor };
+            const want = expect;
+            if (head !== want.head ||
+                want.fence !== 0 ||
+                anchor !== want.anchor ||
+                event.sequence !== head + 1) {
+                return { appended: false, reason: "moved", head, fence: 0, anchor };
+            }
+            this.db
+                .prepare(`INSERT INTO events (id, workflow_id, execution_id, event_type, sequence, timestamp, payload, metadata)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(event.id, event.workflowId, event.executionId, event.eventType, event.sequence, event.timestamp, JSON.stringify(event.payload), event.metadata !== undefined ? JSON.stringify(event.metadata) : null);
+            return { appended: true };
+        });
+        let result;
+        try {
+            result = run.immediate();
+        }
+        catch (err) {
+            if (isDuplicateSequenceViolation(err)) {
+                throw new event_runtime_1.DuplicateSequenceError(executionId, event?.sequence ?? -1, err);
+            }
+            if (isDuplicateIdViolation(err)) {
+                throw new event_runtime_1.DuplicateEnvelopeIdError(event?.id ?? "", executionId, err);
+            }
+            throw err;
+        }
+        if (result.appended && event !== null)
+            this.notify(executionId, event);
+        return result;
+    }
+    async read(executionId) {
+        const rows = this.db
+            .prepare("SELECT * FROM events WHERE execution_id = ? ORDER BY sequence ASC")
+            .all(executionId);
+        return rows.map(rowToEnvelope);
+    }
+    async readFrom(executionId, fromSequence) {
+        const rows = this.db
+            .prepare("SELECT * FROM events WHERE execution_id = ? AND sequence >= ? ORDER BY sequence ASC")
+            .all(executionId, fromSequence);
+        return rows.map(rowToEnvelope);
+    }
+    async head(executionId) {
+        const row = this.db
+            .prepare("SELECT MAX(sequence) AS tip FROM events WHERE execution_id = ?")
+            .get(executionId);
+        return row?.tip ?? null;
+    }
+    async readRange(executionId, fromSequence, toSequence) {
+        if (toSequence < fromSequence)
+            return [];
+        const rows = this.db
+            .prepare("SELECT * FROM events WHERE execution_id = ? AND sequence >= ? AND sequence <= ? ORDER BY sequence ASC")
+            .all(executionId, fromSequence, toSequence);
+        return rows.map(rowToEnvelope);
+    }
+    async copyPrefix(fromExecutionId, toExecutionId, throughSequence, metadata) {
+        // Copy the prefix entirely inside SQLite — payload stays as stored TEXT (no
+        // JS parse/stringify), id/execution_id are re-stamped, and provenance metadata
+        // is merged via json_patch (JSON1). O(P) rows, zero JS serialization.
+        this.db
+            .prepare(`INSERT INTO events (id, workflow_id, execution_id, event_type, sequence, timestamp, payload, metadata)
+         SELECT ? || '-' || sequence, workflow_id, ?, event_type, sequence, timestamp, payload,
+                json_patch(COALESCE(metadata, '{}'), json(?))
+         FROM events WHERE execution_id = ? AND sequence <= ?`)
+            .run(toExecutionId, toExecutionId, JSON.stringify(metadata), fromExecutionId, throughSequence);
+    }
+    async subscribe(executionId, handler) {
+        return this.subscribers.add(executionId, handler);
+    }
+    async deleteExecution(executionId) {
+        this.db.prepare("DELETE FROM events WHERE execution_id = ?").run(executionId);
+    }
+    async deleteThrough(executionId, through) {
+        // ADR 0139 D8 - one statement, sequence 0 included; events above `through` are untouched.
+        this.db
+            .prepare("DELETE FROM events WHERE execution_id = ? AND sequence <= ?")
+            .run(executionId, through);
+    }
+    async truncatePrefix(executionId, throughSequence) {
+        // Preserve sequence 0 (bootstrap anchor); drop (0..throughSequence].
+        this.db
+            .prepare("DELETE FROM events WHERE execution_id = ? AND sequence > 0 AND sequence <= ?")
+            .run(executionId, throughSequence);
+    }
+    async truncatePrefixKeeping(executionId, throughSequence, keepEventTypes) {
+        // ADR 0106 — one statement: sequence 0 and every kept-type event survive in place. The
+        // kept types ride as one JSON array parameter, so the statement text never varies.
+        this.db
+            .prepare("DELETE FROM events WHERE execution_id = ? AND sequence > 0 AND sequence <= ? AND event_type NOT IN (SELECT value FROM json_each(?))")
+            .run(executionId, throughSequence, JSON.stringify(keepEventTypes));
+    }
+    async listExecutions() {
+        // The (execution_id, sequence) index makes DISTINCT a cheap index-only scan.
+        const rows = this.db
+            .prepare("SELECT DISTINCT execution_id FROM events")
+            .all();
+        return rows.map((r) => r.execution_id);
+    }
+    async listExecutionsPage(opts) {
+        // SP-1 (SPI 1.2.0) — keyset over the same index: lexicographic, bounded memory.
+        // Statements prepared lazily once (audit: no per-page re-parse on big scans).
+        const limit = opts?.limit ?? 1000;
+        this.pageFirstStmt ??= this.db.prepare("SELECT DISTINCT execution_id FROM events ORDER BY execution_id LIMIT ?");
+        this.pageAfterStmt ??= this.db.prepare("SELECT DISTINCT execution_id FROM events WHERE execution_id > ? ORDER BY execution_id LIMIT ?");
+        const rows = opts?.cursor === undefined
+            ? this.pageFirstStmt.all(limit + 1)
+            : this.pageAfterStmt.all(opts.cursor, limit + 1);
+        const executionIds = rows.slice(0, limit).map((r) => r.execution_id);
+        const last = executionIds[executionIds.length - 1];
+        return {
+            executionIds,
+            ...(rows.length > limit && last !== undefined && { nextCursor: last }),
+        };
+    }
+    async close() {
+        this.db.close();
+    }
+    notify(_executionId, event) {
+        this.subscribers.emit(event);
+    }
+}
+exports.SqliteEventStore = SqliteEventStore;
+//# sourceMappingURL=SqliteEventStore.js.map

package/dist/SqliteEventStore.js.map

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

package/dist/SqliteLeaseStore.d.ts

@@ -0,0 +1,25 @@
+import { type AcquireOptions, type Lease, type LeaseStore } from "@loomwork/event-runtime";
+/**
+ * SQLite {@link LeaseStore} (#380). Single-host by nature — better-sqlite3 is synchronous and
+ * the file is the boundary — which is the right scope for it: leases answer "which of my nodes
+ * owns this", and a single-host deployment has one. Multi-node wants Postgres.
+ */
+export declare class SqliteLeaseStore implements LeaseStore {
+    readonly scope: "host";
+    private readonly db;
+    constructor(dbPath: string);
+    acquire(executionId: string, owner: string, ttlMs: number, now?: number, options?: AcquireOptions): Promise<Lease | null>;
+    private acquireStmt;
+    private acquireOne;
+    /** Many leases in one transaction (SPI 2.2.0): per id exactly {@link acquire}, atomically. `steal` is rejected. */
+    acquireMany(executionIds: readonly string[], owner: string, ttlMs: number, now?: number, options?: AcquireOptions): Promise<Lease[]>;
+    /** The HELD set: ids whose lease `owner` still holds, extended. Never resurrects a missing row. */
+    renewMany(executionIds: readonly string[], owner: string, ttlMs: number, now?: number): Promise<string[]>;
+    releaseMany(executionIds: readonly string[], owner: string): Promise<void>;
+    renew(executionId: string, owner: string, ttlMs: number, now?: number): Promise<boolean>;
+    expired(now?: number, limit?: number): Promise<Lease[]>;
+    get(executionId: string): Promise<Lease | null>;
+    release(executionId: string, owner: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteLeaseStore.d.ts.map

package/dist/SqliteLeaseStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteLeaseStore.d.ts","sourceRoot":"","sources":["../src/SqliteLeaseStore.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,UAAU,EAIhB,MAAM,yBAAyB,CAAC;AAgBjC;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,QAAQ,CAAC,KAAK,EAAG,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM;IAOpB,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,SAAa,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IASxB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,UAAU;IAalB,mHAAmH;IAC7G,WAAW,CACf,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,SAAa,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,KAAK,EAAE,CAAC;IAenB,mGAAmG;IAC7F,SAAS,CACb,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,SAAa,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;IAWd,WAAW,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,SAAa,GACf,OAAO,CAAC,OAAO,CAAC;IAUb,OAAO,CAAC,GAAG,SAAa,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IASxD,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAO/C,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/SqliteLeaseStore.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteLeaseStore = void 0;
+const event_runtime_1 = require("@loomwork/event-runtime");
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const schema_1 = require("./schema");
+const rowToLease = (r) => ({
+    executionId: r.execution_id,
+    owner: r.owner,
+    expiresAt: r.expires_at,
+});
+/**
+ * SQLite {@link LeaseStore} (#380). Single-host by nature — better-sqlite3 is synchronous and
+ * the file is the boundary — which is the right scope for it: leases answer "which of my nodes
+ * owns this", and a single-host deployment has one. Multi-node wants Postgres.
+ */
+class SqliteLeaseStore {
+    scope = "host";
+    db;
+    constructor(dbPath) {
+        this.db = new better_sqlite3_1.default(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("synchronous = NORMAL");
+        (0, schema_1.migrate)(this.db);
+    }
+    async acquire(executionId, owner, ttlMs, now = Date.now(), options) {
+        (0, event_runtime_1.assertTtl)(ttlMs);
+        const steal = (0, event_runtime_1.assertSteal)(options);
+        return this.acquireOne(this.acquireStmt(), executionId, owner, ttlMs, now, steal);
+    }
+    // One statement, so two processes on the same file cannot both win: the insert takes a
+    // free row, and the conflict clause takes it only when it is ours, already expired, or the
+    // caller holds a steal proof (validated by `acquire` before this runs; never in a batch).
+    acquireStmt() {
+        return this.db.prepare(`INSERT INTO leases (execution_id, owner, expires_at) VALUES (?, ?, ?)
+       ON CONFLICT(execution_id) DO UPDATE SET owner = excluded.owner, expires_at = excluded.expires_at
+       WHERE leases.owner = ? OR leases.expires_at <= ? OR ? = 1`);
+    }
+    acquireOne(stmt, executionId, owner, ttlMs, now, steal) {
+        const expiresAt = now + ttlMs;
+        const info = stmt.run(executionId, owner, expiresAt, owner, now, steal ? 1 : 0);
+        return info.changes > 0 ? { executionId, owner, expiresAt } : null;
+    }
+    /** Many leases in one transaction (SPI 2.2.0): per id exactly {@link acquire}, atomically. `steal` is rejected. */
+    async acquireMany(executionIds, owner, ttlMs, now = Date.now(), options) {
+        (0, event_runtime_1.assertTtl)(ttlMs);
+        (0, event_runtime_1.assertNoBatchSteal)(options);
+        const ids = [...new Set(executionIds)];
+        const stmt = this.acquireStmt();
+        return this.db.transaction(() => {
+            const out = [];
+            for (const id of ids) {
+                const lease = this.acquireOne(stmt, id, owner, ttlMs, now, false);
+                if (lease !== null)
+                    out.push(lease);
+            }
+            return out;
+        })();
+    }
+    /** The HELD set: ids whose lease `owner` still holds, extended. Never resurrects a missing row. */
+    async renewMany(executionIds, owner, ttlMs, now = Date.now()) {
+        (0, event_runtime_1.assertTtl)(ttlMs);
+        const ids = [...new Set(executionIds)];
+        const stmt = this.db.prepare("UPDATE leases SET expires_at = ? WHERE execution_id = ? AND owner = ?");
+        return this.db.transaction(() => ids.filter((id) => stmt.run(now + ttlMs, id, owner).changes > 0))();
+    }
+    async releaseMany(executionIds, owner) {
+        const ids = [...new Set(executionIds)];
+        const stmt = this.db.prepare("DELETE FROM leases WHERE execution_id = ? AND owner = ?");
+        this.db.transaction(() => {
+            for (const id of ids)
+                stmt.run(id, owner);
+        })();
+    }
+    async renew(executionId, owner, ttlMs, now = Date.now()) {
+        (0, event_runtime_1.assertTtl)(ttlMs);
+        const info = this.db
+            .prepare("UPDATE leases SET expires_at = ? WHERE execution_id = ? AND owner = ?")
+            .run(now + ttlMs, executionId, owner);
+        return info.changes > 0;
+    }
+    async expired(now = Date.now(), limit = 100) {
+        const rows = this.db
+            .prepare("SELECT * FROM leases WHERE expires_at <= ? ORDER BY expires_at ASC LIMIT ?")
+            .all(now, limit);
+        return rows.map(rowToLease);
+    }
+    async get(executionId) {
+        const row = this.db
+            .prepare("SELECT * FROM leases WHERE execution_id = ?")
+            .get(executionId);
+        return row ? rowToLease(row) : null;
+    }
+    async release(executionId, owner) {
+        this.db
+            .prepare("DELETE FROM leases WHERE execution_id = ? AND owner = ?")
+            .run(executionId, owner);
+    }
+    async close() {
+        this.db.close();
+    }
+}
+exports.SqliteLeaseStore = SqliteLeaseStore;
+//# sourceMappingURL=SqliteLeaseStore.js.map

package/dist/SqliteLeaseStore.js.map

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

package/dist/SqliteMemoryStore.d.ts

@@ -0,0 +1,52 @@
+import type { MemoryEntry, MemorySearchOptions, MemoryStore } from "@loomwork/memory";
+/**
+ * SQLite-backed {@link MemoryStore} — the zero-server durable agent memory. Point it
+ * at the same DB file as the SqliteEventStore so one backup captures events + memory.
+ * Own idempotent migration, same pattern as SqliteTimerStore/SqliteDurableStateStore.
+ *
+ * A key names an ordered list, so the table needs an insertion key of its own: entries
+ * routinely share a timestamp and `ORDER BY timestamp` would reshuffle a conversation.
+ * `AUTOINCREMENT` (not bare rowid) makes the monotonicity a schema-level guarantee
+ * rather than an argument about rowid reuse after a `clear`.
+ *
+ * `replace` is one transaction, which is the whole reason it is on the SPI: MemoryRuntime
+ * rewrites a list on every TTL/maxEntries eviction, and a crash between the delete and the
+ * re-insert would make routine eviction the thing that loses the scope.
+ *
+ * `remove` (ADR 0091) is one indexed `DELETE` matching `json_extract(entry, '$.id')` — the
+ * id is read from the stored JSON rather than duplicated into a column, so nothing can
+ * drift between what `read` returns and what a delete matches, and a database written
+ * before this shipped needs no migration.
+ *
+ * `search` rides an FTS5 index over `searchableText(entry)`, held in an EXTERNAL-CONTENT
+ * table so the text is indexed but not stored twice, and synchronised by triggers so a
+ * `clear`/`replace` cannot leave the index describing entries that no longer exist. FTS5's
+ * `rank` is a BM25 score where LOWER is better, hence `ORDER BY rank` ascending.
+ */
+export declare class SqliteMemoryStore implements MemoryStore {
+    private readonly db;
+    private readonly appendStmt;
+    private readonly readStmt;
+    private readonly clearStmt;
+    private readonly removeStmt;
+    private readonly searchStmt;
+    private readonly replaceTxn;
+    constructor(dbPath: string);
+    append(key: string, entry: MemoryEntry): Promise<void>;
+    read(key: string): Promise<MemoryEntry[]>;
+    clear(key: string): Promise<void>;
+    replace(key: string, entries: readonly MemoryEntry[]): Promise<void>;
+    /**
+     * Delete by entry id. The FTS index needs no special handling: rows are deleted, so the
+     * existing AFTER DELETE trigger takes them out of `memory_fts` — which is the reason
+     * this is a row delete and not a rewrite of the `entry` JSON.
+     *
+     * An entry with no id has `json_extract(...) IS NULL`, and `NULL IN (...)` is NULL —
+     * never true — so anonymous entries cannot be removed by any list of ids, including one
+     * containing the strings "null" or "undefined".
+     */
+    remove(key: string, ids: readonly string[]): Promise<void>;
+    search(key: string, query: string, opts?: MemorySearchOptions): Promise<MemoryEntry[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=SqliteMemoryStore.d.ts.map

package/dist/SqliteMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteMemoryStore.d.ts","sourceRoot":"","sources":["../src/SqliteMemoryStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQtF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyD;gBAExE,MAAM,EAAE,MAAM;IAmEpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKzC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E;;;;;;;;OAQG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB1F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}