resend-cli 1.2.2 → 1.3.1

package/src/lib/output.ts

@@ -1,54 +0,0 @@
-export function errorMessage(err: unknown, fallback: string): string {
-  return err instanceof Error ? err.message : fallback;
-}
-
-export interface OutputOptions {
-  json?: boolean;
-  exitCode?: number;
-}
-
-function shouldOutputJson(json?: boolean): boolean {
-  if (json) {
-    return true;
-  }
-  if (!process.stdout.isTTY) {
-    return true;
-  }
-  return false;
-}
-
-export function outputResult(data: unknown, opts: OutputOptions = {}): void {
-  if (shouldOutputJson(opts.json)) {
-    console.log(JSON.stringify(data, null, 2));
-  } else {
-    if (typeof data === 'string') {
-      console.log(data);
-    } else {
-      console.log(JSON.stringify(data, null, 2));
-    }
-  }
-  if (opts.exitCode !== undefined) {
-    process.exit(opts.exitCode);
-  }
-}
-
-export function outputError(
-  error: { message: string; code?: string },
-  opts: OutputOptions = {},
-): never {
-  const exitCode = opts.exitCode ?? 1;
-
-  if (shouldOutputJson(opts.json)) {
-    console.error(
-      JSON.stringify(
-        { error: { message: error.message, code: error.code ?? 'unknown' } },
-        null,
-        2,
-      ),
-    );
-  } else {
-    console.error(`Error: ${error.message}`);
-  }
-
-  process.exit(exitCode);
-}

package/src/lib/pagination.ts

@@ -1,36 +0,0 @@
-import type { GlobalOpts } from './client';
-import { outputError } from './output';
-
-export function parseLimitOpt(raw: string, globalOpts: GlobalOpts): number {
-  const limit = parseInt(raw, 10);
-  if (Number.isNaN(limit) || limit < 1 || limit > 100) {
-    outputError(
-      {
-        message: '--limit must be an integer between 1 and 100',
-        code: 'invalid_limit',
-      },
-      { json: globalOpts.json },
-    );
-  }
-  return limit;
-}
-
-export function buildPaginationOpts(
-  limit: number,
-  after?: string,
-  before?: string,
-) {
-  return after ? { limit, after } : before ? { limit, before } : { limit };
-}
-
-export function printPaginationHint(list: {
-  has_more: boolean;
-  data: Array<{ id: string }>;
-}): void {
-  if (list.has_more && list.data.length > 0) {
-    const last = list.data[list.data.length - 1];
-    console.log(
-      `\nMore results available. Use --after ${last.id} to fetch the next page.`,
-    );
-  }
-}

package/src/lib/prompts.ts

@@ -1,149 +0,0 @@
-import * as p from '@clack/prompts';
-import type { GlobalOpts } from './client';
-import { outputError } from './output';
-import { isInteractive } from './tty';
-
-export interface FieldSpec {
-  flag: string;
-  message: string;
-  placeholder?: string;
-  required?: boolean;
-  validate?: (value: string | undefined) => string | undefined;
-}
-
-export function cancelAndExit(message: string): never {
-  p.cancel(message);
-  process.exit(0);
-}
-
-/**
- * Guard a delete action: error in non-interactive mode (no --yes), or show a
- * confirmation prompt in interactive mode. Exits the process on cancel/rejection.
- */
-export async function confirmDelete(
-  _id: string,
-  confirmMessage: string,
-  globalOpts: GlobalOpts,
-): Promise<void> {
-  if (!isInteractive()) {
-    outputError(
-      {
-        message: 'Use --yes to confirm deletion in non-interactive mode.',
-        code: 'confirmation_required',
-      },
-      { json: globalOpts.json },
-    );
-  }
-
-  const confirmed = await p.confirm({ message: confirmMessage });
-  if (p.isCancel(confirmed) || !confirmed) {
-    cancelAndExit('Deletion cancelled.');
-  }
-}
-
-export async function requireText(
-  value: string | undefined,
-  prompt: {
-    message: string;
-    placeholder?: string;
-    validate?: (value: string | undefined) => string | Error | undefined;
-  },
-  error: { message: string; code: string },
-  globalOpts: GlobalOpts,
-): Promise<string> {
-  if (value) {
-    return value;
-  }
-
-  if (!isInteractive()) {
-    outputError(error, { json: globalOpts.json });
-  }
-
-  const result = await p.text({
-    message: prompt.message,
-    placeholder: prompt.placeholder,
-    validate:
-      prompt.validate ??
-      ((v) =>
-        !v || v.length === 0 ? `${prompt.message} is required` : undefined),
-  });
-  if (p.isCancel(result)) {
-    cancelAndExit('Cancelled.');
-  }
-  return result;
-}
-
-export async function requireSelect<V extends string>(
-  value: V | undefined,
-  prompt: {
-    message: string;
-    options: Parameters<typeof p.select<V>>[0]['options'];
-  },
-  error: { message: string; code: string },
-  globalOpts: GlobalOpts,
-): Promise<V> {
-  if (value) {
-    return value;
-  }
-
-  if (!isInteractive()) {
-    outputError(error, { json: globalOpts.json });
-  }
-
-  const result = await p.select<V>({
-    message: prompt.message,
-    options: prompt.options,
-  });
-  if (p.isCancel(result)) {
-    cancelAndExit('Cancelled.');
-  }
-  return result;
-}
-
-export async function promptForMissing<
-  T extends Record<string, string | undefined>,
->(
-  current: T,
-  fields: FieldSpec[],
-  globalOpts: GlobalOpts,
-): Promise<{ [K in keyof T]: string }> {
-  const missing = fields.filter(
-    (f) => f.required !== false && !current[f.flag],
-  );
-
-  if (missing.length === 0) {
-    return current as { [K in keyof T]: string };
-  }
-
-  if (!isInteractive()) {
-    const flags = missing.map((f) => `--${f.flag}`).join(', ');
-    outputError(
-      { message: `Missing required flags: ${flags}`, code: 'missing_flags' },
-      { json: globalOpts.json },
-    );
-  }
-
-  const result = await p.group(
-    Object.fromEntries(
-      missing.map((field) => [
-        field.flag,
-        () =>
-          p.text({
-            message: field.message,
-            placeholder: field.placeholder,
-            validate:
-              field.validate ??
-              ((v) =>
-                !v || v.length === 0
-                  ? `${field.message} is required`
-                  : undefined),
-          }),
-      ]),
-    ),
-    {
-      onCancel: () => cancelAndExit('Operation cancelled.'),
-    },
-  );
-
-  return { ...current, ...result } as { [K in keyof T]: string };
-}

