install.sh

#!/bin/sh
# Airwallex CLI installer
#
# Usage:
#   curl -fsSL https://raw.githubusercontent.com/airwallex/airwallex-cli/master/install.sh | sh
#
# Environment variables:
#   AIRWALLEX_VERSION         pin a specific release (default: version bundled in script, e.g. v0.1.0)
#   AIRWALLEX_INSTALL_DIR     install location (default: $HOME/.local/bin)
#   AIRWALLEX_SKIP_CHECKSUM   set to 1 to skip SHA256 verification (local-dev only)
#
# Exit codes:
#   0  success
#   1  generic failure
#   2  unsupported platform
#   3  checksum mismatch
#   4  network failure

set -eu

REPO="airwallex/airwallex-cli"
BIN_NAME="airwallex"
INSTALL_DIR="${AIRWALLEX_INSTALL_DIR:-$HOME/.local/bin}"
STATE_DIR="${HOME}/.local/state/airwallex"
VERSION="${AIRWALLEX_VERSION:-latest}"
SKIP_CHECKSUM="${AIRWALLEX_SKIP_CHECKSUM:-0}"

EXIT_GENERIC=1
EXIT_UNSUPPORTED=2
EXIT_CHECKSUM=3
EXIT_NETWORK=4

# Colors via terminfo so we get real ESC bytes (not literal '\033[…]').
# `tput setaf` is universally available on POSIX systems and respects
# $TERM. Falls back to empty strings when stdout isn't a tty (CI, log
# files) or terminfo doesn't know how to colour the current terminal.
if [ -t 1 ] && command -v tput >/dev/null 2>&1 && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; then
    BOLD=$(tput bold)
    DIM=$(tput dim)
    BLUE=$(tput setaf 4)
    GREEN=$(tput setaf 2)
    YELLOW=$(tput setaf 3)
    RED=$(tput setaf 1)
    RESET=$(tput sgr0)
else
    BOLD=''
    DIM=''
    BLUE=''
    GREEN=''
    YELLOW=''
    RED=''
    RESET=''
fi

# Output helpers. Glyphs are UTF-8; modern macOS / Linux terminals all
# render these correctly. Reserve plain ASCII fallbacks for the rare
# legacy terminal.
_lang="${LANG:-}${LC_ALL:-}"
case "$_lang" in
    *UTF-8*|*utf-8*|*utf8*)
        G_STEP='→' G_OK='✓' G_WARN='!' G_ERR='✗' ;;
    *)
        G_STEP='*' G_OK='+' G_WARN='!' G_ERR='x' ;;
esac

# Output levels:
#   header()  : one-time banner at the top
#   step()    : a unit of progress (blue arrow)
#   ok()      : a success summary line (green check)
#   warn()    : non-fatal warning (yellow bang)
#   err()     : fatal error (red x), exits with the supplied code (default 1)
header() { printf '\n%s%sAirwallex CLI installer%s\n\n' "$BOLD" "$BLUE" "$RESET"; }
step()   { printf '  %s%s%s %s\n' "$BLUE" "$G_STEP" "$RESET" "$*"; }
ok()     { printf '  %s%s%s %s\n' "$GREEN" "$G_OK" "$RESET" "$*"; }
warn()   { printf '  %s%s%s %s\n' "$YELLOW" "$G_WARN" "$RESET" "$*" >&2; }
err() {
    code="${2:-$EXIT_GENERIC}"
    printf '\n  %s%s%s %s\n\n' "$RED" "$G_ERR" "$RESET" "$1" >&2
    exit "$code"
}

# Detect the platform and emit the asset-name fragment used in release
# filenames. macOS builds use `macos` and `x86_64`; Linux builds use
# `linux` and `amd64`.
detect_platform() {
    os=$(uname -s | tr '[:upper:]' '[:lower:]')
    arch=$(uname -m)

    case "$os" in
        darwin) os_label="macos" ;;
        linux)  os_label="linux" ;;
        *) err "Unsupported OS: $os (supported: darwin, linux)" "$EXIT_UNSUPPORTED" ;;
    esac

    case "$arch" in
        x86_64|amd64)
            case "$os_label" in
                macos) arch_label="x86_64" ;;
                *)     arch_label="amd64" ;;
            esac
            ;;
        arm64|aarch64) arch_label="arm64" ;;
        *) err "Unsupported architecture: $arch (supported: x86_64, arm64)" "$EXIT_UNSUPPORTED" ;;
    esac

    echo "${os_label}_${arch_label}"
}

