resend-cli 1.2.1 → 1.3.0

package/.claude/worktrees/emails-list/src/commands/auth/login.ts

@@ -1,207 +0,0 @@
-import { execFile } from 'node:child_process';
-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 { buildHelpText } from '../../lib/help-text';
-import { errorMessage, outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { createSpinner } from '../../lib/spinner';
-import { isInteractive } from '../../lib/tty';
-
-const RESEND_API_KEYS_URL = 'https://resend.com/api-keys?new=true';
-
-function openInBrowser(url: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    // `start` on Windows is a shell built-in, not an executable.
-    // Must invoke via `cmd.exe /c start <url>`.
-    const cmd =
-      process.platform === 'win32'
-        ? 'cmd.exe'
-        : process.platform === 'darwin'
-          ? 'open'
-          : 'xdg-open';
-    const args =
-      process.platform === 'win32' ? ['/c', 'start', '""', url] : [url];
-    execFile(cmd, args, { timeout: 5000 }, (err) => resolve(!err));
-  });
-}
-
-export const loginCommand = new Command('login')
-  .description('Save a Resend API key to the local credentials file')
-  .option('--key <key>', 'API key to store (required in non-interactive mode)')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      setup: true,
-      context:
-        'Non-interactive: --key is required (no prompts will appear when stdin/stdout is not a TTY).',
-      output: `  {"success":true,"config_path":"<path>"}`,
-      errorCodes: ['missing_key', 'invalid_key_format', 'validation_failed'],
-      examples: [
-        'resend login --key re_123456789',
-        'resend login                      (interactive — prompts and opens browser)',
-        'RESEND_API_KEY=re_123 resend emails send ...  (skip login; use env var directly)',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    let apiKey = opts.key;
-
-    if (!apiKey) {
-      if (!isInteractive()) {
-        outputError(
-          {
-            message:
-              'Missing --key flag. Provide your API key in non-interactive mode.',
-            code: 'missing_key',
-          },
-          { json: globalOpts.json },
-        );
-      }
-
-      p.intro('Resend Authentication');
-
-      const existing = resolveApiKey();
-      if (existing) {
-        p.log.info(
-          `Existing API key found (source: ${existing.source}). Enter a new key to replace it.`,
-        );
-      }
-
-      const method = await p.select({
-        message: 'How would you like to get your API key?',
-        options: [
-          {
-            value: 'browser' as const,
-            label: 'Open resend.com/api-keys in browser',
-          },
-          { value: 'manual' as const, label: 'Enter API key manually' },
-        ],
-      });
-
-      if (p.isCancel(method)) {
-        cancelAndExit('Login cancelled.');
-      }
-
-      if (method === 'browser') {
-        const opened = await openInBrowser(RESEND_API_KEYS_URL);
-        if (opened) {
-          p.log.info(`Opened ${RESEND_API_KEYS_URL}`);
-        } else {
-          p.log.warn(
-            `Could not open browser. Visit ${RESEND_API_KEYS_URL} manually.`,
-          );
-        }
-      }
-
-      const result = await p.password({
-        message: 'Enter your Resend API key:',
-        validate: (value) => {
-          if (!value) {
-            return 'API key is required';
-          }
-          if (!value.startsWith('re_')) {
-            return 'API key must start with re_';
-          }
-          return undefined;
-        },
-      });
-
-      if (p.isCancel(result)) {
-        cancelAndExit('Login cancelled.');
-      }
-
-      apiKey = result;
-    }
-
-    if (!apiKey.startsWith('re_')) {
-      outputError(
-        {
-          message: 'Invalid API key format. Key must start with re_',
-          code: 'invalid_key_format',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    const spinner = createSpinner(
-      'Validating API key...',
-      'braille',
-      globalOpts.quiet,
-    );
-
-    try {
-      const resend = new Resend(apiKey);
-      await resend.domains.list();
-      spinner.stop('API key is valid');
-    } catch (err) {
-      spinner.fail('API key validation failed');
-      outputError(
-        {
-          message: errorMessage(err, 'Failed to validate API key'),
-          code: 'validation_failed',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    let teamName = globalOpts.team;
-
-    if (!teamName && isInteractive()) {
-      const existingTeams = listTeams();
-      if (existingTeams.length > 0) {
-        const options = [
-          ...existingTeams.map((t) => ({
-            value: t.name,
-            label: `${t.name} (overwrite)`,
-          })),
-          { value: '__new__' as const, label: '+ Create new team' },
-        ];
-
-        const choice = await p.select({
-          message: 'Save API key to which team?',
-          options,
-        });
-
-        if (p.isCancel(choice)) {
-          cancelAndExit('Login cancelled.');
-        }
-
-        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,
-          });
-          if (p.isCancel(newName)) {
-            cancelAndExit('Login cancelled.');
-          }
-          teamName = newName;
-        } else {
-          teamName = choice;
-        }
-      } else {
-        teamName = 'default';
-      }
-    }
-
-    const configPath = storeApiKey(apiKey, teamName);
-    const teamLabel = teamName || 'default';
-
-    if (globalOpts.json) {
-      outputResult(
-        { success: true, config_path: configPath, team: teamLabel },
-        { json: true },
-      );
-    } else {
-      const msg = `API key stored for team '${teamLabel}' at ${configPath}`;
-      if (isInteractive()) {
-        p.outro(msg);
-      } else {
-        console.log(msg);
-      }
-    }
-  });

package/.claude/worktrees/emails-list/src/commands/auth/logout.ts

@@ -1,105 +0,0 @@
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import type { GlobalOpts } from '../../lib/client';
-import {
-  getConfigDir,
-  removeAllApiKeys,
-  removeApiKey,
-  resolveTeamName,
-} from '../../lib/config';
-import { buildHelpText } from '../../lib/help-text';
-import { errorMessage, outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-
-export const logoutCommand = new Command('logout')
-  .description(
-    'Remove the saved Resend API key from the local credentials file',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      setup: true,
-      context: `Removes the saved API key from ~/.config/resend/credentials.json.
-  (Linux: $XDG_CONFIG_HOME/resend/credentials.json)
-  (Windows: %APPDATA%\\resend\\credentials.json)
-
-When --team is specified, only that team's entry is removed.
-When no team is specified, all teams are removed.
-
-If no credentials file exists, exits cleanly with no error.`,
-      output: `  {"success":true,"config_path":"<path>"}`,
-      errorCodes: ['remove_failed'],
-      examples: [
-        'resend logout',
-        'resend logout --team staging',
-        'resend logout --json',
-      ],
-    }),
-  )
-  .action(async (_opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const configPath = join(getConfigDir(), 'credentials.json');
-
-    if (!existsSync(configPath)) {
-      if (!globalOpts.json && isInteractive()) {
-        console.log('No saved credentials found. Nothing to remove.');
-      } else {
-        outputResult(
-          { success: true, already_logged_out: true },
-          { json: globalOpts.json },
-        );
-      }
-      return;
-    }
-
-    const logoutAll = !globalOpts.team;
-    const teamLabel = globalOpts.team || resolveTeamName();
-
-    if (!globalOpts.json && isInteractive()) {
-      const message = logoutAll
-        ? `Remove all saved API keys at ${configPath}?`
-        : `Remove saved API key for team '${teamLabel}'?`;
-
-      const confirmed = await p.confirm({ message });
-
-      if (p.isCancel(confirmed) || !confirmed) {
-        cancelAndExit('Logout cancelled.');
-      }
-    }
-
-    try {
-      if (logoutAll) {
-        removeAllApiKeys();
-      } else {
-        removeApiKey(teamLabel);
-      }
-    } catch (err) {
-      outputError(
-        {
-          message: errorMessage(err, 'Failed to remove credentials'),
-          code: 'remove_failed',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    if (!globalOpts.json && isInteractive()) {
-      const msg = logoutAll
-        ? 'Logged out. All API keys removed.'
-        : `Logged out. API key removed for team '${teamLabel}'.`;
-      p.outro(msg);
-    } else {
-      outputResult(
-        {
-          success: true,
-          config_path: configPath,
-          team: logoutAll ? 'all' : teamLabel,
-        },
-        { json: globalOpts.json },
-      );
-    }
-  });

package/.claude/worktrees/emails-list/src/commands/broadcasts/create.ts

@@ -1,196 +0,0 @@
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import type { CreateBroadcastOptions } from 'resend';
-import { runCreate } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { readFile } from '../../lib/files';
-import { buildHelpText } from '../../lib/help-text';
-import { outputError } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-
-export const createBroadcastCommand = new Command('create')
-  .description('Create a broadcast draft (or send immediately with --send)')
-  .option('--from <address>', 'Sender address — required')
-  .option('--subject <subject>', 'Email subject — required')
-  .option('--segment-id <id>', 'Target segment ID — required')
-  .option(
-    '--html <html>',
-    'HTML body (supports {{{FIRST_NAME|fallback}}} triple-brace variable interpolation)',
-  )
-  .option(
-    '--html-file <path>',
-    'Path to an HTML file for the body (supports {{{FIRST_NAME|fallback}}} variable interpolation)',
-  )
-  .option('--text <text>', 'Plain-text body')
-  .option('--name <name>', 'Internal label for the broadcast (optional)')
-  .option('--reply-to <address>', 'Reply-to address (optional)')
-  .option(
-    '--preview-text <text>',
-    'Preview text shown in inbox below the subject line (optional)',
-  )
-  .option(
-    '--topic-id <id>',
-    'Associate with a topic for subscription filtering (optional)',
-  )
-  .option('--send', 'Send immediately on create instead of saving as draft')
-  .option(
-    '--scheduled-at <datetime>',
-    'Schedule delivery — ISO 8601 or natural language e.g. "in 1 hour", "tomorrow at 9am ET" (only valid with --send)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Non-interactive: --from, --subject, and --segment-id are required.
-Body: provide exactly one of --html, --html-file, or --text.
-
-Variable interpolation:
-  HTML bodies support triple-brace syntax for contact properties.
-  Example: {{{FIRST_NAME|Friend}}} — uses FIRST_NAME or falls back to "Friend".
-
-Scheduling:
-  Use --scheduled-at with --send to schedule delivery.
-  Accepts ISO 8601 (e.g. 2026-08-05T11:52:01Z) or natural language (e.g. "in 1 hour").
-  --scheduled-at without --send is ignored.`,
-      output: `  {"id":"<broadcast-id>"}`,
-      errorCodes: [
-        'auth_error',
-        'missing_from',
-        'missing_subject',
-        'missing_segment',
-        'missing_body',
-        'file_read_error',
-        'create_error',
-      ],
-      examples: [
-        'resend broadcasts create --from hello@domain.com --subject "Weekly Update" --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --html "<p>Hello {{{FIRST_NAME|there}}}</p>"',
-        'resend broadcasts create --from hello@domain.com --subject "Launch" --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --html-file ./email.html --send',
-        'resend broadcasts create --from hello@domain.com --subject "Launch" --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --text "Hello!" --send --scheduled-at "tomorrow at 9am ET"',
-        'resend broadcasts create --from hello@domain.com --subject "News" --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --html "<p>Hi</p>" --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    let from = opts.from;
-    let subject = opts.subject;
-    let segmentId = opts.segmentId;
-
-    if (!from) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --from flag.', code: 'missing_from' },
-          { json: globalOpts.json },
-        );
-      }
-      const result = await p.text({
-        message: 'From address',
-        placeholder: 'hello@domain.com',
-        validate: (v) => (!v ? 'Required' : undefined),
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      from = result;
-    }
-
-    if (!subject) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --subject flag.', code: 'missing_subject' },
-          { json: globalOpts.json },
-        );
-      }
-      const result = await p.text({
-        message: 'Subject',
-        placeholder: 'Weekly Newsletter',
-        validate: (v) => (!v ? 'Required' : undefined),
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      subject = result;
-    }
-
-    if (!segmentId) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --segment-id flag.', code: 'missing_segment' },
-          { json: globalOpts.json },
-        );
-      }
-      const result = await p.text({
-        message: 'Segment ID',
-        placeholder: '7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
-        validate: (v) => (!v ? 'Required' : undefined),
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      segmentId = result;
-    }
-
-    let html = opts.html;
-    let text = opts.text;
-
-    if (opts.htmlFile) {
-      html = readFile(opts.htmlFile, globalOpts);
-    }
-
-    if (!html && !text) {
-      if (!isInteractive()) {
-        outputError(
-          {
-            message: 'Missing body. Provide --html, --html-file, or --text.',
-            code: 'missing_body',
-          },
-          { json: globalOpts.json },
-        );
-      }
-      const result = await p.text({
-        message: 'Body (plain text)',
-        placeholder: 'Hello {{{FIRST_NAME|there}}}!',
-        validate: (v) => (!v ? 'Required' : undefined),
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      text = result;
-    }
-
-    await runCreate(
-      {
-        spinner: {
-          loading: 'Creating broadcast...',
-          success: opts.send ? 'Broadcast sent' : 'Broadcast created',
-          fail: 'Failed to create broadcast',
-        },
-        sdkCall: (resend) =>
-          resend.broadcasts.create({
-            from,
-            subject,
-            segmentId,
-            ...(html && { html }),
-            ...(text && { text }),
-            ...(opts.name && { name: opts.name }),
-            ...(opts.replyTo && { replyTo: opts.replyTo }),
-            ...(opts.previewText && { previewText: opts.previewText }),
-            ...(opts.topicId && { topicId: opts.topicId }),
-            ...(opts.send && { send: true as const }),
-            ...(opts.send &&
-              opts.scheduledAt && { scheduledAt: opts.scheduledAt }),
-          } as CreateBroadcastOptions),
-        onInteractive: (d) => {
-          if (opts.send) {
-            console.log(`\nBroadcast sent: ${d.id}`);
-          } else {
-            console.log(`\nBroadcast created: ${d.id}`);
-            console.log('Status: draft');
-            console.log(`\nSend it with: resend broadcasts send ${d.id}`);
-          }
-        },
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/broadcasts/delete.ts

@@ -1,46 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { runDelete } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-
-export const deleteBroadcastCommand = new Command('delete')
-  .alias('rm')
-  .description(
-    'Delete a broadcast — draft broadcasts are removed; scheduled broadcasts are cancelled before delivery',
-  )
-  .argument('<id>', 'Broadcast ID')
-  .option('--yes', 'Skip confirmation prompt')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Warning: Deleting a scheduled broadcast cancels its delivery immediately.
-Only draft and scheduled broadcasts can be deleted; sent broadcasts cannot.
-
-Non-interactive: --yes is required to confirm deletion when stdin/stdout is not a TTY.`,
-      output: `  {"object":"broadcast","id":"<id>","deleted":true}`,
-      errorCodes: ['auth_error', 'confirmation_required', 'delete_error'],
-      examples: [
-        'resend broadcasts delete d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --yes',
-        'resend broadcasts delete d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --yes --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runDelete(
-      id,
-      !!opts.yes,
-      {
-        confirmMessage: `Delete broadcast ${id}?\nIf scheduled, delivery will be cancelled.`,
-        spinner: {
-          loading: 'Deleting broadcast...',
-          success: 'Broadcast deleted',
-          fail: 'Failed to delete broadcast',
-        },
-        object: 'broadcast',
-        successMsg: 'Broadcast deleted.',
-        sdkCall: (resend) => resend.broadcasts.remove(id),
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/broadcasts/get.ts

@@ -1,59 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { runGet } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { broadcastStatusIndicator } from './utils';
-
-export const getBroadcastCommand = new Command('get')
-  .description(
-    'Retrieve full details for a broadcast including HTML body, status, and delivery times',
-  )
-  .argument('<id>', 'Broadcast ID')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Note: The list command returns summary objects without html/text/from/subject.
-Use this command to retrieve the full broadcast payload.`,
-      output: `  {"id":"...","object":"broadcast","name":"...","segment_id":"...","from":"...","subject":"...","status":"draft|queued|sent","created_at":"...","scheduled_at":null,"sent_at":null}`,
-      errorCodes: ['auth_error', 'fetch_error'],
-      examples: [
-        'resend broadcasts get d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
-        'resend broadcasts get d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runGet(
-      {
-        spinner: {
-          loading: 'Fetching broadcast...',
-          success: 'Broadcast fetched',
-          fail: 'Failed to fetch broadcast',
-        },
-        sdkCall: (resend) => resend.broadcasts.get(id),
-        onInteractive: (b) => {
-          console.log(`\nBroadcast: ${b.id}`);
-          console.log(`  Status:      ${broadcastStatusIndicator(b.status)}`);
-          console.log(`  Name:        ${b.name ?? '(untitled)'}`);
-          console.log(`  From:        ${b.from ?? '—'}`);
-          console.log(`  Subject:     ${b.subject ?? '—'}`);
-          console.log(`  Segment:     ${b.segment_id ?? '—'}`);
-          if (b.preview_text) {
-            console.log(`  Preview:     ${b.preview_text}`);
-          }
-          if (b.topic_id) {
-            console.log(`  Topic:       ${b.topic_id}`);
-          }
-          console.log(`  Created:     ${b.created_at}`);
-          if (b.scheduled_at) {
-            console.log(`  Scheduled:   ${b.scheduled_at}`);
-          }
-          if (b.sent_at) {
-            console.log(`  Sent:        ${b.sent_at}`);
-          }
-        },
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/broadcasts/index.ts

@@ -1,43 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { createBroadcastCommand } from './create';
-import { deleteBroadcastCommand } from './delete';
-import { getBroadcastCommand } from './get';
-import { listBroadcastsCommand } from './list';
-import { sendBroadcastCommand } from './send';
-import { updateBroadcastCommand } from './update';
-
-export const broadcastsCommand = new Command('broadcasts')
-  .description('Manage broadcasts — bulk email to a segment of contacts')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Lifecycle:
-  Broadcasts follow a draft → send flow:
-    1. create  — creates a draft (or sends immediately with --send)
-    2. send    — sends an API-created draft (dashboard broadcasts cannot be sent via API)
-  Scheduled broadcasts can be deleted to cancel delivery; sent broadcasts are immutable.
-
-Template variables:
-  HTML bodies support triple-brace interpolation for contact properties.
-  Example: {{{FIRST_NAME|Friend}}} — uses FIRST_NAME or falls back to "Friend".
-
-Scheduling:
-  --scheduled-at accepts ISO 8601 or natural language e.g. "in 1 hour", "tomorrow at 9am ET".`,
-      examples: [
-        'resend broadcasts list',
-        'resend broadcasts create --from hello@domain.com --subject "Launch" --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --html "<p>Hi {{{FIRST_NAME|there}}}</p>"',
-        'resend broadcasts send d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
-        'resend broadcasts send d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --scheduled-at "in 1 hour"',
-        'resend broadcasts get d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6',
-        'resend broadcasts update d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --subject "Updated Subject"',
-        'resend broadcasts delete d1c2b3a4-5e6f-7a8b-9c0d-e1f2a3b4c5d6 --yes',
-      ],
-    }),
-  )
-  .addCommand(createBroadcastCommand)
-  .addCommand(sendBroadcastCommand)
-  .addCommand(getBroadcastCommand)
-  .addCommand(listBroadcastsCommand, { isDefault: true })
-  .addCommand(updateBroadcastCommand)
-  .addCommand(deleteBroadcastCommand);