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

package/dist/environment/opfs-sah.worker.js

@@ -0,0 +1,212 @@
+import { createInMemoryDatabase, } from "../database/sqlite/index.js";
+import { boot } from "../engine/boot.js";
+let sqlite3Module;
+let poolUtil;
+let sqlite; // OpfsSAHPoolDb (sqlite3.oo1.DB subclass)
+let currentOpfsPath;
+let engine = null;
+/**
+ * Normalize the client-provided logical database name for the SAH pool VFS.
+ *
+ * - The SAH pool uses a virtual filesystem keyed by names beginning with "/".
+ * - Callers pass a simple logical key (e.g. "project-a"); this function
+ *   ensures it is prefixed with "/" before passing to the VFS.
+ *
+ * @param name Logical database key provided by the host.
+ * @returns Normalized SAH pool path (always prefixed with "/").
+ */
+function opfsName(name) {
+    return name.startsWith("/") ? name : "/" + name;
+}
+/**
+ * Lazily initialize the sqlite3 module (loaded via an in-memory database helper).
+ *
+ * - This gives us a handle to the module required to install the SAH pool VFS
+ *   and to open sqlite3.oo1.DB instances.
+ * - Safe to call multiple times; subsequent calls are no-ops.
+ */
+async function ensureSqlite() {
+    if (!sqlite3Module) {
+        const temp = await createInMemoryDatabase({
+            readOnly: false,
+        });
+        sqlite3Module = temp.sqlite3;
+    }
+}
+/**
+ * Ensure the OPFS SyncAccessHandle pool VFS is installed exactly once per worker.
+ *
+ * - Installs the SAH pool VFS via sqlite3Module.installOpfsSAHPoolVfs().
+ * - Retries a few times with backoff to avoid transient handle contention
+ *   (e.g. immediately after a previous pool is released).
+ * - Safe to call multiple times; subsequent calls are no-ops once poolUtil is set.
+ */
+async function ensurePool() {
+    await ensureSqlite();
+    if (poolUtil)
+        return;
+    let attempts = 0;
+    const maxAttempts = 4;
+    while (true) {
+        try {
+            poolUtil = await sqlite3Module.installOpfsSAHPoolVfs();
+            return;
+        }
+        catch (e) {
+            attempts++;
+            if (attempts >= maxAttempts)
+                throw e;
+            const delay = Math.pow(2, attempts - 1) * 25;
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+}
+/**
+ * Handle a single host → worker RPC request and return a response.
+ *
+ * Supported operations:
+ * - "open": open an existing DB by key and boot the Lix engine.
+ * - "create": import a blob for a new DB by key (refuses to overwrite) — no boot.
+ * - "exists": check if a DB for the given key exists (via SAH pool metadata).
+ * - execBatch: removed; host should loop over call('lix_exec_sync', ...) or use explicit transactions.
+ * - "export": export the current DB bytes via the SAH pool.
+ * - "close": close the current DB and release worker references (pool is kept).
+ */
+async function handle(req) {
+    try {
+        switch (req.op) {
+            case "open": {
+                // Ensure pool VFS is available
+                await ensurePool();
+                const opfsPath = opfsName(req.payload.name);
+                currentOpfsPath = opfsPath;
+                // Open DB and boot engine
+                const uri = `file:${opfsPath}?vfs=opfs-sahpool`;
+                sqlite = new sqlite3Module.oo1.DB(uri, "c");
+                sqlite.sqlite3 = sqlite3Module;
+                const bootArgs = (req.payload.bootArgs ?? {
+                    providePlugins: [],
+                    providePluginsRaw: [],
+                });
+                const bootedEngine = await boot({
+                    // db is sqlite3.oo1 DB; engine expects sqlite-wasm compatible surface
+                    sqlite,
+                    emit: (ev) => {
+                        self.postMessage({ type: "event", event: ev });
+                    },
+                    args: bootArgs,
+                });
+                engine = bootedEngine;
+                return { id: req.id, ok: true };
+            }
+            case "create": {
+                // Ensure pool VFS is available
+                await ensurePool();
+                const opfsPath = opfsName(req.payload.name);
+                currentOpfsPath = opfsPath;
+                // Refuse overwrite to avoid data loss
+                let exists = false;
+                try {
+                    const existing = poolUtil.exportFile(opfsPath);
+                    exists = !!existing && existing.byteLength > 0;
+                }
+                catch {
+                    exists = false;
+                }
+                if (exists) {
+                    throw Object.assign(new Error("OPFS SAH VFS: database already exists for this name; refusing to import seed blob to avoid data loss"), { code: "LIX_OPFS_ALREADY_EXISTS" });
+                }
+                // Import the provided blob into the SAH pool
+                poolUtil.importDb(opfsPath, new Uint8Array(req.payload.blob));
+                // Creation is import-only. The host is expected to call "open" next.
+                sqlite = undefined;
+                currentOpfsPath = opfsPath;
+                engine = null;
+                return { id: req.id, ok: true };
+            }
+            case "exists": {
+                // Check via pool metadata whether the DB for the given name exists
+                await ensurePool();
+                const opfsPath = opfsName(req.payload.name);
+                let exists = false;
+                try {
+                    const bytes = poolUtil.exportFile(opfsPath);
+                    exists = !!bytes && bytes.byteLength > 0;
+                }
+                catch {
+                    exists = false;
+                }
+                return { id: req.id, ok: true, result: exists };
+            }
+            case "export": {
+                if (!poolUtil || !sqlite)
+                    throw new Error("Engine not initialized");
+                // Export using poolUtil (must match open path)
+                const rawName = (sqlite?.getFilename?.() ??
+                    sqlite?.filename ??
+                    currentOpfsPath ??
+                    "").replace(/^file:/, "");
+                const name = rawName.split("?")[0] || currentOpfsPath || rawName;
+                const bytes = poolUtil.exportFile(name);
+                const buf = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+                return {
+                    id: req.id,
+                    ok: true,
+                    result: { blob: buf },
+                    transfer: [buf],
+                };
+            }
+            case "close": {
+                if (sqlite) {
+                    sqlite.close();
+                }
+                // Keep VFS installed so the pool persists across sessions in this worker
+                sqlite = undefined;
+                currentOpfsPath = undefined;
+                engine = null;
+                return { id: req.id, ok: true };
+            }
+            case "call": {
+                if (!sqlite)
+                    throw new Error("Environment not initialized");
+                const { route, payload } = req.payload;
+                if (!engine?.call) {
+                    return {
+                        id: req.id,
+                        ok: false,
+                        error: {
+                            name: "LixRpcError",
+                            message: "engine router unavailable",
+                            code: "LIX_RPC_ROUTER_UNAVAILABLE",
+                        },
+                    };
+                }
+                const result = await engine.call(route, payload);
+                return { id: req.id, ok: true, result };
+            }
+        }
+    }
+    catch (err) {
+        return {
+            id: req.id,
+            ok: false,
+            error: {
+                name: err?.name ?? "Error",
+                message: String(err?.message ?? err),
+                code: err?.code,
+                stack: err?.stack ? String(err.stack) : undefined,
+            },
+        };
+    }
+}
+self.onmessage = async (ev) => {
+    const res = await handle(ev.data);
+    const transfer = res.transfer;
+    if (transfer && transfer.length) {
+        self.postMessage(res, transfer);
+    }
+    else {
+        self.postMessage(res);
+    }
+};
+//# sourceMappingURL=opfs-sah.worker.js.map

package/dist/environment/opfs-sah.worker.js.map

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

package/dist/environment/test-actors/echo.actor.d.ts

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

package/dist/environment/test-actors/echo.actor.d.ts.map

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

package/dist/environment/test-actors/echo.actor.js

@@ -0,0 +1,7 @@
+const globalScope = self;
+globalScope.onmessage = (event) => {
+    // Echo back the data so tests can observe initialization + pings.
+    globalScope.postMessage({ received: event.data });
+};
+export {};
+//# sourceMappingURL=echo.actor.js.map

package/dist/environment/test-actors/echo.actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.actor.js","sourceRoot":"","sources":["../../../src/environment/test-actors/echo.actor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAW,CAAC;AAEhC,WAAW,CAAC,SAAS,GAAG,CAAC,KAAmB,EAAE,EAAE;IAC/C,kEAAkE;IAClE,WAAW,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC"}

package/dist/filesystem/directory/ensure-directories.d.ts

@@ -0,0 +1,48 @@
+import type { LixEngine } from "../../engine/boot.js";
+export declare function getActiveVersionId(engine: Pick<LixEngine, "executeSync">): string;
+export declare function readDirectoryByPath(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    path: string;
+}): {
+    id: string;
+    parent_id: string | null;
+    path: string;
+} | undefined;
+export declare function readDirectoryPathById(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    directoryId: string;
+}): string | undefined;
+export declare function assertNoFileAtPath(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    filePath: string;
+}): void;
+export declare function assertNoDirectoryAtFilePath(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    filePath: string;
+}): void;
+export declare function computeDirectoryPath(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    parentId: string | null;
+    name: string;
+}): string;
+export declare function ensureDirectoryAncestors(args: {
+    engine: Pick<LixEngine, "executeSync" | "hooks">;
+    versionId?: string;
+    filePath: string;
+}): void;
+export declare function ensureDirectoryPathExists(args: {
+    engine: Pick<LixEngine, "executeSync" | "hooks">;
+    versionId: string;
+    path: string;
+}): string | null;
+export declare function composeDirectoryPath(args: {
+    engine: Pick<LixEngine, "executeSync">;
+    versionId: string;
+    directoryId: string | null;
+}): string | undefined;
+//# sourceMappingURL=ensure-directories.d.ts.map

