@signaliz/sdk 1.0.32 → 1.0.34

package/README.md

@@ -78,11 +78,12 @@ callers never need an internal Trigger.dev status URL. The SDK follows the
 server's adaptive polling hints by default and still honors `pollIntervalMs`
 when a caller explicitly overrides the cadence.
 Exact duplicate tasks are single-flighted across each full batch without
-changing input order or result cardinality. Find Email, Verify Email, and
-Company Signal Enrichment use 25-row REST chunks. Signal to Copy batches larger
-than 25 use one recoverable REST job when they can reuse available signal data;
-fresh or deep-search requests keep the 25-row path. Signal to Copy also shares
-company research across copy recipients.
+changing input order or result cardinality. Find Email and Verify Email batches
+larger than 25 use one cache-aware recoverable REST job with 500-row result
+pages; Company Signal Enrichment uses 25-row REST chunks. Signal to Copy batches
+larger than 25 use one recoverable REST job when they can reuse available signal
+data; fresh or deep-search requests keep the 25-row path. Signal to Copy also
+shares company research across copy recipients.
 
 Company Signal Enrichment defaults `online` and `enableDeepSearch` to `true`
 unless the caller explicitly disables them. Signal to Copy AI returns three

package/dist/{chunk-JO4MYKSK.mjs → chunk-BGVNI5E2.mjs}

@@ -566,20 +566,39 @@ var Signaliz = class {
     return uniqueResults;
   }
   async runAvailableSignalCopyBatchJob(requests) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy"