package/src/lib/spinner.ts

@@ -1,100 +0,0 @@
-import type { GlobalOpts } from './client';
-import { errorMessage, outputError } from './output';
-import { isInteractive, isUnicodeSupported } from './tty';
-
-// Status symbols generated via String.fromCodePoint() — never literal Unicode in
-// source — to prevent UTF-8 → Latin-1 corruption when the npm package is bundled.
-const TICK = isUnicodeSupported ? String.fromCodePoint(0x2714) : 'v'; // ✔
-const WARN = isUnicodeSupported ? String.fromCodePoint(0x26a0) : '!'; // ⚠
-const CROSS = isUnicodeSupported ? String.fromCodePoint(0x2717) : 'x'; // ✗
-
-// Braille spinner: cycle through U+2800-block dot patterns.
-const SPINNER_FRAMES = [
-  '\u2839',
-  '\u2838',
-  '\u2834',
-  '\u2826',
-  '\u2807',
-  '\u280F',
-  '\u2819',
-  '\u2839',
-];
-const SPINNER_INTERVAL = 80;
-
-type SdkResponse<T> = { data: T | null; error: { message: string } | null };
-
-/**
- * Wraps an SDK call with a spinner, unified error handling, and automatic stop/fail.
- * Eliminates the repeated try/catch + spinner boilerplate across all command files.
- */
-export async function withSpinner<T>(
-  messages: { loading: string; success: string; fail: string },
-  call: () => Promise<SdkResponse<T>>,
-  errorCode: string,
-  globalOpts: GlobalOpts,
-): Promise<T> {
-  const spinner = createSpinner(messages.loading, globalOpts.quiet);
-  try {
-    const { data, error } = await call();
-    if (error) {
-      spinner.fail(messages.fail);
-      outputError(
-        { message: error.message, code: errorCode },
-        { json: globalOpts.json },
-      );
-    }
-    if (data === null) {
-      spinner.fail(messages.fail);
-      outputError(
-        { message: 'Unexpected empty response', code: errorCode },
-        { json: globalOpts.json },
-      );
-    }
-    spinner.stop(messages.success);
-    return data;
-  } catch (err) {
-    spinner.fail(messages.fail);
-    return outputError(
-      { message: errorMessage(err, 'Unknown error'), code: errorCode },
-      { json: globalOpts.json },
-    );
-  }
-}
-
-export function createSpinner(message: string, quiet?: boolean) {
-  if (quiet || !isInteractive()) {
-    return {
-      update(_msg: string) {},
-      stop(_msg: string) {},
-      warn(_msg: string) {},
-      fail(_msg: string) {},
-    };
-  }
-
-  const frames = isUnicodeSupported ? SPINNER_FRAMES : ['-', '\\', '|', '/'];
-  const interval = SPINNER_INTERVAL;
-  let i = 0;
-  let text = message;
-
-  const timer = setInterval(() => {
-    process.stderr.write(`\r\x1B[2K  ${frames[i++ % frames.length]} ${text}`);
-  }, interval);
-
-  return {
-    update(msg: string) {
-      text = msg;
-    },
-    stop(msg: string) {
-      clearInterval(timer);
-      process.stderr.write(`\r\x1B[2K  ${TICK} ${msg}\n`);
-    },
-    warn(msg: string) {
-      clearInterval(timer);
-      process.stderr.write(`\r\x1B[2K  ${WARN} ${msg}\n`);
-    },
-    fail(msg: string) {
-      clearInterval(timer);
-      process.stderr.write(`\r\x1B[2K  ${CROSS} ${msg}\n`);
-    },
-  };
-}

