refactor: consume Commonlib as a package

src/apps/webapp/adapters/FSAPIConversionAdapter.ts

@@ -1,5 +1,5 @@
-import type { FilePath, UXFileInfoStub, UXFolderInfo } from "@lib/common/types";
-import type { IConversionAdapter } from "@lib/serviceModules/adapters";
+import type { FilePath, UXFileInfoStub, UXFolderInfo } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { IConversionAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import type { FSAPIFile, FSAPIFolder } from "./FSAPITypes";
 
 /**

src/apps/webapp/adapters/FSAPIFileSystemAdapter.ts

@@ -1,9 +1,9 @@
-import type { FilePath, UXStat } from "@lib/common/types";
-import type { IFileSystemAdapter } from "@lib/serviceModules/adapters";
+import type { FilePath, UXStat } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { IFileSystemAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import { FSAPIPathAdapter } from "./FSAPIPathAdapter";
 import { FSAPITypeGuardAdapter } from "./FSAPITypeGuardAdapter";
 import { FSAPIConversionAdapter } from "./FSAPIConversionAdapter";
-import { FSAPIStorageAdapter } from "./FSAPIStorageAdapter";
+import { FileSystemAccessStorageAdapter } from "@vrtmrz/livesync-commonlib/browser";
 import { FSAPIVaultAdapter } from "./FSAPIVaultAdapter";
 import type { FSAPIFile, FSAPIFolder, FSAPIStat } from "./FSAPITypes";
 import { shareRunningResult } from "octagonal-wheels/concurrency/lock_v2";
@@ -15,7 +15,7 @@ export class FSAPIFileSystemAdapter implements IFileSystemAdapter<FSAPIFile, FSA
     readonly path: FSAPIPathAdapter;
     readonly typeGuard: FSAPITypeGuardAdapter;
     readonly conversion: FSAPIConversionAdapter;
-    readonly storage: FSAPIStorageAdapter;
+    readonly storage: FileSystemAccessStorageAdapter;
     readonly vault: FSAPIVaultAdapter;
 
     private fileCache = new Map<string, FSAPIFile>();
@@ -25,7 +25,7 @@ export class FSAPIFileSystemAdapter implements IFileSystemAdapter<FSAPIFile, FSA
         this.path = new FSAPIPathAdapter();
         this.typeGuard = new FSAPITypeGuardAdapter();
         this.conversion = new FSAPIConversionAdapter();
-        this.storage = new FSAPIStorageAdapter(rootHandle);
+        this.storage = new FileSystemAccessStorageAdapter(rootHandle);
         this.vault = new FSAPIVaultAdapter(rootHandle);
     }
 

src/apps/webapp/adapters/FSAPIPathAdapter.ts

@@ -1,5 +1,5 @@
-import type { FilePath } from "@lib/common/types";
-import type { IPathAdapter } from "@lib/serviceModules/adapters";
+import type { FilePath } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { IPathAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import type { FSAPIFile } from "./FSAPITypes";
 
 /**

src/apps/webapp/adapters/FSAPIStorageAdapter.ts

@@ -1,225 +0,0 @@
-import type { UXDataWriteOptions } from "@lib/common/types";
-import type { IStorageAdapter } from "@lib/serviceModules/adapters";
-import type { FSAPIStat } from "./FSAPITypes";
-import { validateStoragePath } from "@/apps/storagePath";
-
-/**
- * Storage adapter implementation for FileSystem API
- */
-export class FSAPIStorageAdapter implements IStorageAdapter<FSAPIStat> {
-    constructor(private readonly rootHandle: FileSystemDirectoryHandle) {}
-
-    /**
-     * Resolve a path to directory and file handles
-     */
-    private async resolvePath(p: string): Promise<{
-        dirHandle: FileSystemDirectoryHandle;
-        fileName: string;
-    } | null> {
-        validateStoragePath(p, false);
-        try {
-            const parts = p.split("/").filter((part) => part !== "");
-
-            let currentHandle = this.rootHandle;
-            const fileName = parts[parts.length - 1];
-
-            // Navigate to the parent directory
-            for (let i = 0; i < parts.length - 1; i++) {
-                currentHandle = await currentHandle.getDirectoryHandle(parts[i]);
-            }
-
-            return { dirHandle: currentHandle, fileName };
-        } catch {
-            return null;
-        }
-    }
-
-    /**
-     * Get file handle for a given path
-     */
-    private async getFileHandle(p: string): Promise<FileSystemFileHandle | null> {
-        validateStoragePath(p);
-        if (p === "") return null;
-        const resolved = await this.resolvePath(p);
-        if (!resolved) return null;
-
-        try {
-            return await resolved.dirHandle.getFileHandle(resolved.fileName);
-        } catch {
-            return null;
-        }
-    }
-
-    /**
-     * Get directory handle for a given path
-     */
-    private async getDirectoryHandle(p: string): Promise<FileSystemDirectoryHandle | null> {
-        validateStoragePath(p);
-        try {
-            const parts = p.split("/").filter((part) => part !== "");
-            if (parts.length === 0) {
-                return this.rootHandle;
-            }
-
-            let currentHandle = this.rootHandle;
-            for (const part of parts) {
-                currentHandle = await currentHandle.getDirectoryHandle(part);
-            }
-
-            return currentHandle;
-        } catch {
-            return null;
-        }
-    }
-
-    /** Resolve a writable file path after creating its parent directories. */
-    private async resolveWritablePath(p: string): Promise<{
-        dirHandle: FileSystemDirectoryHandle;
-        fileName: string;
-    } | null> {
-        validateStoragePath(p, false);
-        const parts = p.split("/").filter((part) => part !== "");
-        const fileName = parts.pop()!;
-        const parentPath = parts.join("/");
-        await this.mkdir(parentPath);
-        const dirHandle = await this.getDirectoryHandle(parentPath);
-        return dirHandle ? { dirHandle, fileName } : null;
-    }
-
-    async exists(p: string): Promise<boolean> {
-        const fileHandle = await this.getFileHandle(p);
-        if (fileHandle) return true;
-
-        const dirHandle = await this.getDirectoryHandle(p);
-        return dirHandle !== null;
-    }
-
-    async trystat(p: string): Promise<FSAPIStat | null> {
-        // Try as file first
-        const fileHandle = await this.getFileHandle(p);
-        if (fileHandle) {
-            const file = await fileHandle.getFile();
-            return {
-                size: file.size,
-                mtime: file.lastModified,
-                ctime: file.lastModified,
-                type: "file",
-            };
-        }
-
-        // Try as directory
-        const dirHandle = await this.getDirectoryHandle(p);
-        if (dirHandle) {
-            return {
-                size: 0,
-                mtime: Date.now(),
-                ctime: Date.now(),
-                type: "folder",
-            };
-        }
-
-        return null;
-    }
-
-    async stat(p: string): Promise<FSAPIStat | null> {
-        return await this.trystat(p);
-    }
-
-    async mkdir(p: string): Promise<void> {
-        validateStoragePath(p);
-        const parts = p.split("/").filter((part) => part !== "");
-        let currentHandle = this.rootHandle;
-
-        for (const part of parts) {
-            currentHandle = await currentHandle.getDirectoryHandle(part, { create: true });
-        }
-    }
-
-    async remove(p: string): Promise<void> {
-        const resolved = await this.resolvePath(p);
-        if (!resolved) return;
-
-        await resolved.dirHandle.removeEntry(resolved.fileName, { recursive: true });
-    }
-
-    async read(p: string): Promise<string> {
-        const fileHandle = await this.getFileHandle(p);
-        if (!fileHandle) {
-            throw new Error(`File not found: ${p}`);
-        }
-
-        const file = await fileHandle.getFile();
-        return await file.text();
-    }
-
-    async readBinary(p: string): Promise<ArrayBuffer> {
-        const fileHandle = await this.getFileHandle(p);
-        if (!fileHandle) {
-            throw new Error(`File not found: ${p}`);
-        }
-
-        const file = await fileHandle.getFile();
-        return await file.arrayBuffer();
-    }
-
-    async write(p: string, data: string, options?: UXDataWriteOptions): Promise<void> {
-        const resolved = await this.resolveWritablePath(p);
-        if (!resolved) {
-            throw new Error(`Invalid path: ${p}`);
-        }
-
-        const fileHandle = await resolved.dirHandle.getFileHandle(resolved.fileName, { create: true });
-        const writable = await fileHandle.createWritable();
-        await writable.write(data);
-        await writable.close();
-    }
-
-    async writeBinary(p: string, data: ArrayBuffer, options?: UXDataWriteOptions): Promise<void> {
-        const resolved = await this.resolveWritablePath(p);
-        if (!resolved) {
-            throw new Error(`Invalid path: ${p}`);
-        }
-
-        const fileHandle = await resolved.dirHandle.getFileHandle(resolved.fileName, { create: true });
-        const writable = await fileHandle.createWritable();
-        await writable.write(data);
-        await writable.close();
-    }
-
-    async append(p: string, data: string, options?: UXDataWriteOptions): Promise<void> {
-        const existing = await this.exists(p);
-        if (existing) {
-            const currentContent = await this.read(p);
-            await this.write(p, currentContent + data, options);
-        } else {
-            await this.write(p, data, options);
-        }
-    }
-
-    async list(basePath: string): Promise<{ files: string[]; folders: string[] }> {
-        const dirHandle = await this.getDirectoryHandle(basePath);
-        if (!dirHandle) {
-            return { files: [], folders: [] };
-        }
-
-        const files: string[] = [];
-        const folders: string[] = [];
-
-        // Use AsyncIterator instead of .values() for better compatibility
-        for await (const [name, entry] of (
-            dirHandle as unknown as {
-                entries(): AsyncIterable<[string, FileSystemHandle]>;
-            }
-        ).entries()) {
-            const entryPath = basePath ? `${basePath}/${name}` : name;
-
-            if (entry.kind === "directory") {
-                folders.push(entryPath);
-            } else if (entry.kind === "file") {
-                files.push(entryPath);
-            }
-        }
-
-        return { files, folders };
-    }
-}

src/apps/webapp/adapters/FSAPIStorageAdapter.unit.spec.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from "vitest";
 import { storageAdapterContractCases } from "@/apps/_test/storageAdapterContract";
 import { FSAPIFileSystemAdapter } from "./FSAPIFileSystemAdapter";
-import { FSAPIStorageAdapter } from "./FSAPIStorageAdapter";
+import { FileSystemAccessStorageAdapter } from "@vrtmrz/livesync-commonlib/browser";
 import { FSAPIVaultAdapter } from "./FSAPIVaultAdapter";
 
 class MemoryFileHandle {
@@ -100,11 +100,11 @@ class MemoryDirectoryHandle {
     }
 }
 
-describe("FSAPIStorageAdapter", () => {
+describe("FileSystemAccessStorageAdapter", () => {
     for (const contractCase of storageAdapterContractCases) {
         it(contractCase.name, async () => {
             const root = new MemoryDirectoryHandle("root") as unknown as FileSystemDirectoryHandle;
-            await contractCase.run(new FSAPIStorageAdapter(root));
+            await contractCase.run(new FileSystemAccessStorageAdapter(root));
         });
     }
 });

src/apps/webapp/adapters/FSAPITypeGuardAdapter.ts

@@ -1,4 +1,4 @@
-import type { ITypeGuardAdapter } from "@lib/serviceModules/adapters";
+import type { ITypeGuardAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import type { FSAPIFile, FSAPIFolder } from "./FSAPITypes";
 
 /**

src/apps/webapp/adapters/FSAPITypes.ts

@@ -1,4 +1,4 @@
-import type { FilePath, UXStat } from "@lib/common/types";
+import type { FilePath, UXStat } from "@vrtmrz/livesync-commonlib/compat/common/types";
 
 /**
  * FileSystem API file representation

src/apps/webapp/adapters/FSAPIVaultAdapter.ts

@@ -1,5 +1,5 @@
-import type { FilePath, UXDataWriteOptions } from "@lib/common/types";
-import type { IVaultAdapter } from "@lib/serviceModules/adapters";
+import type { FilePath, UXDataWriteOptions } from "@vrtmrz/livesync-commonlib/compat/common/types";
+import type { IVaultAdapter } from "@vrtmrz/livesync-commonlib/compat/serviceModules/adapters";
 import type { FSAPIFile, FSAPIFolder } from "./FSAPITypes";
 
 /**