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

package/dist/filesystem/file/cache/clear-file-data-cache.js

@@ -1,54 +0,0 @@
-/**
- * Clears the file data cache for a specific file and version.
- *
- * @example
- * clearFileDataCache({
- *   engine: lix.engine!,
- *   fileId: "file_123",
- *   versionId: "version_456"
- * });
- */
-export function clearFileDataCache(args) {
-    if (args.fileId && args.versionId) {
-        // Clear specific file in specific version
-        args.engine.sqlite.exec({
-            sql: `
-        DELETE FROM lix_internal_file_data_cache 
-        WHERE file_id = ? 
-        AND version_id = ?
-      `,
-            bind: [args.fileId, args.versionId],
-            returnValue: "resultRows",
-        });
-    }
-    else if (args.versionId) {
-        // Clear all files in a specific version
-        args.engine.sqlite.exec({
-            sql: `
-        DELETE FROM lix_internal_file_data_cache 
-        WHERE version_id = ?
-      `,
-            bind: [args.versionId],
-            returnValue: "resultRows",
-        });
-    }
-    else if (args.fileId) {
-        // Clear specific file across all versions
-        args.engine.sqlite.exec({
-            sql: `
-        DELETE FROM lix_internal_file_data_cache 
-        WHERE file_id = ?
-      `,
-            bind: [args.fileId],
-            returnValue: "resultRows",
-        });
-    }
-    else {
-        // Clear entire cache
-        args.engine.sqlite.exec({
-            sql: `DELETE FROM lix_internal_file_data_cache`,
-            returnValue: "resultRows",
-        });
-    }
-}
-//# sourceMappingURL=clear-file-data-cache.js.map

package/dist/filesystem/file/cache/clear-file-data-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"clear-file-data-cache.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/clear-file-data-cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAIlC;IACA,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,GAAG,EAAE;;;;OAID;YACJ,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;YACnC,WAAW,EAAE,YAAY;SACzB,CAAC,CAAC;IACJ,CAAC;SAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,wCAAwC;QACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,GAAG,EAAE;;;OAGD;YACJ,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;YACtB,WAAW,EAAE,YAAY;SACzB,CAAC,CAAC;IACJ,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,GAAG,EAAE;;;OAGD;YACJ,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,YAAY;SACzB,CAAC,CAAC;IACJ,CAAC;SAAM,CAAC;QACP,qBAAqB;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACvB,GAAG,EAAE,0CAA0C;YAC/C,WAAW,EAAE,YAAY;SACzB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC"}

package/dist/filesystem/file/cache/lixcol-schema.d.ts

@@ -1,27 +0,0 @@
-import type { Selectable } from "kysely";
-import type { LixEngine } from "../../../engine/boot.js";
-export type InternalFileLixcolCacheRow = Selectable<InternalFileLixcolCacheTable>;
-export type InternalFileLixcolCacheTable = {
-    file_id: string;
-    version_id: string;
-    latest_change_id: string;
-    latest_commit_id: string;
-    created_at: string;
-    updated_at: string;
-    writer_key: string | null;
-};
-/**
- * Schema for the file lixcol metadata cache.
- *
- * This cache stores the expensive-to-compute lixcol columns for files,
- * avoiding the need for complex subqueries in the file view.
- *
- * The view can query this table directly using SQL:
- * SELECT latest_change_id, latest_commit_id, created_at, updated_at, writer_key
- * FROM lix_internal_file_lixcol_cache
- * WHERE file_id = ? AND version_id = ?
- */
-export declare function applyFileLixcolCacheSchema(args: {
-    engine: Pick<LixEngine, "sqlite">;
-}): void;
-//# sourceMappingURL=lixcol-schema.d.ts.map

package/dist/filesystem/file/cache/lixcol-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lixcol-schema.d.ts","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/lixcol-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,0BAA0B,GACrC,UAAU,CAAC,4BAA4B,CAAC,CAAC;AAE1C,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;CAClC,GAAG,IAAI,CAkBP"}

package/dist/filesystem/file/cache/lixcol-schema.js

