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

package/dist/file/materialize-file-data-at-changeset.js

@@ -0,0 +1,119 @@
+import { executeSync } from "../database/execute-sync.js";
+import { lixUnknownFileFallbackPlugin } from "./unknown-file-fallback-plugin.js";
+function globSync(args) {
+    const columnNames = [];
+    const result = args.lix.sqlite.exec({
+        sql: `SELECT CASE WHEN ? GLOB ? THEN 1 ELSE 0 END AS matches`,
+        bind: [args.path, args.glob],
+        returnValue: "resultRows",
+        columnNames,
+    });
+    return result[0]?.[0] === 1;
+}
+export function materializeFileDataAtChangeset(args) {
+    const plugins = args.lix.plugin.getAllSync();
+    // First, try to find a specific plugin that can handle this file (excluding fallback)
+    for (const plugin of plugins) {
+        if (!plugin.detectChangesGlob ||
+            !globSync({
+                lix: args.lix,
+                path: args.file.path,
+                glob: plugin.detectChangesGlob,
+            })) {
+            continue;
+        }
+        if (!plugin.applyChanges) {
+            continue;
+        }
+        // Get plugin changes from state_history table
+        const changes = executeSync({
+            lix: args.lix,
+            query: selectFileChanges({
+                lix: args.lix,
+                pluginKey: plugin.key,
+                fileId: args.file.id,
+                rootChangeSetId: args.rootChangeSetId,
+                depth: args.depth,
+            }),
+        });
+        // Format changes for plugin
+        const formattedChanges = changes.map((change) => ({
+            ...change,
+            snapshot_content: typeof change.snapshot_content === "string"
+                ? JSON.parse(change.snapshot_content)
+                : change.snapshot_content,
+        }));
+        const file = plugin.applyChanges({
+            file: args.file,
+            changes: formattedChanges,
+        });
+        return file.fileData;
+    }
+    // If no specific plugin matched, use the fallback plugin
+    const changes = executeSync({
+        lix: args.lix,
+        query: selectFileChanges({
+            lix: args.lix,
+            pluginKey: lixUnknownFileFallbackPlugin.key,
+            fileId: args.file.id,
+            rootChangeSetId: args.rootChangeSetId,
+            depth: args.depth,
+        }),
+    });
+    // Format changes for plugin
+    const formattedChanges = changes.map((change) => ({
+        ...change,
+        snapshot_content: typeof change.snapshot_content === "string"
+            ? JSON.parse(change.snapshot_content)
+            : change.snapshot_content,
+    }));
+    if (formattedChanges.length === 0) {
+        throw new Error(`[materializeFileDataAtChangeset] No changes found for file ${args.file.id} with plugin ${lixUnknownFileFallbackPlugin.key} at root changeset ${args.rootChangeSetId} depth ${args.depth}. Cannot materialize file data.`);
+    }
+    const file = lixUnknownFileFallbackPlugin.applyChanges({
+        file: args.file,
+        changes: formattedChanges,
+    });
+    return file.fileData;
+}
+function selectFileChanges(args) {
+    return args.lix.db
+        .selectFrom("state_history as sh1")
+        .where("sh1.plugin_key", "=", args.pluginKey)
+        .where("sh1.file_id", "=", args.fileId)
+        .where("sh1.root_change_set_id", "=", args.rootChangeSetId)
+        .where("sh1.depth", ">=", args.depth)
+        .where("sh1.depth", "=", (eb) => 
+    // This subquery finds the "leaf state" for each entity at the requested depth in history.
+    //
+    // What this does: "For each entity in the file, find its most recent state that existed
+    // at or before the requested depth. Some entities might have changed at depth 0, others
+    // might be unchanged since depth 5 - we need all of them to reconstruct the complete file."
+    //
+    // Example: Requesting depth=1 for a JSON file
+    // - "name" entity: last changed at depth=3 (unchanged for 3 changesets)
+    // - "value" entity: last changed at depth=1 (changed 1 changeset ago)
+    // - "description" entity: last changed at depth=0 (just changed)
+    //
+    // Result: We get "name" from depth=3 and "value" from depth=1 (ignoring "description" at depth=0)
+    //
+    // args.depth: The depth we want to reconstruct the file at (0=current, higher=further back in history)
+    // >= args.depth: Go backwards in history to find all entities that existed at or before this point
+    // min(depth): For each entity, get its most recent state (leaf) at or after the requested depth
+    eb
+        .selectFrom("state_history as sh2")
+        .select((eb) => eb.fn.min("sh2.depth").as("min_depth"))
+        .whereRef("sh2.entity_id", "=", "sh1.entity_id")
+        .whereRef("sh2.file_id", "=", "sh1.file_id")
+        .whereRef("sh2.plugin_key", "=", "sh1.plugin_key")
+        .whereRef("sh2.root_change_set_id", "=", "sh1.root_change_set_id")
+        .where("sh2.depth", ">=", args.depth))
+        .select([
+        "sh1.entity_id",
+        "sh1.schema_key",
+        "sh1.file_id",
+        "sh1.plugin_key",
+        "sh1.snapshot_content",
+    ]);
+}
+//# sourceMappingURL=materialize-file-data-at-changeset.js.map

