kommo-aiatende-api 1.2.2 → 1.2.4

package/dist/index.mjs

@@ -41,12 +41,30 @@ var AuthManager = class {
 // src/resources/leads/index.ts
 import qs from "qs";
 
+// src/utils/idempotency.ts
+import { randomUUID } from "crypto";
+function ensureRequestId(item) {
+  if (item.request_id) return item;
+  return { ...item, request_id: randomUUID() };
+}
+
 // src/base.ts
 var BaseResource = class {
   client;
   constructor(client) {
     this.client = client;
   }
+  /**
+   * POST de criação em lote marcado como seguro para retry: cada item recebe um
+   * request_id (se ainda não tiver um) para que a Kommo deduplique reenvios após
+   * falhas transitórias de rede, e a requisição fica elegível ao retry automático.
+   */
+  async postIdempotent(url, items) {
+    const payload = items.map(ensureRequestId);
+    const config = { _idempotentRetry: true };
+    const response = await this.client.post(url, payload, config);
+    return response.data;
+  }
 };
 
 // src/resources/leads/index.ts
@@ -118,8 +136,7 @@ var LeadsResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/leads", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/leads", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -132,8 +149,7 @@ var LeadsResource = class extends BaseResource {
   }
   async createComplex(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/leads/complex", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/leads/complex", payload);
   }
   async listLossReasons() {
     const response = await this.client.get("/api/v4/leads/loss_reasons");
@@ -210,8 +226,7 @@ var ContactsResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/contacts", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/contacts", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -678,8 +693,7 @@ var CompaniesResource = class extends BaseResource {
   }
   async create(items) {
     const payload = Array.isArray(items) ? items : [items];
-    const response = await this.client.post("/api/v4/companies", payload);
-    return response.data;
+    return this.postIdempotent("/api/v4/companies", payload);
   }
   async update(items) {
     const payload = Array.isArray(items) ? items : [items];
@@ -1394,6 +1408,61 @@ var KommoApiError = class extends Error {
   }
 };
 
+// src/http/retry.ts
+var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set(["get", "delete", "patch", "put", "head", "options"]);
+var TRANSIENT_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ECONNRESET",
+  "ECONNABORTED",
+  "ETIMEDOUT",
+  "EAI_AGAIN",
+  "EPIPE"
+]);
+function isTransientNetworkError(error) {
+  if (error.response) return false;
+  if (error.code && TRANSIENT_ERROR_CODES.has(error.code)) return true;
+  return /socket hang up|network error/i.test(error.message || "");
+}
+function isRetryableRequest(config) {
+  const method = (config.method || "get").toLowerCase();
+  if (IDEMPOTENT_METHODS.has(method)) return true;
+  return method === "post" && config._idempotentRetry === true;
+}
+function isRateLimited(error) {
+  return error.response?.status === 429;
+}
+function retryAfterMs(error) {
+  const header = error.response?.headers?.["retry-after"];
+  if (!header) return null;
+  const seconds = Number(header);
+  if (!Number.isNaN(seconds)) return seconds * 1e3;
+  const dateMs = Date.parse(header);
+  if (!Number.isNaN(dateMs)) return Math.max(0, dateMs - Date.now());
+  return null;
+}
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function attachRetryInterceptor(client, retryConfig = {}) {
+  const { retries = 2, baseDelayMs = 300, maxDelayMs = 3e3 } = retryConfig;
+  client.interceptors.response.use(void 0, async (error) => {
+    const config = error.config;
+    const rateLimited = isRateLimited(error);
+    if (!config || retries <= 0 || !rateLimited && (!isTransientNetworkError(error) || !isRetryableRequest(config))) {
+      throw error;
+    }
+    const attempt = config._retryCount ?? 0;
+    if (attempt >= retries) {
+      throw error;
+    }
+    config._retryCount = attempt + 1;
+    const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
+    const backoff = rateLimited ? retryAfterMs(error) ?? exponential : exponential;
+    const jitter = backoff * 0.3 * Math.random();
+    await wait(backoff + jitter);
+    return client.request(config);
+  });
+}
+
 // src/client.ts
 var KommoClient = class {
   config;
@@ -1433,6 +1502,7 @@ var KommoClient = class {
     const baseURL = `https://${config.domain}.kommo.com`;
     this.httpClient = axios2.create({
       baseURL,
+      timeout: config.timeout ?? 3e4,
       headers: {
         "Content-Type": "application/json"
       },
@@ -1440,6 +1510,9 @@ var KommoClient = class {
         return qs19.stringify(params, { arrayFormat: "brackets" });
       }
     });
+    if (config.retry !== false) {
+      attachRetryInterceptor(this.httpClient, config.retry || {});
+    }
     this.httpClient.interceptors.response.use(
       (response) => response,
       (error) => {