groundmail-cli 0.42.0 → 0.43.0

package/dist/cli.js

@@ -2113,7 +2113,7 @@ function trimUrl(value) {
 }
 
 // package.json
-var version = "0.42.0";
+var version = "0.43.0";
 
 // src/user-agent.ts
 var AGENT_ENV = [
@@ -4967,11 +4967,17 @@ var VALUE_FLAGS6 = [
   "--text",
   "--html",
   "--idempotency-key",
-  "--forward-from"
+  "--forward-from",
+  "--owner-email",
+  "--code",
+  "--source"
 ];
-var BOOLEAN_FLAGS = ["--json", "--yes", "--unread", "--archived", "--include-held", "--reply-all"];
+var BOOLEAN_FLAGS = ["--instant", "--json", "--yes", "--unread", "--archived", "--include-held", "--reply-all"];
 var USAGE3 = [
-  "Usage: groundmail mailboxes create [--local-part signup-bot] [--domain agents.example.com] [--display-name \u2026] [--external-id \u2026] [--tenant <tenant>] [--retention-days 7] [--spam-threshold 5] [--metadata JSON] [--forward-from <mailbox>] [--json]",
+  "Usage: groundmail mailboxes create --instant [--local-part signup-bot] [--owner-email you@example.com] [--json]",
+  "       groundmail mailboxes owner <mailbox> --owner-email you@example.com",
+  "       groundmail mailboxes verify <mailbox> --code 482913",
+  "       groundmail mailboxes create [--local-part signup-bot] [--domain agents.example.com] [--display-name \u2026] [--external-id \u2026] [--tenant <tenant>] [--retention-days 7] [--spam-threshold 5] [--metadata JSON] [--forward-from <mailbox>] [--json]",
   "       groundmail mailboxes list [--tenant <tenant>] [--limit 25] [--cursor \u2026] [--json]",
   "       groundmail mailboxes get <mailbox> [--json]",
   "       groundmail mailboxes delete <mailbox> --yes",
@@ -5098,13 +5104,38 @@ function paging(args) {
   if (typeof limit === "object") return limit;
   return { ...limit !== void 0 ? { limit } : {}, ...args.values["--cursor"] ? { cursor: args.values["--cursor"] } : {} };
 }
+async function createInstant(args) {
+  const { createInstantMailbox } = await import("groundmail");
+  const v = args.values;
+  try {
+    const created = await createInstantMailbox(
+      {
+        ...v["--local-part"] ? { local_part: v["--local-part"] } : {},
+        ...v["--display-name"] ? { display_name: v["--display-name"] } : {},
+        ...v["--owner-email"] ? { owner_email: v["--owner-email"] } : {},
+        source: v["--source"] ?? "cli"
+      },
+      { ...v["--base-url"] ? { baseUrl: v["--base-url"] } : {} }
+    );
+    if (args.booleans["--json"] === true) console.log(JSON.stringify(created));
+    else {
+      console.log(created.mailbox.address);
+      console.log(`Key (shown once): ${created.api_key}`);
+      console.log("Set it as GROUNDMAIL_API_KEY. This mailbox can receive now. To send, name your person: groundmail mailboxes owner");
+    }
+    return { exitCode: 0 };
+  } catch (error) {
+    return { exitCode: 1, error: error instanceof Error ? error.message : String(error) };
+  }
+}
 async function runMailboxesCommand(subcommand, argv, env = process.env) {
-  if (!subcommand || !["create", "list", "get", "delete", "forward", "threads", "read", "wait", "send", "reply"].includes(subcommand)) {
+  if (!subcommand || !["create", "owner", "verify", "list", "get", "delete", "forward", "threads", "read", "wait", "send", "reply"].includes(subcommand)) {
     return { exitCode: 1, error: USAGE3 };
   }
   const parsed = parseArgs(argv, { values: VALUE_FLAGS6, booleans: BOOLEAN_FLAGS });
   if (!parsed.ok) return { exitCode: 1, error: parsed.error };
   const { args } = parsed;
+  if (subcommand === "create" && args.booleans["--instant"] === true) return createInstant(args);
   const apiKey = args.values["--api-key"] || env.GROUNDMAIL_API_KEY;
   if (!apiKey) return { exitCode: 1, error: "Missing API key. Run groundmail login, set GROUNDMAIL_API_KEY or pass --api-key." };
   const json = args.booleans["--json"] === true;
@@ -5118,6 +5149,18 @@ async function runMailboxesCommand(subcommand, argv, env = process.env) {
   const ref = mailbox;
   try {
     const client2 = await createMailboxesClient(apiKey, v["--base-url"]);
+    if (subcommand === "owner") {
+      if (!v["--owner-email"]) return { exitCode: 1, error: "Missing --owner-email." };
+      const owner = await client2.mailboxes.setOwner(ref, v["--owner-email"]);
+      print(owner, () => `Code sent to ${owner.owner_email}. Ask them for it, then run: groundmail mailboxes verify ${ref} --code <code>`);
+      return { exitCode: 0 };
+    }
+    if (subcommand === "verify") {
+      if (!v["--code"]) return { exitCode: 1, error: "Missing --code." };
+      const verified = await client2.mailboxes.verifyOwner(ref, v["--code"]);
+      print(verified, () => "Verified. This mailbox now has a normal account, with the same key.");
+      return { exitCode: 0 };
+    }
     if (subcommand === "create") {
       const params = createParams(args);
       if ("error" in params) return { exitCode: 1, error: params.error };
@@ -5272,6 +5315,9 @@ var USAGE_LINES = [
   "  groundmail test-inbox address [--prefix signup]   a fresh address on your team's test domain (mail there is caught, never delivered)",
   "  groundmail test-inbox wait --to <address> [--timeout 30] [--since <iso>] [--json]   wait for an email; prints its code and links (exit 2 on timeout)",
   "  groundmail test-inbox list [--to <address>] [--since <iso>] [--json]",
+  "  groundmail mailboxes create --instant [--owner-email you@example.com]   no account or key needed",
+  "  groundmail mailboxes owner <mailbox> --owner-email you@example.com   send your person a code",
+  "  groundmail mailboxes verify <mailbox> --code 482913   unlock sending",
   "  groundmail mailboxes create [--local-part signup-bot] [--domain agents.example.com] [--display-name \u2026] [--external-id \u2026] [--tenant <tenant>] [--retention-days 7] [--spam-threshold 5] [--metadata JSON] [--forward-from <mailbox>] [--json]   a real address your agent reads and sends from; no --domain: a hosted address, which can only reply; --forward-from: a hosted mailbox this one replaces",
   "  groundmail mailboxes list [--tenant <tenant>] [--limit 25] [--cursor \u2026] [--json]",
   "  groundmail mailboxes get <mailbox> [--json]",

package/package.json

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