@@ -1,31 +0,0 @@
-/**
- * Schema for the file lixcol metadata cache.
- *
- * This cache stores the expensive-to-compute lixcol columns for files,
- * avoiding the need for complex subqueries in the file view.
- *
- * The view can query this table directly using SQL:
- * SELECT latest_change_id, latest_commit_id, created_at, updated_at, writer_key
- * FROM lix_internal_file_lixcol_cache
- * WHERE file_id = ? AND version_id = ?
- */
-export function applyFileLixcolCacheSchema(args) {
-    // Create the cache table for file lixcol metadata
-    args.engine.sqlite.exec(`
-		CREATE TABLE IF NOT EXISTS lix_internal_file_lixcol_cache (
-			file_id TEXT NOT NULL,
-			version_id TEXT NOT NULL,
-			latest_change_id TEXT,
-			latest_commit_id TEXT,
-			created_at TEXT,
-			updated_at TEXT,
-			writer_key TEXT,
-			PRIMARY KEY (file_id, version_id)
-		) STRICT;
-
-		-- Index for fast lookups
-		CREATE INDEX IF NOT EXISTS idx_file_lixcol_cache_lookup 
-		ON lix_internal_file_lixcol_cache(file_id, version_id);
-	`);
-}
-//# sourceMappingURL=lixcol-schema.js.map

package/dist/filesystem/file/cache/lixcol-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lixcol-schema.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/lixcol-schema.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAE1C;IACA,kDAAkD;IAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;EAevB,CAAC,CAAC;AACJ,CAAC"}

package/dist/filesystem/file/cache/path-cache-schema.d.ts

@@ -1,25 +0,0 @@
-import type { Selectable } from "kysely";
-import type { LixEngine } from "../../../engine/boot.js";
-/**
- * Applies the schema for the internal file path cache table.
- *
- * This cache will store precomputed full file paths so that queries like
- * `WHERE path LIKE '/foo/%'` can be answered without recomputing paths for
- * every row.
- *
- * @example
- * applyFilePathCacheSchema({ engine: lix });
- */
-export declare function applyFilePathCacheSchema(args: {
-    engine: Pick<LixEngine, "sqlite">;
-}): void;
-export type InternalFilePathCacheRow = Selectable<InternalFilePathCacheTable>;
-export type InternalFilePathCacheTable = {
-    file_id: string;
-    version_id: string;
-    directory_id: string | null;
-    name: string;
-    extension: string | null;
-    path: string;
-};
-//# sourceMappingURL=path-cache-schema.d.ts.map

package/dist/filesystem/file/cache/path-cache-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-cache-schema.d.ts","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/path-cache-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;CAClC,GAAG,IAAI,CAkBP;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/filesystem/file/cache/path-cache-schema.js

@@ -1,30 +0,0 @@
-/**
- * Applies the schema for the internal file path cache table.
- *
- * This cache will store precomputed full file paths so that queries like
- * `WHERE path LIKE '/foo/%'` can be answered without recomputing paths for
- * every row.
- *
- * @example
- * applyFilePathCacheSchema({ engine: lix });
- */
-export function applyFilePathCacheSchema(args) {
-    args.engine.sqlite.exec(`
-    CREATE TABLE IF NOT EXISTS lix_internal_file_path_cache (
-      file_id TEXT NOT NULL,
-      version_id TEXT NOT NULL,
-      directory_id TEXT,
-      name TEXT NOT NULL,
-      extension TEXT,
-      path TEXT NOT NULL,
-      PRIMARY KEY (file_id, version_id)
-    ) strict;
-
-    CREATE INDEX IF NOT EXISTS idx_lix_internal_file_path_cache_version_path
-      ON lix_internal_file_path_cache (version_id, path, file_id);
-
-    CREATE INDEX IF NOT EXISTS idx_lix_internal_file_path_cache_version_directory
-      ON lix_internal_file_path_cache (version_id, directory_id);
-  `);
-}
-//# sourceMappingURL=path-cache-schema.js.map

package/dist/filesystem/file/cache/path-cache-schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-cache-schema.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/path-cache-schema.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAExC;IACA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;GAgBtB,CAAC,CAAC;AACL,CAAC"}

package/dist/filesystem/file/cache/schema.d.ts

