@signaliz/sdk 1.0.31 → 1.0.32

package/README.md

@@ -77,10 +77,12 @@ 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. 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.
 
 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-JO4MYKSK.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,55 @@ 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 startedAt = Date.now();
+    const maxWaitMs = 20 * 6e4;
+    let status = await this.client.post("api/v1/signal-to-copy", {
+      requests: requests.map(signalToCopyRequestBody)
+    });
+    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`);
+      }
+      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", {
+        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("api/v1/signal-to-copy", {
+          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(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const results = new Array(requests.length);
+    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");
+      }
+      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+    }
+    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
+    return results;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();

package/dist/index.d.mts

@@ -203,6 +203,8 @@ 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 runSignalCopyBatchChunk;
     private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;

package/dist/index.d.ts

@@ -203,6 +203,8 @@ 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 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,55 @@ 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 startedAt = Date.now();
+    const maxWaitMs = 20 * 6e4;
+    let status = await this.client.post("api/v1/signal-to-copy", {
+      requests: requests.map(signalToCopyRequestBody)
+    });
+    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`);
+      }
+      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", {
+        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("api/v1/signal-to-copy", {
+          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(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const results = new Array(requests.length);
+    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");
+      }
+      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+    }
+    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
+    return results;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   Signaliz,
   SignalizError
-} from "./chunk-P3ICLKAE.mjs";
+} from "./chunk-JO4MYKSK.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,55 @@ 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 startedAt = Date.now();
+    const maxWaitMs = 20 * 6e4;
+    let status = await this.client.post("api/v1/signal-to-copy", {
+      requests: requests.map(signalToCopyRequestBody)
+    });
+    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`);
+      }
+      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", {
+        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("api/v1/signal-to-copy", {
+          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(`Signal to Copy batch returned ${rows.length} results for ${requests.length} requests`);
+    }
+    const results = new Array(requests.length);
+    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");
+      }
+      results[index] = row.success === false ? { index, success: false, error: row.error || row.message || "Signal to Copy failed" } : { index, success: true, data: normalizeSignalToCopyResult(row) };
+    }
+    if (results.some((item) => !item)) throw new Error("Signal to Copy batch returned incomplete indexed results");
+    return results;
   }
   async runSignalCopyBatchChunk(requests, concurrency) {
     const startedAt = Date.now();

package/dist/mcp-config.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   Signaliz
-} from "./chunk-P3ICLKAE.mjs";
+} from "./chunk-JO4MYKSK.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.32",
   "description": "Signaliz SDK for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",