@signaliz/cli 1.0.43 → 1.0.45

package/README.md

@@ -18,6 +18,8 @@ signaliz find-email --company-domain example.com --full-name "Jane Doe" --skip-c
 signaliz verify-email jane@example.com
 # Force a fresh-provider verification instead of reusing cached proof
 signaliz verify-email jane@example.com --skip-cache
+# Preview any single or batch product request without provider calls or credits
+signaliz verify-email jane@example.com --dry-run --json
 # Return early when a provider check runs long, then resume the exact run
 signaliz verify-email jane@example.com --skip-cache --no-wait --json
 signaliz verify-email --verification-run-id run_... --json
@@ -67,9 +69,14 @@ generate-company-rows | signaliz company-signals --input - --jsonl --omit-raw
 
 JSONL writes one `{ "type": "result", ... }` line per input followed by one
 `{ "type": "summary", ... }` line. Input order and cardinality are preserved.
-
-If a batch submission response is lost, rerun the same command with
-`--idempotency-key <key>` to recover the original job without duplicate work.
+Failed result lines preserve `errorCode`, `retryEligible`, and
+`retryAfterSeconds` when the API supplies recovery guidance.
+
+If a single request or batch submission response is lost, rerun the same
+command with `--idempotency-key <key>` to recover the original request or job
+without duplicate work. Add `--dry-run` to any product command, including one
+using `--input`, to receive a conservative credit ceiling without provider
+calls, jobs, writes, or spend.
 
 Batch input is capped at 5,000 records, concurrency is bounded to `1-50`, input
 order is preserved, and a failed item does not abort successful items.

package/dist/bin.js

@@ -39,7 +39,8 @@ Common flags:
   --input <json-or-jsonl-file>  Batch up to 5,000 records with any product command
   --input -                     Read a JSON array or JSONL batch from stdin
   --concurrency <1-50>          Simultaneous API requests for batch input (default: 10)
