resend-cli 1.1.0 → 1.2.0

package/src/commands/auth/login.ts

@@ -3,7 +3,13 @@ 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, storeApiKey } from '../../lib/config';
+import {
+  listTeams,
+  resolveApiKey,
+  setActiveTeam,
+  storeApiKey,
+  validateTeamName,
+} from '../../lib/config';
 import { buildHelpText } from '../../lib/help-text';
 import { errorMessage, outputError, outputResult } from '../../lib/output';
 import { cancelAndExit } from '../../lib/prompts';
@@ -127,7 +133,11 @@ export const loginCommand = new Command('login')
       );
     }
 
-    const spinner = createSpinner('Validating API key...');
+    const spinner = createSpinner(
+      'Validating API key...',
+      'braille',
+      globalOpts.quiet,
+    );
 
     try {
       const resend = new Resend(apiKey);
@@ -146,6 +156,17 @@ 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) {
@@ -169,8 +190,7 @@ export const loginCommand = new Command('login')
         if (choice === '__new__') {
           const newName = await p.text({
             message: 'Enter a name for the new team:',
-            validate: (v) =>
-              !v || v.length === 0 ? 'Team name is required' : undefined,
+            validate: (v) => validateTeamName(v),
           });
           if (p.isCancel(newName)) {
             cancelAndExit('Login cancelled.');
@@ -180,21 +200,22 @@ export const loginCommand = new Command('login')
           teamName = choice;
         }
       } else {
-        const newName = await p.text({
-          message: 'Enter a team name (or press Enter for "default"):',
-          defaultValue: 'default',
-          placeholder: 'default',
-        });
-        if (p.isCancel(newName)) {
-          cancelAndExit('Login cancelled.');
-        }
-        teamName = newName;
+        teamName = 'default';
       }
     }
 
     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(): CheckResult {
-  const resolved = resolveApiKey();
+function checkApiKeyPresence(flagValue?: string): CheckResult {
+  const resolved = resolveApiKey(flagValue);
   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();
+    const keyCheck = checkApiKeyPresence(globalOpts.apiKey);
     checks.push(keyCheck);
     if (keyCheck.status === 'fail') {
       spinner?.fail(keyCheck.message);

package/src/commands/open.ts

@@ -0,0 +1,24 @@
+import { Command } from '@commander-js/extra-typings';
+import { buildHelpText } from '../lib/help-text';
+
+export const openCommand = new Command('open')
+  .description('Open the Resend dashboard in your browser')
+  .addHelpText(
+    'after',
+    buildHelpText({
+      context: 'Opens https://resend.com/emails in your default browser.',
+      examples: ['resend open'],
+    }),
+  )
+  .action(async () => {
+    const url = 'https://resend.com/emails';
+    const { platform } = process;
+    const args =
+      platform === 'darwin'
+        ? ['open', url]
+        : platform === 'win32'
+          ? ['cmd', '/c', 'start', url]
+          : ['xdg-open', url];
+
+    Bun.spawn(args, { stdio: ['ignore', 'ignore', 'ignore'] });
+  });

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, removeTeam } from '../../lib/config';
+import { listTeams, removeApiKey } from '../../lib/config';
 import { errorMessage, outputError, outputResult } from '../../lib/output';
 import { cancelAndExit } from '../../lib/prompts';
 import { isInteractive } from '../../lib/tty';
@@ -24,6 +24,7 @@ export const removeCommand = new Command('remove')
           },
           { json: globalOpts.json },
         );
+        return;
       }
 
       const teams = listTeams();
@@ -35,6 +36,7 @@ export const removeCommand = new Command('remove')
           },
           { json: globalOpts.json },
         );
