@bendyline/docblocks 1.1.2 → 2.1.0

package/dist/index-pgBHBQ9G.d.ts

@@ -1,213 +0,0 @@
-/**
- * FileSystemProvider — abstract interface for a virtual filesystem.
- *
- * Implementations back onto IndexedDB (for browser-local storage) or
- * the File System Access API (for native folder access).
- */
-interface FileEntry {
-    kind: 'file';
-    name: string;
-    path: string;
-}
-interface FolderEntry {
-    kind: 'directory';
-    name: string;
-    path: string;
-}
-type FileSystemEntry = FileEntry | FolderEntry;
-interface FileMeta {
-    name: string;
-    path: string;
-    size: number;
-    lastModified: string;
-}
-interface FileSystemProvider {
-    /** Unique identifier for this provider instance. */
-    readonly id: string;
-    /** Human-readable label (e.g., folder name or "Browser Storage"). */
-    readonly label: string;
-    /** Read the text content of a file. Returns null if the file doesn't exist. */
-    readFile(path: string): Promise<string | null>;
-    /** Write text content to a file, creating it (and parent dirs) if needed. */
-    writeFile(path: string, content: string): Promise<void>;
-    /** Delete a file or empty directory. */
-    delete(path: string): Promise<void>;
-    /** Rename or move an entry. */
-    rename(oldPath: string, newPath: string): Promise<void>;
-    /** List immediate children of a directory. */
-    readDirectory(path: string): Promise<FileSystemEntry[]>;
-    /** Check whether a path exists. */
-    exists(path: string): Promise<boolean>;
-    /** Create a directory (and parents if needed). */
-    createDirectory(path: string): Promise<void>;
-    /** Get metadata for a file. Returns null if not found. */
-    stat(path: string): Promise<FileMeta | null>;
-    /** Read raw binary content. Returns null if not found. */
-    readBinary(path: string): Promise<ArrayBuffer | null>;
-    /** Write raw binary content. */
-    writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
-}
-
-/**
- * DocBlocksHostAPI — the contract exposed by the Electron desktop shell
- * to its renderer process via contextBridge.
- *
- * This file is the single source of truth for the host ↔ renderer
- * bridge. The Electron preload script exposes an implementation matching
- * this shape; the React renderer calls it through `window.docBlocksHost`.
- */
-
-/** Filesystem operations scoped to a registered absolute root path. */
-interface DocBlocksHostFsAPI {
-    readFile(rootPath: string, path: string): Promise<string | null>;
-    writeFile(rootPath: string, path: string, content: string): Promise<void>;
-    delete(rootPath: string, path: string): Promise<void>;
-    rename(rootPath: string, oldPath: string, newPath: string): Promise<void>;
-    readDirectory(rootPath: string, path: string): Promise<FileSystemEntry[]>;
-    exists(rootPath: string, path: string): Promise<boolean>;
-    createDirectory(rootPath: string, path: string): Promise<void>;
-    stat(rootPath: string, path: string): Promise<FileMeta | null>;
-    readBinary(rootPath: string, path: string): Promise<ArrayBuffer | null>;
-    writeBinary(rootPath: string, path: string, data: ArrayBuffer | Uint8Array): Promise<void>;
-    /**
-     * Subscribe to change notifications for a watched root. Returns an
-     * unsubscribe function. The main process uses chokidar under the hood.
-     */
-    watch(rootPath: string, onChange: (path: string) => void): () => void;
-}
-/** Descriptor returned for an Electron-managed workspace (backed by a folder). */
-interface ElectronWorkspaceInfo {
-    id: string;
-    name: string;
-    rootPath: string;
-}
-/** Workspace-management operations exposed to the renderer. */
-interface DocBlocksHostWorkspacesAPI {
-    /**
-     * Return the default workspace (creating ~/Documents/DocBlocks on first
-     * call, or the user's configured default).
-     */
-    getDefault(): Promise<ElectronWorkspaceInfo>;
-    /**
-     * Open the native folder picker. Returns null if the user cancels.
-     * The selected folder is registered in the main process whitelist.
-     */
-    pickFolder(): Promise<ElectronWorkspaceInfo | null>;
-    /**
-     * Re-register a previously known workspace so its rootPath is trusted
-     * for subsequent fs calls. Called on app startup for persisted
-     * electron-native workspaces before any fs operation.
-     */
-    register(info: ElectronWorkspaceInfo): Promise<void>;
-    /** Remove a workspace from the trusted whitelist. */
-    unregister(id: string): Promise<void>;
-}
-/** Shell operations — reveal in Finder/Explorer, open external URLs. */
-interface DocBlocksHostShellAPI {
-    /** Reveal a file (by absolute path) in the OS file manager. */
-    revealInFolder(absolutePath: string): Promise<void>;
-    /** Open a URL in the default browser. */
-    openExternal(url: string): Promise<void>;
-}
-/** System ffmpeg detection and invocation. */
-interface DocBlocksHostFfmpegAPI {
-    /** True if `ffmpeg` is available on PATH (or bundled). */
-    available(): Promise<boolean>;
-    /** Version string from `ffmpeg -version`, or null if unavailable. */
-    version(): Promise<string | null>;
-    /**
-     * Render a markdown file at the given absolute path to MP4 using the
-     * existing squisq-video CLI pipeline. Returns the absolute path to the
-     * produced MP4 file, or throws on failure.
-     */
-    renderVideo(markdownAbsolutePath: string, options: {
-        fps?: number;
-        quality?: 'draft' | 'normal' | 'high';
-    }): Promise<string>;
-}
-/** Auto-updater control. */
-interface DocBlocksHostUpdaterAPI {
-    /** Kick off a check; resolves to true if an update is available. */
-    checkForUpdates(): Promise<boolean>;
-    /** Current app version string. */
-    getVersion(): Promise<string>;
-    /**
-     * Quit the app and apply a downloaded update. Should only be called
-     * after an `UpdaterStatus` of kind `'downloaded'` has been observed.
-     */
-    quitAndInstall(): Promise<void>;
-    /**
-     * Subscribe to updater status events. Returns an unsubscribe function.
-     */
-    onStatus(listener: (status: UpdaterStatus) => void): () => void;
-}
-type UpdaterStatus = {
-    kind: 'checking';
-} | {
-    kind: 'available';
-    version: string;
-    releaseNotes?: string;
-    releaseUrl?: string;
-} | {
-    kind: 'not-available';
-} | {
-    kind: 'downloading';
-    percent: number;
-} | {
-    kind: 'downloaded';
-    version: string;
-    releaseNotes?: string;
-    releaseUrl?: string;
-} | {
-    kind: 'error';
-    message: string;
-};
-/** Menu-command events pushed from the main process to the renderer. */
-type MenuCommand = 'file:new' | 'file:openFolder' | 'file:revealWorkspace' | 'file:settings' | 'help:about' | 'help:checkForUpdates' | 'help:viewOnGitHub';
-/** Deep-link event resolved by the host into a trusted workspace file. */
-interface OpenRequest {
-    kind: 'workspace-file';
-    workspaceId: string;
-    /** Slash-prefixed path relative to the workspace root. */
-    path: string;
-}
-/** Environment metadata provided by the host. */
-interface HostEnvironment {
-    platform: 'darwin' | 'win32' | 'linux';
-    appVersion: string;
-    isDev: boolean;
-}
-/** The full DocBlocks desktop host API. */
-interface DocBlocksHostAPI {
-    env: HostEnvironment;
-    fs: DocBlocksHostFsAPI;
-    workspaces: DocBlocksHostWorkspacesAPI;
-    shell: DocBlocksHostShellAPI;
-    ffmpeg: DocBlocksHostFfmpegAPI;
-    updater: DocBlocksHostUpdaterAPI;
-    /**
-     * Subscribe to menu commands dispatched by the native menu.
-     * Returns an unsubscribe function.
-     */
-    onMenuCommand(listener: (cmd: MenuCommand) => void): () => void;
-    /**
-     * Subscribe to open-file / open-url requests from the OS.
-     * Returns an unsubscribe function.
-     */
-    onOpenRequest(listener: (request: OpenRequest) => void): () => void;
-}
-
-/**
- * Host bridge — shared types + runtime access for the Electron desktop
- * host. The renderer calls `getDocBlocksHost()` to reach the preload
- * contextBridge; `isElectronHost()` gates desktop-only UI branches.
- */
-
-/** True when running inside the Electron desktop shell. */
-declare function isElectronHost(): boolean;
-/** Return the host API, or throw if not running under Electron. */
-declare function getDocBlocksHost(): DocBlocksHostAPI;
-/** Return the host API, or null if not running under Electron. */
-declare function maybeGetDocBlocksHost(): DocBlocksHostAPI | null;
-
-export { type DocBlocksHostAPI as D, type ElectronWorkspaceInfo as E, type FileEntry as F, type HostEnvironment as H, type MenuCommand as M, type OpenRequest as O, type UpdaterStatus as U, type DocBlocksHostFfmpegAPI as a, type DocBlocksHostFsAPI as b, type DocBlocksHostShellAPI as c, type DocBlocksHostUpdaterAPI as d, type DocBlocksHostWorkspacesAPI as e, type FileMeta as f, type FileSystemEntry as g, type FileSystemProvider as h, type FolderEntry as i, getDocBlocksHost as j, isElectronHost as k, maybeGetDocBlocksHost as m };

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/workspace/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,sBAAsB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/workspace/types.d.ts