package/dist/file/materialize-file-data-at-changeset.js.map

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

package/dist/file/materialize-file-data-at-commit.d.ts

@@ -0,0 +1,9 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { LixFile } from "./schema.js";
+export declare function materializeFileDataAtCommit(args: {
+    lix: Pick<Lix, "sqlite" | "plugin" | "db">;
+    file: Omit<LixFile, "data">;
+    rootCommitId: string;
+    depth: number;
+}): Uint8Array;
+//# sourceMappingURL=materialize-file-data-at-commit.d.ts.map

package/dist/file/materialize-file-data-at-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-file-data-at-commit.d.ts","sourceRoot":"","sources":["../../src/file/materialize-file-data-at-commit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmB3C,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC3C,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,UAAU,CAkFb"}

package/dist/file/materialize-file-data-at-commit.js

@@ -0,0 +1,119 @@
+import { executeSync } from "../database/execute-sync.js";
+import { lixUnknownFileFallbackPlugin } from "./unknown-file-fallback-plugin.js";
+function globSync(args) {
+    const columnNames = [];
+    const result = args.lix.sqlite.exec({
+        sql: `SELECT CASE WHEN ? GLOB ? THEN 1 ELSE 0 END AS matches`,
+        bind: [args.path, args.glob],
+        returnValue: "resultRows",
+        columnNames,
+    });
+    return result[0]?.[0] === 1;
+}
+export function materializeFileDataAtCommit(args) {
+    const plugins = args.lix.plugin.getAllSync();
+    // First, try to find a specific plugin that can handle this file (excluding fallback)
+    for (const plugin of plugins) {
+        if (!plugin.detectChangesGlob ||
+            !globSync({
+                lix: args.lix,
+                path: args.file.path,
+                glob: plugin.detectChangesGlob,
+            })) {
+            continue;
+        }
+        if (!plugin.applyChanges) {
+            continue;
+        }
+        // Get plugin changes from state_history table
+        const changes = executeSync({
+            lix: args.lix,
+            query: selectFileChanges({
+                lix: args.lix,
+                pluginKey: plugin.key,
+                fileId: args.file.id,
+                rootCommitId: args.rootCommitId,
+                depth: args.depth,
+            }),
+        });
+        // Format changes for plugin
+        const formattedChanges = changes.map((change) => ({
+            ...change,
+            snapshot_content: typeof change.snapshot_content === "string"
+                ? JSON.parse(change.snapshot_content)
+                : change.snapshot_content,
+        }));
+        const file = plugin.applyChanges({
+            file: args.file,
+            changes: formattedChanges,
+        });
+        return file.fileData;
+    }
+    // If no specific plugin matched, use the fallback plugin
+    const changes = executeSync({
+        lix: args.lix,
+        query: selectFileChanges({
+            lix: args.lix,
+            pluginKey: lixUnknownFileFallbackPlugin.key,
+            fileId: args.file.id,
+            rootCommitId: args.rootCommitId,
+            depth: args.depth,
+        }),
+    });
+    // Format changes for plugin
+    const formattedChanges = changes.map((change) => ({
+        ...change,
+        snapshot_content: typeof change.snapshot_content === "string"
+            ? JSON.parse(change.snapshot_content)
+            : change.snapshot_content,
+    }));
+    if (formattedChanges.length === 0) {
+        throw new Error(`[materializeFileDataAtCommit] No changes found for file ${args.file.id} with plugin ${lixUnknownFileFallbackPlugin.key} at root commit ${args.rootCommitId} depth ${args.depth}. Cannot materialize file data.`);
+    }
+    const file = lixUnknownFileFallbackPlugin.applyChanges({
+        file: args.file,
+        changes: formattedChanges,
+    });
+    return file.fileData;
+}
+function selectFileChanges(args) {
+    return args.lix.db
+        .selectFrom("state_history as sh1")
+        .where("sh1.plugin_key", "=", args.pluginKey)
+        .where("sh1.file_id", "=", args.fileId)
+        .where("sh1.root_commit_id", "=", args.rootCommitId)
+        .where("sh1.depth", ">=", args.depth)
+        .where("sh1.depth", "=", (eb) => 
+    // This subquery finds the "leaf state" for each entity at the requested depth in history.
+    //
+    // What this does: "For each entity in the file, find its most recent state that existed
+    // at or before the requested depth. Some entities might have changed at depth 0, others
+    // might be unchanged since depth 5 - we need all of them to reconstruct the complete file."
+    //
+    // Example: Requesting depth=1 for a JSON file
+    // - "name" entity: last changed at depth=3 (unchanged for 3 changesets)
+    // - "value" entity: last changed at depth=1 (changed 1 changeset ago)
+    // - "description" entity: last changed at depth=0 (just changed)
+    //
+    // Result: We get "name" from depth=3 and "value" from depth=1 (ignoring "description" at depth=0)
+    //
+    // args.depth: The depth we want to reconstruct the file at (0=current, higher=further back in history)
+    // >= args.depth: Go backwards in history to find all entities that existed at or before this point
+    // min(depth): For each entity, get its most recent state (leaf) at or after the requested depth
+    eb
+        .selectFrom("state_history as sh2")
+        .select((eb) => eb.fn.min("sh2.depth").as("min_depth"))
+        .whereRef("sh2.entity_id", "=", "sh1.entity_id")
+        .whereRef("sh2.file_id", "=", "sh1.file_id")
+        .whereRef("sh2.plugin_key", "=", "sh1.plugin_key")
+        .whereRef("sh2.root_commit_id", "=", "sh1.root_commit_id")
+        .where("sh2.depth", ">=", args.depth))
+        .select([
+        "sh1.entity_id",
+        "sh1.schema_key",
+        "sh1.file_id",
+        "sh1.plugin_key",
+        "sh1.snapshot_content",
+    ]);
+}
+//# sourceMappingURL=materialize-file-data-at-commit.js.map