+        return;
       }
 
       const choice = await p.select({
@@ -64,7 +66,7 @@ export const removeCommand = new Command('remove')
     }
 
     try {
-      removeTeam(teamName);
+      removeApiKey(teamName);
     } catch (err) {
       outputError(
         {
@@ -73,6 +75,7 @@ export const removeCommand = new Command('remove')
         },
         { json: globalOpts.json },
       );
+      return;
     }
 
     if (globalOpts.json) {

package/src/commands/teams/switch.ts

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

package/src/lib/client.ts

@@ -2,7 +2,12 @@ import { Resend } from 'resend';
 import { resolveApiKey } from './config';
 import { errorMessage, outputError } from './output';
 
-export type GlobalOpts = { apiKey?: string; json?: boolean; team?: string };
+export type GlobalOpts = {
+  apiKey?: string;
+  json?: boolean;
+  quiet?: boolean;
+  team?: string;
+};
 
 export function createClient(flagValue?: string, teamName?: string): Resend {
   const resolved = resolveApiKey(flagValue, teamName);

package/src/lib/config.ts

@@ -1,4 +1,11 @@
-import { chmodSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
@@ -102,6 +109,10 @@ 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 };
@@ -116,7 +127,6 @@ export function storeApiKey(apiKey: string, teamName?: string): string {
 
 export function removeAllApiKeys(): string {
   const configPath = getCredentialsPath();
-  const { unlinkSync } = require('node:fs');
   unlinkSync(configPath);
   return configPath;
 }
@@ -125,13 +135,20 @@ 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"
@@ -142,7 +159,6 @@ 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;
@@ -152,6 +168,10 @@ 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');
@@ -176,6 +196,19 @@ 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)}...`;
@@ -183,29 +216,3 @@ 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/src/lib/help-text.ts

@@ -9,11 +9,13 @@ export interface HelpTextOptions {
 const GLOBAL_OPTS_FULL = `Global options:
   --api-key <key>   API key (or set RESEND_API_KEY env var)
   --team <name>     Team profile to use (overrides RESEND_TEAM)
-  --json            Force JSON output (also auto-enabled when stdout is piped)`;
+  --json            Force JSON output (also auto-enabled when stdout is piped)
+  -q, --quiet       Suppress spinners and status output (implies --json)`;
 
 const GLOBAL_OPTS_SETUP = `Global options:
   --team <name>  Team profile to save the key to
-  --json         Force JSON output`;
+  --json         Force JSON output
+  -q, --quiet    Suppress spinners and status output (implies --json)`;
 
 const ERROR_ENVELOPE = `  {"error":{"message":"<message>","code":"<code>"}}`;
 

package/src/lib/spinner.ts

@@ -21,7 +21,7 @@ export async function withSpinner<T>(
   errorCode: string,
   globalOpts: GlobalOpts,
 ): Promise<T> {
-  const spinner = createSpinner(messages.loading);
+  const spinner = createSpinner(messages.loading, 'braille', globalOpts.quiet);
   try {
     const { data, error } = await call();
     if (error) {
@@ -51,8 +51,12 @@ export async function withSpinner<T>(
 
 export type SpinnerName = keyof typeof spinners;
 
-export function createSpinner(message: string, name: SpinnerName = 'braille') {
-  if (!isInteractive()) {
+export function createSpinner(
+  message: string,
+  name: SpinnerName = 'braille',
+  quiet?: boolean,
+) {
+  if (quiet || !isInteractive()) {
     return {
       update(_msg: string) {},
       stop(_msg: string) {},

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

@@ -116,4 +116,39 @@ 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,11 +5,12 @@ import { join } from 'node:path';
 import {
   getConfigDir,
   listTeams,
-  removeTeam,
+  removeApiKey,
   resolveApiKey,
   resolveTeamName,
   setActiveTeam,
   storeApiKey,
+  validateTeamName,
 } from '../../src/lib/config';
 import { captureTestEnv } from '../helpers';
 
@@ -354,7 +355,7 @@ describe('setActiveTeam', () => {
   });
 });
 
-describe('removeTeam', () => {
+describe('removeApiKey', () => {
   const restoreEnv = captureTestEnv();
   let tmpDir: string;
 
@@ -375,7 +376,7 @@ describe('removeTeam', () => {
     storeApiKey('re_default', 'default');
     storeApiKey('re_staging', 'staging');
 
-    removeTeam('staging');
+    removeApiKey('staging');
 
     const teams = listTeams();
     expect(teams).toEqual([{ name: 'default', active: true }]);
@@ -386,7 +387,7 @@ describe('removeTeam', () => {
     storeApiKey('re_staging', 'staging');
     setActiveTeam('staging');
 
-    removeTeam('staging');
+    removeApiKey('staging');
 
     const configPath = join(tmpDir, 'resend', 'credentials.json');
     const data = JSON.parse(readFileSync(configPath, 'utf-8'));
@@ -396,7 +397,7 @@ describe('removeTeam', () => {
   test('deletes file when last team removed', () => {
     storeApiKey('re_only', 'only');
 
-    removeTeam('only');
+    removeApiKey('only');
 
     const { existsSync } = require('node:fs');
     const configPath = join(tmpDir, 'resend', 'credentials.json');
@@ -405,10 +406,42 @@ describe('removeTeam', () => {
 
   test('throws when team does not exist', () => {
     storeApiKey('re_default');
-    expect(() => removeTeam('nonexistent')).toThrow('not found');
+    expect(() => removeApiKey('nonexistent')).toThrow('not found');
   });
 
   test('throws when no credentials file', () => {
-    expect(() => removeTeam('any')).toThrow('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();
   });
 });

package/tests/lib/help-text.test.ts

@@ -20,7 +20,8 @@ describe('buildHelpText', () => {
         'Global options:\n' +
         '  --api-key <key>   API key (or set RESEND_API_KEY env var)\n' +
         '  --team <name>     Team profile to use (overrides RESEND_TEAM)\n' +
-        '  --json            Force JSON output (also auto-enabled when stdout is piped)' +
+        '  --json            Force JSON output (also auto-enabled when stdout is piped)\n' +
+        '  -q, --quiet       Suppress spinners and status output (implies --json)' +
         '\n\n' +
         'Output (--json or piped):\n' +
         '  {"id":"em_123"}' +