@dxos/plugin-wnfs 0.9.1-staging.ee54ba693a → 0.11.0

package/PLUGIN.mdl

@@ -1,15 +1,17 @@
 ---
 id: org.dxos.plugin.wnfs
 name: WnfsPlugin
-version: 0.1.0
+version: 0.2.0
 ---
 
 A decentralized file storage plugin for `DXOS` Composer built on the Web Native File System (WNFS) protocol.
 
 WNFS provides a content-addressed, end-to-end encrypted private file system using a cryptographic "dark forest"
 structure. Files are stored as IPLD blocks referenced by CID, replicated to a DXOS edge blob service, and
-cached locally in IndexedDB. The plugin implements the `FileCapabilities.Backend` and `FileCapabilities.UrlResolver`
-interfaces from `plugin-file`, so other plugins (e.g. `plugin-gallery`) can upload and resolve `wnfs://` URLs
+cached locally in IndexedDB. The plugin registers a `BlobBackend` (schemes: `['wnfs']`) on the ECHO Hypergraph
+via `client.graph.registerBlobBackend`, and contributes a matching `FileCapabilities.Backend` descriptor
+(`{ storage: 'wnfs' }`) so `plugin-file` — and any plugin built on it, e.g. `plugin-gallery` — can
+upload files and resolve `wnfs://` URIs uniformly via the core `Blob.fromBytes`/`Blob.url`/`Blob.read` API,
 without knowing the underlying storage layer. Uploads are scoped to a DXOS Space; the private forest root CID
 is persisted on the space's ECHO properties and updated atomically on every write.
 
@@ -44,7 +46,9 @@ type WnfsPath
 
 ```mdl
 type FileInfo
-  desc: Metadata returned after a successful upload.
+  desc: |
+    Internal return value of the `upload` helper. Only `.url` is surfaced to the outside world,
+    as the `uri` field of the `BlobBackend.put` PutResponse.
   fields:
     name: string              # Original file name
     type: string              # MIME type
@@ -75,7 +79,6 @@ type WnfsInstance
     directory: PrivateDirectory
     forest: PrivateForest
 ```
-```
 
 ## Operations
 
@@ -97,7 +100,64 @@ op getPathFromUrl
   output: string[]
 ```
 
-Effectful operations — read or write persistent state.
+BlobBackend implementation — registered on the ECHO Hypergraph, dispatched to by core `Blob.fromBytes` /
+`Blob.read` / `Blob.exists` / `Blob.url` whenever a Blob's storage or URI scheme resolves to `wnfs`.
+
+```mdl
+op wnfsBlobPut
+  desc: |
+    Implements BlobBackend.put. Resolves the target Space from spaceId, wraps the given bytes in a
+    browser File (named `name ?? contentHash`), and delegates to the uploadFile op. Returns
+    { uri: info.url } (a wnfs:// URL) as the PutResponse.
+  input:
+    spaceId: SpaceId
+    data: Uint8Array
+    contentType?: string
+    contentHash: string       # sha256 hex digest, computed by the core BlobManager; not re-verified here
+    name?: string
+  output: { uri: string }
+  effects: [fs:read, echo:write, http:post]
+  errors:
+    SpaceNotFound: no space matching spaceId is currently open (invariant failure)
+```
+
+```mdl
+op wnfsBlobGet
+  desc: |
+    Implements BlobBackend.get. Resolves the Space from spaceId, loads or reuses the cached
+    WnfsInstance, and reads the file bytes at the given wnfs:// URI (via getPathFromUrl + directory.read).
+  input:
+    spaceId: SpaceId
+    uri: string
+  output: Uint8Array | undefined
+  effects: [fs:read, http:get]
+  note: Returns undefined (never throws) if the space is not open or the read fails for any reason.
+```
+
+```mdl
+op wnfsBlobHas
+  desc: Implements BlobBackend.has by delegating to the same read path as wnfsBlobGet and checking for a defined result.
+  input:
+    spaceId: SpaceId
+    uri: string
+  output: boolean
+```
+
+```mdl
+op wnfsBlobGetUrl
+  desc: |
+    Implements BlobBackend.getUrl. Resolves the Space, loads or reuses the cached WnfsInstance,
+    reads the file bytes, wraps them in a Blob, and returns an object URL for in-browser display.
+  input:
+    spaceId: SpaceId
+    uri: string
+    contentType?: string
+  output: string | undefined
+  effects: [fs:read, http:get]
+  note: Returns undefined (never throws) if the space is not open or reading fails.
+```
+
+Effectful operations underlying the BlobBackend implementation above.
 
 ```mdl
 op uploadFile
@@ -119,22 +179,6 @@ op uploadFile
     the forest CID property is only updated after the forest is stored.
 ```
 
-```mdl
-op resolveWnfsUrl
-  desc: |
-    Reads file bytes from the WNFS private directory for a wnfs:// URL,
-    wraps them in a Blob, and returns an object URL for in-browser display.
-  input:
-    wnfsUrl: string
-    space: Space
-    type?: string             # MIME type hint for Blob construction
-  output: string              # blob: object URL
-  effects: [fs:read, http:get]
-  errors:
-    UrlNotResolvable: space not available or file not found in directory
-  note: Errors are swallowed and undefined is returned to avoid breaking image renders.
-```
-
 ```mdl
 op flushBlockQueue
   desc: |
@@ -156,9 +200,10 @@ op flushBlockQueue
 feat F-1: Upload File
 
   req F-1.1:
-    when: a FileCapabilities.Backend consumer calls upload(file, db)
-    then: the file is read, hashed, written to the WNFS private directory,
-          and stored in the blockstore
+    when: core Blob.fromBytes routes to the 'wnfs' storage (i.e. BlobBackend.put is invoked
+          for this backend)
+    then: the file is written to the WNFS private directory and stored in the blockstore;
+          wnfsBlobPut returns { uri } to the caller
 
   req F-1.2:
     when: the write succeeds
@@ -166,27 +211,28 @@ feat F-1: Upload File
 
   req F-1.3:
     when: the upload completes
-    then: a FileInfo object with name, type, size, and wnfs:// URL is returned to the caller
+    then: the returned uri is a wnfs:// URL, embedded by core Blob.ts as the Blob object's
+          `data.uri` (an `external` BlobData variant)
 ```
 
 ```mdl
-feat F-2: Resolve wnfs:// URL
+feat F-2: Resolve wnfs:// blobs
 
   req F-2.1:
-    when: FileCapabilities.UrlResolver.test(url) is called with a wnfs:// URL
-    then: returns true
+    when: a Blob's URI scheme is 'wnfs' (i.e. this plugin's registered schemes include it)
+    then: core Blob.read / Blob.exists / Blob.url dispatch to this plugin's BlobBackend
 
   req F-2.2:
-    when: FileCapabilities.UrlResolver.resolve(url, file, space) is called
+    when: BlobBackend.get or .has is called with a wnfs:// uri
     then: loads or reuses a cached WnfsInstance for the space and reads the file bytes
 
   req F-2.3:
-    when: bytes are successfully read
-    then: a blob: object URL is returned for in-browser display
+    when: BlobBackend.getUrl is called with a wnfs:// uri
+    then: bytes are read and wrapped in a blob: object URL for in-browser display
 
   req F-2.4:
-    when: the space is undefined or reading fails
-    then: undefined is returned; no error is propagated
+    when: the space is not open, or reading/writing fails
+    then: get/has/getUrl resolve to undefined/false rather than throwing; put rejects
 ```
 
 ```mdl
@@ -241,29 +287,29 @@ feat F-4: Space-Scoped Private File System
 ## Acceptance
 
 ```mdl
