@signaliz/sdk 1.0.62 → 1.0.64

package/README.md

@@ -166,6 +166,8 @@ can instead set `waitForResult: false` to receive `jobId` plus the actual
 `idempotencyKey`, then resume with `resumeCompanySignalBatch` or
 `resumeSignalCopyBatch`. Company/Copy polling has no fixed SDK deadline unless
 `maxWaitMs` is explicitly supplied; timeout errors retain both recovery fields.
+Find Email and Verify Email polling defaults to 20 minutes; large email batches
+honor `maxWaitMs` and `pollIntervalMs` and retain the same recovery fields.
 Find Email, Verify Email, and Company Signals use bounded 25-row result pages;
 Signal to Copy uses 100-row durable pages.
 Retrieve completed Company/Copy pages within seven days. After cleanup, recovery
@@ -214,9 +216,11 @@ only when fresh or deeper research is required.
 Every core request uses the authenticated workspace. Find Email and Verify Email
 honor that workspace's configured cache window; eligible hits cost 0 credits,
 while fresh discovery or verification is charged on every plan. Builder, Team,
-Agency, and Pay-As-You-Go include fresh Company Signals and Signal to Copy. Those plans
-still check eligible workspace signal data first even when Company Signals is
-set to No cache. `lookbackDays` remains a hard evidence-age bound for both
+Agency, and Pay-As-You-Go include fresh Company Signals. Team and Agency also
+include Unlimited Signal to Copy AI; Signal to Copy remains callable on other
+plans under the standard product contract. These plans still check eligible
+workspace signal data first even when Company Signals is set to No cache.
+`lookbackDays` remains a hard evidence-age bound for both
 cached and fresh Company Signals and Signal to Copy results.
 Unclassified evidence is returned by signal enrichment but is not used to
 generate outreach copy.

package/dist/{chunk-6G2FALRZ.mjs → chunk-PDOG4IUP.mjs}