# Return the absolute path to the shell rc file for PATH configuration.
# Falls back to ~/.profile when $SHELL is unset (common in minimal
# containers and piped-from-curl contexts).
resolve_rc_file() {
    case "${SHELL:-}" in
        */zsh)  echo "$HOME/.zshrc" ;;
        */bash) echo "$HOME/.bashrc" ;;
        */fish) echo "$HOME/.config/fish/config.fish" ;;
        *)      echo "$HOME/.profile" ;;
    esac
}

# Append a PATH export to a file unless it already contains INSTALL_DIR.
_patch_rc() {
    _file="$1"
    if [ -f "$_file" ] && grep -qF "$INSTALL_DIR" "$_file" 2>/dev/null; then
        return 0
    fi
    mkdir -p "$(dirname "$_file")"
    case "$_file" in
        */config.fish)
            printf '\nfish_add_path "%s"\n' "$INSTALL_DIR" >> "$_file" ;;
        *)
            # shellcheck disable=SC2016
            # $PATH is intentionally literal — the rc file will expand it at
            # shell-startup time, not at install time.
            printf '\nexport PATH="%s:$PATH"\n' "$INSTALL_DIR" >> "$_file" ;;
    esac
}

# Add INSTALL_DIR to PATH in the user's shell rc file. On Linux also
# patch ~/.profile so login shells (display-manager sessions, SSH, etc.)
# pick up the path without requiring an interactive-shell rc file.
ensure_path() {
    rc_file=$(resolve_rc_file)
    _patch_rc "$rc_file"

    os=$(uname -s | tr '[:upper:]' '[:lower:]')
    if [ "$os" = "linux" ] && [ "$rc_file" != "$HOME/.profile" ]; then
        _patch_rc "$HOME/.profile"
    fi

    return 0
}

# Pre-flight: make sure we can actually write to INSTALL_DIR before downloading
# anything. Walk up the directory tree until we find an existing ancestor,
# since `mkdir -p` will create the intermediate directories.
check_writable() {
    dir="$1"
    target="$dir"
    while [ ! -d "$dir" ]; do
        dir=$(dirname "$dir")
    done
    if [ ! -w "$dir" ]; then
        err "$(printf '%s' "Cannot write to $target ($dir is not writable).
  Re-run with sudo, or pick a writable location:
    AIRWALLEX_INSTALL_DIR=\$HOME/.local/bin curl -fsSL ... | sh")"
    fi
}

# Baked in at release time. Kept in sync with internal/core/version/version.go
# and the README version badge by the CI check-version job.
LATEST_VERSION="v0.3.0"

# Compute the SHA256 of $1 and echo the bare hex digest. Prefers
# `sha256sum` (GNU coreutils, default on Linux); falls back to `shasum
# -a 256` which is the macOS-shipped equivalent.
compute_sha256() {
    _file="$1"
    if command -v sha256sum >/dev/null 2>&1; then
        sha256sum "$_file" | awk '{print $1}'
    elif command -v shasum >/dev/null 2>&1; then
        shasum -a 256 "$_file" | awk '{print $1}'
    else
        err "Neither sha256sum nor shasum is available; cannot verify download integrity"
    fi
}

# Download the per-OS aggregate checksum file from the release and extract
# the expected SHA256 for $asset. The release script publishes one file
# per OS (e.g. airwallex-linux-checksums.txt), each containing lines of
# the form `<sha256>  <filename>` for every architecture of that OS.
fetch_expected_sha256() {
    _os_label="$1"
    _asset="$2"
    _version="$3"
    _tmp="$4"

    _checksum_name="${BIN_NAME}-${_os_label}-checksums.txt"
    _checksum_url="https://github.com/${REPO}/releases/download/${_version}/${_checksum_name}"
    _checksum_path="${_tmp}/${_checksum_name}"

    if ! curl -fsSL -o "$_checksum_path" "$_checksum_url"; then
        err "Failed to download checksum file from $_checksum_url" "$EXIT_NETWORK"
    fi

    # Match the bare asset filename at end-of-line (or followed by whitespace).
    # `sha256sum` emits `<hash>  <name>` (two spaces); BSD `shasum` emits the
    # same format with `-a 256`. The grep is anchored on the asset name to
    # avoid accidental prefix collisions between arches.
    _expected=$(awk -v name="$_asset" '$2 == name { print $1; exit }' "$_checksum_path")
    if [ -z "$_expected" ]; then
        err "Asset $_asset not listed in $_checksum_name"
    fi
    echo "$_expected"
}

