@interop/was-client 0.1.0

package/dist/Resource.js

@@ -0,0 +1,124 @@
+/*!
+ * 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 } from './internal/paths.js';
+import { prepareBody, parseResource } from './internal/content.js';
+import { assertNotReserved } from './internal/reserved.js';
+import { send } from './internal/request.js';
+export class Resource {
+    spaceId;
+    collectionId;
+    id;
+    _context;
+    _capability;
+    /**
+     * @param options {object}
+     * @param options.context {ClientContext}
+     * @param options.spaceId {string}
+     * @param options.collectionId {string}
+     * @param options.resourceId {string}
+     * @param [options.capability] {IZcap}   capability attached to every request
+     */
+    constructor({ context, spaceId, collectionId, resourceId, capability }) {
+        this._context = context;
+        this.spaceId = spaceId;
+        this.collectionId = collectionId;
+        this.id = resourceId;
+        this._capability = capability;
+    }
+    get _path() {
+        return resourcePath(this.spaceId, this.collectionId, this.id);
+    }
+    /**
+     * 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
+     * (WAS returns 404 for both not-found and unauthorized).
+     *
+     * @returns {Promise<Json | Blob | null>}
+     */
+    async get() {
+        const response = await send(this._context, {
+            path: this._path,
+            method: 'GET',
+            capability: this._capability,
+            read: true
+        });
+        return parseResource(response);
+    }
+    /**
+     * Reads the resource body as text. Returns `null` on a missing/unauthorized
+     * resource (404 conflation caveat).
+     *
+     * @returns {Promise<string | null>}
+     */
+    async getText() {
+        const response = await send(this._context, {
+            path: this._path,
+            method: 'GET',
+            capability: this._capability,
+            read: true
+        });
+        return response === null ? null : response.text();
+    }
+    /**
+     * Reads the resource body as raw bytes. Returns `null` on a
+     * missing/unauthorized resource (404 conflation caveat).
+     *
+     * @returns {Promise<Uint8Array | null>}
+     */
+    async getBytes() {
+        const response = await send(this._context, {
+            path: this._path,
+            method: 'GET',
+            capability: this._capability,
+            read: true
+        });
+        if (response === null) {
+            return null;
+        }
+        return new Uint8Array(await response.arrayBuffer());
+    }
+    /**
+     * Creates or replaces the resource by id (upsert). JSON for plain
+     * objects/arrays, binary for `Blob`/`Uint8Array`. Throws `NotFoundError` if
+     * the parent collection does not exist (WAS does not auto-create parents).
+     *
+     * @param data {Json | Blob | Uint8Array}
+     * @param options {object}
+     * @param [options.contentType] {string}   content-type for binary data
+     * @returns {Promise<void>}
+     */
+    async put(data, options = {}) {
+        assertNotReserved(this.id, 'resource');
+        const prepared = prepareBody(data, options);
+        await send(this._context, {
+            path: this._path,
+            method: 'PUT',
+            capability: this._capability,
+            json: prepared.json,
+            body: prepared.body,
+            headers: prepared.contentType
+                ? { 'content-type': prepared.contentType }
+                : undefined
+        });
+    }
+    /**
+     * Deletes the resource. Idempotent.
+     *
+     * @returns {Promise<void>}
+     */
+    async delete() {
+        await send(this._context, {
+            path: this._path,
+            method: 'DELETE',
+            capability: this._capability,
+            idempotent: true
+        });
+    }
+}
+//# sourceMappingURL=Resource.js.map

package/dist/Resource.js.map

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

package/dist/Space.d.ts