-  --idempotency-key <key>       Reuse after an ambiguous batch submission to recover the same job
+  --idempotency-key <key>       Reuse after an ambiguous response to recover the same request or job
+  --dry-run                     Return a no-spend plan without provider calls, jobs, or writes
 `;
 function loadConfig() {
   if (!(0, import_node_fs.existsSync)(CONFIG_FILE)) return {};
@@ -143,6 +144,15 @@ function batchOutput(value) {
     if (value.failed > 0) process.stdout.write("Use --json to inspect per-record errors.\n");
   });
 }
+function dryRunOutput(value) {
+  output(value, () => {
+    process.stdout.write(`Planned ${value.inputCount} ${value.capability} request(s).
+`);
+    process.stdout.write(`Maximum estimated credits: ${value.estimatedCredits.max}
+`);
+    process.stdout.write("No provider calls, jobs, writes, or credits were used.\n");
+  });
+}
 function resolveApiKey() {
   const key = process.env.SIGNALIZ_API_KEY || loadConfig().apiKey;
   if (!key) fail("No API key configured. Run: signaliz auth login");
@@ -238,7 +248,7 @@ async function auth(args) {
 async function findEmail() {
   const rows = readBatchInput();
   if (rows) {
-    const result2 = await createClient().findEmails(rows.map((value) => {
+    const requests = rows.map((value) => {
       const row = record(value);
       return {
         companyDomain: row.companyDomain || row.company_domain || row.domain,
@@ -249,7 +259,13 @@ async function findEmail() {
         companyName: row.companyName || row.company_name,
         skipCache: row.skipCache ?? row.skip_cache ?? hasFlag("skip-cache")
       };
-    }), batchOptions());
+    });
+    if (hasFlag("dry-run")) {
+      const result3 = await createClient().findEmails(requests, { ...batchOptions(), dryRun: true });
+      dryRunOutput(result3);
+      return;
+    }
+    const result2 = await createClient().findEmails(requests, batchOptions());
     batchOutput(result2);
     return;
   }
@@ -261,15 +277,22 @@ async function findEmail() {
   if (!companyDomain || !fullName && !(firstName && lastName)) {
     fail('Usage: signaliz find-email --company-domain example.com --full-name "Jane Doe"');
   }
-  const result = await createClient().findEmail({
+  const request = {
     companyDomain,
     fullName,
     firstName,
     lastName,
     linkedinUrl,
     companyName: flag("company-name"),
-    skipCache: hasFlag("skip-cache")
-  });
+    skipCache: hasFlag("skip-cache"),
+    idempotencyKey: flag("idempotency-key")
+  };
+  if (hasFlag("dry-run")) {
+    const result2 = await createClient().findEmail({ ...request, dryRun: true });
+    dryRunOutput(result2);
+    return;
+  }
+  const result = await createClient().findEmail(request);
   output(result, () => {
     process.stdout.write(`${result.email || "No email found"} (${result.verificationStatus})
 `);
@@ -286,6 +309,15 @@ async function verifyEmail(args) {
   const rows = readBatchInput();
   if (rows) {
     const emails = rows.map((value) => typeof value === "string" ? value : String(record(value).email || ""));
+    if (hasFlag("dry-run")) {
+      const result3 = await createClient().verifyEmails(emails, {
+        ...batchOptions(),
+        skipCache: hasFlag("skip-cache"),
+        dryRun: true
+      });
+      dryRunOutput(result3);
+      return;
+    }
     const result2 = await createClient().verifyEmails(emails, {
       ...batchOptions(),
       skipCache: hasFlag("skip-cache")
@@ -296,13 +328,20 @@ async function verifyEmail(args) {
   const email = args[0] && !args[0].startsWith("--") ? args[0] : flag("email");
   const verificationRunId = flag("verification-run-id");
   if (!email && !verificationRunId) fail("Usage: signaliz verify-email [jane@example.com] [--verification-run-id run_...]");
-  const result = await createClient().verifyEmail(email, {
+  const options = {
     skipCache: hasFlag("skip-cache"),
     verificationRunId,
     waitForResult: !hasFlag("no-wait"),
     maxWaitMs: numberFlag("max-wait-ms"),
-    pollIntervalMs: numberFlag("poll-interval-ms")
-  });
+    pollIntervalMs: numberFlag("poll-interval-ms"),
+    idempotencyKey: flag("idempotency-key")
+  };
+  if (hasFlag("dry-run")) {
+    const result2 = await createClient().verifyEmail(email, { ...options, dryRun: true });
+    dryRunOutput(result2);
+    return;
+  }
+  const result = await createClient().verifyEmail(email, options);
   output(result, () => {
     if (result.status === "processing") {
       process.stdout.write(`Verification processing: ${result.verificationRunId}
