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

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

@@ -0,0 +1,64 @@
+import { sql } from "kysely";
+import { internalQueryBuilder } from "../../engine/internal-query-builder.js";
+const CACHE_STALE_KEY = "lix_state_cache_stale";
+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 setStaleStateCacheMemoV2(args) {
+    staleStateCache.set(args.engine.executeSync, args.value);
+}
+/**
+ * Remove the cached stale flag so the next read re-queries SQLite.
+ */
+export function invalidateStaleStateCacheMemoV2(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;
+    }
+    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 = isStaleStateCacheV2({ engine: lix.engine! });
+ */
+export function isStaleStateCacheV2(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) {
+                    invalidateStaleStateCacheMemoV2({ engine });
+                    break;
+                }
+            }
+        });
+    }
+    if (staleStateCache.has(args.engine.executeSync)) {
+        return staleStateCache.get(args.engine.executeSync);
+    }
+    const result = readStaleFlag(args.engine);
+    setStaleStateCacheMemoV2({ engine, value: result });
+    return result;
+}
+//# sourceMappingURL=is-stale-state-cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is-stale-state-cache.js","sourceRoot":"","sources":["../../../src/state/cache-v2/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,wBAAwB,CAAC,IAGxC;IACA,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAE/C;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,mBAAmB,CAAC,IAEnC;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,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC5C,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,wBAAwB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=is-stale-state-cache.test.d.ts.map

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

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

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

@@ -0,0 +1,30 @@
+import { test, expect } from "vitest";
+import { isStaleStateCacheV2 } from "./is-stale-state-cache.js";
+import { clearStateCacheV2 } from "./clear-state-cache.js";
+import { markStateCacheAsFreshV2, markStateCacheAsStaleV2, } from "./mark-state-cache-as-stale.js";
+import { openLix } from "../../lix/open-lix.js";
+test("cache v2 is stale after cache clear", async () => {
+    const lix = await openLix({});
+    // Start with a known fresh flag and warm the cached value
+    markStateCacheAsStaleV2({ engine: lix.engine });
+    markStateCacheAsFreshV2({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCacheV2({ engine: lix.engine })).toBe(false);
+    // Clearing should flip the flag back to stale and invalidate the memoized result
+    clearStateCacheV2({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCacheV2({ engine: lix.engine })).toBe(true);
+});
+test("cached stale flag invalidates when the key toggles", async () => {
+    const lix = await openLix({});
+    markStateCacheAsStaleV2({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCacheV2({ engine: lix.engine })).toBe(true);
+    markStateCacheAsFreshV2({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCacheV2({ engine: lix.engine })).toBe(false);
+    markStateCacheAsStaleV2({ engine: lix.engine });
+    await Promise.resolve();
+    expect(isStaleStateCacheV2({ engine: lix.engine })).toBe(true);
+});
+//# sourceMappingURL=is-stale-state-cache.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"is-stale-state-cache.test.js","sourceRoot":"","sources":["../../../src/state/cache-v2/is-stale-state-cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACN,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;IACtD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,0DAA0D;IAC1D,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACjD,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEjE,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IAC3C,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;IACrE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhE,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEjE,uBAAuB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { LixEngine } from "../../engine/boot.js";
+/**
+ * Mark the cache v2 as stale to trigger repopulation on next read.
+ *
+ * @example
+ * markStateCacheAsStaleV2({ engine: lix.engine! });
+ */
+export declare function markStateCacheAsStaleV2(args: {
+    engine: Pick<LixEngine, "sqlite" | "hooks" | "executeSync" | "runtimeCacheRef">;
+    timestamp?: string;
+}): void;
+/**
+ * Mark the cache v2 as fresh after a successful repopulation.
+ *
+ * @example
+ * markStateCacheAsFreshV2({ engine: lix.engine! });
+ */
+export declare function markStateCacheAsFreshV2(args: {
+    engine: Pick<LixEngine, "hooks" | "executeSync" | "runtimeCacheRef">;
+    timestamp?: string;
+}): void;
+//# sourceMappingURL=mark-state-cache-as-stale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mark-state-cache-as-stale.d.ts","sourceRoot":"","sources":["../../../src/state/cache-v2/mark-state-cache-as-stale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC7C,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;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC7C,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-v2/mark-state-cache-as-stale.js

@@ -0,0 +1,62 @@
+import { getTimestampSync } from "../../engine/functions/timestamp.js";
+import { LixKeyValueSchema } from "../../key-value/schema-definition.js";
+import { updateUntrackedState } from "../untracked/update-untracked-state.js";
+import { setStaleStateCacheMemoV2 } from "./is-stale-state-cache.js";
+const CACHE_STALE_KEY = "lix_state_cache_stale";
+/**
+ * Mark the cache v2 as stale to trigger repopulation on next read.
+ *
+ * @example
+ * markStateCacheAsStaleV2({ engine: lix.engine! });
+ */
+export function markStateCacheAsStaleV2(args) {
+    const createdAt = args.timestamp ?? getTimestampSync({ engine: args.engine });
+    updateUntrackedState({
+        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",
+            },
+        ],
+    });
+    setStaleStateCacheMemoV2({ engine: args.engine, value: true });
+}
+/**
+ * Mark the cache v2 as fresh after a successful repopulation.
+ *
+ * @example
+ * markStateCacheAsFreshV2({ engine: lix.engine! });
+ */
+export function markStateCacheAsFreshV2(args) {
+    const createdAt = args.timestamp ?? getTimestampSync({ engine: args.engine });
+    updateUntrackedState({
+        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",
+            },
+        ],
+    });
+    setStaleStateCacheMemoV2({ engine: args.engine, value: false });
+}
+//# sourceMappingURL=mark-state-cache-as-stale.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mark-state-cache-as-stale.js","sourceRoot":"","sources":["../../../src/state/cache-v2/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,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAMvC;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,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAGvC;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,wBAAwB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { LixEngine } from "../../engine/boot.js";
+export interface PopulateStateCacheV2Options {
+    version_id?: string;
+}
+/**
+ * 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
+ *
+ * @example
+ * populateStateCacheV2({ engine: lix.engine! });
+ */
+export declare function populateStateCacheV2(args: {
+    engine: Pick<LixEngine, "sqlite" | "executeSync" | "runtimeCacheRef" | "hooks">;
+    options?: PopulateStateCacheV2Options;
+}): void;
+//# sourceMappingURL=populate-state-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"populate-state-cache.d.ts","sourceRoot":"","sources":["../../../src/state/cache-v2/populate-state-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAStD,MAAM,WAAW,2BAA2B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,IAAI,CACX,SAAS,EACT,QAAQ,GAAG,aAAa,GAAG,iBAAiB,GAAG,OAAO,CACtD,CAAC;IACF,OAAO,CAAC,EAAE,2BAA2B,CAAC;CACtC,GAAG,IAAI,CA6IP"}

