resend-cli 1.2.1 → 1.2.2

package/.claude/worktrees/emails-list/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/.claude/worktrees/emails-list/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/.claude/worktrees/emails-list/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 });
-    }
-  });

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

@@ -1,77 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import type { UpdateContactOptions } from 'resend';
-import { runWrite } from '../../lib/actions';
-import type { GlobalOpts } from '../../lib/client';
-import { buildHelpText } from '../../lib/help-text';
-import { contactIdentifier, parsePropertiesJson } from './utils';
-
-export const updateContactCommand = new Command('update')
-  .description("Update a contact's subscription status or custom properties")
-  .argument(
-    '<id>',
-    'Contact UUID or email address — both are accepted by the API',
-  )
-  .option(
-    '--unsubscribed',
-    'Globally unsubscribe the contact from all broadcasts',
-  )
-  .option(
-    '--no-unsubscribed',
-    'Re-subscribe the contact (clears the global unsubscribe flag)',
-  )
-  .option(
-    '--properties <json>',
-    'JSON object of properties to merge (e.g. \'{"company":"Acme"}\'); set a key to null to clear it',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `The <id> argument accepts either a UUID or an email address.
-
-Subscription toggle:
-  --unsubscribed   Sets unsubscribed: true  — contact will not receive any broadcasts.
-  --no-unsubscribed Sets unsubscribed: false — re-enables broadcast delivery.
-  Omitting both flags leaves the subscription status unchanged.
-
-Properties: --properties merges the given JSON object with existing properties.
-  Set a key to null to clear it: '{"company":null}'.`,
-      output: `  {"object":"contact","id":"<id>"}`,
-      errorCodes: ['auth_error', 'invalid_properties', 'update_error'],
-      examples: [
-        'resend contacts update 479e3145-dd38-4932-8c0c-e58b548c9e76 --unsubscribed',
-        'resend contacts update user@example.com --no-unsubscribed',
-        `resend contacts update 479e3145-dd38-4932-8c0c-e58b548c9e76 --properties '{"plan":"pro"}'`,
-        'resend contacts update user@example.com --unsubscribed --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    const properties = parsePropertiesJson(opts.properties, globalOpts);
-
-    // contactIdentifier resolves UUID vs email. The spread of a discriminated
-    // union requires an explicit cast because TypeScript cannot narrow it
-    // through a spread at the call site.
-    const payload = {
-      ...contactIdentifier(id),
-      ...(opts.unsubscribed !== undefined && {
-        unsubscribed: opts.unsubscribed,
-      }),
-      ...(properties && { properties }),
-    } as UpdateContactOptions;
-
-    await runWrite(
-      {
-        spinner: {
-          loading: 'Updating contact...',
-          success: 'Contact updated',
-          fail: 'Failed to update contact',
-        },
-        sdkCall: (resend) => resend.contacts.update(payload),
-        errorCode: 'update_error',
-        successMsg: `Contact updated: ${id}`,
-      },
-      globalOpts,
-    );
-  });

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

