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

package/dist/repository/example.js

@@ -0,0 +1,87 @@
+/**
+ * This file contains example usage of the repository pattern for Lix SDK.
+ * These examples demonstrate how to use the new abstraction layer for common operations.
+ */
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+// Example plugin to demonstrate usage
+const examplePlugin = {
+    key: "example_plugin",
+    detectChangesGlob: "*.md",
+    detectChanges: ({ before, after }) => {
+        // Simple implementation for the example
+        return [];
+    },
+    applyChanges: ({ file, changes }) => {
+        // Simple implementation for the example
+        return { fileData: file.data };
+    },
+};
+async function fileRepositoryExample() {
+    // Initialize Lix with the example plugin
+    const lix = await openLixInMemory({
+        providePlugins: [examplePlugin],
+    });
+    // Using the file repository
+    const { files } = lix.repositories;
+    // Create a new file
+    const readme = await files.create({
+        path: "/README.md",
+        data: new TextEncoder().encode("# Hello World"),
+        metadata: { createdAt: new Date().toISOString() },
+    });
+    console.log(`Created file: ${readme.path} with ID: ${readme.id}`);
+    // Get a file by path
+    const file = await files.getByPath("/README.md");
+    if (file) {
+        console.log(`Found file: ${file.path}`);
+        console.log(`Content: ${new TextDecoder().decode(file.data)}`);
+    }
+    // Update a file
+    const updatedFile = await files.update(readme.id, {
+        data: new TextEncoder().encode("# Updated Content"),
+        metadata: { ...readme.metadata, updatedAt: new Date().toISOString() },
+    });
+    console.log(`Updated file content: ${new TextDecoder().decode(updatedFile.data)}`);
+    // Find all markdown files
+    const markdownFiles = await files.findByExtension("md");
+    console.log(`Found ${markdownFiles.length} markdown files`);
+    // Create or update a file (convenience method)
+    const document = await files.createOrUpdate("/docs/document.md", new TextEncoder().encode("# New Document"), { category: "documentation" });
+    console.log(`Created or updated file: ${document.path}`);
+    // Query with more complex conditions
+    const recentFiles = await files.query()
+        .where("path", "startsWith", "/docs/")
+        .orderBy("lixcol_created_at", "desc")
+        .limit(5)
+        .execute();
+    console.log(`Found ${recentFiles.length} recent files in docs directory`);
+    // Delete a file
+    await files.deleteByPath("/README.md");
+    console.log("Deleted README.md");
+}
+async function keyValueRepositoryExample() {
+    // Initialize Lix
+    const lix = await openLixInMemory({});
+    // Using the key-value repository
+    const { keyValues } = lix.repositories;
+    // Store some values
+    await keyValues.set("user:preferences:theme", "dark");
+    await keyValues.set("user:preferences:fontSize", 14);
+    await keyValues.set("app:version", "1.0.0");
+    // Get a single value
+    const theme = await keyValues.get("user:preferences:theme");
+    console.log(`User theme: ${theme}`);
+    // Find all user preferences
+    const userPrefs = await keyValues.findByKeyPrefix("user:preferences:");
+    console.log("User preferences:", userPrefs);
+    // Update a value
+    await keyValues.set("user:preferences:theme", "light");
+    console.log(`Updated theme to: ${await keyValues.get("user:preferences:theme")}`);
+    // Delete a value
+    await keyValues.deleteKey("app:version");
+    console.log(`app:version exists: ${await keyValues.get("app:version") !== null}`);
+}
+// These examples can be run to demonstrate the repository pattern
+// fileRepositoryExample();
+// keyValueRepositoryExample();
+//# sourceMappingURL=example.js.map

package/dist/repository/example.js.map

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

package/dist/repository/file-repository.d.ts

