TOR.WATCH API v2 Documentation

#!/bin/bash
# ===============================================================
#  TOR.WATCH API v2.2 Terminal Client
# ===============================================================
# Usage examples:
#   ./tdw_api.sh list
#   ./tdw_api.sh list full
#   ./tdw_api.sh list csv
#   ./tdw_api.sh show 95
#   ./tdw_api.sh create "http://mirror.onion.tor.my" "signature" true false
#   ./tdw_api.sh update 88 "http://mirror11.com" "-" true false
#   ./tdw_api.sh delete 95
#   ./tdw_api.sh delete-multiple 1,2,3
#   ./tdw_api.sh delete-all
#   ./tdw_api.sh create-multiple mirrors.csv
#   ./tdw_api.sh update-multiple mirrors-update.csv
#   ./tdw_api.sh batch-sync mirrors.csv
# ===============================================================

# --- CONFIGURATION ---
BASE_URL="your_base_url"
API_KEY="your_api_key_here"

# --- COLORS & ICONS ---
GREEN='\033[0;32m'
CYAN='\033[0;36m'
RED='\033[0;31m'
GRAY='\033[0;90m'
YELLOW='\033[1;33m'
NC='\033[0m'
OK_ICON="✅"
FAIL_ICON="❌"

# --- DEPENDENCY CHECKS ---
check_dependencies() {
  missing=0

  if ! command -v curl &> /dev/null; then
    echo -e "${RED}Error:${NC} curl is required but not installed."
    echo -e "${YELLOW}Install curl with one of the following:${NC}"
    echo "  Ubuntu/Debian:    sudo apt install curl"
    echo "  Fedora:           sudo dnf install curl"
    echo "  Arch Linux:       sudo pacman -S curl"
    echo "  macOS (Homebrew): brew install curl"
    missing=1
  fi

  if command -v jq &> /dev/null; then
    PARSER="jq"
  else
    PARSER="cat"
    echo -e "${YELLOW}Note:${NC} jq not found. Pretty-printing disabled for single requests."
    echo -e "${GRAY}Bulk operations (create-multiple, update-multiple, delete-all) require jq. Install jq to use them.${NC}"
  fi

  if [ $missing -eq 1 ]; then
    exit 1
  fi
}

ensure_jq_for_bulk() {
  if [ "$PARSER" != "jq" ]; then
    echo -e "${RED}Error:${NC} This operation requires 'jq'."
    echo "Install jq and re-run. Example:"
    echo "  Ubuntu/Debian: sudo apt install jq"
    echo "  macOS (Homebrew): brew install jq"
    exit 1
  fi
}

# --- HEADER ---
print_header() {
  echo -e "${CYAN}───────────────────────────────────────────${NC}"
  echo -e "${GREEN} TOR.WATCH API v2.2 Terminal Client${NC}"
  echo -e "${CYAN}───────────────────────────────────────────${NC}"
}

# --- HTTP helper ---
# Usage: http_call METHOD URL [DATA_JSON]
# Sets global LAST_HTTP_CODE and prints body (pretty if jq available)
http_call() {
  local method=$1 url=$2 data="$3"
  local resp http_code body

  if [ -n "$data" ]; then
    resp=$(curl -sS -w "\n%{http_code}" -X "$method" "$url" \
      -H "Authorization: ${API_KEY}" \
      -H "Content-Type: application/json" \
      -d "$data")
  else
    resp=$(curl -sS -w "\n%{http_code}" -X "$method" "$url" \
      -H "Authorization: ${API_KEY}")
  fi

  http_code=$(echo "$resp" | tail -n1)
  body=$(echo "$resp" | sed '$d')

  LAST_HTTP_CODE=$http_code

  if [ -n "$body" ]; then
    if [ "$PARSER" = "jq" ]; then
      echo "$body" | jq .
    else
      echo "$body"
    fi
  fi

  return 0
}

