@bendyline/docblocks 2.6.1 → 2.6.2

package/THIRD_PARTY_NOTICES.txt

@@ -14,7 +14,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.11.3 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.11.4 | MIT | https://github.com/bendyline/squisq |
 | @types/debug | 4.1.12 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/hast | 3.0.4 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/katex | 0.16.8 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
@@ -132,7 +132,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 Package-local license, copying, and notice files are reproduced below. Where a published package omits its repository license, the reviewed aggregate or README identified in `Source files` supplies the retained material.
 
 ==============================================================================
-Components: @bendyline/squisq@2.11.3
+Components: @bendyline/squisq@2.11.4
 Source files: node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -158,7 +158,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ==============================================================================
-Components: @bendyline/squisq@2.11.3
+Components: @bendyline/squisq@2.11.4
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -189,7 +189,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.11.3
+Components: @bendyline/squisq@2.11.4
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{chunk-BVY7GGNV.js → chunk-5MJC4KOE.js}

@@ -1,7 +1,13 @@
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  FILE_SYSTEM_TRANSFER_LIMITS,
   maybeGetDocBlocksHost
-} from "./chunk-6XHOOBYF.js";
+} from "./chunk-KFWPPIJH.js";
+import {
+  HOST_WIRE_LIMITS,
+  isBoundedBytePayload,
+  isBoundedString
+} from "./chunk-2WDJ27EH.js";
 import {
   isRecord
 } from "./chunk-73OOROXH.js";