+    );
+    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) };
+    }
+    return results;
+  }
+  async runRecoverableCoreBatchJob(path, requests, label) {
     const startedAt = Date.now();
     const maxWaitMs = 20 * 6e4;
-    let status = await this.client.post("api/v1/signal-to-copy", {
-      requests: requests.map(signalToCopyRequestBody)
+    const submission = await this.client.post(path, {
+      requests,
+      idempotency_key: newBatchIdempotencyKey(label)
+    });
+    const jobId = String(submission.job_id || "").trim();
+    if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
+    let status = await this.client.post(path, {
+      job_id: jobId,
+      page: 1,
+      page_size: 500
     });
-    const jobId = String(status.job_id || "").trim();
-    if (!jobId) throw new Error("Signal to Copy batch did not return a recoverable job_id");
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
-        throw new Error(`Signal to Copy batch ${jobId} did not complete within ${maxWaitMs}ms`);
+        throw new Error(`${label} batch ${jobId} did not complete within ${maxWaitMs}ms`);
       }
       const retryAfterMs = Number(status.next_poll_after_seconds || 2) * 1e3;
       await sleep2(Math.min(Math.max(250, retryAfterMs), maxWaitMs - (Date.now() - startedAt)));
-      status = await this.client.post("api/v1/signal-to-copy", {
+      status = await this.client.post(path, {
         job_id: jobId,
         page: 1,
         page_size: 500
@@ -590,7 +609,7 @@ var Signaliz = class {
     if (totalPages > 1) {
       const remainingPages = await Promise.all(Array.from(
         { length: totalPages - 1 },
-        (_, index) => this.client.post("api/v1/signal-to-copy", {
+        (_, index) => this.client.post(path, {
           job_id: jobId,
           page: index + 2,
           page_size: 500
@@ -600,18 +619,18 @@ var Signaliz = class {
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
-      throw new Error(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
     }
-    const results = new Array(requests.length);
+    const seen = /* @__PURE__ */ new Set();
     for (const row of rows) {
       const index = Number(row.index);
-      if (!Number.isInteger(index) || index < 0 || index >= requests.length) {
-        throw new Error("Signal to Copy batch returned an invalid result index");
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
       }
-      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      seen.add(index);
     }
-    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
-    return results;
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -679,6 +698,24 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
+    if ((path === "api/v1/find-email" || path === "api/v1/verify-email") && uniqueTasks.length > 25) {
+      const label = path === "api/v1/find-email" ? "Find Email" : "Verify Email";
+      const rows = await this.runRecoverableCoreBatchJob(
+        path,
+        uniqueTasks.map((task) => task.request),
+        label
+      );
+      const uniqueResults2 = rows.map((raw) => ({
+        index: uniqueTasks[Number(raw.index)].index,
+        success: !recoverableJobRowFailed(raw),
+        raw,
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${label} item failed` : void 0
+      }));
+      return tasks.map((task, index) => ({
+        ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
+        index: task.index
+      }));
+    }
     const chunks = [];
     for (let offset = 0; offset < uniqueTasks.length; offset += 25) {
       chunks.push({ offset, tasks: uniqueTasks.slice(offset, offset + 25) });
@@ -736,6 +773,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+}
+function newBatchIdempotencyKey(label) {
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return `signaliz-${label.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-${nonce}`;
+}
 function compact(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
 }

package/dist/index.d.mts

@@ -205,6 +205,7 @@ declare class Signaliz {
     createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise<BatchResult<SignalToCopyResult>>;
     private runSignalCopyBatchChunks;
     private runAvailableSignalCopyBatchJob;
+    private runRecoverableCoreBatchJob;
     private runSignalCopyBatchChunk;
     private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;

package/dist/index.d.ts

@@ -205,6 +205,7 @@ declare class Signaliz {
     createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise<BatchResult<SignalToCopyResult>>;
     private runSignalCopyBatchChunks;
     private runAvailableSignalCopyBatchJob;
+    private runRecoverableCoreBatchJob;
     private runSignalCopyBatchChunk;
     private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;

package/dist/index.js

@@ -593,20 +593,39 @@ var Signaliz = class {
     return uniqueResults;
   }
   async runAvailableSignalCopyBatchJob(requests) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy"
+    );
+    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) };
+    }
+    return results;
+  }
+  async runRecoverableCoreBatchJob(path, requests, label) {
     const startedAt = Date.now();
     const maxWaitMs = 20 * 6e4;
-    let status = await this.client.post("api/v1/signal-to-copy", {
-      requests: requests.map(signalToCopyRequestBody)
+    const submission = await this.client.post(path, {
+      requests,
+      idempotency_key: newBatchIdempotencyKey(label)
+    });
+    const jobId = String(submission.job_id || "").trim();
+    if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
+    let status = await this.client.post(path, {
+      job_id: jobId,
+      page: 1,
+      page_size: 500
     });
-    const jobId = String(status.job_id || "").trim();
-    if (!jobId) throw new Error("Signal to Copy batch did not return a recoverable job_id");
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
-        throw new Error(`Signal to Copy batch ${jobId} did not complete within ${maxWaitMs}ms`);
+        throw new Error(`${label} batch ${jobId} did not complete within ${maxWaitMs}ms`);
       }
       const retryAfterMs = Number(status.next_poll_after_seconds || 2) * 1e3;
       await sleep2(Math.min(Math.max(250, retryAfterMs), maxWaitMs - (Date.now() - startedAt)));
-      status = await this.client.post("api/v1/signal-to-copy", {
+      status = await this.client.post(path, {
         job_id: jobId,
         page: 1,
         page_size: 500
@@ -617,7 +636,7 @@ var Signaliz = class {
     if (totalPages > 1) {
       const remainingPages = await Promise.all(Array.from(
         { length: totalPages - 1 },
-        (_, index) => this.client.post("api/v1/signal-to-copy", {
+        (_, index) => this.client.post(path, {
           job_id: jobId,
           page: index + 2,
           page_size: 500
@@ -627,18 +646,18 @@ var Signaliz = class {
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
-      throw new Error(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
     }
-    const results = new Array(requests.length);
+    const seen = /* @__PURE__ */ new Set();
     for (const row of rows) {
       const index = Number(row.index);
-      if (!Number.isInteger(index) || index < 0 || index >= requests.length) {
-        throw new Error("Signal to Copy batch returned an invalid result index");
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
       }
-      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      seen.add(index);
     }
-    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
-    return results;
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -706,6 +725,24 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
+    if ((path === "api/v1/find-email" || path === "api/v1/verify-email") && uniqueTasks.length > 25) {
+      const label = path === "api/v1/find-email" ? "Find Email" : "Verify Email";
+      const rows = await this.runRecoverableCoreBatchJob(
+        path,
+        uniqueTasks.map((task) => task.request),
+        label
+      );
+      const uniqueResults2 = rows.map((raw) => ({
+        index: uniqueTasks[Number(raw.index)].index,
+        success: !recoverableJobRowFailed(raw),
+        raw,
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${label} item failed` : void 0
+      }));
+      return tasks.map((task, index) => ({
+        ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
+        index: task.index
+      }));
+    }
     const chunks = [];
     for (let offset = 0; offset < uniqueTasks.length; offset += 25) {
       chunks.push({ offset, tasks: uniqueTasks.slice(offset, offset + 25) });
@@ -763,6 +800,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+}
+function newBatchIdempotencyKey(label) {
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return `signaliz-${label.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-${nonce}`;
+}
 function compact(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
 }

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   Signaliz,
   SignalizError
-} from "./chunk-JO4MYKSK.mjs";
+} from "./chunk-BGVNI5E2.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -597,20 +597,39 @@ var Signaliz = class {
     return uniqueResults;
   }
   async runAvailableSignalCopyBatchJob(requests) {
+    const rows = await this.runRecoverableCoreBatchJob(
+      "api/v1/signal-to-copy",
+      requests.map(signalToCopyRequestBody),
+      "Signal to Copy"
+    );
+    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) };
+    }
+    return results;
+  }
+  async runRecoverableCoreBatchJob(path2, requests, label) {
     const startedAt = Date.now();
     const maxWaitMs = 20 * 6e4;
-    let status = await this.client.post("api/v1/signal-to-copy", {
-      requests: requests.map(signalToCopyRequestBody)
+    const submission = await this.client.post(path2, {
+      requests,
+      idempotency_key: newBatchIdempotencyKey(label)
+    });
+    const jobId = String(submission.job_id || "").trim();
+    if (!jobId) throw new Error(`${label} batch did not return a recoverable job_id`);
+    let status = await this.client.post(path2, {
+      job_id: jobId,
+      page: 1,
+      page_size: 500
     });
-    const jobId = String(status.job_id || "").trim();
-    if (!jobId) throw new Error("Signal to Copy batch did not return a recoverable job_id");
     while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
       if (Date.now() - startedAt >= maxWaitMs) {
-        throw new Error(`Signal to Copy batch ${jobId} did not complete within ${maxWaitMs}ms`);
+        throw new Error(`${label} batch ${jobId} did not complete within ${maxWaitMs}ms`);
       }
       const retryAfterMs = Number(status.next_poll_after_seconds || 2) * 1e3;
       await sleep2(Math.min(Math.max(250, retryAfterMs), maxWaitMs - (Date.now() - startedAt)));
-      status = await this.client.post("api/v1/signal-to-copy", {
+      status = await this.client.post(path2, {
         job_id: jobId,
         page: 1,
         page_size: 500
@@ -621,7 +640,7 @@ var Signaliz = class {
     if (totalPages > 1) {
       const remainingPages = await Promise.all(Array.from(
         { length: totalPages - 1 },
-        (_, index) => this.client.post("api/v1/signal-to-copy", {
+        (_, index) => this.client.post(path2, {
           job_id: jobId,
           page: index + 2,
           page_size: 500
@@ -631,18 +650,18 @@ var Signaliz = class {
     }
     const rows = pages.flat();
     if (rows.length !== requests.length) {
-      throw new Error(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
     }
-    const results = new Array(requests.length);
+    const seen = /* @__PURE__ */ new Set();
     for (const row of rows) {
       const index = Number(row.index);
-      if (!Number.isInteger(index) || index < 0 || index >= requests.length) {
-        throw new Error("Signal to Copy batch returned an invalid result index");
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
       }
-      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+      seen.add(index);
     }
-    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
-    return results;
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -710,6 +729,24 @@ var Signaliz = class {
     const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
     const uniqueTasks = deduplicated.uniqueItems;
+    if ((path2 === "api/v1/find-email" || path2 === "api/v1/verify-email") && uniqueTasks.length > 25) {
+      const label = path2 === "api/v1/find-email" ? "Find Email" : "Verify Email";
+      const rows = await this.runRecoverableCoreBatchJob(
+        path2,
+        uniqueTasks.map((task) => task.request),
+        label
+      );
+      const uniqueResults2 = rows.map((raw) => ({
+        index: uniqueTasks[Number(raw.index)].index,
+        success: !recoverableJobRowFailed(raw),
+        raw,
+        error: recoverableJobRowFailed(raw) ? raw.error || raw._error || raw.message || raw.failure_reason || `${label} item failed` : void 0
+      }));
+      return tasks.map((task, index) => ({
+        ...uniqueResults2[deduplicated.sourceIndexByInput[index]],
+        index: task.index
+      }));
+    }
     const chunks = [];
     for (let offset = 0; offset < uniqueTasks.length; offset += 25) {
       chunks.push({ offset, tasks: uniqueTasks.slice(offset, offset + 25) });
@@ -767,6 +804,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || ["failed", "skipped"].includes(String(row._status || "").toLowerCase());
+}
+function newBatchIdempotencyKey(label) {
+  const nonce = globalThis.crypto?.randomUUID?.() || `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+  return `signaliz-${label.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-${nonce}`;
+}
 function compact(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
 }

package/dist/mcp-config.mjs

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

package/package.json

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