resend-cli 1.2.1 → 1.2.2

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

@@ -1,83 +0,0 @@
-import { Command, Option } from '@commander-js/extra-typings';
-import { runCreate } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { requireText } from '../../lib/prompts';
-import { renderDnsRecordsTable } from './utils';
-
-export const createDomainCommand = new Command('create')
-  .description('Create a new domain and receive DNS records to configure')
-  .option('--name <domain>', 'Domain name (e.g. example.com)')
-  .addOption(
-    new Option('--region <region>', 'Sending region').choices([
-      'us-east-1',
-      'eu-west-1',
-      'sa-east-1',
-      'ap-northeast-1',
-    ] as const),
-  )
-  .addOption(
-    new Option('--tls <mode>', 'TLS mode (default: opportunistic)').choices([
-      'opportunistic',
-      'enforced',
-    ] as const),
-  )
-  .option('--sending', 'Enable sending capability (default: enabled)')
-  .option('--receiving', 'Enable receiving capability (default: disabled)')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context:
-        'Non-interactive: --name is required (no prompts when stdin/stdout is not a TTY)',
-      output:
-        '  Full domain object with DNS records array to configure in your DNS provider.',
-      errorCodes: ['auth_error', 'missing_name', 'create_error'],
-      examples: [
-        'resend domains create --name example.com',
-        'resend domains create --name example.com --region eu-west-1 --tls enforced',
-        'resend domains create --name example.com --receiving --json',
-        'resend domains create --name example.com --sending --receiving --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const name = await requireText(
-      opts.name,
-      { message: 'Domain name', placeholder: 'example.com' },
-      { message: 'Missing --name flag.', code: 'missing_name' },
-      globalOpts,
-    );
-
-    await runCreate(
-      {
-        spinner: {
-          loading: 'Creating domain...',
-          success: 'Domain created',
-          fail: 'Failed to create domain',
-        },
-        sdkCall: (resend) =>
-          resend.domains.create({
-            name,
-            ...(opts.region && { region: opts.region }),
-            ...(opts.tls && { tls: opts.tls }),
-            ...((opts.sending || opts.receiving) && {
-              capabilities: {
-                ...(opts.sending && { sending: 'enabled' as const }),
-                ...(opts.receiving && { receiving: 'enabled' as const }),
-              },
-            }),
-          }),
-        onInteractive: (d) => {
-          console.log(`\nDomain created: ${d.name} (id: ${d.id})`);
-          console.log('\nDNS Records to configure:');
-          console.log(renderDnsRecordsTable(d.records, d.name));
-          console.log(
-            `\nRun \`resend domains verify ${d.id}\` after configuring DNS.`,
-          );
-        },
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,42 +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 deleteDomainCommand = new Command('delete')
-  .alias('rm')
-  .description('Delete a domain')
-  .argument('<id>', 'Domain ID')
-  .option('--yes', 'Skip confirmation prompt')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context:
-        'Non-interactive: --yes is required to confirm deletion when stdin/stdout is not a TTY.',
-      output: '  {"object":"domain","id":"<id>","deleted":true}',
-      errorCodes: ['auth_error', 'confirmation_required', 'delete_error'],
-      examples: [
-        'resend domains delete 4dd369bc-aa82-4ff3-97de-514ae3000ee0 --yes',
-        'resend domains delete 4dd369bc-aa82-4ff3-97de-514ae3000ee0 --yes --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runDelete(
-      id,
-      !!opts.yes,
-      {
-        confirmMessage: `Delete domain ${id}?\nThis cannot be undone.`,
-        spinner: {
-          loading: 'Deleting domain...',
-          success: 'Domain deleted',
-          fail: 'Failed to delete domain',
-        },
-        object: 'domain',
-        successMsg: 'Domain deleted.',
-        sdkCall: (resend) => resend.domains.remove(id),
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,47 +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 { renderDnsRecordsTable, statusIndicator } from './utils';
-
-export const getDomainCommand = new Command('get')
-  .description(
-    'Retrieve a domain with its DNS records and current verification status',
-  )
-  .argument('<id>', 'Domain ID')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output:
-        '  Full domain object including records array and current status.\n\nDomain status values: not_started | pending | verified | failed | temporary_failure',
-      errorCodes: ['auth_error', 'fetch_error'],
-      examples: [
-        'resend domains get 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
-        'resend domains get 4dd369bc-aa82-4ff3-97de-514ae3000ee0 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runGet(
-      {
-        spinner: {
-          loading: 'Fetching domain...',
-          success: 'Domain fetched',
-          fail: 'Failed to fetch domain',
-        },
-        sdkCall: (resend) => resend.domains.get(id),
-        onInteractive: (d) => {
-          console.log(`\n${d.name} — ${statusIndicator(d.status)}`);
-          console.log(`ID: ${d.id}`);
-          console.log(`Region: ${d.region}`);
-          console.log(`Created: ${d.created_at}`);
-          if (d.records.length > 0) {
-            console.log('\nDNS Records:');
-            console.log(renderDnsRecordsTable(d.records, d.name));
-          }
-        },
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,35 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { createDomainCommand } from './create';
-import { deleteDomainCommand } from './delete';
-import { getDomainCommand } from './get';
-import { listDomainsCommand } from './list';
-import { updateDomainCommand } from './update';
-import { verifyDomainCommand } from './verify';
-
-export const domainsCommand = new Command('domains')
-  .description('Manage verified sending and receiving domains')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Domain lifecycle:
-  1. resend domains create --name example.com    (get DNS records)
-  2. Configure DNS records at your DNS provider
-  3. resend domains verify <id>                  (trigger verification)
-  4. resend domains get <id>                     (poll until "verified")`,
-      examples: [
-        'resend domains list',
-        'resend domains create --name example.com --region us-east-1',
-        'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
-        'resend domains get 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
-        'resend domains update <id> --tls enforced --open-tracking',
-        'resend domains delete <id> --yes',
-      ],
-    }),
-  )
-  .addCommand(createDomainCommand)
-  .addCommand(verifyDomainCommand)
-  .addCommand(getDomainCommand)
-  .addCommand(listDomainsCommand, { isDefault: true })
-  .addCommand(updateDomainCommand)
-  .addCommand(deleteDomainCommand);

package/.claude/worktrees/emails-list/src/commands/domains/list.ts

@@ -1,53 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { runList } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import {
-  buildPaginationOpts,
-  parseLimitOpt,
-  printPaginationHint,
-} from '../../lib/pagination';
-import { renderDomainsTable } from './utils';
-
-export const listDomainsCommand = new Command('list')
-  .alias('ls')
-  .description('List all domains')
-  .option('--limit <n>', 'Maximum number of domains to return (1-100)', '10')
-  .option('--after <cursor>', 'Return domains after this cursor (next page)')
-  .option(
-    '--before <cursor>',
-    'Return domains before this cursor (previous page)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output:
-        '  {"object":"list","data":[...],"has_more":true}\n  The list response does not include DNS records — use "resend domains get <id>" for that.',
-      errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
-      examples: [
-        'resend domains list',
-        'resend domains list --limit 25 --json',
-        'resend domains list --after <cursor> --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    const limit = parseLimitOpt(opts.limit, globalOpts);
-    const paginationOpts = buildPaginationOpts(limit, opts.after, opts.before);
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching domains...',
-          success: 'Domains fetched',
-          fail: 'Failed to list domains',
-        },
-        sdkCall: (resend) => resend.domains.list(paginationOpts),
-        onInteractive: (list) => {
-          console.log(renderDomainsTable(list.data));
-          printPaginationHint(list);
-        },
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/domains/update.ts

@@ -1,75 +0,0 @@
-import { Command, Option } from '@commander-js/extra-typings';
-import type { UpdateDomainsOptions } from 'resend';
-import { runWrite } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { outputError } from '../../lib/output';
-
-export const updateDomainCommand = new Command('update')
-  .description(
-    'Update domain settings: TLS mode, open tracking, and click tracking',
-  )
-  .argument('<id>', 'Domain ID')
-  .addOption(
-    new Option('--tls <mode>', 'TLS mode').choices([
-      'opportunistic',
-      'enforced',
-    ] as const),
-  )
-  .option('--open-tracking', 'Enable open tracking')
-  .option('--no-open-tracking', 'Disable open tracking')
-  .option('--click-tracking', 'Enable click tracking')
-  .option('--no-click-tracking', 'Disable click tracking')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output: '  {"object":"domain","id":"<id>"}',
-      errorCodes: ['auth_error', 'no_changes', 'update_error'],
-      examples: [
-        'resend domains update <id> --tls enforced',
-        'resend domains update <id> --open-tracking --click-tracking',
-        'resend domains update <id> --no-open-tracking --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const { tls, openTracking, clickTracking } = opts;
-
-    if (!tls && openTracking === undefined && clickTracking === undefined) {
-      outputError(
-        {
-          message:
-            'Provide at least one option to update: --tls, --open-tracking, or --click-tracking.',
-          code: 'no_changes',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    const payload: UpdateDomainsOptions = { id };
-    if (tls) {
-      payload.tls = tls;
-    }
-    if (openTracking !== undefined) {
-      payload.openTracking = openTracking;
-    }
-    if (clickTracking !== undefined) {
-      payload.clickTracking = clickTracking;
-    }
-
-    await runWrite(
-      {
-        spinner: {
-          loading: 'Updating domain...',
-          success: 'Domain updated',
-          fail: 'Failed to update domain',
-        },
-        sdkCall: (resend) => resend.domains.update(payload),
-        errorCode: 'update_error',
-        successMsg: `Domain updated: ${id}`,
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/domains/utils.ts

@@ -1,44 +0,0 @@
-import type { DomainRecords } from 'resend';
-import { renderTable } from '../../lib/table';
-
-export function renderDnsRecordsTable(
-  records: DomainRecords[],
-  domainName: string,
-): string {
-  const rows = records.map((r) => {
-    const displayName = r.name
-      ? r.name.includes('.')
-        ? r.name
-        : `${r.name}.${domainName}`
-      : domainName;
-    return [r.type, displayName, r.ttl, r.value];
-  });
-  return renderTable(
-    ['Type', 'Name', 'TTL', 'Value'],
-    rows,
-    '(no DNS records)',
-  );
-}
-
-export function renderDomainsTable(
-  domains: Array<{ id: string; name: string; status: string; region: string }>,
-): string {
-  const rows = domains.map((d) => [d.name, d.status, d.region, d.id]);
-  return renderTable(['Name', 'Status', 'Region', 'ID'], rows, '(no domains)');
-}
-
-export function statusIndicator(status: string): string {
-  switch (status) {
-    case 'verified':
-      return '✓ Verified';
-    case 'pending':
-      return '⏳ Pending';
-    case 'not_started':
-      return '○ Not started';
-    case 'failed':
-    case 'temporary_failure':
-      return '✗ Failed';
-    default:
-      return status;
-  }
-}

package/.claude/worktrees/emails-list/src/commands/domains/verify.ts

@@ -1,38 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { runWrite } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-
-export const verifyDomainCommand = new Command('verify')
-  .description('Trigger async DNS verification for a domain')
-  .argument('<id>', 'Domain ID')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Verification is async — the domain enters "pending" status while DNS records are checked.
-Poll the status with: resend domains get <id>`,
-      output: '  {"object":"domain","id":"<id>"}',
-      errorCodes: ['auth_error', 'verify_error'],
-      examples: [
-        'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0',
-        'resend domains verify 4dd369bc-aa82-4ff3-97de-514ae3000ee0 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    await runWrite(
-      {
-        spinner: {
-          loading: 'Verifying domain...',
-          success: 'Verification started',
-          fail: 'Failed to verify domain',
-        },
-        sdkCall: (resend) => resend.domains.verify(id),
-        errorCode: 'verify_error',
-        successMsg: `Domain verification started. Check status with resend domains get ${id}.`,
-      },
-      globalOpts,
-    );
-  });

package/.claude/worktrees/emails-list/src/commands/emails/batch.ts

@@ -1,140 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import type { CreateBatchOptions } from 'resend';
-import type { GlobalOpts } from '../../lib/client';
-import { requireClient } from '../../lib/client';
-import { readFile } from '../../lib/files';
-import { buildHelpText } from '../../lib/help-text';
-import { outputError, outputResult } from '../../lib/output';
-import { requireText } from '../../lib/prompts';
-import { withSpinner } from '../../lib/spinner';
-import { isInteractive } from '../../lib/tty';
-
-export const batchCommand = new Command('batch')
-  .description('Send up to 100 emails in a single API request from a JSON file')
-  .option(
-    '--file <path>',
-    'Path to a JSON file containing an array of email objects (required in non-interactive mode)',
-  )
-  .option(
-    '--idempotency-key <key>',
-    'Deduplicate this batch request using this key',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context:
-        'Non-interactive: --file\nLimit: 100 emails per request (API hard limit — warned if exceeded)\nUnsupported per-email fields: attachments, scheduled_at\n\nFile format (--file path):\n  [\n    {"from":"you@domain.com","to":["user@example.com"],"subject":"Hello","text":"Hi"},\n    {"from":"you@domain.com","to":["other@example.com"],"subject":"Hello","html":"<b>Hi</b>"}\n  ]',
-      output: '  [{"id":"<email-id>"},{"id":"<email-id>"}]',
-      errorCodes: [
-        'auth_error',
-        'missing_file',
-        'file_read_error',
-        'invalid_json',
-        'invalid_format',
-        'batch_error',
-      ],
-      examples: [
-        'resend emails batch --file ./emails.json',
-        'resend emails batch --file ./emails.json --json',
-        'resend emails batch --file ./emails.json --idempotency-key my-batch-2026-02-18',
-        'RESEND_API_KEY=re_123 resend emails batch --file ./emails.json --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const resend = requireClient(globalOpts);
-
-    const filePath = await requireText(
-      opts.file,
-      { message: 'Path to JSON file', placeholder: './emails.json' },
-      {
-        message:
-          'Missing --file flag. Provide a JSON file with an array of email objects.',
-        code: 'missing_file',
-      },
-      globalOpts,
-    );
-
-    const raw = readFile(filePath, globalOpts);
-
-    let parsed: unknown;
-    try {
-      parsed = JSON.parse(raw);
-    } catch {
-      outputError(
-        { message: 'File content is not valid JSON.', code: 'invalid_json' },
-        { json: globalOpts.json },
-      );
-    }
-
-    if (!Array.isArray(parsed)) {
-      outputError(
-        {
-          message: 'File content must be a JSON array of email objects.',
-          code: 'invalid_format',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    const emails = parsed as unknown[];
-
-    if (emails.length > 100) {
-      console.warn(
-        `Warning: ${emails.length} emails exceeds the 100-email limit. The API may reject this request.`,
-      );
-    }
-
-    for (let i = 0; i < emails.length; i++) {
-      const email = emails[i] as Record<string, unknown>;
-      if ('attachments' in email) {
-        outputError(
-          {
-            message: `Email at index ${i} contains "attachments", which is not supported in batch sends.`,
-            code: 'batch_error',
-          },
-          { json: globalOpts.json },
-        );
-      }
-      if ('scheduled_at' in email) {
-        outputError(
-          {
-            message: `Email at index ${i} contains "scheduled_at", which is not supported in batch sends.`,
-            code: 'batch_error',
-          },
-          { json: globalOpts.json },
-        );
-      }
-    }
-
-    const batchData = await withSpinner(
-      {
-        loading: 'Sending batch...',
-        success: 'Batch sent',
-        fail: 'Failed to send batch',
-      },
-      () =>
-        resend.batch.send(
-          emails as CreateBatchOptions,
-          opts.idempotencyKey
-            ? { idempotencyKey: opts.idempotencyKey }
-            : undefined,
-        ),
-      'batch_error',
-      globalOpts,
-    );
-
-    const emailIds = batchData.data;
-    if (!globalOpts.json && isInteractive()) {
-      console.log(
-        `Sent ${emailIds.length} email${emailIds.length === 1 ? '' : 's'}`,
-      );
-      for (const email of emailIds) {
-        console.log(`  ${email.id}`);
-      }
-    } else {
-      outputResult(emailIds, { json: globalOpts.json });
-    }
-  });

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

@@ -1,28 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { batchCommand } from './batch';
-import { listCommand } from './list';
-import { receivingCommand } from './receiving/index';
-import { sendCommand } from './send';
-
-export const emailsCommand = new Command('emails')
-  .description('Send and manage emails')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      examples: [
-        'resend emails send --from you@domain.com --to user@example.com --subject "Hello" --text "Hi"',
-        'resend emails list',
-        'resend emails list --limit 25 --json',
-        'resend emails batch --file ./emails.json',
-        'resend emails receiving list',
-        'resend emails receiving get <email-id>',
-        'resend emails receiving attachments <email-id>',
-        'resend emails receiving attachment <email-id> <attachment-id>',
-      ],
-    }),
-  )
-  .addCommand(sendCommand)
-  .addCommand(listCommand)
-  .addCommand(batchCommand)
-  .addCommand(receivingCommand);

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

@@ -1,73 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import type { ListEmail } from 'resend';
-import { runList } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import {
-  buildPaginationOpts,
-  parseLimitOpt,
-  printPaginationHint,
-} from '../../lib/pagination';
-import { renderTable } from '../../lib/table';
-
-function renderEmailsTable(emails: ListEmail[]): string {
-  const rows = emails.map((e) => {
-    const to = e.to.join(', ');
-    const toStr = to.length > 40 ? `${to.slice(0, 37)}...` : to;
-    const subject =
-      e.subject.length > 50 ? `${e.subject.slice(0, 47)}...` : e.subject;
-    return [e.from, toStr, subject, e.last_event, e.created_at, e.id];
-  });
-  return renderTable(
-    ['From', 'To', 'Subject', 'Last Event', 'Created At', 'ID'],
-    rows,
-    '(no emails)',
-  );
-}
-
-export const listCommand = new Command('list')
-  .alias('ls')
-  .description('List sent emails')
-  .option('--limit <n>', 'Maximum number of emails to return (1-100)', '10')
-  .option('--after <cursor>', 'Return emails after this cursor (next page)')
-  .option(
-    '--before <cursor>',
-    'Return emails before this cursor (previous page)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context:
-        'Pagination: use --after or --before with an email ID as the cursor.\nOnly one of --after or --before may be used at a time.\nThe response includes has_more: true when additional pages exist.',
-      output:
-        '  {"object":"list","has_more":false,"data":[{"id":"<uuid>","from":"you@domain.com","to":["user@example.com"],"subject":"Hello","created_at":"<iso-date>","last_event":"delivered","bcc":null,"cc":null,"reply_to":null}]}',
-      errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
-      examples: [
-        'resend emails list',
-        'resend emails list --limit 25 --json',
-        'resend emails list --after <email-id> --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const limit = parseLimitOpt(opts.limit, globalOpts);
-    const paginationOpts = buildPaginationOpts(limit, opts.after, opts.before);
-
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching emails...',
-          success: 'Emails fetched',
-          fail: 'Failed to list emails',
-        },
-        sdkCall: (resend) => resend.emails.list(paginationOpts),
-        onInteractive: (list) => {
-          console.log(renderEmailsTable(list.data));
-          printPaginationHint(list);
-        },
-      },
-      globalOpts,
-    );
-  });