-test T-1: Upload creates FileInfo
-  given: an active space and a registered WNFS backend
-  when: a file is uploaded via the Backend capability
+test T-1: Upload creates a wnfs:// blob
+  given: an active space and this plugin's BlobBackend registered on the ECHO Hypergraph
+  when: Blob.fromBytes is called with storage: 'wnfs'
   then:
-    - FileInfo.url starts with wnfs://
+    - the resulting Blob's data.uri starts with wnfs://
     - space.properties.wnfs.privateForestCid is set
     - block for the file is present in the local IndexedDB blockstore
 ```
 
 ```mdl
-test T-2: Resolve uploaded file
-  given: a file was previously uploaded and FileInfo.url is known
-  when: UrlResolver.resolve(url, file, space) is called
+test T-2: Resolve uploaded blob via getUrl
+  given: a blob was previously uploaded and its data.uri (a wnfs:// URI) is known
+  when: BlobBackend.getUrl(spaceId, uri, contentType) is called
   then:
     - a blob: object URL is returned
-    - URL can be used as an img src
+    - the URL can be used as an img src
 ```
 
 ```mdl
-test T-3: Resolve without space returns undefined
-  given: a wnfs:// URL
-  when: UrlResolver.resolve is called with space = undefined
-  then: undefined is returned; no error is thrown
+test T-3: get/has/getUrl return undefined/false when the space is not open
+  given: a wnfs:// URI whose space is not currently open
+  when: BlobBackend.get, .has, or .getUrl is called
+  then: undefined (or false for .has) is returned; no error is thrown
 ```
 
 ```mdl

package/dist/lib/WnfsPlugin.mjs

@@ -0,0 +1,28 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { ClientEvents } from "@dxos/plugin-client";
+import { BlobBackend, Dependencies } from "#capabilities";
+import { translations } from "#translations";
+import { WnfsEvents } from "#types";
+//#endregion
+//#region src/WnfsPlugin.tsx
+var WnfsPlugin = Plugin.define(meta).pipe(AppPlugin.addTranslationsModule({ translations }), Plugin.addModule({
+	id: "dependencies",
+	activatesOn: ClientEvents.ClientReady,
+	firesAfterActivation: [WnfsEvents.DependenciesReady],
+	activate: Dependencies
+}), Plugin.addModule({
+	id: "blob-backend",
+	activatesOn: WnfsEvents.DependenciesReady,
+	activate: BlobBackend
+}), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\nid: org.dxos.plugin.wnfs\nname: WnfsPlugin\nversion: 0.2.0\n---\n\nA decentralized file storage plugin for `DXOS` Composer built on the Web Native File System (WNFS) protocol.\n\nWNFS provides a content-addressed, end-to-end encrypted private file system using a cryptographic \"dark forest\"\nstructure. Files are stored as IPLD blocks referenced by CID, replicated to a DXOS edge blob service, and\ncached locally in IndexedDB. The plugin registers a `BlobBackend` (schemes: `['wnfs']`) on the ECHO Hypergraph\nvia `client.graph.registerBlobBackend`, and contributes a matching `FileCapabilities.Backend` descriptor\n(`{ storage: 'wnfs' }`) so `plugin-file` — and any plugin built on it, e.g. `plugin-gallery` — can\nupload files and resolve `wnfs://` URIs uniformly via the core `Blob.fromBytes`/`Blob.url`/`Blob.read` API,\nwithout knowing the underlying storage layer. Uploads are scoped to a DXOS Space; the private forest root CID\nis persisted on the space's ECHO properties and updated atomically on every write.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`       |\n| `feat`      | `org.dxos.mdl.feat@1.0`       |\n| `test`      | `org.dxos.mdl.test@1.0`       |\n| `component` | `org.dxos.mdl.component@1.0`  |\n| `op`        | `org.dxos.mdl.op@1.0`         |\n\n## Types\n\n```mdl\ntype Cid\n  desc: A content-addressed identifier encoded as a base-32 multibase string (CIDv1, sha2-256).\n  fields:\n    value: string\n```\n\n```mdl\ntype WnfsPath\n  desc: A WNFS path encoded as a wnfs:// URL; segments are percent-encoded.\n  fields:\n    url: string               # wnfs://spaces/<spaceId>/files/<cid>\n```\n\n```mdl\ntype FileInfo\n  desc: |\n    Internal return value of the `upload` helper. Only `.url` is surfaced to the outside world,\n    as the `uri` field of the `BlobBackend.put` PutResponse.\n  fields:\n    name: string              # Original file name\n    type: string              # MIME type\n    url: WnfsPath             # wnfs:// URL for later retrieval\n    cid: Cid                  # Raw content CID of the file bytes\n```\n\n```mdl\ntype BlockstoreState\n  desc: Runtime state of the MixedBlockstore.\n  fields:\n    isConnected: boolean      # Online / offline status\n    queueLength: number       # Blocks pending remote flush\n    apiHost: string           # DXOS edge service base URL\n```\n\n```mdl\ntype WnfsInstances\n  desc: In-memory cache mapping forest CID → loaded PrivateDirectory/PrivateForest pair.\n  fields:\n    entries: Record<string, WnfsInstance>\n```\n\n```mdl\ntype WnfsInstance\n  desc: A loaded WNFS private file system rooted at a specific forest CID.\n  fields:\n    directory: PrivateDirectory\n    forest: PrivateForest\n```\n\n## Operations\n\nPure operations — no external effects.\n\n```mdl\nop wnfsUrl\n  desc: Encodes a WNFS path array into a wnfs:// URL with percent-encoded segments.\n  input:\n    filePath: string[]\n  output: string\n```\n\n```mdl\nop getPathFromUrl\n  desc: Decodes a wnfs:// URL back into a path segment array.\n  input:\n    wnfsUrl: string\n  output: string[]\n```\n\nBlobBackend implementation — registered on the ECHO Hypergraph, dispatched to by core `Blob.fromBytes` /\n`Blob.read` / `Blob.exists` / `Blob.url` whenever a Blob's storage or URI scheme resolves to `wnfs`.\n\n```mdl\nop wnfsBlobPut\n  desc: |\n    Implements BlobBackend.put. Resolves the target Space from spaceId, wraps the given bytes in a\n    browser File (named `name ?? contentHash`), and delegates to the uploadFile op. Returns\n    { uri: info.url } (a wnfs:// URL) as the PutResponse.\n  input:\n    spaceId: SpaceId\n    data: Uint8Array\n    contentType?: string\n    contentHash: string       # sha256 hex digest, computed by the core BlobManager; not re-verified here\n    name?: string\n  output: { uri: string }\n  effects: [fs:read, echo:write, http:post]\n  errors:\n    SpaceNotFound: no space matching spaceId is currently open (invariant failure)\n```\n\n```mdl\nop wnfsBlobGet\n  desc: |\n    Implements BlobBackend.get. Resolves the Space from spaceId, loads or reuses the cached\n    WnfsInstance, and reads the file bytes at the given wnfs:// URI (via getPathFromUrl + directory.read).\n  input:\n    spaceId: SpaceId\n    uri: string\n  output: Uint8Array | undefined\n  effects: [fs:read, http:get]\n  note: Returns undefined (never throws) if the space is not open or the read fails for any reason.\n```\n\n```mdl\nop wnfsBlobHas\n  desc: Implements BlobBackend.has by delegating to the same read path as wnfsBlobGet and checking for a defined result.\n  input:\n    spaceId: SpaceId\n    uri: string\n  output: boolean\n```\n\n```mdl\nop wnfsBlobGetUrl\n  desc: |\n    Implements BlobBackend.getUrl. Resolves the Space, loads or reuses the cached WnfsInstance,\n    reads the file bytes, wraps them in a Blob, and returns an object URL for in-browser display.\n  input:\n    spaceId: SpaceId\n    uri: string\n    contentType?: string\n  output: string | undefined\n  effects: [fs:read, http:get]\n  note: Returns undefined (never throws) if the space is not open or reading fails.\n```\n\nEffectful operations underlying the BlobBackend implementation above.\n\n```mdl\nop uploadFile\n  desc: |\n    Reads a File, writes its bytes into the WNFS private directory at a\n    CID-derived path, persists the updated forest pointer to the space's\n    ECHO properties, and returns FileInfo.\n  input:\n    file: File\n    space: Space\n  output: FileInfo\n  effects: [fs:read, echo:write, http:post]\n  errors:\n    SpaceNotFound: no space matching the given spaceId\n    BlockstoreError: local or remote block I/O failure\n  note: |\n    Uses sha256 for block hashing (not the rs-wnfs default Blake3) for\n    broader runtime support. Writes are atomic from ECHO's perspective:\n    the forest CID property is only updated after the forest is stored.\n```\n\n```mdl\nop flushBlockQueue\n  desc: |\n    Drains the pending-upload queue by assembling a CAR archive and POSTing\n    it to the edge blob service. Called automatically (debounced 5 s) on\n    block writes and on the browser `online` event.\n  input:\n    blockstore: Blockstore\n  output: void\n  effects: [http:post]\n  errors:\n    NetworkError: remote POST failed\n  note: Queue is persisted to IndexedDB so pending blocks survive page reloads.\n```\n\n## Features\n\n```mdl\nfeat F-1: Upload File\n\n  req F-1.1:\n    when: core Blob.fromBytes routes to the 'wnfs' storage (i.e. BlobBackend.put is invoked\n          for this backend)\n    then: the file is written to the WNFS private directory and stored in the blockstore;\n          wnfsBlobPut returns { uri } to the caller\n\n  req F-1.2:\n    when: the write succeeds\n    then: the space's ECHO properties are updated with the new privateForestCid\n\n  req F-1.3:\n    when: the upload completes\n    then: the returned uri is a wnfs:// URL, embedded by core Blob.ts as the Blob object's\n          `data.uri` (an `external` BlobData variant)\n```\n\n```mdl\nfeat F-2: Resolve wnfs:// blobs\n\n  req F-2.1:\n    when: a Blob's URI scheme is 'wnfs' (i.e. this plugin's registered schemes include it)\n    then: core Blob.read / Blob.exists / Blob.url dispatch to this plugin's BlobBackend\n\n  req F-2.2:\n    when: BlobBackend.get or .has is called with a wnfs:// uri\n    then: loads or reuses a cached WnfsInstance for the space and reads the file bytes\n\n  req F-2.3:\n    when: BlobBackend.getUrl is called with a wnfs:// uri\n    then: bytes are read and wrapped in a blob: object URL for in-browser display\n\n  req F-2.4:\n    when: the space is not open, or reading/writing fails\n    then: get/has/getUrl resolve to undefined/false rather than throwing; put rejects\n```\n\n```mdl\nfeat F-3: Blockstore Sync\n\n  req F-3.1:\n    when: a block is written via blockstore.put\n    then: the block is saved to IndexedDB and added to the upload queue\n\n  req F-3.2:\n    when: the browser is online and the queue is non-empty\n    then: blocks are batched into a CAR archive and flushed to the edge service\n\n  req F-3.3:\n    when: the browser goes offline\n    then: the queue is persisted to IndexedDB; no upload is attempted\n\n  req F-3.4:\n    when: the browser comes back online\n    then: the flush is triggered automatically\n\n  req F-3.5:\n    when: a block is requested via blockstore.get and is present in IndexedDB\n    then: the block is returned from the local cache without a network request\n\n  req F-3.6:\n    when: a block is not in IndexedDB and the browser is online\n    then: the block is fetched from the edge service and cached locally\n```\n\n```mdl\nfeat F-4: Space-Scoped Private File System\n\n  req F-4.1:\n    when: a space has no existing WNFS properties\n    then: a new PrivateForest and PrivateDirectory are created and stored\n\n  req F-4.2:\n    when: a space already has a privateForestCid\n    then: the existing forest and directory are loaded from the blockstore\n\n  req F-4.3:\n    when: a WnfsInstance is already cached for the current forest CID\n    then: the cached instance is reused without reloading from the blockstore\n\n  req F-4.4:\n    when: legacy snake_case WNFS properties are found on a space\n    then: they are deleted and replaced with the current camelCase schema\n    tags: [migration]\n```\n\n## Acceptance\n\n```mdl\ntest T-1: Upload creates a wnfs:// blob\n  given: an active space and this plugin's BlobBackend registered on the ECHO Hypergraph\n  when: Blob.fromBytes is called with storage: 'wnfs'\n  then:\n    - the resulting Blob's data.uri starts with wnfs://\n    - space.properties.wnfs.privateForestCid is set\n    - block for the file is present in the local IndexedDB blockstore\n```\n\n```mdl\ntest T-2: Resolve uploaded blob via getUrl\n  given: a blob was previously uploaded and its data.uri (a wnfs:// URI) is known\n  when: BlobBackend.getUrl(spaceId, uri, contentType) is called\n  then:\n    - a blob: object URL is returned\n    - the URL can be used as an img src\n```\n\n```mdl\ntest T-3: get/has/getUrl return undefined/false when the space is not open\n  given: a wnfs:// URI whose space is not currently open\n  when: BlobBackend.get, .has, or .getUrl is called\n  then: undefined (or false for .has) is returned; no error is thrown\n```\n\n```mdl\ntest T-4: Blockstore offline queuing\n  given: the browser is offline\n  when: a block is written to the blockstore\n  then:\n    - block is saved to IndexedDB\n    - queue length increases by 1\n    - no HTTP request is made\n```\n\n```mdl\ntest T-5: Blockstore queue flushes on reconnect\n  given: blocks are queued while offline\n  when: the browser comes back online\n  then:\n    - a CAR archive containing all queued blocks is POSTed to the edge service\n    - the queue is cleared\n```\n\n```mdl\ntest T-6: New space initializes WNFS directory\n  given: a space with no WNFS properties\n  when: loadWnfs is called for that space\n  then:\n    - a new PrivateForest and PrivateDirectory are created\n    - space.properties.wnfs.privateForestCid is populated\n```\n\n```mdl\ntest T-7: WnfsInstance cache hit\n  given: a WnfsInstance is cached for the current forest CID\n  when: loadWnfs is called again for the same space\n  then: the cached instance is returned; no blockstore reads occur\n```\n\n---\n\n## Appendix: Extension Definitions\n\nExtension block types used in this document are defined below using\nthe core `ext` primitive — the only construct the base language provides.\n\n```mdl\next type\n  uri: org.dxos.mdl.type@1.0\n  desc: A named data structure with typed fields and optional literals.\n  fields:\n    desc?: Prose\n    fields?: FieldMap        # name[?]: TypeExpr  (# inline comment)\n    literals?: UnionList     # a | b | c\n    extends?: TypeRef[]\n```\n\n```mdl\next feat\n  uri: org.dxos.mdl.feat@1.0\n  desc: A named feature grouping one or more requirements.\n  fields:\n    desc?: Prose\n    req: RequirementList\n  nesting: self              # feat blocks may contain feat blocks\n```\n\n```mdl\next test\n  uri: org.dxos.mdl.test@1.0\n  desc: An acceptance scenario expressed as given / when / then steps.\n  fields:\n    given?: Step | Step[]\n    when?: Step | Step[]\n    then: Step | Step[]\n    tags?: TagList\n```\n\n```mdl\next component\n  uri: org.dxos.mdl.component@1.0\n  desc: A UI component with props, internal state, slots, actions, and events.\n  fields:\n    desc?: Prose\n    props?: FieldMap            # external inputs (immutable inside component)\n    state?: FieldMap            # internal reactive state\n    slots?: FieldMap            # named ReactNode injection points\n    actions?: ActionMap         # methods the component exposes or handles\n    emits?: EventMap            # events the component raises to its parent\n    layout?: CodeBlock          # ASCII sketch of visual structure (non-normative)\n```\n\n```mdl\next op\n  uri: org.dxos.mdl.op@1.0\n  desc: |\n    A named operation with typed inputs, outputs, and declared errors.\n    Pure ops have no effects or requires. Effectful ops declare both.\n  fields:\n    desc?: Prose\n    input?: FieldMap            # named input parameters\n    output?: TypeExpr           # return type\n    errors?: ErrorMap           # name: Prose  (when this error occurs)\n    effects?: EffectList        # echo:read | echo:write | http | fs | ...\n    requires?: ServiceList      # injected service dependencies\n    note?: Prose                # implementation guidance (non-normative)\n```\n",
+	mimeType: "application/x-mdl"
+} }), Plugin.make);
+//#endregion
+export { WnfsPlugin, WnfsPlugin as default };
+
+//# sourceMappingURL=WnfsPlugin.mjs.map

