@signaliz/sdk 1.0.72 → 1.0.73

package/README.md

@@ -230,7 +230,7 @@ Single calls and synchronous batches of at most 25 may instead pass
 Durable batches of 26-5,000 reject these references rather than silently
 starting new research.
 
-Signals Everything is query-first rather than a row batch. It defaults to 100
+Signals First is query-first rather than a row batch. It defaults to 100
 distinct companies and supports up to 1,000. Every returned signal row contains
 only a signal type, verified source URL, event date, company name, and domain.
 A request is a ceiling, not a promise: it can return fewer results

package/dist/{chunk-MFXKZU6K.mjs → chunk-N4SFDZG7.mjs}

@@ -1924,6 +1924,16 @@ function normalizeFindEmailResult(data) {
     success: processing || !failed && found,
     found,
     email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    candidateSource: typeof data.candidate_source === "string" ? data.candidate_source : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     firstName: data.first_name,
     lastName: data.last_name,
     confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
@@ -1963,6 +1973,19 @@ function normalizeFindEmailResult(data) {
 function normalizeVerifyEmailResult(email, data) {
   data = publicProductData(data, "verify_email");
   const failed = coreProductResponseFailed(data);
+  const publicIsCatchAll = data.is_catch_all === true || data.email_is_catch_all === true;
+  const publicPrimaryResult = String(data.primary_verdict ?? "").toLowerCase();
+  const publicTerminalResult = String(data.terminal_result ?? "").toLowerCase();
+  const okToSend = !failed && (data.ok_to_send === true || publicPrimaryResult === "ok" || publicPrimaryResult === "catch_all" && publicTerminalResult === "deliverable");
+  return {
+    email: typeof data.email === "string" ? data.email : email || null,
+    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    isCatchAll: publicIsCatchAll,
+    creditsCharged: Number.isFinite(Number(data.credits_charged)) ? Number(data.credits_charged) : 0,
+    okToSend,
+    ...data.verification_run_id || data.run_id ? { verificationRunId: data.verification_run_id ?? data.run_id } : {},
+    ...data.next_poll_after_seconds !== void 0 ? { nextPollAfterSeconds: data.next_poll_after_seconds } : {}
+  };
   const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   const verificationStatus = normalizeVerifyEmailStatus(
     failed ? malformed ? "malformed" : "error" : data.verification_status ?? data.verification_verdict ?? data.deliverability_status ?? "unknown"
@@ -1977,6 +2000,15 @@ function normalizeVerifyEmailResult(email, data) {
     error: failed ? coreProductErrorMessage(data) : void 0,
     errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId,
     retryAfterMs: data.retry_after_ms,
@@ -2240,7 +2272,7 @@ function validateSignalDiscoveryParams(params) {
   const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
   const query = typeof params.query === "string" ? params.query.trim() : "";
   if (!runId && !query) {
-    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+    throw new TypeError("Signals First requires query or signalSearchRunId");
   }
   if (query && (query.length < 2 || query.length > 2e3)) {
     throw new RangeError("query must contain between 2 and 2000 characters");

package/dist/index.d.mts

@@ -256,6 +256,17 @@ interface FindEmailResult {
     success: boolean;
     found: boolean;
     email: string | null;
+    /** The mailbox checked even when it was not safe to send. */
+    checkedEmail?: string | null;
+    candidateSource?: string | null;
+    primaryVerifier?: string | null;
+    primaryVerdict?: string | null;
+    terminalVerifier?: string | null;
+    terminalVerdict?: string | null;
+    terminalResult?: string | null;
+    terminalIsCatchAll?: boolean | null;
+    terminalIsAcceptAll?: boolean | null;
+    bouncebanId?: string | null;
     firstName?: string;
     lastName?: string;
     confidence: number;
@@ -300,45 +311,13 @@ interface FindEmailResult {
 type VerifyEmailStatus = 'valid' | 'invalid' | 'catch_all' | 'role' | 'disposable' | 'unknown' | 'verifier_error' | 'malformed' | 'error';
 type VerifyEmailRecommendation = 'send' | 'do_not_send' | 'manual_review';
 interface VerifyEmailResult {
-    success: boolean;
-    error?: string;
-    errorCode?: string;
-    email: string;
-    /** Execution state. Processing results are never send-safe. */
+    email: string | null;
     status: 'processing' | 'completed';
-    /** Durable Trigger run id for resuming a long verification. */
+    isCatchAll: boolean;
+    creditsCharged: number;
+    okToSend: boolean;
     verificationRunId?: string;
-    retryAfterMs?: number;
     nextPollAfterSeconds?: number;
-    isValid: boolean;
-    isDeliverable: boolean;
-    /** True when the address failed syntax validation before any provider call. */
-    isMalformed: boolean;
-    isCatchAll: boolean;
-    /** Explicit send-safety verdict. Missing or false never becomes true by inference. */
-    verifiedForSending: boolean;
-    verificationStatus?: VerifyEmailStatus;
-    deliverabilityStatus?: VerifyEmailStatus;
-    verificationVerdict: VerifyEmailStatus;
-    isRoleAccount?: boolean;
-    quality?: string | null;
-    recommendation?: VerifyEmailRecommendation;
-    smtpStatus?: string;
-    providerStatus?: string;
-    failureReason?: string;
-    confidenceScore: number;
-    provider?: string;
-    verificationSource?: string;
-    /** ISO timestamp when the provider observed the winning verdict. */
-    verificationObservedAt?: string;
-    billingReplayed?: boolean;
-    /** True when the public result came from a completed response-idempotency reservation. */
-    idempotencyReplayed?: boolean;
-    creditsUsed?: number;
-    /** Canonical run ID alias returned alongside verificationRunId when available. */
-    runId?: string;
-    suggestedAction?: string;
-    raw: Record<string, unknown>;
 }
 interface VerifyEmailOptions {
     /** Resume an existing long verification without another provider call. */

package/dist/index.d.ts

@@ -256,6 +256,17 @@ interface FindEmailResult {
     success: boolean;
     found: boolean;
     email: string | null;
+    /** The mailbox checked even when it was not safe to send. */
+    checkedEmail?: string | null;
+    candidateSource?: string | null;
+    primaryVerifier?: string | null;
+    primaryVerdict?: string | null;
+    terminalVerifier?: string | null;
+    terminalVerdict?: string | null;
+    terminalResult?: string | null;
+    terminalIsCatchAll?: boolean | null;
+    terminalIsAcceptAll?: boolean | null;
+    bouncebanId?: string | null;
     firstName?: string;
     lastName?: string;
     confidence: number;
@@ -300,45 +311,13 @@ interface FindEmailResult {
 type VerifyEmailStatus = 'valid' | 'invalid' | 'catch_all' | 'role' | 'disposable' | 'unknown' | 'verifier_error' | 'malformed' | 'error';
 type VerifyEmailRecommendation = 'send' | 'do_not_send' | 'manual_review';
 interface VerifyEmailResult {
-    success: boolean;
-    error?: string;
-    errorCode?: string;
-    email: string;
-    /** Execution state. Processing results are never send-safe. */
+    email: string | null;
     status: 'processing' | 'completed';
-    /** Durable Trigger run id for resuming a long verification. */
+    isCatchAll: boolean;
+    creditsCharged: number;
+    okToSend: boolean;
     verificationRunId?: string;
-    retryAfterMs?: number;
     nextPollAfterSeconds?: number;
-    isValid: boolean;
-    isDeliverable: boolean;
-    /** True when the address failed syntax validation before any provider call. */
-    isMalformed: boolean;
-    isCatchAll: boolean;
-    /** Explicit send-safety verdict. Missing or false never becomes true by inference. */
-    verifiedForSending: boolean;
-    verificationStatus?: VerifyEmailStatus;
-    deliverabilityStatus?: VerifyEmailStatus;
-    verificationVerdict: VerifyEmailStatus;
-    isRoleAccount?: boolean;
-    quality?: string | null;
-    recommendation?: VerifyEmailRecommendation;
-    smtpStatus?: string;
-    providerStatus?: string;
-    failureReason?: string;
-    confidenceScore: number;
-    provider?: string;
-    verificationSource?: string;
-    /** ISO timestamp when the provider observed the winning verdict. */
-    verificationObservedAt?: string;
-    billingReplayed?: boolean;
-    /** True when the public result came from a completed response-idempotency reservation. */
-    idempotencyReplayed?: boolean;
-    creditsUsed?: number;
-    /** Canonical run ID alias returned alongside verificationRunId when available. */
-    runId?: string;
-    suggestedAction?: string;
-    raw: Record<string, unknown>;
 }
 interface VerifyEmailOptions {
     /** Resume an existing long verification without another provider call. */

package/dist/index.js

@@ -1951,6 +1951,16 @@ function normalizeFindEmailResult(data) {
     success: processing || !failed && found,
     found,
     email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    candidateSource: typeof data.candidate_source === "string" ? data.candidate_source : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     firstName: data.first_name,
     lastName: data.last_name,
     confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
@@ -1990,6 +2000,19 @@ function normalizeFindEmailResult(data) {
 function normalizeVerifyEmailResult(email, data) {
   data = publicProductData(data, "verify_email");
   const failed = coreProductResponseFailed(data);
+  const publicIsCatchAll = data.is_catch_all === true || data.email_is_catch_all === true;
+  const publicPrimaryResult = String(data.primary_verdict ?? "").toLowerCase();
+  const publicTerminalResult = String(data.terminal_result ?? "").toLowerCase();
+  const okToSend = !failed && (data.ok_to_send === true || publicPrimaryResult === "ok" || publicPrimaryResult === "catch_all" && publicTerminalResult === "deliverable");
+  return {
+    email: typeof data.email === "string" ? data.email : email || null,
+    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    isCatchAll: publicIsCatchAll,
+    creditsCharged: Number.isFinite(Number(data.credits_charged)) ? Number(data.credits_charged) : 0,
+    okToSend,
+    ...data.verification_run_id || data.run_id ? { verificationRunId: data.verification_run_id ?? data.run_id } : {},
+    ...data.next_poll_after_seconds !== void 0 ? { nextPollAfterSeconds: data.next_poll_after_seconds } : {}
+  };
   const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   const verificationStatus = normalizeVerifyEmailStatus(
     failed ? malformed ? "malformed" : "error" : data.verification_status ?? data.verification_verdict ?? data.deliverability_status ?? "unknown"
@@ -2004,6 +2027,15 @@ function normalizeVerifyEmailResult(email, data) {
     error: failed ? coreProductErrorMessage(data) : void 0,
     errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId,
     retryAfterMs: data.retry_after_ms,
@@ -2267,7 +2299,7 @@ function validateSignalDiscoveryParams(params) {
   const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
   const query = typeof params.query === "string" ? params.query.trim() : "";
   if (!runId && !query) {
-    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+    throw new TypeError("Signals First requires query or signalSearchRunId");
   }
   if (query && (query.length < 2 || query.length > 2e3)) {
     throw new RangeError("query must contain between 2 and 2000 characters");

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -1955,6 +1955,16 @@ function normalizeFindEmailResult(data) {
     success: processing || !failed && found,
     found,
     email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    candidateSource: typeof data.candidate_source === "string" ? data.candidate_source : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     firstName: data.first_name,
     lastName: data.last_name,
     confidence: failed ? 0 : data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
@@ -1994,6 +2004,19 @@ function normalizeFindEmailResult(data) {
 function normalizeVerifyEmailResult(email, data) {
   data = publicProductData(data, "verify_email");
   const failed = coreProductResponseFailed(data);
+  const publicIsCatchAll = data.is_catch_all === true || data.email_is_catch_all === true;
+  const publicPrimaryResult = String(data.primary_verdict ?? "").toLowerCase();
+  const publicTerminalResult = String(data.terminal_result ?? "").toLowerCase();
+  const okToSend = !failed && (data.ok_to_send === true || publicPrimaryResult === "ok" || publicPrimaryResult === "catch_all" && publicTerminalResult === "deliverable");
+  return {
+    email: typeof data.email === "string" ? data.email : email || null,
+    status: String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
+    isCatchAll: publicIsCatchAll,
+    creditsCharged: Number.isFinite(Number(data.credits_charged)) ? Number(data.credits_charged) : 0,
+    okToSend,
+    ...data.verification_run_id || data.run_id ? { verificationRunId: data.verification_run_id ?? data.run_id } : {},
+    ...data.next_poll_after_seconds !== void 0 ? { nextPollAfterSeconds: data.next_poll_after_seconds } : {}
+  };
   const malformed = data.is_malformed === true || data.verification_verdict === "malformed" || data.verification_status === "malformed" || data.deliverability_status === "malformed";
   const verificationStatus = normalizeVerifyEmailStatus(
     failed ? malformed ? "malformed" : "error" : data.verification_status ?? data.verification_verdict ?? data.deliverability_status ?? "unknown"
@@ -2008,6 +2031,15 @@ function normalizeVerifyEmailResult(email, data) {
     error: failed ? coreProductErrorMessage(data) : void 0,
     errorCode: failed ? coreProductErrorCode(data) : void 0,
     email: data.email ?? email,
+    checkedEmail: typeof data.checked_email === "string" ? data.checked_email : null,
+    primaryVerifier: typeof data.primary_verifier === "string" ? data.primary_verifier : null,
+    primaryVerdict: typeof data.primary_verdict === "string" ? data.primary_verdict : null,
+    terminalVerifier: typeof data.terminal_verifier === "string" ? data.terminal_verifier : null,
+    terminalVerdict: typeof data.terminal_verdict === "string" ? data.terminal_verdict : null,
+    terminalResult: typeof data.terminal_result === "string" ? data.terminal_result : null,
+    terminalIsCatchAll: typeof data.terminal_is_catch_all === "boolean" ? data.terminal_is_catch_all : null,
+    terminalIsAcceptAll: typeof data.terminal_is_accept_all === "boolean" ? data.terminal_is_accept_all : null,
+    bouncebanId: typeof data.bounceban_id === "string" ? data.bounceban_id : null,
     status: !failed && String(data.status || "").toLowerCase() === "processing" ? "processing" : "completed",
     verificationRunId,
     retryAfterMs: data.retry_after_ms,
@@ -2271,7 +2303,7 @@ function validateSignalDiscoveryParams(params) {
   const runId = typeof params.signalSearchRunId === "string" ? params.signalSearchRunId.trim() : "";
   const query = typeof params.query === "string" ? params.query.trim() : "";
   if (!runId && !query) {
-    throw new TypeError("Signals Everything requires query or signalSearchRunId");
+    throw new TypeError("Signals First requires query or signalSearchRunId");
   }
   if (query && (query.length < 2 || query.length > 2e3)) {
     throw new RangeError("query must contain between 2 and 2000 characters");

package/dist/mcp-config.mjs

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/sdk",
-  "version": "1.0.72",
+  "version": "1.0.73",
   "description": "Signaliz SDK for Company Signal Enrichment, Signals First, Signal Awareness, Signal to Copy AI, and Signaliz Flow.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",