# --- UTIL ---
trim() { printf '%s' "$1" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//'; }

# --- COMMANDS ---

# list: summary or full
# list: summary or full
list_mirrors() {
  # fetch
  resp=$(curl -sS -H "Authorization: ${API_KEY}" "${BASE_URL}/api/v2/mirrors")
  if [ -z "$resp" ]; then
    echo -e "${RED}Error:${NC} Failed to fetch mirrors."
    return 1
  fi

  if [ "$PARSER" = "jq" ]; then
    arr_json=$(echo "$resp" | jq -c 'if type=="object" and has("mirrors") then .mirrors elif type=="array" then . else [] end')

    if [ "$1" = "full" ]; then
      # Output full JSON
      echo "$arr_json" | jq .
      return 0
    elif [ "$1" = "csv" ]; then
      # Output CSV format for easy export
      echo "id,url,signature,captcha,credit,vip"
      echo "$arr_json" | jq -r '.[] | "\(.ID // .id),\(.url // .URL),\(.signature // ""),\(.captcha // false),\(.credit // false),\(.vip // false)"'
      return 0
    fi

    # print summary table
    printf "%-8s  %-48s  %-20s  %-6s  %-6s  %-6s\n" "ID" "URL" "SIGNATURE" "CAP" "CREDIT" "VIP"
    printf "%-8s  %-48s  %-20s  %-6s  %-6s  %-6s\n" "--------" "------------------------------------------------" "--------------------" "------" "------" "------"

    echo "$arr_json" | jq -r '.[] | [(.ID // .id // "null"), (.url // .URL // ""), (.signature // ""), (.captcha // false), (.credit // false), (.vip // false)] | @tsv' |
      while IFS=$'\t' read -r id url signature captcha credit vip; do
        id=$(trim "$id")
        url=$(trim "$url")
        signature=$(trim "$signature")
        captcha=$(trim "$captcha")
        credit=$(trim "$credit")
        vip=$(trim "$vip")
        printf "%-8s  %-48s  %-20s  %-6s  %-6s  %-6s\n" "$id" "$url" "$signature" "$captcha" "$credit" "$vip"
      done
  else
    # no jq: print raw
    echo "$resp"
  fi
}

show_mirror() {
  id=$1
  [ -z "$id" ] && { echo -e "${RED}Error:${NC} Missing mirror ID"; exit 1; }
  http_call GET "${BASE_URL}/api/v2/mirrors/${id}"
  code=$LAST_HTTP_CODE
  if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
    echo -e "${GREEN}${OK_ICON} OK (${code})${NC}"
  else
    echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
  fi
}

create_mirror() {
  url=$1
  signature=$2
  captcha=$3
  credit=$4
  vip=$5

  if [ -z "$url" ]; then
    echo -e "${RED}Error:${NC} create requires url and captcha."
    echo "Usage: ./tdw_api.sh create \"url\" \"signature\" true false [vip]"
    exit 1
  fi
  if [ -z "$captcha" ]; then
    echo -e "${RED}Error:${NC} captcha is required (true|false)."
    exit 1
  fi
  if [ "$captcha" != "true" ] && [ "$captcha" != "false" ]; then
    echo -e "${RED}Error:${NC} captcha must be 'true' or 'false'."
    exit 1
  fi

  # ✅ Default signature if empty
  if [ -z "$signature" ]; then
    signature="-"
  fi

  # Default credit to false if not provided
  if [ -z "$credit" ]; then
    credit="false"
  fi
  if [ "$credit" != "true" ] && [ "$credit" != "false" ]; then
    echo -e "${RED}Error:${NC} credit must be 'true' or 'false'."
    exit 1
  fi

  # Default vip to false if not provided
  if [ -z "$vip" ]; then
    vip="false"
  fi
  if [ "$vip" != "true" ] && [ "$vip" != "false" ]; then
    echo -e "${RED}Error:${NC} vip must be 'true' or 'false'."
    exit 1
  fi

  # Build JSON payload cleanly
  data=$(jq -n --arg url "$url" --arg sig "$signature" --argjson cap $captcha --argjson cred $credit --argjson v $vip \
    '{url:$url, signature:$sig, captcha:$cap, credit:$cred, vip:$v}')

  echo -e "${GRAY}→ Payload:${NC} $data"
  http_call POST "${BASE_URL}/api/v2/mirrors" "$data"

  code=$LAST_HTTP_CODE
  if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
    echo -e "${GREEN}${OK_ICON} Created (${code})${NC}"
  else
    echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
  fi
}

update_mirror() {
  id=$1
  url=$2
  signature=$3
  captcha=$4
  credit=$5
  vip=$6

  if [ -z "$id" ] || [ -z "$url" ]; then
    echo -e "${RED}Error:${NC} update requires id, url, and captcha (signature, credit, vip optional)."
    echo "Usage: ./tdw_api.sh update   [signature]  [credit] [vip]"
    exit 1
  fi
  if [ -z "$captcha" ]; then
    echo -e "${RED}Error:${NC} captcha is required (true|false)."
    exit 1
  fi
  if [ "$captcha" != "true" ] && [ "$captcha" != "false" ]; then
    echo -e "${RED}Error:${NC} captcha must be 'true' or 'false'."
    exit 1
  fi

  signature=${signature:-""}
  
  # Default credit to false if not provided
  if [ -z "$credit" ]; then
    credit="false"
  fi
  if [ "$credit" != "true" ] && [ "$credit" != "false" ]; then
    echo -e "${RED}Error:${NC} credit must be 'true' or 'false'."
    exit 1
  fi

  # Default vip to false if not provided
  if [ -z "$vip" ]; then
    vip="false"
  fi
  if [ "$vip" != "true" ] && [ "$vip" != "false" ]; then
    echo -e "${RED}Error:${NC} vip must be 'true' or 'false'."
    exit 1
  fi

  data=$(jq -n --arg url "$url" --arg sig "$signature" --argjson cap $captcha --argjson cred $credit --argjson v $vip '{url:$url, signature:$sig, captcha:$cap, credit:$cred, vip:$v}')
  http_call PUT "${BASE_URL}/api/v2/mirrors/${id}" "$data"
  code=$LAST_HTTP_CODE
  if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
    echo -e "${GREEN}${OK_ICON} Updated (${code})${NC}"
  else
    echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
  fi
}

delete_mirror() {
  id=$1
  [ -z "$id" ] && { echo -e "${RED}Error:${NC} Missing mirror ID"; exit 1; }
  http_call DELETE "${BASE_URL}/api/v2/mirrors/${id}"
  code=$LAST_HTTP_CODE
  if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
    echo -e "${GREEN}${OK_ICON} Deleted (${code})${NC}"
  else
    echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
  fi
}

delete_multiple_mirrors() {
  ids=$1
  if [ -z "$ids" ]; then
    echo -e "${RED}Usage:${NC} ./tdw_api.sh delete-multiple "
    exit 1
  fi
  ensure_jq_for_bulk

  IFS=',' read -ra arr <<< "$ids"
  for id in "${arr[@]}"; do
    id=$(trim "$id")
    echo -e "${GRAY}Deleting mirror ID: ${id}${NC}"
    http_call DELETE "${BASE_URL}/api/v2/mirrors/${id}"
    code=$LAST_HTTP_CODE
    if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
      echo -e "${GREEN}${OK_ICON} Deleted (${code})${NC}"
    else
      echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
    fi
    echo
  done
}

delete_all_mirrors() {
  ensure_jq_for_bulk
  echo -e "${YELLOW}⚠️  WARNING: This will delete ALL mirrors.${NC}"
  read -p "Type YES to confirm: " confirm
  if [ "${confirm^^}" != "YES" ]; then
    echo "Canceled."
    exit 0
  fi

  echo -e "${GRAY}Fetching mirrors...${NC}"
  json=$(curl -sS -H "Authorization: ${API_KEY}" "${BASE_URL}/api/v2/mirrors")

  ids=$(echo "$json" | jq -r '
    if type=="array" then .[] | ( .ID // .id // empty )
    elif type=="object" and has("mirrors") then .mirrors[] | ( .ID // .id // empty )
    else empty end
  ')

  if [ -z "$ids" ]; then
    echo "No mirrors found (or failed to retrieve)."
    exit 0
  fi

  for id in $ids; do
    id=$(trim "$id")
    echo -e "${GRAY}Deleting mirror ID: ${id}${NC}"
    http_call DELETE "${BASE_URL}/api/v2/mirrors/${id}"
    code=$LAST_HTTP_CODE
    if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
      echo -e "${GREEN}${OK_ICON} Deleted (${code})${NC}"
    else
      echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
    fi
    echo
  done
}

# create-multiple expects CSV: url,signature,captcha,credit,vip
create_multiple_mirrors() {
  file=$1
  if [ -z "$file" ]; then
    echo -e "${RED}Usage:${NC} ./tdw_api.sh create-multiple "
    exit 1
  fi
  ensure_jq_for_bulk
  if [ ! -f "$file" ]; then
    echo -e "${RED}Error:${NC} File not found: $file"
    exit 1
  fi

  echo -e "${CYAN}Preview from $file:${NC}"
  echo -e "${GRAY}$(head -n 1 "$file")${NC}"
  tail -n +2 "$file" | nl -ba -w3 -s'  ' | head -n 10
  echo

  read -p "Type YES to proceed with batch sync: " confirm
  if [ "${confirm^^}" != "YES" ]; then echo "Canceled."; exit 0; fi


  while IFS=',' read -r url signature captcha credit vip || [ -n "$url" ]; do
    url=$(trim "$url")
    signature=$(trim "$signature")
    captcha=$(trim "$captcha")
    credit=$(trim "$credit")
    vip=$(trim "$vip")

    if echo "$url" | grep -iq '^url$'; then continue; fi
    if [ -z "$url" ]; then
      echo -e "${YELLOW}Skipping empty URL line${NC}"
      continue
    fi
    if [ -z "$captcha" ]; then
      echo -e "${RED}Error:${NC} captcha is required for each entry (true|false). Skipping $url"
      continue
    fi
    if [ "$captcha" != "true" ] && [ "$captcha" != "false" ]; then
      echo -e "${RED}Error:${NC} captcha must be 'true' or 'false' for $url. Skipping."
      continue
    fi

    # Default credit to false if empty
    if [ -z "$credit" ]; then
      credit="false"
    fi
    if [ "$credit" != "true" ] && [ "$credit" != "false" ]; then
      echo -e "${RED}Error:${NC} credit must be 'true' or 'false' for $url. Skipping."
      continue
    fi

    # Default vip to false if empty
    if [ -z "$vip" ]; then
      vip="false"
    fi
    if [ "$vip" != "true" ] && [ "$vip" != "false" ]; then
      echo -e "${RED}Error:${NC} vip must be 'true' or 'false' for $url. Skipping."
      continue
    fi

    signature=${signature:-""}
    echo -e "${GRAY}Creating: ${url} (captcha=${captcha}, credit=${credit}, vip=${vip})${NC}"
    data=$(jq -n --arg url "$url" --arg sig "$signature" --argjson cap $captcha --argjson cred $credit --argjson v $vip '{url:$url, signature:$sig, captcha:$cap, credit:$cred, vip:$v}')
    http_call POST "${BASE_URL}/api/v2/mirrors" "$data"
    code=$LAST_HTTP_CODE
    if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
      echo -e "${GREEN}${OK_ICON} Created (${code})${NC}"
    else
      echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
    fi
    echo
  done < "$file"
}

# update-multiple expects CSV: id,url,signature,captcha,credit,vip
update_multiple_mirrors() {
  file=$1
  if [ -z "$file" ]; then
    echo -e "${RED}Usage:${NC} ./tdw_api.sh update-multiple "
    exit 1
  fi
  ensure_jq_for_bulk
  if [ ! -f "$file" ]; then
    echo -e "${RED}Error:${NC} File not found: $file"
    exit 1
  fi

  echo -e "${CYAN}Preview from $file:${NC}"
  echo -e "${GRAY}$(head -n 1 "$file")${NC}"
  tail -n +2 "$file" | nl -ba -w3 -s'  ' | head -n 10
  echo

  read -p "Type YES to proceed with batch sync: " confirm
  if [ "${confirm^^}" != "YES" ]; then echo "Canceled."; exit 0; fi

  while IFS=',' read -r id url signature captcha credit vip || [ -n "$id" ]; do
    id=$(trim "$id")
    url=$(trim "$url")
    signature=$(trim "$signature")
    captcha=$(trim "$captcha")
    credit=$(trim "$credit")
    vip=$(trim "$vip")

    if echo "$id" | grep -iq '^id$'; then continue; fi
    if [ -z "$id" ] || [ -z "$url" ]; then
      echo -e "${YELLOW}Skipping invalid line: id or url missing${NC}"
      continue
    fi
    if [ -z "$captcha" ]; then
      echo -e "${RED}Error:${NC} captcha is required for each entry (true|false). Skipping id ${id}"
      continue
    fi
    if [ "$captcha" != "true" ] && [ "$captcha" != "false" ]; then
      echo -e "${RED}Error:${NC} captcha must be 'true' or 'false' for id ${id}. Skipping."
      continue
    fi

    # Default credit to false if empty
    if [ -z "$credit" ]; then
      credit="false"
    fi
    if [ "$credit" != "true" ] && [ "$credit" != "false" ]; then
      echo -e "${RED}Error:${NC} credit must be 'true' or 'false' for id ${id}. Skipping."
      continue
    fi

    # Default vip to false if empty
    if [ -z "$vip" ]; then
      vip="false"
    fi
    if [ "$vip" != "true" ] && [ "$vip" != "false" ]; then
      echo -e "${RED}Error:${NC} vip must be 'true' or 'false' for id ${id}. Skipping."
      continue
    fi

    signature=${signature:-""}
    echo -e "${GRAY}Updating ID ${id}: ${url} (captcha=${captcha}, credit=${credit}, vip=${vip})${NC}"
    data=$(jq -n --arg url "$url" --arg sig "$signature" --argjson cap $captcha --argjson cred $credit --argjson v $vip '{url:$url, signature:$sig, captcha:$cap, credit:$cred, vip:$v}')
    http_call PUT "${BASE_URL}/api/v2/mirrors/${id}" "$data"
    code=$LAST_HTTP_CODE
    if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
      echo -e "${GREEN}${OK_ICON} Updated (${code})${NC}"
    else
      echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
    fi
    echo
  done < "$file"
}

# --- BATCH SYNC ---
batch_sync() {
  file=$1
  if [ -z "$file" ]; then
    echo -e "${RED}Usage:${NC} ./tdw_api.sh batch-sync "
    exit 1
  fi
  ensure_jq_for_bulk
  if [ ! -f "$file" ]; then
    echo -e "${RED}Error:${NC} File not found: $file"
    exit 1
  fi

  echo -e "${CYAN}Preview from $file:${NC}"
  echo -e "${GRAY}$(head -n 1 "$file")${NC}"
  tail -n +2 "$file" | nl -ba -w3 -s'  ' | head -n 10
  echo

  read -p "Type YES to send all mirrors in one batch sync request: " confirm
  if [ "${confirm^^}" != "YES" ]; then
    echo "Canceled."
    exit 0
  fi

  # Build JSON payload from CSV
  json_payload=$(tail -n +2 "$file" | jq -Rn '
    [inputs |
      split(",") |
      {url: .[0], signature: (.[1] // ""), captcha: (.[2] == "true"), credit: (.[3] == "true"), vip: (.[4] == "true")}
    ] | {mirrors: .}
  ')

  echo -e "${GRAY}→ Payload:${NC} $json_payload"
  http_call PUT "${BASE_URL}/api/v2/mirrors/batch" "$json_payload"

  code=$LAST_HTTP_CODE
  if [ "$code" -ge 200 ] && [ "$code" -lt 300 ]; then
    echo -e "${GREEN}${OK_ICON} Batch sync complete (${code})${NC}"
  else
    echo -e "${RED}${FAIL_ICON} HTTP ${code}${NC}"
  fi
}

show_csv_help() {
  echo -e "${YELLOW}CSV Formats:${NC}"
  echo

  # create-multiple
  echo -e "  ${GREEN}create-multiple:${NC} ${GRAY}url,signature,captcha,credit,vip${NC}"
  echo -e "    - Each mirror must be on a separate line."
  echo -e "    - Fields:"
  echo -e "        ${CYAN}url${NC}       → The mirror URL (required)"
  echo -e "        ${CYAN}signature${NC} → Optional; use empty or '-' if none"
  echo -e "        ${CYAN}captcha${NC}   → true or false (required)"
  echo -e "        ${CYAN}credit${NC}    → true or false (optional, defaults to false)"
  echo -e "        ${CYAN}vip${NC}       → true or false (optional, defaults to false)"
  echo -e "    - Example:"
  echo -e "        ${BLUE}url,signature,captcha,credit,vip${NC}"
  echo -e "        ${BLUE}http://mirror1.com,abc123,true,false,false${NC}"
  echo -e "        ${BLUE}http://mirror2.com,,false,true,true${NC}"
  echo

  # update-multiple
  echo -e "  ${GREEN}update-multiple:${NC} ${GRAY}id,url,signature,captcha,credit,vip${NC}"
  echo -e "    - Update existing mirrors by ID."
  echo -e "    - Fields:"
  echo -e "        ${CYAN}id${NC}        → Mirror ID (required)"
  echo -e "        ${CYAN}url${NC}       → Mirror URL (required)"
  echo -e "        ${CYAN}signature${NC} → Optional; leave empty or '-' if none"
  echo -e "        ${CYAN}captcha${NC}   → true or false (required)"
  echo -e "        ${CYAN}credit${NC}    → true or false (optional, defaults to false)"
  echo -e "        ${CYAN}vip${NC}       → true or false (optional, defaults to false)"
  echo -e "    - Example:"
  echo -e "        ${BLUE}id,url,signature,captcha,credit,vip${NC}"
  echo -e "        ${BLUE}88,http://mirror1.com,newSig,true,false,false${NC}"
  echo -e "        ${BLUE}89,http://mirror2.com,,false,true,true${NC}"
  echo

  # batch-sync
  echo -e "  ${GREEN}batch-sync:${NC} ${GRAY}url,signature,captcha,credit,vip${NC}"
  echo -e "    - Send multiple mirrors in a single batch request."
  echo -e "    - Each mirror must be on its own line."
  echo -e "    - Example:"
  echo -e "        ${BLUE}url,signature,captcha,credit,vip${NC}"
  echo -e "        ${BLUE}http://mirror1.com,abc123,true,false,false${NC}"
  echo -e "        ${BLUE}http://mirror2.com,,false,true,true${NC}"
  echo
  echo -e "${YELLOW}Notes:${NC}"
  echo -e "  - Empty lines are skipped."
  echo -e "  - The header line is required for all CSV files."
  echo -e "  - Only commas ',' are supported as separators."
  echo -e "  - captcha must be either 'true' or 'false'."
  echo -e "  - credit must be either 'true' or 'false' (defaults to false if omitted)."
  echo -e "  - vip must be either 'true' or 'false' (defaults to false if omitted)."
  echo
}

# --- HELP MENU ---
show_help() {
  echo -e "${YELLOW}Usage:${NC}"
  echo -e "  ${GREEN}./tdw_api.sh${NC} ${BLUE}${NC} [options]\n"

  echo -e "${YELLOW}Commands:${NC}"
  echo -e "  ${GREEN}list${NC} [full|csv]	Show all mirrors (summary, full JSON, or CSV)"
  echo -e "  ${GREEN}show${NC} ID         	Show details of a specific mirror"
  echo -e "  ${GREEN}create${NC}   		Create a mirror format: \"url\" \"signature\" true false [vip]"										
  echo -e "  ${GREEN}update${NC}    		Update a mirror"										
  echo -e "  ------------------------------------------------------"
  echo -e "  ${GREEN}delete${NC} ID               	Delete a mirror by ID"
  echo -e "  ${GREEN}delete-multiple${NC} ID,ID 	Delete multiple mirrors at once"
  echo -e "  ${GREEN}delete-all${NC}                 	⚠️  Delete ALL mirrors "
  echo -e "  ------------------------------------------------------"
  echo -e "  ${GREEN}create-multiple${NC} mirrors.csv   Create multiple mirrors from CSV"
  echo -e "  ${GREEN}update-multiple${NC} mirrors.csv   Update multiple mirrors from CSV"  
  echo -e "  ${GREEN}batch-sync${NC} mirrors.csv    	Send multiple mirrors in one batch request\n"

  echo -e "${YELLOW}CSV formats:${NC}"
  echo -e "  ${GREEN}create-multiple:${NC} ${GRAY}url,signature,captcha,credit,vip${NC}"
  echo -e "    e.g.: ${BLUE}http://a.com,abc123,true,false,false${NC}"
  echo -e "  ${GREEN}update-multiple:${NC} ${GRAY}id,url,signature,captcha,credit,vip${NC}"
  echo -e "    e.g.: ${BLUE}88,http://x.com,newSig,true,false,false${NC}"
  echo -e "  ${GREEN}batch-sync:${NC} ${GRAY}url,signature,captcha,credit,vip${NC}"
  echo -e "    e.g.: ${BLUE}http://y.com,signed,true,false,false${NC}"
  echo -e "  ${YELLOW}More examples:${NC} ${GREEN}./tdw_api.sh help csv${NC}\n"

  echo -e "${YELLOW}⚠️ Tip:${NC} If you see "validation error ${RED}❌ HTTP${NC}" Check your BASE_URL, API_KEY, and Signature values. The signature field cannot be empty \"\" use \"-\" if you don’t have one."
}

# --- MAIN ---
check_dependencies
print_header

case "$1" in
  list) list_mirrors "$2" ;;
  show) show_mirror "$2" ;;
  create) create_mirror "$2" "$3" "$4" "$5" ;;
  update) update_mirror "$2" "$3" "$4" "$5" "$6" ;;
  delete) delete_mirror "$2" ;;
  delete-multiple) delete_multiple_mirrors "$2" ;;
  delete-all) delete_all_mirrors ;;
  create-multiple) create_multiple_mirrors "$2" ;;
  update-multiple) update_multiple_mirrors "$2" ;;
  batch-sync) batch_sync "$2" ;;
  help)
    if [ "$2" = "csv" ]; then
      show_csv_help
    else
      show_help
    fi
    ;;
  --help|-h|"") show_help ;;
  *) echo -e "${RED}Unknown command:${NC} $1"; show_help ;;
esac