@@ -0,0 +1,99 @@
+import type { ClientContext } from './internal/request.js';
+import { Collection } from './Collection.js';
+import type { BackendReference, CollectionListing, GrantOptions, HandleOptions, IDelegatedZcap, IZcap, ImportStats, SpaceDescription } from './types.js';
+export declare class Space {
+    readonly id: string;
+    private readonly _context;
+    private readonly _capability?;
+    /**
+     * @param options {object}
+     * @param options.context {ClientContext}
+     * @param options.spaceId {string}
+     * @param [options.capability] {IZcap}   capability attached to every request
+     */
+    constructor({ context, spaceId, capability }: {
+        context: ClientContext;
+        spaceId: string;
+        capability?: IZcap;
+    });
+    private get _path();
+    /**
+     * Reads the Space Description. Returns `null` if the space is missing or not
+     * visible to you (WAS returns 404 for both not-found and unauthorized).
+     *
+     * @returns {Promise<SpaceDescription | null>}
+     */
+    describe(): Promise<SpaceDescription | null>;
+    /**
+     * Creates or updates the space by id (upsert). Merges the given fields over
+     * the current description; `controller` defaults to the wrapped signer's DID.
+     *
+     * @param desc {object}
+     * @param [desc.name] {string}
+     * @param [desc.controller] {string}
+     * @returns {Promise<SpaceDescription>}
+     */
+    configure(desc: {
+        name?: string;
+        controller?: string;
+    }): Promise<SpaceDescription>;
+    /**
+     * Deletes the space. Idempotent.
+     *
+     * @returns {Promise<void>}
+     */
+    delete(): Promise<void>;
+    /**
+     * Returns a lazy handle to a collection by id. No I/O.
+     *
+     * @param collectionId {string}
+     * @param options {object}
+     * @param [options.capability] {IZcap}
+     * @returns {Collection}
+     */
+    collection(collectionId: string, options?: HandleOptions): Collection;
+    /**
+     * Creates a collection within the space (server-generated id unless `id` is
+     * given). Throws `NotFoundError` if the space does not exist.
+     *
+     * @param desc {object}
+     * @param [desc.id] {string}
+     * @param [desc.name] {string}
+     * @param [desc.backend] {BackendReference}
+     * @returns {Promise<Collection>}
+     */
+    createCollection(desc?: {
+        id?: string;
+        name?: string;
+        backend?: BackendReference;
+    }): Promise<Collection>;
+    /**
+     * Lists the collections in the space. Returns `null` if the space is missing
+     * or not visible to you (404 conflation caveat).
+     *
+     * @returns {Promise<CollectionListing | null>}
+     */
+    collections(): Promise<CollectionListing | null>;
+    /**
+     * Delegates access to this space. Prefills the grant `target` with this
+     * space's URL (and the bound `capability`, if any, for re-delegation).
+     *
+     * @param options {GrantOptions}
+     * @returns {Promise<IDelegatedZcap>}
+     */
+    grant(options: GrantOptions): Promise<IDelegatedZcap>;
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive.
+     *
+     * @returns {Promise<Uint8Array>}
+     */
+    export(): Promise<Uint8Array>;
+    /**
+     * Imports (merges) a tar archive into the space.
+     *
+     * @param tar {Uint8Array | Blob}
+     * @returns {Promise<ImportStats>}
+     */
+    import(tar: Uint8Array | Blob): Promise<ImportStats>;
+}
+//# sourceMappingURL=Space.d.ts.map

package/dist/Space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Space.d.ts","sourceRoot":"","sources":["../src/Space.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,KAAK,EACL,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,qBAAa,KAAK;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAO;IAEpC;;;;;OAKG;gBACS,EACV,OAAO,EACP,OAAO,EACP,UAAU,EACX,EAAE;QACD,OAAO,EAAE,aAAa,CAAA;QACtB,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,KAAK,CAAA;KACnB;IAMD,OAAO,KAAK,KAAK,GAEhB;IAED;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAUlD;;;;;;;;OAQG;IACG,SAAS,CAAC,IAAI,EAAE;QACpB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmB7B;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B;;;;;;;OAOG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,UAAU;IASzE;;;;;;;;;OASG;IACG,gBAAgB,CACpB,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;KAAO,GACpE,OAAO,CAAC,UAAU,CAAC;IAyBtB;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAUtD;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAU3D;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAanC;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;CAc3D"}

package/dist/Space.js

