resend-cli 1.2.2 → 1.3.0

package/src/commands/contact-properties/utils.ts

@@ -1,17 +0,0 @@
-import type { ContactProperty } from 'resend';
-import { renderTable } from '../../lib/table';
-
-export function renderContactPropertiesTable(props: ContactProperty[]): string {
-  const rows = props.map((prop) => [
-    prop.key,
-    prop.type,
-    prop.fallbackValue != null ? String(prop.fallbackValue) : '',
-    prop.id,
-    prop.createdAt,
-  ]);
-  return renderTable(
-    ['Key', 'Type', 'Fallback Value', 'ID', 'Created'],
-    rows,
-    '(no contact properties)',
-  );
-}

package/src/commands/contacts/add-segment.ts

@@ -1,78 +0,0 @@
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import type { AddContactSegmentOptions } from 'resend';
-import type { GlobalOpts } from '../../lib/client';
-import { requireClient } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { withSpinner } from '../../lib/spinner';
-import { isInteractive } from '../../lib/tty';
-import { segmentContactIdentifier } from './utils';
-
-export const addContactSegmentCommand = new Command('add-segment')
-  .description('Add a contact to a segment')
-  .argument('<contactId>', 'Contact UUID or email address')
-  .option('--segment-id <id>', 'Segment ID to add the contact to (required)')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <contactId> argument accepts either a UUID or an email address.
-
-Non-interactive: --segment-id is required.`,
-      output: `  {"id":"<segment-membership-id>"}`,
-      errorCodes: ['auth_error', 'missing_segment_id', 'add_segment_error'],
-      examples: [
-        'resend contacts add-segment 479e3145-dd38-4932-8c0c-e58b548c9e76 --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
-        'resend contacts add-segment user@example.com --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --json',
-      ],
-    }),
-  )
-  .action(async (contactId, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    const resend = requireClient(globalOpts);
-
-    let segmentId = opts.segmentId;
-
-    if (!segmentId) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --segment-id flag.', code: 'missing_segment_id' },
-          { 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;
-    }
-
-    // segmentContactIdentifier resolves UUID vs email for the ContactSegmentsBaseOptions
-    // discriminated union. The spread of that union requires an explicit cast.
-    const payload = {
-      ...segmentContactIdentifier(contactId),
-      segmentId,
-    } as AddContactSegmentOptions;
-
-    const data = await withSpinner(
-      {
-        loading: 'Adding contact to segment...',
-        success: 'Contact added to segment',
-        fail: 'Failed to add contact to segment',
-      },
-      () => resend.contacts.segments.add(payload),
-      'add_segment_error',
-      globalOpts,
-    );
-
-    if (!globalOpts.json && isInteractive()) {
-      console.log(`Contact added to segment: ${segmentId}`);
-    } else {
-      outputResult(data, { json: globalOpts.json });
-    }
-  });

package/src/commands/contacts/create.ts

@@ -1,122 +0,0 @@
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import { runCreate } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { cancelAndExit, requireText } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-import { parsePropertiesJson } from './utils';
-
-export const createContactCommand = new Command('create')
-  .description('Create a new contact')
-  .option('--email <email>', 'Contact email address (required)')
-  .option('--first-name <name>', 'First name')
-  .option('--last-name <name>', 'Last name')
-  .option(
-    '--unsubscribed',
-    'Globally unsubscribe the contact from all broadcasts',
-  )
-  .option(
-    '--properties <json>',
-    'Custom properties as a JSON string (e.g. \'{"company":"Acme"}\')',
-  )
-  .option(
-    '--segment-id <id...>',
-    'Segment ID to add the contact to on creation (repeatable: --segment-id abc --segment-id def)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Non-interactive: --email is required. All other flags are optional.
-
-Properties: pass a JSON object string to --properties (e.g. '{"plan":"pro","company":"Acme"}').
-  Properties are stored as custom contact attributes. To clear a property, set it to null.
-  firstName and lastName are convenience aliases — they map to FIRST_NAME/LAST_NAME properties internally.
-
-Segments: use --segment-id once per segment to add the contact to one or more segments on creation.
-
-Unsubscribed: setting --unsubscribed is a team-wide opt-out from all broadcasts, regardless of segments/topics.`,
-      output: `  {"object":"contact","id":"<id>"}`,
-      errorCodes: [
-        'auth_error',
-        'missing_email',
-        'invalid_properties',
-        'create_error',
-      ],
-      examples: [
-        'resend contacts create --email jane@example.com',
-        'resend contacts create --email jane@example.com --first-name Jane --last-name Smith',
-        'resend contacts create --email jane@example.com --unsubscribed',
-        `resend contacts create --email jane@example.com --properties '{"company":"Acme","plan":"pro"}'`,
-        'resend contacts create --email jane@example.com --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --segment-id a2f4c6e8-1b3d-5f7a-9c2e-4d6f8a1b3c5e',
-        'resend contacts create --email jane@example.com --first-name Jane --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const email = await requireText(
-      opts.email,
-      { message: 'Email address', placeholder: 'user@example.com' },
-      { message: 'Missing --email flag.', code: 'missing_email' },
-      globalOpts,
-    );
-
-    let firstName = opts.firstName;
-    let lastName = opts.lastName;
-
-    if (isInteractive() && !opts.firstName) {
-      const result = await p.text({
-        message: 'First name (optional)',
-        placeholder: 'Jane',
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      if (result) {
-        firstName = result;
-      }
-    }
-
-    if (isInteractive() && !opts.lastName) {
-      const result = await p.text({
-        message: 'Last name (optional)',
-        placeholder: 'Smith',
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      if (result) {
-        lastName = result;
-      }
-    }
-
-    const properties = parsePropertiesJson(opts.properties, globalOpts);
-    const segments = opts.segmentId ?? [];
-
-    await runCreate(
-      {
-        spinner: {
-          loading: 'Creating contact...',
-          success: 'Contact created',
-          fail: 'Failed to create contact',
-        },
-        sdkCall: (resend) =>
-          resend.contacts.create({
-            email,
-            ...(firstName && { firstName }),
-            ...(lastName && { lastName }),
-            ...(opts.unsubscribed && { unsubscribed: true }),
-            ...(properties && { properties }),
-            ...(segments.length > 0 && {
-              segments: segments.map((id) => ({ id })),
-            }),
-          }),
-        onInteractive: (data) => {
-          console.log(`\nContact created: ${data.id}`);
-        },
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/delete.ts

@@ -1,49 +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 deleteContactCommand = new Command('delete')
-  .alias('rm')
-  .description('Delete a contact')
-  .argument(
-    '<id>',
-    'Contact UUID or email address — both are accepted by the API',
-  )
-  .option(
-    '--yes',
-    'Skip the confirmation prompt (required in non-interactive mode)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <id> argument accepts either a UUID or an email address.
-
-Non-interactive: --yes is required to confirm deletion when stdin/stdout is not a TTY.`,
-      output: `  {"object":"contact","id":"<id>","deleted":true}`,
-      errorCodes: ['auth_error', 'confirmation_required', 'delete_error'],
-      examples: [
-        'resend contacts delete 479e3145-dd38-4932-8c0c-e58b548c9e76 --yes',
-        'resend contacts delete user@example.com --yes --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runDelete(
-      id,
-      !!opts.yes,
-      {
-        confirmMessage: `Delete contact ${id}?\nThis cannot be undone.`,
-        spinner: {
-          loading: 'Deleting contact...',
-          success: 'Contact deleted',
-          fail: 'Failed to delete contact',
-        },
-        object: 'contact',
-        successMsg: 'Contact deleted.',
-        sdkCall: (resend) => resend.contacts.remove(id),
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/get.ts

@@ -1,53 +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 getContactCommand = new Command('get')
-  .description('Retrieve a contact by ID or email address')
-  .argument(
-    '<id>',
-    'Contact UUID or email address — both are accepted by the API',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output: `  {\n    "object": "contact",\n    "id": "<uuid>",\n    "email": "user@example.com",\n    "first_name": "Jane",\n    "last_name": "Smith",\n    "created_at": "2026-01-01T00:00:00.000Z",\n    "unsubscribed": false,\n    "properties": {}\n  }`,
-      errorCodes: ['auth_error', 'fetch_error'],
-      examples: [
-        'resend contacts get 479e3145-dd38-4932-8c0c-e58b548c9e76',
-        'resend contacts get user@example.com',
-        'resend contacts get 479e3145-dd38-4932-8c0c-e58b548c9e76 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runGet(
-      {
-        spinner: {
-          loading: 'Fetching contact...',
-          success: 'Contact fetched',
-          fail: 'Failed to fetch contact',
-        },
-        sdkCall: (resend) => resend.contacts.get(id),
-        onInteractive: (data) => {
-          const name = [data.first_name, data.last_name]
-            .filter(Boolean)
-            .join(' ');
-          console.log(`\n${data.email}${name ? ` (${name})` : ''}`);
-          console.log(`ID: ${data.id}`);
-          console.log(`Created: ${data.created_at}`);
-          console.log(`Unsubscribed: ${data.unsubscribed ? 'yes' : 'no'}`);
-          const propEntries = Object.entries(data.properties ?? {});
-          if (propEntries.length > 0) {
-            console.log('Properties:');
-            for (const [key, val] of propEntries) {
-              console.log(`  ${key}: ${val.value}`);
-            }
-          }
-        },
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/index.ts

@@ -1,58 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { addContactSegmentCommand } from './add-segment';
-import { createContactCommand } from './create';
-import { deleteContactCommand } from './delete';
-import { getContactCommand } from './get';
-import { listContactsCommand } from './list';
-import { removeContactSegmentCommand } from './remove-segment';
-import { listContactSegmentsCommand } from './segments';
-import { listContactTopicsCommand } from './topics';
-import { updateContactCommand } from './update';
-import { updateContactTopicsCommand } from './update-topics';
-
-export const contactsCommand = new Command('contacts')
-  .description('Manage contacts — the global list of people you send email to')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Contacts are global entities (not audience-scoped since the 2025 migration).
-Each contact is identified by a UUID or email address — both are accepted in all subcommands.
-
-Properties:
-  Contacts carry custom key-value properties (e.g. plan, company) accessible in broadcast templates
-  via {{{PROPERTY_NAME|fallback}}} triple-brace interpolation.
-  firstName/lastName are convenience aliases stored as FIRST_NAME/LAST_NAME properties.
-
-Subscription:
-  --unsubscribed is a team-wide opt-out from all broadcasts.
-  Fine-grained control is available via topic subscriptions (see "resend contacts topics").
-
-Segments:
-  Contacts can belong to multiple segments. Segments determine which contacts receive a broadcast.
-  Manage membership with "resend contacts add-segment" and "resend contacts remove-segment".`,
-      examples: [
-        'resend contacts list',
-        'resend contacts create --email jane@example.com --first-name Jane',
-        'resend contacts get 479e3145-dd38-4932-8c0c-e58b548c9e76',
-        'resend contacts get user@example.com',
-        'resend contacts update user@example.com --unsubscribed',
-        'resend contacts delete 479e3145-dd38-4932-8c0c-e58b548c9e76 --yes',
-        'resend contacts segments user@example.com',
-        'resend contacts add-segment user@example.com --segment-id 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
-        'resend contacts remove-segment user@example.com 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
-        'resend contacts topics user@example.com',
-        `resend contacts update-topics user@example.com --topics '[{"id":"topic-uuid","subscription":"opt_in"}]'`,
-      ],
-    }),
-  )
-  .addCommand(createContactCommand)
-  .addCommand(getContactCommand)
-  .addCommand(listContactsCommand, { isDefault: true })
-  .addCommand(updateContactCommand)
-  .addCommand(deleteContactCommand)
-  .addCommand(listContactSegmentsCommand)
-  .addCommand(addContactSegmentCommand)
-  .addCommand(removeContactSegmentCommand)
-  .addCommand(listContactTopicsCommand)
-  .addCommand(updateContactTopicsCommand);

package/src/commands/contacts/list.ts

@@ -1,57 +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 { renderContactsTable } from './utils';
-
-export const listContactsCommand = new Command('list')
-  .alias('ls')
-  .description('List all contacts')
-  .option('--limit <n>', 'Maximum number of contacts to return (1-100)', '10')
-  .option('--after <cursor>', 'Return contacts after this cursor (next page)')
-  .option(
-    '--before <cursor>',
-    'Return contacts before this cursor (previous page)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Contacts are global — they are not scoped to audiences or segments since the 2025 migration.
-
-Pagination: use --after or --before with a contact 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.`,
-      output: `  {"object":"list","data":[{"id":"...","email":"...","first_name":"...","last_name":"...","unsubscribed":false}],"has_more":false}`,
-      errorCodes: ['auth_error', 'invalid_limit', 'list_error'],
-      examples: [
-        'resend contacts list',
-        'resend contacts list --limit 25 --json',
-        'resend contacts list --after 479e3145-dd38-4932-8c0c-e58b548c9e76 --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 contacts...',
-          success: 'Contacts fetched',
-          fail: 'Failed to list contacts',
-        },
-        sdkCall: (resend) => resend.contacts.list(paginationOpts),
-        onInteractive: (list) => {
-          console.log(renderContactsTable(list.data));
-          printPaginationHint(list);
-        },
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/remove-segment.ts

@@ -1,48 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import type { RemoveContactSegmentOptions } from 'resend';
-import { runWrite } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { segmentContactIdentifier } from './utils';
-
-export const removeContactSegmentCommand = new Command('remove-segment')
-  .description('Remove a contact from a segment')
-  .argument('<contactId>', 'Contact UUID or email address')
-  .argument('<segmentId>', 'Segment ID to remove the contact from')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <contactId> argument accepts either a UUID or an email address.
-The <segmentId> argument must be a segment UUID (not an email).`,
-      output: `  {"id":"<segment-id>","deleted":true}`,
-      errorCodes: ['auth_error', 'remove_segment_error'],
-      examples: [
-        'resend contacts remove-segment 479e3145-dd38-4932-8c0c-e58b548c9e76 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d',
-        'resend contacts remove-segment user@example.com 7b1e0a3d-4c5f-4e8a-9b2d-1a3c5e7f9b2d --json',
-      ],
-    }),
-  )
-  .action(async (contactId, segmentId, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    // segmentContactIdentifier resolves UUID vs email for the ContactSegmentsBaseOptions
-    // discriminated union. The spread of that union requires an explicit cast.
-    const payload = {
-      ...segmentContactIdentifier(contactId),
-      segmentId,
-    } as RemoveContactSegmentOptions;
-
-    await runWrite(
-      {
-        spinner: {
-          loading: 'Removing contact from segment...',
-          success: 'Contact removed from segment',
-          fail: 'Failed to remove contact from segment',
-        },
-        sdkCall: (resend) => resend.contacts.segments.remove(payload),
-        errorCode: 'remove_segment_error',
-        successMsg: `Contact removed from segment: ${segmentId}`,
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/segments.ts

@@ -1,39 +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 { renderSegmentsTable } from '../segments/utils';
-import { segmentContactIdentifier } from './utils';
-
-export const listContactSegmentsCommand = new Command('segments')
-  .description('List the segments a contact belongs to')
-  .argument('<id>', 'Contact UUID or email address')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <id> argument accepts either a UUID or an email address.`,
-      output: `  {"object":"list","data":[{"id":"<segment-uuid>","name":"Newsletter Subscribers","created_at":"..."}],"has_more":false}`,
-      errorCodes: ['auth_error', 'list_error'],
-      examples: [
-        'resend contacts segments 479e3145-dd38-4932-8c0c-e58b548c9e76',
-        'resend contacts segments user@example.com',
-        'resend contacts segments 479e3145-dd38-4932-8c0c-e58b548c9e76 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching segments...',
-          success: 'Segments fetched',
-          fail: 'Failed to list segments',
-        },
-        sdkCall: (resend) =>
-          resend.contacts.segments.list(segmentContactIdentifier(id)),
-        onInteractive: (list) => console.log(renderSegmentsTable(list.data)),
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/topics.ts

@@ -1,45 +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 { contactIdentifier, renderContactTopicsTable } from './utils';
-
-export const listContactTopicsCommand = new Command('topics')
-  .description("List a contact's topic subscriptions")
-  .argument('<id>', 'Contact UUID or email address')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <id> argument accepts either a UUID or an email address.
-
-Topics control which broadcast email types a contact receives.
-  subscription values: "opt_in" (receiving) | "opt_out" (not receiving)
-
-Use "resend contacts update-topics <id>" to change subscription statuses.`,
-      output: `  {"object":"list","data":[{"id":"...","name":"Product Updates","description":"...","subscription":"opt_in"}],"has_more":false}`,
-      errorCodes: ['auth_error', 'list_error'],
-      examples: [
-        'resend contacts topics 479e3145-dd38-4932-8c0c-e58b548c9e76',
-        'resend contacts topics user@example.com',
-        'resend contacts topics 479e3145-dd38-4932-8c0c-e58b548c9e76 --json',
-      ],
-    }),
-  )
-  .action(async (id, _opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    // ListContactTopicsBaseOptions uses optional { id?, email? } (not a discriminated
-    // union), so contactIdentifier's result is directly assignable without a cast.
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching topic subscriptions...',
-          success: 'Topic subscriptions fetched',
-          fail: 'Failed to list topic subscriptions',
-        },
-        sdkCall: (resend) => resend.contacts.topics.list(contactIdentifier(id)),
-        onInteractive: (list) =>
-          console.log(renderContactTopicsTable(list.data)),
-      },
-      globalOpts,
-    );
-  });