@@ -1,21 +0,0 @@
-import type { Selectable } from "kysely";
-import type { LixEngine } from "../../../engine/boot.js";
-/**
- * Applies the file data cache schema to the database.
- *
- * The cache stores materialized file data to avoid repeated
- * plugin processing and change aggregation.
- *
- * @example
- * applyFileDataCacheSchema(lix);
- */
-export declare function applyFileDataCacheSchema(args: {
-    engine: Pick<LixEngine, "sqlite">;
-}): void;
-export type InternalFileDataCacheRow = Selectable<InternalFileDataCacheTable>;
-export type InternalFileDataCacheTable = {
-    file_id: string;
-    version_id: string;
-    data: Uint8Array;
-};
-//# sourceMappingURL=schema.d.ts.map

package/dist/filesystem/file/cache/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;CAClC,GAAG,IAAI,CAaP;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CACjB,CAAC"}

package/dist/filesystem/file/cache/schema.js

@@ -1,24 +0,0 @@
-/**
- * Applies the file data cache schema to the database.
- *
- * The cache stores materialized file data to avoid repeated
- * plugin processing and change aggregation.
- *
- * @example
- * applyFileDataCacheSchema(lix);
- */
-export function applyFileDataCacheSchema(args) {
-    args.engine.sqlite.exec(`
-    CREATE TABLE IF NOT EXISTS lix_internal_file_data_cache (
-      file_id TEXT NOT NULL,
-      version_id TEXT NOT NULL,
-      data BLOB NOT NULL,
-      PRIMARY KEY (file_id, version_id)
-    ) strict;
-
-    -- Index for fast version_id filtering
-    CREATE INDEX IF NOT EXISTS idx_lix_internal_file_data_cache_version_id 
-      ON lix_internal_file_data_cache (version_id);
-  `);
-}
-//# sourceMappingURL=schema.js.map

package/dist/filesystem/file/cache/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/schema.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAExC;IACA,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;GAWtB,CAAC,CAAC;AACL,CAAC"}

package/dist/filesystem/file/cache/schema.test.d.ts

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

package/dist/filesystem/file/cache/schema.test.d.ts.map

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

package/dist/filesystem/file/cache/schema.test.js