@@ -703,7 +703,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
-    validateCoreProductMaxWaitMs(params.maxWaitMs);
+    validateCompanySignalParams(params);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -723,7 +723,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
-    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
+    companies.forEach(validateCompanySignalParams);
     const requests = companies.map(companySignalRequestBody);
     if (companies.length > 25 && requests.some((request) => request.include_candidate_evidence === true)) {
       throw new RangeError(
@@ -1010,7 +1010,8 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, pollIntervalMs, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+    validateCoreBatchPollingOptions({ maxWaitMs, pollIntervalMs });
     const job = await this.submitRecoverableCoreBatchJob(
       path,
       requests,
@@ -1022,6 +1023,7 @@ var Signaliz = class {
     const recovered = await this.readRecoverableCoreBatchJob(path, job.jobId, label, {
       pageSize,
       maxWaitMs,
+      pollIntervalMs,
       idempotencyKey: job.idempotencyKey
     });
     if (recovered.total !== requests.length) {
@@ -1090,12 +1092,7 @@ var Signaliz = class {
     if (options.pageSize !== void 0 && (!Number.isFinite(options.pageSize) || options.pageSize <= 0)) {
       throw new RangeError("pageSize must be a positive finite number");
     }
-    if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
-      throw new RangeError("maxWaitMs must be a positive finite number");
-    }
-    if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
-      throw new RangeError("pollIntervalMs must be a positive finite number");
-    }
+    validateCoreBatchPollingOptions(options);
     const maximumPageSize = path === "api/v1/signal-to-copy" ? 100 : 25;
     const pageSize = Math.min(maximumPageSize, Math.max(1, Math.trunc(options.pageSize ?? maximumPageSize)));
     const emailJob = path === "api/v1/find-email" || path === "api/v1/verify-email";
@@ -1287,7 +1284,8 @@ var Signaliz = class {
         uniqueTasks.map((task) => task.request),
         recoverableBatch.label,
         recoverableBatch.pageSize,
-        recoverableBatch.maxWaitMs,
+        options?.maxWaitMs ?? recoverableBatch.maxWaitMs,
+        options?.pollIntervalMs,
         options?.idempotencyKey,
         uniqueTasks.map((task) => task.index)
       );
@@ -1674,6 +1672,15 @@ function companySignalRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function validateCompanySignalParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
+  if (params.targetSignalCount !== void 0 && (!Number.isInteger(params.targetSignalCount) || params.targetSignalCount < 1 || params.targetSignalCount > 15)) {
+    throw new RangeError("targetSignalCount must be an integer between 1 and 15");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+}
 function companySignalParamsFromRecoveredRow(row) {
   return {
     companyDomain: row.company?.domain ?? row.company_domain,
@@ -2229,6 +2236,8 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
+    unlimitedSignalToCopy: data.unlimited_signal_to_copy,
+    signalToCopyEntitlement: data.signal_to_copy_entitlement,
     variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
@@ -2312,6 +2321,14 @@ async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function validateCoreBatchPollingOptions(options) {
+  if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
+    throw new RangeError("maxWaitMs must be a positive finite number");
+  }
+  if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
+    throw new RangeError("pollIntervalMs must be a positive finite number");
+  }
+}
 function assertRecoverableBatchResultsRetained(status, label, jobId, idempotencyKey) {
   if (status.results_expired !== true && status.results_cleaned !== true) return;
   throw new SignalizError({

package/dist/index.d.mts

@@ -17,7 +17,7 @@ interface BatchOptions {
     dryRun?: boolean;
     /** Return a durable Company Signals or Signal to Copy job handle immediately. */
     waitForResult?: boolean;
-    /** Maximum time to poll a durable job. Company/Copy jobs wait without a fixed deadline when omitted. */
+    /** Maximum time to poll a durable job. Email jobs default to 20 minutes; Company/Copy jobs wait without a fixed deadline when omitted. */
     maxWaitMs?: number;
     /** Override the server-provided polling delay for a durable job. */
     pollIntervalMs?: number;
@@ -494,6 +494,8 @@ interface SignalToCopyResult {
     liveProviderCalled?: boolean;
     aiProviderCalled?: boolean;
     byoAiUsed?: boolean;
+    unlimitedSignalToCopy?: boolean;
+    signalToCopyEntitlement?: 'unlimited' | 'standard';
     variations: SignalToCopyVariation[];
     raw: Record<string, unknown>;
 }

package/dist/index.d.ts

@@ -17,7 +17,7 @@ interface BatchOptions {
     dryRun?: boolean;
     /** Return a durable Company Signals or Signal to Copy job handle immediately. */
     waitForResult?: boolean;
-    /** Maximum time to poll a durable job. Company/Copy jobs wait without a fixed deadline when omitted. */
+    /** Maximum time to poll a durable job. Email jobs default to 20 minutes; Company/Copy jobs wait without a fixed deadline when omitted. */
     maxWaitMs?: number;
     /** Override the server-provided polling delay for a durable job. */
     pollIntervalMs?: number;
@@ -494,6 +494,8 @@ interface SignalToCopyResult {
     liveProviderCalled?: boolean;
     aiProviderCalled?: boolean;
     byoAiUsed?: boolean;
+    unlimitedSignalToCopy?: boolean;
+    signalToCopyEntitlement?: 'unlimited' | 'standard';
     variations: SignalToCopyVariation[];
     raw: Record<string, unknown>;
 }

package/dist/index.js

@@ -730,7 +730,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
-    validateCoreProductMaxWaitMs(params.maxWaitMs);
+    validateCompanySignalParams(params);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -750,7 +750,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
-    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
+    companies.forEach(validateCompanySignalParams);
     const requests = companies.map(companySignalRequestBody);
     if (companies.length > 25 && requests.some((request) => request.include_candidate_evidence === true)) {
       throw new RangeError(
@@ -1037,7 +1037,8 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+  async runRecoverableCoreBatchJob(path, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, pollIntervalMs, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+    validateCoreBatchPollingOptions({ maxWaitMs, pollIntervalMs });
     const job = await this.submitRecoverableCoreBatchJob(
       path,
       requests,
@@ -1049,6 +1050,7 @@ var Signaliz = class {
     const recovered = await this.readRecoverableCoreBatchJob(path, job.jobId, label, {
       pageSize,
       maxWaitMs,
+      pollIntervalMs,
       idempotencyKey: job.idempotencyKey
     });
     if (recovered.total !== requests.length) {
@@ -1117,12 +1119,7 @@ var Signaliz = class {
     if (options.pageSize !== void 0 && (!Number.isFinite(options.pageSize) || options.pageSize <= 0)) {
       throw new RangeError("pageSize must be a positive finite number");
     }
-    if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
-      throw new RangeError("maxWaitMs must be a positive finite number");
-    }
-    if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
-      throw new RangeError("pollIntervalMs must be a positive finite number");
-    }
+    validateCoreBatchPollingOptions(options);
     const maximumPageSize = path === "api/v1/signal-to-copy" ? 100 : 25;
     const pageSize = Math.min(maximumPageSize, Math.max(1, Math.trunc(options.pageSize ?? maximumPageSize)));
     const emailJob = path === "api/v1/find-email" || path === "api/v1/verify-email";
@@ -1314,7 +1311,8 @@ var Signaliz = class {
         uniqueTasks.map((task) => task.request),
         recoverableBatch.label,
         recoverableBatch.pageSize,
-        recoverableBatch.maxWaitMs,
+        options?.maxWaitMs ?? recoverableBatch.maxWaitMs,
+        options?.pollIntervalMs,
         options?.idempotencyKey,
         uniqueTasks.map((task) => task.index)
       );
@@ -1701,6 +1699,15 @@ function companySignalRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function validateCompanySignalParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
+  if (params.targetSignalCount !== void 0 && (!Number.isInteger(params.targetSignalCount) || params.targetSignalCount < 1 || params.targetSignalCount > 15)) {
+    throw new RangeError("targetSignalCount must be an integer between 1 and 15");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+}
 function companySignalParamsFromRecoveredRow(row) {
   return {
     companyDomain: row.company?.domain ?? row.company_domain,
@@ -2256,6 +2263,8 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
+    unlimitedSignalToCopy: data.unlimited_signal_to_copy,
+    signalToCopyEntitlement: data.signal_to_copy_entitlement,
     variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
@@ -2339,6 +2348,14 @@ async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function validateCoreBatchPollingOptions(options) {
+  if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
+    throw new RangeError("maxWaitMs must be a positive finite number");
+  }
+  if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
+    throw new RangeError("pollIntervalMs must be a positive finite number");
+  }
+}
 function assertRecoverableBatchResultsRetained(status, label, jobId, idempotencyKey) {
   if (status.results_expired !== true && status.results_cleaned !== true) return;
   throw new SignalizError({

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   Signaliz,
   SignalizError
-} from "./chunk-6G2FALRZ.mjs";
+} from "./chunk-PDOG4IUP.mjs";
 export {
   Signaliz,
   SignalizError

package/dist/mcp-config.js

@@ -734,7 +734,7 @@ var Signaliz = class {
     );
   }
   async enrichCompanySignals(params) {
-    validateCoreProductMaxWaitMs(params.maxWaitMs);
+    validateCompanySignalParams(params);
     const request = companySignalRequestBody(params);
     const data = await this.client.post("api/v1/company-signals", request);
     if (isCoreProductDryRun(data)) return normalizeCoreProductDryRunResult(data);
@@ -754,7 +754,7 @@ var Signaliz = class {
   }
   async enrichCompanies(companies, options) {
     validateBatchSize(companies);
-    companies.forEach((params) => validateCoreProductMaxWaitMs(params.maxWaitMs));
+    companies.forEach(validateCompanySignalParams);
     const requests = companies.map(companySignalRequestBody);
     if (companies.length > 25 && requests.some((request) => request.include_candidate_evidence === true)) {
       throw new RangeError(
@@ -1041,7 +1041,8 @@ var Signaliz = class {
     }
     return uniqueResults;
   }
-  async runRecoverableCoreBatchJob(path2, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+  async runRecoverableCoreBatchJob(path2, requests, label, pageSize = 500, maxWaitMs = 20 * 6e4, pollIntervalMs, idempotencyKey, idempotencyItemIndices, submissionFields = {}) {
+    validateCoreBatchPollingOptions({ maxWaitMs, pollIntervalMs });
     const job = await this.submitRecoverableCoreBatchJob(
       path2,
       requests,
@@ -1053,6 +1054,7 @@ var Signaliz = class {
     const recovered = await this.readRecoverableCoreBatchJob(path2, job.jobId, label, {
       pageSize,
       maxWaitMs,
+      pollIntervalMs,
       idempotencyKey: job.idempotencyKey
     });
     if (recovered.total !== requests.length) {
@@ -1121,12 +1123,7 @@ var Signaliz = class {
     if (options.pageSize !== void 0 && (!Number.isFinite(options.pageSize) || options.pageSize <= 0)) {
       throw new RangeError("pageSize must be a positive finite number");
     }
-    if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
-      throw new RangeError("maxWaitMs must be a positive finite number");
-    }
-    if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
-      throw new RangeError("pollIntervalMs must be a positive finite number");
-    }
+    validateCoreBatchPollingOptions(options);
     const maximumPageSize = path2 === "api/v1/signal-to-copy" ? 100 : 25;
     const pageSize = Math.min(maximumPageSize, Math.max(1, Math.trunc(options.pageSize ?? maximumPageSize)));
     const emailJob = path2 === "api/v1/find-email" || path2 === "api/v1/verify-email";
@@ -1318,7 +1315,8 @@ var Signaliz = class {
         uniqueTasks.map((task) => task.request),
         recoverableBatch.label,
         recoverableBatch.pageSize,
-        recoverableBatch.maxWaitMs,
+        options?.maxWaitMs ?? recoverableBatch.maxWaitMs,
+        options?.pollIntervalMs,
         options?.idempotencyKey,
         uniqueTasks.map((task) => task.index)
       );
@@ -1705,6 +1703,15 @@ function companySignalRequestBody(params) {
     idempotency_key: params.idempotencyKey
   });
 }
+function validateCompanySignalParams(params) {
+  validateCoreProductMaxWaitMs(params.maxWaitMs);
+  if (params.targetSignalCount !== void 0 && (!Number.isInteger(params.targetSignalCount) || params.targetSignalCount < 1 || params.targetSignalCount > 15)) {
+    throw new RangeError("targetSignalCount must be an integer between 1 and 15");
+  }
+  if (params.lookbackDays !== void 0 && (!Number.isInteger(params.lookbackDays) || params.lookbackDays < 1 || params.lookbackDays > 365)) {
+    throw new RangeError("lookbackDays must be an integer between 1 and 365");
+  }
+}
 function companySignalParamsFromRecoveredRow(row) {
   return {
     companyDomain: row.company?.domain ?? row.company_domain,
@@ -2260,6 +2267,8 @@ function normalizeSignalToCopyResult(data) {
     liveProviderCalled: data.live_provider_called,
     aiProviderCalled: data.ai_provider_called,
     byoAiUsed: data.byo_ai_used,
+    unlimitedSignalToCopy: data.unlimited_signal_to_copy,
+    signalToCopyEntitlement: data.signal_to_copy_entitlement,
     variations: (failed ? [] : data.variations ?? []).map((variation) => ({
       style: variation.style,
       subjectLine: variation.subject_line ?? "",
@@ -2343,6 +2352,14 @@ async function waitForNextSignalPoll(data, override, startedAt, maxWaitMs) {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function validateCoreBatchPollingOptions(options) {
+  if (options.maxWaitMs !== void 0 && (!Number.isFinite(options.maxWaitMs) || options.maxWaitMs <= 0)) {
+    throw new RangeError("maxWaitMs must be a positive finite number");
+  }
+  if (options.pollIntervalMs !== void 0 && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs <= 0)) {
+    throw new RangeError("pollIntervalMs must be a positive finite number");
+  }
+}
 function assertRecoverableBatchResultsRetained(status, label, jobId, idempotencyKey) {
   if (status.results_expired !== true && status.results_cleaned !== true) return;
   throw new SignalizError({

package/dist/mcp-config.mjs

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

package/package.json

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