@elanlanguages/bridge-anonymization 0.1.3 → 0.2.0

package/dist/utils/storage-browser.js

@@ -0,0 +1,381 @@
+/**
+ * Browser Storage Provider
+ * Implements StorageProvider using IndexedDB for text data and OPFS for binary files
+ */
+import { join } from "./path.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const DB_NAME = "bridge-anonymization";
+const DB_VERSION = 1;
+const STORE_NAME = "files";
+const CACHE_PREFIX = "bridge-anonymization";
+// ============================================================================
+// IndexedDB Helpers
+// ============================================================================
+/**
+ * Opens the IndexedDB database
+ */
+function openDatabase() {
+    return new Promise((resolve, reject) => {
+        const request = indexedDB.open(DB_NAME, DB_VERSION);
+        request.onerror = () => {
+            reject(new Error(`Failed to open IndexedDB: ${request.error?.message}`));
+        };
+        request.onsuccess = () => {
+            resolve(request.result);
+        };
+        request.onupgradeneeded = (event) => {
+            const db = event.target.result;
+            if (!db.objectStoreNames.contains(STORE_NAME)) {
+                db.createObjectStore(STORE_NAME);
+            }
+        };
+    });
+}
+/**
+ * Gets a value from IndexedDB
+ */
+async function idbGet(key) {
+    const db = await openDatabase();
+    return new Promise((resolve, reject) => {
+        const transaction = db.transaction(STORE_NAME, "readonly");
+        const store = transaction.objectStore(STORE_NAME);
+        const request = store.get(key);
+        request.onerror = () => {
+            reject(new Error(`Failed to read from IndexedDB: ${request.error?.message}`));
+        };
+        request.onsuccess = () => {
+            resolve(request.result);
+        };
+        transaction.oncomplete = () => {
+            db.close();
+        };
+    });
+}
+/**
+ * Sets a value in IndexedDB
+ */
+async function idbSet(key, value) {
+    const db = await openDatabase();
+    return new Promise((resolve, reject) => {
+        const transaction = db.transaction(STORE_NAME, "readwrite");
+        const store = transaction.objectStore(STORE_NAME);
+        const request = store.put(value, key);
+        request.onerror = () => {
+            reject(new Error(`Failed to write to IndexedDB: ${request.error?.message}`));
+        };
+        transaction.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+    });
+}
+/**
+ * Deletes a value from IndexedDB
+ */
+async function idbDelete(key) {
+    const db = await openDatabase();
+    return new Promise((resolve, reject) => {
+        const transaction = db.transaction(STORE_NAME, "readwrite");
+        const store = transaction.objectStore(STORE_NAME);
+        const request = store.delete(key);
+        request.onerror = () => {
+            reject(new Error(`Failed to delete from IndexedDB: ${request.error?.message}`));
+        };
+        transaction.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+    });
+}
+/**
+ * Gets all keys from IndexedDB that start with a prefix
+ */
+async function idbGetKeysWithPrefix(prefix) {
+    const db = await openDatabase();
+    return new Promise((resolve, reject) => {
+        const transaction = db.transaction(STORE_NAME, "readonly");
+        const store = transaction.objectStore(STORE_NAME);
+        const request = store.getAllKeys();
+        request.onerror = () => {
+            reject(new Error(`Failed to get keys from IndexedDB: ${request.error?.message}`));
+        };
+        request.onsuccess = () => {
+            const allKeys = request.result;
+            const matchingKeys = allKeys.filter((key) => typeof key === "string" && key.startsWith(prefix));
+            resolve(matchingKeys);
+        };
+        transaction.oncomplete = () => {
+            db.close();
+        };
+    });
+}
+// ============================================================================
+// OPFS Helpers
+// ============================================================================
+/**
+ * Checks if OPFS is available
+ */
+function isOPFSAvailable() {
+    return (typeof navigator !== "undefined" &&
+        "storage" in navigator &&
+        "getDirectory" in navigator.storage);
+}
+/**
+ * Gets the OPFS root directory handle
+ */
+async function getOPFSRoot() {
+    if (!isOPFSAvailable()) {
+        throw new Error("Origin Private File System is not available in this browser");
+    }
+    return navigator.storage.getDirectory();
+}
+/**
+ * Gets a file handle from OPFS, creating parent directories if needed
+ */
+async function getOPFSFileHandle(path, create) {
+    const root = await getOPFSRoot();
+    const parts = path.split("/").filter((p) => p !== "");
+    if (parts.length === 0) {
+        return null;
+    }
+    const filename = parts.pop();
+    let dir = root;
+    // Navigate/create directories
+    for (const part of parts) {
+        try {
+            dir = await dir.getDirectoryHandle(part, { create });
+        }
+        catch {
+            if (!create)
+                return null;
+            throw new Error(`Failed to access directory: ${part}`);
+        }
+    }
+    // Get file handle
+    try {
+        return await dir.getFileHandle(filename, { create });
+    }
+    catch {
+        if (!create)
+            return null;
+        throw new Error(`Failed to access file: ${filename}`);
+    }
+}
+// ============================================================================
+// Browser Storage Provider Implementation
+// ============================================================================
+/**
+ * Browser implementation of StorageProvider
+ * Uses IndexedDB for text data and OPFS for binary files (like models)
+ */
+export class BrowserStorageProvider {
+    /**
+     * Determines if a path should use OPFS (for large binary files)
+     */
+    shouldUseOPFS(path) {
+        // Use OPFS for model files (large binaries)
+        return path.includes("/models/") && (path.endsWith(".onnx") ||
+            path.endsWith(".bin") ||
+            path.endsWith(".safetensors"));
+    }
+    /**
+     * Normalizes a path to a storage key
+     */
+    toStorageKey(path) {
+        // Remove leading slashes and normalize
+        return path.replace(/^\/+/, "").replace(/\/+/g, "/");
+    }
+    /**
+     * Reads a file as binary data
+     */
+    async readFile(path) {
+        const key = this.toStorageKey(path);
+        if (this.shouldUseOPFS(path) && isOPFSAvailable()) {
+            // Read from OPFS
+            const handle = await getOPFSFileHandle(key, false);
+            if (!handle) {
+                throw new Error(`File not found: ${path}`);
+            }
+            const file = await handle.getFile();
+            const buffer = await file.arrayBuffer();
+            return new Uint8Array(buffer);
+        }
+        // Read from IndexedDB
+        const data = await idbGet(key);
+        if (data === undefined) {
+            throw new Error(`File not found: ${path}`);
+        }
+        if (data instanceof Uint8Array) {
+            return data;
+        }
+        if (typeof data === "string") {
+            const encoder = new TextEncoder();
+            return encoder.encode(data);
+        }
+        throw new Error(`Invalid data type for file: ${path}`);
+    }
+    /**
+     * Reads a file as text
+     */
+    async readTextFile(path, encoding) {
+        const key = this.toStorageKey(path);
+        // First try IndexedDB (where we store text files)
+        const data = await idbGet(key);
+        if (data !== undefined) {
+            if (typeof data === "string") {
+                return data;
+            }
+            if (data instanceof Uint8Array) {
+                // Handle latin1 encoding
+                if (encoding === "latin1") {
+                    // Latin1 is a 1:1 mapping of byte values to characters
+                    return Array.from(data)
+                        .map((b) => String.fromCharCode(b))
+                        .join("");
+                }
+                const decoder = new TextDecoder(encoding ?? "utf-8");
+                return decoder.decode(data);
+            }
+        }
+        // Try OPFS as fallback
+        if (isOPFSAvailable()) {
+            const handle = await getOPFSFileHandle(key, false);
+            if (handle) {
+                const file = await handle.getFile();
+                if (encoding === "latin1") {
+                    const buffer = await file.arrayBuffer();
+                    const bytes = new Uint8Array(buffer);
+                    return Array.from(bytes)
+                        .map((b) => String.fromCharCode(b))
+                        .join("");
+                }
+                return file.text();
+            }
+        }
+        throw new Error(`File not found: ${path}`);
+    }
+    /**
+     * Writes data to a file
+     */
+    async writeFile(path, data) {
+        const key = this.toStorageKey(path);
+        if (this.shouldUseOPFS(path) && isOPFSAvailable()) {
+            // Write to OPFS for large binary files
+            const handle = await getOPFSFileHandle(key, true);
+            if (!handle) {
+                throw new Error(`Failed to create file: ${path}`);
+            }
+            const writable = await handle.createWritable();
+            // Cast data to the expected type for FileSystemWritableFileStream
+            await writable.write(typeof data === "string" ? data : data);
+            await writable.close();
+        }
+        else {
+            // Write to IndexedDB for smaller/text files
+            await idbSet(key, data);
+        }
+    }
+    /**
+     * Checks if a file exists
+     */
+    async exists(path) {
+        const key = this.toStorageKey(path);
+        // Check IndexedDB first
+        const idbData = await idbGet(key);
+        if (idbData !== undefined) {
+            return true;
+        }
+        // Check OPFS
+        if (isOPFSAvailable()) {
+            const handle = await getOPFSFileHandle(key, false);
+            if (handle) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Creates a directory (no-op in browser storage, directories are implicit)
+     */
+    async mkdir(_path) {
+        // Directories are created implicitly when writing files
+        // For OPFS, we create them when needed
+    }
+    /**
+     * Removes a file or directory
+     */
+    async rm(path, options) {
+        const key = this.toStorageKey(path);
+        if (options?.recursive === true) {
+            // Delete all keys with this prefix from IndexedDB
+            const keys = await idbGetKeysWithPrefix(key);
+            for (const k of keys) {
+                await idbDelete(k);
+            }
+            // Delete from OPFS if available
+            if (isOPFSAvailable()) {
+                try {
+                    const root = await getOPFSRoot();
+                    const parts = key.split("/").filter((p) => p !== "");
+                    let dir = root;
+                    // Navigate to parent directory
+                    for (let i = 0; i < parts.length - 1; i++) {
+                        try {
+                            dir = await dir.getDirectoryHandle(parts[i]);
+                        }
+                        catch {
+                            return; // Directory doesn't exist
+                        }
+                    }
+                    // Remove the entry
+                    const name = parts[parts.length - 1];
+                    if (name !== undefined && name !== "") {
+                        await dir.removeEntry(name, { recursive: true });
+                    }
+                }
+                catch {
+                    if (options?.force !== true) {
+                        throw new Error(`Failed to remove: ${path}`);
+                    }
+                }
+            }
+        }
+        else {
+            // Delete single file
+            try {
+                await idbDelete(key);
+            }
+            catch (e) {
+                if (options?.force !== true)
+                    throw e;
+            }
+            if (isOPFSAvailable()) {
+                try {
+                    const handle = await getOPFSFileHandle(key, false);
+                    if (handle !== null) {
+                        const root = await getOPFSRoot();
+                        const parts = key.split("/").filter((p) => p !== "");
+                        let dir = root;
+                        for (let i = 0; i < parts.length - 1; i++) {
+                            dir = await dir.getDirectoryHandle(parts[i]);
+                        }
+                        await dir.removeEntry(parts[parts.length - 1]);
+                    }
+                }
+                catch (e) {
+                    if (options?.force !== true)
+                        throw e;
+                }
+            }
+        }
+    }
+    /**
+     * Gets the cache directory path (virtual path in browser)
+     */
+    getCacheDir(subdir) {
+        return join(CACHE_PREFIX, subdir);
+    }
+}
+//# sourceMappingURL=storage-browser.js.map

package/dist/utils/storage-browser.js.map

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

package/dist/utils/storage-node.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Node.js Storage Provider
+ * Implements StorageProvider using Node.js fs/promises
+ */
+import type { StorageProvider } from "./storage.js";
+/**
+ * Node.js implementation of StorageProvider
+ * Uses fs/promises for file operations
+ */
+export declare class NodeStorageProvider implements StorageProvider {
+    /**
+     * Reads a file as binary data
+     */
+    readFile(path: string): Promise<Uint8Array>;
+    /**
+     * Reads a file as text
+     */
+    readTextFile(path: string, encoding?: string): Promise<string>;
+    /**
+     * Writes data to a file
+     */
+    writeFile(path: string, data: Uint8Array | string): Promise<void>;
+    /**
+     * Checks if a file or directory exists
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Creates a directory
+     */
+    mkdir(path: string): Promise<void>;
+    /**
+     * Removes a file or directory
+     */
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Gets the platform-specific cache directory
+     */
+    getCacheDir(subdir: string): string;
+}
+//# sourceMappingURL=storage-node.d.ts.map

package/dist/utils/storage-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-node.d.ts","sourceRoot":"","sources":["../../src/utils/storage-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKjD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMpE;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5C;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACG,EAAE,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACjD,OAAO,CAAC,IAAI,CAAC;IAOhB;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAsBpC"}

package/dist/utils/storage-node.js

@@ -0,0 +1,93 @@
+/**
+ * Node.js Storage Provider
+ * Implements StorageProvider using Node.js fs/promises
+ */
+import * as fs from "fs/promises";
+import * as nodePath from "path";
+import * as os from "os";
+/**
+ * Node.js implementation of StorageProvider
+ * Uses fs/promises for file operations
+ */
+export class NodeStorageProvider {
+    /**
+     * Reads a file as binary data
+     */
+    async readFile(path) {
+        const buffer = await fs.readFile(path);
+        return new Uint8Array(buffer);
+    }
+    /**
+     * Reads a file as text
+     */
+    async readTextFile(path, encoding) {
+        // Handle latin1 encoding (used by nam_dict.txt)
+        const nodeEncoding = encoding === "latin1" ? "latin1" : "utf-8";
+        return fs.readFile(path, { encoding: nodeEncoding });
+    }
+    /**
+     * Writes data to a file
+     */
+    async writeFile(path, data) {
+        // Ensure parent directory exists
+        const dir = nodePath.dirname(path);
+        await fs.mkdir(dir, { recursive: true });
+        if (typeof data === "string") {
+            await fs.writeFile(path, data, "utf-8");
+        }
+        else {
+            await fs.writeFile(path, data);
+        }
+    }
+    /**
+     * Checks if a file or directory exists
+     */
+    async exists(path) {
+        try {
+            await fs.access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Creates a directory
+     */
+    async mkdir(path) {
+        await fs.mkdir(path, { recursive: true });
+    }
+    /**
+     * Removes a file or directory
+     */
+    async rm(path, options) {
+        await fs.rm(path, {
+            recursive: options?.recursive ?? false,
+            force: options?.force ?? false,
+        });
+    }
+    /**
+     * Gets the platform-specific cache directory
+     */
+    getCacheDir(subdir) {
+        const homeDir = os.homedir();
+        let baseDir;
+        switch (process.platform) {
+            case "darwin":
+                baseDir = nodePath.join(homeDir, "Library", "Caches");
+                break;
+            case "win32":
+                baseDir =
+                    process.env["LOCALAPPDATA"] ??
+                        nodePath.join(homeDir, "AppData", "Local");
+                break;
+            default:
+                // Linux and others - use XDG_CACHE_HOME or ~/.cache
+                baseDir =
+                    process.env["XDG_CACHE_HOME"] ?? nodePath.join(homeDir, ".cache");
+                break;
+        }
+        return nodePath.join(baseDir, "bridge-anonymization", subdir);
+    }
+}
+//# sourceMappingURL=storage-node.js.map

package/dist/utils/storage-node.js.map

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

package/dist/utils/storage.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Storage Abstraction Layer
+ * Provides a unified interface for file storage across Node.js and browser environments
+ */
+/**
+ * Storage provider interface
+ * Implementations exist for Node.js (fs) and browser (IndexedDB/OPFS)
+ */
+export interface StorageProvider {
+    /**
+     * Reads a file as binary data
+     */
+    readFile(path: string): Promise<Uint8Array>;
+    /**
+     * Reads a file as text
+     * @param encoding - Character encoding (default: 'utf-8', also supports 'latin1')
+     */
+    readTextFile(path: string, encoding?: string): Promise<string>;
+    /**
+     * Writes data to a file
+     * Creates parent directories if they don't exist
+     */
+    writeFile(path: string, data: Uint8Array | string): Promise<void>;
+    /**
+     * Checks if a file or directory exists
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Creates a directory (and parent directories if needed)
+     */
+    mkdir(path: string): Promise<void>;
+    /**
+     * Removes a file or directory
+     */
+    rm(path: string, options?: {
+        recursive?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Gets the cache directory path for a given subdirectory
+     * @param subdir - Subdirectory name (e.g., 'models', 'semantic-data')
+     */
+    getCacheDir(subdir: string): string;
+}
+/**
+ * Detects if running in Node.js environment
+ */
+export declare function isNode(): boolean;
+/**
+ * Detects if running in browser environment
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Detects if running in a Web Worker
+ */
+export declare function isWebWorker(): boolean;
+/**
+ * Gets the appropriate storage provider for the current environment
+ * Uses lazy loading to avoid importing unnecessary modules
+ */
+export declare function getStorageProvider(): Promise<StorageProvider>;
+/**
+ * Resets the storage provider (useful for testing)
+ */
+export declare function resetStorageProvider(): void;
+/**
+ * Sets a custom storage provider (useful for testing)
+ */
+export declare function setStorageProvider(provider: StorageProvider): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpF;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAMD;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAMhC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAKrC;AAQD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAoBnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAElE"}