opfs-worker 0.2.3 → 0.2.5

package/dist/raw.js.map

@@ -1 +1 @@
-{"version":3,"file":"raw.js","sources":["../src/worker.ts"],"sourcesContent":["import { expose } from 'comlink';\n\nimport { decodeBuffer } from './utils/encoder';\nimport {\n    FileNotFoundError,\n    OPFSError,\n    OPFSNotMountedError,\n    PathError\n} from './utils/errors';\n\nimport { \n    calculateFileHash, \n    checkOPFSSupport, \n    joinPath, \n    readFileData, \n    splitPath, \n    writeFileData,\n    basename,\n    dirname,\n    normalizePath,\n    resolvePath,\n    convertBlobToUint8Array\n} from './utils/helpers';\n\nimport type { DirentData, FileStat, WatchEvent } from './types';\nimport type { BufferEncoding } from 'typescript';\n\n/**\n * OPFS (Origin Private File System) File System implementation\n * \n * This class provides a high-level interface for working with the browser's\n * Origin Private File System API, offering file and directory operations\n * similar to Node.js fs module.\n * \n * @example\n * ```typescript\n * const fs = new OPFSFileSystem();\n * await fs.init('/my-app');\n * await fs.writeFile('/data/config.json', JSON.stringify({ theme: 'dark' }));\n * const config = await fs.readFile('/data/config.json');\n * ```\n */\nexport class OPFSWorker {\n    /** Root directory handle for the file system */\n    private root: FileSystemDirectoryHandle | null = null;\n\n    /** Watch event callback */\n    private watchCallback: ((event: WatchEvent) => void) | null = null;\n\n    /** Map of watched paths to their last known state */\n    private watchers = new Map<string, Map<string, FileStat>>();\n\n    /** Interval handle for polling watched paths */\n    private watchTimer: ReturnType<typeof setInterval> | null = null;\n\n    /** Polling interval in milliseconds */\n    private watchInterval = 1000;\n\n    /** Flag to avoid concurrent scans */\n    private scanning = false;\n\n    /** Promise to prevent concurrent mount operations */\n    private mountingPromise: Promise<boolean> | null = null;\n\n    /**\n     * Creates a new OPFSFileSystem instance\n     * \n     * @param watchCallback - Optional callback for file change events\n     * @param watchOptions - Optional configuration for watching\n     * @throws {OPFSError} If OPFS is not supported in the current browser\n     */\n    constructor(\n        watchCallback?: (event: WatchEvent) => void,\n        watchOptions?: { watchInterval?: number }\n    ) {\n        checkOPFSSupport();\n        \n        if (watchCallback) {\n            this.watchCallback = watchCallback;\n            if (watchOptions?.watchInterval) {\n                this.watchInterval = watchOptions.watchInterval;\n            }\n        }\n        \n        void this.mount('/');\n    }\n\n    /**\n     * Initialize the file system within a given directory\n     * \n     * This method sets up the root directory for all subsequent operations.\n     * If no root is specified, it will use the OPFS root directory.\n     * \n     * @param root - The root path for the file system (default: '/')\n     * @returns Promise that resolves to true if initialization was successful\n     * @throws {OPFSError} If initialization fails\n     * \n     * @example\n     * ```typescript\n     * const fs = new OPFSFileSystem();\n     * \n     * // Use OPFS root (default)\n     * await fs.mount();\n     * \n     * // Use custom directory\n     * await fs.mount('/my-app');\n     * ```\n     */\n    async mount(root: string = '/'): Promise<boolean> {\n        // If already mounting, wait for previous operation to complete first\n        if (this.mountingPromise) {\n            await this.mountingPromise;\n        }\n\n        this.mountingPromise = new Promise<boolean>(async(resolve, reject) => {\n            this.root = null;\n    \n            try {\n                const rootDir = await navigator.storage.getDirectory();\n    \n                if (root === '/') {\n                    this.root = rootDir;\n                } \n                else {\n                    this.root = await this.getDirectoryHandle(root, true, rootDir);\n                }\n                resolve(true);\n            }\n            catch (error) {\n                console.error(error);\n                reject(new OPFSError('Failed to initialize OPFS', 'INIT_FAILED'));\n            }\n            finally {\n                this.mountingPromise = null;\n            }\n        });\n\n        return this.mountingPromise;\n    }\n\n    /**\n     * Set the watch callback for file change events\n     * \n     * @param callback - The callback function to invoke when files change\n     * @param options - Optional configuration for watching\n     */\n    setWatchCallback(callback: (event: WatchEvent) => void, options?: { watchInterval?: number }): void {\n        this.watchCallback = callback;\n\n        if (options?.watchInterval) {\n            this.watchInterval = options.watchInterval;\n        }\n    }\n\n    /**\n     * Automatically mount the OPFS root if not already mounted\n     * \n     * This method is called internally when file operations are performed\n     * without explicitly mounting first.\n     * \n     * @returns Promise that resolves when auto-mount is complete\n     * @throws {OPFSError} If auto-mount fails\n     */\n    private async ensureMounted(): Promise<void> {\n        // If already mounted, return immediately\n        if (this.root) {\n            return;\n        }\n\n        // If already mounting, wait for that operation to complete\n        if (this.mountingPromise) {\n            await this.mountingPromise;\n            return;\n        }\n\n        throw new OPFSError('OPFS not mounted', 'NOT_MOUNTED');\n    }\n\n    /**\n     * Get a directory handle from a path\n     * \n     * Navigates through the directory structure to find or create a directory\n     * at the specified path.\n     * \n     * @param path - The path to the directory (string or array of segments)\n     * @param create - Whether to create the directory if it doesn't exist (default: false)\n     * @param from - The directory to start from (default: root directory)\n     * @returns Promise that resolves to the directory handle\n     * @throws {OPFSError} If the directory cannot be accessed or created\n     * \n     * @example\n     * ```typescript\n     * const docsDir = await fs.getDirectoryHandle('/users/john/documents', true);\n     * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);\n     * ```\n     */\n    private async getDirectoryHandle(path: string | string[], create: boolean = false, from: FileSystemDirectoryHandle | null = this.root): Promise<FileSystemDirectoryHandle> {\n        if (!from) {\n            throw new OPFSNotMountedError();\n        }\n\n        const segments = Array.isArray(path) ? path : splitPath(path);\n        let current = from;\n\n        for (const segment of segments) {\n            current = await current.getDirectoryHandle(segment, { create });\n        }\n\n        return current;\n    }\n\n    /**\n     * Get a file handle from a path\n     * \n     * Navigates to the parent directory and retrieves or creates a file handle\n     * for the specified file path.\n     * \n     * @param path - The path to the file (string or array of segments)\n     * @param create - Whether to create the file if it doesn't exist (default: false)\n     * @param from - The directory to start from (default: root directory)\n     * @returns Promise that resolves to the file handle\n     * @throws {PathError} If the path is empty\n     * @throws {OPFSError} If the file cannot be accessed or created\n     * \n     * @example\n     * ```typescript\n     * const fileHandle = await fs.getFileHandle('/config/settings.json', true);\n     * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);\n     * ```\n     */\n    private async getFileHandle(path: string | string[], create = false, from: FileSystemDirectoryHandle | null = this.root): Promise<FileSystemFileHandle> {\n        if (!from) {\n            throw new OPFSNotMountedError();\n        }\n\n        const segments = splitPath(path);\n\n        if (segments.length === 0) {\n            throw new PathError('Path must not be empty', Array.isArray(path) ? path.join('/') : path);\n        }\n\n        const fileName = segments.pop()!;\n        const dir = await this.getDirectoryHandle(segments, create, from);\n\n        return dir.getFileHandle(fileName, { create });\n    }\n\n\n    /**\n     * Recursively list all files and directories with their stats\n     * \n     * Traverses the entire file system starting from the root and returns\n     * a Map containing all paths and their corresponding file statistics.\n     * \n     * @param options - Options for indexing\n     * @param options.includeHash - Whether to calculate file hash (default: false)\n     * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)\n     * @returns Promise that resolves to a Map of path => FileStat\n     * @throws {OPFSError} If the indexing operation fails\n     * \n     * @example\n     * ```typescript\n     * // Basic index without hash\n     * const index = await fs.index();\n     * \n     * // Index with file hash\n     * const indexWithHash = await fs.index({ \n     *   includeHash: true,\n     *   hashAlgorithm: 'SHA-1'\n     * });\n     * \n     * // Iterate through all files and directories\n     * for (const [path, stat] of index) {\n     *   console.log(`${path}: ${stat.isFile ? 'file' : 'directory'} (${stat.size} bytes)`);\n     *   if (stat.hash) console.log(`  Hash: ${stat.hash}`);\n     * }\n     * \n     * // Get specific file stats\n     * const fileStats = index.get('/data/config.json');\n     * if (fileStats) {\n     *   console.log(`File size: ${fileStats.size} bytes`);\n     *   if (fileStats.hash) console.log(`Hash: ${fileStats.hash}`);\n     * }\n     * ```\n     */\n    async index(options?: { includeHash?: boolean; hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' }): Promise<Map<string, FileStat>> {\n        const result = new Map<string, FileStat>();\n\n        const walk = async(dirPath: string) => {\n            const items = await this.readdir(dirPath, { withFileTypes: true });\n\n            for (const item of items) {\n                const fullPath = `${ dirPath === '/' ? '' : dirPath }/${ item.name }`;\n\n                try {\n                    const stat = await this.stat(fullPath, options);\n\n                    result.set(fullPath, stat);\n\n                    if (stat.isDirectory) {\n                        await walk(fullPath);\n                    }\n                }\n                catch (err) {\n                    console.warn(`Skipping broken entry: ${ fullPath }`, err);\n                }\n            }\n        };\n\n        result.set('/', {\n            kind: 'directory',\n            size: 0,\n            mtime: new Date(0).toISOString(),\n            ctime: new Date(0).toISOString(),\n            isFile: false,\n            isDirectory: true,\n        });\n\n        await walk('/');\n\n        return result;\n    }\n\n    /**\n     * Read a file from the file system\n     * \n     * Reads the contents of a file and returns it as a string or binary data\n     * depending on the specified encoding.\n     * \n     * @param path - The path to the file to read\n     * @param encoding - The encoding to use for reading the file\n     * @returns Promise that resolves to the file contents\n     * @throws {FileNotFoundError} If the file does not exist\n     * @throws {OPFSError} If reading the file fails\n     * \n     * @example\n     * ```typescript\n     * // Read as text\n     * const content = await fs.readFile('/config/settings.json');\n     * \n     * // Read as binary\n     * const binaryData = await fs.readFile('/images/logo.png', 'binary');\n     * \n     * // Read with specific encoding\n     * const utf8Content = await fs.readFile('/data/utf8.txt', 'utf-8');\n     * ```\n     */\n    async readFile(path: string, encoding: 'binary'): Promise<Uint8Array>;\n    async readFile(path: string, encoding?: BufferEncoding): Promise<string>;\n    async readFile(\n        path: string,\n        encoding: BufferEncoding | 'binary' = 'utf-8'\n    ): Promise<string | Uint8Array> {\n        await this.ensureMounted();\n        \n        try {\n            const fileHandle = await this.getFileHandle(path, false);\n            const buffer = await readFileData(fileHandle);\n\n            if (encoding === 'binary') {\n                return buffer;\n            }\n\n            return decodeBuffer(buffer, encoding);\n        }\n        catch (err) {\n            console.error(err);\n\n            throw new FileNotFoundError(path);\n        }\n    }\n\n    /**\n     * Write data to a file\n     * \n     * Creates or overwrites a file with the specified data. If the file already\n     * exists, it will be truncated before writing.\n     * \n     * @param path - The path to the file to write\n     * @param data - The data to write to the file (string, Uint8Array, or ArrayBuffer)\n     * @param encoding - The encoding to use when writing string data (default: 'utf-8')\n     * @returns Promise that resolves when the write operation is complete\n     * @throws {OPFSError} If writing the file fails\n     * \n     * @example\n     * ```typescript\n     * // Write text data\n     * await fs.writeFile('/config/settings.json', JSON.stringify({ theme: 'dark' }));\n     * \n     * // Write binary data\n     * const binaryData = new Uint8Array([1, 2, 3, 4, 5]);\n     * await fs.writeFile('/data/binary.dat', binaryData);\n     * \n     * // Write with specific encoding\n     * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');\n     * ```\n     */\n    async writeFile(\n        path: string,\n        data: string | Uint8Array | ArrayBuffer,\n        encoding?: BufferEncoding\n    ): Promise<void> {\n        await this.ensureMounted();\n        \n        const fileHandle = await this.getFileHandle(path, true);\n\n        await writeFileData(fileHandle, data, encoding, { truncate: true });\n    }\n\n    /**\n     * Append data to a file\n     * \n     * Adds data to the end of an existing file. If the file doesn't exist,\n     * it will be created.\n     * \n     * @param path - The path to the file to append to\n     * @param data - The data to append to the file (string, Uint8Array, or ArrayBuffer)\n     * @param encoding - The encoding to use when appending string data (default: 'utf-8')\n     * @returns Promise that resolves when the append operation is complete\n     * @throws {OPFSError} If appending to the file fails\n     * \n     * @example\n     * ```typescript\n     * // Append text to a log file\n     * await fs.appendFile('/logs/app.log', `[${new Date().toISOString()}] User logged in\\n`);\n     * \n     * // Append binary data\n     * const additionalData = new Uint8Array([6, 7, 8]);\n     * await fs.appendFile('/data/binary.dat', additionalData);\n     * ```\n     */\n    async appendFile(\n        path: string,\n        data: string | Uint8Array | ArrayBuffer,\n        encoding?: BufferEncoding\n    ): Promise<void> {\n        await this.ensureMounted();\n        \n        const fileHandle = await this.getFileHandle(path, true);\n\n        await writeFileData(fileHandle, data, encoding, { append: true });\n    }\n\n    /**\n     * Create a directory\n     * \n     * Creates a new directory at the specified path. If the recursive option\n     * is enabled, parent directories will be created as needed.\n     * \n     * @param path - The path where the directory should be created\n     * @param options - Options for directory creation\n     * @param options.recursive - Whether to create parent directories if they don't exist (default: false)\n     * @returns Promise that resolves when the directory is created\n     * @throws {OPFSError} If the directory cannot be created\n     * \n     * @example\n     * ```typescript\n     * // Create a single directory\n     * await fs.mkdir('/users/john');\n     * \n     * // Create nested directories\n     * await fs.mkdir('/users/john/documents/projects', { recursive: true });\n     * ```\n     */\n    async mkdir(path: string, options?: { recursive?: boolean }): Promise<void> {\n        await this.ensureMounted();\n\n        if (!this.root) {\n            throw new OPFSNotMountedError();\n        }\n\n        const recursive = options?.recursive ?? false;\n        const segments = splitPath(path);\n\n        let current = this.root;\n\n        for (let i = 0; i < segments.length; i++) {\n            const segment = segments[i];\n\n            try {\n                current = await current.getDirectoryHandle(segment!, { create: recursive || i === segments.length - 1 });\n            }\n            catch (e: any) {\n                if (e.name === 'NotFoundError') {\n                    throw new OPFSError(\n                        `Parent directory does not exist: ${ joinPath(segments.slice(0, i + 1)) }`,\n                        'ENOENT'\n                    );\n                }\n\n                if (e.name === 'TypeMismatchError') {\n                    throw new OPFSError(`Path segment is not a directory: ${ segment }`, 'ENOTDIR');\n                }\n\n                throw new OPFSError('Failed to create directory', 'MKDIR_FAILED');\n            }\n        }\n    }\n\n    /**\n     * Get file or directory stats\n     * \n     * Retrieves metadata about a file or directory, including size, modification time,\n     * type information, and optionally file hashes.\n     * \n     * @param path - The path to the file or directory\n     * @param options - Options for stat operation\n     * @param options.includeHash - Whether to calculate file hash (default: false, only for files)\n     * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)\n     * @returns Promise that resolves to file/directory statistics\n     * @throws {OPFSError} If the file or directory does not exist or cannot be accessed\n     * \n     * @example\n     * ```typescript\n     * // Basic stats\n     * const stats = await fs.stat('/config/settings.json');\n     * console.log(`File size: ${stats.size} bytes`);\n     * console.log(`Is file: ${stats.isFile}`);\n     * console.log(`Modified: ${stats.mtime}`);\n     * \n     * // Stats with hash (SHA-1 is fastest)\n     * const statsWithHash = await fs.stat('/config/settings.json', { \n     *   includeHash: true,\n     *   hashAlgorithm: 'SHA-1'\n     * });\n     * console.log(`Hash: ${statsWithHash.hash}`);\n     * ```\n     */\n    async stat(path: string, options?: { includeHash?: boolean; hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' }): Promise<FileStat> {\n        await this.ensureMounted();\n        \n        // Special handling for root directory\n        if (path === '/') {\n            return {\n                kind: 'directory',\n                size: 0,\n                mtime: new Date(0).toISOString(),\n                ctime: new Date(0).toISOString(),\n                isFile: false,\n                isDirectory: true,\n            };\n        }\n        \n        const name = basename(path);\n        const parentDir = await this.getDirectoryHandle(dirname(path), false);\n        const includeHash = options?.includeHash ?? false;\n        const hashAlgorithm = options?.hashAlgorithm ?? 'SHA-1';\n\n        try {\n            const fileHandle = await parentDir.getFileHandle(name!, { create: false });\n            const file = await fileHandle.getFile();\n\n            const baseStat: FileStat = {\n                kind: 'file',\n                size: file.size,\n                mtime: new Date(file.lastModified).toISOString(),\n                ctime: new Date(file.lastModified).toISOString(),\n                isFile: true,\n                isDirectory: false,\n            };\n\n            if (includeHash) {\n                try {\n                    const buffer = new Uint8Array(await file.arrayBuffer());\n                    const hash = await calculateFileHash(buffer, hashAlgorithm);\n\n                    baseStat.hash = hash;\n                }\n                catch (error) {\n                    console.warn(`Failed to calculate hash for ${ path }:`, error);\n                }\n            }\n\n            return baseStat;\n        }\n        catch (e: any) {\n            if (e.name !== 'TypeMismatchError' && e.name !== 'NotFoundError') {\n                throw new OPFSError('Failed to stat (file)', 'STAT_FAILED');\n            }\n        }\n\n        try {\n            await parentDir.getDirectoryHandle(name!, { create: false });\n\n            return {\n                kind: 'directory',\n                size: 0,\n                mtime: new Date(0).toISOString(),\n                ctime: new Date(0).toISOString(),\n                isFile: false,\n                isDirectory: true,\n            };\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError') {\n                throw new OPFSError(`No such file or directory: ${ path }`, 'ENOENT');\n            }\n\n            throw new OPFSError('Failed to stat (directory)', 'STAT_FAILED');\n        }\n    }\n\n    /**\n     * Read a directory's contents\n     * \n     * Lists all files and subdirectories within the specified directory.\n     * \n     * @param path - The path to the directory to read\n     * @param options - Options for the readdir operation\n     * @param options.withFileTypes - Whether to return detailed file information (default: false)\n     * @returns Promise that resolves to an array of file/directory names or detailed information\n     * @throws {OPFSError} If the directory does not exist or cannot be accessed\n     * \n     * @example\n     * ```typescript\n     * // Get simple list of names\n     * const files = await fs.readdir('/users/john/documents');\n     * console.log('Files:', files); // ['readme.txt', 'config.json', 'images']\n     * \n     * // Get detailed information\n     * const detailed = await fs.readdir('/users/john/documents', { withFileTypes: true });\n     * detailed.forEach(item => {\n     *   console.log(`${item.name} - ${item.isFile ? 'file' : 'directory'}`);\n     * });\n     * ```\n     */\n    async readdir(path: string): Promise<string[]>;\n    async readdir(path: string, options: { withFileTypes: true }): Promise<DirentData[]>;\n    async readdir(path: string, options: { withFileTypes: false }): Promise<string[]>;\n    async readdir(path: string, options?: { withFileTypes?: boolean }): Promise<string[] | DirentData[]> {\n        await this.ensureMounted();\n        \n        const withTypes = options?.withFileTypes ?? false;\n        const dir = await this.getDirectoryHandle(path, false);\n\n        if (withTypes) {\n            const results: DirentData[] = [];\n\n            for await (const [name, handle] of (dir as any).entries()) {\n                const isFile = handle.kind === 'file';\n\n                results.push({\n                    name,\n                    kind: handle.kind,\n                    isFile,\n                    isDirectory: !isFile,\n                });\n            }\n\n            return results;\n        }\n        else {\n            const results: string[] = [];\n\n            for await (const [name] of (dir as any).entries()) {\n                results.push(name);\n            }\n\n            return results;\n        }\n    }\n\n    /**\n     * Check if a file or directory exists\n     * \n     * Verifies if a file or directory exists at the specified path.\n     * \n     * @param path - The path to check\n     * @returns Promise that resolves to true if the file or directory exists, false otherwise  \n     * \n     * @example\n     * ```typescript\n     * const exists = await fs.exists('/config/settings.json');\n     * console.log(`File exists: ${exists}`);\n     * ```\n     */\n    async exists(path: string): Promise<boolean> {\n        await this.ensureMounted();\n        \n        if (path === '/') {\n            return true;\n        }\n        \n        const name = basename(path);\n        let dir: FileSystemDirectoryHandle | null = null;\n\n        try {\n            dir = await this.getDirectoryHandle(dirname(path), false);\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError' || e.name === 'TypeMismatchError') {\n                dir = null;\n            }\n\n            throw e;\n        }\n\n        if (!dir || !name) {\n            return false;\n        }\n\n        try {\n            await dir.getFileHandle(name, { create: false });\n\n            return true;\n        }\n        catch (e: any) {\n            if (e.name !== 'NotFoundError' && e.name !== 'TypeMismatchError') {\n                throw e;\n            }\n        }\n\n        try {\n            await dir.getDirectoryHandle(name, { create: false });\n\n            return true;\n        }\n        catch (e: any) {\n            if (e.name !== 'NotFoundError' && e.name !== 'TypeMismatchError') {\n                throw e;\n            }\n        }\n\n        return false;\n    }\n\n    /**\n     * Clear all contents of a directory without removing the directory itself\n     * \n     * Removes all files and subdirectories within the specified directory,\n     * but keeps the directory itself.\n     * \n     * @param path - The path to the directory to clear (default: '/')\n     * @returns Promise that resolves when all contents are removed\n     * @throws {OPFSError} If the operation fails\n     * \n     * @example\n     * ```typescript\n     * // Clear root directory contents\n     * await fs.clear('/');\n     * \n     * // Clear specific directory contents\n     * await fs.clear('/data');\n     * ```\n     */\n    async clear(path: string = '/'): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const items = await this.readdir(path, { withFileTypes: true });\n\n            for (const item of items) {\n                const itemPath = `${ path === '/' ? '' : path }/${ item.name }`;\n\n                await this.remove(itemPath, { recursive: true });\n            }\n        }\n        catch (error: any) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to clear directory: ${ path }`, 'CLEAR_FAILED');\n        }\n    }\n\n    /**\n     * Remove files and directories\n     * \n     * Removes files and directories. Similar to Node.js fs.rm().\n     * \n     * @param path - The path to remove\n     * @param options - Options for removal\n     * @param options.recursive - Whether to remove directories and their contents recursively (default: false)\n     * @param options.force - Whether to ignore errors if the path doesn't exist (default: false)\n     * @returns Promise that resolves when the removal is complete\n     * @throws {OPFSError} If the removal fails\n     * \n     * @example\n     * ```typescript\n     * // Remove a file\n     * await fs.rm('/path/to/file.txt');\n     * \n     * // Remove a directory and all its contents\n     * await fs.rm('/path/to/directory', { recursive: true });\n     * \n     * // Remove with force (ignore if doesn't exist)\n     * await fs.rm('/maybe/exists', { force: true });\n     * ```\n     */\n    async remove(path: string, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        const recursive = options?.recursive ?? false;\n        const force = options?.force ?? false;\n\n        // Special handling for root directory\n        if (path === '/') {\n            throw new OPFSError('Cannot remove root directory', 'EROOT');\n        }\n\n        const name = basename(path);\n\n        if (!name) {\n            throw new PathError('Invalid path', path);\n        }\n\n        const parent = await this.getDirectoryHandle(dirname(path), false);\n\n        try {\n            await parent.removeEntry(name, { recursive });\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError') {\n                if (!force) {\n                    throw new OPFSError(`No such file or directory: ${ path }`, 'ENOENT');\n                }\n            }\n            else if (e.name === 'InvalidModificationError') {\n                throw new OPFSError(`Directory not empty: ${ path }. Use recursive option to force removal.`, 'ENOTEMPTY');\n            }\n            else if (e.name === 'TypeMismatchError' && !recursive) {\n                throw new OPFSError(`Cannot remove directory without recursive option: ${ path }`, 'EISDIR');\n            }\n            else {\n                throw new OPFSError(`Failed to remove path: ${ path }`, 'RM_FAILED');\n            }\n        }\n    }\n\n    /**\n     * Resolve a path to an absolute path\n     * \n     * Resolves relative paths and normalizes path segments (like '..' and '.').\n     * Similar to Node.js fs.realpath() but without symlink resolution since OPFS doesn't support symlinks.\n     * \n     * @param path - The path to resolve\n     * @returns Promise that resolves to the absolute normalized path\n     * @throws {FileNotFoundError} If the path does not exist\n     * @throws {OPFSError} If path resolution fails\n     * \n     * @example\n     * ```typescript\n     * // Resolve relative path\n     * const absolute = await fs.realpath('./config/../data/file.txt');\n     * console.log(absolute); // '/data/file.txt'\n     * ```\n     */\n    async realpath(path: string): Promise<string> {\n        await this.ensureMounted();\n        \n        try {\n            const normalizedPath = resolvePath(path);\n            const exists = await this.exists(normalizedPath);\n\n            if (!exists) {\n                throw new FileNotFoundError(normalizedPath);\n            }\n\n            return normalizedPath;\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to resolve path: ${ path }`, 'REALPATH_FAILED');\n        }\n    }\n\n    /**\n     * Rename a file or directory\n     * \n     * Changes the name of a file or directory. If the target path already exists,\n     * it will be replaced.\n     * \n     * @param oldPath - The current path of the file or directory\n     * @param newPath - The new path for the file or directory\n     * @returns Promise that resolves when the rename operation is complete\n     * @throws {OPFSError} If the rename operation fails\n     * \n     * @example\n     * ```typescript\n     * await fs.rename('/old/path/file.txt', '/new/path/renamed.txt');\n     * ```\n     */\n    async rename(oldPath: string, newPath: string): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const sourceExists = await this.exists(oldPath);\n\n            if (!sourceExists) {\n                throw new FileNotFoundError(oldPath);\n            }\n\n            await this.copy(oldPath, newPath, { recursive: true });\n            await this.remove(oldPath, { recursive: true });\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to rename from ${ oldPath } to ${ newPath }`, 'RENAME_FAILED');\n        }\n    }\n\n    /**\n     * Copy files and directories\n     * \n     * Copies files and directories. Similar to Node.js fs.cp().\n     * \n     * @param source - The source path to copy from\n     * @param destination - The destination path to copy to\n     * @param options - Options for copying\n     * @param options.recursive - Whether to copy directories recursively (default: false)\n     * @param options.force - Whether to overwrite existing files (default: true)\n     * @returns Promise that resolves when the copy operation is complete\n     * @throws {OPFSError} If the copy operation fails\n     * \n     * @example\n     * ```typescript\n     * // Copy a file\n     * await fs.copy('/source/file.txt', '/dest/file.txt');\n     * \n     * // Copy a directory and all its contents\n     * await fs.copy('/source/dir', '/dest/dir', { recursive: true });\n     * \n     * // Copy without overwriting existing files\n     * await fs.copy('/source', '/dest', { recursive: true, force: false });\n     * ```\n     */\n    async copy(source: string, destination: string, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const recursive = options?.recursive ?? false;\n            const force = options?.force ?? true;\n\n            const sourceExists = await this.exists(source);\n\n            if (!sourceExists) {\n                throw new OPFSError(`Source does not exist: ${ source }`, 'ENOENT');\n            }\n\n            const destExists = await this.exists(destination);\n\n            if (destExists && !force) {\n                throw new OPFSError(`Destination already exists: ${ destination }`, 'EEXIST');\n            }\n\n            const sourceStats = await this.stat(source);\n\n            if (sourceStats.isFile) {\n                const content = await this.readFile(source, 'binary');\n                \n                await this.writeFile(destination, content);\n            }\n            else {\n                if (!recursive) {\n                    throw new OPFSError(`Cannot copy directory without recursive option: ${ source }`, 'EISDIR');\n                }\n\n                await this.mkdir(destination, { recursive: true });\n\n                const items = await this.readdir(source, { withFileTypes: true });\n\n                for (const item of items) {\n                    const sourceItemPath = `${ source }/${ item.name }`;\n                    const destItemPath = `${ destination }/${ item.name }`;\n\n                    await this.copy(sourceItemPath, destItemPath, { recursive: true, force });\n                }\n            }\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to copy from ${ source } to ${ destination }`, 'CP_FAILED');\n        }\n    }\n\n    /**\n     * Start watching a file or directory for changes\n     */\n    async watch(path: string): Promise<void> {\n        await this.ensureMounted();\n        \n        const normalizedPath = normalizePath(path);\n        const snapshot = await this.buildSnapshot(normalizedPath);\n        this.watchers.set(normalizedPath, snapshot);\n\n        if (!this.watchTimer) {\n            this.watchTimer = setInterval(() => {\n                void this.scanWatches();\n            }, this.watchInterval);\n        }\n    }\n\n    /**\n     * Stop watching a previously watched path\n     */\n    unwatch(path: string): void {\n        const normalizedPath = normalizePath(path);\n        this.watchers.delete(normalizedPath);\n\n        if (this.watchers.size === 0 && this.watchTimer) {\n            clearInterval(this.watchTimer);\n            this.watchTimer = null;\n        }\n    }\n\n    private async buildSnapshot(rootPath: string): Promise<Map<string, FileStat>> {\n        const result = new Map<string, FileStat>();\n\n        const walk = async (current: string) => {\n            const stat = await this.stat(current);\n            result.set(current, stat);\n\n            if (stat.isDirectory) {\n                const entries = await this.readdir(current, { withFileTypes: true });\n                for (const entry of entries) {\n                    const child = `${ current === '/' ? '' : current }/${ entry.name }`;\n                    await walk(child);\n                }\n            }\n        };\n\n        await walk(rootPath);\n        return result;\n    }\n\n    private async scanWatches(): Promise<void> {\n        if (this.scanning) {\n            return;\n        }\n\n        this.scanning = true;\n\n        try {\n            await Promise.all(\n                [...this.watchers.entries()].map(async ([rootPath, prev]) => {\n                    let next: Map<string, FileStat>;\n\n                    try {\n                        next = await this.buildSnapshot(rootPath);\n                    }\n                    catch {\n                        next = new Map();\n                    }\n\n                    const events: WatchEvent[] = [];\n\n                    for (const [p, stat] of next) {\n                        const old = prev.get(p);\n                        if (!old) {\n                            events.push({ path: p, type: 'create' });\n                        }\n                        else if (old.mtime !== stat.mtime || old.size !== stat.size) {\n                            events.push({ path: p, type: 'change' });\n                        }\n                    }\n\n                    for (const p of prev.keys()) {\n                        if (!next.has(p)) {\n                            events.push({ path: p, type: 'delete' });\n                        }\n                    }\n\n                    if (events.length && this.watchCallback) {\n                        for (const event of events) {\n                            this.watchCallback(event);\n                        }\n                    }\n\n                    this.watchers.set(rootPath, next);\n                })\n            );\n        }\n        finally {\n            this.scanning = false;\n        }\n    }\n\n    /**\n     * Synchronize the file system with external data\n     * \n     * Syncs the file system with an array of entries containing paths and data.\n     * This is useful for importing data from external sources or syncing with remote data.\n     * \n     * @param entries - Array of [path, data] tuples to sync\n     * @param options - Options for synchronization\n     * @param options.cleanBefore - Whether to clear the file system before syncing (default: false)\n     * @returns Promise that resolves when synchronization is complete\n     * @throws {OPFSError} If the synchronization fails\n     * \n     * @example\n     * ```typescript\n     * // Sync with external data\n     * const entries: [string, string | Uint8Array | Blob][] = [\n     *   ['/config.json', JSON.stringify({ theme: 'dark' })],\n     *   ['/data/binary.dat', new Uint8Array([1, 2, 3, 4])],\n     *   ['/upload.txt', new Blob(['file content'], { type: 'text/plain' })]\n     * ];\n     * \n     * // Sync without clearing existing files\n     * await fs.sync(entries);\n     * \n     * // Clean file system and then sync\n     * await fs.sync(entries, { cleanBefore: true });\n     * ```\n     */\n    async sync(entries: [string, string | Uint8Array | Blob][], options?: { cleanBefore?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const cleanBefore = options?.cleanBefore ?? false;\n\n            if (cleanBefore) {\n                await this.clear('/');\n            }\n\n            for (const [path, data] of entries) {\n                const normalizedPath = normalizePath(path);\n\n                let fileData: string | Uint8Array;\n\n                if (data instanceof Blob) {\n                    fileData = await convertBlobToUint8Array(data);\n                }\n                else {\n                    fileData = data;\n                }\n\n                await this.writeFile(normalizedPath, fileData);\n            }\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError('Failed to sync file system', 'SYNC_FAILED');\n        }\n    }\n}\n\n// Only expose the worker when running in a Web Worker environment\nif (typeof self !== 'undefined' && self.constructor.name === 'DedicatedWorkerGlobalScope') {\n  expose(new OPFSWorker());\n}\n"],"names":["OPFSWorker","watchCallback","watchOptions","checkOPFSSupport","root","resolve","reject","rootDir","error","OPFSError","callback","options","path","create","from","OPFSNotMountedError","segments","splitPath","current","segment","PathError","fileName","result","walk","dirPath","items","item","fullPath","stat","err","encoding","fileHandle","buffer","readFileData","decodeBuffer","FileNotFoundError","data","writeFileData","recursive","i","e","joinPath","name","basename","parentDir","dirname","includeHash","hashAlgorithm","file","baseStat","hash","calculateFileHash","withTypes","dir","results","handle","isFile","itemPath","force","parent","normalizedPath","resolvePath","oldPath","newPath","source","destination","content","sourceItemPath","destItemPath","normalizePath","snapshot","rootPath","entries","entry","child","prev","next","events","p","old","event","fileData","convertBlobToUint8Array","expose"],"mappings":"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"}
+{"version":3,"file":"raw.js","sources":["../src/worker.ts"],"sourcesContent":["import { expose } from 'comlink';\n\nimport { decodeBuffer } from './utils/encoder';\nimport {\n    FileNotFoundError,\n    OPFSError,\n    OPFSNotMountedError,\n    PathError\n} from './utils/errors';\n\nimport { \n    calculateFileHash, \n    checkOPFSSupport, \n    joinPath, \n    readFileData, \n    splitPath, \n    writeFileData,\n    basename,\n    dirname,\n    normalizePath,\n    resolvePath,\n    convertBlobToUint8Array\n} from './utils/helpers';\n\nimport type { DirentData, FileStat, WatchEvent } from './types';\nimport type { BufferEncoding } from 'typescript';\n\n/**\n * OPFS (Origin Private File System) File System implementation\n * \n * This class provides a high-level interface for working with the browser's\n * Origin Private File System API, offering file and directory operations\n * similar to Node.js fs module.\n * \n * @example\n * ```typescript\n * const fs = new OPFSFileSystem();\n * await fs.init('/my-app');\n * await fs.writeFile('/data/config.json', JSON.stringify({ theme: 'dark' }));\n * const config = await fs.readFile('/data/config.json');\n * ```\n */\nexport class OPFSWorker {\n    /** Root directory handle for the file system */\n    private root: FileSystemDirectoryHandle | null = null;\n\n    /** Watch event callback */\n    private watchCallback: ((event: WatchEvent) => void) | null = null;\n\n    /** Map of watched paths to their last known state */\n    private watchers = new Map<string, Map<string, FileStat>>();\n\n    /** Interval handle for polling watched paths */\n    private watchTimer: ReturnType<typeof setInterval> | null = null;\n\n    /** Polling interval in milliseconds */\n    private watchInterval = 1000;\n\n    /** Flag to avoid concurrent scans */\n    private scanning = false;\n\n    /** Promise to prevent concurrent mount operations */\n    private mountingPromise: Promise<boolean> | null = null;\n\n    /** Hash algorithm for file hashing (null means no hashing) */\n    private hashAlgorithm: null | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' = null;\n\n    /**\n     * Notify about internal changes to the file system\n     * \n     * This method is called by internal operations to notify clients about\n     * changes, even when no specific paths are being watched.\n     * \n     * @param path - The path that was changed\n     * @param type - The type of change (create, change, delete)\n     */\n    private async notifyChange(event: Omit<WatchEvent, 'timestamp' | 'hash'>): Promise<void> {\n        if (!this.watchCallback) {\n            return;\n        }\n\n        // Calculate hash if hashing is enabled and this is a file operation\n        let hash: string | undefined;\n        if (this.hashAlgorithm && !event.isDirectory && event.type !== 'removed') {\n            try {\n                const stats = await this.stat(event.path);\n\n                if (stats.isFile && stats.hash) {\n                    hash = stats.hash;\n                }\n            } \n            catch (error) {\n                console.warn(`Failed to calculate hash for ${event.path}:`, error);\n            }\n        }\n\n        // Notify about the change immediately\n        this.watchCallback({\n            timestamp: new Date().toISOString(),\n            ...event,\n            ...(hash && { hash })\n        });\n    }\n\n    /**\n     * Creates a new OPFSFileSystem instance\n     * \n     * @param watchCallback - Optional callback for file change events\n     * @param options - Optional configuration options\n     * @param options.watchInterval - Polling interval in milliseconds for file watching\n     * @param options.hashAlgorithm - Hash algorithm for file hashing\n     * @throws {OPFSError} If OPFS is not supported in the current browser\n     */\n    constructor(\n        watchCallback?: (event: WatchEvent) => void,\n        options?: { \n            watchInterval?: number;\n            hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';\n        }\n    ) {\n        checkOPFSSupport();\n        \n        if (watchCallback) {\n            this.watchCallback = watchCallback;\n        }\n        \n        if (options) {\n            this.setOptions(options);\n        }\n        \n        void this.mount('/');\n    }\n\n    /**\n     * Initialize the file system within a given directory\n     * \n     * This method sets up the root directory for all subsequent operations.\n     * If no root is specified, it will use the OPFS root directory.\n     * \n     * @param root - The root path for the file system (default: '/')\n     * @returns Promise that resolves to true if initialization was successful\n     * @throws {OPFSError} If initialization fails\n     * \n     * @example\n     * ```typescript\n     * const fs = new OPFSFileSystem();\n     * \n     * // Use OPFS root (default)\n     * await fs.mount();\n     * \n     * // Use custom directory\n     * await fs.mount('/my-app');\n     * ```\n     */\n    async mount(root: string = '/'): Promise<boolean> {\n        // If already mounting, wait for previous operation to complete first\n        if (this.mountingPromise) {\n            await this.mountingPromise;\n        }\n\n        this.mountingPromise = new Promise<boolean>(async(resolve, reject) => {\n            this.root = null;\n    \n            try {\n                const rootDir = await navigator.storage.getDirectory();\n    \n                if (root === '/') {\n                    this.root = rootDir;\n                } \n                else {\n                    this.root = await this.getDirectoryHandle(root, true, rootDir);\n                }\n                resolve(true);\n            }\n            catch (error) {\n                console.error(error);\n                reject(new OPFSError('Failed to initialize OPFS', 'INIT_FAILED'));\n            }\n            finally {\n                this.mountingPromise = null;\n            }\n        });\n\n        return this.mountingPromise;\n    }\n\n    /**\n     * Set the watch callback for file change events\n     * \n     * @param callback - The callback function to invoke when files change\n     */\n    setWatchCallback(\n        callback: (event: WatchEvent) => void, \n    ) {\n        this.watchCallback = callback;\n    }\n\n    /**\n     * Set configuration options for the file system\n     * \n     * @param options - Configuration options to update\n     * @param options.watchInterval - Polling interval in milliseconds for file watching\n     * @param options.hashAlgorithm - Hash algorithm for file hashing\n     */\n    setOptions(options: { \n        watchInterval?: number;\n        hashAlgorithm?: null | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';\n    }): void {\n        if (options.watchInterval !== undefined) {\n            this.watchInterval = options.watchInterval;\n        }\n\n        if (options.hashAlgorithm !== undefined) {\n            this.hashAlgorithm = options.hashAlgorithm;\n        }\n    }\n\n    /**\n     * Automatically mount the OPFS root if not already mounted\n     * \n     * This method is called internally when file operations are performed\n     * without explicitly mounting first.\n     * \n     * @returns Promise that resolves when auto-mount is complete\n     * @throws {OPFSError} If auto-mount fails\n     */\n    private async ensureMounted(): Promise<void> {\n        // If already mounted, return immediately\n        if (this.root) {\n            return;\n        }\n\n        // If already mounting, wait for that operation to complete\n        if (this.mountingPromise) {\n            await this.mountingPromise;\n            return;\n        }\n\n        throw new OPFSError('OPFS not mounted', 'NOT_MOUNTED');\n    }\n\n    /**\n     * Get a directory handle from a path\n     * \n     * Navigates through the directory structure to find or create a directory\n     * at the specified path.\n     * \n     * @param path - The path to the directory (string or array of segments)\n     * @param create - Whether to create the directory if it doesn't exist (default: false)\n     * @param from - The directory to start from (default: root directory)\n     * @returns Promise that resolves to the directory handle\n     * @throws {OPFSError} If the directory cannot be accessed or created\n     * \n     * @example\n     * ```typescript\n     * const docsDir = await fs.getDirectoryHandle('/users/john/documents', true);\n     * const docsDir2 = await fs.getDirectoryHandle(['users', 'john', 'documents'], true);\n     * ```\n     */\n    private async getDirectoryHandle(path: string | string[], create: boolean = false, from: FileSystemDirectoryHandle | null = this.root): Promise<FileSystemDirectoryHandle> {\n        if (!from) {\n            throw new OPFSNotMountedError();\n        }\n\n        const segments = Array.isArray(path) ? path : splitPath(path);\n        let current = from;\n\n        for (const segment of segments) {\n            current = await current.getDirectoryHandle(segment, { create });\n        }\n\n        return current;\n    }\n\n    /**\n     * Get a file handle from a path\n     * \n     * Navigates to the parent directory and retrieves or creates a file handle\n     * for the specified file path.\n     * \n     * @param path - The path to the file (string or array of segments)\n     * @param create - Whether to create the file if it doesn't exist (default: false)\n     * @param from - The directory to start from (default: root directory)\n     * @returns Promise that resolves to the file handle\n     * @throws {PathError} If the path is empty\n     * @throws {OPFSError} If the file cannot be accessed or created\n     * \n     * @example\n     * ```typescript\n     * const fileHandle = await fs.getFileHandle('/config/settings.json', true);\n     * const fileHandle2 = await fs.getFileHandle(['config', 'settings.json'], true);\n     * ```\n     */\n    private async getFileHandle(path: string | string[], create = false, from: FileSystemDirectoryHandle | null = this.root): Promise<FileSystemFileHandle> {\n        if (!from) {\n            throw new OPFSNotMountedError();\n        }\n\n        const segments = splitPath(path);\n\n        if (segments.length === 0) {\n            throw new PathError('Path must not be empty', Array.isArray(path) ? path.join('/') : path);\n        }\n\n        const fileName = segments.pop()!;\n        const dir = await this.getDirectoryHandle(segments, create, from);\n\n        return dir.getFileHandle(fileName, { create });\n    }\n\n\n    /**\n     * Get a complete index of all files and directories in the file system\n     * \n     * This method recursively traverses the entire file system and returns\n     * a Map containing FileStat objects for every file and directory.\n     * \n     * @returns Promise that resolves to a Map of paths to FileStat objects\n     * @throws {OPFSError} If the file system is not mounted\n     * \n     * @example\n     * ```typescript\n     * const index = await fs.index();\n     * const fileStats = index.get('/data/config.json');\n     * if (fileStats) {\n     *   console.log(`File size: ${fileStats.size} bytes`);\n     *   if (fileStats.hash) console.log(`Hash: ${fileStats.hash}`);\n     * }\n     * ```\n     */\n    async index(): Promise<Map<string, FileStat>> {\n        const result = new Map<string, FileStat>();\n\n        const walk = async(dirPath: string) => {\n            const items = await this.readdir(dirPath, { withFileTypes: true });\n\n            for (const item of items) {\n                const fullPath = `${ dirPath === '/' ? '' : dirPath }/${ item.name }`;\n\n                try {\n                    const stat = await this.stat(fullPath);\n\n                    result.set(fullPath, stat);\n\n                    if (stat.isDirectory) {\n                        await walk(fullPath);\n                    }\n                }\n                catch (err) {\n                    console.warn(`Skipping broken entry: ${ fullPath }`, err);\n                }\n            }\n        };\n\n        result.set('/', {\n            kind: 'directory',\n            size: 0,\n            mtime: new Date(0).toISOString(),\n            ctime: new Date(0).toISOString(),\n            isFile: false,\n            isDirectory: true,\n        });\n\n        await walk('/');\n\n        return result;\n    }\n\n    /**\n     * Read a file from the file system\n     * \n     * Reads the contents of a file and returns it as a string or binary data\n     * depending on the specified encoding.\n     * \n     * @param path - The path to the file to read\n     * @param encoding - The encoding to use for reading the file\n     * @returns Promise that resolves to the file contents\n     * @throws {FileNotFoundError} If the file does not exist\n     * @throws {OPFSError} If reading the file fails\n     * \n     * @example\n     * ```typescript\n     * // Read as text\n     * const content = await fs.readFile('/config/settings.json');\n     * \n     * // Read as binary\n     * const binaryData = await fs.readFile('/images/logo.png', 'binary');\n     * \n     * // Read with specific encoding\n     * const utf8Content = await fs.readFile('/data/utf8.txt', 'utf-8');\n     * ```\n     */\n    async readFile(path: string, encoding: 'binary'): Promise<Uint8Array>;\n    async readFile(path: string, encoding?: BufferEncoding): Promise<string>;\n    async readFile(\n        path: string,\n        encoding: BufferEncoding | 'binary' = 'utf-8'\n    ): Promise<string | Uint8Array> {\n        await this.ensureMounted();\n        \n        try {\n            const fileHandle = await this.getFileHandle(path, false);\n            const buffer = await readFileData(fileHandle);\n\n            if (encoding === 'binary') {\n                return buffer;\n            }\n\n            return decodeBuffer(buffer, encoding);\n        }\n        catch (err) {\n            console.error(err);\n\n            throw new FileNotFoundError(path);\n        }\n    }\n\n    /**\n     * Write data to a file\n     * \n     * Creates or overwrites a file with the specified data. If the file already\n     * exists, it will be truncated before writing.\n     * \n     * @param path - The path to the file to write\n     * @param data - The data to write to the file (string, Uint8Array, or ArrayBuffer)\n     * @param encoding - The encoding to use when writing string data (default: 'utf-8')\n     * @returns Promise that resolves when the write operation is complete\n     * @throws {OPFSError} If writing the file fails\n     * \n     * @example\n     * ```typescript\n     * // Write text data\n     * await fs.writeFile('/config/settings.json', JSON.stringify({ theme: 'dark' }));\n     * \n     * // Write binary data\n     * const binaryData = new Uint8Array([1, 2, 3, 4, 5]);\n     * await fs.writeFile('/data/binary.dat', binaryData);\n     * \n     * // Write with specific encoding\n     * await fs.writeFile('/data/utf16.txt', 'Hello World', 'utf-16le');\n     * ```\n     */\n    async writeFile(\n        path: string,\n        data: string | Uint8Array | ArrayBuffer,\n        encoding?: BufferEncoding\n    ): Promise<void> {\n        await this.ensureMounted();\n        \n        const fileHandle = await this.getFileHandle(path, true);\n\n        await writeFileData(fileHandle, data, encoding, { truncate: true });\n        await this.notifyChange({ path, type: 'changed', isDirectory: false });\n    }\n\n    /**\n     * Append data to a file\n     * \n     * Adds data to the end of an existing file. If the file doesn't exist,\n     * it will be created.\n     * \n     * @param path - The path to the file to append to\n     * @param data - The data to append to the file (string, Uint8Array, or ArrayBuffer)\n     * @param encoding - The encoding to use when appending string data (default: 'utf-8')\n     * @returns Promise that resolves when the append operation is complete\n     * @throws {OPFSError} If appending to the file fails\n     * \n     * @example\n     * ```typescript\n     * // Append text to a log file\n     * await fs.appendFile('/logs/app.log', `[${new Date().toISOString()}] User logged in\\n`);\n     * \n     * // Append binary data\n     * const additionalData = new Uint8Array([6, 7, 8]);\n     * await fs.appendFile('/data/binary.dat', additionalData);\n     * ```\n     */\n    async appendFile(\n        path: string,\n        data: string | Uint8Array | ArrayBuffer,\n        encoding?: BufferEncoding\n    ): Promise<void> {\n        await this.ensureMounted();\n        \n        const fileHandle = await this.getFileHandle(path, true);\n\n        await writeFileData(fileHandle, data, encoding, { append: true });\n        await this.notifyChange({ path, type: 'changed', isDirectory: false });\n    }\n\n    /**\n     * Create a directory\n     * \n     * Creates a new directory at the specified path. If the recursive option\n     * is enabled, parent directories will be created as needed.\n     * \n     * @param path - The path where the directory should be created\n     * @param options - Options for directory creation\n     * @param options.recursive - Whether to create parent directories if they don't exist (default: false)\n     * @returns Promise that resolves when the directory is created\n     * @throws {OPFSError} If the directory cannot be created\n     * \n     * @example\n     * ```typescript\n     * // Create a single directory\n     * await fs.mkdir('/users/john');\n     * \n     * // Create nested directories\n     * await fs.mkdir('/users/john/documents/projects', { recursive: true });\n     * ```\n     */\n    async mkdir(path: string, options?: { recursive?: boolean }): Promise<void> {\n        await this.ensureMounted();\n\n        if (!this.root) {\n            throw new OPFSNotMountedError();\n        }\n\n        const recursive = options?.recursive ?? false;\n        const segments = splitPath(path);\n\n        let current = this.root;\n\n        for (let i = 0; i < segments.length; i++) {\n            const segment = segments[i];\n\n            try {\n                current = await current.getDirectoryHandle(segment!, { create: recursive || i === segments.length - 1 });\n            }\n            catch (e: any) {\n                if (e.name === 'NotFoundError') {\n                    throw new OPFSError(\n                        `Parent directory does not exist: ${ joinPath(segments.slice(0, i + 1)) }`,\n                        'ENOENT'\n                    );\n                }\n\n                if (e.name === 'TypeMismatchError') {\n                    throw new OPFSError(`Path segment is not a directory: ${ segment }`, 'ENOTDIR');\n                }\n\n                throw new OPFSError('Failed to create directory', 'MKDIR_FAILED');\n            }\n        }\n        await this.notifyChange({ path, type: 'added', isDirectory: true });\n    }\n\n    /**\n     * Get file or directory statistics\n     * \n     * Returns detailed information about a file or directory, including\n     * size, modification time, and optionally a hash of the file content.\n     * \n     * @param path - The path to the file or directory\n     * @returns Promise that resolves to FileStat object\n     * @throws {OPFSError} If the path does not exist or cannot be accessed\n     * \n     * @example\n     * ```typescript\n     * const stats = await fs.stat('/data/config.json');\n     * console.log(`File size: ${stats.size} bytes`);\n     * console.log(`Last modified: ${stats.mtime}`);\n     * \n     * // If hashing is enabled, hash will be included\n     * if (stats.hash) {\n     *   console.log(`Hash: ${stats.hash}`);\n     * }\n     * ```\n     */\n    async stat(path: string): Promise<FileStat> {\n        await this.ensureMounted();\n        \n        // Special handling for root directory\n        if (path === '/') {\n            return {\n                kind: 'directory',\n                size: 0,\n                mtime: new Date(0).toISOString(),\n                ctime: new Date(0).toISOString(),\n                isFile: false,\n                isDirectory: true,\n            };\n        }\n        \n        const name = basename(path);\n        const parentDir = await this.getDirectoryHandle(dirname(path), false);\n        const includeHash = this.hashAlgorithm !== null;\n\n        try {\n            const fileHandle = await parentDir.getFileHandle(name!, { create: false });\n            const file = await fileHandle.getFile();\n\n            const baseStat: FileStat = {\n                kind: 'file',\n                size: file.size,\n                mtime: new Date(file.lastModified).toISOString(),\n                ctime: new Date(file.lastModified).toISOString(),\n                isFile: true,\n                isDirectory: false,\n            };\n\n            if (includeHash && this.hashAlgorithm) {\n                try {\n                    const hash = await calculateFileHash(file, this.hashAlgorithm);\n\n                    baseStat.hash = hash;\n                }\n                catch (error) {\n                    console.warn(`Failed to calculate hash for ${ path }:`, error);\n                }\n            }\n\n            return baseStat;\n        }\n        catch (e: any) {\n            if (e.name !== 'TypeMismatchError' && e.name !== 'NotFoundError') {\n                throw new OPFSError('Failed to stat (file)', 'STAT_FAILED');\n            }\n        }\n\n        try {\n            await parentDir.getDirectoryHandle(name!, { create: false });\n\n            return {\n                kind: 'directory',\n                size: 0,\n                mtime: new Date(0).toISOString(),\n                ctime: new Date(0).toISOString(),\n                isFile: false,\n                isDirectory: true,\n            };\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError') {\n                throw new OPFSError(`No such file or directory: ${ path }`, 'ENOENT');\n            }\n\n            throw new OPFSError('Failed to stat (directory)', 'STAT_FAILED');\n        }\n    }\n\n    /**\n     * Read a directory's contents\n     * \n     * Lists all files and subdirectories within the specified directory.\n     * \n     * @param path - The path to the directory to read\n     * @param options - Options for the readdir operation\n     * @param options.withFileTypes - Whether to return detailed file information (default: false)\n     * @returns Promise that resolves to an array of file/directory names or detailed information\n     * @throws {OPFSError} If the directory does not exist or cannot be accessed\n     * \n     * @example\n     * ```typescript\n     * // Get simple list of names\n     * const files = await fs.readdir('/users/john/documents');\n     * console.log('Files:', files); // ['readme.txt', 'config.json', 'images']\n     * \n     * // Get detailed information\n     * const detailed = await fs.readdir('/users/john/documents', { withFileTypes: true });\n     * detailed.forEach(item => {\n     *   console.log(`${item.name} - ${item.isFile ? 'file' : 'directory'}`);\n     * });\n     * ```\n     */\n    async readdir(path: string): Promise<string[]>;\n    async readdir(path: string, options: { withFileTypes: true }): Promise<DirentData[]>;\n    async readdir(path: string, options: { withFileTypes: false }): Promise<string[]>;\n    async readdir(path: string, options?: { withFileTypes?: boolean }): Promise<string[] | DirentData[]> {\n        await this.ensureMounted();\n        \n        const withTypes = options?.withFileTypes ?? false;\n        const dir = await this.getDirectoryHandle(path, false);\n\n        if (withTypes) {\n            const results: DirentData[] = [];\n\n            for await (const [name, handle] of (dir as any).entries()) {\n                const isFile = handle.kind === 'file';\n\n                results.push({\n                    name,\n                    kind: handle.kind,\n                    isFile,\n                    isDirectory: !isFile,\n                });\n            }\n\n            return results;\n        }\n        else {\n            const results: string[] = [];\n\n            for await (const [name] of (dir as any).entries()) {\n                results.push(name);\n            }\n\n            return results;\n        }\n    }\n\n    /**\n     * Check if a file or directory exists\n     * \n     * Verifies if a file or directory exists at the specified path.\n     * \n     * @param path - The path to check\n     * @returns Promise that resolves to true if the file or directory exists, false otherwise  \n     * \n     * @example\n     * ```typescript\n     * const exists = await fs.exists('/config/settings.json');\n     * console.log(`File exists: ${exists}`);\n     * ```\n     */\n    async exists(path: string): Promise<boolean> {\n        await this.ensureMounted();\n        \n        if (path === '/') {\n            return true;\n        }\n        \n        const name = basename(path);\n        let dir: FileSystemDirectoryHandle | null = null;\n\n        try {\n            dir = await this.getDirectoryHandle(dirname(path), false);\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError' || e.name === 'TypeMismatchError') {\n                dir = null;\n            }\n\n            throw e;\n        }\n\n        if (!dir || !name) {\n            return false;\n        }\n\n        try {\n            await dir.getFileHandle(name, { create: false });\n\n            return true;\n        }\n        catch (e: any) {\n            if (e.name !== 'NotFoundError' && e.name !== 'TypeMismatchError') {\n                throw e;\n            }\n        }\n\n        try {\n            await dir.getDirectoryHandle(name, { create: false });\n\n            return true;\n        }\n        catch (e: any) {\n            if (e.name !== 'NotFoundError' && e.name !== 'TypeMismatchError') {\n                throw e;\n            }\n        }\n\n        return false;\n    }\n\n    /**\n     * Clear all contents of a directory without removing the directory itself\n     * \n     * Removes all files and subdirectories within the specified directory,\n     * but keeps the directory itself.\n     * \n     * @param path - The path to the directory to clear (default: '/')\n     * @returns Promise that resolves when all contents are removed\n     * @throws {OPFSError} If the operation fails\n     * \n     * @example\n     * ```typescript\n     * // Clear root directory contents\n     * await fs.clear('/');\n     * \n     * // Clear specific directory contents\n     * await fs.clear('/data');\n     * ```\n     */\n    async clear(path: string = '/'): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const items = await this.readdir(path, { withFileTypes: true });\n\n            for (const item of items) {\n                const itemPath = `${ path === '/' ? '' : path }/${ item.name }`;\n\n                await this.remove(itemPath, { recursive: true });\n            }\n            \n            // Notify about the clear operation\n            await this.notifyChange({ path, type: 'changed', isDirectory: true });\n        }\n        catch (error: any) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to clear directory: ${ path }`, 'CLEAR_FAILED');\n        }\n    }\n\n    /**\n     * Remove files and directories\n     * \n     * Removes files and directories. Similar to Node.js fs.rm().\n     * \n     * @param path - The path to remove\n     * @param options - Options for removal\n     * @param options.recursive - Whether to remove directories and their contents recursively (default: false)\n     * @param options.force - Whether to ignore errors if the path doesn't exist (default: false)\n     * @returns Promise that resolves when the removal is complete\n     * @throws {OPFSError} If the removal fails\n     * \n     * @example\n     * ```typescript\n     * // Remove a file\n     * await fs.rm('/path/to/file.txt');\n     * \n     * // Remove a directory and all its contents\n     * await fs.rm('/path/to/directory', { recursive: true });\n     * \n     * // Remove with force (ignore if doesn't exist)\n     * await fs.rm('/maybe/exists', { force: true });\n     * ```\n     */\n    async remove(path: string, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        const recursive = options?.recursive ?? false;\n        const force = options?.force ?? false;\n\n        // Special handling for root directory\n        if (path === '/') {\n            throw new OPFSError('Cannot remove root directory', 'EROOT');\n        }\n\n        const name = basename(path);\n\n        if (!name) {\n            throw new PathError('Invalid path', path);\n        }\n\n        const parent = await this.getDirectoryHandle(dirname(path), false);\n\n        try {\n            await parent.removeEntry(name, { recursive });\n        }\n        catch (e: any) {\n            if (e.name === 'NotFoundError') {\n                if (!force) {\n                    throw new OPFSError(`No such file or directory: ${ path }`, 'ENOENT');\n                }\n            }\n            else if (e.name === 'InvalidModificationError') {\n                throw new OPFSError(`Directory not empty: ${ path }. Use recursive option to force removal.`, 'ENOTEMPTY');\n            }\n            else if (e.name === 'TypeMismatchError' && !recursive) {\n                throw new OPFSError(`Cannot remove directory without recursive option: ${ path }`, 'EISDIR');\n            }\n            else {\n                throw new OPFSError(`Failed to remove path: ${ path }`, 'RM_FAILED');\n            }\n        }\n        \n        await this.notifyChange({ path, type: 'removed', isDirectory: false });\n    }\n\n    /**\n     * Resolve a path to an absolute path\n     * \n     * Resolves relative paths and normalizes path segments (like '..' and '.').\n     * Similar to Node.js fs.realpath() but without symlink resolution since OPFS doesn't support symlinks.\n     * \n     * @param path - The path to resolve\n     * @returns Promise that resolves to the absolute normalized path\n     * @throws {FileNotFoundError} If the path does not exist\n     * @throws {OPFSError} If path resolution fails\n     * \n     * @example\n     * ```typescript\n     * // Resolve relative path\n     * const absolute = await fs.realpath('./config/../data/file.txt');\n     * console.log(absolute); // '/data/file.txt'\n     * ```\n     */\n    async realpath(path: string): Promise<string> {\n        await this.ensureMounted();\n        \n        try {\n            const normalizedPath = resolvePath(path);\n            const exists = await this.exists(normalizedPath);\n\n            if (!exists) {\n                throw new FileNotFoundError(normalizedPath);\n            }\n\n            return normalizedPath;\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to resolve path: ${ path }`, 'REALPATH_FAILED');\n        }\n    }\n\n    /**\n     * Rename a file or directory\n     * \n     * Changes the name of a file or directory. If the target path already exists,\n     * it will be replaced.\n     * \n     * @param oldPath - The current path of the file or directory\n     * @param newPath - The new path for the file or directory\n     * @returns Promise that resolves when the rename operation is complete\n     * @throws {OPFSError} If the rename operation fails\n     * \n     * @example\n     * ```typescript\n     * await fs.rename('/old/path/file.txt', '/new/path/renamed.txt');\n     * ```\n     */\n    async rename(oldPath: string, newPath: string): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const sourceExists = await this.exists(oldPath);\n\n            if (!sourceExists) {\n                throw new FileNotFoundError(oldPath);\n            }\n\n            await this.copy(oldPath, newPath, { recursive: true });\n            await this.remove(oldPath, { recursive: true });\n            \n            // Notify about the rename operation\n            await this.notifyChange({ path: oldPath, type: 'removed', isDirectory: false });\n            await this.notifyChange({ path: newPath, type: 'added', isDirectory: false });\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to rename from ${ oldPath } to ${ newPath }`, 'RENAME_FAILED');\n        }\n    }\n\n    /**\n     * Copy files and directories\n     * \n     * Copies files and directories. Similar to Node.js fs.cp().\n     * \n     * @param source - The source path to copy from\n     * @param destination - The destination path to copy to\n     * @param options - Options for copying\n     * @param options.recursive - Whether to copy directories recursively (default: false)\n     * @param options.force - Whether to overwrite existing files (default: true)\n     * @returns Promise that resolves when the copy operation is complete\n     * @throws {OPFSError} If the copy operation fails\n     * \n     * @example\n     * ```typescript\n     * // Copy a file\n     * await fs.copy('/source/file.txt', '/dest/file.txt');\n     * \n     * // Copy a directory and all its contents\n     * await fs.copy('/source/dir', '/dest/dir', { recursive: true });\n     * \n     * // Copy without overwriting existing files\n     * await fs.copy('/source', '/dest', { recursive: true, force: false });\n     * ```\n     */\n    async copy(source: string, destination: string, options?: { recursive?: boolean; force?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const recursive = options?.recursive ?? false;\n            const force = options?.force ?? true;\n\n            const sourceExists = await this.exists(source);\n\n            if (!sourceExists) {\n                throw new OPFSError(`Source does not exist: ${ source }`, 'ENOENT');\n            }\n\n            const destExists = await this.exists(destination);\n\n            if (destExists && !force) {\n                throw new OPFSError(`Destination already exists: ${ destination }`, 'EEXIST');\n            }\n\n            const sourceStats = await this.stat(source);\n\n            if (sourceStats.isFile) {\n                const content = await this.readFile(source, 'binary');\n                \n                await this.writeFile(destination, content);\n            }\n            else {\n                if (!recursive) {\n                    throw new OPFSError(`Cannot copy directory without recursive option: ${ source }`, 'EISDIR');\n                }\n\n                await this.mkdir(destination, { recursive: true });\n\n                const items = await this.readdir(source, { withFileTypes: true });\n\n                for (const item of items) {\n                    const sourceItemPath = `${ source }/${ item.name }`;\n                    const destItemPath = `${ destination }/${ item.name }`;\n\n                    await this.copy(sourceItemPath, destItemPath, { recursive: true, force });\n                }\n            }\n            \n            // Notify about the copy operation\n            await this.notifyChange({ path: destination, type: 'added', isDirectory: false });\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError(`Failed to copy from ${ source } to ${ destination }`, 'CP_FAILED');\n        }\n    }\n\n    /**\n     * Start watching a file or directory for changes\n     */\n    async watch(path: string): Promise<void> {\n        await this.ensureMounted();\n        \n        const normalizedPath = normalizePath(path);\n        const snapshot = await this.buildSnapshot(normalizedPath);\n\n        this.watchers.set(normalizedPath, snapshot);\n\n        if (!this.watchTimer) {\n            this.watchTimer = setInterval(() => {\n                void this.scanWatches();\n            }, this.watchInterval);\n        }\n    }\n\n    /**\n     * Stop watching a previously watched path\n     */\n    unwatch(path: string): void {\n        const normalizedPath = normalizePath(path);\n        this.watchers.delete(normalizedPath);\n\n        if (this.watchers.size === 0 && this.watchTimer) {\n            clearInterval(this.watchTimer);\n            this.watchTimer = null;\n        }\n    }\n\n    private async buildSnapshot(rootPath: string): Promise<Map<string, FileStat>> {\n        const result = new Map<string, FileStat>();\n\n        const walk = async (current: string) => {\n            const stat = await this.stat(current);\n            result.set(current, stat);\n\n            if (stat.isDirectory) {\n                const entries = await this.readdir(current, { withFileTypes: true });\n                for (const entry of entries) {\n                    const child = `${ current === '/' ? '' : current }/${ entry.name }`;\n                    await walk(child);\n                }\n            }\n        };\n\n        await walk(rootPath);\n        return result;\n    }\n\n    private async scanWatches(): Promise<void> {\n        if (this.scanning) {\n            return;\n        }\n\n        this.scanning = true;\n\n        try {\n            await Promise.all(\n                [...this.watchers.entries()].map(async([rootPath, prev]) => {\n                    let next: Map<string, FileStat>;\n\n                    try {\n                        next = await this.buildSnapshot(rootPath);\n                    }\n                    catch {\n                        next = new Map();\n                    }\n\n                    for (const [p, stat] of next) {\n                        const old = prev.get(p);\n                        \n                        if (!old) {\n                            await this.notifyChange({ path: p, type: 'added', isDirectory: false });\n                        }\n                        else if (old.mtime !== stat.mtime || old.size !== stat.size) {\n                            await this.notifyChange({ path: p, type: 'changed', isDirectory: false });\n                        }\n                    }\n\n                    for (const p of prev.keys()) {\n                        if (!next.has(p)) {\n                            await this.notifyChange({ path: p, type: 'removed', isDirectory: false });\n                        }\n                    }\n\n                    this.watchers.set(rootPath, next);\n                })\n            );\n        }\n        finally {\n            this.scanning = false;\n        }\n    }\n\n    /**\n     * Synchronize the file system with external data\n     * \n     * Syncs the file system with an array of entries containing paths and data.\n     * This is useful for importing data from external sources or syncing with remote data.\n     * \n     * @param entries - Array of [path, data] tuples to sync\n     * @param options - Options for synchronization\n     * @param options.cleanBefore - Whether to clear the file system before syncing (default: false)\n     * @returns Promise that resolves when synchronization is complete\n     * @throws {OPFSError} If the synchronization fails\n     * \n     * @example\n     * ```typescript\n     * // Sync with external data\n     * const entries: [string, string | Uint8Array | Blob][] = [\n     *   ['/config.json', JSON.stringify({ theme: 'dark' })],\n     *   ['/data/binary.dat', new Uint8Array([1, 2, 3, 4])],\n     *   ['/upload.txt', new Blob(['file content'], { type: 'text/plain' })]\n     * ];\n     * \n     * // Sync without clearing existing files\n     * await fs.sync(entries);\n     * \n     * // Clean file system and then sync\n     * await fs.sync(entries, { cleanBefore: true });\n     * ```\n     */\n    async sync(entries: [string, string | Uint8Array | Blob][], options?: { cleanBefore?: boolean }): Promise<void> {\n        await this.ensureMounted();\n        \n        try {\n            const cleanBefore = options?.cleanBefore ?? false;\n\n            if (cleanBefore) {\n                await this.clear('/');\n            }\n\n            for (const [path, data] of entries) {\n                const normalizedPath = normalizePath(path);\n\n                let fileData: string | Uint8Array;\n\n                if (data instanceof Blob) {\n                    fileData = await convertBlobToUint8Array(data);\n                }\n                else {\n                    fileData = data;\n                }\n\n                await this.writeFile(normalizedPath, fileData);\n            }\n            \n            // Notify about the sync operation\n            await this.notifyChange({ path: '/', type: 'changed', isDirectory: true });\n        }\n        catch (error) {\n            if (error instanceof OPFSError) {\n                throw error;\n            }\n\n            throw new OPFSError('Failed to sync file system', 'SYNC_FAILED');\n        }\n    }\n}\n\n// Only expose the worker when running in a Web Worker environment\nif (typeof self !== 'undefined' && self.constructor.name === 'DedicatedWorkerGlobalScope') {\n  expose(new OPFSWorker());\n}\n"],"names":["OPFSWorker","event","hash","stats","error","watchCallback","options","checkOPFSSupport","root","resolve","reject","rootDir","OPFSError","callback","path","create","from","OPFSNotMountedError","segments","splitPath","current","segment","PathError","fileName","result","walk","dirPath","items","item","fullPath","stat","err","encoding","fileHandle","buffer","readFileData","decodeBuffer","FileNotFoundError","data","writeFileData","recursive","i","e","joinPath","name","basename","parentDir","dirname","includeHash","file","baseStat","calculateFileHash","withTypes","dir","results","handle","isFile","itemPath","force","parent","normalizedPath","resolvePath","oldPath","newPath","source","destination","content","sourceItemPath","destItemPath","normalizePath","snapshot","rootPath","entries","entry","child","prev","next","p","old","fileData","convertBlobToUint8Array","expose"],"mappings":"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"}

