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

package/dist/index.js

@@ -179,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.