@ekodb/ekodb-client 0.2.1 → 0.3.0

package/dist/client.d.ts

@@ -7,6 +7,15 @@ import { Schema, SchemaBuilder, CollectionMetadata } from "./schema";
 export interface Record {
     [key: string]: any;
 }
+/**
+ * Serialization format for client-server communication
+ */
+export declare enum SerializationFormat {
+    /** JSON format (default, human-readable) */
+    Json = "Json",
+    /** MessagePack format (binary, 2-3x faster) */
+    MessagePack = "MessagePack"
+}
 /**
  * Rate limit information from the server
  */
@@ -32,6 +41,8 @@ export interface ClientConfig {
     maxRetries?: number;
     /** Request timeout in milliseconds (default: 30000) */
     timeout?: number;
+    /** Serialization format (default: MessagePack for best performance, use Json for debugging) */
+    format?: SerializationFormat;
 }
 /**
  * Rate limit error
@@ -155,6 +166,7 @@ export declare class EkoDBClient {
     private shouldRetry;
     private maxRetries;
     private timeout;
+    private format;
     private rateLimitInfo;
     constructor(config: string | ClientConfig, apiKey?: string);
     /**
@@ -181,6 +193,12 @@ export declare class EkoDBClient {
      * Sleep for a specified number of seconds
      */
     private sleep;
+    /**
+     * Helper to determine if a path should use JSON
+     * Only CRUD operations (insert/update/delete/batch) use MessagePack
+     * Everything else uses JSON for compatibility
+     */
+    private shouldUseJSON;
     /**
      * Make an HTTP request to the ekoDB API with retry logic
      */
@@ -227,18 +245,19 @@ export declare class EkoDBClient {
     /**
      * Batch insert multiple documents
      */
-    batchInsert(collection: string, records: Record[]): Promise<Record[]>;
+    batchInsert(collection: string, records: Record[], bypassRipple?: boolean): Promise<BatchOperationResult>;
     /**
      * Batch update multiple documents
      */
     batchUpdate(collection: string, updates: Array<{
         id: string;
         data: Record;
-    }>): Promise<Record[]>;
+        bypassRipple?: boolean;
+    }>): Promise<BatchOperationResult>;
     /**
      * Batch delete multiple documents
      */
-    batchDelete(collection: string, ids: string[]): Promise<number>;
+    batchDelete(collection: string, ids: string[], bypassRipple?: boolean): Promise<BatchOperationResult>;
     /**
      * Set a key-value pair
      */

package/dist/client.js

@@ -36,10 +36,21 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebSocketClient = exports.EkoDBClient = exports.MergeStrategy = exports.RateLimitError = void 0;
+exports.WebSocketClient = exports.EkoDBClient = exports.MergeStrategy = exports.RateLimitError = exports.SerializationFormat = void 0;
+const msgpack_1 = require("@msgpack/msgpack");
 const query_builder_1 = require("./query-builder");
 const search_1 = require("./search");
 const schema_1 = require("./schema");
+/**
+ * Serialization format for client-server communication
+ */
+var SerializationFormat;
+(function (SerializationFormat) {
+    /** JSON format (default, human-readable) */
+    SerializationFormat["Json"] = "Json";
+    /** MessagePack format (binary, 2-3x faster) */
+    SerializationFormat["MessagePack"] = "MessagePack";
+})(SerializationFormat || (exports.SerializationFormat = SerializationFormat = {}));
 /**
  * Rate limit error
  */
