resend-cli 1.2.0 → 1.2.1

package/.github/workflows/release.yml

@@ -3,13 +3,46 @@ on:
   push:
     tags:
       - 'v*'
-permissions:
-  contents: write
 concurrency:
   group: release
   cancel-in-progress: false
 jobs:
+  test-binary:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            target: bun-darwin-arm64
+            binary: dist/resend
+            flags: "--bytecode"
+          - os: ubuntu-latest
+            target: bun-linux-x64
+            binary: dist/resend
+            flags: "--bytecode"
+          - os: windows-latest
+            target: bun-windows-x64
+            binary: dist/resend.exe
+            flags: ""
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build binary
+        run: bun build --compile --minify --sourcemap ${{ matrix.flags }} src/cli.ts --target=${{ matrix.target }} --outfile ${{ matrix.binary }}
+
+      - name: Verify binary runs
+        run: ${{ matrix.binary }} --version
+
   release:
+    needs: test-binary
+    permissions:
+      contents: write
     runs-on: blacksmith-2vcpu-ubuntu-2204
     steps:
       - uses: actions/checkout@v6
@@ -64,12 +97,6 @@ jobs:
             ```pwsh
             irm https://resend.com/install.ps1 | iex
             ```
-
-            **GitHub CLI** _(use while repo is private)_
-            ```sh
-            gh release download --repo resend/resend-cli --pattern "resend-darwin-arm64.tar.gz"
-            tar -xzf resend-darwin-arm64.tar.gz && sudo mv resend /usr/local/bin/ && rm resend-darwin-arm64.tar.gz
-            ```
           files: |
             dist/resend-darwin-arm64.tar.gz
             dist/resend-darwin-x64.tar.gz

package/README.md

@@ -1,6 +1,17 @@
 # Resend CLI
 
