@drakkar.software/starfish-client 3.0.0-alpha.0 → 3.0.0-alpha.2

package/dist/index.js

@@ -82,7 +82,7 @@ var StarfishClient = class {
    */
   async buildAuthHeaders(method, pathAndQuery, body) {
     if (this.capProvider) {
-      const { cap, devEdPrivHex } = await this.capProvider.getCap();
+      const { cap, devEdPrivHex, pubHex } = await this.capProvider.getCap();
       const req = {
         method,
         pathAndQuery,
@@ -90,12 +90,14 @@ var StarfishClient = class {
         host: this.signingHost()
       };
       const { sig, ts, nonce } = await signRequest(req, devEdPrivHex);
-      return {
+      const headers = {
         Authorization: `Cap ${encodeCapAuth(cap)}`,
         "X-Starfish-Sig": sig,
         "X-Starfish-Ts": String(ts),
         "X-Starfish-Nonce": nonce
       };
+      if (pubHex !== void 0) headers["X-Starfish-Pub"] = pubHex;
+      return headers;
     }
     return {};
   }
@@ -177,6 +179,42 @@ var StarfishClient = class {
     }
     return res.json();
   }
+  /**
+   * Append an element to an appendOnly (`by_timestamp`) collection.
+   *
+   * Unlike {@link push}, appendOnly writes carry no hash/conflict check — an
+   * authorized append is always accepted. Each element is stored server-side as
+   * `{ts, data}` and pulls can filter by `ts` via `since`/`checkpoint`.
+   *
+   * @param path - the push endpoint (e.g. "/push/events")
+   * @param data - the element payload. For a `delegated` collection, encrypt it
+   *   first (e.g. `createKeyringEncryptor(keyring, kem).encrypt(data)`); the
+   *   server stores it opaquely and never reads it.
+   * @param opts.ts - optional client-supplied element timestamp (ms). Must be a
+   *   non-negative integer strictly greater than the latest stored element's ts
+   *   (else the server responds 409). Omit to let the server assign one.
+   * @throws {StarfishHttpError} on a non-2xx response (e.g. 409 for a
+   *   non-monotonic timestamp).
+   */
+  async append(path, data, opts = {}) {
+    const bodyObj = { data };
+    if (opts.ts !== void 0) bodyObj["ts"] = opts.ts;
+    const body = JSON.stringify(bodyObj);
+    const authHeaders = await this.buildAuthHeaders("POST", path, body);
+    const res = await this.fetch(`${this.baseUrl}${path}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...authHeaders
+      },
+      body
+    });
+    if (!res.ok) {
+      throw new StarfishHttpError(res.status, await res.text());
+    }
+    return res.json();
+  }
   /**
    * Pull binary data from a blob collection.
    * Returns raw bytes with the content hash from the ETag header.