@@ -68,6 +79,7 @@ class EkoDBClient {
             this.shouldRetry = true;
             this.maxRetries = 3;
             this.timeout = 30000;
+            this.format = SerializationFormat.MessagePack; // Default to MessagePack for 2-3x performance
         }
         else {
             this.baseURL = config.baseURL;
@@ -75,6 +87,7 @@ class EkoDBClient {
             this.shouldRetry = config.shouldRetry ?? true;
             this.maxRetries = config.maxRetries ?? 3;
             this.timeout = config.timeout ?? 30000;
+            this.format = config.format ?? SerializationFormat.MessagePack; // Default to MessagePack for 2-3x performance
         }
     }
     /**
@@ -138,29 +151,72 @@ class EkoDBClient {
     sleep(seconds) {
         return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
     }
+    /**
+     * Helper to determine if a path should use JSON
+     * Only CRUD operations (insert/update/delete/batch) use MessagePack
+     * Everything else uses JSON for compatibility
+     */
+    shouldUseJSON(path) {
+        // ONLY these operations support MessagePack
+        const msgpackPaths = [
+            "/api/insert/",
+            "/api/batch_insert/",
+            "/api/update/",
+            "/api/batch_update/",
+            "/api/delete/",
+            "/api/batch_delete/",
+        ];
+        // Check if path starts with any MessagePack-supported operation
+        for (const prefix of msgpackPaths) {
+            if (path.startsWith(prefix)) {
+                return false; // Use MessagePack
+            }
+        }
+        // Everything else uses JSON
+        return true;
+    }
     /**
      * Make an HTTP request to the ekoDB API with retry logic
      */
