@interop/was-client 0.99.0 → 0.100.0

package/dist/internal/revoke.d.ts

@@ -11,6 +11,15 @@ import type { IDelegatedZcap, IRootZcap, IZcap } from '../types.js';
  * @returns {string}
  */
 export declare function rootCapabilityId(target: string): string;
+/**
+ * The invocation target a root capability id names: the inverse of
+ * {@link rootCapabilityId}. Returns `null` for an id that is not a root
+ * capability id, or whose encoded target is malformed.
+ *
+ * @param id {string}   a capability id
+ * @returns {string | null}
+ */
+export declare function rootCapabilityTarget(id: string): string | null;
 /**
  * Builds the root capability for `target` in **object** form.
  *
@@ -32,21 +41,33 @@ export declare function rootCapability({ target, controller }: {
     controller: string;
 }): IRootZcap;
 /**
- * Derives the id of the Space a capability is rooted in, from its
- * `invocationTarget`. A Space-rooted capability's target is the Space URL or a
- * path beneath it (the server enforces this when it verifies the chain), so
- * every depth `parseSpaceTarget` recognizes -- Space, Collection, Resource, or a
- * reserved sub-resource such as `/space/s/c/r/meta` -- carries the Space id.
+ * The URL of the Space a capability is rooted in, read off its delegation
+ * chain: a Space-rooted capability's chain starts at the Space's root
+ * capability, whose id encodes the Space URL. The result is in canonical
+ * form.
+ *
+ * The root's target is taken to be the Space URL. A Space URL has no shape
+ * of its own (a Collection URL is an http(s) URL ending in a slash too), so
+ * this function cannot tell a chain rooted at a Space from one rooted at a
+ * Collection, a Resource, or a Spaces Repository: only the server, which
+ * knows its hierarchy, can, and it refuses a revocation whose chain does not
+ * root exactly in the Space. What is refused here is a root whose target
+ * cannot be a Space URL at all (an origin, a URL with a query, a URN) and a
+ * chain that starts at no root capability. A capability this client minted
+ * from a handle is always Space-rooted. A bare `was.grant({ target })` with
+ * no `spaceUrl`, the mode for a server with no Space hierarchy, roots at
+ * its target and is not revocable this way by design.
  *
- * @param context {ClientContext}
  * @param zcap {IZcap}   the capability to locate
  * @returns {string}
+ * @throws {ValidationError}   when the chain does not start at a root
+ *   capability id, or that id names something that cannot be a Space URL
  */
-export declare function spaceIdOf(context: ClientContext, zcap: IZcap): string;
+export declare function spaceUrlOf(zcap: IZcap): string;
 /**
  * Revokes a Space-rooted delegated capability: `POST`s it to
- * `/space/:spaceId/zcaps/revocations/:capabilityId`, invoking that URL's own
- * root capability. Resolves on the server's 204.
+ * `{spaceUrl}zcaps/revocations/:capabilityId`, invoking that URL's own root
+ * capability. Resolves on the server's 204.
  *
  * The `action` is deliberately left unset: `send()` defaults it to the HTTP
  * method, and this route expects `POST` (WAS capabilities are scoped by HTTP
@@ -54,12 +75,12 @@ export declare function spaceIdOf(context: ClientContext, zcap: IZcap): string;
  *
  * @param context {ClientContext}
  * @param options {object}
- * @param options.spaceId {string}          the Space the capability is rooted in
- * @param options.zcap {IDelegatedZcap}     the capability to revoke
+ * @param options.spaceUrl {string}          the Space the capability is rooted in
+ * @param options.zcap {IDelegatedZcap}      the capability to revoke
  * @returns {Promise<void>}
  */