@@ -1,29 +0,0 @@
-/**
- * Workspace — a named binding to a FileSystemProvider, representing
- * the user's current working context (a folder of markdown files).
- */
-export interface WorkspaceDescriptor {
-    /** Unique stable identifier (persisted in IndexedDB). */
-    id: string;
-    /** User-visible label. */
-    name: string;
-    /**
-     * Provider kind:
-     * - 'indexeddb' — browser-local storage (web only)
-     * - 'native' — File System Access API (web Chrome/Edge only)
-     * - 'electron-native' — Electron main-process native filesystem
-     */
-    type: 'indexeddb' | 'native' | 'electron-native';
-    /** ISO timestamp of last access. */
-    lastOpened: string;
-    /** Absolute filesystem path for 'electron-native' workspaces. */
-    rootPath?: string;
-    /**
-     * Per-workspace override for the global versioning preference. When
-     * `'inherit'` (or absent), the global preference applies. `'on'` /
-     * `'off'` force the corresponding behavior regardless of the global
-     * setting. See `resolveVersioningEnabled` in the preferences module.
-     */
-    versioningOverride?: 'inherit' | 'on' | 'off';
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/workspace/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACjD,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC;CAC/C"}

package/dist/workspace/types.js

@@ -1,6 +0,0 @@
-/**
- * Workspace — a named binding to a FileSystemProvider, representing
- * the user's current working context (a folder of markdown files).
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/workspace/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/workspace/workspace-manager.d.ts

@@ -1,35 +0,0 @@
-/**
- * WorkspaceManager — manages the list of known workspaces in IndexedDB
- * and provides helpers for creating / switching / removing them.
- *
- * The actual FileSystemProvider instances are created by the caller
- * (since native providers need a DirectoryHandle from user interaction).
- */
-import type { WorkspaceDescriptor } from './types.js';
-/**
- * Get the list of all known workspace descriptors.
- */
-export declare function listWorkspaces(): Promise<WorkspaceDescriptor[]>;
-/**
- * Get a specific workspace descriptor by id.
- */
-export declare function getWorkspace(id: string): Promise<WorkspaceDescriptor | null>;
-/**
- * Add or update a workspace descriptor. If a workspace with the same id
- * already exists, it is replaced.
- */
-export declare function saveWorkspace(workspace: WorkspaceDescriptor): Promise<void>;
-/**
- * Remove a workspace descriptor by id.
- */
-export declare function removeWorkspace(id: string): Promise<void>;
-/**
- * Touch the lastOpened timestamp on a workspace.
- */
-export declare function touchWorkspace(id: string): Promise<void>;
-/**
- * Ensure a default IndexedDB workspace exists. Called on app startup.
- * Returns the descriptor.
- */
-export declare function ensureDefaultWorkspace(): Promise<WorkspaceDescriptor>;
-//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/workspace/workspace-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/workspace/workspace-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAYtD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAGlF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CASjF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAY3E"}

package/dist/workspace/workspace-manager.js

@@ -1,82 +0,0 @@
-/**
- * WorkspaceManager — manages the list of known workspaces in IndexedDB
- * and provides helpers for creating / switching / removing them.
- *
- * The actual FileSystemProvider instances are created by the caller
- * (since native providers need a DirectoryHandle from user interaction).
- */
-import { LocalForageAdapter } from '@bendyline/squisq/storage';
-const DB_NAME = 'docblocks-workspaces';
-const STORE_NAME = 'workspaces';
-const LIST_KEY = 'workspace-list';
-const DEFAULT_WORKSPACE_ID = 'default';
-const store = new LocalForageAdapter({
-    name: DB_NAME,
-    storeName: STORE_NAME,
-});
-/**
- * Get the list of all known workspace descriptors.
- */
-export async function listWorkspaces() {
-    const list = await store.get(LIST_KEY);
-    return list ?? [];
-}
-/**
- * Get a specific workspace descriptor by id.
- */
-export async function getWorkspace(id) {
-    const list = await listWorkspaces();
-    return list.find((w) => w.id === id) ?? null;
-}
-/**
- * Add or update a workspace descriptor. If a workspace with the same id
- * already exists, it is replaced.
- */
-export async function saveWorkspace(workspace) {
-    const list = await listWorkspaces();
-    const idx = list.findIndex((w) => w.id === workspace.id);
-    if (idx >= 0) {
-        list[idx] = workspace;
-    }
-    else {
-        list.push(workspace);
-    }
-    await store.set(LIST_KEY, list);
-}
-/**
- * Remove a workspace descriptor by id.
- */
-export async function removeWorkspace(id) {
-    const list = await listWorkspaces();
-    const filtered = list.filter((w) => w.id !== id);
-    await store.set(LIST_KEY, filtered);
-}
-/**
- * Touch the lastOpened timestamp on a workspace.
- */
-export async function touchWorkspace(id) {
-    const list = await listWorkspaces();
-    const workspace = list.find((w) => w.id === id);
-    if (workspace) {
-        workspace.lastOpened = new Date().toISOString();
-        await store.set(LIST_KEY, list);
-    }
-}
-/**
- * Ensure a default IndexedDB workspace exists. Called on app startup.
- * Returns the descriptor.
- */
-export async function ensureDefaultWorkspace() {
-    const existing = await getWorkspace(DEFAULT_WORKSPACE_ID);
-    if (existing)
-        return existing;
-    const descriptor = {
-        id: DEFAULT_WORKSPACE_ID,
-        name: 'My Documents',
-        type: 'indexeddb',
-        lastOpened: new Date().toISOString(),
-    };
-    await saveWorkspace(descriptor);
-    return descriptor;
-}
-//# sourceMappingURL=workspace-manager.js.map

package/dist/workspace/workspace-manager.js.map

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

package/src/filesystem/electron-provider.ts

@@ -1,88 +0,0 @@
-/**
- * ElectronFileSystemProvider — implements FileSystemProvider by delegating
- * to the Electron desktop host's fs IPC bridge. Every operation is scoped
- * to an absolute root path that the main process validates against a
- * whitelist of registered workspace roots.
- *
- * This file has no Electron dependency — it is a pure IPC client that
- * relies on the `docBlocksHost` global installed by the preload script.
- */
-
-import type { FileSystemProvider, FileSystemEntry, FileMeta } from './types.js';
-import { maybeGetDocBlocksHost } from '../host/index.js';
-import type { DocBlocksHostFsAPI } from '../host/types.js';
-
-export { isElectronHost } from '../host/index.js';
-
-function getHostFs(): DocBlocksHostFsAPI {
-  const host = maybeGetDocBlocksHost();
-  if (!host) {
-    throw new Error(
-      'ElectronFileSystemProvider: docBlocksHost is not available — not running under Electron?',
-    );
-  }
-  return host.fs;
-}
-
-export class ElectronFileSystemProvider implements FileSystemProvider {
-  readonly id: string;
-  readonly label: string;
-
-  private readonly rootPath: string;
-
-  constructor(id: string, label: string, rootPath: string) {
-    this.id = id;
-    this.label = label;
-    this.rootPath = rootPath;
-  }
-
-  /** Absolute path this provider is rooted at. */
-  getRootPath(): string {
-    return this.rootPath;
-  }
-
-  readFile(path: string): Promise<string | null> {
-    return getHostFs().readFile(this.rootPath, path);
-  }
-
-  writeFile(path: string, content: string): Promise<void> {
-    return getHostFs().writeFile(this.rootPath, path, content);
-  }
-
-  delete(path: string): Promise<void> {
-    return getHostFs().delete(this.rootPath, path);
-  }
-
-  rename(oldPath: string, newPath: string): Promise<void> {
-    return getHostFs().rename(this.rootPath, oldPath, newPath);
-  }
-
-  readDirectory(path: string): Promise<FileSystemEntry[]> {
-    return getHostFs().readDirectory(this.rootPath, path);
-  }
-
-  exists(path: string): Promise<boolean> {
-    return getHostFs().exists(this.rootPath, path);
-  }
-
-  createDirectory(path: string): Promise<void> {
-    return getHostFs().createDirectory(this.rootPath, path);
-  }
-
-  stat(path: string): Promise<FileMeta | null> {
-    return getHostFs().stat(this.rootPath, path);
-  }
-
-  readBinary(path: string): Promise<ArrayBuffer | null> {
-    return getHostFs().readBinary(this.rootPath, path);
-  }
-
-  writeBinary(path: string, data: ArrayBuffer | Uint8Array): Promise<void> {
-    return getHostFs().writeBinary(this.rootPath, path, data);
-  }
-
-  /** Subscribe to external change notifications under this root. */
-  watch(onChange: (changedPath: string) => void): () => void {
-    return getHostFs().watch(this.rootPath, onChange);
-  }
-}

package/src/filesystem/file-media-provider.ts

@@ -1,103 +0,0 @@
-/**
- * createFileMediaProvider — per-file media storage following the pandoc /
- * Word convention: a markdown file `notes.md` gets a sibling folder
- * `notes_files/` that holds its images, audio, and video.
- *
- * Given:
- *   • `container` — a ContentContainer scoped to the markdown file's
- *     parent directory (so `readFile('notes_files/image.png')` maps to the
- *     parent-relative path)
- *   • `markdownBasename` — e.g. `"notes.md"`
- *
- * Returns a MediaProvider that:
- *   • Writes new media under `{basename}_files/{name}` in the parent dir
- *   • Returns the folder-qualified path (`notes_files/image.png`) from
- *     addMedia so the markdown stays portable outside DocBlocks
- *   • Resolves both bare (`image.png`) and folder-qualified
- *     (`notes_files/image.png`) references — so legacy markdown and
- *     exports from other tools both work
- */
-
-import type { MediaProvider, MediaEntry } from '@bendyline/squisq/schemas';
-import type { ContentContainer } from '@bendyline/squisq/storage';
-
-function stripExt(name: string): string {
-  return name.replace(/\.[^.]+$/, '');
-}
-
-export function createFileMediaProvider(
-  container: ContentContainer,
-  markdownBasename: string,
-): MediaProvider {
-  const folder = stripExt(markdownBasename) + '_files';
-  const prefix = folder + '/';
-  const blobUrlCache = new Map<string, string>();
-
-  function toKey(ref: string): string {
-    const clean = ref.replace(/^\/+/, '');
-    return clean.startsWith(prefix) ? clean : prefix + clean;
-  }
-
-  return {
-    async resolveUrl(ref: string): Promise<string> {
-      const key = toKey(ref);
-      const cached = blobUrlCache.get(key);
-      if (cached) return cached;
-
-      const data = await container.readFile(key);
-      if (!data) return ref;
-
-      const entries = await container.listFiles();
-      const entry = entries.find((e) => e.path === key);
-      const mimeType = entry?.mimeType ?? 'application/octet-stream';
-
-      const url = URL.createObjectURL(new Blob([data], { type: mimeType }));
-      blobUrlCache.set(key, url);
-      return url;
-    },
-
-    async listMedia(): Promise<MediaEntry[]> {
-      const entries = await container.listFiles(prefix);
-      return entries
-        .filter((e) => !e.path.toLowerCase().endsWith('.md'))
-        .map((e) => ({
-          name: e.path,
-          mimeType: e.mimeType,
-          size: e.size,
-        }));
-    },
-
-    async addMedia(
-      name: string,
-      data: ArrayBuffer | Blob | Uint8Array,
-      mimeType: string,
-    ): Promise<string> {
-      const key = toKey(name);
-      const cached = blobUrlCache.get(key);
-      if (cached) {
-        URL.revokeObjectURL(cached);
-        blobUrlCache.delete(key);
-      }
-      const buffer = data instanceof Blob ? new Uint8Array(await data.arrayBuffer()) : data;
-      await container.writeFile(key, buffer, mimeType);
-      return key;
-    },
-
-    async removeMedia(ref: string): Promise<void> {
-      const key = toKey(ref);
-      const cached = blobUrlCache.get(key);
-      if (cached) {
-        URL.revokeObjectURL(cached);
-        blobUrlCache.delete(key);
-      }
-      await container.removeFile(key);
-    },
-
-    dispose(): void {
-      for (const url of blobUrlCache.values()) {
-        URL.revokeObjectURL(url);
-      }
-      blobUrlCache.clear();
-    },
-  };
-}