package/dist/file/materialize-file-data-at-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-file-data-at-commit.js","sourceRoot":"","sources":["../../src/file/materialize-file-data-at-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,SAAS,QAAQ,CAAC,IAIjB;IACA,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,GAAG,EAAE,wDAAwD;QAC7D,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAC5B,WAAW,EAAE,YAAY;QACzB,WAAW;KACX,CAAC,CAAC;IAEH,OAAQ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAS,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAK3C;IACA,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAE7C,sFAAsF;IACtF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IACC,CAAC,MAAM,CAAC,iBAAiB;YACzB,CAAC,QAAQ,CAAC;gBACT,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;gBACpB,IAAI,EAAE,MAAM,CAAC,iBAAiB;aAC9B,CAAC,EACD,CAAC;YACF,SAAS;QACV,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC1B,SAAS;QACV,CAAC;QAED,8CAA8C;QAC9C,MAAM,OAAO,GAAG,WAAW,CAAC;YAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,iBAAiB,CAAC;gBACxB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,MAAM,CAAC,GAAG;gBACrB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;gBACpB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC;SACF,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,GAAG,MAAM;YACT,gBAAgB,EACf,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ;gBAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACrC,CAAC,CAAC,MAAM,CAAC,gBAAgB;SAC3B,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,gBAAgB;SACzB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,yDAAyD;IACzD,MAAM,OAAO,GAAG,WAAW,CAAC;QAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,iBAAiB,CAAC;YACxB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,4BAA4B,CAAC,GAAG;YAC3C,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACpB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;KACF,CAAC,CAAC;IAEH,4BAA4B;IAC5B,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,GAAG,MAAM;QACT,gBAAgB,EACf,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ;YAC1C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACrC,CAAC,CAAC,MAAM,CAAC,gBAAgB;KAC3B,CAAC,CAAC,CAAC;IAEJ,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACd,2DAA2D,IAAI,CAAC,IAAI,CAAC,EAAE,gBAAgB,4BAA4B,CAAC,GAAG,mBAAmB,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,KAAK,iCAAiC,CAChN,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,4BAA4B,CAAC,YAAa,CAAC;QACvD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,gBAAgB;KACzB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,QAAQ,CAAC;AACtB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAM1B;IACA,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE;SAChB,UAAU,CAAC,sBAAsB,CAAC;SAClC,KAAK,CAAC,gBAAgB,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;SAC5C,KAAK,CAAC,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;SACtC,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC;SACnD,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;SACpC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE;IAC/B,0FAA0F;IAC1F,EAAE;IACF,wFAAwF;IACxF,wFAAwF;IACxF,4FAA4F;IAC5F,EAAE;IACF,8CAA8C;IAC9C,wEAAwE;IACxE,sEAAsE;IACtE,iEAAiE;IACjE,EAAE;IACF,kGAAkG;IAClG,EAAE;IACF,uGAAuG;IACvG,mGAAmG;IACnG,gGAAgG;IAChG,EAAE;SACA,UAAU,CAAC,sBAAsB,CAAC;SAClC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;SACtD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE,eAAe,CAAC;SAC/C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,aAAa,CAAC;SAC3C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,CAAC;SACjD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE,oBAAoB,CAAC;SACzD,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CACtC;SACA,MAAM,CAAC;QACP,eAAe;QACf,gBAAgB;QAChB,aAAa;QACb,gBAAgB;QAChB,sBAAsB;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/file/materialize-file-data.d.ts

