@nestm/storage 0.1.0-alpha.17 → 0.1.0-alpha.18

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oCAAoC,EAAE,MAAM,kCAAkC,CAAC;AACxF,mBAAmB,kCAAkC,CAAC;AACtD,mBAAmB,iCAAiC,CAAC;AACrD,OAAO,EACL,mCAAmC,EACnC,mCAAmC,EACnC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0CAA0C,GAChD,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,EAClC,KAAK,2CAA2C,EAChD,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,mCAAmC,GACzC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,0CAA0C,EAC/C,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oCAAoC,EAAE,MAAM,kCAAkC,CAAC;AACxF,mBAAmB,kCAAkC,CAAC;AACtD,mBAAmB,iCAAiC,CAAC;AACrD,OAAO,EACL,mCAAmC,EACnC,mCAAmC,EACnC,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0CAA0C,GAChD,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,EAClC,KAAK,2CAA2C,EAChD,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,mCAAmC,GACzC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,KAAK,4BAA4B,EACjC,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACrC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,0CAA0C,EAC/C,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EACL,mBAAmB,EACnB,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC"}

package/dist/workspace/index.js

@@ -6,4 +6,5 @@ export { Aes256GcmStorageWorkspaceCursorCodec, STORAGE_WORKSPACE_CURSOR_VERSION,
 export { createStorageWorkspace, mountStorageWorkspace, } from './storage-workspace.js';
 export { DEFAULT_STORAGE_WORKSPACE_LIMITS, STORAGE_WORKSPACE_PERMISSIONS, } from './storage-workspace.types.js';
 export { checkoutStorageCatalogText } from './storage-catalog-checkout.js';
+export { StorageWorkingFiles, } from './storage-working-files.js';
 //# sourceMappingURL=index.js.map

package/dist/workspace/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oCAAoC,EAAE,MAAM,kCAAkC,CAAC;AAGxF,OAAO,EACL,mCAAmC,EACnC,mCAAmC,EACnC,sBAAsB,EACtB,qBAAqB,GAItB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,GAKnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gCAAgC,EAChC,6BAA6B,GAuB9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC","sourcesContent":["export {\n  StorageWorkspaceError,\n  isStorageWorkspaceError,\n} from './storage-workspace.error.js';\nexport { StorageFileWorkflow } from './storage-file-workflow.js';\nexport { DEFAULT_STORAGE_FILE_WORKFLOW_LIMITS } from './storage-file-workflow.types.js';\nexport type * from './storage-file-workflow.types.js';\nexport type * from './storage-file-catalog.types.js';\nexport {\n  protectStorageFileWorkflowWorkspace,\n  protectStorageFileWorkflowOperation,\n  getStorageFileWorkflow,\n  getStorageFileCatalog,\n  type StorageFileWorkflowProtection,\n  type StorageFileWorkflowWorkspace,\n  type ProtectStorageFileWorkflowWorkspaceOptions,\n} from './storage-file-workflow.protection.js';\nexport {\n  Aes256GcmStorageWorkspaceCursorCodec,\n  STORAGE_WORKSPACE_CURSOR_VERSION,\n  STORAGE_WORKSPACE_MAX_CURSOR_BYTES,\n  type Aes256GcmStorageWorkspaceCursorCodecOptions,\n  type StorageWorkspaceCursorCodec,\n  type StorageWorkspaceCursorConfiguration,\n  type StorageWorkspaceCursorEncodeOptions,\n} from './storage-workspace.cursor.js';\nexport {\n  createStorageWorkspace,\n  mountStorageWorkspace,\n} from './storage-workspace.js';\nexport {\n  DEFAULT_STORAGE_WORKSPACE_LIMITS,\n  STORAGE_WORKSPACE_PERMISSIONS,\n  type MountStorageWorkspaceOptions,\n  type StorageWorkspaceBody,\n  type StorageWorkspaceByteFile,\n  type StorageWorkspaceCopyOptions,\n  type StorageWorkspaceDeleteOptions,\n  type StorageWorkspace,\n  type StorageWorkspaceDirectory,\n  type StorageWorkspaceEntry,\n  type StorageWorkspaceFile,\n  type StorageWorkspaceLimits,\n  type StorageWorkspaceListOptions,\n  type StorageWorkspaceMountOptions,\n  type StorageWorkspaceMutationOptions,\n  type StorageWorkspaceOverwriteOptions,\n  type StorageWorkspacePage,\n  type StorageWorkspacePermission,\n  type StorageWorkspaceReadOptions,\n  type StorageWorkspaceSearchMatch,\n  type StorageWorkspaceSearchOptions,\n  type StorageWorkspaceTextFile,\n  type StorageWorkspaceUnconditionalDeleteOptions,\n  type StorageWorkspaceWriteOptions,\n} from './storage-workspace.types.js';\n\nexport { checkoutStorageCatalogText } from './storage-catalog-checkout.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oCAAoC,EAAE,MAAM,kCAAkC,CAAC;AAGxF,OAAO,EACL,mCAAmC,EACnC,mCAAmC,EACnC,sBAAsB,EACtB,qBAAqB,GAItB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,kCAAkC,GAKnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gCAAgC,EAChC,6BAA6B,GAuB9B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EACL,mBAAmB,GAEpB,MAAM,4BAA4B,CAAC","sourcesContent":["export {\n  StorageWorkspaceError,\n  isStorageWorkspaceError,\n} from './storage-workspace.error.js';\nexport { StorageFileWorkflow } from './storage-file-workflow.js';\nexport { DEFAULT_STORAGE_FILE_WORKFLOW_LIMITS } from './storage-file-workflow.types.js';\nexport type * from './storage-file-workflow.types.js';\nexport type * from './storage-file-catalog.types.js';\nexport {\n  protectStorageFileWorkflowWorkspace,\n  protectStorageFileWorkflowOperation,\n  getStorageFileWorkflow,\n  getStorageFileCatalog,\n  type StorageFileWorkflowProtection,\n  type StorageFileWorkflowWorkspace,\n  type ProtectStorageFileWorkflowWorkspaceOptions,\n} from './storage-file-workflow.protection.js';\nexport {\n  Aes256GcmStorageWorkspaceCursorCodec,\n  STORAGE_WORKSPACE_CURSOR_VERSION,\n  STORAGE_WORKSPACE_MAX_CURSOR_BYTES,\n  type Aes256GcmStorageWorkspaceCursorCodecOptions,\n  type StorageWorkspaceCursorCodec,\n  type StorageWorkspaceCursorConfiguration,\n  type StorageWorkspaceCursorEncodeOptions,\n} from './storage-workspace.cursor.js';\nexport {\n  createStorageWorkspace,\n  mountStorageWorkspace,\n} from './storage-workspace.js';\nexport {\n  DEFAULT_STORAGE_WORKSPACE_LIMITS,\n  STORAGE_WORKSPACE_PERMISSIONS,\n  type MountStorageWorkspaceOptions,\n  type StorageWorkspaceBody,\n  type StorageWorkspaceByteFile,\n  type StorageWorkspaceCopyOptions,\n  type StorageWorkspaceDeleteOptions,\n  type StorageWorkspace,\n  type StorageWorkspaceDirectory,\n  type StorageWorkspaceEntry,\n  type StorageWorkspaceFile,\n  type StorageWorkspaceLimits,\n  type StorageWorkspaceListOptions,\n  type StorageWorkspaceMountOptions,\n  type StorageWorkspaceMutationOptions,\n  type StorageWorkspaceOverwriteOptions,\n  type StorageWorkspacePage,\n  type StorageWorkspacePermission,\n  type StorageWorkspaceReadOptions,\n  type StorageWorkspaceSearchMatch,\n  type StorageWorkspaceSearchOptions,\n  type StorageWorkspaceTextFile,\n  type StorageWorkspaceUnconditionalDeleteOptions,\n  type StorageWorkspaceWriteOptions,\n} from './storage-workspace.types.js';\n\nexport { checkoutStorageCatalogText } from './storage-catalog-checkout.js';\n\nexport {\n  StorageWorkingFiles,\n  type StorageWorkingFile,\n} from './storage-working-files.js';\n"]}

package/dist/workspace/storage-catalog-checkout.d.ts

@@ -1,6 +1,6 @@
 import type { StorageFileCatalogCapability, StorageCatalogCommand } from './storage-file-catalog.types.js';
 import type { StorageFileWorkflowCapability } from './storage-file-workflow.types.js';
-/** Bounded, exact-revision catalog read into a sealed text checkpoint. */
+/** Stream exact catalog windows into a sealed checkpoint without buffering the file. */
 export declare function checkoutStorageCatalogText<Receipt>(catalog: StorageFileCatalogCapability<Receipt>, workflow: StorageFileWorkflowCapability<Receipt>, input: StorageCatalogCommand & {
     readonly expectedEtag: string;
 }): Promise<import("./storage-file-workflow.types.js").StorageFileDraft<Receipt>>;

package/dist/workspace/storage-catalog-checkout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-catalog-checkout.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-catalog-checkout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEtF,0EAA0E;AAC1E,wBAAsB,0BAA0B,CAAC,OAAO,EACtD,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAC9C,QAAQ,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAChD,KAAK,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,iFA8CjE"}
+{"version":3,"file":"storage-catalog-checkout.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-catalog-checkout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEtF,wFAAwF;AACxF,wBAAsB,0BAA0B,CAAC,OAAO,EACtD,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAC9C,QAAQ,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAChD,KAAK,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,iFAkEjE"}

package/dist/workspace/storage-catalog-checkout.js

@@ -1,46 +1,60 @@
 import { StorageError } from '../storage.error.js';
-/** Bounded, exact-revision catalog read into a sealed text checkpoint. */
+/** Stream exact catalog windows into a sealed checkpoint without buffering the file. */
 export async function checkoutStorageCatalogText(catalog, workflow, input) {
     const file = await catalog.stat(input);
     if (file.etag !== input.expectedEtag)
         throw new StorageError('The catalog revision changed.', {
             code: 'CONFLICT',
         });
-    if (file.size > workflow.limits.maxTextBytes)
-        throw new StorageError('Checkout exceeds the buffered text limit.', {
-            code: 'LIMIT_EXCEEDED',
-        });
-    const pieces = [];
-    let offset = 0;
-    do {
-        const page = await catalog.readWindow({ ...input, offset });
-        if (page.etag !== input.expectedEtag ||
-            page.totalBytes !== file.size ||
-            page.offset !== offset)
-            throw new StorageError('The catalog revision changed.', {
-                code: 'CONFLICT',
-            });
-        if (page.content === null)
-            throw new StorageError('Checkout requires a text file.', {
-                code: 'INVALID_ARGUMENT',
-            });
-        const next = offset + new TextEncoder().encode(page.content).byteLength;
-        if (next > file.size ||
-            (page.nextOffset === null
-                ? next !== file.size
-                : page.nextOffset !== next || next <= offset))
-            throw new StorageError('Invalid catalog text window.', {
-                code: 'PROVIDER',
-            });
-        pieces.push(page.content);
-        offset = next;
-        if (page.nextOffset === null)
-            break;
-    } while (offset < file.size);
-    return workflow.stageText({
-        ...input,
-        content: pieces.join(''),
+    return workflow.stageStream({
+        path: input.path,
+        expectedEtag: input.expectedEtag,
+        text: true,
+        signal: input.signal,
         idempotencyKey: input.commandId,
+        contentIdentity: JSON.stringify([file.fileId, file.etag, file.size]),
+        body: () => {
+            let offset = 0;
+            return new ReadableStream({
+                async pull(controller) {
+                    try {
+                        const page = await catalog.readWindow({ ...input, offset });
+                        if (page.etag !== input.expectedEtag ||
+                            page.totalBytes !== file.size ||
+                            page.offset !== offset)
+                            throw new StorageError('The catalog revision changed.', {
+                                code: 'CONFLICT',
+                            });
+                        if (page.content === null)
+                            throw new StorageError('Checkout requires a text file.', {
+                                code: 'INVALID_ARGUMENT',
+                            });
+                        const next = offset + new TextEncoder().encode(page.content).byteLength;
+                        if (next > file.size ||
+                            (page.nextOffset === null
+                                ? next !== file.size
+                                : page.nextOffset !== next || next <= offset))
+                            throw new StorageError('Invalid catalog text window.', {
+                                code: 'PROVIDER',
+                            });
+                        controller.enqueue(new TextEncoder().encode(page.content));
+                        offset = next;
+                        if (page.nextOffset === null) {
+                            const current = await catalog.stat(input);
+                            if (current.etag !== input.expectedEtag ||
+                                current.size !== file.size)
+                                throw new StorageError('The catalog revision changed.', {
+                                    code: 'CONFLICT',
+                                });
+                            controller.close();
+                        }
+                    }
+                    catch (error) {
+                        controller.error(error);
+                    }
+                },
+            }, { highWaterMark: 0 });
+        },
     });
 }
 //# sourceMappingURL=storage-catalog-checkout.js.map

package/dist/workspace/storage-catalog-checkout.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage-catalog-checkout.js","sourceRoot":"","sources":["../../src/workspace/storage-catalog-checkout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOnD,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAA8C,EAC9C,QAAgD,EAChD,KAAgE;IAEhE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,YAAY;QAClC,MAAM,IAAI,YAAY,CAAC,+BAA+B,EAAE;YACtD,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;IACL,IAAI,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY;QAC1C,MAAM,IAAI,YAAY,CAAC,2CAA2C,EAAE;YAClE,IAAI,EAAE,gBAAgB;SACvB,CAAC,CAAC;IACL,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,GAAG,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5D,IACE,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,YAAY;YAChC,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,IAAI;YAC7B,IAAI,CAAC,MAAM,KAAK,MAAM;YAEtB,MAAM,IAAI,YAAY,CAAC,+BAA+B,EAAE;gBACtD,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;QACL,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YACvB,MAAM,IAAI,YAAY,CAAC,gCAAgC,EAAE;gBACvD,IAAI,EAAE,kBAAkB;aACzB,CAAC,CAAC;QACL,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC;QACxE,IACE,IAAI,GAAG,IAAI,CAAC,IAAI;YAChB,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI;gBACvB,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;gBACpB,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC;YAE/C,MAAM,IAAI,YAAY,CAAC,8BAA8B,EAAE;gBACrD,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;QACL,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;YAAE,MAAM;IACtC,CAAC,QAAQ,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE;IAC7B,OAAO,QAAQ,CAAC,SAAS,CAAC;QACxB,GAAG,KAAK;QACR,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,cAAc,EAAE,KAAK,CAAC,SAAS;KAChC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { StorageError } from '../storage.error.js';\nimport type {\n  StorageFileCatalogCapability,\n  StorageCatalogCommand,\n} from './storage-file-catalog.types.js';\nimport type { StorageFileWorkflowCapability } from './storage-file-workflow.types.js';\n\n/** Bounded, exact-revision catalog read into a sealed text checkpoint. */\nexport async function checkoutStorageCatalogText<Receipt>(\n  catalog: StorageFileCatalogCapability<Receipt>,\n  workflow: StorageFileWorkflowCapability<Receipt>,\n  input: StorageCatalogCommand & { readonly expectedEtag: string },\n) {\n  const file = await catalog.stat(input);\n  if (file.etag !== input.expectedEtag)\n    throw new StorageError('The catalog revision changed.', {\n      code: 'CONFLICT',\n    });\n  if (file.size > workflow.limits.maxTextBytes)\n    throw new StorageError('Checkout exceeds the buffered text limit.', {\n      code: 'LIMIT_EXCEEDED',\n    });\n  const pieces: string[] = [];\n  let offset = 0;\n  do {\n    const page = await catalog.readWindow({ ...input, offset });\n    if (\n      page.etag !== input.expectedEtag ||\n      page.totalBytes !== file.size ||\n      page.offset !== offset\n    )\n      throw new StorageError('The catalog revision changed.', {\n        code: 'CONFLICT',\n      });\n    if (page.content === null)\n      throw new StorageError('Checkout requires a text file.', {\n        code: 'INVALID_ARGUMENT',\n      });\n    const next = offset + new TextEncoder().encode(page.content).byteLength;\n    if (\n      next > file.size ||\n      (page.nextOffset === null\n        ? next !== file.size\n        : page.nextOffset !== next || next <= offset)\n    )\n      throw new StorageError('Invalid catalog text window.', {\n        code: 'PROVIDER',\n      });\n    pieces.push(page.content);\n    offset = next;\n    if (page.nextOffset === null) break;\n  } while (offset < file.size);\n  return workflow.stageText({\n    ...input,\n    content: pieces.join(''),\n    idempotencyKey: input.commandId,\n  });\n}\n"]}
+{"version":3,"file":"storage-catalog-checkout.js","sourceRoot":"","sources":["../../src/workspace/storage-catalog-checkout.ts"],"names":[],"mappings":"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","sourcesContent":["import { StorageError } from '../storage.error.js';\nimport type {\n  StorageFileCatalogCapability,\n  StorageCatalogCommand,\n} from './storage-file-catalog.types.js';\nimport type { StorageFileWorkflowCapability } from './storage-file-workflow.types.js';\n\n/** Stream exact catalog windows into a sealed checkpoint without buffering the file. */\nexport async function checkoutStorageCatalogText<Receipt>(\n  catalog: StorageFileCatalogCapability<Receipt>,\n  workflow: StorageFileWorkflowCapability<Receipt>,\n  input: StorageCatalogCommand & { readonly expectedEtag: string },\n) {\n  const file = await catalog.stat(input);\n  if (file.etag !== input.expectedEtag)\n    throw new StorageError('The catalog revision changed.', {\n      code: 'CONFLICT',\n    });\n  return workflow.stageStream({\n    path: input.path,\n    expectedEtag: input.expectedEtag,\n    text: true,\n    signal: input.signal,\n    idempotencyKey: input.commandId,\n    contentIdentity: JSON.stringify([file.fileId, file.etag, file.size]),\n    body: () => {\n      let offset = 0;\n      return new ReadableStream<Uint8Array>(\n        {\n          async pull(controller) {\n            try {\n              const page = await catalog.readWindow({ ...input, offset });\n              if (\n                page.etag !== input.expectedEtag ||\n                page.totalBytes !== file.size ||\n                page.offset !== offset\n              )\n                throw new StorageError('The catalog revision changed.', {\n                  code: 'CONFLICT',\n                });\n              if (page.content === null)\n                throw new StorageError('Checkout requires a text file.', {\n                  code: 'INVALID_ARGUMENT',\n                });\n              const next =\n                offset + new TextEncoder().encode(page.content).byteLength;\n              if (\n                next > file.size ||\n                (page.nextOffset === null\n                  ? next !== file.size\n                  : page.nextOffset !== next || next <= offset)\n              )\n                throw new StorageError('Invalid catalog text window.', {\n                  code: 'PROVIDER',\n                });\n              controller.enqueue(new TextEncoder().encode(page.content));\n              offset = next;\n              if (page.nextOffset === null) {\n                const current = await catalog.stat(input);\n                if (\n                  current.etag !== input.expectedEtag ||\n                  current.size !== file.size\n                )\n                  throw new StorageError('The catalog revision changed.', {\n                    code: 'CONFLICT',\n                  });\n                controller.close();\n              }\n            } catch (error) {\n              controller.error(error);\n            }\n          },\n        },\n        { highWaterMark: 0 },\n      );\n    },\n  });\n}\n"]}

package/dist/workspace/storage-draft-stream.d.ts

@@ -0,0 +1,3 @@
+/** Bounded byte rechunking; each text chunk ends at a complete Unicode scalar. */
+export declare function chunkStorageDraftStream(source: ReadableStream<Uint8Array>, maxBytes: number, text: boolean, signal: AbortSignal): AsyncGenerator<Uint8Array<ArrayBufferLike>, void, unknown>;
+//# sourceMappingURL=storage-draft-stream.d.ts.map

package/dist/workspace/storage-draft-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-draft-stream.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-draft-stream.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,wBAAuB,uBAAuB,CAC5C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,WAAW,8DAiDpB"}

package/dist/workspace/storage-draft-stream.js

@@ -0,0 +1,57 @@
+import { trimStorageUtf8Chunk } from '../bytes/index.js';
+import { StorageError } from '../storage.error.js';
+/** Bounded byte rechunking; each text chunk ends at a complete Unicode scalar. */
+export async function* chunkStorageDraftStream(source, maxBytes, text, signal) {
+    if (maxBytes < (text ? 4 : 1)) {
+        await source.cancel().catch(() => { });
+        throw new StorageError('Chunk limit is too small.', {
+            code: 'LIMIT_EXCEEDED',
+        });
+    }
+    let buffer = new Uint8Array(maxBytes);
+    let filled = 0;
+    const reader = source.getReader();
+    const abort = () => {
+        void reader.cancel(signal.reason).catch(() => { });
+    };
+    signal.addEventListener('abort', abort, { once: true });
+    try {
+        signal.throwIfAborted();
+        for (;;) {
+            const next = await reader.read();
+            signal.throwIfAborted();
+            if (next.done)
+                break;
+            for (let at = 0; at < next.value.length;) {
+                const count = Math.min(maxBytes - filled, next.value.length - at);
+                buffer.set(next.value.subarray(at, at + count), filled);
+                filled += count;
+                at += count;
+                if (filled === maxBytes) {
+                    const complete = text
+                        ? trimStorageUtf8Chunk(buffer, { final: false })
+                        : buffer;
+                    if (text)
+                        new TextDecoder('utf-8', { fatal: true }).decode(complete);
+                    yield complete;
+                    const rest = buffer.subarray(complete.length);
+                    buffer = new Uint8Array(maxBytes);
+                    buffer.set(rest);
+                    filled = rest.length;
+                }
+            }
+        }
+        if (filled) {
+            const final = buffer.subarray(0, filled);
+            if (text)
+                new TextDecoder('utf-8', { fatal: true }).decode(final);
+            yield final;
+        }
+    }
+    finally {
+        signal.removeEventListener('abort', abort);
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}
+//# sourceMappingURL=storage-draft-stream.js.map

package/dist/workspace/storage-draft-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-draft-stream.js","sourceRoot":"","sources":["../../src/workspace/storage-draft-stream.ts"],"names":[],"mappings":"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","sourcesContent":["import { trimStorageUtf8Chunk } from '../bytes/index.js';\nimport { StorageError } from '../storage.error.js';\n\n/** Bounded byte rechunking; each text chunk ends at a complete Unicode scalar. */\nexport async function* chunkStorageDraftStream(\n  source: ReadableStream<Uint8Array>,\n  maxBytes: number,\n  text: boolean,\n  signal: AbortSignal,\n) {\n  if (maxBytes < (text ? 4 : 1)) {\n    await source.cancel().catch(() => {});\n    throw new StorageError('Chunk limit is too small.', {\n      code: 'LIMIT_EXCEEDED',\n    });\n  }\n  let buffer = new Uint8Array(maxBytes);\n  let filled = 0;\n  const reader = source.getReader();\n  const abort = () => {\n    void reader.cancel(signal.reason).catch(() => {});\n  };\n  signal.addEventListener('abort', abort, { once: true });\n  try {\n    signal.throwIfAborted();\n    for (;;) {\n      const next = await reader.read();\n      signal.throwIfAborted();\n      if (next.done) break;\n      for (let at = 0; at < next.value.length;) {\n        const count = Math.min(maxBytes - filled, next.value.length - at);\n        buffer.set(next.value.subarray(at, at + count), filled);\n        filled += count;\n        at += count;\n        if (filled === maxBytes) {\n          const complete = text\n            ? trimStorageUtf8Chunk(buffer, { final: false })\n            : buffer;\n          if (text) new TextDecoder('utf-8', { fatal: true }).decode(complete);\n          yield complete;\n          const rest = buffer.subarray(complete.length);\n          buffer = new Uint8Array(maxBytes);\n          buffer.set(rest);\n          filled = rest.length;\n        }\n      }\n    }\n    if (filled) {\n      const final = buffer.subarray(0, filled);\n      if (text) new TextDecoder('utf-8', { fatal: true }).decode(final);\n      yield final;\n    }\n  } finally {\n    signal.removeEventListener('abort', abort);\n    await reader.cancel().catch(() => {});\n    reader.releaseLock();\n  }\n}\n"]}

package/dist/workspace/storage-file-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-file-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-file-workflow.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,+BAA+B,EAGpC,KAAK,6BAA6B,EAGlC,KAAK,0BAA0B,EAIhC,MAAM,kCAAkC,CAAC;AAE1C,qBAAa,mBAAmB,CAAC,KAAK,EAAE,OAAO;;IAE7C,YAAY,OAAO,EAAE,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,EAE9D;IAED,KAAK,CACH,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,+BAAoC,GAC5C,6BAA6B,CAAC,OAAO,CAAC,CAoiBxC;CA6FF"}
+{"version":3,"file":"storage-file-workflow.d.ts","sourceRoot":"","sources":["../../src/workspace/storage-file-workflow.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,+BAA+B,EAGpC,KAAK,6BAA6B,EAGlC,KAAK,0BAA0B,EAIhC,MAAM,kCAAkC,CAAC;AAE1C,qBAAa,mBAAmB,CAAC,KAAK,EAAE,OAAO;;IAE7C,YAAY,OAAO,EAAE,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,EAE9D;IAED,KAAK,CACH,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,+BAAoC,GAC5C,6BAA6B,CAAC,OAAO,CAAC,CAkpBxC;CA6FF"}

package/dist/workspace/storage-file-workflow.js

@@ -1,4 +1,5 @@
-import { applyStorageTextEdit } from '../core/storage-text-edit.js';
+import { searchStorageText } from '../core/storage-text.js';
+import { editStorageTextStream } from '../core/storage-text-stream-edit.js';
 import { stageStorageTextDraft } from './storage-text-draft.js';
 import { createHash, randomUUID } from 'node:crypto';
 import { StorageError } from '../storage.error.js';
@@ -59,6 +60,14 @@ export class StorageFileWorkflow {
                     signal: AbortSignal.any([boundSignal, restriction.signal].filter((signal) => signal !== undefined)),
                 });
             },
+            lookup: async (input) => {
+                const signal = operation('read', input);
+                validateIdentity(input.idempotencyKey);
+                return transaction(signal, async (tx) => {
+                    const draft = await tx.findDraftByKey(input.idempotencyKey);
+                    return draft === null ? null : summary(draft);
+                });
+            },
             begin: async (input) => {
                 const signal = operation('write', input);
                 requireMutation(input.expectedEtag);
@@ -138,6 +147,61 @@ export class StorageFileWorkflow {
                     }),
                 }));
             },
