@lix-js/sdk 0.5.0-preview.1 → 0.5.0

package/dist/state/cache/create-schema-cache-table.js

@@ -0,0 +1,137 @@
+import { buildSchemaIndexStatements } from "./schema-indexes.js";
+/**
+ * Creates (or updates) a per-schema internal state cache table with core indexes.
+ * Idempotent: safe to call multiple times and on existing tables.
+ *
+ * Core choices:
+ * - STRICT + WITHOUT ROWID for compact storage and fast PK lookups
+ * - PK(entity_id, file_id, version_id) to reflect logical identity
+ * - Indexes to accelerate common access patterns used by views/benches
+ * - Partial indexes for live/tombstone scans so SQLite can skip dead rows quickly
+ */
+/**
+ * Ensures a schema-specific cache table exists and returns its physical name.
+ *
+ * The table contains a strict layout that mirrors materialized state rows and
+ * creates core indexes optimised for read-heavy cache workloads. The function is
+ * idempotent — callers may invoke it multiple times without side effects.
+ *
+ * @example
+ *
+ * ```ts
+ * const tableName = createSchemaCacheTable({
+ *   engine,
+ *   schema: definition,
+ * });
+ * console.log(tableName); // "lix_internal_state_cache_v1_example"
+ * ```
+ */
+export function createSchemaCacheTable(args) {
+    const { engine, schema } = args;
+    const schemaKey = schema["x-lix-key"];
+    if (typeof schemaKey !== "string" || schemaKey.length === 0) {
+        throw new Error("createSchemaCacheTable: schema must include a non-empty x-lix-key.");
+    }
+    const tableName = schemaKeyToCacheTableName(schemaKey);
+    // Create table if it doesn't exist
+    const createTableSql = `
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      entity_id TEXT NOT NULL,
+      schema_key TEXT NOT NULL,
+      file_id TEXT NOT NULL,
+      version_id TEXT NOT NULL,
+      plugin_key TEXT NOT NULL,
+      snapshot_content BLOB,
+      schema_version TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      inherited_from_version_id TEXT,
+      is_tombstone INTEGER DEFAULT 0,
+      change_id TEXT,
+      commit_id TEXT,
+      PRIMARY KEY (entity_id, file_id, version_id)
+    ) STRICT, WITHOUT ROWID;
+  `;
+    engine.executeSync({ sql: createTableSql, preprocessMode: "none" });
+    // Core static indexes for common access patterns
+    // 1) Fast version-scoped lookups (frequent)
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_version_id ON ${tableName} (version_id)`,
+        preprocessMode: "none",
+    });
+    // 2) Fast lookups by (version_id, file_id, entity_id) – complements PK order
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_vfe ON ${tableName} (version_id, file_id, entity_id)`,
+        preprocessMode: "none",
+    });
+    // 2b) Fast lookups when queries omit file_id (entity+version filters)
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_ve ON ${tableName} (version_id, entity_id)`,
+        preprocessMode: "none",
+    });
+    // 3) Fast scans by file within a version
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_fv ON ${tableName} (file_id, version_id)`,
+        preprocessMode: "none",
+    });
+    // 4) Partial index for live rows only to skip tombstones when applying predicates
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_live_vfe
+			ON ${tableName} (version_id, file_id, entity_id)
+			WHERE is_tombstone = 0 AND snapshot_content IS NOT NULL`,
+        preprocessMode: "none",
+    });
+    // 5) Partial index for tombstones when they are queried explicitly
+    engine.executeSync({
+        sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_tomb_vfe
+			ON ${tableName} (version_id, file_id, entity_id)
+			WHERE is_tombstone = 1 AND snapshot_content IS NULL`,
+        preprocessMode: "none",
+    });
+    // Extra expression indexes for descriptor cache
+    if (tableName === "lix_internal_state_cache_v1_lix_version_descriptor") {
+        // Speed up recursive inheritance walks by indexing the parent pointer extracted from JSON
+        engine.executeSync({
+            sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_inherits_from
+		        ON ${tableName}(json_extract(snapshot_content, '$.inherits_from_version_id'))
+		        WHERE json_extract(snapshot_content, '$.inherits_from_version_id') IS NOT NULL`,
+            preprocessMode: "none",
+        });
+        // Pair child/parent ids to avoid temp b-trees when deduping inheritance edges
+        engine.executeSync({
+            sql: `CREATE INDEX IF NOT EXISTS idx_${tableName}_id_parent
+		        ON ${tableName}(json_extract(snapshot_content, '$.id'), json_extract(snapshot_content, '$.inherits_from_version_id'))`,
+            preprocessMode: "none",
+        });
+    }
+    // Update planner stats
+    engine.executeSync({ sql: `ANALYZE ${tableName}`, preprocessMode: "none" });
+    const indexStatements = buildSchemaIndexStatements({
+        schema,
+        tableName,
+    });
+    const traceEnv = globalThis?.process?.env;
+    const traceIndexesFlag = typeof traceEnv?.LIX_TRACE_SCHEMA_INDEXES === "string" &&
+        traceEnv.LIX_TRACE_SCHEMA_INDEXES.toLowerCase() !== "false" &&
+        traceEnv.LIX_TRACE_SCHEMA_INDEXES !== "0";
+    for (const statement of indexStatements) {
+        if (traceIndexesFlag) {
+            console.debug(`createSchemaCacheTable index -> ${statement.name}: ${statement.sql}`);
+        }
+        engine.executeSync({ sql: statement.sql, preprocessMode: "none" });
+    }
+    return tableName;
+}
+/** Utility to sanitize a schema_key for use in a physical table name */
+export function schemaKeyToCacheTableName(schema_key) {
+    const sanitized = schema_key.replace(/[^a-zA-Z0-9]/g, "_");
+    return `lix_internal_state_cache_v1_${sanitized}`;
+}
+const CACHE_TABLE_PREFIX = "lix_internal_state_cache_v1_";
+export function cacheTableNameToSchemaKey(tableName) {
+    if (tableName.startsWith(CACHE_TABLE_PREFIX)) {
+        return tableName.slice(CACHE_TABLE_PREFIX.length);
+    }
+    return tableName;
+}
+//# sourceMappingURL=create-schema-cache-table.js.map

package/dist/state/cache/create-schema-cache-table.js.map

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

package/dist/state/cache/create-schema-cache-table.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-schema-cache-table.test.d.ts.map

package/dist/state/cache/create-schema-cache-table.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-schema-cache-table.test.d.ts","sourceRoot":"","sources":["../../../src/state/cache/create-schema-cache-table.test.ts"],"names":[],"mappings":""}

package/dist/state/cache/create-schema-cache-table.test.js

@@ -0,0 +1,49 @@
+import { test, expect } from "vitest";
+import { openLix } from "../../lix/open-lix.js";
+import { createSchemaCacheTable, schemaKeyToCacheTableName, } from "./create-schema-cache-table.js";
+const TEST_CACHE_SCHEMA = {
+    "x-lix-key": "lix_test_create",
+    "x-lix-version": "1.0",
+    type: "object",
+    additionalProperties: false,
+    properties: {},
+};
+test("createSchemaCacheTable creates table with core indexes and is idempotent", async () => {
+    const lix = await openLix({});
+    const tableName = schemaKeyToCacheTableName(TEST_CACHE_SCHEMA["x-lix-key"]);
+    // First call should create the table and indexes
+    createSchemaCacheTable({ engine: lix.engine, schema: TEST_CACHE_SCHEMA });
+    // Verify table exists and WITHOUT ROWID
+    const tbl = lix.engine.sqlite.exec({
+        sql: `SELECT name, sql FROM sqlite_schema WHERE type='table' AND name = ?`,
+        bind: [tableName],
+        returnValue: "resultRows",
+        rowMode: "object",
+    });
+    expect(tbl?.[0]?.name).toBe(tableName);
+    expect(String(tbl?.[0]?.sql || "")).toMatch(/WITHOUT ROWID/);
+    // Verify core indexes exist
+    const idxRows = lix.engine.sqlite.exec({
+        sql: `SELECT name, sql FROM sqlite_schema WHERE type='index' AND tbl_name = ? ORDER BY name`,
+        bind: [tableName],
+        returnValue: "resultRows",
+        rowMode: "object",
+    });
+    const names = new Set(idxRows.map((r) => r.name));
+    expect(Array.from(names)).toEqual(expect.arrayContaining([
+        `idx_${tableName}_version_id`,
+        `idx_${tableName}_vfe`,
+        `idx_${tableName}_fv`,
+    ]));
+    // Second call should be a no-op (idempotent)
+    createSchemaCacheTable({ engine: lix.engine, schema: TEST_CACHE_SCHEMA });
+    const idxRows2 = lix.engine.sqlite.exec({
+        sql: `SELECT name FROM sqlite_schema WHERE type='index' AND tbl_name = ?`,
+        bind: [tableName],
+        returnValue: "resultRows",
+    });
+    // Still contains the same three core indexes (no duplicates)
+    const idxCount = idxRows2.filter((r) => String(r?.[0] || "").startsWith(`idx_${tableName}_`)).length;
+    expect(idxCount).toBeGreaterThanOrEqual(3);
+});
+//# sourceMappingURL=create-schema-cache-table.test.js.map

package/dist/state/cache/create-schema-cache-table.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-schema-cache-table.test.js","sourceRoot":"","sources":["../../../src/state/cache/create-schema-cache-table.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EACN,sBAAsB,EACtB,yBAAyB,GACzB,MAAM,gCAAgC,CAAC;AAGxC,MAAM,iBAAiB,GAAG;IACzB,WAAW,EAAE,iBAAiB;IAC9B,eAAe,EAAE,KAAK;IACtB,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,UAAU,EAAE,EAAE;CACyB,CAAC;AAEzC,IAAI,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;IAC3F,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5E,iDAAiD;IACjD,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAE3E,wCAAwC;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,GAAG,EAAE,qEAAqE;QAC1E,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,QAAQ;KACjB,CAAU,CAAC;IAEZ,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7D,4BAA4B;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACvC,GAAG,EAAE,uFAAuF;QAC5F,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,QAAQ;KACjB,CAAoC,CAAC;IAEtC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAChC,MAAM,CAAC,eAAe,CAAC;QACtB,OAAO,SAAS,aAAa;QAC7B,OAAO,SAAS,MAAM;QACtB,OAAO,SAAS,KAAK;KACrB,CAAC,CACF,CAAC;IAEF,6CAA6C;IAC7C,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAE3E,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACxC,GAAG,EAAE,oEAAoE;QACzE,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,WAAW,EAAE,YAAY;KACzB,CAAe,CAAC;IAEjB,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,SAAS,GAAG,CAAC,CACpD,CAAC,MAAM,CAAC;IACT,MAAM,CAAC,QAAQ,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC"}

package/dist/state/cache/is-stale-state-cache.d.ts

@@ -1,5 +1,27 @@
-import type { Lix } from "../../lix/open-lix.js";
+import type { LixEngine } from "../../engine/boot.js";
+/**
+ * Memoize the stale flag for a given SQLite connection.
+ */
+export declare function setStaleStateCacheMemo(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    value: boolean;
+}): void;
+/**
+ * Remove the cached stale flag so the next read re-queries SQLite.
+ */
+export declare function invalidateStaleStateCacheMemo(args: {
+    engine: Pick<LixEngine, "executeSync">;
+}): void;
+/**
+ * Determine whether the state cache needs to be repopulated.
+ *
+ * The result is cached per SQLite connection and automatically invalidated
+ * whenever the `lix_state_cache_stale` key changes via `onStateCommit`.
+ *
+ * @example
+ * const stale = isStaleStateCache({ engine: lix.engine! });
+ */
 export declare function isStaleStateCache(args: {
-    lix: Pick<Lix, "sqlite" | "db">;
+    engine: Pick<LixEngine, "executeSync" | "hooks">;
 }): boolean;
 //# sourceMappingURL=is-stale-state-cache.d.ts.map

package/dist/state/cache/is-stale-state-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-stale-state-cache.d.ts","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAIjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;CAChC,GAAG,OAAO,CAmBV"}
+{"version":3,"file":"is-stale-state-cache.d.ts","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAStD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,OAAO,CAAC;CACf,GAAG,IAAI,CAEP;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IACnD,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;CACvC,GAAG,IAAI,CAEP;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;CACjD,GAAG,OAAO,CAyBV"}

package/dist/state/cache/is-stale-state-cache.js

@@ -1,22 +1,64 @@
 import { sql } from "kysely";
-import { executeSync } from "../../database/execute-sync.js";
+import { internalQueryBuilder } from "../../engine/internal-query-builder.js";
 const CACHE_STALE_KEY = "lix_state_cache_stale";
-export function isStaleStateCache(args) {
-    // Query the resolved view directly to avoid recursion on the vtable itself
-    const res = executeSync({
-        lix: args.lix,
-        query: args.lix.db
-            .selectFrom("internal_resolved_state_all")
-            .where("entity_id", "=", CACHE_STALE_KEY)
-            .where("schema_key", "=", "lix_key_value")
-            .where("version_id", "=", "global")
-            .select(sql `json_extract(snapshot_content, '$.value')`.as("value")),
-    });
-    // If no flag exists, cache is stale by default
+const CACHE_SCHEMA_KEY = "lix_key_value";
+const staleStateCache = new WeakMap();
+const hookListeners = new WeakSet();
+/**
+ * Memoize the stale flag for a given SQLite connection.
+ */
+export function setStaleStateCacheMemo(args) {
+    staleStateCache.set(args.engine.executeSync, args.value);
+}
+/**
+ * Remove the cached stale flag so the next read re-queries SQLite.
+ */
+export function invalidateStaleStateCacheMemo(args) {
+    staleStateCache.delete(args.engine.executeSync);
+}
+function readStaleFlag(engine) {
+    const res = engine.executeSync(internalQueryBuilder
+        .selectFrom("lix_internal_state_vtable")
+        .where("entity_id", "=", CACHE_STALE_KEY)
+        .where("schema_key", "=", CACHE_SCHEMA_KEY)
+        .where("version_id", "=", "global")
+        .where("inherited_from_version_id", "is", null)
+        .where("snapshot_content", "is not", null)
+        .select(sql `json_extract(snapshot_content, '$.value')`.as("value"))
+        .compile()).rows;
     if (!res || res.length === 0) {
         return true;
     }
-    // Parse the snapshot content to get the value
     return res[0]?.value == true;
 }
+/**
+ * Determine whether the state cache needs to be repopulated.
+ *
+ * The result is cached per SQLite connection and automatically invalidated
+ * whenever the `lix_state_cache_stale` key changes via `onStateCommit`.
+ *
+ * @example
+ * const stale = isStaleStateCache({ engine: lix.engine! });
+ */
+export function isStaleStateCache(args) {
+    const { engine } = args;
+    if (!hookListeners.has(args.engine.hooks)) {
+        hookListeners.add(args.engine.hooks);
+        engine.hooks.onStateCommit(({ changes }) => {
+            for (const change of changes) {
+                if (change.entity_id === CACHE_STALE_KEY &&
+                    change.schema_key === CACHE_SCHEMA_KEY) {
+                    invalidateStaleStateCacheMemo({ engine });
+                    break;
+                }
+            }
+        });
+    }
+    if (staleStateCache.has(args.engine.executeSync)) {
+        return staleStateCache.get(args.engine.executeSync);
+    }
+    const result = readStaleFlag(args.engine);
+    setStaleStateCacheMemo({ engine, value: result });
+    return result;
+}
 //# sourceMappingURL=is-stale-state-cache.js.map

package/dist/state/cache/is-stale-state-cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-stale-state-cache.js","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAe,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,iBAAiB,CAAC,IAEjC;IACA,2EAA2E;IAC3E,MAAM,GAAG,GAAG,WAAW,CAAC;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAG,IAAI,CAAC,GAAG,CAAC,EAAmD;aAClE,UAAU,CAAC,6BAA6B,CAAC;aACzC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,eAAe,CAAC;aACxC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,eAAe,CAAC;aACzC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC;aAClC,MAAM,CAAC,GAAG,CAAA,2CAA2C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;KACpE,CAAC,CAAC;IAEH,+CAA+C;IAC/C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,8CAA8C;IAC9C,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"is-stale-state-cache.js","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC,MAAM,eAAe,GAAG,IAAI,OAAO,EAAgB,CAAC;AACpD,MAAM,aAAa,GAAG,IAAI,OAAO,EAAU,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACA,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAE7C;IACA,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,MAAsC;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAC7B,oBAAoB;SAClB,UAAU,CAAC,2BAA2B,CAAC;SACvC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,eAAe,CAAC;SACxC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,gBAAgB,CAAC;SAC1C,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC;SAClC,KAAK,CAAC,2BAA2B,EAAE,IAAI,EAAE,IAAI,CAAC;SAC9C,KAAK,CAAC,kBAAkB,EAAE,QAAQ,EAAE,IAAI,CAAC;SACzC,MAAM,CAAC,GAAG,CAAA,2CAA2C,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;SAClE,OAAO,EAAE,CACX,CAAC,IAAI,CAAC;IAEP,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAEjC;IACA,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC9B,IACC,MAAM,CAAC,SAAS,KAAK,eAAe;oBACpC,MAAM,CAAC,UAAU,KAAK,gBAAgB,EACrC,CAAC;oBACF,6BAA6B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC1C,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAE,CAAC;IACtD,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,sBAAsB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/state/cache/is-stale-state-cache.test.js

@@ -1,27 +1,30 @@
 import { test, expect } from "vitest";
 import { isStaleStateCache } from "./is-stale-state-cache.js";
 import { clearStateCache } from "./clear-state-cache.js";
+import { markStateCacheAsFresh, markStateCacheAsStale, } from "./mark-state-cache-as-stale.js";
 import { openLix } from "../../lix/open-lix.js";
 test("cache is stale after cache clear", async () => {
     const lix = await openLix({});
-    const internalDb = lix.db;
-    // Insert some data to ensure cache is populated
-    await lix.db
-        .insertInto("key_value")
-        .values({
-        key: "test_key",
-        value: "test_value",
-    })
-        .execute();
-    const cache = await internalDb
-        .selectFrom("internal_state_cache")
-        .selectAll()
-        .execute();
-    expect(cache.length).toBeGreaterThan(0);
-    // Clear the cache
-    clearStateCache({ lix });
-    // Cache should be stale after clearing
-    const result = isStaleStateCache({ lix });
-    expect(result).toBe(true);
+    // Start with a known fresh flag and warm the cached value
+    markStateCacheAsStale({ engine: lix.engine });
+    markStateCacheAsFresh({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCache({ engine: lix.engine })).toBe(false);
+    // Clearing should flip the flag back to stale and invalidate the memoized result
+    clearStateCache({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCache({ engine: lix.engine })).toBe(true);
+});
+test("cached stale flag invalidates when the key toggles", async () => {
+    const lix = await openLix({});
+    markStateCacheAsStale({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCache({ engine: lix.engine })).toBe(true);
+    markStateCacheAsFresh({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCache({ engine: lix.engine })).toBe(false);
+    markStateCacheAsStale({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCache({ engine: lix.engine })).toBe(true);
 });
 //# sourceMappingURL=is-stale-state-cache.test.js.map

package/dist/state/cache/is-stale-state-cache.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"is-stale-state-cache.test.js","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAIhD,IAAI,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;IACnD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,EAAkD,CAAC;IAE1E,gDAAgD;IAChD,MAAM,GAAG,CAAC,EAAE;SACV,UAAU,CAAC,WAAW,CAAC;SACvB,MAAM,CAAC;QACP,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,YAAY;KACnB,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,MAAM,KAAK,GAAG,MAAM,UAAU;SAC5B,UAAU,CAAC,sBAAsB,CAAC;SAClC,SAAS,EAAE;SACX,OAAO,EAAE,CAAC;IAEZ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAExC,kBAAkB;IAClB,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAEzB,uCAAuC;IACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"is-stale-state-cache.test.js","sourceRoot":"","sources":["../../../src/state/cache/is-stale-state-cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACN,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,IAAI,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;IACnD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC/C,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE/D,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACrE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9D,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE/D,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC"}

package/dist/state/cache/mark-state-cache-as-stale.d.ts

@@ -1,10 +1,10 @@
-import type { Lix } from "../../lix/open-lix.js";
+import type { LixEngine } from "../../engine/boot.js";
 export declare function markStateCacheAsStale(args: {
-    lix: Pick<Lix, "sqlite" | "db">;
+    engine: Pick<LixEngine, "sqlite" | "hooks" | "executeSync" | "runtimeCacheRef">;
     timestamp?: string;
 }): void;
 export declare function markStateCacheAsFresh(args: {
-    lix: Pick<Lix, "sqlite" | "db">;
+    engine: Pick<LixEngine, "hooks" | "executeSync" | "runtimeCacheRef">;
     timestamp?: string;
 }): void;
 //# sourceMappingURL=mark-state-cache-as-stale.d.ts.map

package/dist/state/cache/mark-state-cache-as-stale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mark-state-cache-as-stale.d.ts","sourceRoot":"","sources":["../../../src/state/cache/mark-state-cache-as-stale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAOjD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAiBP;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAoBP"}
+{"version":3,"file":"mark-state-cache-as-stale.d.ts","sourceRoot":"","sources":["../../../src/state/cache/mark-state-cache-as-stale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,IAAI,CACX,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,iBAAiB,CACtD,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAuBP;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,iBAAiB,CAAC,CAAC;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CAuBP"}

package/dist/state/cache/mark-state-cache-as-stale.js

@@ -1,42 +1,50 @@
-import { LixKeyValueSchema } from "../../key-value/schema.js";
-import { timestamp } from "../../deterministic/timestamp.js";
+import { getTimestampSync } from "../../engine/functions/timestamp.js";
+import { LixKeyValueSchema } from "../../key-value/schema-definition.js";
 import { updateUntrackedState } from "../untracked/update-untracked-state.js";
+import { setStaleStateCacheMemo } from "./is-stale-state-cache.js";
 const CACHE_STALE_KEY = "lix_state_cache_stale";
 export function markStateCacheAsStale(args) {
-    // Set the cache stale flag to "true" in untracked state
-    const snapshotContent = JSON.stringify({ key: CACHE_STALE_KEY, value: true });
+    const createdAt = args.timestamp ?? getTimestampSync({ engine: args.engine });
     updateUntrackedState({
-        lix: args.lix,
-        change: {
-            entity_id: CACHE_STALE_KEY,
-            schema_key: LixKeyValueSchema["x-lix-key"],
-            file_id: "lix",
-            plugin_key: "lix_own_entity",
-            snapshot_content: snapshotContent,
-            schema_version: LixKeyValueSchema["x-lix-version"],
-            created_at: args.timestamp ?? timestamp({ lix: args.lix }),
-        },
-        version_id: "global",
+        engine: args.engine,
+        changes: [
+            {
+                entity_id: CACHE_STALE_KEY,
+                schema_key: LixKeyValueSchema["x-lix-key"],
+                file_id: "lix",
+                plugin_key: "lix_sdk",
+                snapshot_content: JSON.stringify({
+                    key: CACHE_STALE_KEY,
+                    value: true,
+                }),
+                schema_version: LixKeyValueSchema["x-lix-version"],
+                created_at: createdAt,
+                lixcol_version_id: "global",
+            },
+        ],
     });
+    setStaleStateCacheMemo({ engine: args.engine, value: true });
 }
 export function markStateCacheAsFresh(args) {
-    // Set the cache stale flag to "false" in untracked state
-    const snapshotContent = JSON.stringify({
-        key: CACHE_STALE_KEY,
-        value: false,
-    });
+    const createdAt = args.timestamp ?? getTimestampSync({ engine: args.engine });
     updateUntrackedState({
-        lix: args.lix,
-        change: {
-            entity_id: CACHE_STALE_KEY,
-            schema_key: LixKeyValueSchema["x-lix-key"],
-            file_id: "lix",
-            plugin_key: "lix_own_entity",
-            snapshot_content: snapshotContent,
-            schema_version: LixKeyValueSchema["x-lix-version"],
-            created_at: args.timestamp ?? timestamp({ lix: args.lix }),
-        },
-        version_id: "global",
+        engine: args.engine,
+        changes: [
+            {
+                entity_id: CACHE_STALE_KEY,
+                schema_key: LixKeyValueSchema["x-lix-key"],
+                file_id: "lix",
+                plugin_key: "lix_sdk",
+                snapshot_content: JSON.stringify({
+                    key: CACHE_STALE_KEY,
+                    value: false,
+                }),
+                schema_version: LixKeyValueSchema["x-lix-version"],
+                created_at: createdAt,
+                lixcol_version_id: "global",
+            },
+        ],
     });
+    setStaleStateCacheMemo({ engine: args.engine, value: false });
 }
 //# sourceMappingURL=mark-state-cache-as-stale.js.map

package/dist/state/cache/mark-state-cache-as-stale.js.map

@@ -1 +1 @@
-{"version":3,"file":"mark-state-cache-as-stale.js","sourceRoot":"","sources":["../../../src/state/cache/mark-state-cache-as-stale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAE9E,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACA,wDAAwD;IACxD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9E,oBAAoB,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE;YACP,SAAS,EAAE,eAAe;YAC1B,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC;YAC1C,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,gBAAgB;YAC5B,gBAAgB,EAAE,eAAe;YACjC,cAAc,EAAE,iBAAiB,CAAC,eAAe,CAAC;YAClD,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;SAC1D;QACD,UAAU,EAAE,QAAQ;KACpB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACA,yDAAyD;IACzD,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC;QACtC,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,oBAAoB,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE;YACP,SAAS,EAAE,eAAe;YAC1B,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC;YAC1C,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,gBAAgB;YAC5B,gBAAgB,EAAE,eAAe;YACjC,cAAc,EAAE,iBAAiB,CAAC,eAAe,CAAC;YAClD,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;SAC1D;QACD,UAAU,EAAE,QAAQ;KACpB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"mark-state-cache-as-stale.js","sourceRoot":"","sources":["../../../src/state/cache/mark-state-cache-as-stale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,IAMrC;IACA,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E,oBAAoB,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE;YACR;gBACC,SAAS,EAAE,eAAe;gBAC1B,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC;gBAC1C,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,SAAS;gBACrB,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC;oBAChC,GAAG,EAAE,eAAe;oBACpB,KAAK,EAAE,IAAI;iBACX,CAAC;gBACF,cAAc,EAAE,iBAAiB,CAAC,eAAe,CAAC;gBAClD,UAAU,EAAE,SAAS;gBACrB,iBAAiB,EAAE,QAAQ;aAC3B;SACD;KACD,CAAC,CAAC;IAEH,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACA,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E,oBAAoB,CAAC;QACpB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE;YACR;gBACC,SAAS,EAAE,eAAe;gBAC1B,UAAU,EAAE,iBAAiB,CAAC,WAAW,CAAC;gBAC1C,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,SAAS;gBACrB,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC;oBAChC,GAAG,EAAE,eAAe;oBACpB,KAAK,EAAE,KAAK;iBACZ,CAAC;gBACF,cAAc,EAAE,iBAAiB,CAAC,eAAe,CAAC;gBAClD,UAAU,EAAE,SAAS;gBACrB,iBAAiB,EAAE,QAAQ;aAC3B;SACD;KACD,CAAC,CAAC;IAEH,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/state/cache/populate-state-cache.d.ts

@@ -1,9 +1,19 @@
-import type { SqliteWasmDatabase } from "sqlite-wasm-kysely";
-export interface PopulateStateCacheOptions {
+import type { LixEngine } from "../../engine/boot.js";
+export interface PopulateStateCacheV2Options {
     version_id?: string;
-    entity_id?: string;
-    schema_key?: string;
-    file_id?: string;
 }
-export declare function populateStateCache(sqlite: SqliteWasmDatabase, options?: PopulateStateCacheOptions): void;
+/**
+ * Populates the state cache v2 from the materializer view.
+ *
+ * This function reads from the materialized state and writes to the per-schema
+ * physical cache tables. If a version_id is provided, it also populates the
+ * cache for all ancestor versions.
+ *
+ * @param lix - The Lix instance with sqlite and db
+ * @param options - Optional filters for selective population
+ */
+export declare function populateStateCache(args: {
+    engine: Pick<LixEngine, "sqlite" | "executeSync" | "runtimeCacheRef" | "hooks">;
+    options?: PopulateStateCacheV2Options;
+}): void;
 //# sourceMappingURL=populate-state-cache.d.ts.map

package/dist/state/cache/populate-state-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populate-state-cache.d.ts","sourceRoot":"","sources":["../../../src/state/cache/populate-state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,yBAAyB;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,yBAA8B,GACrC,IAAI,CA+GN"}
+{"version":3,"file":"populate-state-cache.d.ts","sourceRoot":"","sources":["../../../src/state/cache/populate-state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAUtD,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,IAAI,CACX,SAAS,EACT,QAAQ,GAAG,aAAa,GAAG,iBAAiB,GAAG,OAAO,CACtD,CAAC;IACF,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACtC,GAAG,IAAI,CAoMP"}