groundmail-cli 0.17.1 → 0.18.1

package/dist/cli.js

@@ -1288,7 +1288,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.17.1";
+var version = "0.18.1";
 
 // src/user-agent.ts
 function buildUserAgent(own) {
@@ -3229,6 +3229,28 @@ async function runMigrateCommand(provider, args, env = process.env) {
   }
 }
 
+// src/commands/validate.ts
+async function runValidateCommand(args, env = process.env) {
+  const options = parseSuppressionsCommonArgs(args);
+  const apiKey = resolveApiKey6(options, env);
+  if (!apiKey) {
+    return { exitCode: 1, error: "Missing API key. Set GROUNDMAIL_API_KEY, pass --api-key, or run `groundmail login`." };
+  }
+  const flagValues = new Set([options.apiKey, options.baseUrl].filter(Boolean));
+  const email = readFlag18(args, "--email") || args.find((arg) => arg.includes("@") && !arg.startsWith("-") && !flagValues.has(arg));
+  if (!email) {
+    return { exitCode: 1, error: "Missing email. Usage: groundmail validate user@example.com" };
+  }
+  try {
+    const client = await createSuppressionsClient(apiKey, options.baseUrl);
+    const result = await client.validate(email);
+    console.log(JSON.stringify(result));
+    return { exitCode: result.verdict === "invalid" ? 2 : 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
+
 // src/help.ts
 var USAGE_LINES = [
   "  groundmail login [--scope <scopes>] [--workspace <name>]   sign in through the browser (OAuth; no key to copy)",
@@ -3270,6 +3292,7 @@ var USAGE_LINES = [
   "  groundmail webhooks get --id wh_\u2026",
   "  groundmail webhooks update --id wh_\u2026 [--url \u2026] [--event email.sent] [--enabled true|false]",
   "  groundmail webhooks delete --id <webhook-id>",
+  "  groundmail validate user@example.com   Groundmail validation: verdict, reasons, typo suggestion (exit 2 when invalid)",
   "  groundmail suppressions list",
   "  groundmail suppressions add --email user@example.com [--reason \u2026]",
   "  groundmail suppressions remove --id <id> | --email user@example.com",
@@ -3381,6 +3404,7 @@ async function main() {
   if (session.notice) console.error(session.notice);
   const rest = session.argv;
   if (command === "migrate") await finish(await runMigrateCommand(subcommand, rest));
+  if (command === "validate") await finish(await runValidateCommand([...subcommand ? [subcommand] : [], ...rest]));
   if (command === "domains") {
     if (subcommand === "add" || subcommand === "create") {
       const result = await runAddCommand(rest);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-cli",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "description": "Groundmail CLI — send transactional email from the terminal",
   "license": "MIT",
   "type": "module",
@@ -38,7 +38,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "groundmail": "0.14.7"
+    "groundmail": "0.15.1"
   },
   "devDependencies": {
     "tsup": "^8.5.0",