@signaliz/sdk 1.0.31 → 1.0.33

package/README.md

@@ -77,10 +77,13 @@ resumes long-running research through the same `/company-signals` endpoint;
 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.
-All four products are transported in 25-row REST chunks. Exact duplicate tasks
-are single-flighted across the full batch before chunking, without changing
-input order or result cardinality. Signal to Copy also shares company research
-across copy recipients.
+Exact duplicate tasks are single-flighted across each full batch without
+changing input order or result cardinality. Verify Email batches larger than 25
+use one cache-aware recoverable REST job with 500-row result pages; Find 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.
 
 Company Signal Enrichment defaults `online` and `enableDeepSearch` to `true`
 unless the caller explicitly disables them. Signal to Copy AI returns three

package/dist/{chunk-P3ICLKAE.mjs → chunk-H6HOY73X.mjs}

@@ -518,6 +518,24 @@ var Signaliz = class {
       poll_interval_ms: params.pollIntervalMs
     }));
     const uniqueRequests = deduplicated.uniqueItems;
+    const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
+      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+    );
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const results = requests.map((_, index) => ({
+      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
+      index
+    }));
+    const succeeded = results.filter((item) => item.success).length;
+    return {
+      total: requests.length,
+      succeeded,
+      failed: requests.length - succeeded,
+      durationMs: Date.now() - startedAt,
+      results
+    };
+  }
+  async runSignalCopyBatchChunks(uniqueRequests, options) {
     const chunks = [];
     for (let offset = 0; offset < uniqueRequests.length; offset += 25) {
       chunks.push({ offset, requests: uniqueRequests.slice(offset, offset + 25) });
@@ -545,18 +563,74 @@ var Signaliz = class {
         uniqueResults[chunk.offset + item.index] = { ...item, index: chunk.offset + item.index };
       }
     }
-    const results = requests.map((_, index) => ({
-      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
-      index
-    }));
-    const succeeded = results.filter((item) => item.success).length;
-    return {
-      total: requests.length,
-      succeeded,
-      failed: requests.length - succeeded,
-      durationMs: Date.now() - startedAt,
-      results
-    };
+    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;
+    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
+    });
+    while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
+      if (Date.now() - startedAt >= maxWaitMs) {
+        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(path, {
+        job_id: jobId,
+        page: 1,
+        page_size: 500
+      });
+    }
+    const totalPages = Math.max(1, Number(status.total_pages || 1));
+    const pages = [Array.isArray(status.results) ? status.results : []];
+    if (totalPages > 1) {
+      const remainingPages = await Promise.all(Array.from(
+        { length: totalPages - 1 },
+        (_, index) => this.client.post(path, {
+          job_id: jobId,
+          page: index + 2,
+          page_size: 500
+        })
+      ));
+      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+    }
+    const rows = pages.flat();
+    if (rows.length !== requests.length) {
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
+      }
+      seen.add(index);
+    }
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -624,6 +698,23 @@ 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/verify-email" && uniqueTasks.length > 25) {
+      const rows = await this.runRecoverableCoreBatchJob(
+        path,
+        uniqueTasks.map((task) => task.request),
+        "Verify Email"
+      );
+      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 || "Verify Email 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) });
@@ -681,6 +772,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+}
+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

@@ -203,6 +203,9 @@ declare class Signaliz {
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise<BatchResult<CompanySignalEnrichmentResult>>;
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
     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

@@ -203,6 +203,9 @@ declare class Signaliz {
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise<BatchResult<CompanySignalEnrichmentResult>>;
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
     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

@@ -545,6 +545,24 @@ var Signaliz = class {
       poll_interval_ms: params.pollIntervalMs
     }));
     const uniqueRequests = deduplicated.uniqueItems;
