@signaliz/sdk 1.0.24 → 1.0.26

package/README.md

@@ -27,7 +27,10 @@ const found = await signaliz.findEmail({
   skipCache: true,
 });
 
-const verified = await signaliz.verifyEmail(found.email!);
+const verified = await signaliz.verifyEmail(found.email!, {
+  // Optional: bypass cached verification proof for a fresh-provider check.
+  skipCache: true,
+});
 
 const signals = await signaliz.enrichCompanySignals({
   companyDomain: 'example.com',

package/dist/{chunk-GWTSOG6D.mjs → chunk-XRSWZ62S.mjs}

@@ -364,15 +364,17 @@ var Signaliz = class {
     }));
     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 verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      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
@@ -381,8 +383,11 @@ var Signaliz = class {
   async findEmails(params, options) {
     return runBatch(params, (item) => this.findEmail(item), options);
   }
-  async verifyEmail(email) {
-    const data = await this.client.post("api/v1/verify-email", { email });
+  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 {
@@ -397,7 +402,7 @@ var Signaliz = class {
     };
   }
   async verifyEmails(emails, options) {
-    return runBatch(emails, (email) => this.verifyEmail(email), options);
+    return runBatch(emails, (email) => this.verifyEmail(email, { skipCache: options?.skipCache }), options);
   }
   async enrichCompanySignals(params) {
     const online = params.online ?? true;

package/dist/index.d.mts

@@ -64,6 +64,12 @@ interface VerifyEmailResult {
     verificationSource?: string;
     raw: Record<string, unknown>;
 }
+interface VerifyEmailOptions {
+    /** Bypass cached verification data for a fresh-provider quality check. */
+    skipCache?: boolean;
+}
+interface VerifyEmailBatchOptions extends BatchOptions, VerifyEmailOptions {
+}
 interface CompanySignalEnrichmentParams {
     /** Resume an existing enrichment without creating another provider run. */
     signalRunId?: string;
@@ -173,8 +179,8 @@ declare class Signaliz {
     constructor(config: SignalizConfig);
     findEmail(params: FindEmailParams): Promise<FindEmailResult>;
     findEmails(params: FindEmailParams[], options?: BatchOptions): Promise<BatchResult<FindEmailResult>>;
-    verifyEmail(email: string): Promise<VerifyEmailResult>;
-    verifyEmails(emails: string[], options?: BatchOptions): Promise<BatchResult<VerifyEmailResult>>;
+    verifyEmail(email: string, options?: VerifyEmailOptions): Promise<VerifyEmailResult>;
+    verifyEmails(emails: string[], options?: VerifyEmailBatchOptions): Promise<BatchResult<VerifyEmailResult>>;
     enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise<CompanySignalEnrichmentResult>;
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise<BatchResult<CompanySignalEnrichmentResult>>;
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
@@ -183,4 +189,4 @@ declare class Signaliz {
     health(): Promise<PlatformHealth>;
 }
 
-export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailResult };
+export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };

package/dist/index.d.ts

@@ -64,6 +64,12 @@ interface VerifyEmailResult {
     verificationSource?: string;
     raw: Record<string, unknown>;
 }
+interface VerifyEmailOptions {
+    /** Bypass cached verification data for a fresh-provider quality check. */
+    skipCache?: boolean;
+}
+interface VerifyEmailBatchOptions extends BatchOptions, VerifyEmailOptions {
+}
 interface CompanySignalEnrichmentParams {
     /** Resume an existing enrichment without creating another provider run. */
     signalRunId?: string;
@@ -173,8 +179,8 @@ declare class Signaliz {
     constructor(config: SignalizConfig);
     findEmail(params: FindEmailParams): Promise<FindEmailResult>;
     findEmails(params: FindEmailParams[], options?: BatchOptions): Promise<BatchResult<FindEmailResult>>;
-    verifyEmail(email: string): Promise<VerifyEmailResult>;
-    verifyEmails(emails: string[], options?: BatchOptions): Promise<BatchResult<VerifyEmailResult>>;
+    verifyEmail(email: string, options?: VerifyEmailOptions): Promise<VerifyEmailResult>;
+    verifyEmails(emails: string[], options?: VerifyEmailBatchOptions): Promise<BatchResult<VerifyEmailResult>>;
     enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise<CompanySignalEnrichmentResult>;
     enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise<BatchResult<CompanySignalEnrichmentResult>>;
     signalToCopy(params: SignalToCopyParams): Promise<SignalToCopyResult>;
@@ -183,4 +189,4 @@ declare class Signaliz {
     health(): Promise<PlatformHealth>;
 }
 
-export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailResult };
+export { type BatchItemResult, type BatchOptions, type BatchResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type PlatformHealth, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailResult };

package/dist/index.js

@@ -391,15 +391,17 @@ var Signaliz = class {
     }));
     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 verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      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
@@ -408,8 +410,11 @@ var Signaliz = class {
   async findEmails(params, options) {
     return runBatch(params, (item) => this.findEmail(item), options);
   }
-  async verifyEmail(email) {
-    const data = await this.client.post("api/v1/verify-email", { email });
+  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 {
@@ -424,7 +429,7 @@ var Signaliz = class {
     };
   }
   async verifyEmails(emails, options) {
-    return runBatch(emails, (email) => this.verifyEmail(email), options);
+    return runBatch(emails, (email) => this.verifyEmail(email, { skipCache: options?.skipCache }), options);
   }
   async enrichCompanySignals(params) {
     const online = params.online ?? true;

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -395,15 +395,17 @@ var Signaliz = class {
     }));
     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 verified = data.email_verified === true || data.verified_for_sending === true || ["valid", "deliverable"].includes(String(verificationStatus).toLowerCase());
     return {
       success: data.success !== false && found,
       found,
       email,
       firstName: data.first_name,
       lastName: data.last_name,
-      confidence: data.confidence ?? data.confidence_score ?? 0,
-      verificationStatus: data.verification_status ?? data.status ?? "unknown",
-      providerUsed: data.provider_used ?? data.provider ?? data.source ?? "unknown",
+      confidence: data.confidence ?? data.confidence_score ?? (verified ? 1 : 0),
+      verificationStatus,
+      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
@@ -412,8 +414,11 @@ var Signaliz = class {
   async findEmails(params, options) {
     return runBatch(params, (item) => this.findEmail(item), options);
   }
-  async verifyEmail(email) {
-    const data = await this.client.post("api/v1/verify-email", { email });
+  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 {
@@ -428,7 +433,7 @@ var Signaliz = class {
     };
   }
   async verifyEmails(emails, options) {
-    return runBatch(emails, (email) => this.verifyEmail(email), options);
+    return runBatch(emails, (email) => this.verifyEmail(email, { skipCache: options?.skipCache }), options);
   }
   async enrichCompanySignals(params) {
     const online = params.online ?? true;

package/dist/mcp-config.mjs

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

package/package.json

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