package/src/commands/contacts/update-topics.ts

@@ -1,90 +0,0 @@
-import * as p from '@clack/prompts';
-import { Command } from '@commander-js/extra-typings';
-import type { GlobalOpts } from '../../lib/client';
-import { requireClient } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { outputError, outputResult } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { withSpinner } from '../../lib/spinner';
-import { isInteractive } from '../../lib/tty';
-import { contactIdentifier, parseTopicsJson } from './utils';
-
-export const updateContactTopicsCommand = new Command('update-topics')
-  .description("Update a contact's topic subscription statuses")
-  .argument('<id>', 'Contact UUID or email address')
-  .option(
-    '--topics <json>',
-    'JSON array of topic subscriptions (required) — e.g. \'[{"id":"topic-uuid","subscription":"opt_in"}]\'',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <id> argument accepts either a UUID or an email address.
-
-Non-interactive: --topics is required.
-
-Topics JSON format:
-  '[{"id":"<topic-uuid>","subscription":"opt_in"}]'
-  subscription values: "opt_in" | "opt_out"
-
-This operation replaces all topic subscriptions for the specified topics.
-Topics not included in the array are left unchanged.`,
-      output: `  {"id":"<contact-id>"}`,
-      errorCodes: [
-        'auth_error',
-        'missing_topics',
-        'invalid_topics',
-        'update_topics_error',
-      ],
-      examples: [
-        `resend contacts update-topics 479e3145-dd38-4932-8c0c-e58b548c9e76 --topics '[{"id":"topic-uuid","subscription":"opt_in"}]'`,
-        `resend contacts update-topics user@example.com --topics '[{"id":"t1","subscription":"opt_out"},{"id":"t2","subscription":"opt_in"}]' --json`,
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    const resend = requireClient(globalOpts);
-
-    let topicsJson = opts.topics;
-
-    if (!topicsJson) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --topics flag.', code: 'missing_topics' },
-          { json: globalOpts.json },
-        );
-      }
-      const result = await p.text({
-        message:
-          'Topics JSON (e.g. \'[{"id":"topic-uuid","subscription":"opt_in"}]\')',
-        placeholder: '[{"id":"topic-uuid","subscription":"opt_in"}]',
-        validate: (v) => (!v ? 'Required' : undefined),
-      });
-      if (p.isCancel(result)) {
-        cancelAndExit('Cancelled.');
-      }
-      topicsJson = result;
-    }
-
-    const topics = parseTopicsJson(topicsJson, globalOpts);
-
-    // contactIdentifier's result is directly assignable: UpdateContactTopicsBaseOptions
-    // uses optional { id?, email? } (not a discriminated union).
-    const data = await withSpinner(
-      {
-        loading: 'Updating topic subscriptions...',
-        success: 'Topic subscriptions updated',
-        fail: 'Failed to update topic subscriptions',
-      },
-      () => resend.contacts.topics.update({ ...contactIdentifier(id), topics }),
-      'update_topics_error',
-      globalOpts,
-    );
-
-    if (!globalOpts.json && isInteractive()) {
-      console.log(`Topic subscriptions updated for contact: ${id}`);
-    } else {
-      outputResult(data, { json: globalOpts.json });
-    }
-  });