@@ -0,0 +1,8 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { LixFile } from "./schema.js";
+export declare function materializeFileData(args: {
+    lix: Pick<Lix, "sqlite" | "plugin" | "db">;
+    file: Omit<LixFile, "data">;
+    versionId: string;
+}): Uint8Array;
+//# sourceMappingURL=materialize-file-data.d.ts.map

package/dist/file/materialize-file-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-file-data.d.ts","sourceRoot":"","sources":["../../src/file/materialize-file-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAmB3C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC3C,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,UAAU,CA8Fb"}

package/dist/file/materialize-file-data.js

@@ -0,0 +1,91 @@
+import { executeSync } from "../database/execute-sync.js";
+import { lixUnknownFileFallbackPlugin } from "./unknown-file-fallback-plugin.js";
+function globSync(args) {
+    const columnNames = [];
+    const result = args.lix.sqlite.exec({
+        sql: `SELECT CASE WHEN ? GLOB ? THEN 1 ELSE 0 END AS matches`,
+        bind: [args.path, args.glob],
+        returnValue: "resultRows",
+        columnNames,
+    });
+    return result[0]?.[0] === 1;
+}
+export function materializeFileData(args) {
+    const plugins = args.lix.plugin.getAllSync();
+    // First, try to find a specific plugin that can handle this file (excluding fallback)
+    for (const plugin of plugins) {
+        if (!plugin.detectChangesGlob ||
+            !globSync({
+                lix: args.lix,
+                path: args.file.path,
+                glob: plugin.detectChangesGlob,
+            })) {
+            continue;
+        }
+        if (!plugin.applyChanges) {
+            continue;
+        }
+        // Get plugin changes from state table
+        const changes = executeSync({
+            lix: args.lix,
+            query: args.lix.db
+                .selectFrom("state_all")
+                .where("plugin_key", "=", plugin.key)
+                .where("file_id", "=", args.file.id)
+                .where("version_id", "=", args.versionId)
+                .select([
+                "entity_id",
+                "schema_key",
+                "file_id",
+                "plugin_key",
+                "snapshot_content",
+                "version_id",
+            ]),
+        });
+        // Format changes for plugin
+        const formattedChanges = changes.map((change) => ({
+            ...change,
+            snapshot_content: typeof change.snapshot_content === "string"
+                ? JSON.parse(change.snapshot_content)
+                : change.snapshot_content,
+        }));
+        const file = plugin.applyChanges({
+            file: args.file,
+            changes: formattedChanges,
+        });
+        return file.fileData;
+    }
+    // If no specific plugin matched, use the fallback plugin
+    const changes = executeSync({
+        lix: args.lix,
+        query: args.lix.db
+            .selectFrom("state_all")
+            .where("plugin_key", "=", lixUnknownFileFallbackPlugin.key)
+            .where("file_id", "=", args.file.id)
+            .where("version_id", "=", args.versionId)
+            .select([
+            "entity_id",
+            "schema_key",
+            "file_id",
+            "plugin_key",
+            "snapshot_content",
+            "version_id",
+        ]),
+    });
+    // Format changes for plugin
+    const formattedChanges = changes.map((change) => ({
+        ...change,
+        snapshot_content: typeof change.snapshot_content === "string"
+            ? JSON.parse(change.snapshot_content)
+            : change.snapshot_content,
+    }));
+    if (formattedChanges.length === 0) {
+        throw new Error(`[materializeFileData] No changes found for file ${args.file.id} with plugin ${lixUnknownFileFallbackPlugin.key}. Cannot materialize file data.`);
+    }
+    const file = lixUnknownFileFallbackPlugin.applyChanges({
+        file: args.file,
+        changes: formattedChanges,
+    });
+    return file.fileData;
+}
+//# sourceMappingURL=materialize-file-data.js.map