package/src/lib/table.ts

@@ -1,57 +0,0 @@
-import { isUnicodeSupported } from './tty';
-
-// All box-drawing characters generated via String.fromCodePoint() — never literal
-// Unicode in source — to prevent UTF-8 → Latin-1 corruption in npm bundles.
-const BOX = isUnicodeSupported
-  ? {
-      h: String.fromCodePoint(0x2500), // ─
-      v: String.fromCodePoint(0x2502), // │
-      tl: String.fromCodePoint(0x250c), // ┌
-      tr: String.fromCodePoint(0x2510), // ┐
-      bl: String.fromCodePoint(0x2514), // └
-      br: String.fromCodePoint(0x2518), // ┘
-      lm: String.fromCodePoint(0x251c), // ├
-      rm: String.fromCodePoint(0x2524), // ┤
-      tm: String.fromCodePoint(0x252c), // ┬
-      bm: String.fromCodePoint(0x2534), // ┴
-      mm: String.fromCodePoint(0x253c), // ┼
-    }
-  : {
-      h: '-',
-      v: '|',
-      tl: '+',
-      tr: '+',
-      bl: '+',
-      br: '+',
-      lm: '+',
-      rm: '+',
-      tm: '+',
-      bm: '+',
-      mm: '+',
-    };
-
-export function renderTable(
-  headers: string[],
-  rows: string[][],
-  emptyMessage = '(no results)',
-): string {
-  if (rows.length === 0) {
-    return emptyMessage;
-  }
-  const widths = headers.map((h, i) =>
-    Math.max(h.length, ...rows.map((r) => r[i].length)),
-  );
-  const top =
-    BOX.tl + widths.map((w) => BOX.h.repeat(w + 2)).join(BOX.tm) + BOX.tr;
-  const mid =
-    BOX.lm + widths.map((w) => BOX.h.repeat(w + 2)).join(BOX.mm) + BOX.rm;
-  const bot =
-    BOX.bl + widths.map((w) => BOX.h.repeat(w + 2)).join(BOX.bm) + BOX.br;
-  const row = (cells: string[]) =>
-    BOX.v +
-    ' ' +
-    cells.map((c, i) => c.padEnd(widths[i])).join(` ${BOX.v} `) +
-    ' ' +
-    BOX.v;
-  return [top, row(headers), mid, ...rows.map(row), bot].join('\n');
-}

package/src/lib/tty.ts

@@ -1,28 +0,0 @@
-export function isInteractive(): boolean {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    return false;
-  }
-  if (process.env.CI === 'true' || process.env.CI === '1') {
-    return false;
-  }
-  if (process.env.GITHUB_ACTIONS) {
-    return false;
-  }
-  if (process.env.TERM === 'dumb') {
-    return false;
-  }
-  return true;
-}
-
-/**
- * True on macOS/Linux and on Windows terminals that support Unicode
- * (Windows Terminal, VS Code integrated terminal).
- * False on legacy Windows cmd.exe — callers should fall back to ASCII symbols.
- *
- * Generated via String.fromCodePoint() (never literal Unicode in source)
- * to prevent UTF-8 → Latin-1 corruption when the npm package is bundled.
- */
-export const isUnicodeSupported: boolean =
-  process.platform !== 'win32' ||
-  Boolean(process.env.WT_SESSION) ||
-  process.env.TERM_PROGRAM === 'vscode';

package/src/lib/update-check.ts

