@bunbase-ae/js 1.3.1-next.58.55becc8 → 1.3.1-next.60.a69db4b

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "1.3.1-next.58.55becc8",
+  "version": "1.3.1-next.60.a69db4b",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/client.ts

@@ -12,6 +12,7 @@ import { AuthClient } from "./auth";
 import { CollectionClient } from "./collection";
 import { HttpClient } from "./http";
 import { RealtimeClient } from "./realtime";
+import { SequenceClient } from "./sequence";
 import { StorageClient } from "./storage";
 import type { BunBaseClientOptions, TransactionOperation, TransactionResult } from "./types";
 
@@ -63,6 +64,13 @@ export class BunBaseClient {
     return new CollectionClient<T>(this.http, name);
   }
 
+  // Returns a sequence client for the given sequence name.
+  // Sequence names may contain letters, digits, colons, hyphens, underscores,
+  // and dots — e.g. "invoices:tenant-123:2026".
+  sequence(name: string): SequenceClient {
+    return new SequenceClient(this.http, name);
+  }
+
   // Execute up to 50 create/update/delete operations across multiple collections
   // atomically. All operations succeed or all are rolled back.
   async batch<T = Record<string, unknown>>(

package/src/index.ts

@@ -38,6 +38,7 @@ export { AuthClient, type AuthSnapshot } from "./auth";
 export { BunBaseClient } from "./client";
 export { CollectionClient } from "./collection";
 export { RealtimeClient, type SubscribeOptions } from "./realtime";
+export { SequenceClient } from "./sequence";
 export { type SignedUploadResult, StorageClient, type UploadOptions } from "./storage";
 export {
   type AggregateFunction,

package/src/sequence.ts

@@ -0,0 +1,35 @@
+// SequenceClient — atomic gap-free sequential number generation.
+//
+// Usage:
+//   const seq = client.sequence("invoices:tenant-123:2026");
+//   const next = await seq.next();   // → 1, 2, 3, ... atomic, no gaps
+//   const peek = await seq.peek();   // → current value, no increment
+
+import type { HttpClient } from "./http";
+
+export class SequenceClient {
+  constructor(
+    private readonly http: HttpClient,
+    private readonly name: string,
+  ) {}
+
+  // Atomically increment the sequence and return the new value.
+  // Concurrent calls are serialized at the database level — each caller
+  // gets a unique monotonically-increasing value with no gaps.
+  async next(): Promise<number> {
+    const result = await this.http.request<{ value: number }>(
+      "POST",
+      `/api/v1/sequences/${encodeURIComponent(this.name)}/next`,
+    );
+    return result.value;
+  }
+
+  // Return the current sequence value without incrementing.
+  async peek(): Promise<number> {
+    const result = await this.http.request<{ value: number }>(
+      "GET",
+      `/api/v1/sequences/${encodeURIComponent(this.name)}/peek`,
+    );
+    return result.value;
+  }
+}