@@ -64,16 +70,25 @@ var ElectronFileSystemProviderV2 = class {
     const canonical = parseWorkspacePath(String(path));
     return this.request(
       "read",
-      () => getHostFsV2("read").readFile(this.instanceId, canonical),
-      (value) => {
-        if (!value) return null;
+      async () => {
+        const host = getHostFsV2("read");
+        if (host.beginRead && host.readChunk && host.closeTransfer) {
+          const value2 = unwrap(await host.stat(this.instanceId, canonical), "read");
+          const stat = value2 ? normalizeEntry(value2) : null;
+          if (stat?.kind === "file" && stat.size > FILE_SYSTEM_TRANSFER_LIMITS.chunkBytes) {
+            return { ok: true, value: await this.readTransferredFile(host, canonical) };
+          }
+        }
+        const value = unwrap(await host.readFile(this.instanceId, canonical), "read");
+        if (!value) return { ok: true, value: null };
         const entry = normalizeFile(value.entry);
         const data = copyWireBuffer(value.data);
         if (data.byteLength !== entry.size) {
           throw new TypeError("Filesystem transport returned file bytes with the wrong size.");
         }
-        return Object.freeze({ entry, data });
-      }
+        return { ok: true, value: Object.freeze({ entry, data }) };
+      },
+      (value) => value
     );
   }
   async readDirectory(path) {
@@ -86,13 +101,82 @@ var ElectronFileSystemProviderV2 = class {
   }
   async writeFile(path, data, options) {
     const canonical = parseWorkspacePath(String(path));
+    this.assertOpen("write");
+    if (data.byteLength > FILE_SYSTEM_TRANSFER_LIMITS.fileBytes) {
+      throw new FsError("quota-exceeded", "This file exceeds the 1 GiB desktop file limit.", {
+        operation: "write",
+        path: canonical
+      });
+    }
     const owned = copyBytes(data);
     return this.request(
       "write",
-      () => getHostFsV2("write").writeFile(this.instanceId, canonical, owned, options),
+      async () => {
+        const host = getHostFsV2("write");
+        if (owned.byteLength > FILE_SYSTEM_TRANSFER_LIMITS.chunkBytes && host.beginWrite && host.writeChunk && host.finishWrite && host.closeTransfer) {
+          const id = normalizeTransferId(
+            unwrap(
+              await host.beginWrite(this.instanceId, canonical, owned.byteLength, options),
+              "write"
+            )
+          );
+          try {
+            for (let offset = 0; offset < owned.byteLength; offset += FILE_SYSTEM_TRANSFER_LIMITS.chunkBytes) {
+              unwrap(
+                await host.writeChunk(
+                  this.instanceId,
+                  id,
+                  offset,
+                  owned.slice(offset, offset + FILE_SYSTEM_TRANSFER_LIMITS.chunkBytes)
+                ),
+                "write"
+              );
+            }
+            return await host.finishWrite(this.instanceId, id);
+          } finally {
+            unwrap(await host.closeTransfer(this.instanceId, id), "write");
+          }
+        }
+        if (owned.byteLength > HOST_WIRE_LIMITS.binaryBytes) {
+          throw new FsError(
+            "not-supported",
+            "This desktop version does not support large file transfers. Update DocBlocks and retry."
+          );
+        }
+        return host.writeFile(this.instanceId, canonical, owned, options);
+      },
       normalizeFile
     );
   }
+  async readTransferredFile(host, path) {
+    if (!host.beginRead || !host.readChunk || !host.closeTransfer) {
+      throw new FsError("not-supported", "Large file transfers are unavailable.");
+    }
+    const transfer = unwrap(await host.beginRead(this.instanceId, path), "read");
+    if (transfer === null) return null;
+    if (!isRecord(transfer) || Object.keys(transfer).some((key) => key !== "transferId" && key !== "entry")) {
+      throw new TypeError("Filesystem returned an invalid transfer.");
+    }
+    const id = normalizeTransferId(transfer.transferId);
+    try {
+      const entry = normalizeFile(transfer.entry);
+      if (entry.path !== path || entry.size > FILE_SYSTEM_TRANSFER_LIMITS.fileBytes) {
+        throw new TypeError("Filesystem transfer returned an invalid file.");
+      }
+      const data = new Uint8Array(entry.size);
+      for (let offset = 0; offset < data.byteLength; ) {
+        const chunk = unwrap(await host.readChunk(this.instanceId, id, offset), "read");
+        if (!isBoundedBytePayload(chunk, FILE_SYSTEM_TRANSFER_LIMITS.chunkBytes) || chunk.byteLength === 0 || offset + chunk.byteLength > data.byteLength) {
+          throw new TypeError("Filesystem transfer returned an invalid chunk.");
+        }
+        data.set(chunk instanceof Uint8Array ? chunk : new Uint8Array(chunk), offset);
+        offset += chunk.byteLength;
+      }
+      return Object.freeze({ entry, data: data.buffer });
+    } finally {
+      unwrap(await host.closeTransfer(this.instanceId, id), "read");
+    }
+  }
   async createDirectory(path, options) {
     const canonical = parseWorkspacePath(String(path));
     return this.request(
@@ -291,6 +375,12 @@ function unwrap(result, operation) {
   }
   throw deserializeFsError(result.error);
 }
+function normalizeTransferId(value) {
+  if (!isBoundedString(value, HOST_WIRE_LIMITS.identifierCharacters, 1)) {
+    throw new TypeError("Filesystem returned an invalid transfer ID.");
+  }
+  return value;
+}
 function normalizeEntry(entry) {
   if (!isRecord(entry)) throw new TypeError("Expected a filesystem entry object.");
   if (typeof entry.path !== "string")

package/dist/{chunk-6XHOOBYF.js → chunk-KFWPPIJH.js}

@@ -1,4 +1,12 @@
 // src/host/filesystem-v2.ts
+var FILE_SYSTEM_TRANSFER_LIMITS = Object.freeze({
+  fileBytes: 1024 * 1024 * 1024,
+  chunkBytes: 4 * 1024 * 1024,
+  totalBytes: 2 * 1024 * 1024 * 1024,
+  transfers: 4,
+  idleMs: 12e4,
+  lifetimeMs: 15 * 6e4
+});
 var ELECTRON_FILE_SYSTEM_V2_CAPABILITIES = Object.freeze({
   writeAtomicity: "process",
   moveAtomicity: "process",
@@ -29,6 +37,7 @@ function maybeGetDocBlocksHost() {
 }
 
 export {
+  FILE_SYSTEM_TRANSFER_LIMITS,
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   isElectronHost,
   getDocBlocksHost,

package/dist/filesystem/electron.d.ts

@@ -1,7 +1,7 @@
 import { s as FileSystemProviderV2, r as FileSystemProviderCapabilities, k as FileSystemEntrySnapshot, m as FileSystemFileRead, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, C as FileSystemWatchEvent, H as FileSystemWatchOptions, I as FileSystemWatchSubscription, q as FileSystemProvider, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from '../types-Bb3yccTH.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-DBYraXxE.js';
+import '../types-DhLZZNEn.js';
 
 /** Pure renderer-side client for the typed Electron filesystem v2 transport. */
 declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {
@@ -24,6 +24,7 @@ declare class ElectronFileSystemProviderV2 implements FileSystemProviderV2 {
     readFile(path: WorkspacePath): Promise<FileSystemFileRead | null>;
     readDirectory(path: WorkspacePath): Promise<readonly FileSystemEntrySnapshot[]>;
     writeFile(path: WorkspacePath, data: ArrayBuffer | Uint8Array, options?: FileSystemWriteOptions): Promise<FileSystemFileSnapshot>;
+    private readTransferredFile;
     createDirectory(path: WorkspacePath, options?: FileSystemCreateDirectoryOptions): Promise<FileSystemDirectorySnapshot>;
     remove(path: WorkspacePath, options?: FileSystemRemoveOptions): Promise<FileSystemRemoveResult>;
     move(oldPath: WorkspacePath, newPath: WorkspacePath, options?: FileSystemMoveOptions): Promise<FileSystemEntrySnapshot>;

package/dist/filesystem/electron.js

@@ -1,10 +1,10 @@
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "../chunk-BVY7GGNV.js";
+} from "../chunk-5MJC4KOE.js";
 import {
   isElectronHost
-} from "../chunk-6XHOOBYF.js";
+} from "../chunk-KFWPPIJH.js";
 import "../chunk-2WDJ27EH.js";
 import "../chunk-73OOROXH.js";
 import "../chunk-M62ZGJ5I.js";

package/dist/filesystem/index.d.ts

@@ -10,7 +10,7 @@ import { MediaProvider } from '@bendyline/squisq/schemas';
 export { NativeFileSystemMovePathState, NativeFileSystemMoveRecoveryError, NativeFileSystemMoveRecoveryState, NativeFileSystemProvider, NativeFileSystemProviderV2, isNativeFileSystemSupported, loadDirectoryHandle, openNativeFolder, removeDirectoryHandle, restoreNativeFolder, storeDirectoryHandle } from './native.js';
 export { ElectronFileSystemProvider, ElectronFileSystemProviderV2 } from './electron.js';
 export { isElectronHost } from '../host/index.js';
-import '../types-DBYraXxE.js';
+import '../types-DhLZZNEn.js';
 
 interface DecodeUtf8TextOptions {
     /** User-facing description of the payload being decoded. */

package/dist/filesystem/index.js

@@ -32,10 +32,10 @@ import "../chunk-KQ6756AJ.js";
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "../chunk-BVY7GGNV.js";
+} from "../chunk-5MJC4KOE.js";
 import {
   isElectronHost
-} from "../chunk-6XHOOBYF.js";
+} from "../chunk-KFWPPIJH.js";
 import "../chunk-2WDJ27EH.js";
 import "../chunk-73OOROXH.js";
 import {

package/dist/host/index.d.ts

@@ -1,5 +1,5 @@
-import { Q as OpenRequest, M as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-DBYraXxE.js';
-export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from '../types-DBYraXxE.js';
+import { S as OpenRequest, O as HostPinnedDocument, D as DocBlocksHostAPI } from '../types-DhLZZNEn.js';
+export { a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, F as FILE_SYSTEM_TRANSFER_LIMITS, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, I as HostEnvironment, J as HostExportTargetGrant, K as HostFileSystemReadTransfer, L as HostFileSystemV2OpenRequest, M as HostFileSystemV2Result, N as HostFileSystemV2WatchMessage, P as HostPrepareCloseRequest, Q as HostPrepareCloseResult, R as MenuCommand, U as UpdateCheckResult, T as UpdateInstallResult, V as UpdaterStatus } from '../types-DhLZZNEn.js';
 import '../types-Bb3yccTH.js';
 import '../workspace-path-CWVrcuPL.js';
 

package/dist/host/index.js

@@ -1,9 +1,10 @@
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  FILE_SYSTEM_TRANSFER_LIMITS,
   getDocBlocksHost,
   isElectronHost,
   maybeGetDocBlocksHost
-} from "../chunk-6XHOOBYF.js";
+} from "../chunk-KFWPPIJH.js";
 import {
   HOST_WIRE_LIMITS,
   MAX_HOST_PINNED_DOCUMENTS,
@@ -16,6 +17,7 @@ import {
 } from "../chunk-2WDJ27EH.js";
 export {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  FILE_SYSTEM_TRANSFER_LIMITS,
   HOST_WIRE_LIMITS,
   MAX_HOST_PINNED_DOCUMENTS,
   getDocBlocksHost,

package/dist/index.d.ts

@@ -9,6 +9,6 @@ export { DOCUMENT_RECOVERY_JOURNAL_SCHEMA_VERSION, DOCUMENT_RECOVERY_JOURNAL_STO
 export { ElectronWorkspaceReconciliation, TransientOrigin, WorkspaceDescriptor, ensureDefaultWorkspace, getTransientWorkspace, getWorkspace, listWorkspaces, parsePersistedWorkspaceList, reconcileElectronWorkspaceDescriptors, registerTransientWorkspace, removeWorkspace, saveWorkspace, touchWorkspace, unregisterTransientWorkspace } from './workspace/index.js';
 export { HOST_WIRE_LIMITS, MAX_HOST_PINNED_DOCUMENTS, getDocBlocksHost, isBoundedBytePayload, isBoundedString, isElectronHost, isTrustedRendererUrl, maybeGetDocBlocksHost, parseExternalHttpUrl, parseOpenRequest, parsePinnedMenuDocuments } from './host/index.js';
 export { SHARED_DOCUMENT_LIMITS, SharedDocumentHashParseResult, SharedDocumentMode, SharedDocumentPayload, createSharedDocumentHash, createSharedDocumentUrl, parseSharedDocumentHash } from './share/index.js';
-export { D as DocBlocksHostAPI, a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, F as HostEnvironment, I as HostExportTargetGrant, J as HostFileSystemV2OpenRequest, K as HostFileSystemV2Result, L as HostFileSystemV2WatchMessage, M as HostPinnedDocument, N as HostPrepareCloseRequest, O as HostPrepareCloseResult, P as MenuCommand, Q as OpenRequest, U as UpdateCheckResult, R as UpdateInstallResult, S as UpdaterStatus } from './types-DBYraXxE.js';
+export { D as DocBlocksHostAPI, a as DocBlocksHostClipboardAPI, b as DocBlocksHostExportAPI, c as DocBlocksHostExternalAPI, d as DocBlocksHostFfmpegAPI, e as DocBlocksHostFsAPI, f as DocBlocksHostFsV2API, g as DocBlocksHostGitAPI, h as DocBlocksHostLifecycleAPI, i as DocBlocksHostMenuAPI, j as DocBlocksHostShellAPI, k as DocBlocksHostUpdaterAPI, l as DocBlocksHostWorkspacesAPI, E as ELECTRON_FILE_SYSTEM_V2_CAPABILITIES, m as ElectronWorkspaceInfo, n as ExternalBinaryCommitResult, F as FILE_SYSTEM_TRANSFER_LIMITS, G as GitBranchInfo, o as GitCapabilities, p as GitCloneHandle, q as GitCloneProgress, r as GitError, s as GitErrorCode, t as GitFileAtRevision, u as GitFileChange, v as GitFileStatusCode, w as GitLogEntry, x as GitLogOptions, y as GitRemoteInfo, z as GitRepoDetection, A as GitResult, B as GitRevision, C as GitStatus, H as HostCloseReason, I as HostEnvironment, J as HostExportTargetGrant, K as HostFileSystemReadTransfer, L as HostFileSystemV2OpenRequest, M as HostFileSystemV2Result, N as HostFileSystemV2WatchMessage, O as HostPinnedDocument, P as HostPrepareCloseRequest, Q as HostPrepareCloseResult, R as MenuCommand, S as OpenRequest, U as UpdateCheckResult, T as UpdateInstallResult, V as UpdaterStatus } from './types-DhLZZNEn.js';
 import '@bendyline/squisq/storage';
 import '@bendyline/squisq/schemas';

package/dist/index.js

@@ -38,13 +38,14 @@ import "./chunk-KQ6756AJ.js";
 import {
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2
-} from "./chunk-BVY7GGNV.js";
+} from "./chunk-5MJC4KOE.js";
 import {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
+  FILE_SYSTEM_TRANSFER_LIMITS,
   getDocBlocksHost,
   isElectronHost,
   maybeGetDocBlocksHost
-} from "./chunk-6XHOOBYF.js";
+} from "./chunk-KFWPPIJH.js";
 import {
   HOST_WIRE_LIMITS,
   MAX_HOST_PINNED_DOCUMENTS,
@@ -128,6 +129,7 @@ export {
   ELECTRON_FILE_SYSTEM_V2_CAPABILITIES,
   ElectronFileSystemProvider,
   ElectronFileSystemProviderV2,
+  FILE_SYSTEM_TRANSFER_LIMITS,
   FileSystemContentContainer,
   FileSystemMoveRecoveryError,
   FileSystemPartialMoveError,

package/dist/{types-DBYraXxE.d.ts → types-DhLZZNEn.d.ts}

@@ -1,6 +1,19 @@
-import { S as SerializedFsError, r as FileSystemProviderCapabilities, k as FileSystemEntrySnapshot, m as FileSystemFileRead, K as FileSystemWriteOptions, n as FileSystemFileSnapshot, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, C as FileSystemWatchEvent, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from './types-Bb3yccTH.js';
+import { S as SerializedFsError, n as FileSystemFileSnapshot, K as FileSystemWriteOptions, r as FileSystemProviderCapabilities, k as FileSystemEntrySnapshot, m as FileSystemFileRead, g as FileSystemCreateDirectoryOptions, h as FileSystemDirectorySnapshot, u as FileSystemRemoveOptions, v as FileSystemRemoveResult, o as FileSystemMoveOptions, w as FileSystemSnapshot, C as FileSystemWatchEvent, F as FileCommitResult, j as FileSystemEntry, b as FileMeta } from './types-Bb3yccTH.js';
 import { a as WorkspacePath } from './workspace-path-CWVrcuPL.js';
 
+/** File size and per-message size are deliberately separate budgets. */
+declare const FILE_SYSTEM_TRANSFER_LIMITS: Readonly<{
+    fileBytes: number;
+    chunkBytes: number;
+    totalBytes: number;
+    transfers: 4;
+    idleMs: 120000;
+    lifetimeMs: number;
+}>;
+interface HostFileSystemReadTransfer {
+    readonly transferId: string;
+    readonly entry: FileSystemFileSnapshot;
+}
 /** Stable capabilities shared by the Electron v2 client and native backend. */
 declare const ELECTRON_FILE_SYSTEM_V2_CAPABILITIES: FileSystemProviderCapabilities;
 /** Explicit result envelope; Electron does not preserve custom Error fields. */
@@ -30,6 +43,13 @@ type HostFileSystemV2WatchMessage = {
 };
 /** Wire-level filesystem v2 API exposed by preload. */
 interface DocBlocksHostFsV2API {
+    /** Optional for compatibility with older preload versions. */
+    beginRead?(instanceId: string, path: WorkspacePath): Promise<HostFileSystemV2Result<HostFileSystemReadTransfer | null>>;
+    readChunk?(instanceId: string, transferId: string, offset: number): Promise<HostFileSystemV2Result<ArrayBuffer>>;
+    beginWrite?(instanceId: string, path: WorkspacePath, byteLength: number, options?: FileSystemWriteOptions): Promise<HostFileSystemV2Result<string>>;
+    writeChunk?(instanceId: string, transferId: string, offset: number, data: ArrayBuffer | Uint8Array): Promise<HostFileSystemV2Result<null>>;
+    finishWrite?(instanceId: string, transferId: string): Promise<HostFileSystemV2Result<FileSystemFileSnapshot>>;
+    closeTransfer?(instanceId: string, transferId: string): Promise<HostFileSystemV2Result<null>>;
     open(request: HostFileSystemV2OpenRequest): Promise<HostFileSystemV2Result<FileSystemProviderCapabilities>>;
     stat(instanceId: string, path: WorkspacePath): Promise<HostFileSystemV2Result<FileSystemEntrySnapshot | null>>;
     readFile(instanceId: string, path: WorkspacePath): Promise<HostFileSystemV2Result<FileSystemFileRead | null>>;
@@ -554,4 +574,4 @@ interface DocBlocksHostAPI {
     onOpenRequest(listener: (request: OpenRequest) => void): () => void;
 }
 
-export { type GitResult as A, type GitRevision as B, type GitStatus as C, type DocBlocksHostAPI as D, ELECTRON_FILE_SYSTEM_V2_CAPABILITIES as E, type HostEnvironment as F, type GitBranchInfo as G, type HostCloseReason as H, type HostExportTargetGrant as I, type HostFileSystemV2OpenRequest as J, type HostFileSystemV2Result as K, type HostFileSystemV2WatchMessage as L, type HostPinnedDocument as M, type HostPrepareCloseRequest as N, type HostPrepareCloseResult as O, type MenuCommand as P, type OpenRequest as Q, type UpdateInstallResult as R, type UpdaterStatus as S, type UpdateCheckResult as U, type DocBlocksHostClipboardAPI as a, type DocBlocksHostExportAPI as b, type DocBlocksHostExternalAPI as c, type DocBlocksHostFfmpegAPI as d, type DocBlocksHostFsAPI as e, type DocBlocksHostFsV2API as f, type DocBlocksHostGitAPI as g, type DocBlocksHostLifecycleAPI as h, type DocBlocksHostMenuAPI as i, type DocBlocksHostShellAPI as j, type DocBlocksHostUpdaterAPI as k, type DocBlocksHostWorkspacesAPI as l, type ElectronWorkspaceInfo as m, type ExternalBinaryCommitResult as n, type GitCapabilities as o, type GitCloneHandle as p, type GitCloneProgress as q, type GitError as r, type GitErrorCode as s, type GitFileAtRevision as t, type GitFileChange as u, type GitFileStatusCode as v, type GitLogEntry as w, type GitLogOptions as x, type GitRemoteInfo as y, type GitRepoDetection as z };
+export { type GitResult as A, type GitRevision as B, type GitStatus as C, type DocBlocksHostAPI as D, ELECTRON_FILE_SYSTEM_V2_CAPABILITIES as E, FILE_SYSTEM_TRANSFER_LIMITS as F, type GitBranchInfo as G, type HostCloseReason as H, type HostEnvironment as I, type HostExportTargetGrant as J, type HostFileSystemReadTransfer as K, type HostFileSystemV2OpenRequest as L, type HostFileSystemV2Result as M, type HostFileSystemV2WatchMessage as N, type HostPinnedDocument as O, type HostPrepareCloseRequest as P, type HostPrepareCloseResult as Q, type MenuCommand as R, type OpenRequest as S, type UpdateInstallResult as T, type UpdateCheckResult as U, type UpdaterStatus as V, type DocBlocksHostClipboardAPI as a, type DocBlocksHostExportAPI as b, type DocBlocksHostExternalAPI as c, type DocBlocksHostFfmpegAPI as d, type DocBlocksHostFsAPI as e, type DocBlocksHostFsV2API as f, type DocBlocksHostGitAPI as g, type DocBlocksHostLifecycleAPI as h, type DocBlocksHostMenuAPI as i, type DocBlocksHostShellAPI as j, type DocBlocksHostUpdaterAPI as k, type DocBlocksHostWorkspacesAPI as l, type ElectronWorkspaceInfo as m, type ExternalBinaryCommitResult as n, type GitCapabilities as o, type GitCloneHandle as p, type GitCloneProgress as q, type GitError as r, type GitErrorCode as s, type GitFileAtRevision as t, type GitFileChange as u, type GitFileStatusCode as v, type GitLogEntry as w, type GitLogOptions as x, type GitRemoteInfo as y, type GitRepoDetection as z };

package/dist/workspace/index.d.ts

@@ -1,5 +1,5 @@
 import { q as FileSystemProvider } from '../types-Bb3yccTH.js';
-import { m as ElectronWorkspaceInfo, F as HostEnvironment } from '../types-DBYraXxE.js';
+import { m as ElectronWorkspaceInfo, I as HostEnvironment } from '../types-DhLZZNEn.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.6.1",
+  "version": "2.6.2",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -106,7 +106,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.11.3",
+    "@bendyline/squisq": "2.11.4",
     "zod": "3.25.76"
   }
 }