-export declare function submitRevocation(context: ClientContext, { spaceId, zcap }: {
-    spaceId: string;
+export declare function submitRevocation(context: ClientContext, { spaceUrl, zcap }: {
+    spaceUrl: string;
     zcap: IDelegatedZcap;
 }): Promise<void>;
 //# sourceMappingURL=revoke.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"revoke.d.ts","sourceRoot":"","sources":["../../src/internal/revoke.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAOnE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACX,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,SAAS,CAOZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAarE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAC3D,OAAO,CAAC,IAAI,CAAC,CAmBf"}
+{"version":3,"file":"revoke.d.ts","sourceRoot":"","sources":["../../src/internal/revoke.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAYnE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS9D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EACX,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,SAAS,CAOZ;AA+BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAmB9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAC7D,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/internal/revoke.js

@@ -4,7 +4,7 @@
 /**
  * The revocation primitive shared by `was.revoke()` and `space.revoke()` -- the
  * inverse of `grant.ts`. Submits a delegated capability to its Space's
- * revocation endpoint (`POST /space/:spaceId/zcaps/revocations/:capabilityId`),
+ * revocation endpoint (`POST {spaceUrl}zcaps/revocations/:capabilityId`),
  * where the URL names the capability's `id` and the body is that capability
  * verbatim, proof and capability chain included.
  *
@@ -19,14 +19,23 @@
  * A chain that no longer verifies (tampered, expired, or a delegating key
  * gone from its controller document) synthesizes an empty controller set, so
  * the invocation is denied.
+ *
+ * This module also owns the root capability id grammar and its inverse. A
+ * Space-rooted chain starts at the Space's root capability, whose id encodes
+ * the Space URL, so the Space a capability belongs to is read off its chain
+ * (`spaceUrlOf`) rather than assembled from any server root.
  */
-import { spaceRevocation, toUrl, parseSpaceTarget } from './paths.js';
+import { canonicalSpaceUrl, spaceRevocationUrl } from './paths.js';
 import { send } from './request.js';
 import { ValidationError } from '../errors.js';
 /**
  * The zcap JSON-LD context URL, the sole `@context` of a root capability.
  */
 const ZCAP_CONTEXT_URL = 'https://w3id.org/zcap/v1';
+/**
+ * The prefix of a root capability id.
+ */
+const ROOT_ID_PREFIX = 'urn:zcap:root:';
 /**
  * The root capability id for an invocation target URL
  * (`urn:zcap:root:<encoded target>`) -- the id grammar shared by revocation
@@ -38,7 +47,26 @@ const ZCAP_CONTEXT_URL = 'https://w3id.org/zcap/v1';
  * @returns {string}
  */
 export function rootCapabilityId(target) {
-    return `urn:zcap:root:${encodeURIComponent(target)}`;
+    return `${ROOT_ID_PREFIX}${encodeURIComponent(target)}`;
+}
+/**
+ * The invocation target a root capability id names: the inverse of
+ * {@link rootCapabilityId}. Returns `null` for an id that is not a root
+ * capability id, or whose encoded target is malformed.
+ *
+ * @param id {string}   a capability id
+ * @returns {string | null}
+ */
+export function rootCapabilityTarget(id) {
+    if (!id.startsWith(ROOT_ID_PREFIX)) {
+        return null;
+    }
+    try {
+        return decodeURIComponent(id.slice(ROOT_ID_PREFIX.length));
+    }
+    catch {
+        return null;
+    }
 }
 /**
  * Builds the root capability for `target` in **object** form.
@@ -65,32 +93,76 @@ export function rootCapability({ target, controller }) {
     };
 }
 /**
- * Derives the id of the Space a capability is rooted in, from its
- * `invocationTarget`. A Space-rooted capability's target is the Space URL or a
- * path beneath it (the server enforces this when it verifies the chain), so
- * every depth `parseSpaceTarget` recognizes -- Space, Collection, Resource, or a
- * reserved sub-resource such as `/space/s/c/r/meta` -- carries the Space id.
+ * The id of the root capability a chain starts at: the first entry of the
+ * delegation proof's `capabilityChain`, or the `parentCapability` of a
+ * capability delegated straight from a root, or the capability's own id when
+ * it is a root. `undefined` when the capability carries no proof and no
+ * parent that names a root.
+ *
+ * The delegation proof is the one carrying `capabilityChain`, wherever it
+ * sits in a proof set: a capability may also carry an assertion proof, and
+ * nothing fixes the order.
+ *
+ * @param zcap {IZcap}
+ * @returns {string | undefined}
+ */
+function chainRootId(zcap) {
+    if (!('parentCapability' in zcap)) {
+        return zcap.id;
+    }
+    const proofs = Array.isArray(zcap.proof) ? zcap.proof : [zcap.proof];
+    const delegation = proofs.find(proof => proof?.capabilityChain !== undefined);
+    const first = delegation?.capabilityChain?.[0];
+    if (typeof first === 'string') {
+        return first;
+    }
+    return typeof zcap.parentCapability === 'string'
+        ? zcap.parentCapability
+        : undefined;
+}
+/**
+ * The URL of the Space a capability is rooted in, read off its delegation
+ * chain: a Space-rooted capability's chain starts at the Space's root
+ * capability, whose id encodes the Space URL. The result is in canonical
+ * form.
+ *
+ * The root's target is taken to be the Space URL. A Space URL has no shape
+ * of its own (a Collection URL is an http(s) URL ending in a slash too), so
+ * this function cannot tell a chain rooted at a Space from one rooted at a
+ * Collection, a Resource, or a Spaces Repository: only the server, which
+ * knows its hierarchy, can, and it refuses a revocation whose chain does not
+ * root exactly in the Space. What is refused here is a root whose target
+ * cannot be a Space URL at all (an origin, a URL with a query, a URN) and a
+ * chain that starts at no root capability. A capability this client minted
+ * from a handle is always Space-rooted. A bare `was.grant({ target })` with
+ * no `spaceUrl`, the mode for a server with no Space hierarchy, roots at
+ * its target and is not revocable this way by design.
  *
- * @param context {ClientContext}
  * @param zcap {IZcap}   the capability to locate
  * @returns {string}
+ * @throws {ValidationError}   when the chain does not start at a root
+ *   capability id, or that id names something that cannot be a Space URL
  */
-export function spaceIdOf(context, zcap) {
-    const parsed = parseSpaceTarget({
-        baseUrl: context.baseUrl,
-        target: zcap.invocationTarget
-    });
-    if (parsed === null) {
-        throw new ValidationError(`Cannot derive a Space from invocationTarget ` +
-            `"${zcap.invocationTarget}": it does not address a Space on ` +
-            `"${context.baseUrl}". Revocation is scoped to one Space.`);
+export function spaceUrlOf(zcap) {
+    const rootId = chainRootId(zcap);
+    const target = rootId === undefined ? null : rootCapabilityTarget(rootId);
+    if (target === null) {
+        throw new ValidationError(`Cannot derive a Space from capability "${zcap.id}": its chain does ` +
+            'not start at a root capability id (`urn:zcap:root:...`), so it is ' +
+            'not rooted in a Space.');
+    }
+    try {
+        return canonicalSpaceUrl(target);
+    }
+    catch (err) {
+        throw new ValidationError(`Cannot derive a Space from capability "${zcap.id}": its root ` +
+            `capability names "${target}", which is not a Space URL.`, { cause: err });
     }
-    return parsed.spaceId;
 }
 /**
  * Revokes a Space-rooted delegated capability: `POST`s it to
- * `/space/:spaceId/zcaps/revocations/:capabilityId`, invoking that URL's own
- * root capability. Resolves on the server's 204.
+ * `{spaceUrl}zcaps/revocations/:capabilityId`, invoking that URL's own root
+ * capability. Resolves on the server's 204.
  *
  * The `action` is deliberately left unset: `send()` defaults it to the HTTP
  * method, and this route expects `POST` (WAS capabilities are scoped by HTTP
@@ -98,18 +170,15 @@ export function spaceIdOf(context, zcap) {
  *
  * @param context {ClientContext}
  * @param options {object}
- * @param options.spaceId {string}          the Space the capability is rooted in
- * @param options.zcap {IDelegatedZcap}     the capability to revoke
+ * @param options.spaceUrl {string}          the Space the capability is rooted in
+ * @param options.zcap {IDelegatedZcap}      the capability to revoke
  * @returns {Promise<void>}
  */
-export async function submitRevocation(context, { spaceId, zcap }) {
+export async function submitRevocation(context, { spaceUrl, zcap }) {
     if (!('parentCapability' in zcap)) {
         throw new ValidationError('A root capability cannot be revoked; only a delegated capability can.');
     }
-    const url = toUrl({
-        baseUrl: context.baseUrl,
-        path: spaceRevocation(spaceId, zcap.id)
-    });
+    const url = spaceRevocationUrl({ spaceUrl, capabilityId: zcap.id });
     await send(context, {
         url,
         method: 'POST',

package/dist/internal/revoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"revoke.js","sourceRoot":"","sources":["../../src/internal/revoke.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C;;GAEG;AACH,MAAM,gBAAgB,GAAG,0BAA0B,CAAA;AAEnD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,iBAAiB,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAA;AACtD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,MAAM,EACN,UAAU,EAIX;IACC,OAAO;QACL,UAAU,EAAE,gBAAgB;QAC5B,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC;QAC5B,gBAAgB,EAAE,MAAM;QACxB,UAAU;KACX,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,OAAsB,EAAE,IAAW;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,IAAI,CAAC,gBAAgB;KAC9B,CAAC,CAAA;IACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CACvB,8CAA8C;YAC5C,IAAI,IAAI,CAAC,gBAAgB,oCAAoC;YAC7D,IAAI,OAAO,CAAC,OAAO,uCAAuC,CAC7D,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAA;AACvB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAsB,EACtB,EAAE,OAAO,EAAE,IAAI,EAA6C;IAE5D,IAAI,CAAC,CAAC,kBAAkB,IAAI,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,uEAAuE,CACxE,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;KACxC,CAAC,CAAA;IACF,MAAM,IAAI,CAAC,OAAO,EAAE;QAClB,GAAG;QACH,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,cAAc,CAAC;YACzB,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,OAAO,CAAC,aAAa;SAClC,CAAC;QACF,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"revoke.js","sourceRoot":"","sources":["../../src/internal/revoke.ts"],"names":[],"mappings":"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"}

package/dist/internal/service.d.ts

@@ -29,7 +29,8 @@ export declare function serviceLinkTarget({ header, baseUrl }: {
  * `specs` key other than the WAS identifier is ignored, a version entry
  * without a string `version` is ignored, and the newest version this client
  * speaks is chosen. The members the client acts on are checked before they are
- * used: `spaces` must be an absolute URL and `features` an array of strings.
+ * used: `spaces` must be an absolute `http(s)` URL and `features` an array of
+ * strings.
  *
  * @param description {unknown}   the parsed service description
  * @returns {ServiceInfo}
@@ -39,18 +40,35 @@ export declare function serviceLinkTarget({ header, baseUrl }: {
  */
 export declare function selectServiceVersion(description: unknown): ServiceInfo;
 /**
- * Discovers the service description from a URL the client holds and selects
- * the version to speak: an unsigned `HEAD` of `url` for its `service` link
- * (the response status does not matter), then an unsigned `GET` of the linked
- * document.
+ * Reads the service description at `serviceUrl` with an unsigned `GET` and
+ * selects the version to speak.
+ *
+ * A network failure, and a rate limit or temporary outage (429, 502, 503,
+ * 504), reject with the mapped transport error, since they say nothing about
+ * the protocol the server speaks.
+ *
+ * @param options {object}
+ * @param options.serviceUrl {string}   the service description's URL
+ * @returns {Promise<ServiceInfo>}
+ * @throws {IncompatibleServerError}   when the document cannot be read or
+ *   parsed, or version selection refuses it (see {@link selectServiceVersion})
+ */
+export declare function readServiceDescription({ serviceUrl }: {
+    serviceUrl: string;
+}): Promise<ServiceInfo>;
+/**
+ * Discovers the service description from a URL the server answers and
+ * selects the version to speak: an unsigned `HEAD` of `url` for its `service`
+ * link (the response status does not matter), then
+ * {@link readServiceDescription} of the linked document.
  *
  * A network failure, and a rate limit or temporary outage (429, 502, 503,
  * 504) that comes without the link, reject with the mapped transport error,
  * since they say nothing about the protocol the server speaks.
  *
  * @param options {object}
- * @param options.url {string}   any WAS URL, typically the client's `serverUrl`
- *   (its Spaces Repository URL)
+ * @param options.url {string}   any URL the WAS server answers, typically a
+ *   Spaces Repository URL
  * @returns {Promise<ServiceInfo>}
  * @throws {IncompatibleServerError}   when the response carries no `service`
  *   link, the linked document cannot be read or parsed, or version selection

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

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/internal/service.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,WAAW,yBAAyB,CAAA;AAEjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAA;AA+C7C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACR,EAAE;IACD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,MAAM,GAAG,SAAS,CA2BrB;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,CAiEtE;AAqCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,EACpC,GAAG,EACJ,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,WAAW,CAAC,CAuCvB"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/internal/service.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;GAGG;AACH,eAAO,MAAM,WAAW,yBAAyB,CAAA;AAEjD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAA;AA+C7C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,OAAO,EACR,EAAE;IACD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,MAAM,GAAG,SAAS,CA2BrB;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,CAiEtE;AAqCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,UAAU,EACX,EAAE;IACD,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,eAAe,CAAC,EACpC,GAAG,EACJ,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,WAAW,CAAC,CAiBvB"}

package/dist/internal/service.js

@@ -1,4 +1,5 @@
 import { IncompatibleServerError, mapError } from '../errors.js';
+import { canonicalContainerUrl, parseAbsoluteHttpUrl } from './paths.js';
 import { fetchMapped } from './request.js';
 /**
  * The WAS specification's identifier, the `specs` key its version entries sit
@@ -104,27 +105,13 @@ export function serviceLinkTarget({ header, baseUrl }) {
 function isObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
-/**
- * Whether a value parses as an absolute URL.
- *
- * @param value {string}
- * @returns {boolean}
- */
-function isAbsoluteUrl(value) {
-    try {
-        new URL(value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 /**
  * Applies the spec's version-selection rules to a service description: a
  * `specs` key other than the WAS identifier is ignored, a version entry
  * without a string `version` is ignored, and the newest version this client
  * speaks is chosen. The members the client acts on are checked before they are
- * used: `spaces` must be an absolute URL and `features` an array of strings.
+ * used: `spaces` must be an absolute `http(s)` URL and `features` an array of
+ * strings.
  *
  * @param description {unknown}   the parsed service description
  * @returns {ServiceInfo}
@@ -156,9 +143,9 @@ export function selectServiceVersion(description) {
     }
     const { spaces, features } = chosen;
     if (spaces !== undefined &&
-        (typeof spaces !== 'string' || !isAbsoluteUrl(spaces))) {
+        (typeof spaces !== 'string' || parseAbsoluteHttpUrl(spaces) === null)) {
         throw new IncompatibleServerError(`The ${PWS_SPEC_ID} ${chosen.version} entry's \`spaces\` is not an ` +
-            'absolute URL.');
+            'absolute http(s) URL.');
     }
     if (features !== undefined &&
         (!Array.isArray(features) ||
@@ -171,7 +158,7 @@ export function selectServiceVersion(description) {
         description: description,
         version: chosen.version,
         entry: chosen,
-        ...(spaces !== undefined && { spacesUrl: spaces }),
+        ...(spaces !== undefined && { spacesUrl: canonicalContainerUrl(spaces) }),
         features: tokens,
         hasFeature(token) {
             return tokens.includes(token);
@@ -204,38 +191,20 @@ function refuse({ status, requestUrl, message }) {
     throw new IncompatibleServerError(message, { requestUrl });
 }
 /**
- * Discovers the service description from a URL the client holds and selects
- * the version to speak: an unsigned `HEAD` of `url` for its `service` link
- * (the response status does not matter), then an unsigned `GET` of the linked
- * document.
+ * Reads the service description at `serviceUrl` with an unsigned `GET` and
+ * selects the version to speak.
  *
  * A network failure, and a rate limit or temporary outage (429, 502, 503,
- * 504) that comes without the link, reject with the mapped transport error,
- * since they say nothing about the protocol the server speaks.
+ * 504), reject with the mapped transport error, since they say nothing about
+ * the protocol the server speaks.
  *
  * @param options {object}
- * @param options.url {string}   any WAS URL, typically the client's `serverUrl`
- *   (its Spaces Repository URL)
+ * @param options.serviceUrl {string}   the service description's URL
  * @returns {Promise<ServiceInfo>}
- * @throws {IncompatibleServerError}   when the response carries no `service`
- *   link, the linked document cannot be read or parsed, or version selection
- *   refuses it (see {@link selectServiceVersion})
+ * @throws {IncompatibleServerError}   when the document cannot be read or
+ *   parsed, or version selection refuses it (see {@link selectServiceVersion})
  */
-export async function discoverService({ url }) {
-    const probe = await fetchMapped(url, { method: 'HEAD' });
-    const serviceUrl = serviceLinkTarget({
-        header: probe.headers.get('link'),
-        baseUrl: probe.url || url
-    });
-    if (serviceUrl === undefined) {
-        refuse({
-            status: probe.status,
-            requestUrl: url,
-            message: `The response from "${url}" (${probe.status}) carries no ` +
-                'rel="service" link, so the server predates WAS v0.5, which this ' +
-                'client requires.'
-        });
-    }
+export async function readServiceDescription({ serviceUrl }) {
     const response = await fetchMapped(serviceUrl, {
         method: 'GET',
         headers: { accept: 'application/json' }
@@ -257,4 +226,39 @@ export async function discoverService({ url }) {
     }
     return selectServiceVersion(description);
 }
+/**
+ * Discovers the service description from a URL the server answers and
+ * selects the version to speak: an unsigned `HEAD` of `url` for its `service`
+ * link (the response status does not matter), then
+ * {@link readServiceDescription} of the linked document.
+ *
+ * A network failure, and a rate limit or temporary outage (429, 502, 503,
+ * 504) that comes without the link, reject with the mapped transport error,
+ * since they say nothing about the protocol the server speaks.
+ *
+ * @param options {object}
+ * @param options.url {string}   any URL the WAS server answers, typically a
+ *   Spaces Repository URL
+ * @returns {Promise<ServiceInfo>}
+ * @throws {IncompatibleServerError}   when the response carries no `service`
+ *   link, the linked document cannot be read or parsed, or version selection
+ *   refuses it (see {@link selectServiceVersion})
+ */
+export async function discoverService({ url }) {
+    const probe = await fetchMapped(url, { method: 'HEAD' });
+    const serviceUrl = serviceLinkTarget({
+        header: probe.headers.get('link'),
+        baseUrl: probe.url || url
+    });
+    if (serviceUrl === undefined) {
+        refuse({
+            status: probe.status,
+            requestUrl: url,
+            message: `The response from "${url}" (${probe.status}) carries no ` +
+                'rel="service" link, so the server predates WAS v0.5, which this ' +
+                'client requires.'
+        });
+    }
+    return readServiceDescription({ serviceUrl });
+}
 //# sourceMappingURL=service.js.map

package/dist/internal/service.js.map

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

package/dist/internal/write.d.ts

@@ -24,22 +24,22 @@ import type { IZcap, ResourceData } from '../types.js';
 import type { ClientContext } from './request.js';
 import type { WritePrecondition } from './conditional.js';
 /**
- * Sends an encoded write (`PUT`/`POST`) to a resource path, applying the
+ * Sends an encoded write (`PUT`/`POST`) to a resource URL, applying the
  * encoded body (`json` or `body`), its content-type, and the conditional-write
  * precondition. A write is never a `read`, so the response is always present
  * (errors throw via `send`).
  *
  * @param context {ClientContext}
  * @param options {object}
- * @param options.path {string}                  the resource path to write
+ * @param options.url {string}                   the resource URL to write
  * @param options.method {string}                `PUT` or `POST`
  * @param options.encoded {EncodedWrite}         the codec's encoded write
  * @param [options.capability] {IZcap}
  * @param [options.precondition] {WritePrecondition}   conditional-write headers
  * @returns {Promise<HttpResponse>}
  */
-export declare function sendEncodedWrite(context: ClientContext, { path, method, encoded, capability, precondition }: {
-    path: string;
+export declare function sendEncodedWrite(context: ClientContext, { url, method, encoded, capability, precondition }: {
+    url: string;
     method: string;
     encoded: EncodedWrite;
     capability?: IZcap;
@@ -68,19 +68,19 @@ export declare function codecRequestContext(context: ClientContext, { capability
 }): CodecRequestContext;
 /**
  * The outcome of {@link insertResource}: either the ordinary single-request
- * write (the codec's encoding, the path written, and the response) or the
+ * write (the codec's encoding, the URL written, and the response) or the
  * result of a codec's multi-request {@link ChunkedWrite} plan, which has no one
  * canonical response.
  */
 export type InsertOutcome = {
     chunked?: false;
     encoded: EncodedWrite;
-    path: string;
+    url: string;
     response: HttpResponse;
 } | {
     chunked: true;
     id: string;
-    path: string;
+    url: string;
     contentType?: string;
     etag?: string;
 };
@@ -95,21 +95,21 @@ export type InsertOutcome = {
  * preconditions.
  *
  * A codec that mints its own id (e.g. the encrypting codec's EDV id) writes it
- * by `PUT` to that id's path; a codec that mints none (the identity codec)
- * `POST`s to the items path and lets the server mint one. A conditional codec
+ * by `PUT` to that id's URL; a codec that mints none (the identity codec)
+ * `POST`s to the items URL and lets the server mint one. A conditional codec
  * computes the precondition itself (the EDV codec guards its fresh insert with
  * `If-None-Match: *`); an insert through a non-conditional codec is
  * unconditional, since `add()` names no target revision to pin against.
  *
- * Returns the codec's encoded write and the path actually written alongside the
+ * Returns the codec's encoded write and the URL actually written alongside the
  * response, so the caller can shape its result (the created id and URL) without
  * re-deriving either.
  *
  * @param context {ClientContext}
  * @param options {object}
- * @param options.itemsPath {string}       the collection's items path, the
+ * @param options.itemsUrl {string}       the collection's items URL, the
  *   `POST` target when the codec mints no id
- * @param options.pathForId {function}     builds the resource path for a
+ * @param options.urlForId {function}     builds the resource URL for a
  *   codec-minted id
  * @param options.codec {ResourceCodec}    the collection's resolved codec
  * @param options.data {ResourceData}      the plaintext value
@@ -117,9 +117,9 @@ export type InsertOutcome = {
  * @param [options.capability] {IZcap}
  * @returns {Promise<InsertOutcome>}
  */
-export declare function insertResource(context: ClientContext, { itemsPath, pathForId, codec, data, contentType, capability }: {
-    itemsPath: string;
-    pathForId: (id: string) => string;
+export declare function insertResource(context: ClientContext, { itemsUrl, urlForId, codec, data, contentType, capability }: {
+    itemsUrl: string;
+    urlForId: (id: string) => string;
     codec: ResourceCodec;
     data: ResourceData;
     contentType?: string;
@@ -152,7 +152,7 @@ export declare function insertResource(context: ClientContext, { itemsPath, path
  *
  * @param context {ClientContext}
  * @param options {object}
- * @param options.path {string}                  the resource path to write
+ * @param options.url {string}                   the resource URL to write
  * @param options.codec {ResourceCodec}          the collection's resolved codec
  * @param options.id {string}                    the resource id
  * @param options.data {ResourceData}            the plaintext value
@@ -162,8 +162,8 @@ export declare function insertResource(context: ClientContext, { itemsPath, path
  *   precondition (used only for a non-conditional codec)
  * @returns {Promise<{ etag?: string }>}   the stored resource's new ETag
  */
-export declare function upsertResource(context: ClientContext, { path, codec, id, data, contentType, capability, precondition: callerPrecondition }: {
-    path: string;
+export declare function upsertResource(context: ClientContext, { url, codec, id, data, contentType, capability, precondition: callerPrecondition }: {
+    url: string;
     codec: ResourceCodec;
     id: string;
     data: ResourceData;

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/internal/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAUjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,EACE,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,YAAY,EACb,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GACA,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,EAAE,UAAU,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,KAAK,CAAA;CAAO,GAC1C,mBAAmB,CASrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IACE,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,OAAO,EAAE,YAAY,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,YAAY,CAAA;CACvB,GACD;IACE,OAAO,EAAE,IAAI,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,EACE,SAAS,EACT,SAAS,EACT,KAAK,EACL,IAAI,EACJ,WAAW,EACX,UAAU,EACX,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IACjC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB,GACA,OAAO,CAAC,aAAa,CAAC,CA2BxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,EACE,IAAI,EACJ,KAAK,EACL,EAAE,EACF,IAAI,EACJ,WAAW,EACX,UAAU,EACV,YAAY,EAAE,kBAAkB,EACjC,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GACA,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiE5B"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/internal/write.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAEV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAUjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,EACE,GAAG,EACH,MAAM,EACN,OAAO,EACP,UAAU,EACV,YAAY,EACb,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,YAAY,CAAA;IACrB,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GACA,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,EAAE,UAAU,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,KAAK,CAAA;CAAO,GAC1C,mBAAmB,CASrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IACE,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,OAAO,EAAE,YAAY,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,YAAY,CAAA;CACvB,GACD;IACE,OAAO,EAAE,IAAI,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,EACE,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,WAAW,EACX,UAAU,EACX,EAAE;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAA;CACnB,GACA,OAAO,CAAC,aAAa,CAAC,CA2BxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,EACE,GAAG,EACH,KAAK,EACL,EAAE,EACF,IAAI,EACJ,WAAW,EACX,UAAU,EACV,YAAY,EAAE,kBAAkB,EACjC,EAAE;IACD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,aAAa,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,KAAK,CAAA;IAClB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GACA,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiE5B"}