package/dist/lib/WnfsPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WnfsPlugin.mjs","names":[],"sources":["../../src/WnfsPlugin.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\nimport { ClientEvents } from '@dxos/plugin-client';\n\nimport { BlobBackend, Dependencies } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { WnfsEvents } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const WnfsPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.addModule({\n    id: 'dependencies',\n    activatesOn: ClientEvents.ClientReady,\n    firesAfterActivation: [WnfsEvents.DependenciesReady],\n    activate: Dependencies,\n  }),\n  Plugin.addModule({\n    id: 'blob-backend',\n    activatesOn: WnfsEvents.DependenciesReady,\n    activate: BlobBackend,\n  }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default WnfsPlugin;\n"],"mappings":";;;;;;;;;AAgBA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAC5C,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,aAAa;CAC1B,sBAAsB,CAAC,WAAW,iBAAiB;CACnD,UAAU;AACZ,CAAC,GACD,OAAO,UAAU;CACf,IAAI;CACJ,aAAa,WAAW;CACxB,UAAU;AACZ,CAAC,GACD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT"}

package/dist/lib/WnfsPlugin.node.mjs

@@ -0,0 +1,8 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+//#region src/WnfsPlugin.node.ts
+var WnfsPlugin = Plugin.define(meta).pipe(Plugin.make);
+//#endregion
+export { WnfsPlugin, WnfsPlugin as default };
+
+//# sourceMappingURL=WnfsPlugin.node.mjs.map

package/dist/lib/WnfsPlugin.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WnfsPlugin.node.mjs","names":[],"sources":["../../src/WnfsPlugin.node.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nexport const WnfsPlugin = Plugin.define(meta).pipe(Plugin.make);\n\nexport default WnfsPlugin;\n"],"mappings":";;;AAQA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI"}

package/dist/lib/WnfsPlugin.workerd.mjs

@@ -0,0 +1,8 @@
+import { Plugin } from "@dxos/app-framework";
+import { meta } from "#meta";
+//#region src/WnfsPlugin.workerd.ts
+var WnfsPlugin = Plugin.define(meta).pipe(Plugin.make);
+//#endregion
+export { WnfsPlugin, WnfsPlugin as default };
+
+//# sourceMappingURL=WnfsPlugin.workerd.mjs.map

package/dist/lib/WnfsPlugin.workerd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WnfsPlugin.workerd.mjs","names":[],"sources":["../../src/WnfsPlugin.workerd.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nexport const WnfsPlugin = Plugin.define(meta).pipe(Plugin.make);\n\nexport default WnfsPlugin;\n"],"mappings":";;;AAQA,IAAa,aAAa,OAAO,OAAO,IAAI,CAAC,CAAC,KAAK,OAAO,IAAI"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,8 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var BlobBackend = Capability.lazy("BlobBackend", () => import("./chunk-blob-backend.mjs"));
+var Dependencies = Capability.lazy("Dependencies", () => import("./chunk-dependencies.mjs"));
+//#endregion
+export { BlobBackend, Dependencies };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2025 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\n\nexport const BlobBackend = Capability.lazy('BlobBackend', () => import('./blob-backend'));\n\nexport const Dependencies = Capability.lazy('Dependencies', () => import('./dependencies'));\n"],"mappings":";;AAMA,IAAa,cAAc,WAAW,KAAK,qBAAqB,OAAO,2BAAiB;AAExF,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,2BAAiB"}

package/dist/lib/chunk-blob-backend.mjs

@@ -0,0 +1,118 @@
+import { i as readWnfsFile, n as getBlobUrl, o as loadWnfs, t as upload } from "./chunk-helpers.mjs";
+import { log } from "@dxos/log";
+import { Capability } from "@dxos/app-framework";
+import { ClientCapabilities } from "@dxos/plugin-client";
+import { WnfsCapabilities } from "#types";
+import * as Effect from "effect/Effect";
+import { invariant } from "@dxos/invariant";
+import { FileCapabilities } from "@dxos/plugin-file/types";
+//#region src/capabilities/blob-backend.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-wnfs/src/capabilities/blob-backend.ts";
+/**
+* Blob backend that stores bytes in a space's WNFS private forest, addressed by `wnfs://…` URIs.
+* The underlying WASM bindings (`directory.read`) don't expose a distinct not-found error type, so
+* `readBytes`/`getUrl` can't tell a missing path from a genuine transport/blockstore failure —
+* both are logged and reported as a miss (`undefined`) rather than risk rethrowing on the common
+* missing-file path.
+*/
+var createWnfsBlobBackend = ({ client, blockstore, instances }) => {
+	const readBytes = async (spaceId, uri) => {
+		const space = client.spaces.get(spaceId);
+		if (!space) return;
+		try {
+			const { directory, forest } = await loadWnfs({
+				blockstore,
+				instances,
+				space
+			});
+			return await readWnfsFile({
+				wnfsUrl: uri,
+				blockstore,
+				forest,
+				directory
+			});
+		} catch (error) {
+			log.warn("failed to read wnfs blob", {
+				spaceId,
+				uri,
+				error
+			}, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 44,
+				S: void 0
+			});
+			return;
+		}
+	};
+	return {
+		schemes: [WnfsCapabilities.WNFS_SCHEME],
+		put: async ({ spaceId, data, contentType, contentHash, name }) => {
+			const space = client.spaces.get(spaceId);
+			invariant(space, "Space not found", {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 54,
+				S: void 0,
+				A: ["space", "'Space not found'"]
+			});
+			return { uri: (await upload({
+				file: new File([data], name ?? contentHash, { type: contentType }),
+				blockstore,
+				instances,
+				space
+			})).url };
+		},
+		get: async ({ spaceId, uri }) => readBytes(spaceId, uri),
+		has: async ({ spaceId, uri }) => await readBytes(spaceId, uri) !== void 0,
+		getUrl: async ({ spaceId, uri, contentType }) => {
+			const space = client.spaces.get(spaceId);
+			if (!space) return;
+			try {
+				const { directory, forest } = await loadWnfs({
+					blockstore,
+					instances,
+					space
+				});
+				return await getBlobUrl({
+					wnfsUrl: uri,
+					blockstore,
+					directory,
+					forest,
+					type: contentType
+				});
+			} catch (error) {
+				log.warn("failed to resolve wnfs blob url", {
+					spaceId,
+					uri,
+					error
+				}, {
+					"~LogMeta": "~LogMeta",
+					F: __dxlog_file,
+					L: 76,
+					S: void 0
+				});
+				return;
+			}
+		}
+	};
+};
+var blob_backend_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	const client = yield* Capability.get(ClientCapabilities.Client);
+	const blockstore = yield* Capability.get(WnfsCapabilities.Blockstore);
+	const instances = yield* Capability.get(WnfsCapabilities.Instances);
+	const cleanup = client.graph.registerBlobBackend(WnfsCapabilities.WNFS_BACKEND, createWnfsBlobBackend({
+		client,
+		blockstore,
+		instances
+	}));
+	return Capability.contributes(FileCapabilities.Backend, {
+		name: "WNFS",
+		description: "Decentralized, end-to-end encrypted storage via Web Native File System.",
+		storage: WnfsCapabilities.WNFS_BACKEND
+	}, () => Effect.sync(() => cleanup()));
+}));
+//#endregion
+export { createWnfsBlobBackend, blob_backend_default as default };
+
+//# sourceMappingURL=chunk-blob-backend.mjs.map

