@bunbase-ae/js 3.4.3-next.433.7846066 → 3.4.3-next.437.94850c5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "3.4.3-next.433.7846066",
+  "version": "3.4.3-next.437.94850c5",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/collection.ts

@@ -65,9 +65,23 @@ export class CollectionClient<T extends Record<string, unknown> = Record<string,
     });
   }
 
-  async update(id: string, patch: Partial<T>): Promise<T & BunBaseRecord> {
+  /**
+   * Update a record. Pass `{ expectedVersion }` for an optimistic-lock
+   * (compare-and-set) update: the write is sent with an `If-Match` header and
+   * the server rejects it with a `412` {@link BunBaseError} if the record's
+   * `_version` has moved since you read it. On success the returned record
+   * carries the new `_version`.
+   */
+  async update(
+    id: string,
+    patch: Partial<T>,
+    options: { expectedVersion?: number } = {},
+  ): Promise<T & BunBaseRecord> {
     return this.http.request<T & BunBaseRecord>("PATCH", `/api/v1/${this.name}/${id}`, {
       body: patch,
+      ...(options.expectedVersion !== undefined
+        ? { headers: { "If-Match": String(options.expectedVersion) } }
+        : {}),
     });
   }
 

package/src/http.ts

@@ -110,6 +110,7 @@ export class HttpClient {
       skipAuth?: boolean;
       signal?: AbortSignal;
       keepalive?: boolean;
+      headers?: Record<string, string>;
     } = {},
   ): Promise<T> {
     const res = await this.performWithRefresh(method, path, options);
@@ -138,6 +139,7 @@ export class HttpClient {
       skipAuth?: boolean;
       signal?: AbortSignal;
       keepalive?: boolean;
+      headers?: Record<string, string>;
     },
   ): Promise<Response> {
     const res = await this.send(method, path, options);
@@ -174,6 +176,7 @@ export class HttpClient {
       skipAuth?: boolean;
       signal?: AbortSignal;
       keepalive?: boolean;
+      headers?: Record<string, string>;
     },
   ): Promise<Response> {
     let url = `${this.baseUrl}${path}`;
@@ -202,6 +205,10 @@ export class HttpClient {
       body = JSON.stringify(options.body);
     }
 
+    // Caller-supplied headers (e.g. If-Match for optimistic-lock updates) are
+    // merged last so they can't be clobbered by the defaults above.
+    if (options.headers) Object.assign(headers, options.headers);
+
     return fetch(url, {
       method,
       headers,