@bunbase-ae/js 1.3.1-next.55.d32b998 → 1.3.1-next.57.ddb6045

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunbase-ae/js",
-  "version": "1.3.1-next.55.d32b998",
+  "version": "1.3.1-next.57.ddb6045",
   "type": "module",
   "description": "TypeScript/JavaScript SDK for BunBase",
   "license": "UNLICENSED",

package/src/client.ts

@@ -13,7 +13,7 @@ import { CollectionClient } from "./collection";
 import { HttpClient } from "./http";
 import { RealtimeClient } from "./realtime";
 import { StorageClient } from "./storage";
-import type { BunBaseClientOptions } from "./types";
+import type { BunBaseClientOptions, TransactionOperation, TransactionResult } from "./types";
 
 export class BunBaseClient {
   readonly auth: AuthClient;
@@ -62,4 +62,17 @@ export class BunBaseClient {
   ): CollectionClient<T> {
     return new CollectionClient<T>(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>>(
+    operations: TransactionOperation<T>[],
+  ): Promise<TransactionResult<T>[]> {
+    const result = await this.http.request<{ results: TransactionResult<T>[] }>(
+      "POST",
+      "/api/v1/transactions/execute",
+      { body: { operations } },
+    );
+    return result.results;
+  }
 }

package/src/index.ts

@@ -77,6 +77,14 @@ export {
   type StorageAdapter,
   type TotpChallenge,
   type TotpSetup,
+  type TransactionCreate,
+  type TransactionDelete,
+  type TransactionOperation,
+  type TransactionResult,
+  type TransactionResultCreate,
+  type TransactionResultDelete,
+  type TransactionResultUpdate,
+  type TransactionUpdate,
   type UnsubscribeFn,
   type WithExpand,
 } from "./types";

package/src/types.ts

@@ -239,6 +239,55 @@ export type BatchResult<T = Record<string, unknown>> =
   | BatchResultUpdate<T>
   | BatchResultDelete;
 
+// ─── Transaction operations (cross-collection) ────────────────────────────────
+
+export interface TransactionCreate<T = Record<string, unknown>> {
+  collection: string;
+  op: "create";
+  data: T;
+}
+
+export interface TransactionUpdate<T = Record<string, unknown>> {
+  collection: string;
+  op: "update";
+  id: string;
+  data: Partial<T>;
+}
+
+export interface TransactionDelete {
+  collection: string;
+  op: "delete";
+  id: string;
+}
+
+export type TransactionOperation<T = Record<string, unknown>> =
+  | TransactionCreate<T>
+  | TransactionUpdate<T>
+  | TransactionDelete;
+
+export interface TransactionResultCreate<T = Record<string, unknown>> {
+  op: "create";
+  collection: string;
+  record: T & BunBaseRecord;
+}
+
+export interface TransactionResultUpdate<T = Record<string, unknown>> {
+  op: "update";
+  collection: string;
+  record: T & BunBaseRecord;
+}
+
+export interface TransactionResultDelete {
+  op: "delete";
+  collection: string;
+  id: string;
+}
+
+export type TransactionResult<T = Record<string, unknown>> =
+  | TransactionResultCreate<T>
+  | TransactionResultUpdate<T>
+  | TransactionResultDelete;
+
 export interface GetQuery {
   // Same expand semantics as ListQuery.
   expand?: string[];