@@ -0,0 +1,202 @@
+/*!
+ * 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, toUrl } from './internal/paths.js';
+import { assertNotReserved } from './internal/reserved.js';
+import { delegateGrant } from './internal/grant.js';
+import { send } from './internal/request.js';
+import { Collection } from './Collection.js';
+export class Space {
+    id;
+    _context;
+    _capability;
+    /**
+     * @param options {object}
+     * @param options.context {ClientContext}
+     * @param options.spaceId {string}
+     * @param [options.capability] {IZcap}   capability attached to every request
+     */
+    constructor({ context, spaceId, capability }) {
+        this._context = context;
+        this.id = spaceId;
+        this._capability = capability;
+    }
+    get _path() {
+        return spacePath(this.id);
+    }
+    /**
+     * Reads the Space Description. Returns `null` if the space is missing or not
+     * visible to you (WAS returns 404 for both not-found and unauthorized).
+     *
+     * @returns {Promise<SpaceDescription | null>}
+     */
+    async describe() {
+        const response = await send(this._context, {
+            path: this._path,
+            method: 'GET',
+            capability: this._capability,
+            read: true
+        });
+        return response === null ? null : response.data;
+    }
+    /**
+     * Creates or updates the space by id (upsert). Merges the given fields over
+     * the current description; `controller` defaults to the wrapped signer's DID.
+     *
+     * @param desc {object}
+     * @param [desc.name] {string}
+     * @param [desc.controller] {string}
+     * @returns {Promise<SpaceDescription>}
+     */
+    async configure(desc) {
+        const current = await this.describe();
+        const name = desc.name ?? current?.name;
+        const controller = desc.controller ?? current?.controller ?? this._context.controllerDid;
+        await send(this._context, {
+            path: this._path,
+            method: 'PUT',
+            capability: this._capability,
+            json: { id: this.id, name, controller }
+        });
+        return {
+            id: this.id,
+            type: current?.type ?? ['Space'],
+            ...(name !== undefined ? { name } : {}),
+            controller
+        };
+    }
+    /**
+     * Deletes the space. Idempotent.
+     *
+     * @returns {Promise<void>}
+     */
+    async delete() {
+        await send(this._context, {
+            path: this._path,
+            method: 'DELETE',
+            capability: this._capability,
+            idempotent: true
+        });
+    }
+    /**
+     * Returns a lazy handle to a collection by id. No I/O.
+     *
+     * @param collectionId {string}
+     * @param options {object}
+     * @param [options.capability] {IZcap}
+     * @returns {Collection}
+     */
+    collection(collectionId, options = {}) {
+        return new Collection({
+            context: this._context,
+            spaceId: this.id,
+            collectionId,
+            capability: options.capability ?? this._capability
+        });
+    }
+    /**
+     * Creates a collection within the space (server-generated id unless `id` is
+     * given). Throws `NotFoundError` if the space does not exist.
+     *
+     * @param desc {object}
+     * @param [desc.id] {string}
+     * @param [desc.name] {string}
+     * @param [desc.backend] {BackendReference}
+     * @returns {Promise<Collection>}
+     */
+    async createCollection(desc = {}) {
+        if (desc.id !== undefined) {
+            assertNotReserved(desc.id, 'collection');
+        }
+        const body = {};
+        if (desc.id !== undefined) {
+            body.id = desc.id;
+        }
+        if (desc.name !== undefined) {
+            body.name = desc.name;
+        }
+        if (desc.backend) {
+            body.backend = desc.backend;
+        }
+        const response = await send(this._context, {
+            path: spaceItems(this.id),
+            method: 'POST',
+            capability: this._capability,
+            json: body
+        });
+        const created = response
+            .data;
+        return this.collection(created.id);
+    }
+    /**
+     * Lists the collections in the space. Returns `null` if the space is missing
+     * or not visible to you (404 conflation caveat).
+     *
+     * @returns {Promise<CollectionListing | null>}
+     */
+    async collections() {
+        const response = await send(this._context, {
+            path: spaceCollections(this.id),
+            method: 'GET',
+            capability: this._capability,
+            read: true
+        });
+        return response === null ? null : response.data;
+    }
+    /**
+     * Delegates access to this space. Prefills the grant `target` with this
+     * space's URL (and the bound `capability`, if any, for re-delegation).
+     *
+     * @param options {GrantOptions}
+     * @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
+        });
+    }
+    /**
+     * Exports the whole space as a tar (`application/x-tar`) archive.
+     *
+     * @returns {Promise<Uint8Array>}
+     */
+    async export() {
+        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);
+    }
+    /**
+     * Imports (merges) a tar archive into the space.
+     *
+     * @param tar {Uint8Array | Blob}
+     * @returns {Promise<ImportStats>}
+     */
+    async import(tar) {
+        const body = tar instanceof Uint8Array && tar.constructor !== Uint8Array
+            ? new Uint8Array(tar.buffer, tar.byteOffset, tar.byteLength)
+            : tar;
+        const response = await send(this._context, {
+            path: spaceImport(this.id),
+            method: 'POST',
+            capability: this._capability,
+            body,
+            headers: { 'content-type': 'application/x-tar' }
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=Space.js.map

package/dist/Space.js.map

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

package/dist/WasClient.d.ts

@@ -0,0 +1,115 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * The top-level WAS client. Wraps an ezcap `ZcapClient` (which holds the active
+ * signer) and exposes the WAS containment model
+ * (`SpacesRepository > Space > Collection > Resource`) through lazy
+ * navigational handles. Also hosts the general delegation primitive
+ * (`grant`), capability-rebuilding (`fromCapability`), and the signed
+ * escape-hatch (`request`).
+ */
+import { ZcapClient } from '@interop/ezcap';
+import type { HttpResponse } from '@interop/http-client';
+import { Space } from './Space.js';
+import { Collection } from './Collection.js';
+import { Resource } from './Resource.js';
+import type { GrantOptions, HandleOptions, IDelegatedZcap, ISigner, IZcap, RequestInput, SpaceListing } from './types.js';
+export declare class WasClient {
+    readonly serverUrl: string;
+    readonly zcapClient: ZcapClient;
+    /**
+     * @param options {object}
+     * @param options.serverUrl {string}    base URL for both URL building and
+     *   zcap `invocationTarget`s
+     * @param options.zcapClient {ZcapClient}   an ezcap client holding the signer
+     */
+    constructor({ serverUrl, zcapClient }: {
+        serverUrl: string;
+        zcapClient: ZcapClient;
+    });
+    /**
+     * Convenience constructor that builds the ezcap `ZcapClient` internally from
+     * a signer, using the `Ed25519Signature2020` suite.
+     *
+     * @param options {object}
+     * @param options.serverUrl {string}
+     * @param options.signer {ISigner}
+     * @returns {WasClient}
+     */
+    static fromSigner({ serverUrl, signer }: {
+        serverUrl: string;
+        signer: ISigner;
+    }): WasClient;
+    /**
+     * The DID controlling the wrapped signer (`signer.id` without the key
+     * fragment). Used to default `controller` on `createSpace`.
+     *
+     * @returns {string}
+     */
+    get controllerDid(): string;
+    private get _context();
+    /**
+     * Returns a lazy handle to a space by id. No I/O.
+     *
+     * @param spaceId {string}
+     * @param options {object}
+     * @param [options.capability] {IZcap}
+     * @returns {Space}
+     */
+    space(spaceId: string, options?: HandleOptions): Space;
+    /**
+     * Creates a space (server-generated id unless `id` is given). The server
+     * requires `name`, and `controller` must match the wrapped signer's DID
+     * (which is the default).
+     *
+     * @param desc {object}
+     * @param [desc.id] {string}
+     * @param [desc.name] {string}
+     * @param [desc.controller] {string}
+     * @returns {Promise<Space>}
+     */
+    createSpace(desc?: {
+        id?: string;
+        name?: string;
+        controller?: string;
+    }): Promise<Space>;
+    /**
+     * Lists the spaces in the repository. Not yet implemented by the reference
+     * server, which answers 501 -- so this currently throws
+     * `NotImplementedError`.
+     *
+     * @returns {Promise<SpaceListing>}
+     */
+    listSpaces(): Promise<SpaceListing>;
+    /**
+     * Rebuilds an access handle from a received capability, returning a handle at
+     * the depth implied by the capability's `invocationTarget` (space /
+     * collection / resource), pre-bound with that capability.
+     *
+     * @param zcap {IZcap}
+     * @returns {Space | Collection | Resource}
+     */
+    fromCapability(zcap: IZcap): Space | Collection | Resource;
+    /**
+     * The general delegation primitive. Delegates a capability per `GrantOptions`
+     * and returns the signed zcap to hand off out-of-band. `target` (any URL) and
+     * `capability` (a parent capability to attenuate) make this a superset of the
+     * `space`/`collection` grant sugar.
+     *
+     * @param options {GrantOptions}
+     * @returns {Promise<IDelegatedZcap>}
+     */
+    grant(options: GrantOptions): Promise<IDelegatedZcap>;
+    /**
+     * The signed escape hatch, mirroring ezcap's generic `request()`. Resolves
+     * `path` against `serverUrl`, defaults `action` to `method`, and signs via the
+     * wrapped client. Returns the raw `HttpResponse` and throws raw ky/ezcap
+     * errors -- it does not apply the null-on-404 or typed-error conveniences.
+     *
+     * @param options {RequestInput}
+     * @returns {Promise<HttpResponse>}
+     */
+    request(options: RequestInput): Promise<HttpResponse>;
+}
+//# sourceMappingURL=WasClient.d.ts.map

package/dist/WasClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WasClient.d.ts","sourceRoot":"","sources":["../src/WasClient.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAMxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,OAAO,EACP,KAAK,EACL,YAAY,EACZ,YAAY,EACb,MAAM,YAAY,CAAA;AAEnB,qBAAa,SAAS;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAE/B;;;;;OAKG;gBACS,EACV,SAAS,EACT,UAAU,EACX,EAAE;QACD,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,UAAU,CAAA;KACvB;IAKD;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,EAChB,SAAS,EACT,MAAM,EACP,EAAE;QACD,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,OAAO,CAAA;KAChB,GAAG,SAAS;IASb;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAQ1B;IAED,OAAO,KAAK,QAAQ,GAMnB;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,KAAK;IAQ1D;;;;;;;;;;OAUG;IACG,WAAW,CACf,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAC7D,OAAO,CAAC,KAAK,CAAC;IAkBjB;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAQzC;;;;;;;OAOG;IACH,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ;IAmC1D;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3D;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAG5D"}