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

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,46 @@
+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 required: readonly ["id", "path"];
+    readonly additionalProperties: false;
+};
+/**
+ * The file descriptor type representing the stored metadata for a file.
+ *
+ * This contains the file's identity and metadata but not the actual file content.
+ * The file content (data) is materialized separately by aggregating entities from plugins.
+ */
+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.
+ * This represents the full file as seen in views, combining:
+ * - LixFileDescriptor: stored metadata (id, path, metadata)
+ * - data: materialized file content from plugin 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":"AAGA,OAAO,KAAK,EAEX,uBAAuB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE9C,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC,GAClD,IAAI,CAkPN;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;CAqB1B,CAAC;AAGX;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CACtD,OAAO,uBAAuB,CAC9B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,iBAAiB,GAAG;IACzC,IAAI,EAAE,UAAU,CAAC;CACjB,CAAC"}

package/dist/file/schema.js

@@ -0,0 +1,265 @@
+import { handleFileInsert, handleFileUpdate } from "./file-handlers.js";
+import { materializeFileData } from "./materialize-file-data.js";
+import { materializeFileDataAtChangeset } from "./materialize-file-data-at-changeset.js";
+export function applyFileDatabaseSchema(lix) {
+    lix.sqlite.createFunction({
+        name: "handle_file_insert",
+        arity: 6,
+        xFunc: (_ctx, ...args) => {
+            // Parse metadata if it's a JSON string (SQLite converts objects to strings)
+            let metadata = args[3];
+            if (typeof metadata === "string" && metadata !== null) {
+                try {
+                    metadata = JSON.parse(metadata);
+                }
+                catch {
+                    // If parsing fails, keep as string
+                }
+            }
+            const result = handleFileInsert({
+                lix,
+                file: {
+                    id: args[0],
+                    path: args[1],
+                    data: args[2],
+                    metadata: metadata,
+                },
+                versionId: args[4],
+                untracked: Boolean(args[5]),
+            });
+            return result;
+        },
+        deterministic: true,
+    });
+    lix.sqlite.createFunction({
+        name: "handle_file_update",
+        arity: 6,
+        xFunc: (_ctx, ...args) => {
+            // Parse metadata if it's a JSON string (SQLite converts objects to strings)
+            let metadata = args[3];
+            if (typeof metadata === "string" && metadata !== null) {
+                try {
+                    metadata = JSON.parse(metadata);
+                }
+                catch {
+                    // If parsing fails, keep as string
+                }
+            }
+            const result = handleFileUpdate({
+                lix,
+                file: {
+                    id: args[0],
+                    path: args[1],
+                    data: args[2],
+                    metadata: metadata,
+                },
+                versionId: args[4],
+                untracked: Boolean(args[5]),
+            });
+            return result;
+        },
+        deterministic: true,
+    });
+    lix.sqlite.createFunction({
+        name: "materialize_file_data",
+        arity: 4,
+        deterministic: false,
+        xFunc: (_ctx, ...args) => {
+            return materializeFileData({
+                lix,
+                file: {
+                    id: args[0],
+                    path: args[1],
+                    metadata: args[3],
+                },
+                versionId: args[2],
+            });
+        },
+    });
+    lix.sqlite.createFunction({
+        name: "materialize_file_data_at_changeset",
+        arity: 5,
+        deterministic: false,
+        xFunc: (_ctx, ...args) => {
+            return materializeFileDataAtChangeset({
+                lix,
+                file: {
+                    id: args[0],
+                    path: args[1],
+                    metadata: args[4],
+                },
+                changeSetId: args[2],
+                depth: args[3],
+            });
+        },
+    });
+    lix.sqlite.exec(`
+  CREATE VIEW IF NOT EXISTS file AS
+	SELECT
+		json_extract(snapshot_content, '$.id') AS id,
+		json_extract(snapshot_content, '$.path') AS path,
+		materialize_file_data(
+			json_extract(snapshot_content, '$.id'), 
+			json_extract(snapshot_content, '$.path'), 
+			version_id,
+			json_extract(snapshot_content, '$.metadata')
+		) AS data,
+		json_extract(snapshot_content, '$.metadata') AS metadata,
+		inherited_from_version_id AS lixcol_inherited_from_version_id,
+		created_at AS lixcol_created_at,
+		updated_at AS lixcol_updated_at,
+		change_id AS lixcol_change_id,
+		untracked AS lixcol_untracked
+	FROM state
+	WHERE schema_key = 'lix_file_descriptor';
+
+  CREATE VIEW IF NOT EXISTS file_all AS
+	SELECT
+		json_extract(snapshot_content, '$.id') AS id,
+		json_extract(snapshot_content, '$.path') AS path,
+		materialize_file_data(
+			json_extract(snapshot_content, '$.id'), 
+			json_extract(snapshot_content, '$.path'), 
+			version_id,
+			json_extract(snapshot_content, '$.metadata')
+		) AS data,
+		json_extract(snapshot_content, '$.metadata') AS metadata,
+		version_id AS lixcol_version_id,
+		inherited_from_version_id AS lixcol_inherited_from_version_id,
+		created_at AS lixcol_created_at,
+		updated_at AS lixcol_updated_at,
+		change_id AS lixcol_change_id,
+		untracked AS lixcol_untracked
+	FROM state_all
+	WHERE schema_key = 'lix_file_descriptor';
+
+
+  CREATE TRIGGER IF NOT EXISTS file_insert
+  INSTEAD OF INSERT ON file
+  BEGIN
+      SELECT handle_file_insert(
+        COALESCE(NEW.id, nano_id()),
+        NEW.path,
+        NEW.data,
+        NEW.metadata,
+        (SELECT version_id FROM active_version),
+        COALESCE(NEW.lixcol_untracked, 0)
+      );
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS file_update
+  INSTEAD OF UPDATE ON file
+  BEGIN
+      SELECT handle_file_update(
+        NEW.id,
+        NEW.path,
+        NEW.data,
+        NEW.metadata,
+        (SELECT version_id FROM active_version),
+        COALESCE(NEW.lixcol_untracked, 0)
+      );
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS file_delete
+  INSTEAD OF DELETE ON file
+  BEGIN
+      -- Delete all non-lix_file entities associated with this file first
+      DELETE FROM state_all
+      WHERE file_id = OLD.id
+        AND version_id = (SELECT version_id FROM active_version)
+        AND schema_key != 'lix_file_descriptor';
+        
+      -- Delete the file entity itself
+      DELETE FROM state_all
+      WHERE entity_id = OLD.id
+        AND schema_key = 'lix_file_descriptor'
+        AND version_id = (SELECT version_id FROM active_version);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS file_all_insert
+  INSTEAD OF INSERT ON file_all
+  BEGIN
+      SELECT handle_file_insert(
+        COALESCE(NEW.id, nano_id()),
+        NEW.path,
+        NEW.data,
+        NEW.metadata,
+        COALESCE(NEW.lixcol_version_id, (SELECT version_id FROM active_version)),
+        COALESCE(NEW.lixcol_untracked, 0)
+      );
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS file_all_update
+  INSTEAD OF UPDATE ON file_all
+  BEGIN
+      SELECT handle_file_update(
+        NEW.id,
+        NEW.path,
+        NEW.data,
+        NEW.metadata,
+        COALESCE(NEW.lixcol_version_id, OLD.lixcol_version_id),
+        COALESCE(NEW.lixcol_untracked, 0)
+      );
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS file_all_delete
+  INSTEAD OF DELETE ON file_all
+  BEGIN
+      -- Delete all non-lix_file entities associated with this file first
+      DELETE FROM state_all
+      WHERE file_id = OLD.id
+        AND version_id = OLD.lixcol_version_id
+        AND schema_key != 'lix_file_descriptor';
+        
+      -- Delete the file entity itself
+      DELETE FROM state_all
+      WHERE entity_id = OLD.id
+        AND schema_key = 'lix_file_descriptor'
+        AND version_id = OLD.lixcol_version_id;
+  END;
+
+  CREATE VIEW IF NOT EXISTS file_history AS
+  SELECT
+    json_extract(snapshot_content, '$.id') AS id,
+    json_extract(snapshot_content, '$.path') AS path,
+    materialize_file_data_at_changeset(
+      json_extract(snapshot_content, '$.id'),
+      json_extract(snapshot_content, '$.path'),
+      change_set_id,
+      depth,
+      json_extract(snapshot_content, '$.metadata')
+    ) AS data,
+    json_extract(snapshot_content, '$.metadata') AS metadata,
+    file_id AS lixcol_file_id,
+    plugin_key AS lixcol_plugin_key,
+    schema_version AS lixcol_schema_version,
+    change_id AS lixcol_change_id,
+    change_set_id AS lixcol_change_set_id,
+    depth AS lixcol_depth
+  FROM state_history
+  WHERE schema_key = 'lix_file_descriptor';
+`);
+}
+export const LixFileDescriptorSchema = {
+    "x-lix-key": "lix_file_descriptor",
+    "x-lix-version": "1.0",
+    "x-lix-primary-key": ["id"],
+    "x-lix-unique": [["path"]],
+    type: "object",
+    properties: {
+        id: { type: "string", "x-lix-generated": true },
+        path: {
+            type: "string",
+            pattern: "^/(?!.*//|.*\\\\)(?!.*/$|^/$).+",
+            description: "File path must start with a slash, not contain backslashes or consecutive slashes, and not end with a slash",
+        },
+        metadata: {
+            type: "object",
+            nullable: true,
+        },
+    },
+    required: ["id", "path"],
+    additionalProperties: false,
+};
+LixFileDescriptorSchema;
+//# sourceMappingURL=schema.js.map

package/dist/file/schema.js.map

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

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

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

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

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