@drakkar.software/starfish-client 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/history.js

@@ -0,0 +1,61 @@
+export class SnapshotHistory {
+    snapshots = [];
+    maxSnapshots;
+    storageKey;
+    constructor(options) {
+        this.maxSnapshots = options?.maxSnapshots ?? 20;
+        this.storageKey = options?.storageKey;
+        if (this.storageKey) {
+            try {
+                const raw = localStorage.getItem(this.storageKey);
+                if (raw) {
+                    const parsed = JSON.parse(raw);
+                    if (Array.isArray(parsed))
+                        this.snapshots = parsed;
+                }
+            }
+            catch { /* corrupted or unavailable — start fresh */ }
+        }
+    }
+    /** Take a labeled snapshot of the given data. */
+    take(label, data) {
+        this.snapshots.push({
+            timestamp: Date.now(),
+            label,
+            data: JSON.stringify(data),
+        });
+        if (this.snapshots.length > this.maxSnapshots) {
+            this.snapshots = this.snapshots.slice(-this.maxSnapshots);
+        }
+        this.persist();
+    }
+    /** Restore data from a snapshot at the given index. Returns undefined if index is invalid or data is corrupt. */
+    restore(index) {
+        const snapshot = this.snapshots[index];
+        if (!snapshot)
+            return undefined;
+        try {
+            return JSON.parse(snapshot.data);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** List available snapshots (metadata only, no data payload). */
+    list() {
+        return this.snapshots.map(({ timestamp, label }) => ({ timestamp, label }));
+    }
+    /** Clear all snapshots. */
+    clear() {
+        this.snapshots = [];
+        this.persist();
+    }
+    persist() {
+        if (!this.storageKey)
+            return;
+        try {
+            localStorage.setItem(this.storageKey, JSON.stringify(this.snapshots));
+        }
+        catch { /* quota exceeded — skip silently */ }
+    }
+}

package/dist/index.js

@@ -15,11 +15,9 @@ import {
   HEADER_SIG,
   HEADER_TS,
   HEADER_NONCE,
-  HEADER_ALG,
   HEADER_PUB,
   HEADER_CONTENT_TYPE,
   HEADER_ACCEPT,
-  DEFAULT_ALG,
   signAppendAuthor,
   signRequest,
   stableStringify
@@ -129,23 +127,19 @@ var StarfishClient = class {
    * presenter` bind the server checks.
    */
   async capRequestHeaders(capCtx, method, pathAndQuery, body) {
-    const { cap, devEdPrivHex, pubHex, presenterAlg } = capCtx;
+    const { cap, devEdPrivHex, pubHex } = capCtx;
     const req = {
       method,
       pathAndQuery,
       body,
       host: this.signingHost()
     };
-    const signAlg = cap.kind === "audience" ? presenterAlg ?? DEFAULT_ALG : cap.subAlg ?? cap.issAlg;
-    const { alg, sig, ts, nonce } = await signRequest(req, devEdPrivHex, {
-      alg: signAlg
-    });
+    const { sig, ts, nonce } = await signRequest(req, devEdPrivHex);
     const headers = {
       [HEADER_AUTHORIZATION]: `Cap ${encodeCapAuth(cap)}`,
       [HEADER_SIG]: sig,
       [HEADER_TS]: String(ts),
-      [HEADER_NONCE]: nonce,
-      [HEADER_ALG]: alg
+      [HEADER_NONCE]: nonce
     };
     if (pubHex !== void 0) headers[HEADER_PUB] = pubHex;
     return headers;
@@ -159,11 +153,10 @@ var StarfishClient = class {
    * unsigned and a server requiring signatures rejects it.
    */
   appendAuthorKey(capCtx) {
-    const { cap, pubHex, presenterAlg } = capCtx;
+    const { cap, pubHex } = capCtx;
     const authorPubHex = pubHex ?? cap.sub;
     if (authorPubHex === void 0) return null;
-    const signAlg = cap.kind === "audience" ? presenterAlg ?? DEFAULT_ALG : cap.subAlg ?? cap.issAlg;
-    return { authorPubHex, signAlg };
+    return { authorPubHex };
   }
   async pull(path, checkpointOrOptions) {
     let pathAndQuery = this.applyNamespace(path);
@@ -211,12 +204,16 @@ var StarfishClient = class {
     return result;
   }
   /**
-   * Pull several collections in one round-trip via `/batch/pull`. `collections`
-   * is the list of collection names; `opts.params` supplies path params per
-   * collection (serialized to a URL-encoded JSON `params` query). The server
-   * auto-fills the `{identity}` param from the authenticated caller, so per-user
-   * collections need no params. Returns a map of collection name → its pulled
-   * document or a per-collection `{ error }`. Honors the configured namespace.
+   * Pull several documents in one round-trip via `/batch/pull`. `collections` is
+   * the list of distinct collection names; `opts.params` supplies, per collection,
+   * an ARRAY of path-param sets — one per document to read — so the SAME collection
+   * can fan in many documents (e.g. many users' `profile`) in a single request.
+   * The server auto-fills the `{identity}` param from the authenticated caller for
+   * any set that omits it, so a self-doc collection needs no params. Returns a map
+   * of collection name → an ARRAY of pulled documents (or per-document `{ error }`),
+   * in request order. Honors the configured namespace.
+   *
+   * For the common "many docs of one collection" case prefer {@link batchPullMany}.
    *
    * Note: not append/checkpoint-aware — for incremental append-only reads use
    * `pull(path, { since })` (or `AppendLogCursor`) per collection.
@@ -239,6 +236,18 @@ var StarfishClient = class {
     }
     return await res.json();
   }
+  /**
+   * Convenience over {@link batchPull} for reading MANY documents of ONE
+   * collection in a single round-trip: pass the per-document param-sets and get
+   * back the {@link BatchPullEntry} array aligned to `paramsList` by index (each
+   * entry is `{ data, hash, timestamp }` or `{ error }`). An empty `paramsList`
+   * issues no request and returns `[]`.
+   */
+  async batchPullMany(collection, paramsList) {
+    if (paramsList.length === 0) return [];
+    const res = await this.batchPull([collection], { params: { [collection]: paramsList } });
+    return res.collections[collection] ?? [];
+  }
   /**
    * Push synced data to the server.
    * @param path - The push endpoint path (e.g. "/push/users/abc/settings")
@@ -310,8 +319,7 @@ var StarfishClient = class {
           documentKey,
           data,
           authorKey.authorPubHex,
-          capCtx.devEdPrivHex,
-          authorKey.signAlg
+          capCtx.devEdPrivHex
         );
         bodyObj[AUTHOR_PUBKEY_FIELD] = authorPubkey;
         bodyObj[AUTHOR_SIGNATURE_FIELD] = authorSignature;
@@ -555,7 +563,6 @@ var SyncManager = class {
 
 // src/append-log.ts
 import {
-  DEFAULT_ALG as DEFAULT_ALG2,
   verifyAppendAuthor
 } from "@drakkar.software/starfish-protocol";
 var PULL_PATH_PREFIX = "/pull/";
@@ -702,12 +709,12 @@ var AppendLogCursor = class {
     if (policy.expectedAuthorPubkey && authorPubkey.toLowerCase() !== policy.expectedAuthorPubkey.toLowerCase()) {
       throw new AppendAuthorError(el.ts);
     }
+    void policy;
     const ok = verifyAppendAuthor(
       this.documentKey,
       el.data,
       authorPubkey,
-      authorSignature,
-      policy.alg ?? DEFAULT_ALG2
+      authorSignature
     );
     if (!ok) throw new AppendAuthorError(el.ts);
   }