@@ -0,0 +1,39 @@
+import type { Lix } from "../lix/open-lix.js";
+import { EntityRepository } from "./entity-repository.js";
+import { type LixFile, type NewLixFile, type LixFileUpdate } from "../file/schema.js";
+/**
+ * FileRepository provides a simplified API for file operations
+ */
+export declare class FileRepository extends EntityRepository<LixFile, NewLixFile, LixFileUpdate> {
+    constructor(lix: Lix);
+    /**
+     * Get a file by its path
+     */
+    getByPath(filePath: string): Promise<LixFile | null>;
+    /**
+     * Get a file by its path or throw if not found
+     */
+    getByPathOrThrow(filePath: string): Promise<LixFile>;
+    /**
+     * Find files in a directory
+     */
+    findInDirectory(directoryPath: string): Promise<LixFile[]>;
+    /**
+     * Find files by extension
+     */
+    findByExtension(extension: string): Promise<LixFile[]>;
+    /**
+     * Create or update a file with the given path and content
+     */
+    createOrUpdate(filePath: string, data: Uint8Array, metadata?: Record<string, any> | null): Promise<LixFile>;
+    /**
+     * Delete a file by its path
+     */
+    deleteByPath(filePath: string): Promise<void>;
+    /**
+     * Create a directory structure by ensuring all parent directories exist
+     * @note This doesn't actually create directories in the DB, but rather returns the directory path
+     */
+    ensureDirectoryExists(directoryPath: string): Promise<string>;
+}
+//# sourceMappingURL=file-repository.d.ts.map

package/dist/repository/file-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-repository.d.ts","sourceRoot":"","sources":["../../src/repository/file-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAiB,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrG;;GAEG;AACH,qBAAa,cAAe,SAAQ,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC;gBAC1E,GAAG,EAAE,GAAG;IAIpB;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAM1D;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1D;;OAEG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAWhE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAS5D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAcvH;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD;;;OAGG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAcpE"}

package/dist/repository/file-repository.js

@@ -0,0 +1,93 @@
+import { EntityRepository } from "./entity-repository.js";
+import { LixFileSchema } from "../file/schema.js";
+import path from "path";
+/**
+ * FileRepository provides a simplified API for file operations
+ */
+export class FileRepository extends EntityRepository {
+    constructor(lix) {
+        super(lix, LixFileSchema, "file");
+    }
+    /**
+     * Get a file by its path
+     */
+    async getByPath(filePath) {
+        return this.query()
+            .where("path", "=", filePath)
+            .executeTakeFirst();
+    }
+    /**
+     * Get a file by its path or throw if not found
+     */
+    async getByPathOrThrow(filePath) {
+        const file = await this.getByPath(filePath);
+        if (!file) {
+            throw new Error(`File with path ${filePath} not found`);
+        }
+        return file;
+    }
+    /**
+     * Find files in a directory
+     */
+    async findInDirectory(directoryPath) {
+        // Ensure directory path ends with a slash
+        const normalizedPath = directoryPath.endsWith("/")
+            ? directoryPath
+            : `${directoryPath}/`;
+        return this.query()
+            .where("path", "startsWith", normalizedPath)
+            .execute();
+    }
+    /**
+     * Find files by extension
+     */
+    async findByExtension(extension) {
+        // Remove the dot if it was included
+        const ext = extension.startsWith(".") ? extension : `.${extension}`;
+        return this.query()
+            .where("path", "endsWith", ext)
+            .execute();
+    }
+    /**
+     * Create or update a file with the given path and content
+     */
+    async createOrUpdate(filePath, data, metadata = null) {
+        const existingFile = await this.getByPath(filePath);
+        if (existingFile) {
+            return this.update(existingFile.id, { data, metadata });
+        }
+        else {
+            return this.create({
+                path: filePath,
+                data,
+                metadata,
+            });
+        }
+    }
+    /**
+     * Delete a file by its path
+     */
+    async deleteByPath(filePath) {
+        const file = await this.getByPath(filePath);
+        if (file) {
+            await this.delete(file.id);
+        }
+    }
+    /**
+     * Create a directory structure by ensuring all parent directories exist
+     * @note This doesn't actually create directories in the DB, but rather returns the directory path
+     */
+    async ensureDirectoryExists(directoryPath) {
+        // Normalize directory path to end with a slash
+        const normalizedPath = directoryPath.endsWith("/")
+            ? directoryPath
+            : `${directoryPath}/`;
+        // Directory existence in Lix is implicit - no directories need to be created
+        // but we validate the path
+        if (!normalizedPath.startsWith("/")) {
+            throw new Error("Directory path must start with a slash (/)");
+        }
+        return normalizedPath;
+    }
+}
+//# sourceMappingURL=file-repository.js.map

package/dist/repository/file-repository.js.map

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

package/dist/repository/file-repository.test.d.ts

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

package/dist/repository/file-repository.test.d.ts.map

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

package/dist/repository/file-repository.test.js

