mem0ai 2.4.6 → 3.0.0-beta.1

package/dist/index.mjs

@@ -75,6 +75,37 @@ async function captureClientEvent(eventName, instance, additionalData = {}) {
   );
 }
 
+// src/client/utils.ts
+function camelToSnake(str) {
+  if (str === str.toUpperCase()) return str;
+  return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function snakeToCamel(str) {
+  return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function camelToSnakeKeys(obj) {
+  if (obj === null || obj === void 0 || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) return obj.map(camelToSnakeKeys);
+  if (obj instanceof Date) return obj;
+  return Object.fromEntries(
+    Object.entries(obj).map(([key, value]) => [
+      camelToSnake(key),
+      camelToSnakeKeys(value)
+    ])
+  );
+}
+function snakeToCamelKeys(obj) {
+  if (obj === null || obj === void 0 || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) return obj.map(snakeToCamelKeys);
+  if (obj instanceof Date) return obj;
+  return Object.fromEntries(
+    Object.entries(obj).map(([key, value]) => [
+      snakeToCamel(key),
+      snakeToCamelKeys(value)
+    ])
+  );
+}
+
 // src/common/exceptions.ts
 var MemoryError = class extends Error {
   constructor(message, errorCode, options = {}) {
@@ -173,6 +204,26 @@ function createExceptionFromResponse(statusCode, responseText, options = {}) {
 }
 
 // src/client/mem0.ts
+var ENTITY_PARAMS = [
+  "user_id",
+  "agent_id",
+  "app_id",
+  "run_id",
+  "userId",
+  "agentId",
+  "appId",
+  "runId"
+];
+function rejectTopLevelEntityParams(options, methodName) {
+  const invalidKeys = Object.keys(options != null ? options : {}).filter(
+    (k) => ENTITY_PARAMS.includes(k)
+  );
+  if (invalidKeys.length > 0) {
+    throw new Error(
+      `Top-level entity parameters [${invalidKeys.join(", ")}] are not supported in ${methodName}(). Use filters: { user_id: "..." } instead.`
+    );
+  }
+}
 var APIError = class extends Error {
   constructor(message) {
     super(message);
@@ -191,25 +242,11 @@ var MemoryClient = class {
       throw new Error("Mem0 API key cannot be empty");
     }
   }
-  _validateOrgProject() {
-    if (this.organizationName === null && this.projectName !== null || this.organizationName !== null && this.projectName === null) {
-      console.warn(
-        "Warning: Both organizationName and projectName must be provided together when using either. This will be removed from version 1.0.40. Note that organizationName/projectName are being deprecated in favor of organizationId/projectId."
-      );
-    }
-    if (this.organizationId === null && this.projectId !== null || this.organizationId !== null && this.projectId === null) {
-      console.warn(
-        "Warning: Both organizationId and projectId must be provided together when using either. This will be removed from version 1.0.40."
-      );
-    }
-  }
   constructor(options) {
     this.apiKey = options.apiKey;
     this.host = options.host || "https://api.mem0.ai";
-    this.organizationName = options.organizationName || null;
-    this.projectName = options.projectName || null;
-    this.organizationId = options.organizationId || null;
-    this.projectId = options.projectId || null;
+    this.organizationId = null;
+    this.projectId = null;
     this.headers = {
       Authorization: `Token ${this.apiKey}`,
       "Content-Type": "application/json"
@@ -229,9 +266,7 @@ var MemoryClient = class {
       if (!this.telemetryId) {
         this.telemetryId = generateHash(this.apiKey);
       }
-      this._validateOrgProject();
       captureClientEvent("init", this, {
-        api_version: "v1",
         client_type: "MemoryClient"
       }).catch((error) => {
         console.error("Failed to capture event:", error);
@@ -267,12 +302,12 @@ var MemoryClient = class {
       throw createExceptionFromResponse(response.status, errorData);
     }
     const jsonResponse = await response.json();
-    return jsonResponse;
+    return snakeToCamelKeys(jsonResponse);
   }
   _preparePayload(messages, options) {
     const payload = {};
     payload.messages = messages;
-    return { ...payload, ...options };
+    return camelToSnakeKeys({ ...payload, ...options });
   }
   _prepareParams(options) {
     return Object.fromEntries(
@@ -296,10 +331,10 @@ var MemoryClient = class {
       if (response.status !== "ok") {
         throw new APIError(response.message || "API Key is invalid");
       }
-      const { org_id, project_id, user_email } = response;
-      if (org_id && !this.organizationId) this.organizationId = org_id;
-      if (project_id && !this.projectId) this.projectId = project_id;
-      if (user_email) this.telemetryId = user_email;
+      const { orgId, projectId, userEmail } = response;
+      if (orgId) this.organizationId = orgId;
+      if (projectId) this.projectId = projectId;
+      if (userEmail) this.telemetryId = userEmail;
     } catch (error) {
       if (error instanceof MemoryError || error instanceof APIError) {
         throw error;
@@ -312,25 +347,11 @@ var MemoryClient = class {
   }
   async add(messages, options = {}) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
-    if (this.organizationName != null && this.projectName != null) {
-      options.org_name = this.organizationName;
-      options.project_name = this.projectName;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      options.org_id = this.organizationId;
-      options.project_id = this.projectId;
-      if (options.org_name) delete options.org_name;
-      if (options.project_name) delete options.project_name;
-    }
-    if (options.api_version) {
-      options.version = options.api_version.toString() || "v2";
-    }
     const payload = this._preparePayload(messages, options);
     const payloadKeys = Object.keys(payload);
     this._captureEvent("add", [payloadKeys]);
     const response = await this._fetchWithErrorHandling(
-      `${this.host}/v1/memories/`,
+      `${this.host}/v3/memories/`,
       {
         method: "POST",
         headers: this.headers,
@@ -350,7 +371,6 @@ var MemoryClient = class {
       );
     }
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     const payload = {};
     if (text !== void 0) payload.text = text;
     if (metadata !== void 0) payload.metadata = metadata;
@@ -378,62 +398,42 @@ var MemoryClient = class {
     );
   }
   async getAll(options) {
+    var _a2;
+    rejectTopLevelEntityParams(options, "getAll");
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     const payloadKeys = Object.keys(options || {});
     this._captureEvent("get_all", [payloadKeys]);
-    const { api_version, page, page_size, ...otherOptions } = options != null ? options : {};
-    if (this.organizationName != null && this.projectName != null) {
-      otherOptions.org_name = this.organizationName;
-      otherOptions.project_name = this.projectName;
-    }
-    let appendedParams = "";
-    let paginated_response = false;
-    if (page && page_size) {
-      appendedParams += `page=${page}&page_size=${page_size}`;
-      paginated_response = true;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      otherOptions.org_id = this.organizationId;
-      otherOptions.project_id = this.projectId;
-      if (otherOptions.org_name) delete otherOptions.org_name;
-      if (otherOptions.project_name) delete otherOptions.project_name;
-    }
-    if (api_version === "v2") {
-      let url = paginated_response ? `${this.host}/v2/memories/?${appendedParams}` : `${this.host}/v2/memories/`;
-      return this._fetchWithErrorHandling(url, {
-        method: "POST",
-        headers: this.headers,
-        body: JSON.stringify(otherOptions)
-      });
-    } else {
-      const params = new URLSearchParams(this._prepareParams(otherOptions));
-      const url = paginated_response ? `${this.host}/v1/memories/?${params}&${appendedParams}` : `${this.host}/v1/memories/?${params}`;
-      return this._fetchWithErrorHandling(url, {
-        headers: this.headers
-      });
-    }
+    const { page, pageSize, filters, ...rest } = options != null ? options : {};
+    const body = {
+      output_format: "v1.1",
+      ...camelToSnakeKeys(rest),
+      ...filters && { filters }
+    };
+    let url = `${this.host}/v2/memories/`;
+    if (page && pageSize) {
+      url += `?page=${page}&page_size=${pageSize}`;
+    }
+    const response = await this._fetchWithErrorHandling(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    return Array.isArray(response) ? response : (_a2 = response == null ? void 0 : response.results) != null ? _a2 : response;
   }
   async search(query, options) {
+    rejectTopLevelEntityParams(options, "search");
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     const payloadKeys = Object.keys(options || {});
     this._captureEvent("search", [payloadKeys]);
-    const { api_version, ...otherOptions } = options != null ? options : {};
-    const payload = { query, ...otherOptions };
-    if (this.organizationName != null && this.projectName != null) {
-      payload.org_name = this.organizationName;
-      payload.project_name = this.projectName;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      payload.org_id = this.organizationId;
-      payload.project_id = this.projectId;
-      if (payload.org_name) delete payload.org_name;
-      if (payload.project_name) delete payload.project_name;
-    }
-    const endpoint = api_version === "v2" ? "/v2/memories/search/" : "/v1/memories/search/";
+    const { filters, ...rest } = options != null ? options : {};
+    const payload = {
+      query,
+      output_format: "v1.1",
+      ...camelToSnakeKeys(rest),
+      ...filters && { filters }
+    };
     const response = await this._fetchWithErrorHandling(
-      `${this.host}${endpoint}`,
+      `${this.host}/v3/memories/search/`,
       {
         method: "POST",
         headers: this.headers,
@@ -455,20 +455,10 @@ var MemoryClient = class {
   }
   async deleteAll(options = {}) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     const payloadKeys = Object.keys(options || {});
     this._captureEvent("delete_all", [payloadKeys]);
-    if (this.organizationName != null && this.projectName != null) {
-      options.org_name = this.organizationName;
-      options.project_name = this.projectName;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      options.org_id = this.organizationId;
-      options.project_id = this.projectId;
-      if (options.org_name) delete options.org_name;
-      if (options.project_name) delete options.project_name;
-    }
-    const params = new URLSearchParams(this._prepareParams(options));
+    const snakeOptions = camelToSnakeKeys(this._prepareParams(options));
+    const params = new URLSearchParams(snakeOptions);
     const response = await this._fetchWithErrorHandling(
       `${this.host}/v1/memories/?${params}`,
       {
@@ -489,28 +479,17 @@ var MemoryClient = class {
     );
     return response;
   }
-  async users() {
+  async users(options) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     this._captureEvent("users", []);
-    const options = {};
-    if (this.organizationName != null && this.projectName != null) {
-      options.org_name = this.organizationName;
-      options.project_name = this.projectName;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      options.org_id = this.organizationId;
-      options.project_id = this.projectId;
-      if (options.org_name) delete options.org_name;
-      if (options.project_name) delete options.project_name;
-    }
-    const params = new URLSearchParams(options);
-    const response = await this._fetchWithErrorHandling(
-      `${this.host}/v1/entities/?${params}`,
-      {
-        headers: this.headers
-      }
-    );
+    let url = `${this.host}/v1/entities/`;
+    const params = [];
+    if (options == null ? void 0 : options.page) params.push(`page=${options.page}`);
+    if (options == null ? void 0 : options.pageSize) params.push(`page_size=${options.pageSize}`);
+    if (params.length) url += `?${params.join("&")}`;
+    const response = await this._fetchWithErrorHandling(url, {
+      headers: this.headers
+    });
     return response;
   }
   /**
@@ -533,17 +512,16 @@ var MemoryClient = class {
   }
   async deleteUsers(params = {}) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     let to_delete = [];
-    const { user_id, agent_id, app_id, run_id } = params;
-    if (user_id) {
-      to_delete = [{ type: "user", name: user_id }];
-    } else if (agent_id) {
-      to_delete = [{ type: "agent", name: agent_id }];
-    } else if (app_id) {
-      to_delete = [{ type: "app", name: app_id }];
-    } else if (run_id) {
-      to_delete = [{ type: "run", name: run_id }];
+    const { userId, agentId, appId, runId } = params;
+    if (userId) {
+      to_delete = [{ type: "user", name: userId }];
+    } else if (agentId) {
+      to_delete = [{ type: "agent", name: agentId }];
+    } else if (appId) {
+      to_delete = [{ type: "app", name: appId }];
+    } else if (runId) {
+      to_delete = [{ type: "run", name: runId }];
     } else {
       const entities = await this.users();
       to_delete = entities.results.map((entity) => ({
@@ -554,25 +532,9 @@ var MemoryClient = class {
     if (to_delete.length === 0) {
       throw new Error("No entities to delete");
     }
-    const requestOptions = {};
-    if (this.organizationName != null && this.projectName != null) {
-      requestOptions.org_name = this.organizationName;
-      requestOptions.project_name = this.projectName;
-    }
-    if (this.organizationId != null && this.projectId != null) {
-      requestOptions.org_id = this.organizationId;
-      requestOptions.project_id = this.projectId;
-      if (requestOptions.org_name) delete requestOptions.org_name;
-      if (requestOptions.project_name) delete requestOptions.project_name;
-    }
     for (const entity of to_delete) {
       try {
-        await this.client.delete(
-          `/v2/entities/${entity.type}/${entity.name}/`,
-          {
-            params: requestOptions
-          }
-        );
+        await this.client.delete(`/v2/entities/${entity.type}/${entity.name}/`);
       } catch (error) {
         throw new APIError(
           `Failed to delete ${entity.type} ${entity.name}: ${error.message}`
@@ -580,16 +542,10 @@ var MemoryClient = class {
       }
     }
     this._captureEvent("delete_users", [
-      {
-        user_id,
-        agent_id,
-        app_id,
-        run_id,
-        sync_type: "sync"
-      }
+      { userId, agentId, appId, runId, sync_type: "sync" }
     ]);
     return {
-      message: user_id || agent_id || app_id || run_id ? "Entity deleted successfully." : "All users, agents, apps and runs deleted."
+      message: userId || agentId || appId || runId ? "Entity deleted successfully." : "All users, agents, apps and runs deleted."
     };
   }
   async batchUpdate(memories) {
@@ -627,7 +583,6 @@ var MemoryClient = class {
   }
   async getProject(options) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     const payloadKeys = Object.keys(options || {});
     this._captureEvent("get_project", [payloadKeys]);
     const { fields } = options;
@@ -637,7 +592,7 @@ var MemoryClient = class {
       );
     }
     const params = new URLSearchParams();
-    fields == null ? void 0 : fields.forEach((field) => params.append("fields", field));
+    fields == null ? void 0 : fields.forEach((field) => params.append("fields", camelToSnake(field)));
     const response = await this._fetchWithErrorHandling(
       `${this.host}/api/v1/orgs/organizations/${this.organizationId}/projects/${this.projectId}/?${params.toString()}`,
       {
@@ -648,7 +603,6 @@ var MemoryClient = class {
   }
   async updateProject(prompts) {
     if (this.telemetryId === "") await this.ping();
-    this._validateOrgProject();
     this._captureEvent("update_project", []);
     if (!(this.organizationId && this.projectId)) {
       throw new Error(
@@ -660,7 +614,7 @@ var MemoryClient = class {
       {
         method: "PATCH",
         headers: this.headers,
-        body: JSON.stringify(prompts)
+        body: JSON.stringify(camelToSnakeKeys(prompts))
       }
     );
     return response;
@@ -735,45 +689,47 @@ var MemoryClient = class {
       {
         method: "POST",
         headers: this.headers,
-        body: JSON.stringify(data)
+        body: JSON.stringify(camelToSnakeKeys(data))
       }
     );
     return response;
   }
   async createMemoryExport(data) {
-    var _a2, _b;
     if (this.telemetryId === "") await this.ping();
     this._captureEvent("create_memory_export", []);
     if (!data.filters || !data.schema) {
       throw new Error("Missing filters or schema");
     }
-    data.org_id = ((_a2 = this.organizationId) == null ? void 0 : _a2.toString()) || null;
-    data.project_id = ((_b = this.projectId) == null ? void 0 : _b.toString()) || null;
+    const { filters, ...rest } = data;
     const response = await this._fetchWithErrorHandling(
       `${this.host}/v1/exports/`,
       {
         method: "POST",
         headers: this.headers,
-        body: JSON.stringify(data)
+        body: JSON.stringify({
+          ...camelToSnakeKeys(rest),
+          filters
+        })
       }
     );
     return response;
   }
   async getMemoryExport(data) {
-    var _a2, _b;
     if (this.telemetryId === "") await this.ping();
     this._captureEvent("get_memory_export", []);
-    if (!data.memory_export_id && !data.filters) {
-      throw new Error("Missing memory_export_id or filters");
+    if (!data.memoryExportId && !data.filters) {
+      throw new Error("Missing memoryExportId or filters");
     }
-    data.org_id = ((_a2 = this.organizationId) == null ? void 0 : _a2.toString()) || "";
-    data.project_id = ((_b = this.projectId) == null ? void 0 : _b.toString()) || "";
+    const { filters, ...rest } = data;
     const response = await this._fetchWithErrorHandling(
       `${this.host}/v1/exports/get/`,
       {
         method: "POST",
         headers: this.headers,
-        body: JSON.stringify(data)
+        body: JSON.stringify({
+          ...camelToSnakeKeys(rest),
+          ...filters && { filters }
+        })
       }
     );
     return response;