@@ -1,119 +0,0 @@
-import type { ContactSegmentsBaseOptions, ContactTopic } from 'resend';
-import type { GlobalOpts } from '../../lib/client';
-import { outputError } from '../../lib/output';
-import { renderTable } from '../../lib/table';
-
-// ─── Table renderers ─────────────────────────────────────────────────────────
-
-export function renderContactsTable(
-  contacts: Array<{
-    id: string;
-    email: string;
-    first_name: string | null;
-    last_name: string | null;
-    unsubscribed: boolean;
-  }>,
-): string {
-  const rows = contacts.map((c) => [
-    c.email,
-    c.first_name ?? '',
-    c.last_name ?? '',
-    c.unsubscribed ? 'yes' : 'no',
-    c.id,
-  ]);
-  return renderTable(
-    ['Email', 'First Name', 'Last Name', 'Unsubscribed', 'ID'],
-    rows,
-    '(no contacts)',
-  );
-}
-
-export function renderContactTopicsTable(topics: ContactTopic[]): string {
-  const rows = topics.map((t) => [
-    t.name,
-    t.subscription,
-    t.id,
-    t.description ?? '',
-  ]);
-  return renderTable(
-    ['Name', 'Subscription', 'ID', 'Description'],
-    rows,
-    '(no topic subscriptions)',
-  );
-}
-
-// ─── Contact identifier helpers ───────────────────────────────────────────────
-//
-// The Resend SDK uses two different discriminated-union shapes depending on
-// the API surface:
-//
-//   • contactIdentifier  — produces { id } | { email } for endpoints that
-//     accept SelectingField (update, get, remove) or { id?, email? }
-//     (topics list/update).
-//
-//   • segmentContactIdentifier — produces { contactId } | { email } for the
-//     contacts.segments.* endpoints, which use ContactSegmentsBaseOptions.
-//
-// Centralising the `str.includes('@')` check here prevents it from drifting
-// across six separate command files.
-
-export function contactIdentifier(
-  id: string,
-): { id: string } | { email: string } {
-  return id.includes('@') ? { email: id } : { id };
-}
-
-export function segmentContactIdentifier(
-  id: string,
-): ContactSegmentsBaseOptions {
-  return id.includes('@') ? { email: id } : { contactId: id };
-}
-
-// ─── JSON flag helpers ────────────────────────────────────────────────────────
-
-export function parseTopicsJson(
-  raw: string,
-  globalOpts: GlobalOpts,
-): Array<{ id: string; subscription: 'opt_in' | 'opt_out' }> {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    outputError(
-      {
-        message:
-          'Invalid --topics JSON. Expected an array of {id, subscription} objects.',
-        code: 'invalid_topics',
-      },
-      { json: globalOpts.json },
-    );
-  }
-  if (!Array.isArray(parsed)) {
-    outputError(
-      {
-        message:
-          'Invalid --topics JSON. Expected an array of {id, subscription} objects.',
-        code: 'invalid_topics',
-      },
-      { json: globalOpts.json },
-    );
-  }
-  return parsed as Array<{ id: string; subscription: 'opt_in' | 'opt_out' }>;
-}
-
-export function parsePropertiesJson(
-  raw: string | undefined,
-  globalOpts: GlobalOpts,
-): Record<string, string | number | null> | undefined {
-  if (!raw) {
-    return undefined;
-  }
-  try {
-    return JSON.parse(raw) as Record<string, string | number | null>;
-  } catch {
-    outputError(
-      { message: 'Invalid --properties JSON.', code: 'invalid_properties' },
-      { json: globalOpts.json },
-    );
-  }
-}

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