@@ -321,7 +360,7 @@ Catch-all: ${result.isCatchAll}
 async function companySignals() {
   const rows = readBatchInput();
   if (rows) {
-    const result2 = await createClient().enrichCompanies(rows.map((value) => {
+    const requests = rows.map((value) => {
       const row = record(value);
       const online = row.online ?? !hasFlag("offline");
       return {
@@ -342,7 +381,13 @@ async function companySignals() {
         maxWaitMs: row.maxWaitMs || row.max_wait_ms || numberFlag("max-wait-ms"),
         pollIntervalMs: row.pollIntervalMs || row.poll_interval_ms || numberFlag("poll-interval-ms")
       };
-    }), batchOptions());
+    });
+    if (hasFlag("dry-run")) {
+      const result3 = await createClient().enrichCompanies(requests, { ...batchOptions(), dryRun: true });
+      dryRunOutput(result3);
+      return;
+    }
+    const result2 = await createClient().enrichCompanies(requests, batchOptions());
     batchOutput(result2);
     return;
   }
@@ -350,7 +395,7 @@ async function companySignals() {
   const companyName = flag("company-name");
   const signalRunId = flag("signal-run-id");
   if (!companyDomain && !companyName && !signalRunId) fail("Usage: signaliz company-signals --domain example.com");
-  const result = await createClient().enrichCompanySignals({
+  const request = {
     signalRunId,
     companyDomain,
     companyName,
@@ -366,8 +411,15 @@ async function companySignals() {
     skipCache: hasFlag("skip-cache"),
     waitForResult: !hasFlag("no-wait"),
     maxWaitMs: numberFlag("max-wait-ms"),
-    pollIntervalMs: numberFlag("poll-interval-ms")
-  });
+    pollIntervalMs: numberFlag("poll-interval-ms"),
+    idempotencyKey: flag("idempotency-key")
+  };
+  if (hasFlag("dry-run")) {
+    const result2 = await createClient().enrichCompanySignals({ ...request, dryRun: true });
+    dryRunOutput(result2);
+    return;
+  }
+  const result = await createClient().enrichCompanySignals(request);
   output(result, () => {
     process.stdout.write(`Company: ${result.company.name || result.company.domain}
 Signals: ${result.signalCount}
@@ -381,7 +433,7 @@ Signals: ${result.signalCount}
 async function signalToCopy() {
   const rows = readBatchInput();
   if (rows) {
-    const result2 = await createClient().createSignalCopyBatch(rows.map((value) => {
+    const requests = rows.map((value) => {
       const row = record(value);
       return {
         companyDomain: row.companyDomain || row.company_domain || row.domain,
@@ -396,7 +448,13 @@ async function signalToCopy() {
         maxWaitMs: row.maxWaitMs || row.max_wait_ms || numberFlag("max-wait-ms"),
         pollIntervalMs: row.pollIntervalMs || row.poll_interval_ms || numberFlag("poll-interval-ms")
       };
-    }), batchOptions());
+    });
+    if (hasFlag("dry-run")) {
+      const result3 = await createClient().createSignalCopyBatch(requests, { ...batchOptions(), dryRun: true });
+      dryRunOutput(result3);
+      return;
+    }
+    const result2 = await createClient().createSignalCopyBatch(requests, batchOptions());
     batchOutput(result2);
     return;
   }
@@ -408,7 +466,7 @@ async function signalToCopy() {
   if (!signalRunId && (!companyDomain || !personName || !title || !campaignOffer)) {
     fail('Usage: signaliz signal-to-copy --company-domain example.com --person-name "Jane Doe" --title "VP Sales" --campaign-offer "pipeline intelligence" OR signaliz signal-to-copy --signal-run-id copy_...');
   }
-  const result = await createClient().signalToCopy({
+  const request = {
     companyDomain,
     personName,
     title,
@@ -418,8 +476,15 @@ async function signalToCopy() {
     skipCache: hasFlag("skip-cache"),
     enableDeepSearch: hasFlag("deep-search"),
     maxWaitMs: numberFlag("max-wait-ms"),
-    pollIntervalMs: numberFlag("poll-interval-ms")
-  });
+    pollIntervalMs: numberFlag("poll-interval-ms"),
+    idempotencyKey: flag("idempotency-key")
+  };
+  if (hasFlag("dry-run")) {
+    const result2 = await createClient().signalToCopy({ ...request, dryRun: true });
+    dryRunOutput(result2);
+    return;
+  }
+  const result = await createClient().signalToCopy(request);
   output(result, () => {
     if (result.variations.length === 0) {
       process.stdout.write(`${String(result.raw.message || "Signal research completed without supported evidence.")}
@@ -517,6 +582,10 @@ main().catch((error) => {
       error_code: signalizError?.code || "CLI_ERROR",
       message,
       retry_eligible: signalizError?.isRetryable ?? false,
+      ...signalizError?.retryAfter !== void 0 ? {
+        retry_after: signalizError.retryAfter,
+        retry_after_seconds: signalizError.retryAfter
+      } : {},
       ...signalizError?.errorType ? { error_type: signalizError.errorType } : {},
       ...signalizError?.details ? { details: signalizError.details } : {}
     }, hasFlag("json") ? 2 : void 0)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "description": "Signaliz CLI for Find Email, Verify Email, Company Signal Enrichment, and Signal to Copy AI.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -28,7 +28,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.43"
+    "@signaliz/sdk": "^1.0.47"
   },
   "devDependencies": {
     "tsup": "^8.0.0",