@@ -0,0 +1,165 @@
+import { describe, expect, it } from "vitest";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+import { FileRepository } from "./file-repository.js";
+describe("FileRepository", () => {
+    it("should create and retrieve a file", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a test file
+        const testData = new TextEncoder().encode("# Test Content");
+        const file = await fileRepo.create({
+            path: "/test.md",
+            data: testData,
+            metadata: { test: true },
+        });
+        // Verify the file was created
+        expect(file.path).toBe("/test.md");
+        expect(file.metadata).toEqual({ test: true });
+        // Retrieve the file by path
+        const retrieved = await fileRepo.getByPath("/test.md");
+        expect(retrieved).not.toBeNull();
+        expect(retrieved?.id).toBe(file.id);
+        expect(new TextDecoder().decode(retrieved.data)).toBe("# Test Content");
+    });
+    it("should update an existing file", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a test file
+        const file = await fileRepo.create({
+            path: "/test.md",
+            data: new TextEncoder().encode("# Original Content"),
+        });
+        // Update the file
+        const updatedData = new TextEncoder().encode("# Updated Content");
+        const updated = await fileRepo.update(file.id, {
+            data: updatedData,
+            metadata: { updated: true },
+        });
+        // Verify the update
+        expect(updated.id).toBe(file.id);
+        expect(new TextDecoder().decode(updated.data)).toBe("# Updated Content");
+        expect(updated.metadata).toEqual({ updated: true });
+    });
+    it("should create or update a file", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a new file
+        const file = await fileRepo.createOrUpdate("/test.md", new TextEncoder().encode("# First Content"));
+        // Update the same file
+        const updated = await fileRepo.createOrUpdate("/test.md", new TextEncoder().encode("# Updated Content"));
+        // Verify the operation
+        expect(updated.id).toBe(file.id);
+        expect(new TextDecoder().decode(updated.data)).toBe("# Updated Content");
+        // Create a different file
+        const anotherFile = await fileRepo.createOrUpdate("/another.md", new TextEncoder().encode("# Another File"));
+        expect(anotherFile.id).not.toBe(file.id);
+        expect(anotherFile.path).toBe("/another.md");
+    });
+    it("should find files by extension", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a few files with different extensions
+        await fileRepo.create({
+            path: "/test1.md",
+            data: new TextEncoder().encode("# Test 1"),
+        });
+        await fileRepo.create({
+            path: "/test2.md",
+            data: new TextEncoder().encode("# Test 2"),
+        });
+        await fileRepo.create({
+            path: "/data.json",
+            data: new TextEncoder().encode("{}"),
+        });
+        // Find by extension
+        const mdFiles = await fileRepo.findByExtension("md");
+        expect(mdFiles.length).toBe(2);
+        expect(mdFiles.map(f => f.path).sort()).toEqual(["/test1.md", "/test2.md"]);
+        const jsonFiles = await fileRepo.findByExtension("json");
+        expect(jsonFiles.length).toBe(1);
+        expect(jsonFiles[0].path).toBe("/data.json");
+    });
+    it("should find files in a directory", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a structure of files in different directories
+        await fileRepo.create({
+            path: "/docs/guide.md",
+            data: new TextEncoder().encode("# Guide"),
+        });
+        await fileRepo.create({
+            path: "/docs/api.md",
+            data: new TextEncoder().encode("# API"),
+        });
+        await fileRepo.create({
+            path: "/src/index.ts",
+            data: new TextEncoder().encode("// Code"),
+        });
+        // Find files in the docs directory
+        const docsFiles = await fileRepo.findInDirectory("/docs");
+        expect(docsFiles.length).toBe(2);
+        expect(docsFiles.map(f => f.path).sort()).toEqual(["/docs/api.md", "/docs/guide.md"]);
+        // Find files in the src directory
+        const srcFiles = await fileRepo.findInDirectory("/src");
+        expect(srcFiles.length).toBe(1);
+        expect(srcFiles[0].path).toBe("/src/index.ts");
+    });
+    it("should delete a file by path", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create a test file
+        await fileRepo.create({
+            path: "/to-delete.md",
+            data: new TextEncoder().encode("# Will be deleted"),
+        });
+        // Verify it exists
+        const file = await fileRepo.getByPath("/to-delete.md");
+        expect(file).not.toBeNull();
+        // Delete it
+        await fileRepo.deleteByPath("/to-delete.md");
+        // Verify it's gone
+        const deleted = await fileRepo.getByPath("/to-delete.md");
+        expect(deleted).toBeNull();
+    });
+    it("should use the query builder for complex queries", async () => {
+        // Initialize Lix
+        const lix = await openLixInMemory({});
+        const fileRepo = new FileRepository(lix);
+        // Create some test files
+        await fileRepo.create({
+            path: "/docs/guide.md",
+            data: new TextEncoder().encode("# Guide"),
+            metadata: { type: "documentation", priority: 1 },
+        });
+        await fileRepo.create({
+            path: "/docs/api.md",
+            data: new TextEncoder().encode("# API"),
+            metadata: { type: "documentation", priority: 2 },
+        });
+        await fileRepo.create({
+            path: "/src/index.ts",
+            data: new TextEncoder().encode("// Code"),
+            metadata: { type: "source", priority: 3 },
+        });
+        // Complex query using the query builder
+        const results = await fileRepo.query()
+            .where("path", "startsWith", "/docs/")
+            .orderBy("path", "asc")
+            .execute();
+        expect(results.length).toBe(2);
+        expect(results[0].path).toBe("/docs/api.md");
+        expect(results[1].path).toBe("/docs/guide.md");
+        // Count query
+        const count = await fileRepo.query()
+            .where("path", "endsWith", ".md")
+            .executeCount();
+        expect(count).toBe(2);
+    });
+});
+//# sourceMappingURL=file-repository.test.js.map

