@interop/was-react 0.2.1 → 0.3.0

package/README.md

@@ -104,7 +104,7 @@ no per-collection key is derived, payloads are stored as-is locally and
 remotely, and the stored resource id is the payload's own logical `id`, so a
 public document keeps a stable, shareable resource URL across edits. Be aware
 that everything in a public payload is world-readable -- including the LWW
-bookkeeping fields `updatedAt` and `deviceId` (`deviceId` is a random
+bookkeeping fields `updatedAt` and `clientId` (`clientId` is a random
 per-install identifier, but still a linkability handle across a user's public
 documents). Changing a collection's visibility after first use is a
 data-migration event, not a config tweak: rows written in the other mode stop
@@ -112,7 +112,7 @@ being readable. A registry that maps one WAS collection id to both visibilities
 is rejected at store open. Two payload constraints on public collections: a
 top-level object-valued `jwe` field is reserved (the read path uses it to
 recognize a stray encrypted envelope and refuses the row), and payloads should
-carry the `updatedAt` / `deviceId` LWW fields like any other collection --
+carry the `updatedAt` / `clientId` LWW fields like any other collection --
 without them a concurrent multi-device edit falls back to server-wins.
 
 At login, a public collection is requested from the wallet with the distinct
@@ -138,7 +138,7 @@ export interface Note {
   body: string
   createdAt: string
   updatedAt: string
-  deviceId: string
+  clientId: string
 }
 
 export const useNotes = createEntityStore<Note>('notes')
@@ -201,7 +201,7 @@ export function LoginPage() {
 
 ```tsx
 import { uuidv7 } from 'uuidv7'
-import { getDeviceId } from '@interop/was-react'
+import { getClientId } from '@interop/was-react'
 import { useNotes } from './stores.js'
 
 export function Notes() {
@@ -216,7 +216,7 @@ export function Notes() {
       body: '',
       createdAt: now,
       updatedAt: now,
-      deviceId: getDeviceId()
+      clientId: getClientId()
     })
   }
 
@@ -233,7 +233,7 @@ export function Notes() {
 }
 ```
 
-Entity payloads MUST carry `updatedAt` and `deviceId` (from `getDeviceId()`),
+Entity payloads MUST carry `updatedAt` and `clientId` (from `getClientId()`),
 stamped on EVERY insert and update: they are the last-write-wins pair that
 settles concurrent multi-device edits of the same entity. A payload without them
 loses every sync conflict.
@@ -402,8 +402,8 @@ Hooks:
   zcaps). Pull is driven by the WAS `changes` feed; a low-frequency periodic
   re-sync (`sync.pollMs`, default 15s) keeps open sessions converging.
 - **Conflict resolution.** Last-writer-wins on the payload's own
-  `(updatedAt, deviceId)` (ISO lexical compare, with a per-install random
-  `deviceId` tiebreaker). Updates re-encrypt in place under the same envelope id
+  `(updatedAt, clientId)` (ISO lexical compare, with a per-install random
+  `clientId` tiebreaker). Updates re-encrypt in place under the same envelope id
   with `sequence`+1 (a mutable-head model); deletes are soft-delete tombstones.
 - **Status.** `useSyncStatus()` rolls the per-collection replication states up
   to an aggregate: `offline` (no replication running / local-only), or
@@ -419,7 +419,7 @@ cost.
 | ------------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------ |
 | `@interop/was-react`     | Core: config, identity, auth, sync, storage, session store, React provider and hooks | `react`, `zustand`, `rxdb`                             |
 | `@interop/was-react/mui` | Optional `ProtectedRoute`, `ReconnectBanner`, `SyncStatusChip`                       | `@mui/material`, `@mui/icons-material`, `react-router` |
-| `@interop/was-react/dev` | Node-only `provisionDevGrants` + the `was-provision-dev-grants` CLI                  | (none; Node only)                                      |
+| `@interop/was-react/dev` | Node-only `provisionDevGrants`                                                       | (none; Node only)                                      |
 
 MUI usage:
 
@@ -463,19 +463,6 @@ The `./dev` entry provisions a Space, collections, and delegated read/write
 grants against a running was-teaching-server, so an app can dev-sync without a
 CHAPI wallet in the loop. It is Node-only (uses `node:fs`).
 
-CLI:
-
-```
-was-provision-dev-grants \
-  --server-url http://localhost:3002 \
-  --seed <hex-or-base64url 32-byte seed> \
-  --collections notes \
-  --space-name "Dev Space" \
-  --out ./public/dev-grants.local.json
-```
-
-Programmatic:
-
 ```ts
 import { provisionDevGrants } from '@interop/was-react/dev'
 

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export { loginWithWallet, requestGrants, LoginCancelledError, WalletUnsupportedE
 export type { WalletAPIMessage, IVPOffer, IVPRequest, IVPRDetails, IVPRQuery, IQueryByExample, IDIDAuthenticationQuery, IZcapQuery, IAppConnectQuery, IAppConnectCapabilityQuery, ICapabilityQueryDetail, WalletResponse, WalletRequestProfile, IVerifiableCredential, IVerifiablePresentation, IZcap } from './auth/walletRequestTypes.js';
 export * from './sync/index.js';
 export { LocalStore } from './storage/localStore.js';
-export { setLocalStore, requireStore, hasStore, clearLocalStore, setRemoteStore, requireRemoteStore, hasRemoteStore, clearRemoteStore, getDeviceId } from './storage/storageManager.js';
+export { setLocalStore, requireStore, hasStore, clearLocalStore, setRemoteStore, requireRemoteStore, hasRemoteStore, clearRemoteStore, getClientId } from './storage/storageManager.js';
 export { createEntityStore, type EntityStore } from './storage/entityStore.js';
 export { WasRemoteStore, type MarkerResult, type EqualityQueryPage } from './storage/wasRemoteStore.js';
 export { publicUrlFor } from './storage/publicUrl.js';

package/dist/index.js

@@ -32,7 +32,7 @@ export * from './sync/index.js';
 // stores, the delegated remote store, sync status, rehydrate mechanism, and the
 // replication controller.
 export { LocalStore } from './storage/localStore.js';
-export { setLocalStore, requireStore, hasStore, clearLocalStore, setRemoteStore, requireRemoteStore, hasRemoteStore, clearRemoteStore, getDeviceId } from './storage/storageManager.js';
+export { setLocalStore, requireStore, hasStore, clearLocalStore, setRemoteStore, requireRemoteStore, hasRemoteStore, clearRemoteStore, getClientId } from './storage/storageManager.js';
 export { createEntityStore } from './storage/entityStore.js';
 export { WasRemoteStore } from './storage/wasRemoteStore.js';
 export { publicUrlFor } from './storage/publicUrl.js';

package/dist/react/documentApp.d.ts

@@ -27,7 +27,7 @@ export interface DocumentApp<T extends object> {
     /**
      * The tier-1 document hook. Usable in any component below the provider.
      */
-    useDocument: () => {
+    useAppDocument: () => {
         /**
          * The document: `undefined` during boot, then the stored value or the
          * configured `initial` when nothing has been written yet.
@@ -87,7 +87,7 @@ export interface DocumentApp<T extends object> {
 /**
  * Builds the complete wiring for a one-document app: a `WasAppConfig` with a
  * single sandbox collection and local-first onboarding, the singleton-document
- * store registry, and the typed `useDocument` hook bound to both.
+ * store registry, and the typed `useAppDocument` hook bound to both.
  *
  * @param options {object}
  * @param options.appName {string}   human-readable name (consent reason lines)

package/dist/react/documentApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentApp.d.ts","sourceRoot":"","sources":["../../src/react/documentApp.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAG/D;;GAEG;AACH,eAAO,MAAM,uBAAuB,aAAa,CAAA;AAOjD;;GAEG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAavD;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM;IAC3C;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAA;IACpB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAA;IACvB;;OAEG;IACH,WAAW,EAAE,MAAM;QACjB;;;WAGG;QACH,GAAG,EAAE,CAAC,GAAG,SAAS,CAAA;QAClB;;;;;WAKG;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/D;;;WAGG;QACH,MAAM,EAAE,aAAa,CAAA;QACrB;;WAEG;QACH,IAAI,EAAE,UAAU,CAAA;QAChB;;WAEG;QACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/B;;;WAGG;QACH,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QACzC;;;;;;;WAOG;QACH,OAAO,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC,CAAA;QACpD;;;WAGG;QACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/B;;WAEG;QACH,UAAU,EAAE,OAAO,CAAA;QACnB;;WAEG;QACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACrB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,EAClD,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,IAAI,EACJ,MAAM,EACP,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,CAAA;IAC9C,UAAU,EAAE,oBAAoB,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB,GAAG,WAAW,CAAC,CAAC,CAAC,CAgIjB"}
+{"version":3,"file":"documentApp.d.ts","sourceRoot":"","sources":["../../src/react/documentApp.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAG/D;;GAEG;AACH,eAAO,MAAM,uBAAuB,aAAa,CAAA;AAOjD;;GAEG;AACH,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAavD;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM;IAC3C;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAA;IACpB;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAA;IACvB;;OAEG;IACH,cAAc,EAAE,MAAM;QACpB;;;WAGG;QACH,GAAG,EAAE,CAAC,GAAG,SAAS,CAAA;QAClB;;;;;WAKG;QACH,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/D;;;WAGG;QACH,MAAM,EAAE,aAAa,CAAA;QACrB;;WAEG;QACH,IAAI,EAAE,UAAU,CAAA;QAChB;;WAEG;QACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/B;;;WAGG;QACH,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QACzC;;;;;;;WAOG;QACH,OAAO,EAAE,MAAM,OAAO,CAAC;YAAE,QAAQ,EAAE,OAAO,CAAA;SAAE,GAAG,IAAI,CAAC,CAAA;QACpD;;;WAGG;QACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/B;;WAEG;QACH,UAAU,EAAE,OAAO,CAAA;QACnB;;WAEG;QACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACrB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,EAClD,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,IAAI,EACJ,MAAM,EACP,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAA;KAAE,CAAA;IAC9C,UAAU,EAAE,oBAAoB,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB,GAAG,WAAW,CAAC,CAAC,CAAC,CAgIjB"}

package/dist/react/documentApp.js

@@ -5,16 +5,16 @@
  * The tier-1 "one sandbox document" facade: `defineDocumentApp` builds the
  * whole was-react wiring (config, store registry, entity store) for an app
  * whose entire model is a single key-value document -- an Excalidraw-style
- * editor, a browser-game save file -- and returns a typed `useDocument` hook
+ * editor, a browser-game save file -- and returns a typed `useAppDocument` hook
  * over it. The app never sees `createEntityStore`, grants parsing, or sync
  * internals: it renders `doc`, calls `update`, and optionally offers file
  * export/import and a "Save to Web Spaces" connect button.
  *
  * The facade is a degenerate entity store: one collection (the app-named
  * sandbox collection) holding one logical document under a fixed id. The
- * stored row wraps the app's data (`{ id, updatedAt, deviceId, data }`) so app
+ * stored row wraps the app's data (`{ id, updatedAt, clientId, data }`) so app
  * fields can never collide with the LWW fields the sync layer requires, and
- * the facade stamps `updatedAt`/`deviceId` on every write itself. Hydration
+ * the facade stamps `updatedAt`/`clientId` on every write itself. Hydration
  * goes through `LocalStore.hydrateSingleton`, which LWW-reconciles the
  * duplicate envelope rows two devices can mint for the same logical document.
  *
@@ -29,7 +29,7 @@
  */
 import { useStore } from 'zustand';
 import { createEntityStore } from '../storage/entityStore.js';
-import { getDeviceId, requireStore } from '../storage/storageManager.js';
+import { getClientId, requireStore } from '../storage/storageManager.js';
 import { useAuthStore, useSession, useSyncStatus } from './hooks.js';
 /**
  * The localStore / RxDB collection key the facade's one collection uses.
@@ -46,7 +46,7 @@ export const DOCUMENT_EXPORT_FORMAT = 'was-document/v1';
 /**
  * Builds the complete wiring for a one-document app: a `WasAppConfig` with a
  * single sandbox collection and local-first onboarding, the singleton-document
- * store registry, and the typed `useDocument` hook bound to both.
+ * store registry, and the typed `useAppDocument` hook bound to both.
  *
  * @param options {object}
  * @param options.appName {string}   human-readable name (consent reason lines)
@@ -103,7 +103,7 @@ export function defineDocumentApp({ appName, appOrigin, mediatorBase, document,
         await docStore.getState().upsert({
             id: DOCUMENT_ID,
             updatedAt: new Date().toISOString(),
-            deviceId: getDeviceId({
+            clientId: getClientId({
                 ...(storageKeyPrefix !== undefined && { storageKeyPrefix })
             }),
             data
@@ -152,7 +152,7 @@ export function defineDocumentApp({ appName, appOrigin, mediatorBase, document,
         const imported = record.document;
         await update(() => imported);
     }
-    function useDocument() {
+    function useAppDocument() {
         const held = docStore(state => state.byId.get(DOCUMENT_ID));
         const { status, authenticating, error } = useSession();
         const { state: syncState } = useSyncStatus();
@@ -175,6 +175,6 @@ export function defineDocumentApp({ appName, appOrigin, mediatorBase, document,
             error
         };
     }
-    return { config, registry, useDocument };
+    return { config, registry, useAppDocument };
 }
 //# sourceMappingURL=documentApp.js.map

package/dist/react/documentApp.js.map

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

package/dist/storage/adopt.js

@@ -14,30 +14,30 @@
  *   the same last-write-wins rule replication runs ({@link remotePayloadWins});
  *   a connected doc without LWW fields always loses to a stamped adopted one.
  *
- * Adopted payloads missing `updatedAt`/`deviceId` are stamped at adoption time
+ * Adopted payloads missing `updatedAt`/`clientId` are stamped at adoption time
  * (the sync layer's conflict resolution requires them); payloads that already
  * carry them keep their original values, so a doc edited long ago does not
  * suddenly outrank fresher remote edits.
  */
 import { uuidv7 } from 'uuidv7';
 import { lwwFields, remotePayloadWins } from '../sync/lww.js';
-import { getDeviceId } from './storageManager.js';
+import { getClientId } from './storageManager.js';
 /**
  * The one-per-merge stamp applied to payloads missing their LWW fields.
  *
- * @returns {{ updatedAt: string, deviceId: string }}
+ * @returns {{ updatedAt: string, clientId: string }}
  */
 function adoptionStamp() {
-    let deviceId;
+    let clientId;
     try {
-        deviceId = getDeviceId();
+        clientId = getClientId();
     }
     catch {
         // No localStorage (non-browser environments): an unpersisted id still
         // gives the LWW tiebreak a deterministic value for this merge.
-        deviceId = uuidv7();
+        clientId = uuidv7();
     }
-    return { updatedAt: new Date().toISOString(), deviceId };
+    return { updatedAt: new Date().toISOString(), clientId };
 }
 /**
  * Merges the collected anonymous-replica payloads into `store` (the already

package/dist/storage/entityStore.d.ts

@@ -60,7 +60,7 @@ export interface EntityStore<T extends {
      * stream owns the persisted row already). Used for per-doc reactive patching
      * of pulled/conflict-resolved remote changes; coalesced into one store update
      * per pull burst (see the reactivity note above). When both the incoming and
-     * the held doc carry the LWW fields (`updatedAt` + `deviceId`), a stale
+     * the held doc carry the LWW fields (`updatedAt` + `clientId`), a stale
      * incoming doc is discarded rather than clobbering the newer held one.
      */
     patch: (doc: T) => void;

package/dist/storage/localStore.d.ts

@@ -152,7 +152,7 @@ export declare class LocalStore {
      * created the singleton before syncing produce distinct envelope rows that all
      * decrypt to the same logical id; because LWW conflict resolution is
      * per-envelope-id, those duplicates never reconcile on their own. This keeps
-     * the last-writer-wins winner (payload `updatedAt`, `deviceId` tiebreak) and
+     * the last-writer-wins winner (payload `updatedAt`, `clientId` tiebreak) and
      * tombstones the losers so the deletion replicates and the space converges on
      * one row. Returns the winning payload, or `null` when the collection is empty.
      *
@@ -162,7 +162,7 @@ export declare class LocalStore {
     hydrateSingleton<T extends {
         id: string;
         updatedAt: string;
-        deviceId: string;
+        clientId: string;
     }>(key: string): Promise<T | null>;
     /**
      * Decrypts a single EDV envelope into its plaintext payload, for per-doc

package/dist/storage/localStore.js

@@ -111,7 +111,7 @@ export class LocalStore {
         // Each collection gets an LWW conflict handler bound to its own cipher, so
         // a 412 push conflict (concurrent multi-device edit of the same mutable
         // head) is settled by decrypting both sides and comparing payload
-        // `updatedAt` (deviceId tiebreak) rather than RxDB's default master-wins.
+        // `updatedAt` (clientId tiebreak) rather than RxDB's default master-wins.
         // On a public collection the codec is pass-through, so the handler reads
         // those fields directly off the plaintext payload.
         const collectionsConfig = Object.fromEntries(collections.map(({ key }) => {
@@ -351,7 +351,7 @@ export class LocalStore {
      * created the singleton before syncing produce distinct envelope rows that all
      * decrypt to the same logical id; because LWW conflict resolution is
      * per-envelope-id, those duplicates never reconcile on their own. This keeps
-     * the last-writer-wins winner (payload `updatedAt`, `deviceId` tiebreak) and
+     * the last-writer-wins winner (payload `updatedAt`, `clientId` tiebreak) and
      * tombstones the losers so the deletion replicates and the space converges on
      * one row. Returns the winning payload, or `null` when the collection is empty.
      *

package/dist/storage/storageManager.d.ts

@@ -53,15 +53,15 @@ export declare function hasRemoteStore(): boolean;
  */
 export declare function clearRemoteStore(): void;
 /**
- * A stable per-install device id (the last-write-wins tiebreak stamped into
- * every payload), persisted in localStorage under `<prefix>deviceId`.
+ * A stable per-install client id (the last-write-wins tiebreak stamped into
+ * every payload), persisted in localStorage under `<prefix>clientId`.
  *
  * @param [options] {object}
  * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
  *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
  * @returns {string}
  */
-export declare function getDeviceId({ storageKeyPrefix }?: {
+export declare function getClientId({ storageKeyPrefix }?: {
     storageKeyPrefix?: string;
 }): string;
 //# sourceMappingURL=storageManager.d.ts.map

package/dist/storage/storageManager.js

@@ -3,7 +3,7 @@
  */
 /**
  * The storage manager: a thin process-wide holder for the one {@link LocalStore}
- * instance, the per-session {@link WasRemoteStore}, plus the per-install device
+ * instance, the per-session {@link WasRemoteStore}, plus the per-install client
  * id. Entity stores reach for the stores through {@link requireStore} /
  * {@link requireRemoteStore} inside their verbs rather than importing them
  * directly, which keeps this module free of store imports (no cycle) and lets
@@ -88,20 +88,20 @@ export function clearRemoteStore() {
     remoteStore = null;
 }
 /**
- * A stable per-install device id (the last-write-wins tiebreak stamped into
- * every payload), persisted in localStorage under `<prefix>deviceId`.
+ * A stable per-install client id (the last-write-wins tiebreak stamped into
+ * every payload), persisted in localStorage under `<prefix>clientId`.
  *
  * @param [options] {object}
  * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
  *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
  * @returns {string}
  */
-export function getDeviceId({ storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX } = {}) {
-    const deviceIdKey = `${storageKeyPrefix}deviceId`;
-    let id = localStorage.getItem(deviceIdKey);
+export function getClientId({ storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX } = {}) {
+    const clientIdKey = `${storageKeyPrefix}clientId`;
+    let id = localStorage.getItem(clientIdKey);
     if (!id) {
         id = uuidv7();
-        localStorage.setItem(deviceIdKey, id);
+        localStorage.setItem(clientIdKey, id);
     }
     return id;
 }

package/dist/sync/lww.d.ts

@@ -7,35 +7,35 @@
  * two payloads and converge on the same winner with no coordination.
  *
  * `updatedAt` (an ISO-8601 string, so lexical compare == chronological compare)
- * decides; `deviceId` breaks an exact tie deterministically. Both fields live in
+ * decides; `clientId` breaks an exact tie deterministically. Both fields live in
  * the payload (never the envelope-level checkpoint `updatedAt`).
  */
 /**
  * Whether the remote payload wins over the local one under last-write-wins.
  * Later `updatedAt` wins; on an exact `updatedAt` tie the lexically greater
- * `deviceId` wins (an arbitrary but deterministic, replica-independent choice).
+ * `clientId` wins (an arbitrary but deterministic, replica-independent choice).
  *
- * @param remote {{ updatedAt: string; deviceId: string }}
- * @param local {{ updatedAt: string; deviceId: string }}
+ * @param remote {{ updatedAt: string; clientId: string }}
+ * @param local {{ updatedAt: string; clientId: string }}
  * @returns {boolean}   true if the remote payload should replace the local one
  */
 export declare function remotePayloadWins(remote: {
     updatedAt: string;
-    deviceId: string;
+    clientId: string;
 }, local: {
     updatedAt: string;
-    deviceId: string;
+    clientId: string;
 }): boolean;
 /**
  * Reads the LWW fields off a doc when it carries them. Storage payloads are
- * generic over `{ id: string }`, so docs without `updatedAt`/`deviceId` are
+ * generic over `{ id: string }`, so docs without `updatedAt`/`clientId` are
  * legal; callers fall back to their own rule for those.
  *
  * @param doc {unknown}
- * @returns {{ updatedAt: string, deviceId: string } | null}
+ * @returns {{ updatedAt: string, clientId: string } | null}
  */
 export declare function lwwFields(doc: unknown): {
     updatedAt: string;
-    deviceId: string;
+    clientId: string;
 } | null;
 //# sourceMappingURL=lww.d.ts.map

package/dist/sync/lww.js

@@ -7,36 +7,36 @@
  * two payloads and converge on the same winner with no coordination.
  *
  * `updatedAt` (an ISO-8601 string, so lexical compare == chronological compare)
- * decides; `deviceId` breaks an exact tie deterministically. Both fields live in
+ * decides; `clientId` breaks an exact tie deterministically. Both fields live in
  * the payload (never the envelope-level checkpoint `updatedAt`).
  */
 /**
  * Whether the remote payload wins over the local one under last-write-wins.
  * Later `updatedAt` wins; on an exact `updatedAt` tie the lexically greater
- * `deviceId` wins (an arbitrary but deterministic, replica-independent choice).
+ * `clientId` wins (an arbitrary but deterministic, replica-independent choice).
  *
- * @param remote {{ updatedAt: string; deviceId: string }}
- * @param local {{ updatedAt: string; deviceId: string }}
+ * @param remote {{ updatedAt: string; clientId: string }}
+ * @param local {{ updatedAt: string; clientId: string }}
  * @returns {boolean}   true if the remote payload should replace the local one
  */
 export function remotePayloadWins(remote, local) {
     if (remote.updatedAt !== local.updatedAt) {
         return remote.updatedAt > local.updatedAt;
     }
-    return remote.deviceId > local.deviceId;
+    return remote.clientId > local.clientId;
 }
 /**
  * Reads the LWW fields off a doc when it carries them. Storage payloads are
- * generic over `{ id: string }`, so docs without `updatedAt`/`deviceId` are
+ * generic over `{ id: string }`, so docs without `updatedAt`/`clientId` are
  * legal; callers fall back to their own rule for those.
  *
  * @param doc {unknown}
- * @returns {{ updatedAt: string, deviceId: string } | null}
+ * @returns {{ updatedAt: string, clientId: string } | null}
  */
 export function lwwFields(doc) {
-    const { updatedAt, deviceId } = doc;
-    return typeof updatedAt === 'string' && typeof deviceId === 'string'
-        ? { updatedAt, deviceId }
+    const { updatedAt, clientId } = doc;
+    return typeof updatedAt === 'string' && typeof clientId === 'string'
+        ? { updatedAt, clientId }
         : null;
 }
 //# sourceMappingURL=lww.js.map

package/dist/sync/lwwConflictHandler.d.ts

@@ -7,17 +7,17 @@
  * correct for content-addressed (immutable-per-id) collections but wrong here:
  * every entity is a mutable head that two devices can edit concurrently, so a
  * genuine content conflict must be settled by last-write-wins on the payload's
- * own `updatedAt` (deviceId tiebreak) -- exactly the rule two offline replicas
+ * own `updatedAt` (clientId tiebreak) -- exactly the rule two offline replicas
  * apply independently to converge.
  *
  * The wrinkle is that the conflicting bodies are EDV envelopes (ciphertext), so
  * `resolve` must decrypt both sides through this collection's cipher before it
- * can compare the plaintext `updatedAt` / `deviceId`. `isEqual` stays cheap and
+ * can compare the plaintext `updatedAt` / `clientId`. `isEqual` stays cheap and
  * synchronous (a structural compare of the opaque bodies), as RxDB requires.
  *
  * Convergence: the server holds ONE winner of the push race as `realMasterState`;
  * every replica compares that same master against its own local edit, and the
- * `payloadWins` comparator is a total order over `(updatedAt, deviceId)`, so the
+ * `payloadWins` comparator is a total order over `(updatedAt, clientId)`, so the
  * globally-latest payload wins on every replica with no coordination.
  *
  * The resolution rules, in order:
@@ -57,7 +57,7 @@ import type { Json, SyncedDoc } from './types.js';
  */
 interface LwwPayload {
     updatedAt: string;
-    deviceId: string;
+    clientId: string;
 }
 /**
  * Builds an RxDB conflict handler that settles content conflicts by payload LWW,
@@ -67,7 +67,7 @@ interface LwwPayload {
  * @param [payloadWins] {(remote: LwwPayload, local: LwwPayload) => boolean}
  *   the total-order comparator deciding whether the remote payload replaces the
  *   local one; defaults to {@link remotePayloadWins} (later `updatedAt` wins,
- *   `deviceId` breaks a tie)
+ *   `clientId` breaks a tie)
  * @returns {import('rxdb/plugins/core').RxConflictHandler<SyncedDoc>}
  */
 export declare function makeLwwConflictHandler(decrypt: (envelope: Json) => Promise<Json>, payloadWins?: (remote: LwwPayload, local: LwwPayload) => boolean): {

package/dist/sync/lwwConflictHandler.js

@@ -6,7 +6,7 @@ function bodiesEqual(a, b) {
     return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
 }
 /**
- * Decrypts one side's envelope into its `{ updatedAt, deviceId }`, or `null`
+ * Decrypts one side's envelope into its `{ updatedAt, clientId }`, or `null`
  * when the side has no decryptable payload (a tombstone, or an absent/corrupt
  * body). `null` means "no comparable timestamp", handled by the caller.
  */
@@ -17,8 +17,8 @@ async function lwwFieldsOf(doc, decrypt) {
     try {
         const payload = (await decrypt(doc.data));
         if (typeof payload.updatedAt === 'string' &&
-            typeof payload.deviceId === 'string') {
-            return { updatedAt: payload.updatedAt, deviceId: payload.deviceId };
+            typeof payload.clientId === 'string') {
+            return { updatedAt: payload.updatedAt, clientId: payload.clientId };
         }
         return null;
     }
@@ -34,7 +34,7 @@ async function lwwFieldsOf(doc, decrypt) {
  * @param [payloadWins] {(remote: LwwPayload, local: LwwPayload) => boolean}
  *   the total-order comparator deciding whether the remote payload replaces the
  *   local one; defaults to {@link remotePayloadWins} (later `updatedAt` wins,
- *   `deviceId` breaks a tie)
+ *   `clientId` breaks a tie)
  * @returns {import('rxdb/plugins/core').RxConflictHandler<SyncedDoc>}
  */
 export function makeLwwConflictHandler(decrypt, payloadWins = remotePayloadWins) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interop/was-react",
   "description": "React library for building 'Bring Your Own Everything' (BYOE) apps on Wallet Attached Storage: DID Auth login via CHAPI wallet, local-first encrypted storage, and background sync to a WAS server.",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "scripts": {
     "build": "pnpm run clear && tsc",
@@ -18,9 +18,6 @@
     "test:node": "vitest run",
     "test:coverage": "vitest run --coverage"
   },
-  "bin": {
-    "was-provision-dev-grants": "./dist/dev/cli.js"
-  },
   "files": [
     "dist",
     "README.md",

package/dist/dev/cli.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * Decodes a seed string as hex (all hex chars, even length) or base64url.
- *
- * @param input {string}
- * @returns {Uint8Array}
- */
-export declare function parseSeed(input: string): Uint8Array;
-/**
- * Splits a comma-separated collection-ids string into a trimmed, non-empty list.
- *
- * @param input {string}
- * @returns {string[]}
- */
-export declare function parseCollections(input: string): string[];
-//# sourceMappingURL=cli.d.ts.map

package/dist/dev/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/dev/cli.ts"],"names":[],"mappings":";AAqCA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOnD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD"}

package/dist/dev/cli.js

@@ -1,119 +0,0 @@
-#!/usr/bin/env node
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * CLI wrapper around `provisionDevGrants`. Creates a dev Space + collections on a
- * running was-teaching-server and delegates per-collection RW zcaps to the app
- * DID derived from `--seed`, optionally writing the grants JSON to `--out`.
- *
- * Usage:
- *   was-provision-dev-grants \
- *     --server-url http://localhost:3002 \
- *     --seed <hex-or-base64url 32-byte seed> \
- *     --collections action-items,projects,goals \
- *     [--space-name "Dev Space"] [--out ./public/dev-grants.local.json] [--probe]
- */
-import { parseArgs } from 'node:util';
-import { argv } from 'node:process';
-import { pathToFileURL } from 'node:url';
-import { base64urlnopad, hex } from '@scure/base';
-import { provisionDevGrants } from './provisionDevGrants.js';
-const USAGE = `Usage: was-provision-dev-grants [options]
-
-Required:
-  --server-url <url>       base URL of a running was-teaching-server
-  --seed <string>          the app master seed, hex or base64url encoded
-  --collections <ids>      comma-separated WAS collection ids
-
-Optional:
-  --space-name <name>      Space name (default "Dev Space")
-  --out <path>             write the { grants } JSON to this file
-  --probe                  probe whether the delegated RW zcap authorizes the
-                           encryption-marker PUT
-  --help                   show this message
-`;
-/**
- * Decodes a seed string as hex (all hex chars, even length) or base64url.
- *
- * @param input {string}
- * @returns {Uint8Array}
- */
-export function parseSeed(input) {
-    const value = input.trim();
-    if (/^[0-9a-fA-F]+$/.test(value) && value.length % 2 === 0) {
-        // hex.decode requires lowercase, even-length input.
-        return hex.decode(value.toLowerCase());
-    }
-    return base64urlnopad.decode(value);
-}
-/**
- * Splits a comma-separated collection-ids string into a trimmed, non-empty list.
- *
- * @param input {string}
- * @returns {string[]}
- */
-export function parseCollections(input) {
-    return input
-        .split(',')
-        .map(id => id.trim())
-        .filter(id => id.length > 0);
-}
-async function main() {
-    const { values } = parseArgs({
-        options: {
-            'server-url': { type: 'string' },
-            seed: { type: 'string' },
-            collections: { type: 'string' },
-            'space-name': { type: 'string' },
-            out: { type: 'string' },
-            probe: { type: 'boolean', default: false },
-            help: { type: 'boolean', default: false }
-        }
-    });
-    if (values.help) {
-        console.log(USAGE);
-        return;
-    }
-    const serverUrl = values['server-url'];
-    const seedInput = values.seed;
-    const collectionsInput = values.collections;
-    const missing = [];
-    if (!serverUrl) {
-        missing.push('--server-url');
-    }
-    if (!seedInput) {
-        missing.push('--seed');
-    }
-    if (!collectionsInput) {
-        missing.push('--collections');
-    }
-    if (missing.length > 0) {
-        console.error(`Missing required argument(s): ${missing.join(', ')}\n`);
-        console.error(USAGE);
-        process.exit(1);
-    }
-    const collections = parseCollections(collectionsInput);
-    if (collections.length === 0) {
-        console.error('--collections must list at least one collection id.\n');
-        console.error(USAGE);
-        process.exit(1);
-    }
-    await provisionDevGrants({
-        serverUrl: serverUrl,
-        seed: parseSeed(seedInput),
-        collections,
-        spaceName: values['space-name'],
-        outFile: values.out,
-        probe: values.probe,
-        log: console.log
-    });
-}
-// Run only when invoked as a script, not when imported (e.g. by tests).
-if (argv[1] !== undefined && import.meta.url === pathToFileURL(argv[1]).href) {
-    main().catch(err => {
-        console.error('Provisioning failed:', err);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=cli.js.map

package/dist/dev/cli.js.map

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