@interop/was-client 0.1.0

package/dist/internal/paths.d.ts

@@ -0,0 +1,70 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * URL path builders for the WAS server, encoding the trailing-slash
+ * canonicalization once. Item-create and listing endpoints use a trailing
+ * slash; get/put/delete-by-id endpoints do not. Path segments are
+ * percent-encoded so ids never break out of their slot.
+ *
+ * The zcap `invocationTarget` is derived from the request URL, so these
+ * trailing-slash rules must match the server's per-operation `allowedTarget`
+ * exactly or signature verification fails.
+ */
+/**
+ * `/spaces/` -- the SpacesRepository (create / list spaces).
+ */
+export declare function spacesRoot(): string;
+/**
+ * `/spaces/:spaceId` -- canonical location of a created space (POST response).
+ */
+export declare function spaceLocation(spaceId: string): string;
+/**
+ * `/space/:spaceId` -- get / update / delete a space (no trailing slash).
+ */
+export declare function spacePath(spaceId: string): string;
+/**
+ * `/space/:spaceId/` -- create a collection within a space (trailing slash).
+ */
+export declare function spaceItems(spaceId: string): string;
+/**
+ * `/space/:spaceId/collections/` -- list collections (trailing slash).
+ */
+export declare function spaceCollections(spaceId: string): string;
+/**
+ * `/space/:spaceId/export` -- export a space as a tar archive.
+ */
+export declare function spaceExport(spaceId: string): string;
+/**
+ * `/space/:spaceId/import` -- import a tar archive into a space.
+ */
+export declare function spaceImport(spaceId: string): string;
+/**
+ * `/space/:spaceId/:collectionId` -- get / update / delete a collection
+ * (no trailing slash).
+ */
+export declare function collectionPath(spaceId: string, collectionId: string): string;
+/**
+ * `/space/:spaceId/:collectionId/` -- list items / add a resource
+ * (trailing slash).
+ */
+export declare function collectionItems(spaceId: string, collectionId: string): string;
+/**
+ * `/space/:spaceId/:collectionId/:resourceId` -- get / put / delete a resource
+ * (no trailing slash).
+ */
+export declare function resourcePath(spaceId: string, collectionId: string, resourceId: string): string;
+/**
+ * Resolves a path against the server base URL, producing an absolute URL
+ * string suitable for zcap `invocationTarget`s.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}   the server base URL
+ * @param options.path {string}        a leading-slash path (e.g. `/space/x`)
+ * @returns {string}
+ */
+export declare function toUrl({ serverUrl, path }: {
+    serverUrl: string;
+    path: string;
+}): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/internal/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;GASG;AAMH;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EACpB,SAAS,EACT,IAAI,EACL,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,MAAM,CAET"}

package/dist/internal/paths.js

