@dxos/plugin-wnfs 0.8.4-main.4a85c3132b → 0.8.4-main.4f23b4e393

package/src/extensions/image.stories.tsx

@@ -6,12 +6,12 @@ import { type Meta, type StoryObj } from '@storybook/react-vite';
 import type { Blockstore } from 'interface-blockstore';
 import React, { type ChangeEvent, useEffect, useState } from 'react';
 
-import { faker } from '@dxos/random';
-import { useSpace } from '@dxos/react-client/echo';
+import { random } from '@dxos/random';
+import { useSpaces } from '@dxos/react-client/echo';
 import { withClientProvider } from '@dxos/react-client/testing';
 import { useThemeContext } from '@dxos/react-ui';
-import { withTheme } from '@dxos/react-ui/testing';
 import { useTextEditor } from '@dxos/react-ui-editor';
+import { withTheme } from '@dxos/react-ui/testing';
 import {
   createBasicExtensions,
   createMarkdownExtensions,
@@ -22,16 +22,15 @@ import {
 
 import { create as createBlockstore } from '../blockstore';
 import { upload } from '../helpers';
-
 import { image } from './image';
 
-faker.seed(1);
-const initialValue = faker.lorem.paragraphs(100);
+random.seed(1);
+const initialValue = random.lorem.paragraphs(100);
 const instances = {};
 
 const DefaultStory = () => {
   const { themeMode } = useThemeContext();
-  const space = useSpace();
+  const [space] = useSpaces();
   const [blockstore, setBlockstore] = useState<Blockstore>();
 
   useEffect(() => {

package/src/extensions/image.tsx

@@ -15,8 +15,9 @@ import { focusField } from '@dxos/ui-editor';
 import { defaultTx } from '@dxos/ui-theme';
 import { type MaybePromise } from '@dxos/util';
 
+import { type WnfsCapabilities } from '#types';
+
 import { getBlobUrl, getPathFromUrl, loadWnfs } from '../helpers';
-import { type WnfsCapabilities } from '../types';
 
 const WAIT_UNTIL_LOADER = 1500;
 

package/src/helpers/load.ts

@@ -10,7 +10,7 @@ import { AccessKey, PrivateDirectory, PrivateForest, PrivateNode } from 'wnfs';
 import { Obj } from '@dxos/echo';
 import { type Space } from '@dxos/react-client/echo';
 
-import { type WnfsCapabilities } from '../types';
+import { type WnfsCapabilities } from '#types';
 
 import { Rng, store } from './common';
 
@@ -30,9 +30,9 @@ export const loadWnfs = async ({
   // TODO(wittjosiah): Remove.
   // Delete old properties if they exist.
   if (space.properties.wnfs_access_key !== undefined && space.properties.wnfs_private_forest_cid !== undefined) {
-    Obj.change(space.properties, (p) => {
-      delete p['wnfs_access_key'];
-      delete p['wnfs_private_forest_cid'];
+    Obj.update(space.properties, (obj) => {
+      delete obj['wnfs_access_key'];
+      delete obj['wnfs_private_forest_cid'];
     });
   }
 
@@ -68,8 +68,8 @@ const createWnfsDir = async (blockstore: Blockstore, space: Space) => {
 
   const cidBytes = await newForest.store(wnfsStore);
 
-  Obj.change(space.properties, (p) => {
-    p.wnfs = {
+  Obj.update(space.properties, (obj) => {
+    obj.wnfs = {
       accessKey: Uint8Arrays.toString(accessKeyRaw.toBytes(), 'base64'),
       privateForestCid: CID.decode(cidBytes).toString(),
     };

package/src/helpers/upload.ts

@@ -11,7 +11,7 @@ import type { Space } from '@dxos/client/echo';
 import { Obj } from '@dxos/echo';
 import { log } from '@dxos/log';
 
-import { type WnfsCapabilities } from '../types';
+import { type WnfsCapabilities } from '#types';
 
 import { Rng, filePath, store } from './common';
 import { loadWnfs } from './load';
@@ -47,8 +47,8 @@ export const upload = async ({
   const cidBytes = await updatedForest.store(wnfsStore);
 
   // Update the forest pointer on the associated space.
-  Obj.change(space.properties, (p) => {
-    p.wnfs.privateForestCid = CID.decode(cidBytes).toString();
+  Obj.update(space.properties, (obj) => {
+    obj.wnfs.privateForestCid = CID.decode(cidBytes).toString();
   });
 
   // Generate `wnfs://` URL & return the info.

package/src/index.ts

@@ -2,6 +2,6 @@
 // Copyright 2024 DXOS.org
 //
 
-export { WnfsCapabilities } from './types';
+export * from './helpers';
 export * from './meta';
-export * from './WnfsPlugin';
+export * from './types';

package/src/meta.ts

@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
 import { trim } from '@dxos/util';
 
 export const meta: Plugin.Meta = {
-  id: 'dxos.org/plugin/wnfs',
+  id: 'org.dxos.plugin.wnfs',
   name: 'WNFS',
   description: trim`
     Decentralized file storage using the Web Native File System protocol.

package/src/operations/create-file.ts

@@ -0,0 +1,30 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { invariant } from '@dxos/invariant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+
+import { upload } from '../helpers';
+import { WnfsCapabilities, WnfsFile, WnfsOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof WnfsOperation.CreateFile> = WnfsOperation.CreateFile.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ file, db }) {
+      const client = yield* Capability.get(ClientCapabilities.Client);
+      const blockstore = yield* Capability.get(WnfsCapabilities.Blockstore);
+      const space = client.spaces.get(db.spaceId);
+      invariant(space, 'Space not found');
+      const info = yield* Effect.promise(() => upload({ file, blockstore, space }));
+      return {
+        object: WnfsFile.make({ name: info.name, type: info.type, cid: info.cid }),
+      };
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/create.ts

@@ -0,0 +1,21 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Operation } from '@dxos/compute';
+
+import { WnfsFile, WnfsOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof WnfsOperation.Create> = WnfsOperation.Create.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ name, type, cid }) {
+      return {
+        object: WnfsFile.make({ name, type, cid }),
+      };
+    }),
+  ),
+);
+
+export default handler;

package/src/operations/index.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { OperationHandlerSet } from '@dxos/compute';
+
+export const WnfsOperationHandlerSet = OperationHandlerSet.lazy(
+  () => import('./create'),
+  () => import('./create-file'),
+  () => import('./upload'),
+);

package/src/operations/upload.ts

@@ -0,0 +1,28 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Capability } from '@dxos/app-framework';
+import { Operation } from '@dxos/compute';
+import { invariant } from '@dxos/invariant';
+import { ClientCapabilities } from '@dxos/plugin-client';
+
+import { upload } from '../helpers';
+import { WnfsCapabilities, WnfsOperation } from '../types';
+
+const handler: Operation.WithHandler<typeof WnfsOperation.Upload> = WnfsOperation.Upload.pipe(
+  Operation.withHandler(
+    Effect.fnUntraced(function* ({ file, db }) {
+      const client = yield* Capability.get(ClientCapabilities.Client);
+      const blockstore = yield* Capability.get(WnfsCapabilities.Blockstore);
+      const space = client.spaces.get(db.spaceId);
+      invariant(space, 'Space not found');
+      const info = yield* Effect.promise(() => upload({ file, blockstore, space }));
+      return info;
+    }),
+  ),
+);
+
+export default handler;

package/src/plugin.ts

@@ -0,0 +1,11 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+
+import { meta } from './meta';
+
+export const WnfsPlugin = Plugin.lazy(meta, () => import('#plugin'));
+
+export { WnfsOperationHandlerSet } from './operations';

package/src/translations.ts

@@ -4,25 +4,26 @@
 
 import { type Resource } from '@dxos/react-ui';
 
-import { meta } from './meta';
-import { WnfsFile } from './types';
+import { meta } from '#meta';
+import { WnfsFile } from '#types';
 
 export const translations = [
   {
     'en-US': {
-      [WnfsFile.File.typename]: {
-        'typename label': 'File',
-        'typename label_zero': 'Files',
-        'typename label_one': 'File',
-        'typename label_other': 'Files',
-        'object name placeholder': 'New file',
-        'rename object label': 'Rename file',
-        'delete object label': 'Delete file',
-        'object deleted label': 'File deleted',
+      [WnfsFile.WnfsFile.typename]: {
+        'typename.label': 'File',
+        'typename.label_zero': 'Files',
+        'typename.label_one': 'File',
+        'typename.label_other': 'Files',
+        'object-name.placeholder': 'New file',
+        'add-object.label': 'Add file',
+        'rename-object.label': 'Rename file',
+        'delete-object.label': 'Delete file',
+        'object-deleted.label': 'File deleted',
       },
       [meta.id]: {
-        'plugin name': 'Files',
-        'file input placeholder': 'Drop a file here, or click to select a file',
+        'plugin.name': 'Files',
+        'file-input.placeholder': 'Drop a file here, or click to select a file',
       },
     },
   },

package/src/types/WnfsCapabilities.ts

@@ -0,0 +1,18 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import { type Blockstore as BlockstoreInterface } from 'interface-blockstore';
+import { type PrivateDirectory, type PrivateForest } from 'wnfs';
+
+import { Capability } from '@dxos/app-framework';
+import { type SpaceId } from '@dxos/keys';
+
+import { meta } from '#meta';
+
+export const Blockstore = Capability.make<BlockstoreInterface>(`${meta.id}.capability.blockstore`);
+
+export type Instances = Record<SpaceId, { directory: PrivateDirectory; forest: PrivateForest }>;
+export const Instances = Capability.make<Instances>(`${meta.id}.capability.instances`);

package/src/types/{File.ts → WnfsFile.ts}

@@ -2,23 +2,29 @@
 // Copyright 2024 DXOS.org
 //
 
+// @import-as-namespace
+
 import * as Schema from 'effect/Schema';
 
-import { Obj, Type } from '@dxos/echo';
+import { Annotation, Obj, Type } from '@dxos/echo';
 import { FormInputAnnotation } from '@dxos/echo/internal';
 
-export const File = Schema.Struct({
+export const WnfsFile = Schema.Struct({
   name: Schema.String.pipe(Schema.optional),
   type: Schema.String.pipe(FormInputAnnotation.set(false)),
   cid: Schema.String.pipe(FormInputAnnotation.set(false)),
   timestamp: Schema.String.pipe(FormInputAnnotation.set(false), Schema.optional),
 }).pipe(
   Type.object({
-    typename: 'dxos.org/type/File',
+    typename: 'org.dxos.type.file',
     version: '0.1.0',
   }),
+  Annotation.IconAnnotation.set({
+    icon: 'ph--file--regular',
+    hue: 'teal',
+  }),
 );
 
-export type File = Schema.Schema.Type<typeof File>;
+export type WnfsFile = Schema.Schema.Type<typeof WnfsFile>;
 
-export const make = (props: Obj.MakeProps<typeof File>) => Obj.make(File, props);
+export const make = (props: Obj.MakeProps<typeof WnfsFile>) => Obj.make(WnfsFile, props);

package/src/types/WnfsOperation.ts

@@ -0,0 +1,44 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+// @import-as-namespace
+
+import * as Schema from 'effect/Schema';
+
+import { Capability } from '@dxos/app-framework';
+import { FileInfoSchema } from '@dxos/app-toolkit';
+import { Operation } from '@dxos/compute';
+import { Database } from '@dxos/echo';
+
+import { meta } from '#meta';
+
+import { WnfsAction } from './types';
+import * as WnfsFile from './WnfsFile';
+
+const WNFS_OPERATION = `${meta.id}.operation`;
+
+export const Create = Operation.make({
+  meta: { key: `${WNFS_OPERATION}.create`, name: 'Create WNFS File' },
+  services: [Capability.Service],
+  input: FileInfoSchema.pick('name', 'type', 'cid').pipe(Schema.required),
+  output: Schema.Struct({
+    object: WnfsFile.WnfsFile,
+  }),
+});
+
+export const Upload = Operation.make({
+  meta: { key: `${WNFS_OPERATION}.upload`, name: 'Upload File' },
+  services: [Capability.Service],
+  input: Schema.extend(WnfsAction.UploadFileSchema, Schema.Struct({ db: Database.Database })),
+  output: Schema.required(FileInfoSchema),
+});
+
+export const CreateFile = Operation.make({
+  meta: { key: `${WNFS_OPERATION}.create-file`, name: 'Create File' },
+  services: [Capability.Service],
+  input: Schema.extend(WnfsAction.UploadFileSchema, Schema.Struct({ db: Database.Database })),
+  output: Schema.Struct({
+    object: WnfsFile.WnfsFile,
+  }),
+});

package/src/types/index.ts

@@ -2,6 +2,8 @@
 // Copyright 2024 DXOS.org
 //
 
-export * from './capabilities';
-export * as WnfsFile from './File';
 export * from './types';
+
+export * as WnfsCapabilities from './WnfsCapabilities';
+export * as WnfsFile from './WnfsFile';
+export * as WnfsOperation from './WnfsOperation';

package/src/types/types.ts

@@ -4,22 +4,13 @@
 
 import * as Schema from 'effect/Schema';
 
-import { Capability } from '@dxos/app-framework';
-import { FileInfoSchema } from '@dxos/app-toolkit';
-import { Database } from '@dxos/echo';
-import { Collection } from '@dxos/echo';
-import { Operation } from '@dxos/operation';
-import { SpaceSchema } from '@dxos/react-client/echo';
-
-import { meta } from '../meta';
-
-import * as File from './File';
+import { meta } from '#meta';
 
 export namespace WnfsAction {
-  export const UploadAnnotationId = Symbol.for(`${meta.id}/annotation/upload`);
+  export const UploadAnnotationId = Symbol.for(`${meta.id}.annotation.upload`);
 
   export const UploadFileSchema = Schema.Struct({
-    file: Schema.instanceOf(File.File).annotations({
+    file: Schema.instanceOf(File).annotations({
       [UploadAnnotationId]: {
         // Accept file types.
         'image/*': ['.jpg', '.jpeg', '.png', '.gif'],
@@ -31,51 +22,3 @@ export namespace WnfsAction {
 
   export type UploadFileForm = Schema.Schema.Type<typeof UploadFileSchema>;
 }
-
-const WNFS_OPERATION = `${meta.id}/operation`;
-
-export namespace WnfsOperation {
-  export const OnCreateSpace = Operation.make({
-    meta: { key: `${WNFS_OPERATION}/on-create-space`, name: 'On Create Space' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.Struct({
-        space: SpaceSchema,
-        rootCollection: Collection.Collection,
-        isDefault: Schema.optional(Schema.Boolean),
-      }),
-      output: Schema.Void,
-    },
-  });
-
-  export const Create = Operation.make({
-    meta: { key: `${WNFS_OPERATION}/create`, name: 'Create WNFS File' },
-    services: [Capability.Service],
-    schema: {
-      input: FileInfoSchema.pick('name', 'type', 'cid').pipe(Schema.required),
-      output: Schema.Struct({
-        object: File.File,
-      }),
-    },
-  });
-
-  export const Upload = Operation.make({
-    meta: { key: `${WNFS_OPERATION}/upload`, name: 'Upload File' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.extend(WnfsAction.UploadFileSchema, Schema.Struct({ db: Database.Database })),
-      output: Schema.required(FileInfoSchema),
-    },
-  });
-
-  export const CreateFile = Operation.make({
-    meta: { key: `${WNFS_OPERATION}/create-file`, name: 'Create File' },
-    services: [Capability.Service],
-    schema: {
-      input: Schema.extend(WnfsAction.UploadFileSchema, Schema.Struct({ db: Database.Database })),
-      output: Schema.Struct({
-        object: File.File,
-      }),
-    },
-  });
-}

package/dist/lib/browser/FileContainer-EILNV5LV.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/containers/FileContainer/FileContainer.tsx", "../../../src/containers/FileContainer/index.ts"],
-  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport React, { useState } from 'react';\n\nimport { useCapability } from '@dxos/app-framework/ui';\nimport { type SurfaceComponentProps } from '@dxos/app-toolkit/ui';\nimport { invariant } from '@dxos/invariant';\nimport { getSpace } from '@dxos/react-client/echo';\nimport { Panel, useAsyncEffect } from '@dxos/react-ui';\n\nimport { FilePreview } from '../../components';\nimport { filePath, getBlobUrl, loadWnfs, wnfsUrl } from '../../helpers';\nimport { WnfsCapabilities, type WnfsFile } from '../../types';\n\nexport type FileContainerProps = SurfaceComponentProps<WnfsFile.File>;\n\nexport const FileContainer = ({ role, subject: file }: FileContainerProps) => {\n  const blockstore = useCapability(WnfsCapabilities.Blockstore);\n  const instances = useCapability(WnfsCapabilities.Instances);\n  const [blobUrl, setBlobUrl] = useState<string>();\n\n  useAsyncEffect(async () => {\n    const space = getSpace(file);\n    invariant(space);\n    const { directory, forest } = await loadWnfs({\n      blockstore,\n      instances,\n      space,\n    });\n    const path = filePath(file.cid.toString(), space);\n    const url = await getBlobUrl({\n      wnfsUrl: wnfsUrl(path),\n      blockstore,\n      directory,\n      forest,\n      type: file.type,\n    });\n    setBlobUrl(url);\n  }, [file]);\n\n  if (!blobUrl) {\n    return null;\n  }\n\n  return (\n    <Panel.Root role={role} className='dx-article'>\n      <Panel.Content asChild>\n        <Panel.Content asChild>\n          <FilePreview type={file.type} url={blobUrl} />\n        </Panel.Content>\n      </Panel.Content>\n    </Panel.Root>\n  );\n};\n\nexport default FileContainer;\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { FileContainer } from './FileContainer';\n\nexport default FileContainer;\n"],
-  "mappings": ";;;;;;;;;;;;;;AAIA,OAAOA,SAASC,gBAAgB;AAEhC,SAASC,qBAAqB;AAE9B,SAASC,iBAAiB;AAC1B,SAASC,gBAAgB;AACzB,SAASC,OAAOC,sBAAsB;;AAQ/B,IAAMC,gBAAgB,CAAC,EAAEC,MAAMC,SAASC,KAAI,MAAsB;AACvE,QAAMC,aAAaC,cAAcC,iBAAiBC,UAAU;AAC5D,QAAMC,YAAYH,cAAcC,iBAAiBG,SAAS;AAC1D,QAAM,CAACC,SAASC,UAAAA,IAAcC,SAAAA;AAE9BC,iBAAe,YAAA;AACb,UAAMC,QAAQC,SAASZ,IAAAA;AACvBa,cAAUF,OAAAA,QAAAA;;;;;;;;;AACV,UAAM,EAAEG,WAAWC,OAAM,IAAK,MAAMC,SAAS;MAC3Cf;MACAI;MACAM;IACF,CAAA;AACA,UAAMM,OAAOC,SAASlB,KAAKmB,IAAIC,SAAQ,GAAIT,KAAAA;AAC3C,UAAMU,MAAM,MAAMC,WAAW;MAC3BC,SAASA,QAAQN,IAAAA;MACjBhB;MACAa;MACAC;MACAS,MAAMxB,KAAKwB;IACb,CAAA;AACAhB,eAAWa,GAAAA;EACb,GAAG;IAACrB;GAAK;AAET,MAAI,CAACO,SAAS;AACZ,WAAO;EACT;AAEA,SACE,sBAAA,cAACkB,MAAMC,MAAI;IAAC5B;IAAY6B,WAAU;KAChC,sBAAA,cAACF,MAAMG,SAAO;IAACC,SAAAA;KACb,sBAAA,cAACJ,MAAMG,SAAO;IAACC,SAAAA;KACb,sBAAA,cAACC,aAAAA;IAAYN,MAAMxB,KAAKwB;IAAMH,KAAKd;;AAK7C;;;ACjDA,IAAA,wBAAewB;",
-  "names": ["React", "useState", "useCapability", "invariant", "getSpace", "Panel", "useAsyncEffect", "FileContainer", "role", "subject", "file", "blockstore", "useCapability", "WnfsCapabilities", "Blockstore", "instances", "Instances", "blobUrl", "setBlobUrl", "useState", "useAsyncEffect", "space", "getSpace", "invariant", "directory", "forest", "loadWnfs", "path", "filePath", "cid", "toString", "url", "getBlobUrl", "wnfsUrl", "type", "Panel", "Root", "className", "Content", "asChild", "FilePreview", "FileContainer"]
-}

package/dist/lib/browser/blockstore-Q66HQJ4Q.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/capabilities/blockstore/blockstore.ts", "../../../src/blockstore.ts"],
-  "sourcesContent": ["//\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 * as Blockstore from '../../blockstore';\nimport { WnfsCapabilities } from '../../types';\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    return Capability.contributes(WnfsCapabilities.Blockstore, blockstore);\n  }),\n);\n", "//\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"],
-  "mappings": "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",
-  "names": ["Effect", "Capability", "ClientCapabilities", "CarWriter", "BaseBlockstore", "IDBBlockstore", "debounce", "IDB", "all", "CID", "Uint8Arrays", "create", "apiHost", "MixedBlockstore", "BaseBlockstore", "replace", "undefined", "IDBBlockstore", "storeName", "navigator", "onLine", "debounce", "open", "window", "addEventListener", "url", "cid", "path", "toString", "length", "delete", "key", "fetch", "method", "get", "has", "block", "then", "r", "arrayBuffer", "Uint8Array", "put", "ok", "val", "destroy", "putRemote", "body", "putCarRemote", "car", "headers", "queueCacheName", "keys", "blocks", "Promise", "all", "map", "CID", "parse", "bytes", "queue", "filter", "k", "includes", "fromCache", "Array", "isArray", "items", "arr", "set", "writer", "out", "CarWriter", "outPromise", "close", "concat", "Capability", "makeModule", "fnUntraced", "client", "get", "ClientCapabilities", "Client", "apiHost", "config", "values", "runtime", "services", "edge", "url", "blockstore", "create", "tryPromise", "open", "contributes", "WnfsCapabilities", "Blockstore"]
-}