+    const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
+      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+    );
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const results = requests.map((_, index) => ({
+      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
+      index
+    }));
+    const succeeded = results.filter((item) => item.success).length;
+    return {
+      total: requests.length,
+      succeeded,
+      failed: requests.length - succeeded,
+      durationMs: Date.now() - startedAt,
+      results
+    };
+  }
+  async runSignalCopyBatchChunks(uniqueRequests, options) {
     const chunks = [];
     for (let offset = 0; offset < uniqueRequests.length; offset += 25) {
       chunks.push({ offset, requests: uniqueRequests.slice(offset, offset + 25) });
@@ -572,18 +590,74 @@ var Signaliz = class {
         uniqueResults[chunk.offset + item.index] = { ...item, index: chunk.offset + item.index };
       }
     }
-    const results = requests.map((_, index) => ({
-      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
-      index
-    }));
-    const succeeded = results.filter((item) => item.success).length;
-    return {
-      total: requests.length,
-      succeeded,
-      failed: requests.length - succeeded,
-      durationMs: Date.now() - startedAt,
-      results
-    };
+    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;
+    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
+    });
+    while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
+      if (Date.now() - startedAt >= maxWaitMs) {
+        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(path, {
+        job_id: jobId,
+        page: 1,
+        page_size: 500
+      });
+    }
+    const totalPages = Math.max(1, Number(status.total_pages || 1));
+    const pages = [Array.isArray(status.results) ? status.results : []];
+    if (totalPages > 1) {
+      const remainingPages = await Promise.all(Array.from(
+        { length: totalPages - 1 },
+        (_, index) => this.client.post(path, {
+          job_id: jobId,
+          page: index + 2,
+          page_size: 500
+        })
+      ));
+      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+    }
+    const rows = pages.flat();
+    if (rows.length !== requests.length) {
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
+      }
+      seen.add(index);
+    }
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -651,6 +725,23 @@ 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/verify-email" && uniqueTasks.length > 25) {
+      const rows = await this.runRecoverableCoreBatchJob(
+        path,
+        uniqueTasks.map((task) => task.request),
+        "Verify Email"
+      );
+      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 || "Verify Email 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) });
@@ -708,6 +799,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+}
+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-P3ICLKAE.mjs";
+} from "./chunk-H6HOY73X.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -549,6 +549,24 @@ var Signaliz = class {
       poll_interval_ms: params.pollIntervalMs
     }));
     const uniqueRequests = deduplicated.uniqueItems;
+    const canUseRecoverableAvailableDataJob = uniqueRequests.length > 25 && uniqueRequests.every(
+      (params) => params.waitForResult !== false && params.skipCache !== true && params.enableDeepSearch !== true && params.maxWaitMs === void 0 && params.pollIntervalMs === void 0
+    );
+    const uniqueResults = canUseRecoverableAvailableDataJob ? await this.runAvailableSignalCopyBatchJob(uniqueRequests) : await this.runSignalCopyBatchChunks(uniqueRequests, options);
+    const results = requests.map((_, index) => ({
+      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
+      index
+    }));
+    const succeeded = results.filter((item) => item.success).length;
+    return {
+      total: requests.length,
+      succeeded,
+      failed: requests.length - succeeded,
+      durationMs: Date.now() - startedAt,
+      results
+    };
+  }
+  async runSignalCopyBatchChunks(uniqueRequests, options) {
     const chunks = [];
     for (let offset = 0; offset < uniqueRequests.length; offset += 25) {
       chunks.push({ offset, requests: uniqueRequests.slice(offset, offset + 25) });
@@ -576,18 +594,74 @@ var Signaliz = class {
         uniqueResults[chunk.offset + item.index] = { ...item, index: chunk.offset + item.index };
       }
     }
-    const results = requests.map((_, index) => ({
-      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
-      index
-    }));
-    const succeeded = results.filter((item) => item.success).length;
-    return {
-      total: requests.length,
-      succeeded,
-      failed: requests.length - succeeded,
-      durationMs: Date.now() - startedAt,
-      results
-    };
+    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;
+    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
+    });
+    while (!["completed", "partial", "failed"].includes(String(status.status || "").toLowerCase())) {
+      if (Date.now() - startedAt >= maxWaitMs) {
+        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(path2, {
+        job_id: jobId,
+        page: 1,
+        page_size: 500
+      });
+    }
+    const totalPages = Math.max(1, Number(status.total_pages || 1));
+    const pages = [Array.isArray(status.results) ? status.results : []];
+    if (totalPages > 1) {
+      const remainingPages = await Promise.all(Array.from(
+        { length: totalPages - 1 },
+        (_, index) => this.client.post(path2, {
+          job_id: jobId,
+          page: index + 2,
+          page_size: 500
+        })
+      ));
+      for (const page of remainingPages) pages.push(Array.isArray(page.results) ? page.results : []);
+    }
+    const rows = pages.flat();
+    if (rows.length !== requests.length) {
+      throw new Error(`${label} batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const row of rows) {
+      const index = Number(row.index);
+      if (!Number.isInteger(index) || index < 0 || index >= requests.length || seen.has(index)) {
+        throw new Error(`${label} batch returned an invalid result index`);
+      }
+      seen.add(index);
+    }
+    if (seen.size !== requests.length) throw new Error(`${label} batch returned incomplete indexed results`);
+    return rows;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();
@@ -655,6 +729,23 @@ 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/verify-email" && uniqueTasks.length > 25) {
+      const rows = await this.runRecoverableCoreBatchJob(
+        path2,
+        uniqueTasks.map((task) => task.request),
+        "Verify Email"
+      );
+      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 || "Verify Email 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) });
@@ -712,6 +803,13 @@ var Signaliz = class {
     };
   }
 };
+function recoverableJobRowFailed(row) {
+  return row.success === false || String(row._status || "").toLowerCase() === "failed";
+}
+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-P3ICLKAE.mjs";
+} from "./chunk-H6HOY73X.mjs";
 
 // src/mcp-config.ts
 import * as fs from "fs";

package/package.json

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