-Command-line interface for the [Resend](https://resend.com) email API. Works for humans, AI agents, and CI/CD pipelines.
+The official CLI for [Resend](https://resend.com).
+
+Built for humans, AI agents, and CI/CD pipelines.
+
+```
+██████╗ ███████╗███████╗███████╗███╗   ██╗██████╗
+██╔══██╗██╔════╝██╔════╝██╔════╝████╗  ██║██╔══██╗
+██████╔╝█████╗  ███████╗█████╗  ██╔██╗ ██║██║  ██║
+██╔══██╗██╔══╝  ╚════██║██╔══╝  ██║╚██╗██║██║  ██║
+██║  ██║███████╗███████║███████╗██║ ╚████║██████╔╝
+╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═════╝
+```
 
 ## Install
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "resend-cli",
-  "version": "1.2.0",
-  "description": "Resend CLI — email for developers",
+  "version": "1.2.1",
+  "description": "The official CLI for Resend",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/cli.ts

@@ -17,9 +17,19 @@ import { webhooksCommand } from './commands/webhooks/index';
 import { whoamiCommand } from './commands/whoami';
 import { PACKAGE_NAME, VERSION } from './lib/version';
 
+const BANNER = `
+██████╗ ███████╗███████╗███████╗███╗   ██╗██████╗
+██╔══██╗██╔════╝██╔════╝██╔════╝████╗  ██║██╔══██╗
+██████╔╝█████╗  ███████╗█████╗  ██╔██╗ ██║██║  ██║
+██╔══██╗██╔══╝  ╚════██║██╔══╝  ██║╚██╗██║██║  ██║
+██║  ██║███████╗███████║███████╗██║ ╚████║██████╔╝
+╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═════╝
+`;
+
 const program = new Command()
   .name('resend')
   .description('Resend CLI — email for developers')
+  .addHelpText('beforeAll', BANNER)
   .version(
     `${PACKAGE_NAME} v${VERSION}`,
     '-v, --version',
@@ -50,10 +60,8 @@ Output:
   Errors always exit with code 1: {"error":{"message":"...","code":"..."}}
 
 Examples:
-  $ resend login --key re_123456789
-  $ resend emails send --from you@domain.com --to user@example.com --subject "Hi" --text "Hello"
-  $ resend emails batch --file ./emails.json --json
-  $ resend doctor --json`,
+  $ resend login
+  $ resend emails send`,
   )
   .addCommand(loginCommand)
   .addCommand(logoutCommand)

package/src/commands/auth/login.ts

@@ -3,13 +3,7 @@ import * as p from '@clack/prompts';
 import { Command } from '@commander-js/extra-typings';
 import { Resend } from 'resend';
 import type { GlobalOpts } from '../../lib/client';
-import {
-  listTeams,
-  resolveApiKey,
-  setActiveTeam,
-  storeApiKey,
-  validateTeamName,
-} from '../../lib/config';
+import { listTeams, resolveApiKey, storeApiKey } from '../../lib/config';
 import { buildHelpText } from '../../lib/help-text';
 import { errorMessage, outputError, outputResult } from '../../lib/output';
 import { cancelAndExit } from '../../lib/prompts';
@@ -156,17 +150,6 @@ export const loginCommand = new Command('login')
 
     let teamName = globalOpts.team;
 
-    if (teamName) {
-      const teamError = validateTeamName(teamName);
-      if (teamError) {
-        outputError(
-          { message: teamError, code: 'invalid_team_name' },
-          { json: globalOpts.json },
-        );
-        return;
-      }
-    }
-
     if (!teamName && isInteractive()) {
       const existingTeams = listTeams();
       if (existingTeams.length > 0) {
@@ -190,7 +173,8 @@ export const loginCommand = new Command('login')
         if (choice === '__new__') {
           const newName = await p.text({
             message: 'Enter a name for the new team:',
-            validate: (v) => validateTeamName(v),
+            validate: (v) =>
+              !v || v.length === 0 ? 'Team name is required' : undefined,
           });
           if (p.isCancel(newName)) {
             cancelAndExit('Login cancelled.');
@@ -207,15 +191,6 @@ export const loginCommand = new Command('login')
     const configPath = storeApiKey(apiKey, teamName);
     const teamLabel = teamName || 'default';
 
-    // Auto-switch to the newly added team
-    if (teamName) {
-      try {
-        setActiveTeam(teamName);
-      } catch {
-        // Team was just stored, so this should not fail
-      }
-    }
-
     if (globalOpts.json) {
       outputResult(
         { success: true, config_path: configPath, team: teamLabel },

package/src/commands/doctor.ts

@@ -66,8 +66,8 @@ async function checkCliVersion(): Promise<CheckResult> {
   }
 }
 
-function checkApiKeyPresence(flagValue?: string): CheckResult {
-  const resolved = resolveApiKey(flagValue);
+function checkApiKeyPresence(): CheckResult {
+  const resolved = resolveApiKey();
   if (!resolved) {
     return {
       name: 'API Key',
@@ -246,7 +246,7 @@ export const doctorCommand = new Command('doctor')
 
     // Check 2: API Key
     spinner = interactive ? createSpinner('Checking API key...', 'scan') : null;
-    const keyCheck = checkApiKeyPresence(globalOpts.apiKey);
+    const keyCheck = checkApiKeyPresence();
     checks.push(keyCheck);
     if (keyCheck.status === 'fail') {
       spinner?.fail(keyCheck.message);

package/src/commands/teams/remove.ts

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import { Command } from '@commander-js/extra-typings';
 import type { GlobalOpts } from '../../lib/client';
-import { listTeams, removeApiKey } from '../../lib/config';
+import { listTeams, removeTeam } from '../../lib/config';
 import { errorMessage, outputError, outputResult } from '../../lib/output';
 import { cancelAndExit } from '../../lib/prompts';
 import { isInteractive } from '../../lib/tty';
@@ -24,7 +24,6 @@ export const removeCommand = new Command('remove')
           },
           { json: globalOpts.json },
         );
-        return;
       }
 
       const teams = listTeams();
@@ -36,7 +35,6 @@ export const removeCommand = new Command('remove')
           },
           { json: globalOpts.json },
         );
-        return;
       }
 
       const choice = await p.select({
@@ -66,7 +64,7 @@ export const removeCommand = new Command('remove')
     }
 
     try {
-      removeApiKey(teamName);
+      removeTeam(teamName);
     } catch (err) {
       outputError(
         {
@@ -75,7 +73,6 @@ export const removeCommand = new Command('remove')
         },
         { json: globalOpts.json },
       );
-      return;
     }
 
     if (globalOpts.json) {

package/src/commands/teams/switch.ts

@@ -24,7 +24,6 @@ export const switchCommand = new Command('switch')
           },
           { json: globalOpts.json },
         );
-        return;
       }
 
       const teams = listTeams();
@@ -36,7 +35,6 @@ export const switchCommand = new Command('switch')
           },
           { json: globalOpts.json },
         );
-        return;
       }
 
       const choice = await p.select({
@@ -65,7 +63,6 @@ export const switchCommand = new Command('switch')
         },
         { json: globalOpts.json },
       );
-      return;
     }
 
     if (globalOpts.json) {

package/src/lib/client.ts

@@ -1,6 +1,7 @@
 import { Resend } from 'resend';
 import { resolveApiKey } from './config';
 import { errorMessage, outputError } from './output';
+import { VERSION } from './version';
 
 export type GlobalOpts = {
   apiKey?: string;
@@ -9,6 +10,8 @@ export type GlobalOpts = {
   team?: string;
 };
 
+process.env.RESEND_USER_AGENT = `resend-cli:${VERSION}`;
+
 export function createClient(flagValue?: string, teamName?: string): Resend {
   const resolved = resolveApiKey(flagValue, teamName);
   if (!resolved) {

package/src/lib/config.ts

@@ -1,11 +1,4 @@
-import {
-  chmodSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from 'node:fs';
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
@@ -109,10 +102,6 @@ export function resolveApiKey(
 
 export function storeApiKey(apiKey: string, teamName?: string): string {
   const team = teamName || 'default';
-  const validationError = validateTeamName(team);
-  if (validationError) {
-    throw new Error(validationError);
-  }
   const creds = readCredentials() || { active_team: 'default', teams: {} };
 
   creds.teams[team] = { api_key: apiKey };
@@ -127,6 +116,7 @@ export function storeApiKey(apiKey: string, teamName?: string): string {
 
 export function removeAllApiKeys(): string {
   const configPath = getCredentialsPath();
+  const { unlinkSync } = require('node:fs');
   unlinkSync(configPath);
   return configPath;
 }
@@ -135,20 +125,13 @@ export function removeApiKey(teamName?: string): string {
   const creds = readCredentials();
   if (!creds) {
     const configPath = getCredentialsPath();
-    if (!existsSync(configPath)) {
-      throw new Error('No credentials file found.');
-    }
     // Try to delete legacy file
+    const { unlinkSync } = require('node:fs');
     unlinkSync(configPath);
     return configPath;
   }
 
   const team = teamName || resolveTeamName();
-  if (!creds.teams[team]) {
-    throw new Error(
-      `Team "${team}" not found. Available teams: ${Object.keys(creds.teams).join(', ')}`,
-    );
-  }
   delete creds.teams[team];
 
   // If we removed the active team, switch to first available or "default"
@@ -159,6 +142,7 @@ export function removeApiKey(teamName?: string): string {
 
   // If no teams left, delete the file
   if (Object.keys(creds.teams).length === 0) {
+    const { unlinkSync } = require('node:fs');
     const configPath = getCredentialsPath();
     unlinkSync(configPath);
     return configPath;
@@ -168,10 +152,6 @@ export function removeApiKey(teamName?: string): string {
 }
 
 export function setActiveTeam(teamName: string): void {
-  const validationError = validateTeamName(teamName);
-  if (validationError) {
-    throw new Error(validationError);
-  }
   const creds = readCredentials();
   if (!creds) {
     throw new Error('No credentials file found. Run: resend login');
@@ -196,19 +176,6 @@ export function listTeams(): Array<{ name: string; active: boolean }> {
   }));
 }
 
-export function validateTeamName(name: string): string | undefined {
-  if (!name || name.length === 0) {
-    return 'Team name must not be empty';
-  }
-  if (name.length > 64) {
-    return 'Team name must be 64 characters or fewer';
-  }
-  if (!/^[a-z0-9_-]+$/.test(name)) {
-    return 'Team name must contain only lowercase letters, numbers, dashes, and underscores';
-  }
-  return undefined;
-}
-
 export function maskKey(key: string): string {
   if (key.length <= 7) {
     return `${key.slice(0, 3)}...`;
@@ -216,3 +183,29 @@ export function maskKey(key: string): string {
   return `${key.slice(0, 3)}...${key.slice(-4)}`;
 }
 
+export function removeTeam(teamName: string): void {
+  const creds = readCredentials();
+  if (!creds) {
+    throw new Error('No credentials file found.');
+  }
+  if (!creds.teams[teamName]) {
+    throw new Error(
+      `Team "${teamName}" not found. Available teams: ${Object.keys(creds.teams).join(', ')}`,
+    );
+  }
+
+  delete creds.teams[teamName];
+
+  if (creds.active_team === teamName) {
+    const remaining = Object.keys(creds.teams);
+    creds.active_team = remaining[0] || 'default';
+  }
+
+  if (Object.keys(creds.teams).length === 0) {
+    const { unlinkSync } = require('node:fs');
+    unlinkSync(getCredentialsPath());
+    return;
+  }
+
+  writeCredentials(creds);
+}

package/tests/commands/auth/login.test.ts

@@ -116,39 +116,4 @@ describe('login command', () => {
     // Original team should still exist
     expect(data.teams.production.api_key).toBe('re_old_key_1234');
   });
-
-  // This test must be last — addCommand permanently modifies the shared loginCommand singleton
-  test('auto-switches to team specified via --team flag', async () => {
-    spies = setupOutputSpies();
-
-    const { Command } = await import('@commander-js/extra-typings');
-    const { loginCommand } = await import('../../../src/commands/auth/login');
-    const program = new Command()
-      .option('--team <name>')
-      .option('--json')
-      .option('--api-key <key>')
-      .option('-q, --quiet')
-      .addCommand(loginCommand);
-
-    // First store a default key
-    const configDir = join(tmpDir, 'resend');
-    mkdirSync(configDir, { recursive: true });
-    writeFileSync(
-      join(configDir, 'credentials.json'),
-      JSON.stringify({
-        active_team: 'default',
-        teams: { default: { api_key: 're_old_key_1234' } },
-      }),
-    );
-
-    await program.parseAsync(
-      ['login', '--key', 're_staging_key_123', '--team', 'staging'],
-      { from: 'user' },
-    );
-
-    const configPath = join(tmpDir, 'resend', 'credentials.json');
-    const data = JSON.parse(readFileSync(configPath, 'utf-8'));
-    expect(data.active_team).toBe('staging');
-    expect(data.teams.staging.api_key).toBe('re_staging_key_123');
-  });
 });

package/tests/lib/config.test.ts

@@ -5,12 +5,11 @@ import { join } from 'node:path';
 import {
   getConfigDir,
   listTeams,
-  removeApiKey,
+  removeTeam,
   resolveApiKey,
   resolveTeamName,
   setActiveTeam,
   storeApiKey,
-  validateTeamName,
 } from '../../src/lib/config';
 import { captureTestEnv } from '../helpers';
 
@@ -355,7 +354,7 @@ describe('setActiveTeam', () => {
   });
 });
 
-describe('removeApiKey', () => {
+describe('removeTeam', () => {
   const restoreEnv = captureTestEnv();
   let tmpDir: string;
 
@@ -376,7 +375,7 @@ describe('removeApiKey', () => {
     storeApiKey('re_default', 'default');
     storeApiKey('re_staging', 'staging');
 
-    removeApiKey('staging');
+    removeTeam('staging');
 
     const teams = listTeams();
     expect(teams).toEqual([{ name: 'default', active: true }]);
@@ -387,7 +386,7 @@ describe('removeApiKey', () => {
     storeApiKey('re_staging', 'staging');
     setActiveTeam('staging');
 
-    removeApiKey('staging');
+    removeTeam('staging');
 
     const configPath = join(tmpDir, 'resend', 'credentials.json');
     const data = JSON.parse(readFileSync(configPath, 'utf-8'));
@@ -397,7 +396,7 @@ describe('removeApiKey', () => {
   test('deletes file when last team removed', () => {
     storeApiKey('re_only', 'only');
 
-    removeApiKey('only');
+    removeTeam('only');
 
     const { existsSync } = require('node:fs');
     const configPath = join(tmpDir, 'resend', 'credentials.json');
@@ -406,42 +405,10 @@ describe('removeApiKey', () => {
 
   test('throws when team does not exist', () => {
     storeApiKey('re_default');
-    expect(() => removeApiKey('nonexistent')).toThrow('not found');
+    expect(() => removeTeam('nonexistent')).toThrow('not found');
   });
 
   test('throws when no credentials file', () => {
-    expect(() => removeApiKey('any')).toThrow('No credentials file');
-  });
-});
-
-describe('validateTeamName', () => {
-  test('accepts valid names', () => {
-    expect(validateTeamName('default')).toBeUndefined();
-    expect(validateTeamName('my-team')).toBeUndefined();
-    expect(validateTeamName('team_1')).toBeUndefined();
-    expect(validateTeamName('prod-2024')).toBeUndefined();
-  });
-
-  test('rejects uppercase characters', () => {
-    expect(validateTeamName('Production')).toContain('lowercase');
-  });
-
-  test('rejects spaces and special characters', () => {
-    expect(validateTeamName('my team')).toContain('lowercase');
-    expect(validateTeamName('team@org')).toContain('lowercase');
-  });
-
-  test('rejects empty name', () => {
-    expect(validateTeamName('')).toContain('empty');
-  });
-
-  test('rejects names longer than 64 characters', () => {
-    const longName = 'a'.repeat(65);
-    expect(validateTeamName(longName)).toContain('64');
-  });
-
-  test('accepts name exactly 64 characters', () => {
-    const maxName = 'a'.repeat(64);
-    expect(validateTeamName(maxName)).toBeUndefined();
+    expect(() => removeTeam('any')).toThrow('No credentials file');
   });
 });

package/.github/workflows/test-build-windows.yml

@@ -1,44 +0,0 @@
-name: Test Windows Build
-
-on:
-  push:
-    branches:
-      - main
-  pull_request:
-    paths:
-      - src/**
-      - .github/workflows/test-build-windows.yml
-      - .github/workflows/release.yml
-      - bun.lock
-  workflow_dispatch:
-
-jobs:
-  build:
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build Windows binary
-        run: bun build --compile --minify --sourcemap src/cli.ts --target=bun-windows-x64 --outfile dist/resend-windows-x64.exe
-
-      - name: Verify binary exists
-        shell: pwsh
-        run: |
-          if (-not (Test-Path dist\resend-windows-x64.exe)) {
-            Write-Error "Binary not found"
-            exit 1
-          }
-
-      - name: Verify binary runs
-        shell: pwsh
-        run: |
-          & dist\resend-windows-x64.exe --version
-          if ($LASTEXITCODE -ne 0) {
-            Write-Error "resend --version failed"
-            exit 1
-          }