package/dist/file/materialize-file-data.js.map

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

package/dist/file/materialize-file-data.test.d.ts

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

package/dist/file/materialize-file-data.test.d.ts.map

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

package/dist/file/materialize-file-data.test.js

@@ -0,0 +1,90 @@
+import { test, expect } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { materializeFileData } from "./materialize-file-data.js";
+test("materializeFileData with plugin that has changes", async () => {
+    const mockPlugin = {
+        key: "test-plugin-2",
+        detectChangesGlob: "*.txt",
+        detectChanges: () => [],
+        applyChanges: ({ changes }) => {
+            // Create content based on the changes
+            const changeIds = changes.map((c) => c.entity_id).join(",");
+            return {
+                fileData: new TextEncoder().encode(`processed-${changeIds}`),
+            };
+        },
+    };
+    const lix = await openLix({
+        providePlugins: [mockPlugin],
+    });
+    const activeVersion = await lix.db
+        .selectFrom("active_version")
+        .select("version_id")
+        .executeTakeFirstOrThrow();
+    // Insert a file
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "test-file-2",
+        data: new TextEncoder().encode("initial-data"),
+        path: "/test.txt",
+    })
+        .execute();
+    // Manually insert some state data to simulate plugin changes
+    await lix.db
+        .insertInto("state_all")
+        .values({
+        entity_id: "entity1",
+        schema_key: "test_schema",
+        file_id: "test-file-2",
+        plugin_key: "test-plugin-2",
+        snapshot_content: { value: "test-content" },
+        schema_version: "1.0",
+        version_id: activeVersion.version_id,
+    })
+        .execute();
+    const file = await lix.db
+        .selectFrom("file")
+        .where("id", "=", "test-file-2")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // Test that materializeFileData processes the changes
+    const result = materializeFileData({
+        lix,
+        file: {
+            id: file.id,
+            path: file.path,
+            metadata: file.metadata,
+        },
+        versionId: activeVersion.version_id,
+    });
+    expect(result).toBeInstanceOf(Uint8Array);
+    expect(new TextDecoder().decode(result)).toBe("processed-entity1");
+});
+test("materializeFileData throws when plugin has no applyChanges", async () => {
+    const mockPlugin = {
+        key: "test-plugin-no-apply",
+        detectChangesGlob: "*.txt",
+        detectChanges: () => [],
+        // No applyChanges method - this should cause materialization to fail
+    };
+    const lix = await openLix({
+        providePlugins: [mockPlugin],
+    });
+    // Insert a file that the plugin will match but cannot materialize
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "test-file-no-apply",
+        data: new TextEncoder().encode("initial-data"),
+        path: "/test.txt",
+    })
+        .execute();
+    // Test that selecting the file throws when plugin cannot materialize
+    await expect(async () => await lix.db
+        .selectFrom("file")
+        .where("id", "=", "test-file-no-apply")
+        .selectAll()
+        .executeTakeFirstOrThrow()).rejects.toThrow("[materializeFileData] No changes found for file test-file-no-apply with plugin lix_unknown_file_fallback_plugin. Cannot materialize file data.");
+});
+//# sourceMappingURL=materialize-file-data.test.js.map

package/dist/file/materialize-file-data.test.js.map

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

package/dist/file/schema.d.ts

