@signaliz/sdk 1.0.44 → 1.0.46

package/README.md

@@ -100,6 +100,10 @@ const compactSignals = await signaliz.enrichCompanies(companies, {
 });
 ```
 
+Failed rows preserve `errorCode`, `retryEligible`, and `retryAfterSeconds`
+when the REST API supplies them, including after automatic row retries are
+exhausted.
+
 For an ambiguous submission failure, retry with the same
 `idempotencyKey` to recover the original job without duplicate work.
 

package/dist/{chunk-Q4T2GUXD.mjs → chunk-4LXMT3S5.mjs}

@@ -496,7 +496,11 @@ var Signaliz = class {
         const params = companies[item.index];
         const task = taskByIndex.get(item.index);
         if (!item.success || !item.raw) {
-          results[item.index] = { index: item.index, success: false, error: item.error || "Company Signal batch request failed" };
+          results[item.index] = batchItemFailure(
+            item.index,
+            item.error || "Company Signal batch request failed",
+            item.raw ?? item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item.raw) || params.waitForResult === false) {
@@ -605,11 +609,11 @@ var Signaliz = class {
       const chunk = chunks[chunkResult.index];
       if (!chunkResult.success || !chunkResult.data) {
         for (let index = 0; index < chunk.requests.length; index += 1) {
-          uniqueResults[chunk.offset + index] = {
-            index: chunk.offset + index,
-            success: false,
-            error: chunkResult.error || "Signal to Copy batch request failed"
-          };
+          uniqueResults[chunk.offset + index] = batchItemFailure(
+            chunk.offset + index,
+            chunkResult.error || "Signal to Copy batch request failed",
+            chunkResult
+          );
         }
         continue;
       }
@@ -631,7 +635,7 @@ var Signaliz = class {
     const results = new Array(requests.length);
     for (const row of rows) {
       const index = Number(row.index);
-      results[index] = recoverableJobRowFailed(row) ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      results[index] = recoverableJobRowFailed(row) ? batchItemFailure(index, row.error || row.message || "Signal to Copy failed", row) : { index, success: true, data: normalizeSignalToCopyResult(row) };
     }
     return results;
   }
@@ -705,9 +709,10 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
-  async runSignalCopyBatchChunk(requests, concurrency) {
+  async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const startedAt = Date.now();
     const results = new Array(requests.length);
+    const rateLimited = [];
     let pending = requests.map((params, index) => ({
       index,
       params,
@@ -727,7 +732,19 @@ var Signaliz = class {
         const task = pending[index];
         const item = data.results[index];
         if (item.success === false) {
-          results[task.index] = { index: task.index, success: false, error: item.error || item.message || "Signal to Copy failed" };
+          if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
+            index: task.index,
+            success: false,
+            raw: item
+          })) {
+            rateLimited.push({ index: task.index, params: task.params, raw: item });
+            continue;
+          }
+          results[task.index] = batchItemFailure(
+            task.index,
+            item.error || item.message || "Signal to Copy failed",
+            item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item)) {
@@ -765,6 +782,21 @@ var Signaliz = class {
       pending = nextPending;
       if (pending.length > 0) await sleep2(nextDelayMs);
     }
+    if (rateLimited.length > 0) {
+      await sleep2(rowRateLimitDelayMs(rateLimited.map((item) => ({
+        index: item.index,
+        success: false,
+        raw: item.raw
+      }))));
+      const retried = await this.runSignalCopyBatchChunk(
+        rateLimited.map((item) => item.params),
+        concurrency,
+        rowRateLimitAttempt + 1
+      );
+      for (let index = 0; index < rateLimited.length; index += 1) {
+        results[rateLimited[index].index] = { ...retried[index], index: rateLimited[index].index };
+      }
+    }
     return results;
   }
   async runCoreBatchRound(path, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
@@ -817,7 +849,10 @@ var Signaliz = class {
           uniqueResults[chunk.offset + index] = {
             index: chunk.tasks[index].index,
             success: false,
-            error: chunkResult.error || `${path} batch request failed`
+            error: chunkResult.error || `${path} batch request failed`,
+            errorCode: chunkResult.errorCode,
+            retryEligible: chunkResult.retryEligible,
+            retryAfterSeconds: chunkResult.retryAfterSeconds
           };
         }
         continue;
@@ -883,6 +918,21 @@ function rowRateLimitDelayMs(items) {
   });
   return Math.max(1, Math.min(6e4, Math.max(...delays)));
 }
+function batchItemFailure(index, error, raw) {
+  const errorCode = String(raw?.error_code ?? raw?.code ?? raw?.errorCode ?? "").trim();
+  const retryAfterSeconds2 = Number(
+    raw?.retry_after_seconds ?? raw?.retry_after ?? raw?.retryAfterSeconds ?? (Number.isFinite(Number(raw?.retry_after_ms)) ? Number(raw?.retry_after_ms) / 1e3 : void 0)
+  );
+  const retryEligible = raw?.retry_eligible ?? raw?.retryEligible;
+  return {
+    index,
+    success: false,
+    error,
+    ...errorCode ? { errorCode } : {},
+    ...typeof retryEligible === "boolean" ? { retryEligible } : {},
+    ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {}
+  };
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1093,7 +1143,11 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = { index: item.index, success: false, error: item.error || "Signaliz batch item failed" };
+      results[item.index] = batchItemFailure(
+        item.index,
+        item.error || "Signaliz batch item failed",
+        item.raw ?? item
+      );
       continue;
     }
     try {
@@ -1221,11 +1275,15 @@ async function runBatch(items, execute, options) {
       try {
         results[index] = { index, success: true, data: await execute(items[index]) };
       } catch (error) {
-        results[index] = {
+        results[index] = batchItemFailure(
           index,
-          success: false,
-          error: error instanceof Error ? error.message : String(error)
-        };
+          error instanceof Error ? error.message : String(error),
+          error instanceof SignalizError ? {
+            error_code: error.code,
+            retry_eligible: error.isRetryable,
+            retry_after_seconds: error.retryAfter
+          } : void 0
+        );
       }
     }
   };

package/dist/index.d.mts

@@ -19,6 +19,12 @@ interface BatchItemResult<T> {
     success: boolean;
     data?: T;
     error?: string;
+    /** Stable public error code for a failed row. */
+    errorCode?: string;
+    /** Whether retrying the failed row is safe. */
+    retryEligible?: boolean;
+    /** Server-provided delay before retrying the failed row. */
+    retryAfterSeconds?: number;
     /** Zero-based input index containing the full result for this exact duplicate. */
     duplicateOf?: number;
 }

package/dist/index.d.ts

@@ -19,6 +19,12 @@ interface BatchItemResult<T> {
     success: boolean;
     data?: T;
     error?: string;
+    /** Stable public error code for a failed row. */
+    errorCode?: string;
+    /** Whether retrying the failed row is safe. */
+    retryEligible?: boolean;
+    /** Server-provided delay before retrying the failed row. */
+    retryAfterSeconds?: number;
     /** Zero-based input index containing the full result for this exact duplicate. */
     duplicateOf?: number;
 }

package/dist/index.js

@@ -523,7 +523,11 @@ var Signaliz = class {
         const params = companies[item.index];
         const task = taskByIndex.get(item.index);
         if (!item.success || !item.raw) {
-          results[item.index] = { index: item.index, success: false, error: item.error || "Company Signal batch request failed" };
+          results[item.index] = batchItemFailure(
+            item.index,
+            item.error || "Company Signal batch request failed",
+            item.raw ?? item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item.raw) || params.waitForResult === false) {
@@ -632,11 +636,11 @@ var Signaliz = class {
       const chunk = chunks[chunkResult.index];
       if (!chunkResult.success || !chunkResult.data) {
         for (let index = 0; index < chunk.requests.length; index += 1) {
-          uniqueResults[chunk.offset + index] = {
-            index: chunk.offset + index,
-            success: false,
-            error: chunkResult.error || "Signal to Copy batch request failed"
-          };
+          uniqueResults[chunk.offset + index] = batchItemFailure(
+            chunk.offset + index,
+            chunkResult.error || "Signal to Copy batch request failed",
+            chunkResult
+          );
         }
         continue;
       }
@@ -658,7 +662,7 @@ var Signaliz = class {
     const results = new Array(requests.length);
     for (const row of rows) {
       const index = Number(row.index);
-      results[index] = recoverableJobRowFailed(row) ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      results[index] = recoverableJobRowFailed(row) ? batchItemFailure(index, row.error || row.message || "Signal to Copy failed", row) : { index, success: true, data: normalizeSignalToCopyResult(row) };
     }
     return results;
   }
@@ -732,9 +736,10 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
-  async runSignalCopyBatchChunk(requests, concurrency) {
+  async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const startedAt = Date.now();
     const results = new Array(requests.length);
+    const rateLimited = [];
     let pending = requests.map((params, index) => ({
       index,
       params,
@@ -754,7 +759,19 @@ var Signaliz = class {
         const task = pending[index];
         const item = data.results[index];
         if (item.success === false) {
-          results[task.index] = { index: task.index, success: false, error: item.error || item.message || "Signal to Copy failed" };
+          if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
+            index: task.index,
+            success: false,
+            raw: item
+          })) {
+            rateLimited.push({ index: task.index, params: task.params, raw: item });
+            continue;
+          }
+          results[task.index] = batchItemFailure(
+            task.index,
+            item.error || item.message || "Signal to Copy failed",
+            item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item)) {
@@ -792,6 +809,21 @@ var Signaliz = class {
       pending = nextPending;
       if (pending.length > 0) await sleep2(nextDelayMs);
     }
+    if (rateLimited.length > 0) {
+      await sleep2(rowRateLimitDelayMs(rateLimited.map((item) => ({
+        index: item.index,
+        success: false,
+        raw: item.raw
+      }))));
+      const retried = await this.runSignalCopyBatchChunk(
+        rateLimited.map((item) => item.params),
+        concurrency,
+        rowRateLimitAttempt + 1
+      );
+      for (let index = 0; index < rateLimited.length; index += 1) {
+        results[rateLimited[index].index] = { ...retried[index], index: rateLimited[index].index };
+      }
+    }
     return results;
   }
   async runCoreBatchRound(path, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
@@ -844,7 +876,10 @@ var Signaliz = class {
           uniqueResults[chunk.offset + index] = {
             index: chunk.tasks[index].index,
             success: false,
-            error: chunkResult.error || `${path} batch request failed`
+            error: chunkResult.error || `${path} batch request failed`,
+            errorCode: chunkResult.errorCode,
+            retryEligible: chunkResult.retryEligible,
+            retryAfterSeconds: chunkResult.retryAfterSeconds
           };
         }
         continue;
@@ -910,6 +945,21 @@ function rowRateLimitDelayMs(items) {
   });
   return Math.max(1, Math.min(6e4, Math.max(...delays)));
 }
+function batchItemFailure(index, error, raw) {
+  const errorCode = String(raw?.error_code ?? raw?.code ?? raw?.errorCode ?? "").trim();
+  const retryAfterSeconds2 = Number(
+    raw?.retry_after_seconds ?? raw?.retry_after ?? raw?.retryAfterSeconds ?? (Number.isFinite(Number(raw?.retry_after_ms)) ? Number(raw?.retry_after_ms) / 1e3 : void 0)
+  );
+  const retryEligible = raw?.retry_eligible ?? raw?.retryEligible;
+  return {
+    index,
+    success: false,
+    error,
+    ...errorCode ? { errorCode } : {},
+    ...typeof retryEligible === "boolean" ? { retryEligible } : {},
+    ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {}
+  };
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1120,7 +1170,11 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = { index: item.index, success: false, error: item.error || "Signaliz batch item failed" };
+      results[item.index] = batchItemFailure(
+        item.index,
+        item.error || "Signaliz batch item failed",
+        item.raw ?? item
+      );
       continue;
     }
     try {
@@ -1248,11 +1302,15 @@ async function runBatch(items, execute, options) {
       try {
         results[index] = { index, success: true, data: await execute(items[index]) };
       } catch (error) {
-        results[index] = {
+        results[index] = batchItemFailure(
           index,
-          success: false,
-          error: error instanceof Error ? error.message : String(error)
-        };
+          error instanceof Error ? error.message : String(error),
+          error instanceof SignalizError ? {
+            error_code: error.code,
+            retry_eligible: error.isRetryable,
+            retry_after_seconds: error.retryAfter
+          } : void 0
+        );
       }
     }
   };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   Signaliz,
   SignalizError
-} from "./chunk-Q4T2GUXD.mjs";
+} from "./chunk-4LXMT3S5.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -527,7 +527,11 @@ var Signaliz = class {
         const params = companies[item.index];
         const task = taskByIndex.get(item.index);
         if (!item.success || !item.raw) {
-          results[item.index] = { index: item.index, success: false, error: item.error || "Company Signal batch request failed" };
+          results[item.index] = batchItemFailure(
+            item.index,
+            item.error || "Company Signal batch request failed",
+            item.raw ?? item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item.raw) || params.waitForResult === false) {
@@ -636,11 +640,11 @@ var Signaliz = class {
       const chunk = chunks[chunkResult.index];
       if (!chunkResult.success || !chunkResult.data) {
         for (let index = 0; index < chunk.requests.length; index += 1) {
-          uniqueResults[chunk.offset + index] = {
-            index: chunk.offset + index,
-            success: false,
-            error: chunkResult.error || "Signal to Copy batch request failed"
-          };
+          uniqueResults[chunk.offset + index] = batchItemFailure(
+            chunk.offset + index,
+            chunkResult.error || "Signal to Copy batch request failed",
+            chunkResult
+          );
         }
         continue;
       }
@@ -662,7 +666,7 @@ var Signaliz = class {
     const results = new Array(requests.length);
     for (const row of rows) {
       const index = Number(row.index);
-      results[index] = recoverableJobRowFailed(row) ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      results[index] = recoverableJobRowFailed(row) ? batchItemFailure(index, row.error || row.message || "Signal to Copy failed", row) : { index, success: true, data: normalizeSignalToCopyResult(row) };
     }
     return results;
   }
@@ -736,9 +740,10 @@ var Signaliz = class {
     if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
     return rows;
   }
-  async runSignalCopyBatchChunk(requests, concurrency) {
+  async runSignalCopyBatchChunk(requests, concurrency, rowRateLimitAttempt = 0) {
     const startedAt = Date.now();
     const results = new Array(requests.length);
+    const rateLimited = [];
     let pending = requests.map((params, index) => ({
       index,
       params,
@@ -758,7 +763,19 @@ var Signaliz = class {
         const task = pending[index];
         const item = data.results[index];
         if (item.success === false) {
-          results[task.index] = { index: task.index, success: false, error: item.error || item.message || "Signal to Copy failed" };
+          if (rowRateLimitAttempt < MAX_ROW_RATE_LIMIT_RETRIES && isRetryableRowRateLimit({
+            index: task.index,
+            success: false,
+            raw: item
+          })) {
+            rateLimited.push({ index: task.index, params: task.params, raw: item });
+            continue;
+          }
+          results[task.index] = batchItemFailure(
+            task.index,
+            item.error || item.message || "Signal to Copy failed",
+            item
+          );
           continue;
         }
         if (!isPendingSignalResponse(item)) {
@@ -796,6 +813,21 @@ var Signaliz = class {
       pending = nextPending;
       if (pending.length > 0) await sleep2(nextDelayMs);
     }
+    if (rateLimited.length > 0) {
+      await sleep2(rowRateLimitDelayMs(rateLimited.map((item) => ({
+        index: item.index,
+        success: false,
+        raw: item.raw
+      }))));
+      const retried = await this.runSignalCopyBatchChunk(
+        rateLimited.map((item) => item.params),
+        concurrency,
+        rowRateLimitAttempt + 1
+      );
+      for (let index = 0; index < rateLimited.length; index += 1) {
+        results[rateLimited[index].index] = { ...retried[index], index: rateLimited[index].index };
+      }
+    }
     return results;
   }
   async runCoreBatchRound(path2, tasks, options, companyRecoverableBatch, rowRateLimitAttempt = 0) {
@@ -848,7 +880,10 @@ var Signaliz = class {
           uniqueResults[chunk.offset + index] = {
             index: chunk.tasks[index].index,
             success: false,
-            error: chunkResult.error || `${path2} batch request failed`
+            error: chunkResult.error || `${path2} batch request failed`,
+            errorCode: chunkResult.errorCode,
+            retryEligible: chunkResult.retryEligible,
+            retryAfterSeconds: chunkResult.retryAfterSeconds
           };
         }
         continue;
@@ -914,6 +949,21 @@ function rowRateLimitDelayMs(items) {
   });
   return Math.max(1, Math.min(6e4, Math.max(...delays)));
 }
+function batchItemFailure(index, error, raw) {
+  const errorCode = String(raw?.error_code ?? raw?.code ?? raw?.errorCode ?? "").trim();
+  const retryAfterSeconds2 = Number(
+    raw?.retry_after_seconds ?? raw?.retry_after ?? raw?.retryAfterSeconds ?? (Number.isFinite(Number(raw?.retry_after_ms)) ? Number(raw?.retry_after_ms) / 1e3 : void 0)
+  );
+  const retryEligible = raw?.retry_eligible ?? raw?.retryEligible;
+  return {
+    index,
+    success: false,
+    error,
+    ...errorCode ? { errorCode } : {},
+    ...typeof retryEligible === "boolean" ? { retryEligible } : {},
+    ...Number.isFinite(retryAfterSeconds2) && retryAfterSeconds2 >= 0 ? { retryAfterSeconds: retryAfterSeconds2 } : {}
+  };
+}
 function recoverableJobRowFailed(row) {
   return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
 }
@@ -1124,7 +1174,11 @@ function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
-      results[item.index] = { index: item.index, success: false, error: item.error || "Signaliz batch item failed" };
+      results[item.index] = batchItemFailure(
+        item.index,
+        item.error || "Signaliz batch item failed",
+        item.raw ?? item
+      );
       continue;
     }
     try {
@@ -1252,11 +1306,15 @@ async function runBatch(items, execute, options) {
       try {
         results[index] = { index, success: true, data: await execute(items[index]) };
       } catch (error) {
-        results[index] = {
+        results[index] = batchItemFailure(
           index,
-          success: false,
-          error: error instanceof Error ? error.message : String(error)
-        };
+          error instanceof Error ? error.message : String(error),
+          error instanceof SignalizError ? {
+            error_code: error.code,
+            retry_eligible: error.isRetryable,
+            retry_after_seconds: error.retryAfter
+          } : void 0
+        );
       }
     }
   };

package/dist/mcp-config.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Signaliz
-} from "./chunk-Q4T2GUXD.mjs";
+} from "./chunk-4LXMT3S5.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.44",
+  "version": "1.0.46",
   "description": "Signaliz SDK for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",