opfs-worker 2.1.0 → 2.1.2

package/dist/createOPFSDedicated-DgudPTB8.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOPFSDedicated-DgudPTB8.js","sources":["../src/worker/createDedicatedWorker.ts","../src/facade/createOPFSDedicated.ts"],"sourcesContent":["import { wrap } from 'comlink';\n\nimport WorkerCtor from './dedicated.worker?worker&inline';\nimport { normalizePath } from '../utils/helpers';\n\nimport type { OPFSOptions, OPFSSync } from '../types';\nimport type { Remote } from 'comlink';\n\nconst InlineWorker = WorkerCtor as new (options?: WorkerOptions) => Worker;\n\ntype RemoteOPFSSync = Remote<OPFSSync>;\n\nexport interface DedicatedWorkerOptions extends OPFSOptions {\n    /**\n     * URL of the worker script, e.g. `import url from 'opfs-worker/dedicated.worker.js?url'` (Vite).\n     *\n     * Defaults to the inlined worker (no URL needed). Pass an explicit url when you\n     * prefer the self-contained file (strict CSP without `blob:`, or DIY hosting).\n     */\n    url?: string | URL;\n    /** Bring your own Worker instance (overrides `url`) — not pooled */\n    worker?: Worker;\n}\n\nexport interface RawWorker {\n    /** Comlink proxy to `OPFSSync` (bytes in / bytes out) */\n    fs: RemoteOPFSSync;\n    /** Underlying browser Worker */\n    worker: Worker;\n    /** Drops this facade's port; terminates the Worker when the last user of this pool entry disposes */\n    dispose: () => void;\n}\n\ninterface PoolEntry {\n    worker: Worker;\n    refs: number;\n}\n\n/** Same root (+ same worker url) → one Worker per page. */\nconst pool = new Map<string, PoolEntry>();\n\nfunction poolKey(root: string, url?: string | URL): string {\n    return `${ normalizePath(root) }\\0${ url?.toString() ?? 'inline' }`;\n}\n\n/** A `BroadcastChannel` instance can't cross the wire — send its name instead. */\nfunction applyWorkerOptions(fs: Pick<RemoteOPFSSync, 'setOptions'>, options?: OPFSOptions): void {\n    if (!options) {\n        return;\n    }\n\n    if (options.broadcastChannel instanceof BroadcastChannel) {\n        options.broadcastChannel = options.broadcastChannel.name;\n    }\n\n    void fs.setOptions(options);\n}\n\nfunction connectProxy(worker: Worker): { fs: RemoteOPFSSync; port: MessagePort } {\n    const { port1, port2 } = new MessageChannel();\n\n    worker.postMessage({ type: 'opfs-connect', port: port2 }, [port2]);\n\n    return { fs: wrap<RemoteOPFSSync>(port1), port: port1 };\n}\n\n/**\n * Internal helper: spawn (or reuse) a dedicated worker and wrap `OPFSSync` with Comlink.\n * Prefer {@link createOPFSDedicated}; access the proxy / Worker via\n * `facade.backend` / `facade.worker`.\n *\n * Calls with the same `root` (and same `url`, if any) share one Worker on this page.\n * Different roots get different Workers. Passing `worker` bypasses the pool.\n *\n * `setOptions` hits the shared instance — keep options consistent for the same root.\n */\nexport function createDedicatedWorker(options: DedicatedWorkerOptions = {}): RawWorker {\n    const { url, worker: providedWorker, ...fsOptions } = options;\n    const root = normalizePath(fsOptions.root ?? '/');\n\n    if (providedWorker) {\n        const { fs, port } = connectProxy(providedWorker);\n\n        applyWorkerOptions(fs, fsOptions);\n\n        return {\n            fs,\n            worker: providedWorker,\n            dispose() {\n                port.close();\n            },\n        };\n    }\n\n    const key = poolKey(root, url);\n    let entry = pool.get(key);\n\n    if (!entry) {\n        entry = {\n            worker: url ? new Worker(url, { type: 'module' }) : new InlineWorker(),\n            refs: 0,\n        };\n        pool.set(key, entry);\n    }\n\n    entry.refs += 1;\n\n    const { worker } = entry;\n    const { fs, port } = connectProxy(worker);\n\n    applyWorkerOptions(fs, fsOptions);\n\n    let disposed = false;\n\n    return {\n        fs,\n        worker,\n        dispose() {\n            if (disposed) {\n                return;\n            }\n\n            disposed = true;\n\n            void (async() => {\n                const current = pool.get(key);\n                const isLast = !!current && current.worker === worker && current.refs <= 1;\n\n                try {\n                    // Only the last facade may dispose the shared OPFSSync backend\n                    if (isLast) {\n                        await fs.dispose();\n                    }\n                }\n                finally {\n                    port.close();\n                }\n\n                if (!current || current.worker !== worker) {\n                    return;\n                }\n\n                current.refs -= 1;\n\n                if (current.refs <= 0) {\n                    pool.delete(key);\n                    worker.terminate();\n                }\n            })();\n        },\n    };\n}\n","import { OPFSFacade } from './OPFSFacade';\nimport { createDedicatedWorker } from '../worker/createDedicatedWorker';\n\nimport type { DedicatedWorkerOptions } from '../worker/createDedicatedWorker';\n\n/**\n * Dedicated mode: start a dedicated worker and get a Node-like `fs` API\n * backed by `OPFSSync`.\n *\n * Prefer importing from `opfs-worker/sync` when you only need the worker backend\n * (avoids pulling `OPFSAsync` into the graph). Importing from `opfs-worker` works too.\n *\n * By default uses an inlined worker. Calls with the same `root` (and same `url`)\n * reuse one Worker on this page; different roots get different Workers.\n * Pass `url` / `worker` to load `opfs-worker/dedicated.worker.js` instead\n * (see {@link DedicatedWorkerOptions}).\n *\n * Need the raw bytes API or the Worker instance? Use `fs.backend` / `fs.worker`.\n * For the workerless async backend, use {@link createOPFSAsync}.\n */\nexport function createOPFSDedicated(options?: DedicatedWorkerOptions): OPFSFacade {\n    const { fs, worker, dispose } = createDedicatedWorker(options);\n\n    return new OPFSFacade({ fs, worker, dispose });\n}\n"],"names":["InlineWorker","WorkerCtor","pool","poolKey","root","url","normalizePath","applyWorkerOptions","fs","options","connectProxy","worker","port1","port2","wrap","createDedicatedWorker","providedWorker","fsOptions","port","key","entry","disposed","current","isLast","createOPFSDedicated","dispose","OPFSFacade"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,MAAMA,IAAeC,GA+BfC,wBAAW,IAAA;AAEjB,SAASC,EAAQC,GAAcC,GAA4B;AACvD,SAAO,GAAIC,EAAcF,CAAI,CAAE,KAAMC,GAAK,cAAc,QAAS;AACrE;AAGA,SAASE,EAAmBC,GAAwCC,GAA6B;AAC7F,EAAKA,MAIDA,EAAQ,4BAA4B,qBACpCA,EAAQ,mBAAmBA,EAAQ,iBAAiB,OAGnDD,EAAG,WAAWC,CAAO;AAC9B;AAEA,SAASC,EAAaC,GAA2D;AAC7E,QAAM,EAAE,OAAAC,GAAO,OAAAC,EAAA,IAAU,IAAI,eAAA;AAE7B,SAAAF,EAAO,YAAY,EAAE,MAAM,gBAAgB,MAAME,EAAA,GAAS,CAACA,CAAK,CAAC,GAE1D,EAAE,IAAIC,EAAqBF,CAAK,GAAG,MAAMA,EAAA;AACpD;AAYO,SAASG,EAAsBN,IAAkC,IAAe;AACnF,QAAM,EAAE,KAAAJ,GAAK,QAAQW,GAAgB,GAAGC,MAAcR,GAChDL,IAAOE,EAAcW,EAAU,QAAQ,GAAG;AAEhD,MAAID,GAAgB;AAChB,UAAM,EAAE,IAAAR,GAAI,MAAAU,EAAAA,IAASR,EAAaM,CAAc;AAEhD,WAAAT,EAAmBC,GAAIS,CAAS,GAEzB;AAAA,MACH,IAAAT;AAAAA,MACA,QAAQQ;AAAA,MACR,UAAU;AACNE,QAAAA,EAAK,MAAA;AAAA,MACT;AAAA,IAAA;AAAA,EAER;AAEA,QAAMC,IAAMhB,EAAQC,GAAMC,CAAG;AAC7B,MAAIe,IAAQlB,EAAK,IAAIiB,CAAG;AAExB,EAAKC,MACDA,IAAQ;AAAA,IACJ,QAAQf,IAAM,IAAI,OAAOA,GAAK,EAAE,MAAM,SAAA,CAAU,IAAI,IAAIL,EAAA;AAAA,IACxD,MAAM;AAAA,EAAA,GAEVE,EAAK,IAAIiB,GAAKC,CAAK,IAGvBA,EAAM,QAAQ;AAEd,QAAM,EAAE,QAAAT,MAAWS,GACb,EAAE,IAAAZ,GAAI,MAAAU,MAASR,EAAaC,CAAM;AAExC,EAAAJ,EAAmBC,GAAIS,CAAS;AAEhC,MAAII,IAAW;AAEf,SAAO;AAAA,IACH,IAAAb;AAAA,IACA,QAAAG;AAAA,IACA,UAAU;AACN,MAAIU,MAIJA,IAAW,KAEL,YAAW;AACb,cAAMC,IAAUpB,EAAK,IAAIiB,CAAG,GACtBI,IAAS,CAAC,CAACD,KAAWA,EAAQ,WAAWX,KAAUW,EAAQ,QAAQ;AAEzE,YAAI;AAEA,UAAIC,KACA,MAAMf,EAAG,QAAA;AAAA,QAEjB,UAAA;AAEI,UAAAU,EAAK,MAAA;AAAA,QACT;AAEA,QAAI,CAACI,KAAWA,EAAQ,WAAWX,MAInCW,EAAQ,QAAQ,GAEZA,EAAQ,QAAQ,MAChBpB,EAAK,OAAOiB,CAAG,GACfR,EAAO,UAAA;AAAA,MAEf,GAAA;AAAA,IACJ;AAAA,EAAA;AAER;ACnIO,SAASa,EAAoBf,GAA8C;AAC9E,QAAM,EAAE,IAAAD,GAAI,QAAAG,GAAQ,SAAAc,EAAA,IAAYV,EAAsBN,CAAO;AAE7D,SAAO,IAAIiB,EAAW,EAAE,IAAAlB,GAAI,QAAAG,GAAQ,SAAAc,GAAS;AACjD;"}