resend-cli 1.2.1 → 1.2.2

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

@@ -1,36 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { createSegmentCommand } from './create';
-import { deleteSegmentCommand } from './delete';
-import { getSegmentCommand } from './get';
-import { listSegmentsCommand } from './list';
-
-export const segmentsCommand = new Command('segments')
-  .description(
-    'Manage segments — named groups of contacts used to target broadcasts',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Segments are the modern replacement for Audiences (deprecated).
-A segment is a named group of contacts. Broadcasts target segments via segment_id.
-Contacts can belong to multiple segments.
-
-Segment membership is managed through the contacts namespace:
-  resend contacts add-segment <contactId> --segment-id <segmentId>
-  resend contacts remove-segment <contactId> <segmentId>
-  resend contacts segments <contactId>
-
-There is no "update" endpoint — to rename a segment, delete it and recreate.`,
-      examples: [
-        'resend segments list',
-        'resend segments create --name "Newsletter Subscribers"',
-        'resend segments get 78261eea-8f8b-4381-83c6-79fa7120f1cf',
-        'resend segments delete 78261eea-8f8b-4381-83c6-79fa7120f1cf --yes',
-      ],
-    }),
-  )
-  .addCommand(createSegmentCommand)
-  .addCommand(getSegmentCommand)
-  .addCommand(listSegmentsCommand, { isDefault: true })
-  .addCommand(deleteSegmentCommand);

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

@@ -1,58 +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 { renderSegmentsTable } from './utils';
-
-export const listSegmentsCommand = new Command('list')
-  .alias('ls')
-  .description('List all segments')
-  .option('--limit <n>', 'Maximum number of segments to return (1-100)', '10')
-  .option('--after <cursor>', 'Return segments after this cursor (next page)')
-  .option(
-    '--before <cursor>',
-    'Return segments before this cursor (previous page)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Pagination: use --after or --before with a segment ID as the cursor.
-  Only one of --after or --before may be used at a time.
-  The response includes has_more: true when additional pages exist.
-
-Use "resend segments list" to discover segment IDs for use with broadcasts
-or "resend contacts add-segment".`,
-      output: `  {"object":"list","data":[{"id":"<uuid>","name":"<name>","created_at":"<iso-date>"}],"has_more":false}`,
-      errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
-      examples: [
-        'resend segments list',
-        'resend segments list --limit 25 --json',
-        'resend segments list --after 78261eea-8f8b-4381-83c6-79fa7120f1cf --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 segments...',
-          success: 'Segments fetched',
-          fail: 'Failed to list segments',
-        },
-        sdkCall: (resend) => resend.segments.list(paginationOpts),
-        onInteractive: (list) => {
-          console.log(renderSegmentsTable(list.data));
-          printPaginationHint(list);
-        },
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,7 +0,0 @@
-import type { Segment } from 'resend';
-import { renderTable } from '../../lib/table';
-
-export function renderSegmentsTable(segments: Segment[]): string {
-  const rows = segments.map((s) => [s.name, s.id, s.created_at]);
-  return renderTable(['Name', 'ID', 'Created'], rows, '(no segments)');
-}

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

@@ -1,10 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { listCommand } from './list';
-import { removeCommand } from './remove';
-import { switchCommand } from './switch';
-
-export const teamsCommand = new Command('teams')
-  .description('Manage team profiles for multiple API keys')
-  .addCommand(listCommand)
-  .addCommand(switchCommand)
-  .addCommand(removeCommand);

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

@@ -1,35 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import type { GlobalOpts } from '../../lib/client';
-import { listTeams } from '../../lib/config';
-import { outputResult } from '../../lib/output';
-import { isInteractive } from '../../lib/tty';
-
-export const listCommand = new Command('list')
-  .description('List all team profiles')
-  .action((_opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    const teams = listTeams();
-
-    if (globalOpts.json) {
-      outputResult({ teams }, { json: true });
-      return;
-    }
-
-    if (teams.length === 0) {
-      console.log('No teams configured. Run: resend login');
-      return;
-    }
-
-    if (isInteractive()) {
-      console.log('\n  Teams\n');
-    }
-
-    for (const team of teams) {
-      const marker = team.active ? ' (active)' : '';
-      console.log(`  ${team.active ? '▸' : ' '} ${team.name}${marker}`);
-    }
-
-    if (isInteractive()) {
-      console.log('');
-    }
-  });

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

@@ -1,83 +0,0 @@
-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 { errorMessage, outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-
-export const removeCommand = new Command('remove')
-  .description('Remove a team profile')
-  .argument('[name]', 'Team name to remove')
-  .action(async (name, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    let teamName = name;
-
-    if (!teamName) {
-      if (!isInteractive()) {
-        outputError(
-          {
-            message:
-              'Missing team name. Provide a team name in non-interactive mode.',
-            code: 'missing_name',
-          },
-          { json: globalOpts.json },
-        );
-      }
-
-      const teams = listTeams();
-      if (teams.length === 0) {
-        outputError(
-          {
-            message: 'No teams configured. Run `resend login` first.',
-            code: 'no_teams',
-          },
-          { json: globalOpts.json },
-        );
-      }
-
-      const choice = await p.select({
-        message: 'Remove which team?',
-        options: teams.map((t) => ({
-          value: t.name,
-          label: t.name,
-          hint: t.active ? 'active' : undefined,
-        })),
-      });
-
-      if (p.isCancel(choice)) {
-        cancelAndExit('Remove cancelled.');
-      }
-
-      teamName = choice;
-    }
-
-    if (!globalOpts.json && isInteractive()) {
-      const confirmed = await p.confirm({
-        message: `Remove team '${teamName}' and its API key?`,
-      });
-
-      if (p.isCancel(confirmed) || !confirmed) {
-        cancelAndExit('Remove cancelled.');
-      }
-    }
-
-    try {
-      removeTeam(teamName);
-    } catch (err) {
-      outputError(
-        {
-          message: errorMessage(err, 'Failed to remove team'),
-          code: 'remove_failed',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    if (globalOpts.json) {
-      outputResult({ success: true, removed_team: teamName }, { json: true });
-    } else if (isInteractive()) {
-      console.log(`Team '${teamName}' removed.`);
-    }
-  });

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

@@ -1,73 +0,0 @@
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import type { GlobalOpts } from '../../lib/client';
-import { listTeams, setActiveTeam } from '../../lib/config';
-import { errorMessage, outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-
-export const switchCommand = new Command('switch')
-  .description('Switch the active team profile')
-  .argument('[name]', 'Team name to switch to')
-  .action(async (name, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    let teamName = name;
-
-    if (!teamName) {
-      if (!isInteractive()) {
-        outputError(
-          {
-            message:
-              'Missing team name. Provide a team name in non-interactive mode.',
-            code: 'missing_name',
-          },
-          { json: globalOpts.json },
-        );
-      }
-
-      const teams = listTeams();
-      if (teams.length === 0) {
-        outputError(
-          {
-            message: 'No teams configured. Run `resend login` first.',
-            code: 'no_teams',
-          },
-          { json: globalOpts.json },
-        );
-      }
-
-      const choice = await p.select({
-        message: 'Switch to which team?',
-        options: teams.map((t) => ({
-          value: t.name,
-          label: t.name,
-          hint: t.active ? 'active' : undefined,
-        })),
-      });
-
-      if (p.isCancel(choice)) {
-        cancelAndExit('Switch cancelled.');
-      }
-
-      teamName = choice;
-    }
-
-    try {
-      setActiveTeam(teamName);
-    } catch (err) {
-      outputError(
-        {
-          message: errorMessage(err, 'Failed to switch team'),
-          code: 'switch_failed',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    if (globalOpts.json) {
-      outputResult({ success: true, active_team: teamName }, { json: true });
-    } else if (isInteractive()) {
-      console.log(`Switched to team '${teamName}'.`);
-    }
-  });

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

@@ -1,73 +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';
-
-export const createTopicCommand = new Command('create')
-  .description('Create a new topic for subscription management')
-  .option('--name <name>', 'Topic name (required)')
-  .option(
-    '--description <description>',
-    'Description shown to contacts when managing subscriptions',
-  )
-  .addOption(
-    new Option(
-      '--default-subscription <mode>',
-      'Default subscription state for contacts',
-    )
-      .choices(['opt_in', 'opt_out'] as const)
-      .default('opt_in' as const),
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Topics enable fine-grained subscription management. Contacts can opt in or out of
-individual topics. Broadcasts can target only contacts opted into a specific topic.
-
-Example topics: "Product Updates", "Security Alerts", "Weekly Digest".
-
---default-subscription controls what happens for contacts with no explicit subscription:
-  opt_in   Contacts receive broadcasts unless they explicitly opt out (default)
-  opt_out  Contacts do NOT receive broadcasts unless they explicitly opt in
-
-Non-interactive: --name is required.`,
-      output: `  {"id":"<uuid>"}`,
-      errorCodes: ['auth_error', 'missing_name', 'create_error'],
-      examples: [
-        'resend topics create --name "Product Updates"',
-        'resend topics create --name "Weekly Digest" --default-subscription opt_out',
-        'resend topics create --name "Security Alerts" --description "Critical security notices" --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const name = await requireText(
-      opts.name,
-      { message: 'Topic name', placeholder: 'Product Updates' },
-      { message: 'Missing --name flag.', code: 'missing_name' },
-      globalOpts,
-    );
-
-    await runCreate(
-      {
-        spinner: {
-          loading: 'Creating topic...',
-          success: 'Topic created',
-          fail: 'Failed to create topic',
-        },
-        sdkCall: (resend) =>
-          resend.topics.create({
-            name,
-            defaultSubscription: opts.defaultSubscription,
-            ...(opts.description && { description: opts.description }),
-          }),
-        onInteractive: (data) => {
-          console.log(`\nTopic created: ${data.id}`);
-        },
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,47 +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 deleteTopicCommand = new Command('delete')
-  .alias('rm')
-  .description('Delete a topic')
-  .argument('<id>', 'Topic UUID')
-  .option(
-    '--yes',
-    'Skip the confirmation prompt (required in non-interactive mode)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Warning: Deleting a topic removes all contact subscriptions to that topic and may affect
-  broadcasts that reference this topic_id. Contacts themselves are not deleted.
-
-Non-interactive: --yes is required to confirm deletion when stdin/stdout is not a TTY.`,
-      output: `  {"object":"topic","id":"<uuid>","deleted":true}`,
-      errorCodes: ['auth_error', 'confirmation_required', 'delete_error'],
-      examples: [
-        'resend topics delete 78261eea-8f8b-4381-83c6-79fa7120f1cf --yes',
-        'resend topics delete 78261eea-8f8b-4381-83c6-79fa7120f1cf --yes --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runDelete(
-      id,
-      !!opts.yes,
-      {
-        confirmMessage: `Delete topic ${id}?\nAll contact subscriptions and broadcast associations will be removed.`,
-        spinner: {
-          loading: 'Deleting topic...',
-          success: 'Topic deleted',
-          fail: 'Failed to delete topic',
-        },
-        object: 'topic',
-        successMsg: 'Topic deleted.',
-        sdkCall: (resend) => resend.topics.remove(id),
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,42 +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';
-
-export const getTopicCommand = new Command('get')
-  .description('Retrieve a topic by ID')
-  .argument('<id>', 'Topic UUID')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output: `  {"id":"<uuid>","name":"<name>","description":"<desc>","default_subscription":"opt_in|opt_out","created_at":"<iso-date>"}`,
-      errorCodes: ['auth_error', 'fetch_error'],
-      examples: [
-        'resend topics get 78261eea-8f8b-4381-83c6-79fa7120f1cf',
-        'resend topics get 78261eea-8f8b-4381-83c6-79fa7120f1cf --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runGet(
-      {
-        spinner: {
-          loading: 'Fetching topic...',
-          success: 'Topic fetched',
-          fail: 'Failed to fetch topic',
-        },
-        sdkCall: (resend) => resend.topics.get(id),
-        onInteractive: (data) => {
-          console.log(`\n${data.name}`);
-          console.log(`ID: ${data.id}`);
-          if (data.description) {
-            console.log(`Description: ${data.description}`);
-          }
-          console.log(`Default subscription: ${data.default_subscription}`);
-          console.log(`Created: ${data.created_at}`);
-        },
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,42 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { createTopicCommand } from './create';
-import { deleteTopicCommand } from './delete';
-import { getTopicCommand } from './get';
-import { listTopicsCommand } from './list';
-import { updateTopicCommand } from './update';
-
-export const topicsCommand = new Command('topics')
-  .description('Manage topics for contact subscription preferences')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Topics enable fine-grained subscription management beyond the global unsubscribe flag.
-A contact can opt in or out of individual topics independently.
-
-Broadcasts can target a topic_id so only contacts who have opted into that topic
-receive the email. Contacts with no subscription record use the topic's
-default_subscription setting.
-
-Subscription states:
-  opt_in   Contact will receive broadcasts for this topic
-  opt_out  Contact will NOT receive broadcasts for this topic
-
-Contact topic subscriptions are managed via the contacts namespace:
-  resend contacts topics <contactId>
-  resend contacts update-topics <contactId> --topic-id <id> --subscription opt_in`,
-      examples: [
-        'resend topics list',
-        'resend topics create --name "Product Updates"',
-        'resend topics create --name "Weekly Digest" --default-subscription opt_out',
-        'resend topics get 78261eea-8f8b-4381-83c6-79fa7120f1cf',
-        'resend topics update 78261eea-8f8b-4381-83c6-79fa7120f1cf --name "Security Alerts"',
-        'resend topics delete 78261eea-8f8b-4381-83c6-79fa7120f1cf --yes',
-      ],
-    }),
-  )
-  .addCommand(createTopicCommand)
-  .addCommand(getTopicCommand)
-  .addCommand(listTopicsCommand, { isDefault: true })
-  .addCommand(updateTopicCommand)
-  .addCommand(deleteTopicCommand);

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

@@ -1,34 +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 { renderTopicsTable } from './utils';
-
-export const listTopicsCommand = new Command('list')
-  .alias('ls')
-  .description('List all topics')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Returns all topics in your account. Topic subscription management for individual
-contacts is handled via "resend contacts topics <contactId>".`,
-      output: `  {"data":[{"id":"<uuid>","name":"<name>","description":"<desc>","default_subscription":"opt_in|opt_out","created_at":"<iso-date>"}]}`,
-      errorCodes: ['auth_error', 'list_error'],
-      examples: ['resend topics list', 'resend topics list --json'],
-    }),
-  )
-  .action(async (_opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching topics...',
-          success: 'Topics fetched',
-          fail: 'Failed to list topics',
-        },
-        sdkCall: (resend) => resend.topics.list(),
-        onInteractive: (list) => console.log(renderTopicsTable(list.data)),
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,59 +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';
-import { outputError } from '../../lib/output';
-
-export const updateTopicCommand = new Command('update')
-  .description("Update a topic's name or description")
-  .argument('<id>', 'Topic UUID')
-  .option('--name <name>', 'New topic name')
-  .option('--description <description>', 'New description shown to contacts')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `At least one of --name or --description must be provided to update the topic.
-
-Note: --default-subscription cannot be changed after creation.
-To change the default subscription, delete the topic and recreate it.`,
-      output: `  {"id":"<uuid>"}`,
-      errorCodes: ['auth_error', 'no_changes', 'update_error'],
-      examples: [
-        'resend topics update 78261eea-8f8b-4381-83c6-79fa7120f1cf --name "Security Alerts"',
-        'resend topics update 78261eea-8f8b-4381-83c6-79fa7120f1cf --description "Critical notices" --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    if (!opts.name && !opts.description) {
-      outputError(
-        {
-          message:
-            'Provide at least one option to update: --name or --description.',
-          code: 'no_changes',
-        },
-        { json: globalOpts.json },
-      );
-    }
-
-    await runWrite(
-      {
-        spinner: {
-          loading: 'Updating topic...',
-          success: 'Topic updated',
-          fail: 'Failed to update topic',
-        },
-        sdkCall: (resend) =>
-          resend.topics.update({
-            id,
-            ...(opts.name && { name: opts.name }),
-            ...(opts.description && { description: opts.description }),
-          }),
-        errorCode: 'update_error',
-        successMsg: `Topic updated: ${id}`,
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,16 +0,0 @@
-import type { Topic } from 'resend';
-import { renderTable } from '../../lib/table';
-
-export function renderTopicsTable(topics: Topic[]): string {
-  const rows = topics.map((t) => [
-    t.name,
-    t.description ?? '',
-    t.id,
-    t.created_at,
-  ]);
-  return renderTable(
-    ['Name', 'Description', 'ID', 'Created'],
-    rows,
-    '(no topics)',
-  );
-}