@signaliz/sdk 1.0.29 → 1.0.31

package/dist/index.js

@@ -380,89 +380,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);
@@ -490,47 +452,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);
@@ -553,29 +536,31 @@ 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 deduplicated = dedupeExactBatchItems(requests, (params) => JSON.stringify({
+      request: signalToCopyRequestBody(params),
+      wait_for_result: params.waitForResult,
+      max_wait_ms: params.maxWaitMs,
+      poll_interval_ms: params.pollIntervalMs
+    }));
+    const uniqueRequests = deduplicated.uniqueItems;
     const chunks = [];
-    for (let offset = 0; offset < requests.length; offset += 25) {
-      chunks.push({ offset, requests: requests.slice(offset, offset + 25) });
+    for (let offset = 0; offset < uniqueRequests.length; offset += 25) {
+      chunks.push({ offset, requests: uniqueRequests.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);
+    const uniqueResults = new Array(uniqueRequests.length);
     for (const chunkResult of chunkBatch.results) {
       const chunk = chunks[chunkResult.index];
       if (!chunkResult.success || !chunkResult.data) {
         for (let index = 0; index < chunk.requests.length; index += 1) {
-          results[chunk.offset + index] = {
+          uniqueResults[chunk.offset + index] = {
             index: chunk.offset + index,
             success: false,
             error: chunkResult.error || "Signal to Copy batch request failed"
@@ -584,9 +569,13 @@ var Signaliz = class {
         continue;
       }
       for (const item of chunkResult.data) {
-        results[chunk.offset + item.index] = { ...item, index: chunk.offset + item.index };
+        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,
@@ -658,6 +647,55 @@ var Signaliz = class {
     }
     return results;
   }
+  async runCoreBatchRound(path, tasks, options) {
+    const { serverConcurrency, chunkConcurrency } = batchConcurrencyPlan(options);
+    const deduplicated = dedupeExactBatchItems(tasks, (task) => JSON.stringify(task.request));
+    const uniqueTasks = deduplicated.uniqueItems;
+    const chunks = [];
+    for (let offset = 0; offset < uniqueTasks.length; offset += 25) {
+      chunks.push({ offset, tasks: uniqueTasks.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 uniqueResults = new Array(uniqueTasks.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) {
+          uniqueResults[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];
+        uniqueResults[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 tasks.map((task, index) => ({
+      ...uniqueResults[deduplicated.sourceIndexByInput[index]],
+      index: task.index
+    }));
+  }
   async listTools() {
     const result = await this.client.mcp("tools/list");
     return result.tools ?? [];
@@ -673,6 +711,188 @@ 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 dedupeExactBatchItems(items, keyForItem) {
+  const uniqueItems = [];
+  const sourceIndexByInput = [];
+  const uniqueIndexByKey = /* @__PURE__ */ new Map();
+  for (const item of items) {
+    const key = keyForItem(item);
+    let uniqueIndex = uniqueIndexByKey.get(key);
+    if (uniqueIndex === void 0) {
+      uniqueIndex = uniqueItems.length;
+      uniqueIndexByKey.set(key, uniqueIndex);
+      uniqueItems.push(item);
+    }
+    sourceIndexByInput.push(uniqueIndex);
+  }
+  return { uniqueItems, sourceIndexByInput };
+}
+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,
@@ -734,16 +954,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.mjs

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