package/dist/filesystem/directory/ensure-directories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-directories.d.ts","sourceRoot":"","sources":["../../../src/filesystem/directory/ensure-directories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtD,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,GACpC,MAAM,CAYR;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA0CrE;AA2BD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,GAAG,SAAS,CAMrB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAcP;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAeP;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CA4BT;AAgBD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC9C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CA8BP;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC/C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,GAAG,IAAI,CAoChB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAC1C,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,MAAM,GAAG,SAAS,CA6BrB"}

package/dist/filesystem/directory/ensure-directories.js

@@ -0,0 +1,223 @@
+import { internalQueryBuilder } from "../../engine/internal-query-builder.js";
+import { normalizeDirectoryPath, normalizeFilePath, normalizePathSegment, } from "../path.js";
+export function getActiveVersionId(engine) {
+    const result = engine.executeSync(internalQueryBuilder
+        .selectFrom("active_version")
+        .select("version_id")
+        .compile()).rows;
+    const versionId = result[0]?.version_id;
+    if (!versionId) {
+        throw new Error("No active version present");
+    }
+    return versionId;
+}
+export function readDirectoryByPath(args) {
+    if (args.path === "/") {
+        return undefined;
+    }
+    const segments = args.path.slice(1, -1).split("/");
+    let parentId = null;
+    let lastRow;
+    for (const segment of segments) {
+        const result = args.engine.executeSync({
+            sql: `
+				SELECT
+					json_extract(snapshot_content, '$.id') AS id,
+					json_extract(snapshot_content, '$.parent_id') AS parent_id
+				FROM state_by_version
+				WHERE schema_key = 'lix_directory_descriptor'
+					AND version_id = ?
+					AND json_extract(snapshot_content, '$.name') = ?
+					AND ${parentId === null ? "json_extract(snapshot_content, '$.parent_id') IS NULL" : "json_extract(snapshot_content, '$.parent_id') = ?"}
+				LIMIT 1;
+			`,
+            parameters: parentId === null
+                ? [args.versionId, segment]
+                : [args.versionId, segment, parentId],
+        }).rows;
+        const row = result[0];
+        if (!row) {
+            return undefined;
+        }
+        lastRow = {
+            id: row.id,
+            parent_id: row.parent_id ?? null,
+        };
+        parentId = lastRow.id;
+    }
+    if (!lastRow) {
+        return undefined;
+    }
+    return { id: lastRow.id, parent_id: lastRow.parent_id, path: args.path };
+}
+function readDirectoryDescriptorById(args) {
+    const rows = args.engine.executeSync(internalQueryBuilder
+        .selectFrom("state_by_version")
+        .where("schema_key", "=", "lix_directory_descriptor")
+        .where("version_id", "=", args.versionId)
+        .where("entity_id", "=", args.directoryId)
+        .select(["snapshot_content"])
+        .compile()).rows;
+    const raw = rows[0]?.snapshot_content;
+    if (!raw) {
+        return undefined;
+    }
+    const snapshot = typeof raw === "string" ? JSON.parse(raw) : raw;
+    return snapshot;
+}
+export function readDirectoryPathById(args) {
+    return composeDirectoryPath({
+        engine: args.engine,
+        versionId: args.versionId,
+        directoryId: args.directoryId,
+    });
+}
+export function assertNoFileAtPath(args) {
+    const rows = args.engine.executeSync(internalQueryBuilder
+        .selectFrom("file_by_version")
+        .where("path", "=", args.filePath)
+        .where("lixcol_version_id", "=", args.versionId)
+        .select(["id"])
+        .compile()).rows;
+    if (rows.length > 0) {
+        throw new Error(`Directory path collides with existing file path: ${args.filePath}`);
+    }
+}
+export function assertNoDirectoryAtFilePath(args) {
+    const directoryPath = `${args.filePath}/`;
+    const rows = args.engine.executeSync(internalQueryBuilder
+        .selectFrom("directory_by_version")
+        .where("path", "=", directoryPath)
+        .where("lixcol_version_id", "=", args.versionId)
+        .select(["id"])
+        .compile()).rows;
+    if (rows.length > 0) {
+        throw new Error(`File path collides with existing directory path: ${directoryPath}`);
+    }
+}
+export function computeDirectoryPath(args) {
+    const rawName = args.name?.trim();
+    const name = normalizePathSegment(rawName ?? "");
+    if (!name) {
+        throw new Error("Directory name must be provided");
+    }
+    const parentPath = args.parentId
+        ? composeDirectoryPath({
+            engine: args.engine,
+            versionId: args.versionId,
+            directoryId: args.parentId,
+        })
+        : "/";
+    if (!parentPath) {
+        throw new Error(`Parent directory does not exist for id ${args.parentId}`);
+    }
+    const candidatePath = normalizeDirectoryPath(`${parentPath}${name}/`);
+    assertNoFileAtPath({
+        engine: args.engine,
+        versionId: args.versionId,
+        filePath: candidatePath.slice(0, -1),
+    });
+    return candidatePath;
+}
+function listAncestorDirectories(filePath) {
+    const normalizedPath = normalizeFilePath(filePath);
+    const segments = normalizedPath.split("/").filter(Boolean);
+    segments.pop();
+    const paths = [];
+    let current = "";
+    for (const segment of segments) {
+        const normalizedSegment = normalizePathSegment(segment);
+        current += `/${normalizedSegment}`;
+        paths.push(`${current}/`.normalize("NFC"));
+    }
+    return paths;
+}
+export function ensureDirectoryAncestors(args) {
+    const versionId = args.versionId ?? getActiveVersionId(args.engine);
+    const directories = listAncestorDirectories(args.filePath);
+    if (directories.length === 0)
+        return;
+    let parentId = null;
+    for (const dirPath of directories) {
+        const existing = readDirectoryByPath({
+            engine: args.engine,
+            versionId,
+            path: dirPath,
+        });
+        if (existing) {
+            parentId = existing.id;
+            continue;
+        }
+        const name = normalizePathSegment(dirPath.slice(1, -1).split("/").pop() ?? "");
+        const result = args.engine.executeSync({
+            sql: `SELECT handle_directory_upsert(NULL, ?, ?, ?, 0, ?) AS id;`,
+            parameters: [parentId, name, dirPath, versionId],
+        }).rows;
+        const insertedId = result[0]?.id;
+        if (typeof insertedId !== "string") {
+            throw new Error(`Failed to create directory for path ${dirPath}`);
+        }
+        parentId = insertedId;
+    }
+}
+export function ensureDirectoryPathExists(args) {
+    if (args.path === "/") {
+        return null;
+    }
+    const normalizedPath = normalizeDirectoryPath(args.path);
+    const segments = normalizedPath.slice(1, -1).split("/");
+    let parentId = null;
+    let currentPath = "";
+    for (const segment of segments) {
+        const normalizedSegment = normalizePathSegment(segment);
+        currentPath += `/${normalizedSegment}`;
+        const fullPath = normalizeDirectoryPath(`${currentPath}/`);
+        const existing = readDirectoryByPath({
+            engine: args.engine,
+            versionId: args.versionId,
+            path: fullPath,
+        });
+        if (existing) {
+            parentId = existing.id;
+            continue;
+        }
+        const result = args.engine.executeSync({
+            sql: `SELECT handle_directory_upsert(NULL, ?, ?, NULL, 0, ?) AS id;`,
+            parameters: [parentId, normalizedSegment, args.versionId],
+        }).rows;
+        const insertedId = result[0]?.id;
+        if (typeof insertedId !== "string") {
+            throw new Error(`Failed to create directory for path ${fullPath}`);
+        }
+        parentId = insertedId;
+    }
+    return parentId;
+}
+export function composeDirectoryPath(args) {
+    if (args.directoryId === null) {
+        return "/";
+    }
+    const segments = [];
+    let currentId = args.directoryId;
+    let safety = 0;
+    while (currentId) {
+        if (safety++ > 1024) {
+            throw new Error("Directory hierarchy appears to be cyclic");
+        }
+        const descriptor = readDirectoryDescriptorById({
+            engine: args.engine,
+            versionId: args.versionId,
+            directoryId: currentId,
+        });
+        if (!descriptor) {
+            return undefined;
+        }
+        segments.push(descriptor.name);
+        currentId = descriptor.parent_id ?? null;
+    }
+    if (segments.length === 0) {
+        return "/";
+    }
+    return `/${segments.reverse().join("/")}/`.normalize("NFC");
+}
+//# sourceMappingURL=ensure-directories.js.map