@@ -1,264 +0,0 @@
-import { test, expect } from "vitest";
-import { openLix } from "../../../lix/open-lix.js";
-import { mockJsonPlugin } from "../../../plugin/mock-json-plugin.js";
-// Helper function to query cache directly
-function getFileDataCache(args) {
-    const result = args.lix.engine.sqlite.exec({
-        sql: `
-			SELECT data 
-			FROM lix_internal_file_data_cache 
-			WHERE file_id = ? 
-			AND version_id = ?
-		`,
-        bind: [args.fileId, args.versionId],
-        returnValue: "resultRows",
-    });
-    return result[0]?.[0];
-}
-/**
- * File data caching uses READ-THROUGH caching, not write-through.
- *
- * Why read-through instead of write-through?
- * 1. File writes receive raw data, but the cache needs materialized data (after plugin processing)
- * 2. Materializing on every write would make writes slow
- * 3. There could be consistency gaps between written raw data and cached materialized data
- *
- * Trade-offs:
- * - First read after insert/update has a cache miss (slower)
- * - But writes remain fast and cache consistency is guaranteed
- * - Cache is only populated when actually needed
- */
-test("file data cache - read-through caching", async () => {
-    const lix = await openLix({
-        providePlugins: [mockJsonPlugin],
-    });
-    const testData = new TextEncoder().encode(JSON.stringify({
-        id: "test_file",
-        content: "Test content",
-    }));
-    // Insert a file
-    await lix.db
-        .insertInto("file")
-        .values({
-        id: "test_file",
-        path: "/test/file.json",
-        data: testData,
-    })
-        .execute();
-    // Get active version
-    const activeVersion = await lix.db
-        .selectFrom("active_version")
-        .select("version_id")
-        .executeTakeFirstOrThrow();
-    // Cache should be empty initially (read-through caching)
-    let cachedData = getFileDataCache({
-        lix,
-        fileId: "test_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(cachedData).toBeUndefined();
-    // First read - should populate cache
-    const file = await lix.db
-        .selectFrom("file")
-        .where("id", "=", "test_file")
-        .selectAll()
-        .executeTakeFirstOrThrow();
-    // Compare JSON semantically, not byte-for-byte
-    // The mockJsonPlugin may reorder properties when reconstructing JSON
-    const fileDataParsed = JSON.parse(new TextDecoder().decode(file.data));
-    const testDataParsed = JSON.parse(new TextDecoder().decode(testData));
-    expect(fileDataParsed).toEqual(testDataParsed);
-    // Now cache should be populated
-    cachedData = getFileDataCache({
-        lix,
-        fileId: "test_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(cachedData).toBeDefined();
-    // Cache contains the materialized data (which may have reordered properties)
-    const cachedDataParsed = JSON.parse(new TextDecoder().decode(cachedData));
-    expect(cachedDataParsed).toEqual(testDataParsed);
-});
-test("file data cache - update invalidates and rewrites cache", async () => {
-    const lix = await openLix({
-        providePlugins: [mockJsonPlugin],
-    });
-    const initialData = new TextEncoder().encode(JSON.stringify({
-        id: "update_file",
-        content: "Initial content",
-    }));
-    // Insert initial file
-    await lix.db
-        .insertInto("file")
-        .values({
-        id: "update_file",
-        path: "/test/update.json",
-        data: initialData,
-    })
-        .execute();
-    // Get active version
-    const activeVersion = await lix.db
-        .selectFrom("active_version")
-        .select("version_id")
-        .executeTakeFirstOrThrow();
-    // First read to populate cache
-    let file = await lix.db
-        .selectFrom("file")
-        .where("id", "=", "update_file")
-        .selectAll()
-        .executeTakeFirstOrThrow();
-    // Compare JSON semantically
-    expect(JSON.parse(new TextDecoder().decode(file.data))).toEqual(JSON.parse(new TextDecoder().decode(initialData)));
-    // Verify initial cache
-    let cachedData = getFileDataCache({
-        lix,
-        fileId: "update_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(JSON.parse(new TextDecoder().decode(cachedData))).toEqual(JSON.parse(new TextDecoder().decode(initialData)));
-    // Update the file
-    const updatedData = new TextEncoder().encode(JSON.stringify({
-        id: "update_file",
-        content: "Updated content",
-        newField: "New data",
-    }));
-    await lix.db
-        .updateTable("file")
-        .where("id", "=", "update_file")
-        .set({
-        data: updatedData,
-    })
-        .execute();
-    // Check cache was cleared after update (read-through caching)
-    cachedData = getFileDataCache({
-        lix,
-        fileId: "update_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(cachedData).toBeUndefined();
-    // Read the file - should materialize and cache updated data
-    file = await lix.db
-        .selectFrom("file")
-        .where("id", "=", "update_file")
-        .selectAll()
-        .executeTakeFirstOrThrow();
-    // Compare JSON semantically
-    expect(JSON.parse(new TextDecoder().decode(file.data))).toEqual(JSON.parse(new TextDecoder().decode(updatedData)));
-    // Now cache should be populated with updated data
-    cachedData = getFileDataCache({
-        lix,
-        fileId: "update_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(JSON.parse(new TextDecoder().decode(cachedData))).toEqual(JSON.parse(new TextDecoder().decode(updatedData)));
-});
-// test("file data cache - performance improvement for repeated reads", async () => {
-// 	const lix = await openLix({
-// 		providePlugins: [mockJsonPlugin],
-// 	});
-// 	const testData = new TextEncoder().encode(
-// 		JSON.stringify({
-// 			id: "perf_file",
-// 			content: "Performance test content",
-// 			largeData: Array(1000).fill("data"),
-// 		})
-// 	);
-// 	// Insert a file
-// 	await lix.db
-// 		.insertInto("file")
-// 		.values({
-// 			id: "perf_file",
-// 			path: "/test/perf.json",
-// 			data: testData,
-// 		})
-// 		.execute();
-// 	// First read - populates cache
-// 	const start1 = performance.now();
-// 	const [file1] = await lix.db
-// 		.selectFrom("file")
-// 		.where("id", "=", "perf_file")
-// 		.selectAll()
-// 		.execute();
-// 	const time1 = performance.now() - start1;
-// 	// Second read - should use cache and be faster
-// 	const start2 = performance.now();
-// 	const [file2] = await lix.db
-// 		.selectFrom("file")
-// 		.where("id", "=", "perf_file")
-// 		.selectAll()
-// 		.execute();
-// 	const time2 = performance.now() - start2;
-// 	// Multiple reads to average out timing variations
-// 	const times = [];
-// 	for (let i = 0; i < 10; i++) {
-// 		const start = performance.now();
-// 		await lix.db
-// 			.selectFrom("file")
-// 			.where("id", "=", "perf_file")
-// 			.selectAll()
-// 			.executeTakeFirst();
-// 		times.push(performance.now() - start);
-// 	}
-// 	const avgCachedTime = times.reduce((a, b) => a + b, 0) / times.length;
-// 	// Files should be identical
-// 	expect(file1.data).toEqual(file2.data);
-// 	expect(file1.data).toEqual(testData);
-// 	// Log the timing results for visibility
-// 	console.log(`First read (cold): ${time1.toFixed(2)}ms`);
-// 	console.log(`Second read (cached): ${time2.toFixed(2)}ms`);
-// 	console.log(`Average cached read (10 reads): ${avgCachedTime.toFixed(2)}ms`);
-// 	// Cache reads should generally be faster, but we won't assert this
-// 	// as timing can vary in CI environments
-// });
-test("file data cache - cache is cleared when file is deleted", async () => {
-    const lix = await openLix({
-        providePlugins: [mockJsonPlugin],
-    });
-    const testData = new TextEncoder().encode(JSON.stringify({
-        id: "delete_test_file",
-        content: "File to be deleted",
-    }));
-    // Insert a file - should trigger write-through caching
-    await lix.db
-        .insertInto("file")
-        .values({
-        id: "delete_test_file",
-        path: "/test/delete.json",
-        data: testData,
-    })
-        .execute();
-    // Get active version
-    const activeVersion = await lix.db
-        .selectFrom("active_version")
-        .select("version_id")
-        .executeTakeFirstOrThrow();
-    // First read to populate cache
-    const file = await lix.db
-        .selectFrom("file")
-        .where("id", "=", "delete_test_file")
-        .selectAll()
-        .executeTakeFirstOrThrow();
-    // Compare JSON semantically
-    expect(JSON.parse(new TextDecoder().decode(file.data))).toEqual(JSON.parse(new TextDecoder().decode(testData)));
-    // Verify cache was populated
-    let cachedData = getFileDataCache({
-        lix,
-        fileId: "delete_test_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(cachedData).toBeDefined();
-    expect(JSON.parse(new TextDecoder().decode(cachedData))).toEqual(JSON.parse(new TextDecoder().decode(testData)));
-    // Delete the file
-    await lix.db
-        .deleteFrom("file")
-        .where("id", "=", "delete_test_file")
-        .execute();
-    // Verify cache was cleared
-    cachedData = getFileDataCache({
-        lix,
-        fileId: "delete_test_file",
-        versionId: activeVersion.version_id,
-    });
-    expect(cachedData).toBeUndefined();
-});
-//# sourceMappingURL=schema.test.js.map

package/dist/filesystem/file/cache/schema.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAGrE,0CAA0C;AAC1C,SAAS,gBAAgB,CAAC,IAIzB;IACA,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,GAAG,EAAE;;;;;GAKJ;QACD,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;QACnC,WAAW,EAAE,YAAY;KACzB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAA2B,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,cAAc,EAAE,CAAC,cAAc,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACxC,IAAI,CAAC,SAAS,CAAC;QACd,EAAE,EAAE,WAAW;QACf,OAAO,EAAE,cAAc;KACvB,CAAC,CACF,CAAC;IAEF,gBAAgB;IAChB,MAAM,GAAG,CAAC,EAAE;SACV,UAAU,CAAC,MAAM,CAAC;SAClB,MAAM,CAAC;QACP,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;KACd,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,qBAAqB;IACrB,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAChC,UAAU,CAAC,gBAAgB,CAAC;SAC5B,MAAM,CAAC,YAAY,CAAC;SACpB,uBAAuB,EAAE,CAAC;IAE5B,yDAAyD;IACzD,IAAI,UAAU,GAAG,gBAAgB,CAAC;QACjC,GAAG;QACH,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IAEnC,qCAAqC;IACrC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,CAAC;SAC7B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,+CAA+C;IAC/C,qEAAqE;IACrE,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE/C,gCAAgC;IAChC,UAAU,GAAG,gBAAgB,CAAC;QAC7B,GAAG;QACH,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,6EAA6E;IAC7E,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAW,CAAC,CAAC,CAAC;IAC3E,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,cAAc,EAAE,CAAC,cAAc,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAC3C,IAAI,CAAC,SAAS,CAAC;QACd,EAAE,EAAE,aAAa;QACjB,OAAO,EAAE,iBAAiB;KAC1B,CAAC,CACF,CAAC;IAEF,sBAAsB;IACtB,MAAM,GAAG,CAAC,EAAE;SACV,UAAU,CAAC,MAAM,CAAC;SAClB,MAAM,CAAC;QACP,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,WAAW;KACjB,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,qBAAqB;IACrB,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAChC,UAAU,CAAC,gBAAgB,CAAC;SAC5B,MAAM,CAAC,YAAY,CAAC;SACpB,uBAAuB,EAAE,CAAC;IAE5B,+BAA+B;IAC/B,IAAI,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACrB,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC;SAC/B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC;IAEF,uBAAuB;IACvB,IAAI,UAAU,GAAG,gBAAgB,CAAC;QACjC,GAAG;QACH,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAChE,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC;IAEF,kBAAkB;IAClB,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAC3C,IAAI,CAAC,SAAS,CAAC;QACd,EAAE,EAAE,aAAa;QACjB,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,UAAU;KACpB,CAAC,CACF,CAAC;IAEF,MAAM,GAAG,CAAC,EAAE;SACV,WAAW,CAAC,MAAM,CAAC;SACnB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC;SAC/B,GAAG,CAAC;QACJ,IAAI,EAAE,WAAW;KACjB,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,8DAA8D;IAC9D,UAAU,GAAG,gBAAgB,CAAC;QAC7B,GAAG;QACH,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IAEnC,4DAA4D;IAC5D,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACjB,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC;SAC/B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,4BAA4B;IAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC;IAEF,kDAAkD;IAClD,UAAU,GAAG,gBAAgB,CAAC;QAC7B,GAAG;QACH,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAChE,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CACjD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,qFAAqF;AACrF,+BAA+B;AAC/B,sCAAsC;AACtC,OAAO;AAEP,8CAA8C;AAC9C,qBAAqB;AACrB,sBAAsB;AACtB,0CAA0C;AAC1C,0CAA0C;AAC1C,OAAO;AACP,MAAM;AAEN,oBAAoB;AACpB,gBAAgB;AAChB,wBAAwB;AACxB,cAAc;AACd,sBAAsB;AACtB,8BAA8B;AAC9B,qBAAqB;AACrB,OAAO;AACP,gBAAgB;AAEhB,mCAAmC;AACnC,qCAAqC;AACrC,gCAAgC;AAChC,wBAAwB;AACxB,mCAAmC;AACnC,iBAAiB;AACjB,gBAAgB;AAChB,6CAA6C;AAE7C,mDAAmD;AACnD,qCAAqC;AACrC,gCAAgC;AAChC,wBAAwB;AACxB,mCAAmC;AACnC,iBAAiB;AACjB,gBAAgB;AAChB,6CAA6C;AAE7C,sDAAsD;AACtD,qBAAqB;AACrB,kCAAkC;AAClC,qCAAqC;AACrC,iBAAiB;AACjB,yBAAyB;AACzB,oCAAoC;AACpC,kBAAkB;AAClB,0BAA0B;AAC1B,2CAA2C;AAC3C,KAAK;AACL,0EAA0E;AAE1E,gCAAgC;AAChC,2CAA2C;AAC3C,yCAAyC;AAEzC,4CAA4C;AAC5C,4DAA4D;AAC5D,+DAA+D;AAC/D,iFAAiF;AAEjF,uEAAuE;AACvE,4CAA4C;AAC5C,MAAM;AAEN,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,cAAc,EAAE,CAAC,cAAc,CAAC;KAChC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CACxC,IAAI,CAAC,SAAS,CAAC;QACd,EAAE,EAAE,kBAAkB;QACtB,OAAO,EAAE,oBAAoB;KAC7B,CAAC,CACF,CAAC;IAEF,uDAAuD;IACvD,MAAM,GAAG,CAAC,EAAE;SACV,UAAU,CAAC,MAAM,CAAC;SAClB,MAAM,CAAC;QACP,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,QAAQ;KACd,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,qBAAqB;IACrB,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAChC,UAAU,CAAC,gBAAgB,CAAC;SAC5B,MAAM,CAAC,YAAY,CAAC;SACpB,uBAAuB,EAAE,CAAC;IAE5B,+BAA+B;IAC/B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,kBAAkB,CAAC;SACpC,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAC9C,CAAC;IAEF,6BAA6B;IAC7B,IAAI,UAAU,GAAG,gBAAgB,CAAC;QACjC,GAAG;QACH,MAAM,EAAE,kBAAkB;QAC1B,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAChE,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAC9C,CAAC;IAEF,kBAAkB;IAClB,MAAM,GAAG,CAAC,EAAE;SACV,UAAU,CAAC,MAAM,CAAC;SAClB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,kBAAkB,CAAC;SACpC,OAAO,EAAE,CAAC;IAEZ,2BAA2B;IAC3B,UAAU,GAAG,gBAAgB,CAAC;QAC7B,GAAG;QACH,MAAM,EAAE,kBAAkB;QAC1B,SAAS,EAAE,aAAa,CAAC,UAAU;KACnC,CAAC,CAAC;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;AACpC,CAAC,CAAC,CAAC"}

package/dist/filesystem/file/cache/update-file-data-cache.d.ts

@@ -1,20 +0,0 @@
-import type { LixEngine } from "../../../engine/boot.js";
-/**
- * Updates the file data cache with materialized file content.
- * Used for write-through caching after file insert/update operations.
- *
- * @example
- * updateFileDataCache({
- *   engine: lix.engine!,
- *   fileId: "file_123",
- *   versionId: "version_456",
- *   data: new Uint8Array([...])
- * });
- */
-export declare function updateFileDataCache(args: {
-    engine: Pick<LixEngine, "sqlite">;
-    fileId: string;
-    versionId: string;
-    data: Uint8Array;
-}): void;
-//# sourceMappingURL=update-file-data-cache.d.ts.map

package/dist/filesystem/file/cache/update-file-data-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-file-data-cache.d.ts","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/update-file-data-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;CACjB,GAAG,IAAI,CAWP"}

package/dist/filesystem/file/cache/update-file-data-cache.js

@@ -1,25 +0,0 @@
-/**
- * Updates the file data cache with materialized file content.
- * Used for write-through caching after file insert/update operations.
- *
- * @example
- * updateFileDataCache({
- *   engine: lix.engine!,
- *   fileId: "file_123",
- *   versionId: "version_456",
- *   data: new Uint8Array([...])
- * });
- */
-export function updateFileDataCache(args) {
-    // Use INSERT OR REPLACE for write-through caching
-    args.engine.sqlite.exec({
-        sql: `
-      INSERT OR REPLACE INTO lix_internal_file_data_cache 
-      (file_id, version_id, data)
-      VALUES (?, ?, ?)
-    `,
-        bind: [args.fileId, args.versionId, args.data],
-        returnValue: "resultRows",
-    });
-}
-//# sourceMappingURL=update-file-data-cache.js.map

package/dist/filesystem/file/cache/update-file-data-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-file-data-cache.js","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/update-file-data-cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACA,kDAAkD;IAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACvB,GAAG,EAAE;;;;KAIF;QACH,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;QAC9C,WAAW,EAAE,YAAY;KACzB,CAAC,CAAC;AACJ,CAAC"}

package/dist/filesystem/file/cache/update-file-lixcol-cache.d.ts

@@ -1,21 +0,0 @@
-import type { LixEngine } from "../../../engine/boot.js";
-/**
- * Updates the file lixcol metadata cache.
- *
- * This function computes and caches the expensive lixcol columns
- * (latest_change_id, latest_commit_id, created_at, updated_at, writer_key)
- * to avoid expensive subqueries in the file view.
- *
- * @example
- * updateFileLixcolCache({
- *   lix,
- *   fileId: "file_123",
- *   versionId: "version_456"
- * });
- */
-export declare function updateFileLixcolCache(args: {
-    engine: Pick<LixEngine, "sqlite">;
-    fileId: string;
-    versionId: string;
-}): void;
-//# sourceMappingURL=update-file-lixcol-cache.d.ts.map

package/dist/filesystem/file/cache/update-file-lixcol-cache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-file-lixcol-cache.d.ts","sourceRoot":"","sources":["../../../../src/filesystem/file/cache/update-file-lixcol-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAmEP"}