package/dist/repository/file-repository.test.js.map

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

package/dist/repository/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./entity-repository.js";
+export * from "./file-repository.js";
+export * from "./key-value-repository.js";
+export * from "./query-builder.js";
+export * from "./repository-manager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/repository/index.js

@@ -0,0 +1,6 @@
+export * from "./entity-repository.js";
+export * from "./file-repository.js";
+export * from "./key-value-repository.js";
+export * from "./query-builder.js";
+export * from "./repository-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/repository/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/repository/integration.test.d.ts

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

package/dist/repository/integration.test.d.ts.map

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

package/dist/repository/integration.test.js

@@ -0,0 +1,136 @@
+import { describe, expect, it } from "vitest";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+// A simplified markdown plugin for testing
+const testMarkdownPlugin = {
+    key: "test_markdown_plugin",
+    detectChangesGlob: "*.md",
+    detectChanges: ({ before, after }) => {
+        const afterText = after?.data ? new TextDecoder().decode(after.data) : "";
+        return [
+            {
+                schema: {
+                    "x-lix-key": "markdown_block",
+                    "x-lix-version": "1.0",
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        text: { type: "string" },
+                        type: { type: "string" }
+                    }
+                },
+                entity_id: "block1",
+                snapshot_content: {
+                    id: "block1",
+                    text: afterText,
+                    type: "document",
+                }
+            }
+        ];
+    },
+    applyChanges: ({ file, changes }) => {
+        const blockChanges = changes.filter(c => c.schema_key === "markdown_block" && c.snapshot_content);
+        if (blockChanges.length === 0) {
+            return { fileData: file.data };
+        }
+        const text = blockChanges
+            .map(c => c.snapshot_content?.text || "")
+            .join("\n\n");
+        return {
+            fileData: new TextEncoder().encode(text)
+        };
+    }
+};
+describe("Repository Pattern Integration Test", () => {
+    it("should work with the file repository and a plugin", async () => {
+        // Initialize Lix with the test markdown plugin
+        const lix = await openLixInMemory({
+            providePlugins: [testMarkdownPlugin],
+        });
+        // Create a markdown file
+        const file = await lix.repositories.files.create({
+            path: "/test.md",
+            data: new TextEncoder().encode("# Test Document"),
+        });
+        expect(file.path).toBe("/test.md");
+        expect(new TextDecoder().decode(file.data)).toBe("# Test Document");
+        // Update the file
+        const updatedFile = await lix.repositories.files.update(file.id, {
+            data: new TextEncoder().encode("# Updated Document"),
+        });
+        expect(updatedFile.id).toBe(file.id);
+        expect(new TextDecoder().decode(updatedFile.data)).toBe("# Updated Document");
+        // Check changes were detected by the plugin
+        const changes = await lix.db
+            .selectFrom("change")
+            .innerJoin("snapshot", "change.snapshot_id", "snapshot.id")
+            .where("file_id", "=", file.id)
+            .where("schema_key", "=", "markdown_block")
+            .execute();
+        expect(changes.length).toBeGreaterThan(0);
+        // The latest change should have the updated content
+        const latestChange = changes[changes.length - 1];
+        expect(latestChange.snapshot_content.text).toBe("# Updated Document");
+    });
+    it("should support interoperability between repositories", async () => {
+        // Initialize Lix with the test markdown plugin
+        const lix = await openLixInMemory({
+            providePlugins: [testMarkdownPlugin],
+        });
+        // Create multiple files
+        await lix.repositories.files.createOrUpdate("/docs/readme.md", new TextEncoder().encode("# Readme"));
+        await lix.repositories.files.createOrUpdate("/docs/guide.md", new TextEncoder().encode("# User Guide"));
+        // Store metadata about the files in key-value store
+        await lix.repositories.keyValues.set("docs:count", 2);
+        await lix.repositories.keyValues.set("docs:last-updated", new Date().toISOString());
+        // Query files and key-values together
+        const mdFiles = await lix.repositories.files.findByExtension("md");
+        const docsCount = await lix.repositories.keyValues.get("docs:count");
+        expect(mdFiles.length).toBe(2);
+        expect(docsCount).toBe(2);
+        // Use query builder with files
+        const docFiles = await lix.repositories.files.query()
+            .where("path", "startsWith", "/docs/")
+            .execute();
+        expect(docFiles.length).toBe(2);
+        // Store file references in key-value store
+        await lix.repositories.keyValues.set("file:readme:id", docFiles[0].id);
+        // Retrieve a file using the stored ID
+        const readmeId = await lix.repositories.keyValues.get("file:readme:id");
+        const readme = await lix.repositories.files.findOne(readmeId);
+        expect(readme).not.toBeNull();
+        expect(readme?.path).toContain("/docs/");
+    });
+    it("should support versioning with repositories", async () => {
+        // Initialize Lix with the test markdown plugin
+        const lix = await openLixInMemory({
+            providePlugins: [testMarkdownPlugin],
+        });
+        // Create a file
+        const file = await lix.repositories.files.createOrUpdate("/test.md", new TextEncoder().encode("# Version 1"));
+        // Create a new version
+        const versionB = await lix.db
+            .insertInto("version")
+            .values({
+            name: "version-b",
+            description: "Test Version B",
+        })
+            .returning("id")
+            .executeTakeFirstOrThrow();
+        // Switch to the new version
+        await lix.db
+            .updateTable("active_version")
+            .set({
+            version_id: versionB.id,
+        })
+            .execute();
+        // Update the file in the new version
+        await lix.repositories.files.update(file.id, {
+            data: new TextEncoder().encode("# Version 2"),
+        });
+        // The file should now have the new content
+        const updatedFile = await lix.repositories.files.getByPath("/test.md");
+        expect(updatedFile).not.toBeNull();
+        expect(new TextDecoder().decode(updatedFile.data)).toBe("# Version 2");
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/repository/integration.test.js.map

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

package/dist/repository/key-value-repository.d.ts

@@ -0,0 +1,30 @@
+import type { Lix } from "../lix/open-lix.js";
+import { EntityRepository } from "./entity-repository.js";
+import { type KeyValue, type NewKeyValue, type KeyValueUpdate } from "../key-value/schema.js";
+/**
+ * KeyValueRepository provides a simplified API for key-value operations
+ */
+export declare class KeyValueRepository extends EntityRepository<KeyValue, NewKeyValue, KeyValueUpdate> {
+    constructor(lix: Lix);
+    /**
+     * Get a value by its key
+     */
+    get(key: string): Promise<any | null>;
+    /**
+     * Get a value by its key or throw if not found
+     */
+    getOrThrow(key: string): Promise<any>;
+    /**
+     * Set a value for a key (create or update)
+     */
+    set(key: string, value: any): Promise<KeyValue>;
+    /**
+     * Find all entries with keys that match a prefix
+     */
+    findByKeyPrefix(prefix: string): Promise<KeyValue[]>;
+    /**
+     * Delete a key-value pair by its key
+     */
+    deleteKey(key: string): Promise<void>;
+}
+//# sourceMappingURL=key-value-repository.d.ts.map

package/dist/repository/key-value-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-repository.d.ts","sourceRoot":"","sources":["../../src/repository/key-value-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAqB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEjH;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC;gBACjF,GAAG,EAAE,GAAG;IAKpB;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAQ3C;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAarD;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAM1D;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5C"}