resend-cli 1.2.2 → 1.3.0

package/install.sh

@@ -1,301 +0,0 @@
-#!/usr/bin/env bash
-# Resend CLI installer
-#
-# Usage:
-#   curl -fsSL https://resend.com/install.sh | bash
-#   curl -fsSL https://resend.com/install.sh | bash -s v0.1.0
-#
-# Environment variables:
-#   RESEND_INSTALL  - Custom install directory (default: ~/.resend)
-#   GITHUB_BASE     - Custom GitHub base URL (default: https://github.com)
-
-# Wrap everything in a function to protect against partial download.
-# If the connection drops mid-transfer, bash won't execute a truncated script.
-main() {
-
-set -euo pipefail
-
-# ─── Colors (only when outputting to a terminal) ─────────────────────────────
-
-Color_Off='' Red='' Green='' Dim='' Bold='' Blue='' Yellow=''
-
-if [[ -t 1 ]]; then
-  Color_Off='\033[0m'
-  Red='\033[0;31m'
-  Green='\033[0;32m'
-  Yellow='\033[0;33m'
-  Dim='\033[0;2m'
-  Bold='\033[1m'
-  Blue='\033[0;34m'
-fi
-
-# ─── Helpers ─────────────────────────────────────────────────────────────────
-
-error() {
-  printf "%b\n" "${Red}error${Color_Off}: $*" >&2
-  exit 1
-}
-
-warn() {
-  printf "%b\n" "${Yellow}warn${Color_Off}: $*" >&2
-}
-
-info() {
-  printf "%b\n" "${Dim}$*${Color_Off}"
-}
-
-success() {
-  printf "%b\n" "${Green}$*${Color_Off}"
-}
-
-bold() {
-  printf "%b\n" "${Bold}$*${Color_Off}"
-}
-
-tildify() {
-  if [[ $1 == "$HOME"/* ]]; then
-    echo "~${1#"$HOME"}"
-  else
-    echo "$1"
-  fi
-}
-
-# ─── Dependency checks ──────────────────────────────────────────────────────
-
-command -v curl >/dev/null 2>&1 || error "curl is required but not found. Install it and try again."
-command -v tar  >/dev/null 2>&1 || error "tar is required but not found. Install it and try again."
-
-# ─── OS / Architecture detection ────────────────────────────────────────────
-
-platform=$(uname -ms)
-
-case $platform in
-  'Darwin x86_64')   target=darwin-x64 ;;
-  'Darwin arm64')    target=darwin-arm64 ;;
-  'Linux aarch64')   target=linux-arm64 ;;
-  'Linux arm64')     target=linux-arm64 ;;
-  'Linux x86_64')    target=linux-x64 ;;
-  *)
-    error "Unsupported platform: ${platform}.
-
-  Resend CLI supports:
-    - macOS (Apple Silicon / Intel)
-    - Linux (x64 / arm64)
-
-  For Windows, run this in PowerShell:
-    irm https://resend.com/install.ps1 | iex"
-    ;;
-esac
-
-# Detect Rosetta 2 on macOS — prefer native arm64 binary
-if [[ $target == "darwin-x64" ]]; then
-  if [[ $(sysctl -n sysctl.proc_translated 2>/dev/null || echo 0) == "1" ]]; then
-    target=darwin-arm64
-    info "  Rosetta 2 detected — installing native arm64 binary"
-  fi
-fi
-
-# Detect musl (Alpine Linux) — glibc binaries won't work
-if [[ $target == linux-* ]]; then
-  if ldd --version 2>&1 | grep -qi musl 2>/dev/null; then
-    error "Alpine Linux (musl) is not currently supported.
-
-  The compiled binary requires glibc. Use one of these alternatives:
-    - npm install -g resend-cli
-    - Run in a glibc-based container (e.g., ubuntu, debian)"
-  fi
-fi
-
-# ─── Version + Download URL ─────────────────────────────────────────────────
-
-GITHUB_BASE=${GITHUB_BASE:-"https://github.com"}
-
-# Validate GITHUB_BASE is HTTPS to prevent download from arbitrary sources
-case "$GITHUB_BASE" in
-  https://*) ;;
-  *) error "GITHUB_BASE must start with https:// (got: ${GITHUB_BASE})" ;;
-esac
-
-REPO="${GITHUB_BASE}/resend/resend-cli"
-
-VERSION=${1:-}
-
-# Validate version format if provided
-if [[ -n $VERSION ]]; then
-  # Strip leading 'v' if present, then re-add for the tag
-  VERSION="${VERSION#v}"
-  if ! [[ $VERSION =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
-    error "Invalid version format: ${VERSION}
-
-  Expected: semantic version like 0.1.0 or 1.2.3-beta.1
-  Usage:    curl -fsSL https://resend.com/install.sh | bash -s v0.1.0"
-  fi
-  url="${REPO}/releases/download/v${VERSION}/resend-${target}.tar.gz"
-else
-  url="${REPO}/releases/latest/download/resend-${target}.tar.gz"
-fi
-
-# ─── Install directory ──────────────────────────────────────────────────────
-
-install_dir="${RESEND_INSTALL:-$HOME/.resend}"
-bin_dir="${install_dir}/bin"
-exe="${bin_dir}/resend"
-
-mkdir -p "$bin_dir" || error "Failed to create install directory: ${bin_dir}"
-
-# ─── Download + Extract ─────────────────────────────────────────────────────
-
-echo ""
-bold "  Installing Resend CLI..."
-echo ""
-
-tmpdir=$(mktemp -d) || error "Failed to create temporary directory"
-trap 'rm -rf "$tmpdir"' EXIT INT TERM
-
-tmpfile="${tmpdir}/resend.tar.gz"
-
-info "  Downloading from ${url}"
-echo ""
-
-curl --fail --location --progress-bar --output "$tmpfile" "$url" ||
-  error "Download failed.
-
-  Possible causes:
-    - No internet connection
-    - The version does not exist: ${VERSION:-latest}
-    - GitHub is unreachable
-
-  URL: ${url}"
-
-tar -xzf "$tmpfile" -C "$bin_dir" ||
-  error "Failed to extract archive. The download may be corrupted — try again."
-
-chmod +x "$exe" || error "Failed to make binary executable"
-
-# Strip macOS Gatekeeper quarantine flag (set automatically on curl downloads)
-# Without this, macOS will block the binary: "cannot be opened because Apple
-# cannot check it for malicious software"
-if [[ $(uname -s) == "Darwin" ]]; then
-  xattr -d com.apple.quarantine "$exe" 2>/dev/null || true
-fi
-
-# ─── Verify installation ────────────────────────────────────────────────────
-
-installed_version=$("$exe" --version 2>/dev/null || echo "unknown")
-
-echo ""
-success "  Resend CLI ${installed_version} installed successfully!"
-echo ""
-info "  Binary:  $(tildify "$exe")"
-
-# ─── PATH setup ─────────────────────────────────────────────────────────────
-
-# Check if already on PATH
-if command -v resend >/dev/null 2>&1; then
-  existing=$(command -v resend)
-  if [[ "$existing" == "$exe" ]]; then
-    echo ""
-    bold "  Run ${Blue}resend --help${Color_Off}${Bold} to get started${Color_Off}"
-    echo ""
-    exit 0
-  else
-    warn "another 'resend' was found at ${existing}"
-    info "  The new installation at $(tildify "$exe") may be shadowed."
-  fi
-fi
-
-# Check if bin_dir is already in PATH
-if echo "$PATH" | tr ':' '\n' | grep -qxF "${bin_dir}" 2>/dev/null; then
-  echo ""
-  bold "  Run ${Blue}resend --help${Color_Off}${Bold} to get started${Color_Off}"
-  echo ""
-  exit 0
-fi
-
-# Determine shell config file
-shell_name=$(basename "${SHELL:-}")
-config=""
-shell_line=""
-
-# Build a $HOME-relative path for shell config (~ doesn't expand inside quotes)
-if [[ $bin_dir == "$HOME"/* ]]; then
-  shell_bin_dir="\$HOME${bin_dir#"$HOME"}"
-else
-  shell_bin_dir="$bin_dir"
-fi
-
-case $shell_name in
-  zsh)
-    config="${ZDOTDIR:-$HOME}/.zshrc"
-    shell_line="export PATH=\"${shell_bin_dir}:\$PATH\""
-    ;;
-  bash)
-    # macOS bash opens login shells — .bash_profile is loaded, not .bashrc.
-    # Linux bash opens non-login interactive shells — .bashrc is preferred.
-    if [[ $(uname -s) == "Darwin" ]]; then
-      if [[ -f "$HOME/.bash_profile" ]]; then
-        config="$HOME/.bash_profile"
-      elif [[ -f "$HOME/.bashrc" ]]; then
-        config="$HOME/.bashrc"
-      else
-        config="$HOME/.bash_profile"
-      fi
-    else
-      if [[ -f "$HOME/.bashrc" ]]; then
-        config="$HOME/.bashrc"
-      elif [[ -f "$HOME/.bash_profile" ]]; then
-        config="$HOME/.bash_profile"
-      else
-        config="$HOME/.bashrc"
-      fi
-    fi
-    shell_line="export PATH=\"${shell_bin_dir}:\$PATH\""
-    ;;
-  fish)
-    config="${XDG_CONFIG_HOME:-$HOME/.config}/fish/conf.d/resend.fish"
-    mkdir -p "$(dirname "$config")"
-    shell_line="fish_add_path ${shell_bin_dir}"
-    ;;
-esac
-
-if [[ -n $config ]]; then
-  # Check if PATH entry already exists (check both tildified and absolute)
-  if [[ -f "$config" ]] && (grep -qF "$(tildify "$bin_dir")" "$config" 2>/dev/null || grep -qF "$bin_dir" "$config" 2>/dev/null); then
-    info "  PATH already configured in $(tildify "$config")"
-  elif [[ -w "${config%/*}" ]] || [[ -w "$config" ]]; then
-    {
-      echo ""
-      echo "# Resend CLI"
-      echo "$shell_line"
-    } >> "$config"
-    info "  Added $(tildify "$bin_dir") to \$PATH in $(tildify "$config")"
-    echo ""
-    info "  To start using Resend CLI, run:"
-    echo ""
-    bold "    source $(tildify "$config")"
-    bold "    resend --help"
-  else
-    echo ""
-    info "  Manually add to your shell config:"
-    echo ""
-    bold "    ${shell_line}"
-  fi
-else
-  echo ""
-  info "  Add to your shell config:"
-  echo ""
-  bold "    export PATH=\"${shell_bin_dir}:\$PATH\""
-fi
-
-echo ""
-info "  Next steps:"
-echo ""
-bold "    export RESEND_API_KEY=re_..."
-bold "    resend --help"
-echo ""
-
-}
-
-# Run the installer — this line MUST be the last line in the file.
-# If the download is interrupted, bash will not execute an incomplete function.
-main "$@"

package/renovate.json

@@ -1,4 +0,0 @@
-{
-  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": ["config:recommended"]
-}

package/src/cli.ts

@@ -1,92 +0,0 @@
-#!/usr/bin/env bun
-import { Command } from '@commander-js/extra-typings';
-import { apiKeysCommand } from './commands/api-keys/index';
-import { loginCommand } from './commands/auth/login';
-import { logoutCommand } from './commands/auth/logout';
-import { broadcastsCommand } from './commands/broadcasts/index';
-import { contactPropertiesCommand } from './commands/contact-properties/index';
-import { contactsCommand } from './commands/contacts/index';
-import { doctorCommand } from './commands/doctor';
-import { domainsCommand } from './commands/domains/index';
-import { emailsCommand } from './commands/emails/index';
-import { openCommand } from './commands/open';
-import { segmentsCommand } from './commands/segments/index';
-import { teamsCommand } from './commands/teams/index';
-import { topicsCommand } from './commands/topics/index';
-import { webhooksCommand } from './commands/webhooks/index';
-import { whoamiCommand } from './commands/whoami';
-import { errorMessage, outputError } from './lib/output';
-import { checkForUpdates } from './lib/update-check';
-import { PACKAGE_NAME, VERSION } from './lib/version';
-
-const BANNER = `
-██████╗ ███████╗███████╗███████╗███╗   ██╗██████╗
-██╔══██╗██╔════╝██╔════╝██╔════╝████╗  ██║██╔══██╗
-██████╔╝█████╗  ███████╗█████╗  ██╔██╗ ██║██║  ██║
-██╔══██╗██╔══╝  ╚════██║██╔══╝  ██║╚██╗██║██║  ██║
-██║  ██║███████╗███████║███████╗██║ ╚████║██████╔╝
-╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═══╝╚═════╝
-`;
-
-const program = new Command()
-  .name('resend')
-  .description('Resend CLI — email for developers')
-  .addHelpText('beforeAll', BANNER)
-  .version(
-    `${PACKAGE_NAME} v${VERSION}`,
-    '-v, --version',
-    'Output the current version',
-  )
-  .option('--api-key <key>', 'Resend API key (overrides env/config)')
-  .option('--team <name>', 'Team profile to use (overrides RESEND_TEAM)')
-  .option('--json', 'Force JSON output')
-  .option('-q, --quiet', 'Suppress spinners and status output (implies --json)')
-  .configureHelp({ showGlobalOptions: true })
-  .hook('preAction', (thisCommand, actionCommand) => {
-    if (actionCommand.optsWithGlobals().quiet) {
-      thisCommand.setOptionValue('json', true);
-    }
-  })
-  .addHelpText(
-    'after',
-    `
-Environment:
-  RESEND_API_KEY    API key — checked after --api-key, before stored credentials
-                    Priority: --api-key flag > RESEND_API_KEY > ~/.config/resend/credentials.json
-  RESEND_TEAM       Team profile — checked after --team flag, before active_team in config
-                    Priority: --team flag > RESEND_TEAM > active_team in config > "default"
-
-Output:
-  Human-readable by default. Pass --json or pipe stdout for machine-readable JSON.
-  Use --quiet (-q) in CI to suppress spinners and status messages (implies --json).
-  Errors always exit with code 1: {"error":{"message":"...","code":"..."}}
-
-Examples:
-  $ resend login
-  $ resend emails send`,
-  )
-  .addCommand(loginCommand)
-  .addCommand(logoutCommand)
-  .addCommand(emailsCommand)
-  .addCommand(domainsCommand)
-  .addCommand(apiKeysCommand)
-  .addCommand(broadcastsCommand)
-  .addCommand(contactsCommand)
-  .addCommand(contactPropertiesCommand)
-  .addCommand(segmentsCommand)
-  .addCommand(topicsCommand)
-  .addCommand(webhooksCommand)
-  .addCommand(doctorCommand)
-  .addCommand(teamsCommand)
-  .addCommand(openCommand)
-  .addCommand(whoamiCommand);
-
-program
-  .parseAsync()
-  .then(() => checkForUpdates().catch(() => {}))
-  .catch((err) => {
-    outputError({
-      message: errorMessage(err, 'An unexpected error occurred'),
-      code: 'unexpected_error',
-    });
-  });

package/src/commands/api-keys/create.ts

@@ -1,114 +0,0 @@
-import * as p from '@clack/prompts';
-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 { outputError } from '../../lib/output';
-import { cancelAndExit } from '../../lib/prompts';
-import { isInteractive } from '../../lib/tty';
-
-export const createApiKeyCommand = new Command('create')
-  .description(
-    'Create a new API key and display the token (shown once — store it immediately)',
-  )
-  .option('--name <name>', 'API key name (max 50 characters)')
-  .addOption(
-    new Option('--permission <permission>', 'Permission level').choices([
-      'full_access',
-      'sending_access',
-    ] as const),
-  )
-  .option(
-    '--domain-id <id>',
-    'Restrict a sending_access key to a single domain ID',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Non-interactive: --name is required (no prompts when stdin/stdout is not a TTY).
-
-Permissions:
-  full_access     Full API access (default)
-  sending_access  Send-only access; optionally scope to a domain with --domain-id`,
-      output: `  {"id":"<id>","token":"<token>"}
-  The token is only returned at creation time and cannot be retrieved again.`,
-      errorCodes: ['auth_error', 'missing_name', 'create_error'],
-      examples: [
-        'resend api-keys create --name "Production"',
-        'resend api-keys create --name "CI Token" --permission sending_access',
-        'resend api-keys create --name "Domain Token" --permission sending_access --domain-id <domain-id>',
-        'resend api-keys create --name "Production" --json',
-      ],
-    }),
-  )
-  .action(async (opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-
-    let name = opts.name;
-    let permission = opts.permission;
-
-    if (!name) {
-      if (!isInteractive()) {
-        outputError(
-          { message: 'Missing --name flag.', code: 'missing_name' },
-          { json: globalOpts.json },
-        );
-      }
-
-      const nameResult = await p.text({
-        message: 'Key name',
-        placeholder: 'My API Key',
-        validate: (v) => {
-          if (!v) {
-            return 'Name is required';
-          }
-          if (v.length > 50) {
-            return 'Name must be 50 characters or less';
-          }
-          return undefined;
-        },
-      });
-      if (p.isCancel(nameResult)) {
-        cancelAndExit('Cancelled.');
-      }
-      name = nameResult;
-
-      const permissionResult = await p.select({
-        message: 'Permission level',
-        options: [
-          { value: 'full_access' as const, label: 'Full access' },
-          { value: 'sending_access' as const, label: 'Sending access only' },
-        ],
-      });
-      if (p.isCancel(permissionResult)) {
-        cancelAndExit('Cancelled.');
-      }
-      permission = permissionResult;
-    }
-
-    await runCreate(
-      {
-        spinner: {
-          loading: 'Creating API key...',
-          success: 'API key created',
-          fail: 'Failed to create API key',
-        },
-        sdkCall: (resend) =>
-          resend.apiKeys.create({
-            name,
-            ...(permission && { permission }),
-            ...(opts.domainId && { domain_id: opts.domainId }),
-          }),
-        onInteractive: (d) => {
-          console.log('\nAPI key created!\n');
-          console.log(`  Name:    ${name}`);
-          console.log(`  ID:      ${d.id}`);
-          console.log(`  Token:   ${d.token}`);
-          console.log(
-            '\n⚠  Store this token now — it cannot be retrieved again.',
-          );
-        },
-      },
-      globalOpts,
-    );
-  });

package/src/commands/api-keys/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 deleteApiKeyCommand = new Command('delete')
-  .alias('rm')
-  .description(
-    'Delete an API key — any services using it will immediately lose access',
-  )
-  .argument('<id>', 'API key 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.
-
-Warning: Deleting a key is immediate and irreversible. Any service using this key
-will stop authenticating instantly. The current key (used to call this command)
-can delete itself — the API does not prevent self-deletion.`,
-      output: `  {"object":"api-key","id":"<id>","deleted":true}`,
-      errorCodes: ['auth_error', 'confirmation_required', 'delete_error'],
-      examples: [
-        'resend api-keys delete dacf4072-aa82-4ff3-97de-514ae3000ee0 --yes',
-        'resend api-keys delete dacf4072-aa82-4ff3-97de-514ae3000ee0 --yes --json',
-      ],
-    }),
-  )
-  .action(async (id, opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runDelete(
-      id,
-      !!opts.yes,
-      {
-        confirmMessage: `Delete API key ${id}?\nAny services using this key will stop working.`,
-        spinner: {
-          loading: 'Deleting API key...',
-          success: 'API key deleted',
-          fail: 'Failed to delete API key',
-        },
-        object: 'api-key',
-        successMsg: 'API key deleted.',
-        sdkCall: (resend) => resend.apiKeys.remove(id),
-      },
-      globalOpts,
-    );
-  });

package/src/commands/api-keys/index.ts

@@ -1,26 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { createApiKeyCommand } from './create';
-import { deleteApiKeyCommand } from './delete';
-import { listApiKeysCommand } from './list';
-
-export const apiKeysCommand = new Command('api-keys')
-  .description('Manage API keys for authentication')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      context: `Security notes:
-  - Tokens are only shown at creation time and cannot be retrieved again.
-  - Use sending_access keys with --domain-id for per-domain CI tokens.
-  - Deleting a key is immediate — any service using it loses access instantly.`,
-      examples: [
-        'resend api-keys list',
-        'resend api-keys create --name "Production"',
-        'resend api-keys create --name "CI Token" --permission sending_access --domain-id <domain-id>',
-        'resend api-keys delete <id> --yes',
-      ],
-    }),
-  )
-  .addCommand(createApiKeyCommand)
-  .addCommand(listApiKeysCommand, { isDefault: true })
-  .addCommand(deleteApiKeyCommand);

package/src/commands/api-keys/list.ts

@@ -1,35 +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 { renderApiKeysTable } from './utils';
-
-export const listApiKeysCommand = new Command('list')
-  .alias('ls')
-  .description(
-    'List all API keys (IDs and names — tokens are never returned by this endpoint)',
-  )
-  .addHelpText(
-    'after',
-    buildHelpText({
-      output: `  {"object":"list","data":[{"id":"<id>","name":"<name>","created_at":"<date>"}]}
-  Tokens are never included in list responses.`,
-      errorCodes: ['auth_error', 'list_error'],
-      examples: ['resend api-keys list', 'resend api-keys list --json'],
-    }),
-  )
-  .action(async (_opts, cmd) => {
-    const globalOpts = cmd.optsWithGlobals() as GlobalOpts;
-    await runList(
-      {
-        spinner: {
-          loading: 'Fetching API keys...',
-          success: 'API keys fetched',
-          fail: 'Failed to list API keys',
-        },
-        sdkCall: (resend) => resend.apiKeys.list(),
-        onInteractive: (list) => console.log(renderApiKeysTable(list.data)),
-      },
-      globalOpts,
-    );
-  });

package/src/commands/api-keys/utils.ts

@@ -1,8 +0,0 @@
-import { renderTable } from '../../lib/table';
-
-export function renderApiKeysTable(
-  keys: Array<{ id: string; name: string; created_at: string }>,
-): string {
-  const rows = keys.map((k) => [k.name, k.id, k.created_at]);
-  return renderTable(['Name', 'ID', 'Created'], rows, '(no API keys)');
-}

package/src/commands/auth/index.ts

@@ -1,20 +0,0 @@
-import { Command } from '@commander-js/extra-typings';
-import { buildHelpText } from '../../lib/help-text';
-import { loginCommand } from './login';
-import { logoutCommand } from './logout';
-
-export const authCommand = new Command('auth')
-  .description('Manage authentication')
-  .addHelpText(
-    'after',
-    buildHelpText({
-      setup: true,
-      examples: [
-        'resend login',
-        'resend login --key re_123456789',
-        'resend logout',
-      ],
-    }),
-  )
-  .addCommand(loginCommand)
-  .addCommand(logoutCommand);