@@ -1,172 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { getConfigDir } from './config';
-import { VERSION } from './version';
-
-const CHECK_INTERVAL_MS = 1 * 60 * 60 * 1000; // 1 hour
-export const GITHUB_RELEASES_URL =
-  'https://api.github.com/repos/resend/resend-cli/releases/latest';
-
-type UpdateState = {
-  lastChecked: number;
-  latestVersion: string;
-};
-
-function getStatePath(): string {
-  return join(getConfigDir(), 'update-state.json');
-}
-
-function readState(): UpdateState | null {
-  try {
-    return JSON.parse(readFileSync(getStatePath(), 'utf-8')) as UpdateState;
-  } catch {
-    return null;
-  }
-}
-
-function writeState(state: UpdateState): void {
-  const dir = getConfigDir();
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true, mode: 0o700 });
-  }
-  writeFileSync(getStatePath(), JSON.stringify(state), { mode: 0o600 });
-}
-
-/**
- * Compare two semver strings. Returns true if remote > local.
- */
-function isNewer(local: string, remote: string): boolean {
-  const parse = (v: string) => v.replace(/^v/, '').split('.').map(Number);
-  const [lMaj, lMin, lPat] = parse(local);
-  const [rMaj, rMin, rPat] = parse(remote);
-  if (rMaj !== lMaj) {
-    return rMaj > lMaj;
-  }
-  if (rMin !== lMin) {
-    return rMin > lMin;
-  }
-  return rPat > lPat;
-}
-
-async function fetchLatestVersion(): Promise<string | null> {
-  try {
-    const res = await fetch(GITHUB_RELEASES_URL, {
-      headers: { Accept: 'application/vnd.github.v3+json' },
-      signal: AbortSignal.timeout(5000),
-    });
-    if (!res.ok) {
-      return null;
-    }
-    const data = (await res.json()) as {
-      tag_name?: string;
-      prerelease?: boolean;
-      draft?: boolean;
-    };
-    // /releases/latest already excludes prereleases, but guard anyway
-    if (data.prerelease || data.draft) {
-      return null;
-    }
-    const version = data.tag_name?.replace(/^v/, '');
-    if (!version || !/^\d+\.\d+\.\d+$/.test(version)) {
-      return null;
-    }
-    return version;
-  } catch {
-    return null;
-  }
-}
-
-function shouldSkipCheck(): boolean {
-  if (process.env.RESEND_NO_UPDATE_NOTIFIER === '1') {
-    return true;
-  }
-  if (process.env.CI === 'true' || process.env.CI === '1') {
-    return true;
-  }
-  if (process.env.GITHUB_ACTIONS) {
-    return true;
-  }
-  if (!process.stdout.isTTY) {
-    return true;
-  }
-  return false;
-}
-
-function detectInstallMethod(): string {
-  const execPath = process.execPath || process.argv[0] || '';
-
-  // Homebrew
-  if (/\/(Cellar|homebrew)\//i.test(execPath)) {
-    return 'brew upgrade resend';
-  }
-
-  // npm / npx global install
-  if (/node_modules/.test(execPath) || process.env.npm_execpath) {
-    return 'npm install -g resend-cli';
-  }
-
-  // Install script (default install location)
-  if (/[/\\]\.resend[/\\]bin[/\\]/.test(execPath)) {
-    if (process.platform === 'win32') {
-      return 'irm https://resend.com/install.ps1 | iex';
-    }
-    return 'curl -fsSL https://resend.com/install.sh | bash';
-  }
-
-  // Default: install script
-  if (process.platform === 'win32') {
-    return 'irm https://resend.com/install.ps1 | iex';
-  }
-  return 'curl -fsSL https://resend.com/install.sh | bash';
-}
-
-function formatNotice(latestVersion: string): string {
-  const upgrade = detectInstallMethod();
-  const isUrl = upgrade.startsWith('http');
-
-  const dim = '\x1B[2m';
-  const yellow = '\x1B[33m';
-  const cyan = '\x1B[36m';
-  const reset = '\x1B[0m';
-
-  return [
-    '',
-    `${dim}Update available: ${yellow}v${VERSION}${reset}${dim} → ${cyan}v${latestVersion}${reset}`,
-    `${dim}${isUrl ? 'Visit' : 'Run'}: ${cyan}${upgrade}${reset}`,
-    '',
-  ].join('\n');
-}
-
-/**
- * Check for updates and print a notice to stderr if one is available.
- * Designed to be called after the main command completes — never blocks
- * or throws.
- */
-export async function checkForUpdates(): Promise<void> {
-  if (shouldSkipCheck()) {
-    return;
-  }
-
-  const state = readState();
-  const now = Date.now();
-
-  // If we have a cached check that's still fresh, just use it
-  if (state && now - state.lastChecked < CHECK_INTERVAL_MS) {
-    if (isNewer(VERSION, state.latestVersion)) {
-      process.stderr.write(formatNotice(state.latestVersion));
-    }
-    return;
-  }
-
-  // Stale or missing — fetch in the background
-  const latest = await fetchLatestVersion();
-  if (!latest) {
-    return;
-  }
-
-  writeState({ lastChecked: now, latestVersion: latest });
-
-  if (isNewer(VERSION, latest)) {
-    process.stderr.write(formatNotice(latest));
-  }
-}

package/src/lib/version.ts

@@ -1,4 +0,0 @@
-import pkg from '../../package.json';
-
-export const VERSION: string = pkg.version;
-export const PACKAGE_NAME: string = pkg.name;