package/dist/types.d.ts

@@ -19,7 +19,10 @@ export interface DirentData {
 }
 export interface WatchEvent {
     path: string;
-    type: 'create' | 'change' | 'delete';
+    type: 'added' | 'changed' | 'removed';
+    isDirectory: boolean;
+    timestamp: string;
+    hash?: string;
 }
 export type { OPFSWorker };
 export type RemoteOPFSWorker = Remote<OPFSWorker>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC;AAExC,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACxC;AAED,YAAY,EAAE,UAAU,EAAE,CAAC;AAC3B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC;AAExC,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC;AAC3B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC"}

package/dist/utils/helpers.d.ts

@@ -117,7 +117,7 @@ export declare function writeFileData(fileHandle: FileSystemFileHandle, data: st
  * @param algorithm - Hash algorithm to use (default: 'SHA-1')
  * @returns Promise that resolves to the hash string
  */
-export declare function calculateFileHash(buffer: Uint8Array, algorithm?: string): Promise<string>;
+export declare function calculateFileHash(buffer: File | ArrayBuffer | Uint8Array, algorithm?: string): Promise<string>;
 /**
  * Convert a Blob to Uint8Array
  *

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAM3D;AAGD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,EAAE,QAAQ,GAAE,cAAwB,GAAG,UAAU,CAMpH;AAGD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAcxF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,EACvC,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,GAAE,MAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxG;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAG7E"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAM3D;AAGD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuBhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,EAAE,QAAQ,GAAE,cAAwB,GAAG,UAAU,CAMpH;AAGD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAcxF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAC/B,UAAU,EAAE,oBAAoB,EAChC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,EACvC,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACvD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,UAAU,EAAE,SAAS,GAAE,MAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB7H;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAG7E"}

package/dist/worker.d.ts

@@ -30,15 +30,30 @@ export declare class OPFSWorker {
     private scanning;
     /** Promise to prevent concurrent mount operations */
     private mountingPromise;
+    /** Hash algorithm for file hashing (null means no hashing) */
+    private hashAlgorithm;
+    /**
+     * Notify about internal changes to the file system
+     *
+     * This method is called by internal operations to notify clients about
+     * changes, even when no specific paths are being watched.
+     *
+     * @param path - The path that was changed
+     * @param type - The type of change (create, change, delete)
+     */
+    private notifyChange;
     /**
      * Creates a new OPFSFileSystem instance
      *
      * @param watchCallback - Optional callback for file change events
-     * @param watchOptions - Optional configuration for watching
+     * @param options - Optional configuration options
+     * @param options.watchInterval - Polling interval in milliseconds for file watching
+     * @param options.hashAlgorithm - Hash algorithm for file hashing
      * @throws {OPFSError} If OPFS is not supported in the current browser
      */
-    constructor(watchCallback?: (event: WatchEvent) => void, watchOptions?: {
+    constructor(watchCallback?: (event: WatchEvent) => void, options?: {
         watchInterval?: number;
+        hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
     });
     /**
      * Initialize the file system within a given directory
@@ -66,10 +81,18 @@ export declare class OPFSWorker {
      * Set the watch callback for file change events
      *
      * @param callback - The callback function to invoke when files change
-     * @param options - Optional configuration for watching
      */
-    setWatchCallback(callback: (event: WatchEvent) => void, options?: {
+    setWatchCallback(callback: (event: WatchEvent) => void): void;
+    /**
+     * Set configuration options for the file system
+     *
+     * @param options - Configuration options to update
+     * @param options.watchInterval - Polling interval in milliseconds for file watching
+     * @param options.hashAlgorithm - Hash algorithm for file hashing
+     */
+    setOptions(options: {
         watchInterval?: number;
+        hashAlgorithm?: null | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
     }): void;
     /**
      * Automatically mount the OPFS root if not already mounted
@@ -121,35 +144,17 @@ export declare class OPFSWorker {
      */
     private getFileHandle;
     /**
-     * Recursively list all files and directories with their stats
+     * Get a complete index of all files and directories in the file system
      *
-     * Traverses the entire file system starting from the root and returns
-     * a Map containing all paths and their corresponding file statistics.
+     * This method recursively traverses the entire file system and returns
+     * a Map containing FileStat objects for every file and directory.
      *
-     * @param options - Options for indexing
-     * @param options.includeHash - Whether to calculate file hash (default: false)
-     * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)
-     * @returns Promise that resolves to a Map of path => FileStat
-     * @throws {OPFSError} If the indexing operation fails
+     * @returns Promise that resolves to a Map of paths to FileStat objects
+     * @throws {OPFSError} If the file system is not mounted
      *
      * @example
      * ```typescript
-     * // Basic index without hash
      * const index = await fs.index();
-     *
-     * // Index with file hash
-     * const indexWithHash = await fs.index({
-     *   includeHash: true,
-     *   hashAlgorithm: 'SHA-1'
-     * });
-     *
-     * // Iterate through all files and directories
-     * for (const [path, stat] of index) {
-     *   console.log(`${path}: ${stat.isFile ? 'file' : 'directory'} (${stat.size} bytes)`);
-     *   if (stat.hash) console.log(`  Hash: ${stat.hash}`);
-     * }
-     *
-     * // Get specific file stats
      * const fileStats = index.get('/data/config.json');
      * if (fileStats) {
      *   console.log(`File size: ${fileStats.size} bytes`);
@@ -157,10 +162,7 @@ export declare class OPFSWorker {
      * }
      * ```
      */
-    index(options?: {
-        includeHash?: boolean;
-        hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
-    }): Promise<Map<string, FileStat>>;
+    index(): Promise<Map<string, FileStat>>;
     /**
      * Read a file from the file system
      *
@@ -261,38 +263,28 @@ export declare class OPFSWorker {
         recursive?: boolean;
     }): Promise<void>;
     /**
-     * Get file or directory stats
+     * Get file or directory statistics
      *
-     * Retrieves metadata about a file or directory, including size, modification time,
-     * type information, and optionally file hashes.
+     * Returns detailed information about a file or directory, including
+     * size, modification time, and optionally a hash of the file content.
      *
      * @param path - The path to the file or directory
-     * @param options - Options for stat operation
-     * @param options.includeHash - Whether to calculate file hash (default: false, only for files)
-     * @param options.hashAlgorithm - Hash algorithm to use (default: 'SHA-1', fastest)
-     * @returns Promise that resolves to file/directory statistics
-     * @throws {OPFSError} If the file or directory does not exist or cannot be accessed
+     * @returns Promise that resolves to FileStat object
+     * @throws {OPFSError} If the path does not exist or cannot be accessed
      *
      * @example
      * ```typescript
-     * // Basic stats
-     * const stats = await fs.stat('/config/settings.json');
+     * const stats = await fs.stat('/data/config.json');
      * console.log(`File size: ${stats.size} bytes`);
-     * console.log(`Is file: ${stats.isFile}`);
-     * console.log(`Modified: ${stats.mtime}`);
+     * console.log(`Last modified: ${stats.mtime}`);
      *
-     * // Stats with hash (SHA-1 is fastest)
-     * const statsWithHash = await fs.stat('/config/settings.json', {
-     *   includeHash: true,
-     *   hashAlgorithm: 'SHA-1'
-     * });
-     * console.log(`Hash: ${statsWithHash.hash}`);
+     * // If hashing is enabled, hash will be included
+     * if (stats.hash) {
+     *   console.log(`Hash: ${stats.hash}`);
+     * }
      * ```
      */
-    stat(path: string, options?: {
-        includeHash?: boolean;
-        hashAlgorithm?: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512';
-    }): Promise<FileStat>;
+    stat(path: string): Promise<FileStat>;
     /**
      * Read a directory's contents
      *

package/dist/worker.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "opfs-worker",
-    "version": "0.2.3",
+    "version": "0.2.5",
     "description": "A robust TypeScript library for working with Origin Private File System (OPFS) through Web Workers",
     "type": "module",
     "main": "dist/index.js",