@signaliz/sdk 1.0.36 → 1.0.38

package/README.md

@@ -70,6 +70,13 @@ const verifiedBatch = await signaliz.verifyEmails(emails, { concurrency: 20 });
 const foundBatch = await signaliz.findEmails(contacts, { concurrency: 20 });
 const signalBatch = await signaliz.enrichCompanies(companies, { concurrency: 5 });
 const copyBatch = await signaliz.createSignalCopyBatch(copyRequests, { concurrency: 5 });
+
+// Keep one full result for exact repeats and return duplicateOf references for
+// the rest. This is lossless and avoids multiplying evidence-rich payloads.
+const compactSignals = await signaliz.enrichCompanies(companies, {
+  concurrency: 5,
+  compactDuplicates: true,
+});
 ```
 
 For an ambiguous submission failure, retry with the same
@@ -81,7 +88,10 @@ 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.
 Exact duplicate tasks are single-flighted across each full batch without
-changing input order or result cardinality. Find Email and Verify Email batches
+changing input order or result cardinality. Set `compactDuplicates: true` to
+return repeated successful rows as `duplicateOf` references to the zero-based
+canonical input index; the default remains expanded for compatibility. Find Email and Verify Email
+batches
 larger than 25 use one cache-aware recoverable REST job with 500-row result
 pages. Uniform Company Signal Enrichment batches larger than 25 use one
 cache-aware recoverable REST job with 25-row result pages; heterogeneous,

package/dist/{chunk-WKE2PNXT.mjs → chunk-ZIYVY22X.mjs}

@@ -22,16 +22,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -368,7 +371,8 @@ var Signaliz = class {
       params.length,
       startedAt,
       round,
-      (item) => normalizeFindEmailResult(item.raw)
+      (item) => normalizeFindEmailResult(item.raw),
+      options
     );
   }
   async verifyEmail(email, options) {
@@ -393,7 +397,8 @@ var Signaliz = class {
       emails.length,
       startedAt,
       round,
-      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw)
+      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw),
+      options
     );
   }
   async enrichCompanySignals(params) {
@@ -488,13 +493,14 @@ var Signaliz = class {
       await sleep2(Math.max(1, nextDelayMs));
       pending = nextPending;
     }
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: companies.length,
       succeeded,
       failed: companies.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async signalToCopy(params) {
@@ -535,13 +541,14 @@ var Signaliz = class {
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
     }));
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: requests.length,
       succeeded,
       failed: requests.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async runSignalCopyBatchChunks(uniqueRequests, options) {
@@ -994,7 +1001,7 @@ function dedupeExactBatchItems(items, keyForItem) {
   }
   return { uniqueItems, sourceIndexByInput };
 }
-function finalizeCoreBatch(total, startedAt, round, normalize) {
+function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
@@ -1011,15 +1018,31 @@ function finalizeCoreBatch(total, startedAt, round, normalize) {
       };
     }
   }
-  const succeeded = results.filter((item) => item.success).length;
+  const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+  const succeeded = compactedResults.filter((item) => item.success).length;
   return {
     total,
     succeeded,
     failed: total - succeeded,
     durationMs: Date.now() - startedAt,
-    results
+    results: compactedResults
   };
 }
+function compactExactDuplicateResults(results, enabled) {
+  if (!enabled) return results;
+  const sourceIndexByRaw = /* @__PURE__ */ new WeakMap();
+  return results.map((item) => {
+    if (!item.success || !item.data || typeof item.data !== "object") return item;
+    const raw = item.data.raw;
+    if (!raw || typeof raw !== "object") return item;
+    const duplicateOf = sourceIndexByRaw.get(raw);
+    if (duplicateOf !== void 0) {
+      return { index: item.index, success: true, duplicateOf };
+    }
+    sourceIndexByRaw.set(raw, item.index);
+    return item;
+  });
+}
 function signalToCopyRequestBody(params) {
   return compact({
     company_domain: params.companyDomain,

package/dist/index.d.mts

@@ -11,12 +11,16 @@ interface BatchOptions {
     concurrency?: number;
     /** Stable key for safely retrying an ambiguous recoverable batch submission. */
     idempotencyKey?: string;
+    /** Return exact repeated successes as duplicateOf references. Defaults to false. */
+    compactDuplicates?: boolean;
 }
 interface BatchItemResult<T> {
     index: number;
     success: boolean;
     data?: T;
     error?: string;
+    /** Zero-based input index containing the full result for this exact duplicate. */
+    duplicateOf?: number;
 }
 interface BatchResult<T> {
     total: number;

package/dist/index.d.ts

@@ -11,12 +11,16 @@ interface BatchOptions {
     concurrency?: number;
     /** Stable key for safely retrying an ambiguous recoverable batch submission. */
     idempotencyKey?: string;
+    /** Return exact repeated successes as duplicateOf references. Defaults to false. */
+    compactDuplicates?: boolean;
 }
 interface BatchItemResult<T> {
     index: number;
     success: boolean;
     data?: T;
     error?: string;
+    /** Zero-based input index containing the full result for this exact duplicate. */
+    duplicateOf?: number;
 }
 interface BatchResult<T> {
     total: number;

package/dist/index.js

@@ -49,16 +49,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -395,7 +398,8 @@ var Signaliz = class {
       params.length,
       startedAt,
       round,
-      (item) => normalizeFindEmailResult(item.raw)
+      (item) => normalizeFindEmailResult(item.raw),
+      options
     );
   }
   async verifyEmail(email, options) {
@@ -420,7 +424,8 @@ var Signaliz = class {
       emails.length,
       startedAt,
       round,
-      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw)
+      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw),
+      options
     );
   }
   async enrichCompanySignals(params) {
@@ -515,13 +520,14 @@ var Signaliz = class {
       await sleep2(Math.max(1, nextDelayMs));
       pending = nextPending;
     }
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: companies.length,
       succeeded,
       failed: companies.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async signalToCopy(params) {
@@ -562,13 +568,14 @@ var Signaliz = class {
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
     }));
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: requests.length,
       succeeded,
       failed: requests.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async runSignalCopyBatchChunks(uniqueRequests, options) {
@@ -1021,7 +1028,7 @@ function dedupeExactBatchItems(items, keyForItem) {
   }
   return { uniqueItems, sourceIndexByInput };
 }
-function finalizeCoreBatch(total, startedAt, round, normalize) {
+function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
@@ -1038,15 +1045,31 @@ function finalizeCoreBatch(total, startedAt, round, normalize) {
       };
     }
   }
-  const succeeded = results.filter((item) => item.success).length;
+  const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+  const succeeded = compactedResults.filter((item) => item.success).length;
   return {
     total,
     succeeded,
     failed: total - succeeded,
     durationMs: Date.now() - startedAt,
-    results
+    results: compactedResults
   };
 }
+function compactExactDuplicateResults(results, enabled) {
+  if (!enabled) return results;
+  const sourceIndexByRaw = /* @__PURE__ */ new WeakMap();
+  return results.map((item) => {
+    if (!item.success || !item.data || typeof item.data !== "object") return item;
+    const raw = item.data.raw;
+    if (!raw || typeof raw !== "object") return item;
+    const duplicateOf = sourceIndexByRaw.get(raw);
+    if (duplicateOf !== void 0) {
+      return { index: item.index, success: true, duplicateOf };
+    }
+    sourceIndexByRaw.set(raw, item.index);
+    return item;
+  });
+}
 function signalToCopyRequestBody(params) {
   return compact({
     company_domain: params.companyDomain,

package/dist/index.mjs

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

package/dist/mcp-config.js

@@ -53,16 +53,19 @@ function parseError(status, body) {
       details: body.error.details
     });
   }
+  const code = typeof body?.error_code === "string" && body.error_code.trim() ? body.error_code.trim() : `HTTP_${status}`;
   return new SignalizError({
-    code: `HTTP_${status}`,
+    code,
     message: body?.message || body?.error || `Request failed with status ${status}`,
-    errorType: mapErrorType(void 0, status)
+    errorType: mapErrorType(code, status),
+    details: body?.details || (body?.retry_eligible !== void 0 ? { retry_eligible: body.retry_eligible } : void 0)
   });
 }
 function mapErrorType(code, status) {
   if (code === "RATE_LIMITED" || status === 429) return "rate_limited";
   if (code === "VALIDATION_ERROR" || status === 400) return "validation";
   if (code === "NOT_FOUND" || status === 404) return "not_found";
+  if (code === "NO_SUPPORTED_SIGNAL") return "not_found";
   if (code === "AUTH_EXPIRED" || status === 401) return "auth_expired";
   if (code === "INSUFFICIENT_CREDITS" || status === 402) return "insufficient_credits";
   if (code === "TIMEOUT" || status === 504) return "timeout";
@@ -399,7 +402,8 @@ var Signaliz = class {
       params.length,
       startedAt,
       round,
-      (item) => normalizeFindEmailResult(item.raw)
+      (item) => normalizeFindEmailResult(item.raw),
+      options
     );
   }
   async verifyEmail(email, options) {
@@ -424,7 +428,8 @@ var Signaliz = class {
       emails.length,
       startedAt,
       round,
-      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw)
+      (item) => normalizeVerifyEmailResult(emails[item.index], item.raw),
+      options
     );
   }
   async enrichCompanySignals(params) {
@@ -519,13 +524,14 @@ var Signaliz = class {
       await sleep2(Math.max(1, nextDelayMs));
       pending = nextPending;
     }
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: companies.length,
       succeeded,
       failed: companies.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async signalToCopy(params) {
@@ -566,13 +572,14 @@ var Signaliz = class {
       ...uniqueResults[deduplicated.sourceIndexByInput[index]],
       index
     }));
-    const succeeded = results.filter((item) => item.success).length;
+    const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+    const succeeded = compactedResults.filter((item) => item.success).length;
     return {
       total: requests.length,
       succeeded,
       failed: requests.length - succeeded,
       durationMs: Date.now() - startedAt,
-      results
+      results: compactedResults
     };
   }
   async runSignalCopyBatchChunks(uniqueRequests, options) {
@@ -1025,7 +1032,7 @@ function dedupeExactBatchItems(items, keyForItem) {
   }
   return { uniqueItems, sourceIndexByInput };
 }
-function finalizeCoreBatch(total, startedAt, round, normalize) {
+function finalizeCoreBatch(total, startedAt, round, normalize, options) {
   const results = new Array(total);
   for (const item of round) {
     if (!item.success || !item.raw) {
@@ -1042,15 +1049,31 @@ function finalizeCoreBatch(total, startedAt, round, normalize) {
       };
     }
   }
-  const succeeded = results.filter((item) => item.success).length;
+  const compactedResults = compactExactDuplicateResults(results, options?.compactDuplicates === true);
+  const succeeded = compactedResults.filter((item) => item.success).length;
   return {
     total,
     succeeded,
     failed: total - succeeded,
     durationMs: Date.now() - startedAt,
-    results
+    results: compactedResults
   };
 }
+function compactExactDuplicateResults(results, enabled) {
+  if (!enabled) return results;
+  const sourceIndexByRaw = /* @__PURE__ */ new WeakMap();
+  return results.map((item) => {
+    if (!item.success || !item.data || typeof item.data !== "object") return item;
+    const raw = item.data.raw;
+    if (!raw || typeof raw !== "object") return item;
+    const duplicateOf = sourceIndexByRaw.get(raw);
+    if (duplicateOf !== void 0) {
+      return { index: item.index, success: true, duplicateOf };
+    }
+    sourceIndexByRaw.set(raw, item.index);
+    return item;
+  });
+}
 function signalToCopyRequestBody(params) {
   return compact({
     company_domain: params.companyDomain,

package/dist/mcp-config.mjs

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

package/package.json

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