package/dist/state/cache-v2/populate-state-cache.js

@@ -0,0 +1,143 @@
+import { updateStateCacheV2 } from "./update-state-cache.js";
+import { getStateCacheV2Tables, getStateCacheV2Columns, clearStateCacheV2Columns, } from "./schema.js";
+/**
+ * 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
+ *
+ * @example
+ * populateStateCacheV2({ engine: lix.engine! });
+ */
+export function populateStateCacheV2(args) {
+    const { sqlite } = args.engine;
+    const options = args.options ?? {};
+    let versionsToPopulate;
+    if (options.version_id) {
+        // When a specific version is requested, also include all its ancestors
+        // This ensures the resolved view can access inherited state
+        // Use the materializer's version ancestry view to find all ancestors
+        const ancestorRows = sqlite.exec({
+            sql: `
+				SELECT DISTINCT ancestor_version_id as version_id
+				FROM lix_internal_materialization_version_ancestry
+				WHERE version_id = ?
+			`,
+            bind: [options.version_id],
+            returnValue: "resultRows",
+            rowMode: "array",
+        });
+        // The ancestry view includes the version itself and all its ancestors
+        versionsToPopulate =
+            ancestorRows.length > 0
+                ? ancestorRows.map((row) => row[0])
+                : [options.version_id];
+    }
+    else {
+        // If no version_id specified, populate all active versions (with tips)
+        const tipRows = sqlite.exec({
+            sql: `SELECT version_id FROM lix_internal_materialization_version_tips`,
+            returnValue: "resultRows",
+            rowMode: "array",
+        });
+        versionsToPopulate = tipRows.map((row) => row[0]);
+    }
+    if (versionsToPopulate.length === 0) {
+        return;
+    }
+    // Clear existing cache entries for the versions being populated
+    const existingTables = sqlite.exec({
+        sql: `SELECT name FROM sqlite_schema 
+		      WHERE type='table' 
+		      AND name LIKE 'lix_internal_state_cache_v2_%'`,
+        returnValue: "resultRows",
+    });
+    const tableCache = getStateCacheV2Tables({ engine: args.engine });
+    const placeholders = versionsToPopulate.map(() => "?").join(",");
+    for (const row of existingTables ?? []) {
+        const tableName = row?.[0];
+        if (!tableName)
+            continue;
+        const columns = getStateCacheV2Columns({
+            engine: args.engine,
+            tableName,
+        });
+        if (!columns.has("version_id")) {
+            sqlite.exec({ sql: `DROP TABLE ${tableName}` });
+            clearStateCacheV2Columns({ engine: args.engine, tableName });
+            tableCache.delete(tableName);
+            continue;
+        }
+        tableCache.add(tableName);
+        sqlite.exec({
+            sql: `DELETE FROM ${tableName} WHERE version_id IN (${placeholders})`,
+            bind: versionsToPopulate,
+        });
+    }
+    // Query materialized state to get changes for all required versions
+    const selectPlaceholders = versionsToPopulate.map(() => "?").join(",");
+    const selectSql = `
+		SELECT 
+			m.entity_id,
+			m.schema_key,
+			m.file_id,
+			m.version_id,
+			m.plugin_key,
+			m.snapshot_content,
+			m.schema_version,
+			m.created_at,
+			m.updated_at,
+			m.change_id,
+			m.commit_id,
+			m.inherited_from_version_id
+		FROM lix_internal_state_materializer m
+		WHERE m.version_id IN (${selectPlaceholders})
+		  AND m.inherited_from_version_id IS NULL
+	`;
+    const results = sqlite.exec({
+        sql: selectSql,
+        bind: versionsToPopulate,
+        returnValue: "resultRows",
+        rowMode: "object",
+    });
+    if (!results || results.length === 0) {
+        return;
+    }
+    const materializedChanges = results.map((row) => {
+        const changeId = row.change_id ??
+            `${row.schema_key}:${row.entity_id}:${row.version_id}:materializer`;
+        const commitId = row.commit_id ??
+            row.change_id ??
+            `${row.version_id}:${row.entity_id}:materializer`;
+        return {
+            id: changeId,
+            entity_id: row.entity_id,
+            schema_key: row.schema_key,
+            schema_version: row.schema_version,
+            file_id: row.file_id,
+            plugin_key: row.plugin_key,
+            snapshot_content: row.snapshot_content,
+            created_at: row.created_at,
+            metadata: null,
+            version_id: row.version_id,
+            commit_id: commitId,
+            lixcol_version_id: row.version_id,
+            lixcol_commit_id: commitId,
+            inherited_from_version_id: row.inherited_from_version_id,
+        };
+    });
+    updateStateCacheV2({
+        engine: {
+            executeSync: args.engine.executeSync,
+            runtimeCacheRef: args.engine.runtimeCacheRef,
+            hooks: args.engine.hooks,
+            sqlite: args.engine.sqlite,
+        },
+        changes: materializedChanges,
+    });
+}
+//# sourceMappingURL=populate-state-cache.js.map