@@ -0,0 +1,92 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * URL path builders for the WAS server, encoding the trailing-slash
+ * canonicalization once. Item-create and listing endpoints use a trailing
+ * slash; get/put/delete-by-id endpoints do not. Path segments are
+ * percent-encoded so ids never break out of their slot.
+ *
+ * The zcap `invocationTarget` is derived from the request URL, so these
+ * trailing-slash rules must match the server's per-operation `allowedTarget`
+ * exactly or signature verification fails.
+ */
+function encode(segment) {
+    return encodeURIComponent(segment);
+}
+/**
+ * `/spaces/` -- the SpacesRepository (create / list spaces).
+ */
+export function spacesRoot() {
+    return '/spaces/';
+}
+/**
+ * `/spaces/:spaceId` -- canonical location of a created space (POST response).
+ */
+export function spaceLocation(spaceId) {
+    return `/spaces/${encode(spaceId)}`;
+}
+/**
+ * `/space/:spaceId` -- get / update / delete a space (no trailing slash).
+ */
+export function spacePath(spaceId) {
+    return `/space/${encode(spaceId)}`;
+}
+/**
+ * `/space/:spaceId/` -- create a collection within a space (trailing slash).
+ */
+export function spaceItems(spaceId) {
+    return `/space/${encode(spaceId)}/`;
+}
+/**
+ * `/space/:spaceId/collections/` -- list collections (trailing slash).
+ */
+export function spaceCollections(spaceId) {
+    return `/space/${encode(spaceId)}/collections/`;
+}
+/**
+ * `/space/:spaceId/export` -- export a space as a tar archive.
+ */
+export function spaceExport(spaceId) {
+    return `/space/${encode(spaceId)}/export`;
+}
+/**
+ * `/space/:spaceId/import` -- import a tar archive into a space.
+ */
+export function spaceImport(spaceId) {
+    return `/space/${encode(spaceId)}/import`;
+}
+/**
+ * `/space/:spaceId/:collectionId` -- get / update / delete a collection
+ * (no trailing slash).
+ */
+export function collectionPath(spaceId, collectionId) {
+    return `/space/${encode(spaceId)}/${encode(collectionId)}`;
+}
+/**
+ * `/space/:spaceId/:collectionId/` -- list items / add a resource
+ * (trailing slash).
+ */
+export function collectionItems(spaceId, collectionId) {
+    return `/space/${encode(spaceId)}/${encode(collectionId)}/`;
+}
+/**
+ * `/space/:spaceId/:collectionId/:resourceId` -- get / put / delete a resource
+ * (no trailing slash).
+ */
+export function resourcePath(spaceId, collectionId, resourceId) {
+    return `/space/${encode(spaceId)}/${encode(collectionId)}/${encode(resourceId)}`;
+}
+/**
+ * Resolves a path against the server base URL, producing an absolute URL
+ * string suitable for zcap `invocationTarget`s.
+ *
+ * @param options {object}
+ * @param options.serverUrl {string}   the server base URL
+ * @param options.path {string}        a leading-slash path (e.g. `/space/x`)
+ * @returns {string}
+ */
+export function toUrl({ serverUrl, path }) {
+    return new URL(path, serverUrl).toString();
+}
+//# sourceMappingURL=paths.js.map

package/dist/internal/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;GASG;AAEH,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,GAAG,CAAA;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,eAAe,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,SAAS,CAAA;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,SAAS,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAoB;IAClE,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,YAAoB;IACnE,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAA;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,YAAoB,EACpB,UAAkB;IAElB,OAAO,UAAU,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAA;AAClF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,KAAK,CAAC,EACpB,SAAS,EACT,IAAI,EAIL;IACC,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC5C,CAAC"}

package/dist/internal/request.d.ts