package/dist/filesystem/directory/ensure-directories.js.map

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

package/dist/filesystem/directory/schema-definition.d.ts

@@ -0,0 +1,36 @@
+import type { FromLixSchemaDefinition } from "../../schema-definition/definition.js";
+export type LixDirectoryDescriptor = FromLixSchemaDefinition<typeof LixDirectoryDescriptorSchema>;
+export declare const LixDirectoryDescriptorSchema: {
+    readonly "x-lix-key": "lix_directory_descriptor";
+    readonly "x-lix-version": "1.0";
+    readonly "x-lix-primary-key": readonly ["/id"];
+    readonly "x-lix-unique": readonly [readonly ["/parent_id", "/name"]];
+    readonly "x-lix-override-lixcols": {
+        readonly lixcol_file_id: "\"lix\"";
+        readonly lixcol_plugin_key: "\"lix_sdk\"";
+    };
+    readonly type: "object";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly "x-lix-default": "lix_uuid_v7()";
+        };
+        readonly parent_id: {
+            readonly type: "string";
+            readonly nullable: true;
+            readonly description: "Identifier of the parent directory. Null indicates the virtual root directory.";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly pattern: "^[^/\\\\]+$";
+            readonly description: "Directory segment without slashes.";
+        };
+        readonly hidden: {
+            readonly type: "boolean";
+            readonly "x-lix-default": "false";
+        };
+    };
+    readonly required: readonly ["id", "parent_id", "name"];
+    readonly additionalProperties: false;
+};
+//# sourceMappingURL=schema-definition.d.ts.map