-    async makeRequest(method, path, data, attempt = 0) {
+    async makeRequest(method, path, data, attempt = 0, forceJson = false) {
         if (!this.token) {
             await this.refreshToken();
         }
+        // Determine content type and serialization based on path
+        // Only CRUD operations support MessagePack, everything else uses JSON
+        const shouldForceJson = forceJson || this.shouldUseJSON(path);
+        const isMessagePack = !shouldForceJson && this.format === SerializationFormat.MessagePack;
+        const contentType = isMessagePack
+            ? "application/msgpack"
+            : "application/json";
+        // Note: Modern fetch API automatically handles gzip/deflate decompression
+        // when server sends Content-Encoding header. No additional configuration needed.
         const options = {
             method,
             headers: {
                 Authorization: `Bearer ${this.token}`,
-                "Content-Type": "application/json",
+                "Content-Type": contentType,
+                Accept: contentType,
             },
         };
         if (data) {
-            options.body = JSON.stringify(data);
+            options.body = isMessagePack
+                ? (0, msgpack_1.encode)(data)
+                : JSON.stringify(data);
         }
         try {
             const response = await fetch(`${this.baseURL}${path}`, options);
             // Extract rate limit info from successful responses
             if (response.ok) {
                 this.extractRateLimitInfo(response);
-                return response.json();
+                // Deserialize based on format
+                if (isMessagePack) {
+                    const buffer = await response.arrayBuffer();
+                    return (0, msgpack_1.decode)(new Uint8Array(buffer));
+                }
+                else {
+                    return response.json();
+                }
             }
             // Handle rate limiting (429)
             if (response.status === 429) {
@@ -168,7 +224,7 @@ class EkoDBClient {
                 if (this.shouldRetry && attempt < this.maxRetries) {
                     console.log(`Rate limited. Retrying after ${retryAfter} seconds...`);
                     await this.sleep(retryAfter);
-                    return this.makeRequest(method, path, data, attempt + 1);
+                    return this.makeRequest(method, path, data, attempt + 1, forceJson);
                 }
                 throw new RateLimitError(retryAfter);
             }
@@ -179,7 +235,7 @@ class EkoDBClient {
                 const retryDelay = 10;
                 console.log(`Service unavailable. Retrying after ${retryDelay} seconds...`);
                 await this.sleep(retryDelay);
-                return this.makeRequest(method, path, data, attempt + 1);
+                return this.makeRequest(method, path, data, attempt + 1, forceJson);
             }
             // Handle other errors
             const text = await response.text();
@@ -193,7 +249,7 @@ class EkoDBClient {
                 const retryDelay = 3;
                 console.log(`Network error. Retrying after ${retryDelay} seconds...`);
                 await this.sleep(retryDelay);
-                return this.makeRequest(method, path, data, attempt + 1);
+                return this.makeRequest(method, path, data, attempt + 1, forceJson);
             }
             throw error;
         }
@@ -255,57 +311,65 @@ class EkoDBClient {
     /**
      * Batch insert multiple documents
      */
-    async batchInsert(collection, records) {
-        const inserts = records.map((data) => ({ data }));
-        const result = await this.makeRequest("POST", `/api/batch/insert/${collection}`, { inserts });
-        return result.successful.map((id) => ({ id }));
+    async batchInsert(collection, records, bypassRipple) {
+        const inserts = records.map((data) => ({
+            data,
+            bypass_ripple: bypassRipple,
+        }));
+        return this.makeRequest("POST", `/api/batch/insert/${collection}`, { inserts });
     }
     /**
      * Batch update multiple documents
      */
     async batchUpdate(collection, updates) {
-        const result = await this.makeRequest("PUT", `/api/batch/update/${collection}`, { updates });
-        return result.successful.map((id) => ({ id }));
+        const formattedUpdates = updates.map((u) => ({
+            id: u.id,
+            data: u.data,
+            bypass_ripple: u.bypassRipple,
+        }));
+        return this.makeRequest("PUT", `/api/batch/update/${collection}`, { updates: formattedUpdates });
     }
     /**
      * Batch delete multiple documents
      */
-    async batchDelete(collection, ids) {
-        const deletes = ids.map((id) => ({ id }));
-        const result = await this.makeRequest("DELETE", `/api/batch/delete/${collection}`, { deletes });
-        return result.successful.length;
+    async batchDelete(collection, ids, bypassRipple) {
+        const deletes = ids.map((id) => ({
+            id: id,
+            bypass_ripple: bypassRipple,
+        }));
+        return this.makeRequest("DELETE", `/api/batch/delete/${collection}`, { deletes });
     }
     /**
      * Set a key-value pair
      */
     async kvSet(key, value) {
-        await this.makeRequest("POST", `/api/kv/set/${encodeURIComponent(key)}`, { value });
+        await this.makeRequest("POST", `/api/kv/set/${encodeURIComponent(key)}`, { value }, 0, true);
     }
     /**
      * Get a value by key
      */
     async kvGet(key) {
-        const result = await this.makeRequest("GET", `/api/kv/get/${encodeURIComponent(key)}`);
+        const result = await this.makeRequest("GET", `/api/kv/get/${encodeURIComponent(key)}`, undefined, 0, true);
         return result.value;
     }
     /**
      * Delete a key
      */
     async kvDelete(key) {
-        await this.makeRequest("DELETE", `/api/kv/delete/${encodeURIComponent(key)}`);
+        await this.makeRequest("DELETE", `/api/kv/delete/${encodeURIComponent(key)}`, undefined, 0, true);
     }
     /**
      * List all collections
      */
     async listCollections() {
-        const result = await this.makeRequest("GET", "/api/collections");
+        const result = await this.makeRequest("GET", "/api/collections", undefined, 0, true);
         return result.collections;
     }
     /**
      * Delete a collection
      */
     async deleteCollection(collection) {
-        await this.makeRequest("DELETE", `/api/collections/${collection}`);
+        await this.makeRequest("DELETE", `/api/collections/${collection}`, undefined, 0, true);
     }
     /**
      * Create a collection with schema
@@ -325,7 +389,7 @@ class EkoDBClient {
      */
     async createCollection(collection, schema) {
         const schemaObj = schema instanceof schema_1.SchemaBuilder ? schema.build() : schema;
-        await this.makeRequest("POST", `/api/collections/${collection}`, schemaObj);
+        await this.makeRequest("POST", `/api/collections/${collection}`, schemaObj, 0, true);
     }
     /**
      * Get collection metadata and schema
@@ -334,7 +398,7 @@ class EkoDBClient {
      * @returns Collection metadata including schema and analytics
      */
     async getCollection(collection) {
-        return this.makeRequest("GET", `/api/collections/${collection}`);
+        return this.makeRequest("GET", `/api/collections/${collection}`, undefined, 0, true);
     }
     /**
      * Get collection schema
@@ -383,26 +447,26 @@ class EkoDBClient {
         const queryObj = searchQuery instanceof search_1.SearchQueryBuilder
             ? searchQuery.build()
             : searchQuery;
-        return this.makeRequest("POST", `/api/search/${collection}`, queryObj);
+        return this.makeRequest("POST", `/api/search/${collection}`, queryObj, 0, true);
     }
     // ========== Chat Methods ==========
     /**
      * Create a new chat session
      */
     async createChatSession(request) {
-        return this.makeRequest("POST", "/api/chat", request);
+        return this.makeRequest("POST", "/api/chat", request, 0, true);
     }
     /**
      * Send a message in an existing chat session
      */
     async chatMessage(sessionId, request) {
-        return this.makeRequest("POST", `/api/chat/${sessionId}/messages`, request);
+        return this.makeRequest("POST", `/api/chat/${sessionId}/messages`, request, 0, true);
     }
     /**
      * Get a chat session by ID
      */
     async getChatSession(sessionId) {
-        return this.makeRequest("GET", `/api/chat/${sessionId}`);
+        return this.makeRequest("GET", `/api/chat/${sessionId}`, undefined, 0, true);
     }
     /**
      * List all chat sessions
@@ -417,7 +481,7 @@ class EkoDBClient {
             params.append("sort", query.sort);
         const queryString = params.toString();
         const path = queryString ? `/api/chat?${queryString}` : "/api/chat";
-        return this.makeRequest("GET", path);
+        return this.makeRequest("GET", path, undefined, 0, true);
     }
     /**
      * Get messages from a chat session
@@ -434,55 +498,55 @@ class EkoDBClient {
         const path = queryString
             ? `/api/chat/${sessionId}/messages?${queryString}`
             : `/api/chat/${sessionId}/messages`;
-        return this.makeRequest("GET", path);
+        return this.makeRequest("GET", path, undefined, 0, true);
     }
     /**
      * Update a chat session
      */
     async updateChatSession(sessionId, request) {
-        return this.makeRequest("PUT", `/api/chat/${sessionId}`, request);
+        return this.makeRequest("PUT", `/api/chat/${sessionId}`, request, 0, true);
     }
     /**
      * Branch a chat session
      */
     async branchChatSession(request) {
-        return this.makeRequest("POST", "/api/chat/branch", request);
+        return this.makeRequest("POST", "/api/chat/branch", request, 0, true);
     }
     /**
      * Delete a chat session
      */
     async deleteChatSession(sessionId) {
-        await this.makeRequest("DELETE", `/api/chat/${sessionId}`);
+        await this.makeRequest("DELETE", `/api/chat/${sessionId}`, undefined, 0, true);
     }
     /**
      * Regenerate an AI response message
      */
     async regenerateMessage(sessionId, messageId) {
-        return this.makeRequest("POST", `/api/chat/${sessionId}/messages/${messageId}/regenerate`);
+        return this.makeRequest("POST", `/api/chat/${sessionId}/messages/${messageId}/regenerate`, undefined, 0, true);
     }
     /**
      * Update a specific message
      */
     async updateChatMessage(sessionId, messageId, content) {
-        await this.makeRequest("PUT", `/api/chat/${sessionId}/messages/${messageId}`, { content });
+        await this.makeRequest("PUT", `/api/chat/${sessionId}/messages/${messageId}`, { content }, 0, true);
     }
     /**
      * Delete a specific message
      */
     async deleteChatMessage(sessionId, messageId) {
-        await this.makeRequest("DELETE", `/api/chat/${sessionId}/messages/${messageId}`);
+        await this.makeRequest("DELETE", `/api/chat/${sessionId}/messages/${messageId}`, undefined, 0, true);
     }
     /**
      * Toggle the "forgotten" status of a message
      */
     async toggleForgottenMessage(sessionId, messageId, forgotten) {
-        await this.makeRequest("PATCH", `/api/chat/${sessionId}/messages/${messageId}/forgotten`, { forgotten });
+        await this.makeRequest("PATCH", `/api/chat/${sessionId}/messages/${messageId}/forgotten`, { forgotten }, 0, true);
     }
     /**
      * Merge multiple chat sessions into one
      */
     async mergeChatSessions(request) {
-        return this.makeRequest("POST", "/api/chat/merge", request);
+        return this.makeRequest("POST", "/api/chat/merge", request, 0, true);
     }
     /**
      * Create a WebSocket client

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { EkoDBClient, WebSocketClient, MergeStrategy, RateLimitError, } from "./client";
+export { EkoDBClient, WebSocketClient, SerializationFormat, MergeStrategy, RateLimitError, } from "./client";
 export { QueryBuilder, SortOrder } from "./query-builder";
 export { SearchQueryBuilder } from "./search";
 export { SchemaBuilder, FieldTypeSchemaBuilder, VectorIndexAlgorithm, DistanceMetric, } from "./schema";

package/dist/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JoinBuilder = exports.DistanceMetric = exports.VectorIndexAlgorithm = exports.FieldTypeSchemaBuilder = exports.SchemaBuilder = exports.SearchQueryBuilder = exports.SortOrder = exports.QueryBuilder = exports.RateLimitError = exports.MergeStrategy = exports.WebSocketClient = exports.EkoDBClient = void 0;
+exports.JoinBuilder = exports.DistanceMetric = exports.VectorIndexAlgorithm = exports.FieldTypeSchemaBuilder = exports.SchemaBuilder = exports.SearchQueryBuilder = exports.SortOrder = exports.QueryBuilder = exports.RateLimitError = exports.MergeStrategy = exports.SerializationFormat = exports.WebSocketClient = exports.EkoDBClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "EkoDBClient", { enumerable: true, get: function () { return client_1.EkoDBClient; } });
 Object.defineProperty(exports, "WebSocketClient", { enumerable: true, get: function () { return client_1.WebSocketClient; } });
+Object.defineProperty(exports, "SerializationFormat", { enumerable: true, get: function () { return client_1.SerializationFormat; } });
 Object.defineProperty(exports, "MergeStrategy", { enumerable: true, get: function () { return client_1.MergeStrategy; } });
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return client_1.RateLimitError; } });
 var query_builder_1 = require("./query-builder");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekodb/ekodb-client",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Official TypeScript/JavaScript client for ekoDB",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,6 +22,7 @@
     "typescript": "^5.3.0"
   },
   "dependencies": {
+    "@msgpack/msgpack": "^3.0.0",
     "ws": "^8.16.0"
   }
 }

package/src/client.ts

@@ -2,6 +2,7 @@
  * ekoDB TypeScript Client
  */
 
+import { encode, decode } from "@msgpack/msgpack";
 import { QueryBuilder, Query as QueryBuilderQuery } from "./query-builder";
 import { SearchQuery, SearchQueryBuilder, SearchResponse } from "./search";
 import { Schema, SchemaBuilder, CollectionMetadata } from "./schema";
@@ -10,6 +11,16 @@ export interface Record {
   [key: string]: any;
 }
 
+/**
+ * Serialization format for client-server communication
+ */
+export enum SerializationFormat {
+  /** JSON format (default, human-readable) */
+  Json = "Json",
+  /** MessagePack format (binary, 2-3x faster) */
+  MessagePack = "MessagePack",
+}
+
 /**
  * Rate limit information from the server
  */
@@ -36,6 +47,8 @@ export interface ClientConfig {
   maxRetries?: number;
   /** Request timeout in milliseconds (default: 30000) */
   timeout?: number;
+  /** Serialization format (default: MessagePack for best performance, use Json for debugging) */
+  format?: SerializationFormat;
 }
 
 /**
@@ -184,6 +197,7 @@ export class EkoDBClient {
   private shouldRetry: boolean;
   private maxRetries: number;
   private timeout: number;
+  private format: SerializationFormat;
   private rateLimitInfo: RateLimitInfo | null = null;
 
   constructor(config: string | ClientConfig, apiKey?: string) {
@@ -194,12 +208,14 @@ export class EkoDBClient {
       this.shouldRetry = true;
       this.maxRetries = 3;
       this.timeout = 30000;
+      this.format = SerializationFormat.MessagePack; // Default to MessagePack for 2-3x performance
     } else {
       this.baseURL = config.baseURL;
       this.apiKey = config.apiKey;
       this.shouldRetry = config.shouldRetry ?? true;
       this.maxRetries = config.maxRetries ?? 3;
       this.timeout = config.timeout ?? 30000;
+      this.format = config.format ?? SerializationFormat.MessagePack; // Default to MessagePack for 2-3x performance
     }
   }
 
@@ -275,6 +291,33 @@ export class EkoDBClient {
     return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
   }
 
+  /**
+   * Helper to determine if a path should use JSON
+   * Only CRUD operations (insert/update/delete/batch) use MessagePack
+   * Everything else uses JSON for compatibility
+   */
+  private shouldUseJSON(path: string): boolean {
+    // ONLY these operations support MessagePack
+    const msgpackPaths = [
+      "/api/insert/",
+      "/api/batch_insert/",
+      "/api/update/",
+      "/api/batch_update/",
+      "/api/delete/",
+      "/api/batch_delete/",
+    ];
+
+    // Check if path starts with any MessagePack-supported operation
+    for (const prefix of msgpackPaths) {
+      if (path.startsWith(prefix)) {
+        return false; // Use MessagePack
+      }
+    }
+
+    // Everything else uses JSON
+    return true;
+  }
+
   /**
    * Make an HTTP request to the ekoDB API with retry logic
    */
@@ -283,21 +326,36 @@ export class EkoDBClient {
     path: string,
     data?: any,
     attempt: number = 0,
+    forceJson: boolean = false,
   ): Promise<T> {
     if (!this.token) {
       await this.refreshToken();
     }
 
+    // Determine content type and serialization based on path
+    // Only CRUD operations support MessagePack, everything else uses JSON
+    const shouldForceJson = forceJson || this.shouldUseJSON(path);
+    const isMessagePack =
+      !shouldForceJson && this.format === SerializationFormat.MessagePack;
+    const contentType = isMessagePack
+      ? "application/msgpack"
+      : "application/json";
+
+    // Note: Modern fetch API automatically handles gzip/deflate decompression
+    // when server sends Content-Encoding header. No additional configuration needed.
     const options: RequestInit = {
       method,
       headers: {
         Authorization: `Bearer ${this.token}`,
-        "Content-Type": "application/json",
+        "Content-Type": contentType,
+        Accept: contentType,
       },
     };
 
     if (data) {
-      options.body = JSON.stringify(data);
+      options.body = isMessagePack
+        ? (encode(data) as any)
+        : JSON.stringify(data);
     }
 
     try {
@@ -306,7 +364,14 @@ export class EkoDBClient {
       // Extract rate limit info from successful responses
       if (response.ok) {
         this.extractRateLimitInfo(response);
-        return response.json() as Promise<T>;
+
+        // Deserialize based on format
+        if (isMessagePack) {
+          const buffer = await response.arrayBuffer();
+          return decode(new Uint8Array(buffer)) as T;
+        } else {
+          return response.json() as Promise<T>;
+        }
       }
 
       // Handle rate limiting (429)
@@ -319,7 +384,13 @@ export class EkoDBClient {
         if (this.shouldRetry && attempt < this.maxRetries) {
           console.log(`Rate limited. Retrying after ${retryAfter} seconds...`);
           await this.sleep(retryAfter);
-          return this.makeRequest<T>(method, path, data, attempt + 1);
+          return this.makeRequest<T>(
+            method,
+            path,
+            data,
+            attempt + 1,
+            forceJson,
+          );
         }
 
         throw new RateLimitError(retryAfter);
@@ -336,7 +407,7 @@ export class EkoDBClient {
           `Service unavailable. Retrying after ${retryDelay} seconds...`,
         );
         await this.sleep(retryDelay);
-        return this.makeRequest<T>(method, path, data, attempt + 1);
+        return this.makeRequest<T>(method, path, data, attempt + 1, forceJson);
       }
 
       // Handle other errors
@@ -352,7 +423,7 @@ export class EkoDBClient {
         const retryDelay = 3;
         console.log(`Network error. Retrying after ${retryDelay} seconds...`);
         await this.sleep(retryDelay);
-        return this.makeRequest<T>(method, path, data, attempt + 1);
+        return this.makeRequest<T>(method, path, data, attempt + 1, forceJson);
       }
 
       throw error;
@@ -440,14 +511,20 @@ export class EkoDBClient {
   /**
    * Batch insert multiple documents
    */
-  async batchInsert(collection: string, records: Record[]): Promise<Record[]> {
-    const inserts = records.map((data) => ({ data }));
-    const result = await this.makeRequest<BatchOperationResult>(
+  async batchInsert(
+    collection: string,
+    records: Record[],
+    bypassRipple?: boolean,
+  ): Promise<BatchOperationResult> {
+    const inserts = records.map((data) => ({
+      data,
+      bypass_ripple: bypassRipple,
+    }));
+    return this.makeRequest<BatchOperationResult>(
       "POST",
       `/api/batch/insert/${collection}`,
       { inserts },
     );
-    return result.successful.map((id) => ({ id }));
   }
 
   /**
@@ -455,27 +532,37 @@ export class EkoDBClient {
    */
   async batchUpdate(
     collection: string,
-    updates: Array<{ id: string; data: Record }>,
-  ): Promise<Record[]> {
-    const result = await this.makeRequest<BatchOperationResult>(
+    updates: Array<{ id: string; data: Record; bypassRipple?: boolean }>,
+  ): Promise<BatchOperationResult> {
+    const formattedUpdates = updates.map((u) => ({
+      id: u.id,
+      data: u.data,
+      bypass_ripple: u.bypassRipple,
+    }));
+    return this.makeRequest<BatchOperationResult>(
       "PUT",
       `/api/batch/update/${collection}`,
-      { updates },
+      { updates: formattedUpdates },
     );
-    return result.successful.map((id) => ({ id }));
   }
 
   /**
    * Batch delete multiple documents
    */
-  async batchDelete(collection: string, ids: string[]): Promise<number> {
-    const deletes = ids.map((id) => ({ id }));
-    const result = await this.makeRequest<BatchOperationResult>(
+  async batchDelete(
+    collection: string,
+    ids: string[],
+    bypassRipple?: boolean,
+  ): Promise<BatchOperationResult> {
+    const deletes = ids.map((id) => ({
+      id: id,
+      bypass_ripple: bypassRipple,
+    }));
+    return this.makeRequest<BatchOperationResult>(
       "DELETE",
       `/api/batch/delete/${collection}`,
       { deletes },
     );
-    return result.successful.length;
   }
 
   /**
@@ -486,6 +573,8 @@ export class EkoDBClient {
       "POST",
       `/api/kv/set/${encodeURIComponent(key)}`,
       { value },
+      0,
+      true, // Force JSON for KV operations
     );
   }
 
@@ -496,6 +585,9 @@ export class EkoDBClient {
     const result = await this.makeRequest<{ value: any }>(
       "GET",
       `/api/kv/get/${encodeURIComponent(key)}`,
+      undefined,
+      0,
+      true, // Force JSON for KV operations
     );
     return result.value;
   }
@@ -507,6 +599,9 @@ export class EkoDBClient {
     await this.makeRequest<void>(
       "DELETE",
       `/api/kv/delete/${encodeURIComponent(key)}`,
+      undefined,
+      0,
+      true, // Force JSON for KV operations
     );
   }
 
@@ -517,6 +612,9 @@ export class EkoDBClient {
     const result = await this.makeRequest<{ collections: string[] }>(
       "GET",
       "/api/collections",
+      undefined,
+      0,
+      true, // Force JSON for metadata operations
     );
     return result.collections;
   }
@@ -525,7 +623,13 @@ export class EkoDBClient {
    * Delete a collection
    */
   async deleteCollection(collection: string): Promise<void> {
-    await this.makeRequest<void>("DELETE", `/api/collections/${collection}`);
+    await this.makeRequest<void>(
+      "DELETE",
+      `/api/collections/${collection}`,
+      undefined,
+      0,
+      true, // Force JSON for metadata operations
+    );
   }
 
   /**
@@ -553,6 +657,8 @@ export class EkoDBClient {
       "POST",
       `/api/collections/${collection}`,
       schemaObj,
+      0,
+      true, // Force JSON for metadata operations
     );
   }
 
@@ -566,6 +672,9 @@ export class EkoDBClient {
     return this.makeRequest<CollectionMetadata>(
       "GET",
       `/api/collections/${collection}`,
+      undefined,
+      0,
+      true, // Force JSON for metadata operations
     );
   }
 
@@ -625,6 +734,8 @@ export class EkoDBClient {
       "POST",
       `/api/search/${collection}`,
       queryObj,
+      0,
+      true, // Force JSON for search operations
     );
   }
 
@@ -636,7 +747,13 @@ export class EkoDBClient {
   async createChatSession(
     request: CreateChatSessionRequest,
   ): Promise<ChatResponse> {
-    return this.makeRequest<ChatResponse>("POST", "/api/chat", request);
+    return this.makeRequest<ChatResponse>(
+      "POST",
+      "/api/chat",
+      request,
+      0,
+      true, // Force JSON for chat operations
+    );
   }
 
   /**
@@ -650,6 +767,8 @@ export class EkoDBClient {
       "POST",
       `/api/chat/${sessionId}/messages`,
       request,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -660,6 +779,9 @@ export class EkoDBClient {
     return this.makeRequest<ChatSessionResponse>(
       "GET",
       `/api/chat/${sessionId}`,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -676,7 +798,13 @@ export class EkoDBClient {
 
     const queryString = params.toString();
     const path = queryString ? `/api/chat?${queryString}` : "/api/chat";
-    return this.makeRequest<ListSessionsResponse>("GET", path);
+    return this.makeRequest<ListSessionsResponse>(
+      "GET",
+      path,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
+    );
   }
 
   /**
@@ -695,7 +823,13 @@ export class EkoDBClient {
     const path = queryString
       ? `/api/chat/${sessionId}/messages?${queryString}`
       : `/api/chat/${sessionId}/messages`;
-    return this.makeRequest<GetMessagesResponse>("GET", path);
+    return this.makeRequest<GetMessagesResponse>(
+      "GET",
+      path,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
+    );
   }
 
   /**
@@ -709,6 +843,8 @@ export class EkoDBClient {
       "PUT",
       `/api/chat/${sessionId}`,
       request,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -718,14 +854,26 @@ export class EkoDBClient {
   async branchChatSession(
     request: CreateChatSessionRequest,
   ): Promise<ChatResponse> {
-    return this.makeRequest<ChatResponse>("POST", "/api/chat/branch", request);
+    return this.makeRequest<ChatResponse>(
+      "POST",
+      "/api/chat/branch",
+      request,
+      0,
+      true, // Force JSON for chat operations
+    );
   }
 
   /**
    * Delete a chat session
    */
   async deleteChatSession(sessionId: string): Promise<void> {
-    await this.makeRequest<void>("DELETE", `/api/chat/${sessionId}`);
+    await this.makeRequest<void>(
+      "DELETE",
+      `/api/chat/${sessionId}`,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
+    );
   }
 
   /**
@@ -738,6 +886,9 @@ export class EkoDBClient {
     return this.makeRequest<ChatResponse>(
       "POST",
       `/api/chat/${sessionId}/messages/${messageId}/regenerate`,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -753,6 +904,8 @@ export class EkoDBClient {
       "PUT",
       `/api/chat/${sessionId}/messages/${messageId}`,
       { content },
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -763,6 +916,9 @@ export class EkoDBClient {
     await this.makeRequest<void>(
       "DELETE",
       `/api/chat/${sessionId}/messages/${messageId}`,
+      undefined,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -778,6 +934,8 @@ export class EkoDBClient {
       "PATCH",
       `/api/chat/${sessionId}/messages/${messageId}/forgotten`,
       { forgotten },
+      0,
+      true, // Force JSON for chat operations
     );
   }
 
@@ -791,6 +949,8 @@ export class EkoDBClient {
       "POST",
       "/api/chat/merge",
       request,
+      0,
+      true, // Force JSON for chat operations
     );
   }
 

package/src/index.ts

@@ -1,6 +1,7 @@
 export {
   EkoDBClient,
   WebSocketClient,
+  SerializationFormat,
   MergeStrategy,
   RateLimitError,
 } from "./client";