@signaliz/sdk 1.0.29 → 1.0.30

package/README.md

@@ -77,8 +77,9 @@ 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.
-Signal to Copy batches are transported in 25-row chunks; exact duplicates and
-shared company research are single-flighted without changing input order.
+All four products are transported in 25-row REST chunks. Exact duplicate tasks
+are single-flighted without changing input order or result cardinality, and
+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-R4DIAP7P.mjs → chunk-INM326KO.mjs}

@@ -353,89 +353,51 @@ var Signaliz = class {
     this.client = new HttpClient(config);
   }
   async findEmail(params) {
-    const data = await this.client.post("api/v1/find-email", compact({
-      company_domain: params.companyDomain,
-      full_name: params.fullName,
-      first_name: params.firstName,
-      last_name: params.lastName,
-      linkedin_url: params.linkedinUrl,
-      company_name: params.companyName,
-      skip_cache: params.skipCache
-    }));
-    const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
-    const found = Boolean(email) && data.found !== false;
-    const verificationStatus = data.verification_status ?? data.status ?? "unknown";
-    const rawFreshness = String(data.verification_freshness ?? "").toLowerCase();
-    const verificationFreshness = rawFreshness === "fresh" || rawFreshness === "stale" ? rawFreshness : "unknown";
-    const needsReverification = data.needs_reverification === true || verificationFreshness === "stale";
-    const explicitlyNotSendSafe = data.verified_for_sending === false || needsReverification;
-    const verified = !explicitlyNotSendSafe && (data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase()));
-    const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
-    return {
-      success: data.success !== false && found,
-      found,
-      email,
-      firstName: data.first_name,
-      lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
-      verificationStatus,
-      isVerified: verified,
-      isVerifiedForSending: !needsReverification && data.verified_for_sending === true,
-      isCatchAll: data.email_is_catch_all === true || data.is_catch_all === true,
-      verificationFreshness,
-      verificationAgeDays,
-      verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
-      needsReverification,
-      providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
-      error: found ? void 0 : data.error ?? "No verified email found",
-      errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
-      raw: data
-    };
+    const data = await this.client.post("api/v1/find-email", findEmailRequestBody(params));
+    return normalizeFindEmailResult(data);
   }
   async findEmails(params, options) {
-    return runBatch(params, (item) => this.findEmail(item), options);
+    validateBatchSize(params);
+    const startedAt = Date.now();
+    const round = await this.runCoreBatchRound(
+      "api/v1/find-email",
+      params.map((item, index) => ({ index, request: findEmailRequestBody(item) })),
+      options
+    );
+    return finalizeCoreBatch(
+      params.length,
+      startedAt,
+      round,
+      (item) => normalizeFindEmailResult(item.raw)
+    );
   }
   async verifyEmail(email, options) {
     const data = await this.client.post("api/v1/verify-email", {
       email,
       skip_cache: options?.skipCache
     });
-    const verificationStatus = String(data.verification_status ?? "").toLowerCase();
-    const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
-    return {
-      email: data.email ?? email,
-      isValid: data.is_valid ?? data.valid ?? verified,
-      isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
-      isCatchAll: data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false,
-      confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
-      provider: data.provider,
-      verificationSource: data.verification_source,
-      raw: data
-    };
+    return normalizeVerifyEmailResult(email, data);
   }
   async verifyEmails(emails, options) {
-    return runBatch(emails, (email) => this.verifyEmail(email, { skipCache: options?.skipCache }), options);
+    validateBatchSize(emails);
+    const startedAt = Date.now();
+    const round = await this.runCoreBatchRound(
+      "api/v1/verify-email",
+      emails.map((email, index) => ({
+        index,
+        request: { email, skip_cache: options?.skipCache }
+      })),
+      options
+    );
+    return finalizeCoreBatch(
+      emails.length,
+      startedAt,
+      round,
+      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw)
+    );
   }
   async enrichCompanySignals(params) {
-    const online = params.online ?? true;
-    const request = compact({
-      signal_run_id: params.signalRunId,
-      company_domain: params.companyDomain,
-      company_name: params.companyName,
-      research_prompt: params.researchPrompt,
-      signal_types: params.signalTypes,
-      target_signal_count: params.targetSignalCount,
-      lookback_days: params.lookbackDays,
-      online,
-      enable_deep_search: params.enableDeepSearch ?? online,
-      enable_outreach_intelligence: params.enableOutreachIntelligence,
-      enable_predictive_intelligence: params.enablePredictiveIntelligence,
-      skip_cache: params.skipCache,
-      // REST always returns a resumable run instead of holding the connection;
-      // waitForResult controls this SDK's polling loop below.
-      wait_for_result: false,
-      max_wait_ms: params.maxWaitMs
-    });
+    const request = companySignalRequestBody(params);
     let data = await this.client.post("api/v1/company-signals", request);
     if (params.waitForResult !== false && data.run_id && isPendingSignalResponse(data)) {
       const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
@@ -463,47 +425,68 @@ var Signaliz = class {
         throw new Error(`Company signal enrichment ${data.run_id} did not complete within ${maxWaitMs}ms`);
       }
     }
-    return {
-      success: data.success ?? true,
-      status: data.status,
-      signalRunId: data.signal_run_id ?? data.run_id,
-      company: {
-        name: data.company?.name ?? params.companyName ?? null,
-        domain: data.company?.domain ?? params.companyDomain ?? null
-      },
-      signals: (data.signals ?? []).map((signal) => {
-        const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
-        return {
-          id: signal.id,
-          title: signal.title ?? "",
-          type: signal.type ?? signal.signal_type ?? "unknown",
-          content: signal.content ?? signal.description ?? "",
-          date: signal.date ?? signal.detected_at ?? null,
-          datePrecision: signal.date_precision,
-          sourceUrl: signal.source_url ?? signal.url ?? null,
-          sourceType: signal.source_type,
-          sourceProvenance: signal.source_provenance,
-          confidence: signal.confidence ?? signal.confidence_score ?? null,
-          entityConfidence: signal.entity_confidence ?? metadata?.entity_confidence ?? null,
-          signalFamily: signal.signal_family,
-          eventType: signal.signal_event_type,
-          eventLabel: signal.signal_event_label,
-          classification: signal.signal_classification ?? null,
-          derived: signal.derived === true,
-          evidencePublishedDate: signal.evidence_published_date ?? metadata?.evidence_published_date ?? null,
-          signalFeedSource: signal.signal_feed_source ?? metadata?.signal_feed_source,
-          metadata
-        };
-      }),
-      signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
-      intelligence: data.intelligence ?? null,
-      credits: data.credits,
-      metadata: data.metadata,
-      raw: data
-    };
+    return normalizeCompanySignalResult(params, data);
   }
   async enrichCompanies(companies, options) {
-    return runBatch(companies, (company) => this.enrichCompanySignals(company), options);
+    validateBatchSize(companies);
+    const startedAt = Date.now();
+    const results = new Array(companies.length);
+    let pending = companies.map((params, index) => ({
+      index,
+      request: companySignalRequestBody(params)
+    }));
+    while (pending.length > 0) {
+      const round = await this.runCoreBatchRound("api/v1/company-signals", pending, options);
+      const taskByIndex = new Map(pending.map((task) => [task.index, task]));
+      const nextPending = [];
+      let nextDelayMs = 6e4;
+      for (const item of round) {
+        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" };
+          continue;
+        }
+        if (!isPendingSignalResponse(item.raw) || params.waitForResult === false) {
+          results[item.index] = { index: item.index, success: true, data: normalizeCompanySignalResult(params, item.raw) };
+          continue;
+        }
+        const maxWaitMs = Math.max(1e3, params.maxWaitMs ?? 20 * 6e4);
+        if (Date.now() - startedAt >= maxWaitMs) {
+          results[item.index] = {
+            index: item.index,
+            success: false,
+            error: `Company signal enrichment ${item.raw.signal_run_id || item.raw.run_id || ""} did not complete within ${maxWaitMs}ms`
+          };
+          continue;
+        }
+        const signalRunId = item.raw.signal_run_id || item.raw.run_id;
+        if (!signalRunId) {
+          results[item.index] = { index: item.index, success: false, error: "Company signal enrichment is processing without a signal_run_id" };
+          continue;
+        }
+        nextDelayMs = Math.min(
+          nextDelayMs,
+          signalPollDelayMs(item.raw, params.pollIntervalMs),
+          maxWaitMs - (Date.now() - startedAt)
+        );
+        nextPending.push({
+          ...task,
+          request: { ...task.request, signal_run_id: signalRunId }
+        });
+      }
+      if (nextPending.length === 0) break;
+      await sleep2(Math.max(1, nextDelayMs));
+      pending = nextPending;
+    }
+    const succeeded = results.filter((item) => item.success).length;
+    return {
+      total: companies.length,
+      succeeded,
+      failed: companies.length - succeeded,
+      durationMs: Date.now() - startedAt,
+      results
+    };
   }
   async signalToCopy(params) {
     const request = signalToCopyRequestBody(params);
@@ -526,22 +509,17 @@ var Signaliz = class {
     return normalizeSignalToCopyResult(data);
   }
   async createSignalCopyBatch(requests, options) {
-    if (!Array.isArray(requests) || requests.length === 0) {
-      throw new Error("Signaliz batch requests require at least one item");
-    }
-    if (requests.length > 5e3) {
-      throw new Error(`Signaliz batch requests support at most 5,000 items; received ${requests.length}`);
-    }
+    validateBatchSize(requests);
     const startedAt = Date.now();
     const chunks = [];
     for (let offset = 0; offset < requests.length; offset += 25) {
       chunks.push({ offset, requests: requests.slice(offset, offset + 25) });
     }
-    const serverConcurrency = Math.min(10, options?.concurrency ?? 10);
+    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
     const chunkBatch = await runBatch(
       chunks,
       (chunk) => this.runSignalCopyBatchChunk(chunk.requests, serverConcurrency),
-      options
+      { concurrency: chunkConcurrency }
     );
     const results = new Array(requests.length);
     for (const chunkResult of chunkBatch.results) {
@@ -631,6 +609,50 @@ var Signaliz = class {
     }
     return results;
   }
+  async runCoreBatchRound(path, tasks, options) {
+    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
+    const chunks = [];
+    for (let offset = 0; offset < tasks.length; offset += 25) {
+      chunks.push({ offset, tasks: tasks.slice(offset, offset + 25) });
+    }
+    const chunkBatch = await runBatch(chunks, async (chunk) => {
+      const data = await this.client.post(path, {
+        requests: chunk.tasks.map((task) => task.request),
+        concurrency: serverConcurrency
+      });
+      if (!Array.isArray(data.results) || data.results.length !== chunk.tasks.length) {
+        throw new Error(`${path} batch returned an invalid result count`);
+      }
+      if (data.results.some((row, index) => row.index !== index)) {
+        throw new Error(`${path} batch returned results out of order`);
+      }
+      return data.results;
+    }, { concurrency: chunkConcurrency });
+    const results = new Array(tasks.length);
+    for (const chunkResult of chunkBatch.results) {
+      const chunk = chunks[chunkResult.index];
+      if (!chunkResult.success || !chunkResult.data) {
+        for (let index = 0; index < chunk.tasks.length; index += 1) {
+          results[chunk.offset + index] = {
+            index: chunk.tasks[index].index,
+            success: false,
+            error: chunkResult.error || `${path} batch request failed`
+          };
+        }
+        continue;
+      }
+      for (let index = 0; index < chunkResult.data.length; index += 1) {
+        const raw = chunkResult.data[index];
+        results[chunk.offset + index] = {
+          index: chunk.tasks[index].index,
+          success: raw.success !== false,
+          raw,
+          error: raw.success === false ? raw.error || raw.message || raw.error_code || `${path} item failed` : void 0
+        };
+      }
+    }
+    return results;
+  }
   async listTools() {
     const result = await this.client.mcp("tools/list");
     return result.tools ?? [];
@@ -646,6 +668,172 @@ var Signaliz = class {
 function compact(input) {
   return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
 }
+function findEmailRequestBody(params) {
+  return compact({
+    company_domain: params.companyDomain,
+    full_name: params.fullName,
+    first_name: params.firstName,
+    last_name: params.lastName,
+    linkedin_url: params.linkedinUrl,
+    company_name: params.companyName,
+    skip_cache: params.skipCache
+  });
+}
+function normalizeFindEmailResult(data) {
+  const email = typeof data.email === "string" && data.email.trim() ? data.email.trim() : null;
+  const found = Boolean(email) && data.found !== false;
+  const verificationStatus = data.verification_status ?? data.status ?? "unknown";
+  const rawFreshness = String(data.verification_freshness ?? "").toLowerCase();
+  const verificationFreshness = rawFreshness === "fresh" || rawFreshness === "stale" ? rawFreshness : "unknown";
+  const needsReverification = data.needs_reverification === true || verificationFreshness === "stale";
+  const explicitlyNotSendSafe = data.verified_for_sending === false || needsReverification;
+  const verified = !explicitlyNotSendSafe && (data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase()));
+  const verificationAgeDays = typeof data.verification_age_days === "number" && Number.isFinite(data.verification_age_days) ? data.verification_age_days : null;
+  return {
+    success: data.success !== false && found,
+    found,
+    email,
+    firstName: data.first_name,
+    lastName: data.last_name,
+    confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+    verificationStatus,
+    isVerified: verified,
+    isVerifiedForSending: !needsReverification && data.verified_for_sending === true,
+    isCatchAll: data.email_is_catch_all === true || data.is_catch_all === true,
+    verificationFreshness,
+    verificationAgeDays,
+    verifiedAt: typeof data.verified_at === "string" ? data.verified_at : null,
+    needsReverification,
+    providerUsed: data.provider_used ?? data.provider ?? data.email_source ?? data.source ?? "unknown",
+    error: found ? void 0 : data.error ?? "No verified email found",
+    errorCode: found ? void 0 : data.error_code ?? "EMAIL_NOT_FOUND",
+    raw: data
+  };
+}
+function normalizeVerifyEmailResult(email, data) {
+  const verificationStatus = String(data.verification_status ?? "").toLowerCase();
+  const verified = data.email_verified === true || ["valid", "deliverable"].includes(verificationStatus);
+  return {
+    email: data.email ?? email,
+    isValid: data.is_valid ?? data.valid ?? verified,
+    isDeliverable: data.is_deliverable ?? data.deliverable ?? verified,
+    isCatchAll: data.email_is_catch_all ?? data.is_catch_all ?? data.catch_all ?? data.diagnostics?.is_catch_all ?? false,
+    confidenceScore: data.confidence_score ?? data.confidence ?? data.diagnostics?.confidence_score ?? (verified ? 1 : 0),
+    provider: data.provider,
+    verificationSource: data.verification_source,
+    raw: data
+  };
+}
+function companySignalRequestBody(params) {
+  const online = params.online ?? true;
+  return compact({
+    signal_run_id: params.signalRunId,
+    company_domain: params.companyDomain,
+    company_name: params.companyName,
+    research_prompt: params.researchPrompt,
+    signal_types: params.signalTypes,
+    target_signal_count: params.targetSignalCount,
+    lookback_days: params.lookbackDays,
+    online,
+    enable_deep_search: params.enableDeepSearch ?? online,
+    enable_outreach_intelligence: params.enableOutreachIntelligence,
+    enable_predictive_intelligence: params.enablePredictiveIntelligence,
+    skip_cache: params.skipCache,
+    // REST always returns a resumable run instead of holding the connection;
+    // waitForResult controls the SDK polling loop.
+    wait_for_result: false,
+    max_wait_ms: params.maxWaitMs
+  });
+}
+function normalizeCompanySignalResult(params, data) {
+  return {
+    success: data.success ?? true,
+    status: data.status,
+    signalRunId: data.signal_run_id ?? data.run_id,
+    company: {
+      name: data.company?.name ?? params.companyName ?? null,
+      domain: data.company?.domain ?? params.companyDomain ?? null
+    },
+    signals: (data.signals ?? []).map((signal) => {
+      const metadata = signal.metadata && typeof signal.metadata === "object" && !Array.isArray(signal.metadata) ? signal.metadata : void 0;
+      return {
+        id: signal.id,
+        title: signal.title ?? "",
+        type: signal.type ?? signal.signal_type ?? "unknown",
+        content: signal.content ?? signal.description ?? "",
+        date: signal.date ?? signal.detected_at ?? null,
+        datePrecision: signal.date_precision,
+        sourceUrl: signal.source_url ?? signal.url ?? null,
+        sourceType: signal.source_type,
+        sourceProvenance: signal.source_provenance,
+        confidence: signal.confidence ?? signal.confidence_score ?? null,
+        entityConfidence: signal.entity_confidence ?? metadata?.entity_confidence ?? null,
+        signalFamily: signal.signal_family,
+        eventType: signal.signal_event_type,
+        eventLabel: signal.signal_event_label,
+        classification: signal.signal_classification ?? null,
+        derived: signal.derived === true,
+        evidencePublishedDate: signal.evidence_published_date ?? metadata?.evidence_published_date ?? null,
+        signalFeedSource: signal.signal_feed_source ?? metadata?.signal_feed_source,
+        metadata
+      };
+    }),
+    signalCount: data.signal_count ?? data.total_signals ?? data.signals?.length ?? 0,
+    intelligence: data.intelligence ?? null,
+    credits: data.credits,
+    metadata: data.metadata,
+    raw: data
+  };
+}
+function validateBatchSize(items) {
+  if (!Array.isArray(items) || items.length === 0) {
+    throw new Error("Signaliz batch requests require at least one item");
+  }
+  if (items.length > 5e3) {
+    throw new Error(`Signaliz batch requests support at most 5,000 items; received ${items.length}`);
+  }
+}
+function validatedBatchConcurrency(options) {
+  const concurrency = options?.concurrency ?? 10;
+  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 50) {
+    throw new Error("Signaliz batch concurrency must be an integer between 1 and 50");
+  }
+  return concurrency;
+}
+function batchConcurrencyPlan(options) {
+  const concurrency = validatedBatchConcurrency(options);
+  const serverConcurrency = Math.min(10, concurrency);
+  return {
+    serverConcurrency,
+    chunkConcurrency: Math.max(1, Math.floor(concurrency / serverConcurrency))
+  };
+}
+function finalizeCoreBatch(total, startedAt, round, normalize) {
+  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" };
+      continue;
+    }
+    try {
+      results[item.index] = { index: item.index, success: true, data: normalize(item) };
+    } catch (error) {
+      results[item.index] = {
+        index: item.index,
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  const succeeded = results.filter((item) => item.success).length;
+  return {
+    total,
+    succeeded,
+    failed: total - succeeded,
+    durationMs: Date.now() - startedAt,
+    results
+  };
+}
 function signalToCopyRequestBody(params) {
   return compact({
     company_domain: params.companyDomain,
@@ -707,16 +895,8 @@ function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function runBatch(items, execute, options) {
-  if (!Array.isArray(items) || items.length === 0) {
-    throw new Error("Signaliz batch requests require at least one item");
-  }
-  if (items.length > 5e3) {
-    throw new Error(`Signaliz batch requests support at most 5,000 items; received ${items.length}`);
-  }
-  const concurrency = options?.concurrency ?? 10;
-  if (!Number.isInteger(concurrency) || concurrency < 1 || concurrency > 50) {
-    throw new Error("Signaliz batch concurrency must be an integer between 1 and 50");
-  }
+  validateBatchSize(items);
+  const concurrency = validatedBatchConcurrency(options);
   const startedAt = Date.now();
   const results = new Array(items.length);
   let nextIndex = 0;

package/dist/index.d.mts

@@ -204,6 +204,7 @@ declare class Signaliz {
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
     createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise<BatchResult<SignalToCopyResult>>;
     private runSignalCopyBatchChunk;
+    private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;
     health(): Promise<PlatformHealth>;
 }

package/dist/index.d.ts

@@ -204,6 +204,7 @@ declare class Signaliz {
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
     createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise<BatchResult<SignalToCopyResult>>;
     private runSignalCopyBatchChunk;
+    private runCoreBatchRound;
     listTools(): Promise<MCPToolInfo[]>;
     health(): Promise<PlatformHealth>;
 }