@interop/was-client 0.12.0 → 0.13.0

package/dist/Resource.js

@@ -1,19 +1,47 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * A navigational handle to a single Resource (a JSON object or binary blob
+ * keyed by id within a Collection). Sugar over the Collection item operations,
+ * with explicit `getText()` / `getBytes()` escape hatches.
+ */
 import { resourcePath, resourcePolicy, resourceMeta } from './internal/paths.js';
 import { assertNotReserved } from './internal/reserved.js';
 import { send } from './internal/request.js';
-import { CodecHolder, resolveCodec, readCollectionMarker } from './internal/codec.js';
+import { CodecHolder, resolveCodec } from './internal/codec.js';
 import { writeHeaders, readEtag } from './internal/conditional.js';
-import { sendEncodedWrite } from './internal/write.js';
+import { upsertResource } from './internal/write.js';
 import { readPolicy, writePolicy, deletePolicy } from './internal/policy.js';
+/**
+ * A shared `TextEncoder` for re-serializing a pre-parsed JSON body to bytes in
+ * `getBytes()` (stateless, so one instance is reused).
+ */
+const ENCODER = new TextEncoder();
 export class Resource {
     spaceId;
     collectionId;
     id;
     _context;
     _capability;
-    _codecThunk;
-    _encryptionOverride;
-    _codecHolder;
+    /**
+     * Resolves the codec for this resource: the parent collection's shared codec
+     * when this handle came from `collection.resource(id)`, otherwise one
+     * resolved (and memoized per handle) for its own collection. A standalone
+     * resource discovers its collection's `encryption` marker (one GET on the
+     * collection, cached per handle) unless a per-handle override is set, and
+     * fails closed if it cannot key an encrypted collection. A fresh standalone
+     * handle re-reads the marker, so retain the handle to reuse it. A failed
+     * resolution (e.g. a transient 500/network error during marker discovery) is
+     * not memoized: the cache is cleared so the next call retries rather than
+     * re-throwing the stale error forever.
+     *
+     * A handle obtained via `collection.resource(id)` delegates to the parent's
+     * shared resolver on every call rather than memoizing locally: the parent
+     * already memoizes (so this adds no round-trip), and delegating lets a parent
+     * reset (e.g. after `configure()` adds the encryption marker) propagate here.
+     */
+    _codec;
     /**
      * @param options {object}
      * @param options.context {ClientContext}
@@ -38,53 +66,28 @@ export class Resource {
         // collision exists for `backend` / `quota` / `linkset` / `meta`. Guarding in
         // the constructor covers every operation (read, delete, meta, policy, put),
         // not just writes.
-        assertNotReserved(resourceId, 'resource');
+        assertNotReserved({ id: resourceId, kind: 'resource' });
         this._context = context;
         this.spaceId = spaceId;
         this.collectionId = collectionId;
         this.id = resourceId;
         this._capability = capability;
-        this._codecThunk = codec;
-        this._encryptionOverride = encryption;
-        this._codecHolder = new CodecHolder(() => resolveCodec(this._context, {
-            spaceId: this.spaceId,
-            collectionId: this.collectionId,
-            override: this._encryptionOverride,
-            readMarker: () => readCollectionMarker(this._context, {
+        if (codec) {
+            this._codec = codec;
+        }
+        else {
+            const holder = new CodecHolder(() => resolveCodec(this._context, {
                 spaceId: this.spaceId,
                 collectionId: this.collectionId,
+                override: encryption,
                 capability: this._capability
-            })
-        }));
+            }));
+            this._codec = () => holder.get();
+        }
     }
     get _path() {
         return resourcePath(this.spaceId, this.collectionId, this.id);
     }
-    /**
-     * Resolves (once, then caches) the codec for this resource: the parent
-     * collection's shared codec when this handle came from
-     * `collection.resource(id)`, otherwise one resolved for its own collection. A
-     * standalone resource discovers its collection's `encryption` marker (one GET
-     * on the collection, cached per handle) unless a per-handle override is set,
-     * and fails closed if it cannot key an encrypted collection. A fresh
-     * standalone handle re-reads the marker, so retain the handle to reuse it. A
-     * failed resolution (e.g. a transient 500/network error during marker
-     * discovery) is not memoized: the cache is cleared so the next call retries
-     * rather than re-throwing the stale error forever.
-     *
-     * A handle obtained via `collection.resource(id)` delegates to the parent's
-     * shared thunk on every call rather than memoizing locally: the parent already
-     * memoizes (so this adds no round-trip), and delegating lets a parent reset
-     * (e.g. after `configure()` adds the encryption marker) propagate here.
-     *
-     * @returns {Promise<ResourceCodec>}
-     */
-    _codec() {
-        if (this._codecThunk) {
-            return this._codecThunk();
-        }
-        return this._codecHolder.get();
-    }
     /**
      * Reads the resource, auto-parsing JSON to an object and returning binary as
      * a `Blob`. Returns `null` if the resource is missing or not visible to you
@@ -108,6 +111,12 @@ export class Resource {
      * codec, so on an encrypted collection it never decrypts -- use `get()` to
      * decrypt.
      *
+     * For a JSON content-type the request layer has already consumed and parsed
+     * the body stream (`@interop/http-client` offers no opt-out through ezcap),
+     * so the text is re-serialized from the parsed value: semantically identical
+     * JSON, but not guaranteed byte-identical to what was uploaded (insignificant
+     * whitespace is not preserved).
+     *
      * @returns {Promise<string | null>}
      */
     async getText() {
@@ -117,7 +126,13 @@ export class Resource {
             capability: this._capability,
             read: true
         });
-        return response === null ? null : response.text();
+        if (response === null) {
+            return null;
+        }
+        if (response.data !== undefined) {
+            return JSON.stringify(response.data);
+        }
+        return response.text();
     }
     /**
      * Reads the resource body as raw bytes. Returns `null` on a
@@ -125,6 +140,12 @@ export class Resource {
      * it does NOT run the codec, so on an encrypted collection it never decrypts
      * -- use `get()` to decrypt.
      *
+     * For a JSON content-type the request layer has already consumed and parsed
+     * the body stream (`@interop/http-client` offers no opt-out through ezcap),
+     * so the bytes are re-serialized from the parsed value: semantically
+     * identical JSON, but not guaranteed byte-identical to what was uploaded
+     * (insignificant whitespace is not preserved).
+     *
      * @returns {Promise<Uint8Array | null>}
      */
     async getBytes() {
@@ -137,6 +158,9 @@ export class Resource {
         if (response === null) {
             return null;
         }
+        if (response.data !== undefined) {
+            return ENCODER.encode(JSON.stringify(response.data));
+        }
         return new Uint8Array(await response.arrayBuffer());
     }
     /**
@@ -155,7 +179,10 @@ export class Resource {
      * `ifNoneMatch: true` for a create-if-absent. A failed precondition throws
      * `PreconditionFailedError` (412). On an encrypted collection these are managed
      * automatically by the codec (the EDV `sequence` becomes the enforced ETag), so
-     * the explicit options are for plaintext collections. Returns the new `etag`.
+     * the explicit options are for plaintext collections -- and because the codec
+     * pre-reads the current document to compute them, updating an existing
+     * encrypted document needs read access (a PUT-only capability can only create;
+     * see `upsertResource`). Returns the new `etag`.
      *
      * @param data {ResourceData}
      * @param options {object}
@@ -166,35 +193,17 @@ export class Resource {
      */
     async put(data, options = {}) {
         const codec = await this._codec();
-        // A conditional codec (e.g. the EDV codec) needs the current stored envelope
-        // to advance its sequence and pin the write to the current ETag, so pre-read
-        // it. A plaintext codec needs no pre-read.
-        let current;
-        if (codec.conditionalWrites) {
-            current = await send(this._context, {
-                path: this._path,
-                method: 'GET',
-                capability: this._capability,
-                read: true
-            });
-        }
-        const encoded = await codec.encode({
+        const response = await upsertResource(this._context, {
+            path: this._path,
+            codec,
             id: this.id,
             data,
             contentType: options.contentType,
-            current
-        });
-        // A conditional codec computes the precondition itself (from the sequence /
-        // ETag); a plaintext codec defers to the caller's explicit options.
-        const precondition = codec.conditionalWrites
-            ? { ifMatch: encoded.ifMatch, ifNoneMatch: encoded.ifNoneMatch }
-            : { ifMatch: options.ifMatch, ifNoneMatch: options.ifNoneMatch };
-        const response = await sendEncodedWrite(this._context, {
-            path: this._path,
-            method: 'PUT',
             capability: this._capability,
-            encoded,
-            precondition
+            precondition: {
+                ifMatch: options.ifMatch,
+                ifNoneMatch: options.ifNoneMatch
+            }
         });
         return { etag: readEtag(response) };
     }
@@ -215,7 +224,7 @@ export class Resource {
             // A conditional delete is not idempotent: a stale `If-Match` must surface
             // as a 412 rather than being swallowed as an absent-target success.
             idempotent: options.ifMatch === undefined,
-            headers: writeHeaders(undefined, { ifMatch: options.ifMatch })
+            headers: writeHeaders({ precondition: { ifMatch: options.ifMatch } })
         });
     }
     get _metaPath() {
@@ -291,9 +300,11 @@ export class Resource {
             method: 'PUT',
             capability: this._capability,
             json: { custom },
-            headers: writeHeaders(undefined, {
-                ifMatch: options.ifMatch,
-                ifNoneMatch: options.ifNoneMatch
+            headers: writeHeaders({
+                precondition: {
+                    ifMatch: options.ifMatch,
+                    ifNoneMatch: options.ifNoneMatch
+                }
             })
         });
         return { etag: readEtag(response) };
@@ -301,24 +312,28 @@ export class Resource {
     /**
      * Sets the resource's human-readable `name` (the value surfaced in collection
      * listings), preserving any existing `tags`. Convenience over `setMeta()`.
+     * The write is pinned to the `etag` the `meta()` read returned (when the
+     * backend supports `conditional-writes`), so a concurrent metadata write
+     * surfaces as `PreconditionFailedError` instead of being silently erased by
+     * this full-replacement write.
      *
      * @param name {string}
      * @returns {Promise<void>}
      */
     async setName(name) {
         const current = await this.meta();
-        await this.setMeta({ custom: { ...current?.custom, name } });
+        await this.setMeta({ custom: { ...current?.custom, name } }, { ifMatch: current?.etag });
     }
     /**
      * Sets the resource's `tags`, preserving any existing `name`. Convenience over
-     * `setMeta()`.
+     * `setMeta()`. Pinned to the `meta()` read's `etag` like {@link setName}.
      *
      * @param tags {Record<string, string>}
      * @returns {Promise<void>}
      */
     async setTags(tags) {
         const current = await this.meta();
-        await this.setMeta({ custom: { ...current?.custom, tags } });
+        await this.setMeta({ custom: { ...current?.custom, tags } }, { ifMatch: current?.etag });
     }
     get _policyPath() {
         return resourcePolicy(this.spaceId, this.collectionId, this.id);

package/dist/Resource.js.map

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

package/dist/Space.d.ts

@@ -164,12 +164,55 @@ export declare class Space {
      * @returns {Promise<IDelegatedZcap>}
      */
     grant(options: GrantOptions): Promise<IDelegatedZcap>;
+    /**
+     * Sends the export request and returns the raw response with its body stream
+     * intact, shared by `export`/`exportBlob`/`exportStream`.
+     *
+     * Guards the JSON-mislabel edge: `@interop/http-client` pre-consumes a
+     * response body into `.data` for JSON content-types, so a non-conformant
+     * server that labels the tar archive `application/json` would leave us a dead
+     * stream. Detecting the consumed body here fails with a typed `WasServerError`
+     * naming the mislabeled content-type, rather than a raw "body stream already
+     * read" `TypeError` downstream.
+     *
+     * @returns {Promise<HttpResponse>}
+     */
+    private _exportResponse;
     /**
      * Exports the whole space as a tar (`application/x-tar`) archive.
      *
+     * The entire archive is buffered into memory (a `Uint8Array` cannot be
+     * produced incrementally), so exporting a very large space costs its full
+     * size in RAM. For a constant-memory path use {@link exportStream}; for the
+     * `import()` companion container use {@link exportBlob}.
+     *
      * @returns {Promise<Uint8Array>}
      */
     export(): Promise<Uint8Array>;
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive, as a Blob
+     * typed `application/x-tar`. Pairs directly with `import(tar)`, so copying a
+     * space is `spaceB.import(await spaceA.exportBlob())`.
+     *
+     * Note: in Node a Blob is memory-backed, so this does not reduce peak memory
+     * versus {@link export} -- it is a typed-container convenience (browsers may
+     * spill large Blobs to disk). For the true constant-memory path use
+     * {@link exportStream}.
+     *
+     * @returns {Promise<Blob>}
+     */
+    exportBlob(): Promise<Blob>;
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive, as a lazily
+     * consumed byte stream -- constant memory, for piping to a file, a
+     * `CompressionStream`, or another request.
+     *
+     * The stream must be consumed or cancelled; an abandoned stream holds its
+     * connection open.
+     *
+     * @returns {Promise<ReadableStream<Uint8Array>>}
+     */
+    exportStream(): Promise<ReadableStream<Uint8Array>>;
     /**
      * Imports (merges) a tar archive into the space.
      *

package/dist/Space.d.ts.map

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

package/dist/Space.js

@@ -1,16 +1,8 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * A navigational handle to a Space. Exposes its own lifecycle
- * (`describe`/`configure`/`delete`), contained Collections
- * (`collection`/`createCollection`/`collections`), delegation (`grant`), and
- * whole-space `export`/`import`.
- */
-import { spacePath, spaceItems, spaceCollections, spaceExport, spaceImport, spaceBackends, registeredBackend, spaceQuotas, spacePolicy, spaceLinkset, toUrl } from './internal/paths.js';
+import { spacePath, spaceItems, spaceCollections, spaceExport, spaceImport, spaceBackends, registeredBackend, spaceQuotas, spacePolicy, spaceLinkset } from './internal/paths.js';
 import { assertNotReserved } from './internal/reserved.js';
-import { delegateGrant } from './internal/grant.js';
-import { send } from './internal/request.js';
+import { delegateGrantAt } from './internal/grant.js';
+import { send, readData } from './internal/request.js';
+import { WasServerError } from './errors.js';
 import { createdId, dataOrNull, toPlainBytes } from './internal/content.js';
 import { readPolicy, writePolicy, deletePolicy } from './internal/policy.js';
 import { Collection } from './Collection.js';
@@ -42,13 +34,10 @@ export class Space {
      * @returns {Promise<SpaceDescription | null>}
      */
     async describe() {
-        const response = await send(this._context, {
+        return readData(this._context, {
             path: this._path,
-            method: 'GET',
-            capability: this._capability,
-            read: true
+            capability: this._capability
         });
-        return dataOrNull(response);
     }
     /**
      * Creates or updates the space by id (upsert). Merges the given fields over
@@ -124,7 +113,7 @@ export class Space {
      */
     async createCollection(desc = {}) {
         if (desc.id !== undefined) {
-            assertNotReserved(desc.id, 'collection');
+            assertNotReserved({ id: desc.id, kind: 'collection' });
         }
         const body = {};
         if (desc.id !== undefined) {
@@ -160,13 +149,10 @@ export class Space {
      * @returns {Promise<CollectionsList | null>}
      */
     async collections() {
-        const response = await send(this._context, {
+        return readData(this._context, {
             path: spaceCollections(this.id),
-            method: 'GET',
-            capability: this._capability,
-            read: true
+            capability: this._capability
         });
-        return dataOrNull(response);
     }
     /**
      * Lists the storage backends available within this space. Returns `null` if
@@ -180,13 +166,10 @@ export class Space {
      * @returns {Promise<BackendDescriptor[] | null>}
      */
     async backends() {
-        const response = await send(this._context, {
+        return readData(this._context, {
             path: spaceBackends(this.id),
-            method: 'GET',
-            capability: this._capability,
-            read: true
+            capability: this._capability
         });
-        return dataOrNull(response);
     }
     /**
      * Registers a new `external` ("Bring Your Own Storage") backend against this
@@ -213,7 +196,8 @@ export class Space {
             capability: this._capability,
             json: registration
         });
-        return response.data;
+        // A successful registration always carries the sanitized descriptor body.
+        return dataOrNull(response);
     }
     /**
      * Creates or replaces a registered `external` backend by id
@@ -240,9 +224,8 @@ export class Space {
             json: registration
         });
         // 201 (create) carries the sanitized descriptor; 204 (in-place replace)
-        // carries no body, so `data` is undefined.
-        return (response?.data ??
-            null);
+        // carries no body, which `dataOrNull` maps to `null`.
+        return dataOrNull(response);
     }
     /**
      * Deregisters (forgets) a registered `external` backend by id
@@ -279,13 +262,10 @@ export class Space {
         const path = includeCollections
             ? `${spaceQuotas(this.id)}?include=collections`
             : spaceQuotas(this.id);
-        const response = await send(this._context, {
+        return readData(this._context, {
             path,
-            method: 'GET',
-            capability: this._capability,
-            read: true
+            capability: this._capability
         });
-        return dataOrNull(response);
     }
     /**
      * Delegates access to this space. Prefills the grant `target` with this
@@ -295,27 +275,91 @@ export class Space {
      * @returns {Promise<IDelegatedZcap>}
      */
     async grant(options) {
-        return delegateGrant(this._context, {
-            ...options,
-            target: options.target ??
-                toUrl({ serverUrl: this._context.serverUrl, path: this._path }),
-            capability: options.capability ?? this._capability
+        return delegateGrantAt(this._context, {
+            path: this._path,
+            options,
+            capability: this._capability
         });
     }
     /**
-     * Exports the whole space as a tar (`application/x-tar`) archive.
+     * Sends the export request and returns the raw response with its body stream
+     * intact, shared by `export`/`exportBlob`/`exportStream`.
      *
-     * @returns {Promise<Uint8Array>}
+     * Guards the JSON-mislabel edge: `@interop/http-client` pre-consumes a
+     * response body into `.data` for JSON content-types, so a non-conformant
+     * server that labels the tar archive `application/json` would leave us a dead
+     * stream. Detecting the consumed body here fails with a typed `WasServerError`
+     * naming the mislabeled content-type, rather than a raw "body stream already
+     * read" `TypeError` downstream.
+     *
+     * @returns {Promise<HttpResponse>}
      */
-    async export() {
-        const response = await send(this._context, {
+    async _exportResponse() {
+        const response = (await send(this._context, {
             path: spaceExport(this.id),
             method: 'POST',
             capability: this._capability
-        });
-        // A successful export always returns a response (errors throw via send()).
-        const buffer = await response.arrayBuffer();
-        return new Uint8Array(buffer);
+            // A successful export always returns a response (errors throw via send()).
+        }));
+        if (response.bodyUsed || response.data !== undefined) {
+            const contentType = response.headers.get('content-type') ?? 'an unknown content-type';
+            throw new WasServerError(`Export response body was already consumed (mislabeled as ` +
+                `${contentType}); expected application/x-tar.`);
+        }
+        return response;
+    }
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive.
+     *
+     * The entire archive is buffered into memory (a `Uint8Array` cannot be
+     * produced incrementally), so exporting a very large space costs its full
+     * size in RAM. For a constant-memory path use {@link exportStream}; for the
+     * `import()` companion container use {@link exportBlob}.
+     *
+     * @returns {Promise<Uint8Array>}
+     */
+    async export() {
+        const response = await this._exportResponse();
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive, as a Blob
+     * typed `application/x-tar`. Pairs directly with `import(tar)`, so copying a
+     * space is `spaceB.import(await spaceA.exportBlob())`.
+     *
+     * Note: in Node a Blob is memory-backed, so this does not reduce peak memory
+     * versus {@link export} -- it is a typed-container convenience (browsers may
+     * spill large Blobs to disk). For the true constant-memory path use
+     * {@link exportStream}.
+     *
+     * @returns {Promise<Blob>}
+     */
+    async exportBlob() {
+        const blob = await (await this._exportResponse()).blob();
+        // Normalize the type: some servers omit or mislabel the content-type, and
+        // `Blob.type` is load-bearing for `import()` / anchor-download flows.
+        return blob.type === 'application/x-tar'
+            ? blob
+            : new Blob([blob], { type: 'application/x-tar' });
+    }
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive, as a lazily
+     * consumed byte stream -- constant memory, for piping to a file, a
+     * `CompressionStream`, or another request.
+     *
+     * The stream must be consumed or cancelled; an abandoned stream holds its
+     * connection open.
+     *
+     * @returns {Promise<ReadableStream<Uint8Array>>}
+     */
+    async exportStream() {
+        const response = await this._exportResponse();
+        if (response.body === null) {
+            // A body-less 2xx (204, or an exotic fetch impl) -- fail with a typed
+            // error rather than returning a null stream.
+            throw new WasServerError('Export response carried no body stream.');
+        }
+        return response.body;
     }
     /**
      * Imports (merges) a tar archive into the space.
@@ -332,7 +376,8 @@ export class Space {
             body,
             headers: { 'content-type': 'application/x-tar' }
         });
-        return response.data;
+        // A successful import always carries the stats body.
+        return dataOrNull(response);
     }
     /**
      * Reads the space's access-control policy. Returns `null` when no policy is
@@ -399,13 +444,10 @@ export class Space {
      * @returns {Promise<LinkSet | null>}
      */
     async linkset() {
-        const response = await send(this._context, {
+        return readData(this._context, {
             path: spaceLinkset(this.id),
-            method: 'GET',
-            capability: this._capability,
-            read: true
+            capability: this._capability
         });
-        return dataOrNull(response);
     }
 }
 //# sourceMappingURL=Space.js.map