carlyemail 0.7.0 → 0.8.0

package/README.md

@@ -80,6 +80,7 @@ npm install -g carlyemail
 | | |
 |---|---|
 | `signup --human-email <e> --username <u>` | Create an account and an inbox |
+| `send-code` | Email the owner a code to confirm the account |
 | `verify <code>` | Confirm the owner email |
 | `whoami` | Identity and scope of the current key |
 | `env` | Print `CARLYEMAIL_API_KEY` and `CARLYEMAIL_INBOX` shell exports |

package/carlyemail.js

@@ -18,7 +18,7 @@ import { basename, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes } from "node:crypto";
 
-export const VERSION = "0.7.0";
+export const VERSION = "0.8.0";
 
 const DEFAULT_API = "https://api.carlyemail.com";
 const CONFIG_DIR = join(homedir(), ".carlyemail");
@@ -416,7 +416,17 @@ define(
     ctx.print(ok(bold(out.inbox_id)));
     ctx.print(ok(`key saved to ${saved}`));
     ctx.print("");
-    ctx.print(arrow(`check ${human_email} for a 6-digit code, then:`));
+
+    // Sign-up emails nothing by itself. The person at this terminal is the one
+    // asking, so ask for them; the key is already saved if this fails.
+    try {
+      await request(config, "POST", "/v0/agent/verification-code");
+      ctx.print(arrow(`check ${human_email} for a 6-digit code, then:`));
+    } catch {
+      ctx.print(arrow("the code did not send — try again with:"));
+      ctx.print(`    carlyemail send-code`);
+      ctx.print(arrow("then:"));
+    }
     ctx.print(`    carlyemail verify <code>`);
     ctx.print("");
     ctx.print(dim(`Until the code is confirmed the account can only email ${human_email}.`));
@@ -462,6 +472,27 @@ define("verify", "Confirm the owner email with the code", "carlyemail verify 123
   ctx.print(ok("verified — this account can send anywhere now"));
 });
 
+define(
+  "send-code",
+  "Email the owner a code to confirm the account",
+  "carlyemail send-code",
+  async (ctx) => {
+    const out = await request(ctx.config, "POST", "/v0/agent/verification-code");
+    if (out.verified) {
+      ctx.print(ok("already verified — this account can send anywhere"));
+      return;
+    }
+    ctx.print(
+      arrow(
+        out.sent
+          ? `check ${out.owner_email} for a 6-digit code, then:`
+          : `a code went to ${out.owner_email} in the last 10 minutes — use that one:`
+      )
+    );
+    ctx.print(`    carlyemail verify <code>`);
+  }
+);
+
 define("whoami", "Show the key's identity and scope", "carlyemail whoami", async (ctx) => {
   const me = await request(ctx.config, "GET", "/v0/auth/me");
   emit(ctx, me, () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlyemail",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Real email inboxes your agent can send, receive and reply from. SDK and CLI.",
   "keywords": [
     "email",

package/sdk.d.ts

@@ -43,6 +43,15 @@ export interface AgentSignupResponse {
   organization_id: string;
   inbox_id: string;
   api_key: string;
+  verified?: boolean;
+  next_step?: string;
+}
+
+export interface AgentVerificationCodeResponse {
+  sent: boolean;
+  verified: boolean;
+  owner_email?: string | null;
+  detail: string;
 }
 
 export interface AgentVerifyRequest {
@@ -781,6 +790,7 @@ export declare class Agent {
   signUp(body: AgentSignupRequest): Promise<AgentSignupResponse>;
   signIn(body: AgentSigninRequest): Promise<AgentSigninResponse>;
   verifySignIn(body: AgentSigninVerifyRequest): Promise<AgentSigninVerifyResponse>;
+  requestVerificationCode(): Promise<AgentVerificationCodeResponse>;
   verify(body: AgentVerifyRequest): Promise<AgentVerifyResponse>;
 }
 

package/sdk.js

@@ -88,6 +88,11 @@ class Agent {
     return this.$.request("POST", `/v0/agent/sign-in/verify`, { body, auth: false });
   }
 
+  /** Request Verification Code */
+  requestVerificationCode() {
+    return this.$.request("POST", `/v0/agent/verification-code`);
+  }
+
   /** Verify */
   verify(body) {
     return this.$.request("POST", `/v0/agent/verify`, { body });