@interop/was-client 0.97.1 → 0.99.0

package/README.md

@@ -3,7 +3,7 @@
 [![Node.js CI](https://github.com/interop-alliance/was-client/workflows/CI/badge.svg)](https://github.com/interop-alliance/was-client/actions?query=workflow%3A%22CI%22)
 [![NPM Version](https://img.shields.io/npm/v/@interop/was-client.svg)](https://npm.im/@interop/was-client)
 
-> A developer-friendly client for Wallet Attached Storage (WAS) servers, with a
+> A developer-friendly client for Wallet Attached Storage (PWS) servers, with a
 > database-driver-inspired navigational API over zcap-authorized HTTP.
 
 ## Table of Contents
@@ -27,7 +27,7 @@
   - [Storage introspection: backends and quotas](#storage-introspection-backends-and-quotas)
   - [Registering a Bring-Your-Own-Storage backend](#registering-a-bring-your-own-storage-backend)
   - [Replica registration](#replica-registration)
-  - [Encrypted collections (EDV-over-WAS): pass-through encryption via the WAS client (recommended)](#encrypted-collections-edv-over-was-pass-through-encryption-via-the-was-client-recommended)
+  - [Encrypted collections (EDV-over-PWS): pass-through encryption via the PWS client (recommended)](#encrypted-collections-edv-over-pws-pass-through-encryption-via-the-pws-client-recommended)
   - [Cross-replica sync](#cross-replica-sync)
   - [Resource logs (co-managed key resources)](#resource-logs-co-managed-key-resources)
   - [Export and import](#export-and-import)
@@ -38,17 +38,17 @@
 
 ## Background
 
-The WAS protocol exposes a general purpose database-like container model --
+The PWS protocol exposes a general purpose database-like container model --
 `SpacesRepository > Space > Collection > Resource` -- over HTTP, authorized with
 [Authorization Capabilities (zcaps)](https://w3c-ccg.github.io/zcap-spec/).
 
 `@interop/was-client` wraps that `ZcapClient` and exposes the containment model
 through cheap, lazy navigational handles modeled on a document store's DX
-(`client > db > collection`), using WAS-specific verbs
-(`add`/`get`/`put`/`list`/`delete`) rather than `insertOne`/`findOne` (WAS has
+(`client > db > collection`), using PWS-specific verbs
+(`add`/`get`/`put`/`list`/`delete`) rather than `insertOne`/`findOne` (PWS has
 no query-by-filter yet).
 
-| Document db driver                  | WAS client                                 |
+| Document db driver                  | PWS client                                 |
 | ----------------------------------- | ------------------------------------------ |
 | `new Client(url)`                   | `new WasClient({ serverUrl, zcapClient })` |
 | `client.db('app')`                  | `was.space(spaceId)`                       |
@@ -205,7 +205,7 @@ own pace produces.
 Before its first signed request, the client reads the server's service
 description. It sends an unsigned `HEAD` to `serverUrl`, the Spaces Repository
 URL, and follows the `Link: <...>; rel="service"` header on the response,
-whatever its status. The WAS server itself answers that URL. The server root is
+whatever its status. The PWS server itself answers that URL. The server root is
 often a landing page served by something else, with no `service` link. Then it
 reads the linked document with an unsigned `GET`. The spec fixes no path for the
 document, so the client assumes none. A server that advertises its Spaces
@@ -213,7 +213,7 @@ Repository at a URL other than `serverUrl` is refused with
 `IncompatibleServerError`, since every Space path would otherwise be addressed
 at the wrong mount.
 
-From the document the client selects the WAS specification version it speaks.
+From the document the client selects the PWS specification version it speaks.
 This client speaks only v0.5. It ignores `specs` keys other than
 `https://w3id.org/pws` and entries without a `version`. If no entry names v0.5,
 or the document is malformed, every signed request rejects with
@@ -251,7 +251,7 @@ that copy without fetching, and `service({ refresh: true })` discovers afresh.
 
 ### The handle model
 
-The client exposes the WAS containment model
+The client exposes the PWS containment model
 (`SpacesRepository > Space > Collection > Resource`) as navigational handles.
 Handles are lazy and synchronous to obtain -- only the verb methods hit the
 network. Lazy chains never throw: `was.space(x).collection(y)` does no I/O and
@@ -350,7 +350,7 @@ const userSpaces = items.filter(item => !item.type.includes('AuxiliarySpace'))
 
 ### Collections
 
-A Collection lives inside a Space and holds resources. WAS does not auto-create
+A Collection lives inside a Space and holds resources. PWS does not auto-create
 parents, so `createCollection` throws `NotFoundError` if the space does not
 exist. The server generates the id unless you pass one (a handful of reserved
 ids are rejected).
@@ -451,7 +451,7 @@ Writes detect the payload: a plain object/array is sent as JSON; a
 `Blob`/`Uint8Array`/`Buffer` is sent as binary, with the content-type taken from
 `options.contentType`, the `Blob.type`, or `application/octet-stream`. A
 `ReadableStream<Uint8Array>` is accepted only by an encrypted collection (see
-[Encrypted collections](#encrypted-collections-edv-over-was-pass-through-encryption-via-the-was-client-recommended)).
+[Encrypted collections](#encrypted-collections-edv-over-pws-pass-through-encryption-via-the-pws-client-recommended)).
 A plaintext collection refuses it with `ValidationError`. A plaintext resource
 has no chunked representation, and a signed request carries a `Digest` of its
 whole body. Buffer the stream into a `Blob` there.
@@ -502,7 +502,7 @@ handle's URL. The recipient rebuilds access from the received zcap with
 const added = await collection.add({ secret: 'value' })
 const zcap = await was.grant({
   to: bobDid,
-  actions: ['GET'], // HTTP verbs: 'GET' | 'PUT' | 'POST' | 'DELETE'
+  actions: ['GET'], // HTTP verbs: 'GET' | 'HEAD' | 'PUT' | 'POST' | 'DELETE'
   target: added.url
 })
 
@@ -511,7 +511,18 @@ const handle = bobWas.fromCapability(zcap) // a Resource here
 await handle.get() // succeeds; a write would be denied by the GET-only grant
 ```
 
-Actions are HTTP verbs (`GET` / `PUT` / `POST` / `DELETE`). The WAS server
+A resource-scoped grant does not cover the Collection Metadata object, so a
+client constructed with an `encryption` provider cannot discover whether the
+collection is encrypted and fails closed with `EncryptionError`. Pass the handle
+an explicit override, as you would to `collection.resource(id, options)`:
+`'plaintext'` for a plaintext collection, or the collection's `encryption`
+descriptor (shared out of band with the grant) for an encrypted one.
+
+```ts
+const handle = bobWas.fromCapability(zcap, { encryption: 'plaintext' })
+```
+
+Actions are HTTP verbs (`GET` / `PUT` / `POST` / `DELETE`). The PWS server
 authorizes on these case-sensitively (uppercase), but `grant()` also accepts the
 lowercase forms and normalizes them to uppercase in the signed zcap -- so
 `actions: ['get']` still validates server-side.
@@ -531,7 +542,7 @@ await space.revoke(zcap) // from now on the capability is rejected
 Two parties may revoke: the Space's controller, and any controller in the
 capability's own delegation chain -- so an application can revoke the capability
 it holds, without being granted anything extra. Anyone else gets a
-`NotFoundError`, WAS's mask for "not visible to you".
+`NotFoundError`, PWS's mask for "not visible to you".
 
 Three properties are easy to get wrong:
 
@@ -757,7 +768,7 @@ const { descriptor } = await store.read() // verified head state, `history` kept
 ### Conditional writes (optimistic concurrency)
 
 Every Resource carries a strong **`ETag`** validator that changes on every write
-(conditional writes are a baseline WAS server requirement). Use it to prevent
+(conditional writes are a baseline PWS server requirement). Use it to prevent
 the lost-update problem -- two clients that both read version _N_ and each write
 _N+1_, the second silently clobbering the first.
 
@@ -996,7 +1007,7 @@ surfaces the Space's registrations as the read-only `replicas` member, one
 `{ fromSpace, toSpace, role }` summary per peer, with no registration id and no
 capability. The server ignores `replicas` in a write body.
 
-### Encrypted collections (EDV-over-WAS): pass-through encryption via the WAS client (recommended)
+### Encrypted collections (EDV-over-PWS): pass-through encryption via the PWS client (recommended)
 
 This is the recommended way to use encrypted collections. For the low-level
 alternative -- driving an `EdvClientCore` directly via `WasTransport`, which is
@@ -1082,7 +1093,7 @@ Encrypted collections are a **stricter contract**, not a drop-in (documents-only
 scope for now):
 
 - **Ids.** `add()` mints an EDV id (a `z`-prefixed multibase value used verbatim
-  as the WAS resource id). `put(id, ...)` accepts only an EDV-format id; a
+  as the PWS resource id). `put(id, ...)` accepts only an EDV-format id; a
   human-readable id is rejected (it would leak onto the URL) -- carry a
   human-readable label inside the encrypted content instead. By default the
   minted id is random (the classic mutable-document model); pass
@@ -1106,23 +1117,23 @@ scope for now):
   read back transparently by `get()`. Serving the chunk endpoints is a
   conformance requirement of a server that offers encrypted collections, so
   there is no client-side gate -- one that does not answers `501`.
-  `put(id, bigBlob)` takes the same route where no document is stored at `id`
-  yet, so a large binary can be created at an id of your choosing (pass
-  `ifNoneMatch: true` to get a `412` when the id is taken). Two limits apply.
-  `put()` over an existing document is refused, since replacing its chunks is
-  not automated. And a content-addressed collection (`idDerivation: 'content'`)
-  is refused too: a chunked write stores the document twice, so no single
-  ciphertext derives its id. A chunked write that fails partway deletes what it
-  wrote, and a `507` surfaces as `QuotaExceededError`. One that could not clean
-  up leaves a pending stub, which every read refuses; the EDV doc cipher's
-  `isPendingStub` recognizes it, and `delete()` removes it with its chunks. Tune
-  the threshold and the chunk size with
-  `createEdvEncryption({ maxBlobBytes, chunkSize })`.
+  `put(id, bigBlob)` takes the same route, creating the resource where none is
+  stored at `id` (pass `ifNoneMatch: true` to get a `412` when the id is taken)
+  and replacing the document otherwise. Replacing a chunked document, with a
+  blob of any size or a JSON value, reaps the chunks the new document does not
+  cover once it is stored. One limit applies: a content-addressed collection
+  (`idDerivation: 'content'`) refuses a chunked write, since it stores the
+  document twice and no single ciphertext derives its id. A chunked create that
+  fails partway deletes what it wrote, and a `507` surfaces as
+  `QuotaExceededError`. One that could not clean up, and a replace that fails
+  partway, leave a pending stub, which every read refuses; the EDV doc cipher's
+  `isPendingStub` recognizes it, the next `put()` at the id replaces it, and
+  `delete()` removes it with its chunks. Tune the threshold and the chunk size
+  with `createEdvEncryption({ maxBlobBytes, chunkSize })`.
 - **Streams.** A `ReadableStream<Uint8Array>` has no known size, so `add()`
   always routes it to the chunked-stream path, however short it is. It is
   encrypted and written as it is read, without buffering. `put(id, stream)`
-  takes the same route where no document is stored at `id` yet. Over an existing
-  document it is refused with `ValidationError` before the stream is read. A
+  takes the same route, creating or replacing the document at `id`. A
   content-addressed collection refuses a stream for the reason it refuses a
   large blob. A write that fails midway cancels the stream, so the source behind
   it is released. The content type is `options.contentType`, then a guess from
@@ -1214,7 +1225,7 @@ const { count } = await vault.find({
 ```
 
 Attribute names are dotted paths rooted at `content` or `meta` (the document's
-own `meta`, which carries the content type and encoding -- not the WAS `/meta`
+own `meta`, which carries the content type and encoding -- not the PWS `/meta`
 name/tags, which live in a separate envelope and are deliberately not indexed).
 Pass an array of names for a compound index, searchable by a leading prefix of
 its attributes; `unique: true` makes the server answer a colliding write with
@@ -1241,14 +1252,16 @@ that offers encrypted collections; one that does not answers `501`
 (`NotImplementedError`). `find()` / `declareIndex()` on a plaintext collection
 throw -- there is no client-side index there.
 
-Note that `collection.setMeta({ custom })` replaces the whole `custom` object,
-schema included; the `setName()` / `setTags()` sugar merges instead and leaves
-it intact.
+`collection.setMeta({ custom })` replaces the whole `custom` object, with one
+exception: a `custom` that does not name `indexSchema` keeps the stored schema.
+A `custom` that does name it is sent as given, so `indexSchema: undefined` drops
+the stored schema. The `setName()` / `setTags()` sugar merges and leaves it
+intact either way.
 
 ### Cross-replica sync
 
 The opt-in `@interop/was-client/sync` subpath supplies everything a wallet needs
-to replicate one Space + Collection across devices, with WAS as the primary
+to replicate one Space + Collection across devices, with PWS as the primary
 copy. It is not a sync engine itself -- it provides the seams a change engine
 plugs into:
 
@@ -1404,7 +1417,7 @@ const page = await collection.changes({ method: 'GET', checkpoint, limit: 100 })
 
 ### Resource logs (co-managed key resources)
 
-The opt-in `@interop/was-client/log` subpath is the WAS binding of
+The opt-in `@interop/was-client/log` subpath is the PWS binding of
 `@interop/vh-resource-log`'s store port. Resource logs -- the hash-linked, JSON
 Lines log format (the encrypted-collections spec's Resource Log Profile)
 governing key resources co-managed between a wallet's clients and the storage
@@ -1415,8 +1428,8 @@ library: the JSON Lines codec, the `ResourceLogStore` port, the read-back
 re-exports none of them.
 
 - **`resourceLogStore({ resource })`** / **`resourceLogStore({ collection })`**
-  -- the port over one of the two places a WAS server keeps a log, stored as
-  `text/jsonl` either way: a WAS Resource whose whole body is the log (a key
+  -- the port over one of the two places a PWS server keeps a log, stored as
+  `text/jsonl` either way: a PWS Resource whose whole body is the log (a key
   roster), or a Collection's governing history log at its `/meta/log`
   sub-resource (the descriptor the server derives `encryption` from; see "The
   governing history log" above). The store does read-with-etag of the full log,
@@ -1471,7 +1484,7 @@ const response = await was.request({ path: `/space/${spaceId}`, method: 'GET' })
 ## Errors and the 404/null caveat
 
 Read methods (`describe`/`get`/`list`) return `null` on a 404, following
-MongoDB's `findOne` semantics. **WAS returns 404 for both not-found and
+MongoDB's `findOne` semantics. **PWS returns 404 for both not-found and
 unauthorized**, so `null` means "not visible to you" rather than strictly "does
 not exist". Write/delete methods throw a typed error instead.
 
@@ -1500,9 +1513,14 @@ instead, as `{ outcome: 'not-found' }`, rather than swallowing it.
 Spec endpoints a given server has not yet implemented surface as
 `NotImplementedError` (the server's 501).
 
+The client-side errors (`EncryptionError` and its subtypes, `NotSupportedError`,
+`UnknownEpochError`) are `WasError`s too; they carry no `status`. An
+`UnknownEpochError` carries the `collectionId` whose descriptor to re-read and
+the envelope's unroutable `kids`.
+
 `IncompatibleServerError` comes from service discovery, not from a response
 status. Any signed method, read methods included, throws it when the server
-speaks no WAS version this client understands (see
+speaks no PWS version this client understands (see
 [Service discovery](#service-discovery)). It carries no `status`, so a read
 method does not mistake it for a 404.
 

package/dist/Collection.d.ts

@@ -77,7 +77,12 @@ export declare class Collection {
      *
      * The merge runs against the same read the write is pinned to, and rebases
      * with it: a rival configuration change landing in between is re-read and
-     * merged over rather than re-applied stale.
+     * merged over rather than re-applied stale. That covers the `encryption`
+     * descriptor too, which the merge carries forward whole: a reader escrowed
+     * into the current epoch by a concurrent `addRecipient` is re-read on the
+     * rebase, so this write never sends the roster without that reader's
+     * wrapped key. Pass `ifMatch` to pin the write to a validator of your own
+     * instead, and see a lost race as `PreconditionFailedError`.
      *
      * The merge needs a readable current object to be lost-update-safe, and the
      * read cannot distinguish "absent" from "unreadable" (WAS masks unauthorized
@@ -108,18 +113,24 @@ export declare class Collection {
      *   rather than merged forward. `null` means the caller read it and found
      *   the collection absent or unreadable; omitting the member entirely is
      *   what asks for the read
+     * @param [desc.ifMatch] {string}   the caller's own validator (the `etag`
+     *   from {@link describeWithEtag}): the merge then runs once against the
+     *   version it names and a lost race surfaces as `PreconditionFailedError`
+     *   instead of being rebased, for a caller whose decision to write depends
+     *   on what it read. A pinned write is to an object the caller has read, so
+     *   an unreadable one is `NotFoundError`, not a create
      * @returns {Promise<{ description: CollectionMetadata; etag?: string }>}
      *   the `description` as merged and written by the last attempt, together
-     *   with that write's `etag` -- the validator to pass to
-     *   {@link replaceDescription}'s `ifMatch` for a follow-on
-     *   compare-and-swap. `etag` is absent only where the header did not reach
-     *   the client
+     *   with that write's `etag` -- the validator to pass to a follow-on
+     *   `ifMatch` for a compare-and-swap. `etag` is absent only where the header
+     *   did not reach the client
      */
     configure(desc: CollectionWritableFields & {
         force?: boolean;
         current?: (CollectionMetadata & {
             etag?: string;
         }) | null;
+        ifMatch?: string;
     }): Promise<{
         description: CollectionMetadata;
         etag?: string;
@@ -200,11 +211,26 @@ export declare class Collection {
     }) | null>;
     /**
      * Replaces the Collection's user-writable annotations (`custom`). This is a
-     * full replacement of `custom`: any property omitted from it is cleared, and
-     * an omitted `custom` clears them all. The Collection's configuration
-     * members are carried forward -- the same `PUT` replaces the whole
-     * Collection Metadata object, so they are read and re-sent rather than
-     * dropped.
+     * full replacement of `custom`: any annotation omitted from it is cleared,
+     * and an omitted `custom` clears every annotation. The Collection's
+     * configuration members are carried forward -- the same `PUT` replaces the
+     * whole Collection Metadata object, so they are read and re-sent rather
+     * than dropped.
+     *
+     * One member of `custom` is carried forward the same way, and is the one
+     * exception to the full replacement: the persisted `indexSchema` that
+     * {@link declareIndex} stores there. It is collection state this library
+     * owns, not an annotation the caller is replacing, so a `custom` with no
+     * `indexSchema` member of its own (and an omitted `custom`) keeps the stored
+     * one. A `custom` that names `indexSchema` is sent as given, and installs
+     * what it names on this handle's codec, as {@link declareIndex} does. That
+     * is also how the stored schema is dropped: a `custom` carrying
+     * `indexSchema: undefined` names the member, so nothing is carried forward,
+     * and the undefined member is omitted from the serialized write. Carrying
+     * the schema forward opens the stored `custom` through the codec (reusing
+     * the open a preceding {@link meta} read performed). A stored `custom` this
+     * client cannot open carries nothing, so the write still replaces it as
+     * given.
      *
      * On an encrypted collection `custom` is encrypted into an opaque envelope by
      * the codec before it is sent, so `name` / `tags` are never stored as
@@ -230,7 +256,8 @@ export declare class Collection {
      * @param meta {object}
      * @param [meta.custom] {ResourceMetadataCustomInput}   the user-writable
      *   properties; extra members beyond `name` / `tags` are admitted (this
-     *   Collection-level `custom` also carries the persisted `indexSchema`)
+     *   Collection-level `custom` also carries the persisted `indexSchema`,
+     *   which is carried forward from the stored object when omitted here)
      *   while `name` / `tags` themselves stay checked at their stored types
      * @param options {object}
      * @param [options.ifMatch] {string}       update only if the `ETag` matches
@@ -605,10 +632,11 @@ export declare class Collection {
      * The query is sent as a `POST` whose body carries the parameters, or in
      * the read-only `GET` form with the parameters in the query string, which
      * the server verifies under the `GET` action and answers with the same page.
-     * A capability whose `allowedAction` excludes `POST` (a GET-only pull
-     * capability, say) reads the feed with `GET`, since the `POST` form refuses
-     * it with `NotFoundError`; every other handle sends `POST`. `method`
-     * overrides the derived form.
+     * A capability whose `allowedAction` excludes `POST` (a GET and HEAD grant
+     * on the collection, say, which is what a subscription agent holds) reads
+     * the feed with `GET`, since the `POST` form refuses it with
+     * `NotFoundError`; every other handle sends `POST`. `method` overrides the
+     * derived form.
      *
      * @param [options] {object}
      * @param [options.checkpoint] {ChangesCheckpoint}   opaque checkpoint from a prior page; resume strictly after it

package/dist/Collection.d.ts.map

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