package/dist/state/cache-v2/populate-state-cache.js.map

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

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

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

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

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

package/dist/state/cache-v2/populate-state-cache.test.js

@@ -0,0 +1,102 @@
+import { expect, test } from "vitest";
+import { openLix } from "../../lix/open-lix.js";
+import { populateStateCacheV2 } from "./populate-state-cache.js";
+import { getTimestamp } from "../../engine/functions/timestamp.js";
+import { updateStateCache } from "../cache/update-state-cache.js";
+import { LixStoredSchemaSchema } from "../../stored-schema/schema-definition.js";
+import { schemaKeyToCacheTableNameV2 } from "./create-schema-cache-table.js";
+const cacheTable = (schemaKey, schemaVersion = "1.0") => schemaKeyToCacheTableNameV2(schemaKey, schemaVersion);
+function selectCacheRows(sqlite, schemaKey, schemaVersion = "1.0") {
+    return (sqlite.exec({
+        sql: `SELECT * FROM ${cacheTable(schemaKey, schemaVersion)}`,
+        returnValue: "resultRows",
+        rowMode: "object",
+    }) ?? []);
+}
+async function registerStoredSchema(lix, schemaKey) {
+    const entityId = `${schemaKey}~1.0`;
+    const timestamp = new Date().toISOString();
+    await updateStateCache({
+        engine: lix.engine,
+        changes: [
+            {
+                id: `delete-${entityId}`,
+                entity_id: entityId,
+                schema_key: LixStoredSchemaSchema["x-lix-key"],
+                schema_version: LixStoredSchemaSchema["x-lix-version"],
+                file_id: "lix",
+                plugin_key: "lix_sdk",
+                snapshot_content: null,
+                created_at: timestamp,
+            },
+        ],
+        commit_id: `delete-${entityId}`,
+        version_id: "global",
+    });
+    await updateStateCache({
+        engine: lix.engine,
+        changes: [
+            {
+                id: `insert-${entityId}`,
+                entity_id: entityId,
+                schema_key: LixStoredSchemaSchema["x-lix-key"],
+                schema_version: LixStoredSchemaSchema["x-lix-version"],
+                file_id: "lix",
+                plugin_key: "lix_sdk",
+                snapshot_content: JSON.stringify({
+                    value: {
+                        $schema: "http://json-schema.org/draft-07/schema#",
+                        type: "object",
+                        "x-lix-key": schemaKey,
+                        "x-lix-version": "1.0",
+                        properties: {
+                            id: { type: "string" },
+                            value: { type: "string" },
+                        },
+                        required: [],
+                        additionalProperties: false,
+                    },
+                }),
+                created_at: timestamp,
+            },
+        ],
+        commit_id: `insert-${entityId}`,
+        version_id: "global",
+    });
+}
+test("populateStateCacheV2 materializes normalized rows for global version", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    await registerStoredSchema(lix, "lix_example");
+    const timestamp = await getTimestamp({ lix });
+    const db = lix.db;
+    await db
+        .insertInto("state_by_version")
+        .values({
+        entity_id: "entity-1",
+        schema_key: "lix_example",
+        file_id: "lix",
+        version_id: "global",
+        plugin_key: "test_plugin",
+        snapshot_content: JSON.stringify({
+            id: "entity-1",
+            value: "seed",
+        }),
+        schema_version: "1.0",
+        created_at: timestamp,
+        updated_at: timestamp,
+        inherited_from_version_id: null,
+        change_id: "change-1",
+        commit_id: "commit-1",
+    })
+        .execute();
+    populateStateCacheV2({ engine: lix.engine });
+    const rows = selectCacheRows(lix.engine.sqlite, "lix_example");
+    expect(rows).toHaveLength(1);
+    const row = rows[0];
+    expect(row.version_id).toBe("global");
+    expect(typeof row.commit_id).toBe("string");
+    expect(row.x_value).toBe("seed");
+});
+//# sourceMappingURL=populate-state-cache.test.js.map