package/dist/filesystem/directory/schema-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-definition.d.ts","sourceRoot":"","sources":["../../../src/filesystem/directory/schema-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EAEvB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAC3D,OAAO,4BAA4B,CACnC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiC/B,CAAC"}

package/dist/filesystem/directory/schema-definition.js

@@ -0,0 +1,35 @@
+export const LixDirectoryDescriptorSchema = {
+    "x-lix-key": "lix_directory_descriptor",
+    "x-lix-version": "1.0",
+    "x-lix-primary-key": ["/id"],
+    "x-lix-unique": [["/parent_id", "/name"]],
+    "x-lix-override-lixcols": {
+        lixcol_file_id: '"lix"',
+        lixcol_plugin_key: '"lix_sdk"',
+    },
+    type: "object",
+    properties: {
+        id: {
+            type: "string",
+            "x-lix-default": "lix_uuid_v7()",
+        },
+        parent_id: {
+            type: "string",
+            nullable: true,
+            description: "Identifier of the parent directory. Null indicates the virtual root directory.",
+        },
+        name: {
+            type: "string",
+            pattern: "^[^/\\\\]+$",
+            description: "Directory segment without slashes.",
+        },
+        hidden: {
+            type: "boolean",
+            "x-lix-default": "false",
+        },
+    },
+    required: ["id", "parent_id", "name"],
+    additionalProperties: false,
+};
+LixDirectoryDescriptorSchema;
+//# sourceMappingURL=schema-definition.js.map