@@ -0,0 +1,109 @@
+import type { FromLixSchemaDefinition } from "../schema-definition/definition.js";
+import type { Lix } from "../lix/open-lix.js";
+export declare function applyFileDatabaseSchema(lix: Pick<Lix, "sqlite" | "db" | "plugin" | "hooks">): void;
+export declare const LixFileDescriptorSchema: {
+    readonly "x-lix-key": "lix_file_descriptor";
+    readonly "x-lix-version": "1.0";
+    readonly "x-lix-primary-key": readonly ["id"];
+    readonly "x-lix-unique": readonly [readonly ["path"]];
+    readonly type: "object";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly "x-lix-generated": true;
+        };
+        readonly path: {
+            readonly type: "string";
+            readonly pattern: "^/(?!.*//|.*\\\\)(?!.*/$|^/$).+";
+            readonly description: "File path must start with a slash, not contain backslashes or consecutive slashes, and not end with a slash";
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly nullable: true;
+        };
+        readonly hidden: {
+            readonly type: "boolean";
+            readonly "x-lix-generated": true;
+        };
+    };
+    readonly required: readonly ["id", "path"];
+    readonly additionalProperties: false;
+};
+/**
+ * The file descriptor type representing the stored metadata for a file.
+ *
+ * This is the underlying entity stored in the database with schema_key 'lix_file_descriptor'.
+ * It contains only the file's identity and metadata - NOT the actual file content.
+ *
+ * ```
+ * ┌─────────────────────────────────────────┐
+ * │         LixFileDescriptor               │
+ * │    (schema_key: 'lix_file_descriptor')  │
+ * ├─────────────────────────────────────────┤
+ * │ • id: string (file identifier)          │
+ * │ • path: string (e.g., "/docs/README.md")│
+ * │ • metadata: object | null               │
+ * │ • hidden: boolean                       │
+ * └─────────────────────────────────────────┘
+ *               ↓
+ *     Stored in state/state_all table
+ *               ↓
+ * ┌─────────────────────────────────────────┐
+ * │ File content entities are stored        │
+ * │ separately with file_id = descriptor.id │
+ * │                                         │
+ * │ • JSON properties (mock_json_property)  │
+ * │ • Markdown blocks (markdown_block)      │
+ * │ • CSV rows (csv_row)                    │
+ * │ • etc...                                │
+ * └─────────────────────────────────────────┘
+ * ```
+ *
+ * Key points:
+ * - File descriptors are just metadata - they don't contain file data
+ * - The actual file content is stored as separate entities linked by file_id
+ * - File views aggregate the descriptor + content entities into a complete file
+ * - Changes to file content don't update the descriptor (and vice versa)
+ */
+export type LixFileDescriptor = FromLixSchemaDefinition<typeof LixFileDescriptorSchema>;
+/**
+ * Complete file type combining the descriptor with materialized data.
+ *
+ * Uses "Lix" prefix to avoid collision with JavaScript's built-in File type.
+ *
+ * IMPORTANT: File views are projections over multiple entities, not just the file descriptor.
+ * However, they expose schema_key as 'lix_file_descriptor' to maintain foreign key integrity.
+ *
+ * ```
+ * ┌─────────────────────────────────────────────────────────────┐
+ * │                        File View                            │
+ * │               (schema_key: 'lix_file_descriptor')           │
+ * │                                                             │
+ * │  ┌─────────────────────────┐   ┌─────────────────────────┐ │
+ * │  │   File Descriptor       │   │   Plugin Entities       │ │
+ * │  │ (lix_file_descriptor)   │   │                         │ │
+ * │  ├─────────────────────────┤   ├─────────────────────────┤ │
+ * │  │ • id                    │   │ • JSON properties       │ │
+ * │  │ • path                  │ + │ • Markdown blocks       │ │
+ * │  │ • metadata              │   │ • CSV rows              │ │
+ * │  │ • hidden                │   │ • Future: thumbnails    │ │
+ * │  └─────────────────────────┘   └─────────────────────────┘ │
+ * │                    ↓                       ↓                │
+ * │              ┌─────────────────────────────────┐           │
+ * │              │    Materialized as LixFile      │           │
+ * │              │  • All descriptor fields        │           │
+ * │              │  • data: Uint8Array (from       │           │
+ * │              │    plugin entities)             │           │
+ * │              └─────────────────────────────────┘           │
+ * └─────────────────────────────────────────────────────────────┘
+ * ```
+ *
+ * This projection approach means:
+ * - File views aggregate changes from ALL entities within the file
+ * - The 'data' field is dynamically materialized from plugin entities
+ * - A single file view row represents multiple underlying entities
+ */
+export type LixFile = LixFileDescriptor & {
+    data: Uint8Array;
+};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/file/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEX,uBAAuB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC,GAClD,IAAI,CAqTN;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB1B,CAAC;AAGX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CACtD,OAAO,uBAAuB,CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,MAAM,OAAO,GAAG,iBAAiB,GAAG;IACzC,IAAI,EAAE,UAAU,CAAC;CACjB,CAAC"}