+            stageStream: async (request) => {
+                const input = { ...request };
+                if (input.sourceDraftId !== undefined)
+                    operation('read', input);
+                const signal = operation('write', input);
+                requireMutation(input.expectedEtag);
+                validateIdentity(input.idempotencyKey);
+                assertWorkspacePath(input.path, limits.maxPathBytes, {
+                    allowRoot: false,
+                });
+                if (typeof input.text !== 'boolean' ||
+                    typeof input.contentIdentity !== 'string' ||
+                    !input.contentIdentity.length ||
+                    input.contentIdentity.length > 1024)
+                    invalid('Invalid streaming draft identity.');
+                if (input.expectedEtag !== undefined &&
+                    (!input.expectedEtag.length || input.expectedEtag.length > 1024))
+                    invalid('Invalid ETag.');
+                return summary(await stageStorageTextDraft({
+                    scope,
+                    signal,
+                    limits,
+                    content,
+                    requireMutation,
+                    transaction: (work) => transaction(signal, work),
+                    idempotencyKey: input.idempotencyKey,
+                    fingerprint: digest(new TextEncoder().encode(JSON.stringify([
+                        'stage-stream',
+                        input.path,
+                        input.expectedEtag ?? null,
+                        input.text,
+                        input.contentIdentity,
+                        input.sourceDraftId ?? null,
+                        input.expectedSize ?? null,
+                    ]))),
+                    load: async () => {
+                        const source = input.sourceDraftId === undefined
+                            ? null
+                            : await transaction(signal, (tx) => requireDraft(tx, input.sourceDraftId));
+                        if (source !== null &&
+                            (source.path !== input.path ||
+                                source.expectedEtag !== (input.expectedEtag ?? null) ||
+                                source.size !== input.expectedSize ||
+                                !['open', 'sealed'].includes(source.status)))
+                            conflict('The source checkpoint changed.');
+                        return {
+                            path: input.path,
+                            expectedEtag: input.expectedEtag ?? null,
+                            source,
+                            text: input.text,
+                            content: input.body(),
+                        };
+                    },
+                }));
+            },
             reviseText: async (request) => {
                 const input = {
                     ...request,
@@ -147,10 +211,11 @@ export class StorageFileWorkflow {
                 const signal = operation('write', input);
                 validateIdentity(input.idempotencyKey);
                 validateIdentity(input.draftId);
+                if (input.requestIdentity !== undefined &&
+                    input.requestIdentity.length > 4096)
+                    invalid('Invalid edit request identity.');
                 storageInteger(input.expectedSize, 'expectedSize');
-                if (input.expectedSize > limits.maxTextBytes ||
-                    input.changes.length < 1 ||
-                    input.changes.length > limits.maxEdits)
+                if (input.changes.length < 1 || input.changes.length > limits.maxEdits)
                     throw new StorageError('Text editing exceeds the configured limits.', { code: 'LIMIT_EXCEEDED' });
                 return summary(await stageStorageTextDraft({
                     scope,
@@ -165,6 +230,9 @@ export class StorageFileWorkflow {
                         input.draftId,
                         input.expectedSize,
                         input.changes,
+                        ...(input.requestIdentity === undefined
+                            ? []
+                            : [input.requestIdentity]),
                     ]))),
                     load: async () => {
                         const source = await transaction(signal, (tx) => requireDraft(tx, input.draftId));
@@ -173,16 +241,15 @@ export class StorageFileWorkflow {
                             !['open', 'sealed'].includes(source.status) ||
                             source.size !== input.expectedSize)
                             conflict('The source must be an unfinished text draft at the expected size.');
-                        const bytes = await collectStorageBytes(this.#stream(scope, source, limits, signal), limits.maxTextBytes, signal);
-                        const original = new TextDecoder('utf-8', {
-                            fatal: true,
-                            ignoreBOM: true,
-                        }).decode(bytes);
                         return {
                             source,
                             path: source.path,
                             expectedEtag: source.expectedEtag,
-                            content: applyStorageTextEdit(original, { kind: 'batch', changes: input.changes }, { maxBytes: limits.maxTextBytes, maxEdits: limits.maxEdits }),
+                            content: editStorageTextStream(this.#stream(scope, source, limits, signal), input.changes, {
+                                maxEditBytes: limits.maxTextBytes,
+                                maxEdits: limits.maxEdits,
+                                signal,
+                            }),
                         };
                     },
                 }));
@@ -222,6 +289,25 @@ export class StorageFileWorkflow {
                     : { content: null, offset, nextOffset: null };
                 return { ...summary(draft), ...window };
             },
+            searchText: async (input) => {
+                const signal = operation('read', input);
+                const draft = await transaction(signal, (tx) => requireDraft(tx, input.draftId));
+                if (!draft.text ||
+                    draft.status === 'cancelled' ||
+                    draft.size !== input.expectedSize)
+                    conflict('The source checkpoint changed.');
+                const result = await searchStorageText(async (range) => this.#stream(scope, draft, limits, signal, range.start, range.end + 1), {
+                    size: draft.size,
+                    query: input.query,
+                    offset: input.offset,
+                    maxScanBytes: 262144,
+                    maxMatches: 12,
+                    maxSnippetCharacters: 320,
+                    maxReadBytes: limits.maxReadBytes,
+                    signal,
+                });
+                return { ...result, path: draft.path, etag: draft.id };
+            },
             readText: async (request) => {
                 const input = { ...request };
                 const signal = operation('read', input);