package/dist/lib/chunk-blob-backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-blob-backend.mjs","names":[],"sources":["../../src/capabilities/blob-backend.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport type { Blockstore } from 'interface-blockstore';\n\nimport { Capability } from '@dxos/app-framework';\nimport { type Client } from '@dxos/client';\nimport { type BlobBackend } from '@dxos/echo-protocol';\nimport { invariant } from '@dxos/invariant';\nimport { type SpaceId } from '@dxos/keys';\nimport { log } from '@dxos/log';\nimport { ClientCapabilities } from '@dxos/plugin-client';\nimport { FileCapabilities } from '@dxos/plugin-file/types';\n\nimport { WnfsCapabilities } from '#types';\n\nimport { getBlobUrl, loadWnfs, readWnfsFile, upload } from '../helpers';\n\ninterface CreateWnfsBlobBackendOptions {\n  client: Client;\n  blockstore: Blockstore;\n  instances?: WnfsCapabilities.Instances;\n}\n\n/**\n * Blob backend that stores bytes in a space's WNFS private forest, addressed by `wnfs://…` URIs.\n * The underlying WASM bindings (`directory.read`) don't expose a distinct not-found error type, so\n * `readBytes`/`getUrl` can't tell a missing path from a genuine transport/blockstore failure —\n * both are logged and reported as a miss (`undefined`) rather than risk rethrowing on the common\n * missing-file path.\n */\nexport const createWnfsBlobBackend = ({ client, blockstore, instances }: CreateWnfsBlobBackendOptions): BlobBackend => {\n  const readBytes = async (spaceId: SpaceId, uri: string) => {\n    const space = client.spaces.get(spaceId);\n    if (!space) {\n      return undefined;\n    }\n    try {\n      const { directory, forest } = await loadWnfs({ blockstore, instances, space });\n      return await readWnfsFile({ wnfsUrl: uri, blockstore, forest, directory });\n    } catch (error) {\n      log.warn('failed to read wnfs blob', { spaceId, uri, error });\n      return undefined;\n    }\n  };\n\n  return {\n    schemes: [WnfsCapabilities.WNFS_SCHEME],\n\n    put: async ({ spaceId, data, contentType, contentHash, name }) => {\n      const space = client.spaces.get(spaceId);\n      invariant(space, 'Space not found');\n      // `Uint8Array` is generic over `ArrayBufferLike` (incl. `SharedArrayBuffer`) while DOM's\n      // `BlobPart` only covers `ArrayBuffer`-backed views — a gap between the DOM lib types and\n      // the TS standard lib, not fixable by typing `data` differently.\n      const file = new File([data as BlobPart], name ?? contentHash, { type: contentType });\n      const info = await upload({ file, blockstore, instances, space });\n      return { uri: info.url };\n    },\n\n    get: async ({ spaceId, uri }) => readBytes(spaceId, uri),\n\n    has: async ({ spaceId, uri }) => (await readBytes(spaceId, uri)) !== undefined,\n\n    getUrl: async ({ spaceId, uri, contentType }) => {\n      const space = client.spaces.get(spaceId);\n      if (!space) {\n        return undefined;\n      }\n      try {\n        const { directory, forest } = await loadWnfs({ blockstore, instances, space });\n        return await getBlobUrl({ wnfsUrl: uri, blockstore, directory, forest, type: contentType });\n      } catch (error) {\n        log.warn('failed to resolve wnfs blob url', { spaceId, uri, error });\n        return undefined;\n      }\n    },\n  };\n};\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const client = yield* Capability.get(ClientCapabilities.Client);\n    const blockstore = yield* Capability.get(WnfsCapabilities.Blockstore);\n    const instances = yield* Capability.get(WnfsCapabilities.Instances);\n\n    const cleanup = client.graph.registerBlobBackend(\n      WnfsCapabilities.WNFS_BACKEND,\n      createWnfsBlobBackend({ client, blockstore, instances }),\n    );\n\n    return Capability.contributes(\n      FileCapabilities.Backend,\n      {\n        name: 'WNFS',\n        description: 'Decentralized, end-to-end encrypted storage via Web Native File System.',\n        storage: WnfsCapabilities.WNFS_BACKEND,\n      },\n      () => Effect.sync(() => cleanup()),\n    );\n  }),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiCA,IAAa,yBAAyB,EAAE,QAAQ,YAAY,gBAA2D;CACrH,MAAM,YAAY,OAAO,SAAkB,QAAgB;EACzD,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO;EACvC,IAAI,CAAC,OACH;EAEF,IAAI;GACF,MAAM,EAAE,WAAW,WAAW,MAAM,SAAS;IAAE;IAAY;IAAW;GAAM,CAAC;GAC7E,OAAO,MAAM,aAAa;IAAE,SAAS;IAAK;IAAY;IAAQ;GAAU,CAAC;EAC3E,SAAS,OAAO;GACd,IAAI,KAAK,4BAA4B;IAAE;IAAS;IAAK;GAAM,GAAA;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,KAAA;GAAA,CAAC;GAC5D;EACF;CACF;CAEA,OAAO;EACL,SAAS,CAAC,iBAAiB,WAAW;EAEtC,KAAK,OAAO,EAAE,SAAS,MAAM,aAAa,aAAa,WAAW;GAChE,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO;GACvC,UAAU,OAAO,mBAAgB;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,KAAA;IAAA,GAAA,CAAA,SAAA,mBAAA;GAAA,CAAC;GAMlC,OAAO,EAAE,MAAK,MADK,OAAO;IAAE,MAAA,IADX,KAAK,CAAC,IAAgB,GAAG,QAAQ,aAAa,EAAE,MAAM,YAAY,CACvD;IAAM;IAAY;IAAW;GAAM,CAAC,EAAA,CAC7C,IAAI;EACzB;EAEA,KAAK,OAAO,EAAE,SAAS,UAAU,UAAU,SAAS,GAAG;EAEvD,KAAK,OAAO,EAAE,SAAS,UAAW,MAAM,UAAU,SAAS,GAAG,MAAO,KAAA;EAErE,QAAQ,OAAO,EAAE,SAAS,KAAK,kBAAkB;GAC/C,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO;GACvC,IAAI,CAAC,OACH;GAEF,IAAI;IACF,MAAM,EAAE,WAAW,WAAW,MAAM,SAAS;KAAE;KAAY;KAAW;IAAM,CAAC;IAC7E,OAAO,MAAM,WAAW;KAAE,SAAS;KAAK;KAAY;KAAW;KAAQ,MAAM;IAAY,CAAC;GAC5F,SAAS,OAAO;IACd,IAAI,KAAK,mCAAmC;KAAE;KAAS;KAAK;IAAM,GAAA;KAAA,YAAA;KAAA,GAAA;KAAA,GAAA;KAAA,GAAA,KAAA;IAAA,CAAC;IACnE;GACF;EACF;CACF;AACF;AAEA,IAAA,uBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,MAAM,SAAS,OAAO,WAAW,IAAI,mBAAmB,MAAM;CAC9D,MAAM,aAAa,OAAO,WAAW,IAAI,iBAAiB,UAAU;CACpE,MAAM,YAAY,OAAO,WAAW,IAAI,iBAAiB,SAAS;CAElE,MAAM,UAAU,OAAO,MAAM,oBAC3B,iBAAiB,cACjB,sBAAsB;EAAE;EAAQ;EAAY;CAAU,CAAC,CACzD;CAEA,OAAO,WAAW,YAChB,iBAAiB,SACjB;EACE,MAAM;EACN,aAAa;EACb,SAAS,iBAAiB;CAC5B,SACM,OAAO,WAAW,QAAQ,CAAC,CACnC;AACF,CAAC,CACH"}

package/dist/lib/chunk-dependencies.mjs

@@ -0,0 +1,146 @@
+import { d as storeName } from "./chunk-helpers.mjs";
+import { CID } from "multiformats";
+import * as Uint8Arrays from "uint8arrays";
+import { Capability } from "@dxos/app-framework";
+import { ClientCapabilities } from "@dxos/plugin-client";
+import { WnfsCapabilities } from "#types";
+import * as Effect from "effect/Effect";
+import { CarWriter } from "@ipld/car";
+import { BaseBlockstore } from "blockstore-core";
+import { IDBBlockstore } from "blockstore-idb";
+import debounce from "debounce";
+import * as IDB from "idb-keyval";
+import all from "it-all";
+//#region src/blockstore.ts
+var create = (apiHost) => {
+	return new MixedBlockstore(apiHost);
+};
+/**
+* A blockstore that communicates with the DXOS blob service,
+* and which uses an indexedDB blockstore as a client cache.
+*/
+var MixedBlockstore = class extends BaseBlockstore {
+	#apiHost;
+	#localStore;
+	#isConnected;
+	#flushQueue;
+	#queue;
+	constructor(apiHost) {
+		super();
+		this.#apiHost = apiHost ? apiHost.replace(/\/?$/, "") : void 0;
+		this.#localStore = new IDBBlockstore(storeName());
+		this.#isConnected = navigator.onLine;
+		this.#queue = [];
+		this.#flushQueue = debounce(this.#flushQueueInt, 5e3);
+	}
+	async open() {
+		await this.#localStore.open();
+		await this.#restoreQueue();
+		window.addEventListener("offline", async () => {
+			this.#isConnected = false;
+		});
+		window.addEventListener("online", async () => {
+			this.#isConnected = true;
+			this.#flushQueue();
+		});
+	}
+	url(apiHost, cid) {
+		const path = cid ? cid.toString() : "";
+		return `${apiHost}/api/file${path.length ? "/" + path : ""}`;
+	}
+	async delete(key) {
+		await this.#localStore.delete(key);
+		if (this.#isConnected && this.#apiHost) await fetch(this.url(this.#apiHost, key), { method: "DELETE" });
+	}
+	async get(key) {
+		if (await this.#localStore.has(key)) return await this.#localStore.get(key);
+		if (this.#isConnected && this.#apiHost) {
+			const block = await fetch(this.url(this.#apiHost, key), { method: "GET" }).then((r) => r.arrayBuffer()).then((r) => new Uint8Array(r));
+			await this.#localStore.put(key, block);
+			return block;
+		}
+		return await this.#localStore.get(key);
+	}
+	async has(key) {
+		if (await this.#localStore.has(key)) return true;
+		if (this.#isConnected && this.#apiHost) return await fetch(this.url(this.#apiHost, key), { method: "HEAD" }).then((r) => r.ok);
+		return false;
+	}
+	async put(key, val) {
+		await this.#localStore.put(key, val);
+		await this.#addToQueue(key);
+		this.#flushQueue();
+		return key;
+	}
+	async destroy() {
+		await this.#localStore.destroy();
+	}
+	async putRemote(key, val) {
+		if (this.#apiHost) await fetch(this.url(this.#apiHost, key), {
+			method: "POST",
+			body: val
+		});
+	}
+	async putCarRemote(car) {
+		if (this.#apiHost) await fetch(this.url(this.#apiHost), {
+			method: "POST",
+			headers: { "Content-Type": "application/vnd.ipld.car" },
+			body: car
+		});
+	}
+	queueCacheName = `${storeName()}.state.queue`;
+	async #addToQueue(key) {
+		await this.#saveQueue([...this.#queue, key.toString()]);
+	}
+	async #flushQueueInt() {
+		if (!this.#isConnected || !this.#apiHost) return;
+		const keys = [...this.#queue];
+		if (keys.length === 0) return;
+		const blocks = await Promise.all(keys.map(async (key) => {
+			const cid = CID.parse(key);
+			return {
+				cid,
+				bytes: await this.#localStore.get(cid)
+			};
+		}));
+		const car = await this.#createCar(blocks);
+		await this.putCarRemote(car);
+		const queue = [...this.#queue].filter((k) => {
+			if (keys.includes(k)) return false;
+			return true;
+		});
+		await this.#saveQueue(queue);
+	}
+	async #restoreQueue() {
+		const fromCache = await IDB.get(this.queueCacheName);
+		if (fromCache && Array.isArray(fromCache)) {
+			this.#queue = fromCache;
+			this.#flushQueue();
+		}
+	}
+	async #saveQueue(items) {
+		const arr = [...items];
+		this.#queue = arr;
+		await IDB.set(this.queueCacheName, arr);
+	}
+	async #createCar(blocks) {
+		const { writer, out } = CarWriter.create();
+		const outPromise = all(out);
+		await Promise.all(blocks.map((block) => {
+			return writer.put(block);
+		}));
+		await writer.close();
+		return Uint8Arrays.concat(await outPromise);
+	}
+};
+//#endregion
+//#region src/capabilities/dependencies.ts
+var dependencies_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	const blockstore = create((yield* Capability.get(ClientCapabilities.Client)).config.values.runtime?.services?.edge?.url || "http://localhost:8787");
+	yield* Effect.tryPromise(() => blockstore.open());
+	return [Capability.contributes(WnfsCapabilities.Blockstore, blockstore), Capability.contributes(WnfsCapabilities.Instances, {})];
+}));
+//#endregion
+export { dependencies_default as default };
+
+//# sourceMappingURL=chunk-dependencies.mjs.map