@@ -1,298 +0,0 @@
-import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { Command } from '@commander-js/extra-typings';
-import { Resend } from 'resend';
-import type { GlobalOpts } from '../lib/client';
-import { maskKey, resolveApiKey } from '../lib/config';
-import { buildHelpText } from '../lib/help-text';
-import { errorMessage, outputResult } from '../lib/output';
-import { createSpinner } from '../lib/spinner';
-import { isInteractive } from '../lib/tty';
-import { PACKAGE_NAME, VERSION } from '../lib/version';
-
-type CheckStatus = 'pass' | 'warn' | 'fail';
-
-type CheckResult = {
-  name: string;
-  status: CheckStatus;
-  message: string;
-  detail?: string;
-};
-
-const statusIcons: Record<CheckStatus, string> = {
-  pass: '\x1B[32m✔\x1B[0m',
-  warn: '\x1B[33m!\x1B[0m',
-  fail: '\x1B[31m✗\x1B[0m',
-};
-
-async function checkCliVersion(): Promise<CheckResult> {
-  try {
-    const encodedName = encodeURIComponent(PACKAGE_NAME);
-    const res = await fetch(
-      `https://registry.npmjs.org/${encodedName}/latest`,
-      {
-        signal: AbortSignal.timeout(5000),
-      },
-    );
-    if (!res.ok) {
-      return {
-        name: 'CLI Version',
-        status: 'warn',
-        message: `v${VERSION} (could not check for updates)`,
-      };
-    }
-    const data = (await res.json()) as { version?: string };
-    const latest = data.version ?? 'unknown';
-    if (latest === VERSION) {
-      return {
-        name: 'CLI Version',
-        status: 'pass',
-        message: `v${VERSION} (latest)`,
-      };
-    }
-    return {
-      name: 'CLI Version',
-      status: 'warn',
-      message: `v${VERSION} (latest: v${latest})`,
-      detail: 'Update available',
-    };
-  } catch {
-    return {
-      name: 'CLI Version',
-      status: 'warn',
-      message: `v${VERSION} (could not check for updates)`,
-    };
-  }
-}
-
-function checkApiKeyPresence(): CheckResult {
-  const resolved = resolveApiKey();
-  if (!resolved) {
-    return {
-      name: 'API Key',
-      status: 'fail',
-      message: 'No API key found',
-      detail: 'Run: resend login',
-    };
-  }
-  const teamInfo = resolved.team ? `, team: ${resolved.team}` : '';
-  return {
-    name: 'API Key',
-    status: 'pass',
-    message: `${maskKey(resolved.key)} (source: ${resolved.source}${teamInfo})`,
-  };
-}
-
-async function checkApiValidationAndDomains(): Promise<CheckResult> {
-  const resolved = resolveApiKey();
-  if (!resolved) {
-    return {
-      name: 'API Validation',
-      status: 'fail',
-      message: 'Skipped — no API key',
-    };
-  }
-
-  try {
-    const resend = new Resend(resolved.key);
-    const { data, error } = await resend.domains.list();
-
-    if (error) {
-      return {
-        name: 'API Validation',
-        status: 'fail',
-        message: `API key invalid: ${error.message}`,
-      };
-    }
-
-    const domains = data?.data ?? [];
-    const verified = domains.filter((d) => d.status === 'verified');
-    const pending = domains.filter((d) => d.status !== 'verified');
-
-    if (domains.length === 0) {
-      return {
-        name: 'Domains',
-        status: 'warn',
-        message: 'No domains configured',
-        detail: 'Add a domain at https://resend.com/domains',
-      };
-    }
-
-    if (verified.length === 0) {
-      return {
-        name: 'Domains',
-        status: 'warn',
-        message: `${pending.length} domain(s) pending verification`,
-        detail: domains.map((d) => `${d.name} (${d.status})`).join(', '),
-      };
-    }
-
-    return {
-      name: 'Domains',
-      status: 'pass',
-      message: `${verified.length} verified, ${pending.length} pending`,
-      detail: domains.map((d) => `${d.name} (${d.status})`).join(', '),
-    };
-  } catch (err) {
-    return {
-      name: 'API Validation',
-      status: 'fail',
-      message: errorMessage(err, 'Failed to validate API key'),
-    };
-  }
-}
-
-function checkAgentDetection(): CheckResult {
-  const home = homedir();
-  const agents: { name: string; found: boolean }[] = [];
-
-  // OpenClaw
-  agents.push({
-    name: 'OpenClaw',
-    found: existsSync(join(home, 'clawd', 'skills')),
-  });
-
-  // Cursor
-  agents.push({ name: 'Cursor', found: existsSync(join(home, '.cursor')) });
-
-  // Claude Desktop
-  const claudeConfigPaths =
-    process.platform === 'darwin'
-      ? [
-          join(
-            home,
-            'Library',
-            'Application Support',
-            'Claude',
-            'claude_desktop_config.json',
-          ),
-        ]
-      : process.platform === 'win32'
-        ? [
-            join(
-              process.env.APPDATA ?? '',
-              'Claude',
-              'claude_desktop_config.json',
-            ),
-          ]
-        : [join(home, '.config', 'Claude', 'claude_desktop_config.json')];
-  agents.push({
-    name: 'Claude Desktop',
-    found: claudeConfigPaths.some(existsSync),
-  });
-
-  // VS Code MCP
-  agents.push({
-    name: 'VS Code',
-    found: existsSync(join(process.cwd(), '.vscode', 'mcp.json')),
-  });
-
-  const detected = agents.filter((a) => a.found);
-
-  if (detected.length === 0) {
-    return {
-      name: 'AI Agents',
-      status: 'pass',
-      message: 'No AI agents detected',
-    };
-  }
-
-  return {
-    name: 'AI Agents',
-    status: 'pass',
-    message: `Detected: ${detected.map((a) => a.name).join(', ')}`,
-    detail: 'Future: run `resend setup <agent>` to configure integration',
-  };
-}
-
-export const doctorCommand = new Command('doctor')
-  .description(
-    'Check CLI version, API key, domain status, and AI agent detection',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      setup: true,
-      context: `Checks performed:
-  CLI Version    Is the installed version up to date?
-  API Key        Is a key present (--api-key, RESEND_API_KEY, or credentials file)?
-  API Validation Is the key valid and accepted by the Resend API?
-  AI Agents      Detected: Claude Desktop, Cursor, VS Code MCP, OpenClaw`,
-      output: `  {\n    "ok": true,\n    "checks": [\n      {"name":"CLI Version","status":"pass","message":"v0.1.0 (latest)"},\n      {"name":"API Key","status":"pass","message":"re_...abcd (source: env)"},\n      {"name":"Domains","status":"pass","message":"1 verified, 0 pending"},\n      {"name":"AI Agents","status":"pass","message":"Detected: Claude Desktop"}\n    ]\n  }\n  status values: "pass" | "warn" | "fail"\n  Exit code 1 if any check has status "fail"`,
-      examples: ['resend doctor', 'resend doctor --json'],
-    }),
-  )
-  .action(async (_opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    const checks: CheckResult[] = [];
-    const interactive = isInteractive() && !globalOpts.json;
-
-    if (interactive) {
-      console.log('\n  Resend Doctor\n');
-    }
-
-    // Check 1: CLI Version
-    let spinner = interactive
-      ? createSpinner('Checking CLI version...', 'orbit')
-      : null;
-    const versionCheck = await checkCliVersion();
-    checks.push(versionCheck);
-    if (versionCheck.status === 'warn') {
-      spinner?.warn(versionCheck.message);
-    } else {
-      spinner?.stop(versionCheck.message);
-    }
-
-    // Check 2: API Key
-    spinner = interactive ? createSpinner('Checking API key...', 'scan') : null;
-    const keyCheck = checkApiKeyPresence();
-    checks.push(keyCheck);
-    if (keyCheck.status === 'fail') {
-      spinner?.fail(keyCheck.message);
-    } else {
-      spinner?.stop(keyCheck.message);
-    }
-
-    // Check 3: API Validation + Domains
-    spinner = interactive
-      ? createSpinner('Validating API key & domains...', 'scan')
-      : null;
-    const domainCheck = await checkApiValidationAndDomains();
-    checks.push(domainCheck);
-    if (domainCheck.status === 'fail') {
-      spinner?.fail(domainCheck.message);
-    } else if (domainCheck.status === 'warn') {
-      spinner?.warn(domainCheck.message);
-    } else {
-      spinner?.stop(domainCheck.message);
-    }
-
-    // Check 4: Agent Detection
-    spinner = interactive
-      ? createSpinner('Detecting AI agents...', 'scan')
-      : null;
-    const agentCheck = checkAgentDetection();
-    checks.push(agentCheck);
-    spinner?.stop(agentCheck.message);
-
-    const hasFails = checks.some((c) => c.status === 'fail');
-
-    if (!globalOpts.json && isInteractive()) {
-      console.log('');
-      for (const check of checks) {
-        const icon = statusIcons[check.status];
-        console.log(`  ${icon} ${check.name}: ${check.message}`);
-        if (check.detail) {
-          console.log(`    ${check.detail}`);
-        }
-      }
-      console.log('');
-    } else {
-      outputResult({ ok: !hasFails, checks }, { json: globalOpts.json });
-    }
-
-    if (hasFails) {
-      process.exit(1);
-    }
-  });