package/dist/filesystem/directory/schema-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-definition.js","sourceRoot":"","sources":["../../../src/filesystem/directory/schema-definition.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC3C,WAAW,EAAE,0BAA0B;IACvC,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,CAAC,KAAK,CAAC;IAC5B,cAAc,EAAE,CAAC,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACzC,wBAAwB,EAAE;QACzB,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,WAAW;KAC9B;IACD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,EAAE,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,eAAe;SAChC;QACD,SAAS,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EACV,gFAAgF;SACjF;QACD,IAAI,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,aAAa;YACtB,WAAW,EAAE,oCAAoC;SACjD;QACD,MAAM,EAAE;YACP,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,OAAO;SACxB;KACD;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC;IACrC,oBAAoB,EAAE,KAAK;CAClB,CAAC;AACX,4BAA0D,CAAC"}

package/dist/filesystem/directory/schema.d.ts

@@ -0,0 +1,11 @@
+import type { LixEngine } from "../../engine/boot.js";
+/**
+ * Installs directory descriptors into the database via generated views/triggers.
+ *
+ * @example
+ * applyDirectoryDatabaseSchema({ engine });
+ */
+export declare function applyDirectoryDatabaseSchema(args: {
+    engine: LixEngine;
+}): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/filesystem/directory/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/filesystem/directory/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AActD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,SAAS,CAAC;CAClB,GAAG,IAAI,CA6YP"}