package/dist/state/cache-v2/populate-state-cache.test.js.map

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

package/dist/state/cache-v2/schema-metadata.d.ts

@@ -0,0 +1,20 @@
+export type CacheSchemaPropertyValueKind = "string" | "number" | "integer" | "boolean" | "json";
+export interface CacheSchemaPropertyMetadata {
+    propertyName: string;
+    columnName: string;
+    valueKind: CacheSchemaPropertyValueKind;
+}
+export declare function registerStateCacheSchemaProperties(args: {
+    schemaKey: string;
+    schemaVersion: string;
+    properties: CacheSchemaPropertyMetadata[];
+}): void;
+export declare function getStateCacheSchemaProperties(args: {
+    schemaKey: string;
+    schemaVersion: string;
+}): CacheSchemaPropertyMetadata[] | undefined;
+export declare function clearStateCacheSchemaProperties(args: {
+    schemaKey: string;
+    schemaVersion: string;
+}): void;
+//# sourceMappingURL=schema-metadata.d.ts.map

package/dist/state/cache-v2/schema-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-metadata.d.ts","sourceRoot":"","sources":["../../../src/state/cache-v2/schema-metadata.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,GACrC,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,MAAM,CAAC;AAEV,MAAM,WAAW,2BAA2B;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,4BAA4B,CAAC;CACxC;AAQD,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,2BAA2B,EAAE,CAAC;CAC1C,GAAG,IAAI,CAIP;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACtB,GAAG,2BAA2B,EAAE,GAAG,SAAS,CAI5C;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAIP"}

package/dist/state/cache-v2/schema-metadata.js

@@ -0,0 +1,18 @@
+const schemaPropertyMetadata = new Map();
+function metadataKey(schemaKey, schemaVersion) {
+    return `${schemaKey}::${schemaVersion}`;
+}
+export function registerStateCacheSchemaProperties(args) {
+    const key = metadataKey(args.schemaKey, args.schemaVersion);
+    // Store a copy to avoid accidental external mutation
+    schemaPropertyMetadata.set(key, [...args.properties]);
+}
+export function getStateCacheSchemaProperties(args) {
+    const key = metadataKey(args.schemaKey, args.schemaVersion);
+    const properties = schemaPropertyMetadata.get(key);
+    return properties ? [...properties] : undefined;
+}
+export function clearStateCacheSchemaProperties(args) {
+    schemaPropertyMetadata.delete(metadataKey(args.schemaKey, args.schemaVersion));
+}
+//# sourceMappingURL=schema-metadata.js.map

package/dist/state/cache-v2/schema-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-metadata.js","sourceRoot":"","sources":["../../../src/state/cache-v2/schema-metadata.ts"],"names":[],"mappings":"AAaA,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAyC,CAAC;AAEhF,SAAS,WAAW,CAAC,SAAiB,EAAE,aAAqB;IAC5D,OAAO,GAAG,SAAS,KAAK,aAAa,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAIlD;IACA,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5D,qDAAqD;IACrD,sBAAsB,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAG7C;IACA,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,IAG/C;IACA,sBAAsB,CAAC,MAAM,CAC5B,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAC/C,CAAC;AACH,CAAC"}

package/dist/state/cache-v2/schema.bench.d.ts

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

package/dist/state/cache-v2/schema.bench.d.ts.map

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