package/dist/lib/chunk-dependencies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-dependencies.mjs","names":[],"sources":["../../src/blockstore.ts","../../src/capabilities/dependencies.ts"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport { CarWriter } from '@ipld/car';\nimport type { Block } from '@ipld/car/reader';\nimport { BaseBlockstore } from 'blockstore-core';\nimport { IDBBlockstore } from 'blockstore-idb';\nimport debounce from 'debounce';\nimport * as IDB from 'idb-keyval';\nimport all from 'it-all';\nimport { CID } from 'multiformats';\nimport * as Uint8Arrays from 'uint8arrays';\n\nimport { storeName } from './helpers';\n\nexport const create = (apiHost?: string) => {\n  return new MixedBlockstore(apiHost);\n};\n\n/**\n * A blockstore that communicates with the DXOS blob service,\n * and which uses an indexedDB blockstore as a client cache.\n */\nexport class MixedBlockstore extends BaseBlockstore {\n  readonly #apiHost: string | undefined;\n  readonly #localStore: IDBBlockstore;\n\n  #isConnected: boolean;\n  #flushQueue: () => void;\n  #queue: string[];\n\n  constructor(apiHost?: string) {\n    super();\n\n    this.#apiHost = apiHost ? apiHost.replace(/\\/?$/, '') : undefined;\n    this.#localStore = new IDBBlockstore(storeName());\n    this.#isConnected = navigator.onLine;\n    this.#queue = [];\n\n    this.#flushQueue = debounce(this.#flushQueueInt, 5000);\n  }\n\n  async open(): Promise<void> {\n    await this.#localStore.open();\n    await this.#restoreQueue();\n\n    window.addEventListener('offline', async () => {\n      this.#isConnected = false;\n    });\n\n    window.addEventListener('online', async () => {\n      this.#isConnected = true;\n      this.#flushQueue();\n    });\n  }\n\n  url(apiHost: string, cid?: CID): string {\n    const path = cid ? cid.toString() : '';\n    return `${apiHost}/api/file${path.length ? '/' + path : ''}`;\n  }\n\n  // BLOCKSTORE IMPLEMENTATION\n\n  override async delete(key: CID): Promise<void> {\n    await this.#localStore.delete(key);\n\n    if (this.#isConnected && this.#apiHost) {\n      await fetch(this.url(this.#apiHost, key), {\n        method: 'DELETE',\n      });\n    }\n  }\n\n  override async get(key: CID): Promise<Uint8Array> {\n    if (await this.#localStore.has(key)) {\n      return await this.#localStore.get(key);\n    }\n\n    if (this.#isConnected && this.#apiHost) {\n      const block = await fetch(this.url(this.#apiHost, key), {\n        method: 'GET',\n      })\n        .then((r) => r.arrayBuffer())\n        .then((r) => new Uint8Array(r));\n\n      // Make sure it is cached locally\n      await this.#localStore.put(key, block);\n\n      return block;\n    }\n\n    return await this.#localStore.get(key);\n  }\n\n  override async has(key: CID): Promise<boolean> {\n    if (await this.#localStore.has(key)) {\n      return true;\n    }\n\n    if (this.#isConnected && this.#apiHost) {\n      return await fetch(this.url(this.#apiHost, key), {\n        method: 'HEAD',\n      }).then((r) => r.ok);\n    }\n\n    return false;\n  }\n\n  override async put(key: CID, val: Uint8Array): Promise<CID> {\n    await this.#localStore.put(key, val);\n\n    await this.#addToQueue(key);\n    this.#flushQueue();\n\n    return key;\n  }\n\n  async destroy(): Promise<void> {\n    await this.#localStore.destroy();\n  }\n\n  // REMOTE\n\n  async putRemote(key: CID, val: Uint8Array): Promise<void> {\n    if (this.#apiHost) {\n      await fetch(this.url(this.#apiHost, key), {\n        method: 'POST',\n        body: val as Uint8Array<ArrayBuffer>,\n      });\n    }\n  }\n\n  async putCarRemote(car: Uint8Array): Promise<void> {\n    if (this.#apiHost) {\n      await fetch(this.url(this.#apiHost), {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/vnd.ipld.car',\n        },\n        body: car as Uint8Array<ArrayBuffer>,\n      });\n    }\n  }\n\n  // QUEUE\n\n  readonly queueCacheName = `${storeName()}.state.queue`;\n\n  async #addToQueue(key: CID): Promise<void> {\n    await this.#saveQueue([...this.#queue, key.toString()]);\n  }\n\n  async #flushQueueInt(): Promise<void> {\n    if (!this.#isConnected || !this.#apiHost) {\n      return;\n    }\n\n    const keys = [...this.#queue];\n    if (keys.length === 0) {\n      return;\n    }\n\n    // Collect blocks\n    const blocks = await Promise.all(\n      keys.map(async (key) => {\n        const cid = CID.parse(key);\n        const bytes = await this.#localStore.get(cid);\n        return { cid, bytes };\n      }),\n    );\n\n    // Create & submit CAR\n    const car = await this.#createCar(blocks);\n    await this.putCarRemote(car);\n\n    // Adjust queue\n    const queue = [...this.#queue].filter((k) => {\n      if (keys.includes(k)) {\n        return false;\n      }\n\n      return true;\n    });\n\n    await this.#saveQueue(queue);\n  }\n\n  async #restoreQueue(): Promise<void> {\n    const fromCache = await IDB.get(this.queueCacheName);\n    if (fromCache && Array.isArray(fromCache)) {\n      this.#queue = fromCache;\n      this.#flushQueue();\n    }\n  }\n\n  async #saveQueue(items: string[]): Promise<void> {\n    const arr = [...items];\n    this.#queue = arr;\n    await IDB.set(this.queueCacheName, arr);\n  }\n\n  // 🛠️\n\n  async #createCar(blocks: Block[]): Promise<Uint8Array> {\n    const { writer, out } = CarWriter.create();\n    const outPromise = all(out);\n\n    await Promise.all(\n      blocks.map((block) => {\n        return writer.put(block);\n      }),\n    );\n\n    await writer.close();\n    return Uint8Arrays.concat(await outPromise);\n  }\n}\n","//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { ClientCapabilities } from '@dxos/plugin-client';\n\nimport { WnfsCapabilities } from '#types';\n\nimport * as Blockstore from '../blockstore';\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    const client = yield* Capability.get(ClientCapabilities.Client);\n    const apiHost = client.config.values.runtime?.services?.edge?.url || 'http://localhost:8787';\n    const blockstore = Blockstore.create(apiHost);\n    yield* Effect.tryPromise(() => blockstore.open());\n\n    const instances: WnfsCapabilities.Instances = {};\n\n    return [\n      Capability.contributes(WnfsCapabilities.Blockstore, blockstore),\n      Capability.contributes(WnfsCapabilities.Instances, instances),\n    ];\n  }),\n);\n"],"mappings":"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"}