carlyemail 0.4.0 → 0.5.0

package/carlyemail.js

@@ -18,7 +18,7 @@ import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes } from "node:crypto";
 
-export const VERSION = "0.4.0";
+export const VERSION = "0.5.0";
 
 const DEFAULT_API = "https://api.carlyemail.com";
 const CONFIG_DIR = join(homedir(), ".carlyemail");
@@ -253,9 +253,14 @@ define(
     }
     if (!username) throw new UsageError("--username is required");
 
+    // Not prompted for. Two questions is a sign-up; three is a form, and this
+    // one has a default that works and a `carlyemail name` to change it later.
+    const display_name =
+      typeof ctx.flags["display-name"] === "string" ? ctx.flags["display-name"] : undefined;
+
     const out = await request(ctx.config, "POST", "/v0/agent/sign-up", {
       auth: false,
-      body: { human_email, username, source: "cli" },
+      body: { human_email, username, source: "cli", display_name },
     });
 
     // Saved before anything else is printed: the key is returned exactly once
@@ -316,10 +321,37 @@ define("create", "Create an inbox", "carlyemail create --username support", asyn
   const username = ctx.positional[0] || required(ctx.flags, "username");
   const body = { username };
   if (typeof ctx.flags.domain === "string") body.domain = ctx.flags.domain;
+  if (typeof ctx.flags["display-name"] === "string") body.display_name = ctx.flags["display-name"];
   const inbox = await request(ctx.config, "POST", "/v0/inboxes", { body });
   emit(ctx, inbox, () => ctx.print(ok(bold(inbox.email))));
 });
 
+define(
+  "name",
+  "Set the name recipients see beside an address",
+  'carlyemail name support@carlyemail.com "Support Bot"',
+  async (ctx) => {
+    const inbox = ctx.positional[0];
+    if (!inbox) throw new UsageError('which inbox? carlyemail name <inbox> "Display Name"');
+    // Joined, not `positional[1]`: an unquoted `carlyemail name x@y.com Support
+    // Bot` is the obvious way to type this and would otherwise silently set
+    // "Support". Nothing after the address clears the name rather than being a
+    // usage error, so there is a way to take one off.
+    const display_name = ctx.positional.slice(1).join(" ");
+
+    const out = await request(ctx.config, "PATCH", `/v0/inboxes/${encodeURIComponent(inbox)}`, {
+      body: { display_name },
+    });
+    emit(ctx, out, () =>
+      ctx.print(
+        out.display_name
+          ? ok(`${bold(out.email)} now sends as ${bold(out.display_name)}`)
+          : ok(`${bold(out.email)} now sends with no display name`)
+      )
+    );
+  }
+);
+
 define("delete", "Delete an inbox and its mail", "carlyemail delete support@carlyemail.com", async (ctx) => {
   const inbox = ctx.positional[0];
   if (!inbox) throw new UsageError("which inbox? carlyemail delete <inbox>");

package/package.json

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

package/sdk.d.ts

@@ -21,6 +21,7 @@ export interface AgentSigninVerifyResponse {
 export interface AgentSignupRequest {
   human_email: string;
   username: string;
+  display_name?: string | null;
   source?: string | null;
   referrer?: string | null;
 }