@@ -0,0 +1,64 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * The load-bearing transport layer: wraps `zcapClient.request(...)`, resolving
+ * paths against the server URL and defaulting the capability `action` to the
+ * HTTP method (never ezcap's `read`/`write`). `send()` adds the typed-error
+ * mapping and the null-on-404 read translation; `rawRequest()` is the
+ * unmapped escape hatch used by `was.request()`.
+ */
+import type { ZcapClient } from '@interop/ezcap';
+import type { HttpResponse } from '@interop/http-client';
+import type { IZcap } from '../types.js';
+/**
+ * The shared context threaded through every handle: the server base URL, the
+ * wrapped ezcap client, and the cached controller DID of its signer.
+ */
+export interface ClientContext {
+    serverUrl: string;
+    zcapClient: ZcapClient;
+    controllerDid: string;
+}
+/**
+ * A single signed request. Either `path` (resolved against `serverUrl`) or
+ * `url` (absolute) must be given.
+ */
+export interface SendInput {
+    path?: string;
+    url?: string;
+    method?: string;
+    action?: string;
+    headers?: Record<string, string>;
+    json?: object;
+    body?: Blob | Uint8Array;
+    capability?: IZcap;
+    /** When true, a 404 response resolves to `null` instead of throwing. */
+    read?: boolean;
+    /**
+     * When true, a 404 response resolves to `null` instead of throwing, so a
+     * delete of an already-absent target succeeds (idempotent delete).
+     */
+    idempotent?: boolean;
+}
+/**
+ * Signs and sends a request via the wrapped ezcap client, returning the raw
+ * `HttpResponse` and throwing the raw ky/ezcap error. Does not apply error
+ * mapping or null-on-404 -- this is the escape-hatch primitive.
+ *
+ * @param context {ClientContext}
+ * @param input {SendInput}
+ * @returns {Promise<HttpResponse>}
+ */
+export declare function rawRequest(context: ClientContext, input: SendInput): Promise<HttpResponse>;
+/**
+ * Signs and sends a request, applying the typed-error mapping. When `read` is
+ * set, a 404 resolves to `null` (MongoDB `findOne` semantics); otherwise every
+ * non-2xx maps to a `WasError` subclass.
+ *
+ * @param context {ClientContext}
+ * @param input {SendInput}
+ * @returns {Promise<HttpResponse | null>}
+ */
+export declare function send(context: ClientContext, input: SendInput): Promise<HttpResponse | null>;
+//# sourceMappingURL=request.d.ts.map

package/dist/internal/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/internal/request.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IAExB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,IAAI,GAAG,UAAU,CAAA;IACxB,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAYD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;;;;;;GAQG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgB9B"}

package/dist/internal/request.js

@@ -0,0 +1,60 @@
+import { mapError } from '../errors.js';
+import { toUrl } from './paths.js';
+function resolveRequestUrl(context, input) {
+    if (input.url !== undefined) {
+        return input.url;
+    }
+    if (input.path === undefined) {
+        throw new TypeError('Either "path" or "url" is required.');
+    }
+    return toUrl({ serverUrl: context.serverUrl, path: input.path });
+}
+/**
+ * Signs and sends a request via the wrapped ezcap client, returning the raw
+ * `HttpResponse` and throwing the raw ky/ezcap error. Does not apply error
+ * mapping or null-on-404 -- this is the escape-hatch primitive.
+ *
+ * @param context {ClientContext}
+ * @param input {SendInput}
+ * @returns {Promise<HttpResponse>}
+ */
+export async function rawRequest(context, input) {
+    const url = resolveRequestUrl(context, input);
+    const method = input.method ?? 'GET';
+    return context.zcapClient.request({
+        url,
+        capability: input.capability,
+        method,
+        // Default the capability action to the HTTP method (never `read`/`write`).
+        action: input.action ?? method,
+        headers: input.headers,
+        json: input.json,
+        body: input.body
+    });
+}
+/**
+ * Signs and sends a request, applying the typed-error mapping. When `read` is
+ * set, a 404 resolves to `null` (MongoDB `findOne` semantics); otherwise every
+ * non-2xx maps to a `WasError` subclass.
+ *
+ * @param context {ClientContext}
+ * @param input {SendInput}
+ * @returns {Promise<HttpResponse | null>}
+ */
+export async function send(context, input) {
+    try {
+        return await rawRequest(context, input);
+    }
+    catch (err) {
+        const status = err
+            ?.status;
+        const responseStatus = err?.response
+            ?.status;
+        if ((input.read || input.idempotent) &&
+            (status === 404 || responseStatus === 404)) {
+            return null;
+        }
+        throw mapError(err);
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/internal/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/internal/request.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAuClC,SAAS,iBAAiB,CAAC,OAAsB,EAAE,KAAgB;IACjE,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,GAAG,CAAA;IAClB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAA;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAsB,EACtB,KAAgB;IAEhB,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAA;IACpC,OAAO,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAChC,GAAG;QACH,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM;QACN,2EAA2E;QAC3E,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,MAAM;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,OAAsB,EACtB,KAAgB;IAEhB,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAI,GAA2D;YACzE,EAAE,MAAM,CAAA;QACV,MAAM,cAAc,GAAI,GAA0C,EAAE,QAAQ;YAC1E,EAAE,MAAM,CAAA;QACV,IACE,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;YAChC,CAAC,MAAM,KAAK,GAAG,IAAI,cAAc,KAAK,GAAG,CAAC,EAC1C,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAA;IACrB,CAAC;AACH,CAAC"}

package/dist/internal/reserved.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Path segments reserved by the spec's Reserved Path Segment Registry. A
+ * collection or resource id that collides with one of these is rejected before
+ * the request is sent.
+ */
+export declare const RESERVED_SEGMENTS: readonly string[];
+/**
+ * Throws a `ValidationError` if the given id collides with a reserved path
+ * segment.
+ *
+ * @param id {string}     the proposed collection or resource id
+ * @param kind {string}   'collection' or 'resource', used in the message
+ * @returns {void}
+ */
+export declare function assertNotReserved(id: string, kind: 'collection' | 'resource'): void;
+//# sourceMappingURL=reserved.d.ts.map

package/dist/internal/reserved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAW9C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,GAAG,UAAU,GAC9B,IAAI,CAMN"}

package/dist/internal/reserved.js

@@ -0,0 +1,40 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Reserved path-segment registry and the client-side id-collision guard.
+ * Rejecting reserved ids up front (with a clear `ValidationError`) is friendlier
+ * than letting the server answer `409 Conflict`.
+ */
+import { ValidationError } from '../errors.js';
+/**
+ * Path segments reserved by the spec's Reserved Path Segment Registry. A
+ * collection or resource id that collides with one of these is rejected before
+ * the request is sent.
+ */
+export const RESERVED_SEGMENTS = [
+    'policy',
+    'backends',
+    'backend',
+    'collections',
+    'export',
+    'linkset',
+    'query',
+    'quota',
+    'quotas',
+    'meta'
+];
+/**
+ * Throws a `ValidationError` if the given id collides with a reserved path
+ * segment.
+ *
+ * @param id {string}     the proposed collection or resource id
+ * @param kind {string}   'collection' or 'resource', used in the message
+ * @returns {void}
+ */
+export function assertNotReserved(id, kind) {
+    if (RESERVED_SEGMENTS.includes(id)) {
+        throw new ValidationError(`Cannot use reserved path segment "${id}" as a ${kind} id.`);
+    }
+}
+//# sourceMappingURL=reserved.js.map

package/dist/internal/reserved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved.js","sourceRoot":"","sources":["../../src/internal/reserved.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,QAAQ;IACR,UAAU;IACV,SAAS;IACT,aAAa;IACb,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,QAAQ;IACR,MAAM;CACP,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAU,EACV,IAA+B;IAE/B,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,eAAe,CACvB,qCAAqC,EAAE,UAAU,IAAI,MAAM,CAC5D,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Shared type definitions for the WAS client: containment descriptions,
+ * listing/result shapes, delegation options, and the manual-request input.
+ * ZCap and signer types are re-used from `@interop/data-integrity-core` rather
+ * than re-declared.
+ */
+import type { IZcap, IDelegatedZcap } from '@interop/data-integrity-core/zcap';
+import type { ISigner } from '@interop/data-integrity-core';
+export type { IZcap, IDelegatedZcap, ISigner };
+/**
+ * A JSON-serializable value, the shape stored for JSON resources and
+ * descriptions.
+ */
+export type JsonPrimitive = string | number | boolean | null;
+export interface JsonObject {
+    [key: string]: Json;
+}
+export type JsonArray = Json[];
+export type Json = JsonPrimitive | JsonObject | JsonArray;
+/**
+ * A capability action -- an HTTP verb in its canonical uppercase form, as it
+ * appears in the signed zcap. The WAS server matches actions case-sensitively.
+ */
+export type Action = 'GET' | 'PUT' | 'POST' | 'DELETE';
+/**
+ * The action input accepted by `grant()`: canonical uppercase or lowercase.
+ * Lowercase is normalized to uppercase before the zcap is signed, so a grant of
+ * `'get'` still validates on the server (which expects `'GET'`).
+ */
+export type ActionInput = Action | Lowercase<Action>;
+/**
+ * A Space Description object, as returned by the server.
+ */
+export interface SpaceDescription {
+    id: string;
+    type: string[];
+    name?: string;
+    controller: string;
+}
+/**
+ * A Collection Description object, as returned by the server.
+ */
+export interface CollectionDescription {
+    id: string;
+    type: string[];
+    name?: string;
+}
+/**
+ * One entry in a `CollectionListing` (a collection within a space).
+ */
+export interface CollectionSummary {
+    id: string;
+    name: string;
+    url: string;
+}
+/**
+ * Return shape of `space.collections()`.
+ */
+export interface CollectionListing {
+    url: string;
+    totalItems: number;
+    items: CollectionSummary[];
+}
+/**
+ * One entry in a `SpaceListing` (a space within the repository).
+ */
+export interface SpaceSummary {
+    id: string;
+    name?: string;
+    url: string;
+}
+/**
+ * Return shape of `was.listSpaces()` (not yet implemented by the reference
+ * server, which answers 501).
+ */
+export interface SpaceListing {
+    url: string;
+    totalItems: number;
+    items: SpaceSummary[];
+}
+/**
+ * One entry in a `ResourceListing` (a resource within a collection).
+ */
+export interface ResourceSummary {
+    id: string;
+    url: string;
+    contentType: string;
+}
+/**
+ * Return shape of `collection.list()`.
+ */
+export interface ResourceListing {
+    id: string;
+    url: string;
+    name?: string;
+    type: string[];
+    totalItems: number;
+    items: ResourceSummary[];
+}
+/**
+ * Return shape of `collection.add()` (server-generated resource id + location).
+ */
+export interface AddResult {
+    id: string;
+    url: string;
+    contentType?: string;
+}
+/**
+ * Return shape of `space.import()`.
+ */
+export interface ImportStats {
+    collectionsCreated: number;
+    collectionsSkipped: number;
+    resourcesCreated: number;
+    resourcesSkipped: number;
+}
+/**
+ * Options accepted by every handle factory (`space()`, `collection()`,
+ * `resource()`). A bound `capability` is attached to every request the handle
+ * makes.
+ */
+export interface HandleOptions {
+    capability?: IZcap;
+}
+/**
+ * A reference to a storage backend, used when creating or configuring a
+ * Collection.
+ */
+export interface BackendReference {
+    id: string;
+}
+/**
+ * Options for the general delegation primitive (`was.grant()`) and the
+ * `space`/`collection` sugar.
+ *
+ * @property to              the delegate's controller DID
+ * @property actions         allowed actions (aliases or raw HTTP verbs)
+ * @property [expires]       expiration; defaults to ezcap's 5-minute default
+ * @property [target]        invocationTarget URL; filled by scoped grants
+ * @property [capability]    parent capability to attenuate / re-delegate
+ */
+export interface GrantOptions {
+    to: string;
+    actions: ActionInput[];
+    expires?: string | Date;
+    target?: string;
+    capability?: IZcap;
+}
+/**
+ * Input for the low-level `was.request()` escape hatch.
+ */
+export interface RequestInput {
+    path?: string;
+    url?: string;
+    method?: string;
+    action?: string;
+    headers?: Record<string, string>;
+    json?: object;
+    body?: Blob | Uint8Array;
+    capability?: IZcap;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@interop/was-client",
+  "description": "A developer-friendly client for Wallet Attached Storage (WAS) servers.",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "pnpm run clear && tsc",
+    "clear": "rimraf dist/*",
+    "dev": "vite",
+    "fix": "eslint --fix src test && pnpm run format",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"*.md\"",
+    "lint": "eslint src test",
+    "prepare": "pnpm run build",
+    "rebuild": "pnpm run clear && pnpm run build",
+    "test": "pnpm run fix && pnpm run lint && pnpm run test-node && pnpm run test-browser",
+    "test-browser": "playwright test",
+    "test-node": "vitest run",
+    "test-coverage": "vitest run --coverage"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "module": "dist/index.js",
+  "browser": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "dependencies": {
+    "@interop/data-integrity-core": "^6.1.2",
+    "@interop/ed25519-signature": "^7.0.1",
+    "@interop/ezcap": "^7.1.1",
+    "@interop/http-client": "^1.0.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@interop/ed25519-verification-key": "^7.0.1",
+    "@playwright/test": "^1.60.0",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "eslint": "^10.4.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^17.6.0",
+    "prettier": "^3.8.3",
+    "rimraf": "^6.1.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.59.4",
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7",
+    "was-teaching-server": "link:../was-teaching-server"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "wallet attached storage",
+    "was",
+    "zcap",
+    "ezcap"
+  ],
+  "packageManager": "pnpm@11.5.0",
+  "engines": {
+    "node": ">=24.0"
+  },
+  "author": {
+    "name": "Interop Alliance",
+    "url": "https://github.com/interop-alliance/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/interop-alliance/was-client.git"
+  },
+  "homepage": "https://github.com/interop-alliance/was-client",
+  "bugs": "https://github.com/interop-alliance/was-client/issues"
+}