@signaliz/sdk 1.0.26 → 1.0.28

package/README.md

@@ -36,6 +36,9 @@ const signals = await signaliz.enrichCompanySignals({
   companyDomain: 'example.com',
   researchPrompt: 'expansion priorities',
 });
+// Audit normalized evidence provenance without reaching into `raw`.
+console.log(signals.signals[0].evidencePublishedDate);
+console.log(signals.signals[0].signalFeedSource, signals.signals[0].derived);
 
 // Persist a no-wait run ID and resume it later without duplicate spend.
 const queuedSignals = await signaliz.enrichCompanySignals({
@@ -83,5 +86,8 @@ normally finishes within an agent turn; set `skipCache` or `enableDeepSearch`
 only when fresh or deeper research is required.
 Unclassified evidence is returned by signal enrichment but is not used to
 generate outreach copy.
+Each normalized signal also exposes `datePrecision`, `sourceProvenance`,
+`entityConfidence`, `classification`, `derived`, `evidencePublishedDate`,
+`signalFeedSource`, and the provider `metadata` needed for integrity audits.
 
 `listTools()` and `health()` are connection helpers, not additional products.

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

@@ -365,7 +365,12 @@ 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());
+    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,
@@ -374,6 +379,13 @@ var Signaliz = class {
       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",
@@ -459,16 +471,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        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,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? 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,

package/dist/index.d.mts

@@ -49,6 +49,13 @@ interface FindEmailResult {
     lastName?: string;
     confidence: number;
     verificationStatus: string;
+    isVerified: boolean;
+    isVerifiedForSending: boolean;
+    isCatchAll: boolean;
+    verificationFreshness: 'fresh' | 'stale' | 'unknown';
+    verificationAgeDays: number | null;
+    verifiedAt: string | null;
+    needsReverification: boolean;
     providerUsed: string;
     error?: string;
     errorCode?: string;
@@ -97,9 +104,20 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    datePrecision?: string;
     sourceUrl?: string | null;
     sourceType?: string;
+    sourceProvenance?: string;
     confidence?: number | null;
+    entityConfidence?: number | null;
+    signalFamily?: string;
+    eventType?: string;
+    eventLabel?: string;
+    classification?: Record<string, unknown> | string | null;
+    derived?: boolean;
+    evidencePublishedDate?: string | null;
+    signalFeedSource?: string;
+    metadata?: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;

package/dist/index.d.ts

@@ -49,6 +49,13 @@ interface FindEmailResult {
     lastName?: string;
     confidence: number;
     verificationStatus: string;
+    isVerified: boolean;
+    isVerifiedForSending: boolean;
+    isCatchAll: boolean;
+    verificationFreshness: 'fresh' | 'stale' | 'unknown';
+    verificationAgeDays: number | null;
+    verifiedAt: string | null;
+    needsReverification: boolean;
     providerUsed: string;
     error?: string;
     errorCode?: string;
@@ -97,9 +104,20 @@ interface CompanySignal {
     type: string;
     content: string;
     date?: string | null;
+    datePrecision?: string;
     sourceUrl?: string | null;
     sourceType?: string;
+    sourceProvenance?: string;
     confidence?: number | null;
+    entityConfidence?: number | null;
+    signalFamily?: string;
+    eventType?: string;
+    eventLabel?: string;
+    classification?: Record<string, unknown> | string | null;
+    derived?: boolean;
+    evidencePublishedDate?: string | null;
+    signalFeedSource?: string;
+    metadata?: Record<string, unknown>;
 }
 interface CompanySignalEnrichmentResult {
     success: boolean;

package/dist/index.js

@@ -392,7 +392,12 @@ 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());
+    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,
@@ -401,6 +406,13 @@ var Signaliz = class {
       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",
@@ -486,16 +498,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        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,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? 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,

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -396,7 +396,12 @@ 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());
+    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,
@@ -405,6 +410,13 @@ var Signaliz = class {
       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",
@@ -490,16 +502,30 @@ var Signaliz = class {
         name: data.company?.name ?? params.companyName ?? null,
         domain: data.company?.domain ?? params.companyDomain ?? null
       },
-      signals: (data.signals ?? []).map((signal) => ({
-        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,
-        sourceUrl: signal.source_url ?? signal.url ?? null,
-        sourceType: signal.source_type,
-        confidence: signal.confidence ?? signal.confidence_score ?? 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,

package/dist/mcp-config.mjs

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

package/package.json

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