# Verify the SHA256 of the downloaded asset against the value published
# in the release's per-OS checksum file. Aborts with exit code 3 on
# mismatch — no extraction is attempted in that case.
verify_checksum() {
    _asset_path="$1"
    _asset_name="$2"
    _os_label="$3"
    _version="$4"
    _tmp="$5"

    step "Verifying SHA256 checksum"

    _expected=$(fetch_expected_sha256 "$_os_label" "$_asset_name" "$_version" "$_tmp")
    _actual=$(compute_sha256 "$_asset_path")

    if [ "$_expected" != "$_actual" ]; then
        printf '\n  %s%s%s SHA256 mismatch for %s\n    expected: %s\n    actual:   %s\n\n' \
            "$RED" "$G_ERR" "$RESET" "$_asset_name" "$_expected" "$_actual" >&2
        err "Refusing to install a tampered or corrupted binary." "$EXIT_CHECKSUM"
    fi

    ok "Checksum OK (${DIM}${_actual}${RESET})"
}

main() {
    command -v curl >/dev/null 2>&1 || err "curl is required but not installed"
    command -v tar  >/dev/null 2>&1 || err "tar is required but not installed"

    header

    if [ "$VERSION" = "latest" ]; then
        VERSION="$LATEST_VERSION"
    fi
    step "Version: ${BOLD}${VERSION}${RESET}"

    # Strip a leading "v" so the asset filename matches the release version
    # string (e.g. v0.1.0 -> 0.1.0).
    version_no_v=${VERSION#v}

    platform=$(detect_platform)
    # platform is "<os>_<arch>"; split into os_label for the per-OS checksum file.
    os_label=$(echo "$platform" | cut -d_ -f1)
    asset="airwallex_${version_no_v}_${platform}.tar.gz"
    url="https://github.com/${REPO}/releases/download/${VERSION}/${asset}"

    check_writable "$INSTALL_DIR"

    step "Downloading ${asset}"

    # Explicit template for portability across BSD/GNU mktemp variants.
    tmp=$(mktemp -d "${TMPDIR:-/tmp}/airwallex-cli.XXXXXX")
    trap 'rm -rf "$tmp"' EXIT

    if ! curl -fsSL -o "${tmp}/${asset}" "$url"; then
        err "Failed to download from $url" "$EXIT_NETWORK"
    fi

    # ------------------------------------------------------------------
    # Integrity check (BEFORE extraction).
    # The on-disk filename equals $asset so the checksum line in the
    # published per-OS checksums file (which references the bare asset
    # name) matches without any rename trickery.
    # ------------------------------------------------------------------
    if [ "$SKIP_CHECKSUM" = "1" ]; then
        warn "WARNING: AIRWALLEX_SKIP_CHECKSUM=1 — skipping SHA256 verification (local-dev only)."
    else
        verify_checksum "${tmp}/${asset}" "$asset" "$os_label" "$VERSION" "$tmp"
    fi

    if ! tar -xzf "${tmp}/${asset}" -C "$tmp"; then
        err "Failed to extract ${asset}"
    fi

    if [ ! -f "${tmp}/${BIN_NAME}" ]; then
        err "Archive did not contain expected '${BIN_NAME}' binary"
    fi

    chmod +x "${tmp}/${BIN_NAME}"

    mkdir -p "$INSTALL_DIR"
    mv "${tmp}/${BIN_NAME}" "${INSTALL_DIR}/${BIN_NAME}"

    mkdir -p "$STATE_DIR"

    installed_version=$("${INSTALL_DIR}/${BIN_NAME}" --no-telemetry --version 2>/dev/null || echo "${version_no_v}")

    ok "Installed ${BOLD}${BIN_NAME} ${installed_version}${RESET} to ${DIM}${INSTALL_DIR}/${BIN_NAME}${RESET}"

    case ":$PATH:" in
        *":${INSTALL_DIR}:"*)
            ;;
        *)
            if ensure_path; then
                rc_file=$(resolve_rc_file)
                ok "Added ${BOLD}${INSTALL_DIR}${RESET} to ${BOLD}${rc_file}${RESET}"
                printf '\n  Restart your shell or run:\n    %ssource %s%s\n' \
                    "$DIM" "$rc_file" "$RESET"
            else
                printf '\n  %s%s%s %s%s%s is not on your PATH.\n' \
                    "$YELLOW" "$G_WARN" "$RESET" "$BOLD" "$INSTALL_DIR" "$RESET"
                # shellcheck disable=SC2016
                # \$PATH is shown to the user as instructional text for them
                # to paste into their rc file; we do not want it expanded here.
                printf '  Add it to your shell startup file:\n    %sexport PATH="%s:\$PATH"%s\n' \
                    "$DIM" "$INSTALL_DIR" "$RESET"
            fi
            ;;
    esac

    printf '\n  Run %s%s --help%s to get started.\n\n' "$BOLD" "$BIN_NAME" "$RESET"
}

main "$@"