.vscode.d/siren

#! /usr/bin/env bash

# ==============================================================================
# Settings
# ==============================================================================

# Default editor to configure (cursor, vscode, or vscode-insiders)
SETUP_EDITOR="cursor"

# List of config files to symlink from current directory.
CONFIG_SOURCES=(
  "settings.json"
  "keybindings.json"
  "snippets"
)

# Additional static symlinks to create (source => target)
declare -A STATIC_SYMLINKS=(
  ["cspell/vscode-user-dictionary.txt"]="${HOME}/.cspell/vscode-user-dictionary.txt"
)

# Detect current script directory.
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# Get extensions lockfile path for current editor
get_extensions_lock() {
  echo "${SCRIPT_DIR}/extensions.${SETUP_EDITOR}.lock"
}

# ==============================================================================
# Help
# ==============================================================================

show_help() {
  cat << EOF
Usage: $(basename "$0") EDITOR COMMAND [OPTIONS]

Editors:
  cursor, c                   Cursor editor
  vscode, code, vsc, v        Visual Studio Code
  vscode-insiders, vsci, i    Visual Studio Code Insiders
  windsurf, surf, w           Windsurf editor

Commands:
  config, conf             Create symlinks for editor config files
  dump-extensions, dump    Export installed editor extensions to a lock file.
  extensions, ext          Install editor extensions from a lock file.

Options:
  --latest                 When used with the extensions command, installs the
                           latest version of each extension instead of the
                           exact version from the lock file.

Description:
  This script manages editor configuration files and extensions.
  It can create symlinks for settings, keybindings, and snippets,
  as well as dump extension lock files and install extensions from them.
EOF
}

# ==============================================================================
# Functions
# ==============================================================================

# Determine editor config directory
editor_config_dir() {
  case "$(uname -s)" in
    "Darwin")
      case "${SETUP_EDITOR}" in
        "cursor")
          echo "${HOME}/Library/Application Support/Cursor/User"
          ;;
        "vscode")
          echo "${HOME}/Library/Application Support/Code/User"
          ;;
        "vscode-insiders")
          echo "${HOME}/Library/Application Support/Code - Insiders/User"
          ;;
        "windsurf")
          echo "${HOME}/Library/Application Support/Windsurf/User"
          ;;
        *)
          echo "Error: Invalid editor '${SETUP_EDITOR}' for macOS"
          exit 1
          ;;
      esac
      ;;
    "Linux")
      case "${SETUP_EDITOR}" in
        "cursor")
          echo "${HOME}/.config/Cursor/User"
          ;;
        "vscode")
          echo "${HOME}/.config/Code/User"
          ;;
        "vscode-insiders")
          echo "${HOME}/.config/Code - Insiders/User"
          ;;
        "windsurf")
          echo "${HOME}/.config/Windsurf/User"
          ;;
        *)
          echo "Error: Invalid editor '${SETUP_EDITOR}' for Linux"
          exit 1
          ;;
      esac
      ;;
    *)
      echo "Error: Unsupported operating system"
      exit 1
      ;;
  esac
}

# Cross-platform function to resolve symlinks
resolve_symlink() {
  local path="$1"
  if command -v realpath > /dev/null 2>&1; then
    realpath "$path"
  elif [[ "$(uname -s)" == "Darwin" ]]; then
    # Use printf to safely pass the path to Python
    python -c "import os, sys; print(os.path.realpath(sys.argv[1]))" "$path"
  else
    readlink -f "$path"
  fi
}

# Backup and symlink
backup_and_link() {
  local source="$1"
  local target="$2"
  local real_target
  local real_source

  # Create target directory if it doesn't exist
  local target_dir
  target_dir="$(dirname "${target}")"
  mkdir -p "${target_dir}"

  # Check if target already exists
  if [[ -e "${target}" ]]; then
    # If it's a symlink, check if it points to the same location
    if [[ -L "${target}" ]]; then
      real_target="$(resolve_symlink "$target")"
      real_source="$(resolve_symlink "$source")"
      if [[ "${real_target}" == "${real_source}" ]]; then
        echo "Skipping ${target} - already linked to ${source}"
        return
      fi
    fi

    echo "Backing up existing ${target} to ${target}.bak"
    mv "${target}" "${target}.bak"
  fi

  # Create symlink
  echo "Creating symlink for ${source} to ${target}"
  ln -s "${source}" "${target}"
}

# Create symlinks
do_symlink() {
  # Create editor config directory if it doesn't exist
  local config_dir
  config_dir="$(editor_config_dir)"

  mkdir -p "${config_dir}"
  for path in "${CONFIG_SOURCES[@]}"; do
    backup_and_link "${SCRIPT_DIR}/${path}" "${config_dir}/${path}"
  done

  # Conditionally add mcp.json for cursor
  if [[ "${SETUP_EDITOR}" == "cursor" ]]; then
    STATIC_SYMLINKS["cursor/mcp.json"]="${HOME}/.cursor/mcp.json"
  fi

  # Create static symlinks to custom locations
  for source in "${!STATIC_SYMLINKS[@]}"; do
    target="${STATIC_SYMLINKS[${source}]}"
    backup_and_link "${SCRIPT_DIR}/${source}" "${target}"
  done

  echo "Symlink setup complete!"
}

# Find the editor CLI command
find_editor_cmd() {
  local editor_cmd=""
  local possible_commands=()

  case "${SETUP_EDITOR}" in
    "cursor")
      # Set possible Cursor CLI command locations
      possible_commands=(
        "cursor"
        "/Applications/Cursor.app/Contents/Resources/app/bin/cursor"
        "${HOME}/Applications/Cursor.app/Contents/Resources/app/bin/cursor"
      )
      ;;
    "vscode")
      # Set possible VSCode CLI command locations
      possible_commands=(
        "code"
        "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"
        "${HOME}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code"
      )
      ;;
    "vscode-insiders")
      # Set possible VSCode Insiders CLI command locations
      possible_commands=(
        "code-insiders"
        "/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code"
        "${HOME}/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code"
      )
      ;;
    "windsurf")
      # Set possible Windsurf CLI command locations
      possible_commands=(
        "windsurf"
        "/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf"
        "${HOME}/Applications/Windsurf.app/Contents/Resources/app/bin/windsurf"
      )
      ;;
    *)
      echo "Error: Invalid editor '${SETUP_EDITOR}'"
      exit 1
      ;;
  esac

  # Check for the command in all possible locations
  for cmd in "${possible_commands[@]}"; do
    if command -v "${cmd}" > /dev/null 2>&1; then
      editor_cmd="${cmd}"
      break
    fi
  done

  if [[ -z "${editor_cmd}" ]]; then
    echo "Error: ${SETUP_EDITOR} command not found" >&2
    exit 1
  fi

  echo "${editor_cmd}"
}

# Dump installed extensions to extensions.lock
do_dump_extensions() {
  local editor_cmd
  editor_cmd="$(find_editor_cmd)"
  local current_date
  current_date="$(date)"
  local extensions_lock
  extensions_lock="$(get_extensions_lock)"

  {
    echo "# ${SETUP_EDITOR} Extensions"
    echo "# Generated on ${current_date}"
    echo
    "${editor_cmd}" --list-extensions --show-versions
  } > "${extensions_lock}"

  echo "Extensions list dumped to ${extensions_lock}"
}

# Validate extension line format
validate_extension_line() {
  local line="$1"
  local extension=""
  local version=""

  # Check for exactly one @ symbol
  local at_count
  at_count=$(echo "${line}" | grep -o "@" | wc -l)
  if [[ ${at_count} -ne 1 ]]; then
    echo "Warning: Invalid format '${line}' - must contain exactly one '@'"
    return 1
  fi

  # Extract extension and version parts
  extension="${line%@*}"
  version="${line#*@}"

  # Validate extension part (should be publisher.extension)
  if [[ ! "${extension}" =~ ^[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+$ ]]; then
    echo "Warning: Invalid extension format '${extension}' - must be 'publisher.extension'"
    return 1
  fi

  # Validate version is not empty and contains valid characters
  if [[ -z "${version}" ]]; then
    echo "Warning: Empty version for extension '${extension}'"
    return 1
  fi

  if [[ ! "${version}" =~ ^[a-zA-Z0-9._-]+$ ]]; then
    echo "Warning: Invalid version format '${version}' for extension '${extension}'"
    return 1
  fi

  # Check for leading/trailing whitespace
  if [[ "${line}" != "${line// /}" ]]; then
    echo "Warning: Extension line contains spaces: '${line}'"
    return 1
  fi

  return 0
}

# Global variable to cache installed extensions
_INSTALLED_EXTENSIONS=""

# Get installed extensions with versions, using cache if available
installed_extensions() {
  local editor_cmd="$1"

  # Populate the cache if it's not already populated.
  if [[ -z "${_INSTALLED_EXTENSIONS}" ]]; then
    _INSTALLED_EXTENSIONS="$("${editor_cmd}" --list-extensions --show-versions)"
  fi

  echo "${_INSTALLED_EXTENSIONS}"
}

# Check if extension is already installed, ignoring version
is_extension_installed() {
  local editor_cmd="$1"
  local extension="$2"

  # Check if extension exists in cached list
  installed_extensions "${editor_cmd}" |
    grep -q "^$(printf '%s' "${extension}" | sed 's/[[\.*^$()+?{|]/\\&/g')@"
}

# Check if extension is installed with exact version
is_exact_version_installed() {
  local editor_cmd="$1"
  local extension="$2"
  local version="$3"

  # Check if exact extension@version exists in cached list
  installed_extensions "${editor_cmd}" |
    grep -q "^$(printf '%s' "${extension}@${version}" | sed 's/[[\.*^$()+?{|]/\\&/g')$"
}

# Install an extension directly using the marketplace
install_extension_direct() {
  local editor_cmd="$1"
  local extension="$2"
  local version="$3"
  local use_latest="$4"
  local force_install="$5"
  local result=0

  if [[ "${use_latest}" == "true" ]]; then
    echo "Installing ${extension} (latest version)"
    if ! "${editor_cmd}" --install-extension "${extension}" --force; then
      echo "Warning: Direct install failed for ${extension}"
      result=1
    fi
  else
    echo "Installing ${extension}@${version}"
    local install_cmd=("${editor_cmd}" --install-extension "${extension}@${version}")
    if [[ "${force_install}" == "true" ]]; then
      install_cmd+=(--force)
    fi
    if ! "${install_cmd[@]}"; then
      echo "Warning: Direct install failed for ${extension}@${version}"
      result=1
    fi
  fi

  return ${result}
}

# Install an extension via downloading .vsix file
install_extension_via_vsix() {
  local editor_cmd="$1"
  local extension="$2"
  local version="$3"
  local use_latest="$4"
  local extensions_cache_dir="$5"
  local result=0

  local publisher_id="${extension%%.*}"
  local extension_id="${extension#*.}"
  local vsix_path=""
  local vsix_url=""
  local install_version=""

  if [[ "${use_latest}" == "true" ]]; then
    # Check for jq availability when using --latest flag
    if ! command -v jq > /dev/null 2>&1; then
      echo "Error: jq is required when using --latest flag to parse marketplace API responses"
      echo "Please install jq or remove the --latest flag to use exact versions from the lock file"
      return 1
    fi

    # In latest mode, we need to first query the marketplace to get the latest version
    echo "Finding latest version for ${extension}..."

    # Query the VS Marketplace API to get the extension metadata
    local metadata_url="https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery"
    local temp_metadata="${extensions_cache_dir}/metadata-${extension}.json"

    # Create extensions directory if it doesn't exist
    mkdir -p "${extensions_cache_dir}"

    # Use jq to properly construct JSON
    local request_data
    request_data=$(jq -n --arg ext "$extension" '{
      filters: [{
        criteria: [{ filterType: 7, value: $ext }]
      }],
      flags: 2
    }')

    # Query the marketplace for extension metadata
    if ! curl --silent --compressed -X POST -H "Content-Type: application/json" -H "Accept: application/json; api-version=7.2-preview.1" -d "${request_data}" "${metadata_url}" > "${temp_metadata}"; then
      echo "Warning: Failed to query metadata for ${extension}"
      rm -f "${temp_metadata}"
      return 1
    fi

    # Extract the latest version from the response using jq
    install_version=$(jq -r '.results[0].extensions[0].versions[0].version' "${temp_metadata}" 2> /dev/null)

    # Clean up metadata file
    rm -f "${temp_metadata}"

    # If we couldn't extract a version, use original version as fallback
    if [[ -z "${install_version}" || "${install_version}" == "null" ]]; then
      echo "Warning: Could not determine latest version, falling back to lock file version"
      install_version="${version}"
    else
      echo "Latest version of ${extension} is ${install_version}"
    fi

    # Set up the download path and URL for the specific version we found
    vsix_path="${extensions_cache_dir}/${extension}@${install_version}.vsix"
    vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${install_version}/vspackage"
  else
    # In strict mode, use the exact version from the lock file
    echo "Installing ${extension}@${version} via .vsix"
    vsix_path="${extensions_cache_dir}/${extension}@${version}.vsix"
    vsix_url="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/${publisher_id}/vsextensions/${extension_id}/${version}/vspackage"
    install_version="${version}"
  fi

  # Create extensions directory if it doesn't exist
  mkdir -p "${extensions_cache_dir}"

  # Download the .vsix file
  echo "Downloading ${extension}@${install_version}.vsix..."
  echo "  - URL: ${vsix_url}"
  if ! curl --compressed -L -o "${vsix_path}" "${vsix_url}"; then
    echo "Warning: Failed to download ${extension}@${install_version}.vsix"
    rm -f "${vsix_path}" # Clean up potential partial downloads
    return 1
  fi

  # Install the extension from .vsix file
  # Note: Installing from .vsix automatically overwrites existing versions
  echo "Installing extension from ${vsix_path}"
  if ! "${editor_cmd}" --install-extension "${vsix_path}"; then
    echo "Warning: Failed to install ${extension}@${install_version} from .vsix"
    result=1
  fi

  # Clean up the .vsix file after installation attempt
  rm -f "${vsix_path}"

  return ${result}
}

# Install extensions from extensions.lock
do_install_extensions() {
  local editor_cmd
  editor_cmd="$(find_editor_cmd)"
  local extensions_cache_dir="${SCRIPT_DIR}/cache/extensions"
  local extensions_lock
  extensions_lock="$(get_extensions_lock)"
  local use_latest="${1:-false}"

  if [[ ! -f "${extensions_lock}" ]]; then
    echo "Error: ${extensions_lock} not found"
    exit 1
  fi

  # Warn the installed extensions cache before we start processing the lock
  # file.
  installed_extensions "${editor_cmd}"

  # Process each extension
  while IFS= read -r line; do
    if [[ -n "${line}" && ! "${line}" =~ ^[[:space:]]*# ]]; then
      # Validate extension line format
      if ! validate_extension_line "${line}"; then
        continue
      fi

      extension="${line%@*}"
      version="${line#*@}"

      # Check if already installed with correct version
      if [[ "${use_latest}" == "true" ]]; then
        # In latest mode, just check if extension is installed (any version)
        if is_extension_installed "${editor_cmd}" "${extension}"; then
          echo "Extension ${extension} is already installed, skipping"
          continue
        fi
      else
        # In exact mode, check if the exact version is installed
        if is_exact_version_installed "${editor_cmd}" "${extension}" "${version}"; then
          echo "Extension ${extension}@${version} is already installed, skipping"
          continue
        elif is_extension_installed "${editor_cmd}" "${extension}"; then
          echo "Extension ${extension} is installed but wrong version, force-installing ${version}"
        fi
      fi

      # Determine if we need to force install (when wrong version is installed)
      local force_install="false"
      if [[ "${use_latest}" == "false" ]] && is_extension_installed "${editor_cmd}" "${extension}"; then
        force_install="true"
      fi

      # For Cursor we need to download and install from .vsix file, as
      # installation via ID fails with a signature verification error.
      if [[ "${SETUP_EDITOR}" == "cursor" ]]; then
        install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${extensions_cache_dir}"
        continue
      fi

      if ! install_extension_direct "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${force_install}"; then
        echo "Direct installation failed, trying .vsix download method..."
        install_extension_via_vsix "${editor_cmd}" "${extension}" "${version}" "${use_latest}" "${extensions_cache_dir}"
      fi
    fi
  done < "${extensions_lock}"

  # Clean up extensions directory if empty
  rmdir "${extensions_cache_dir}" 2> /dev/null || true
  echo "Extensions installation complete!"
}

# ==============================================================================
# Main
# ==============================================================================

main() {
  if [[ $# -lt 1 ]]; then
    echo "Error: No editor specified"
    show_help
    exit 1
  fi

  if [[ "$1" == "help" || "$1" == "--help" || "$1" == "-h" ]]; then
    show_help
    exit 0
  fi

  if [[ $# -lt 2 ]]; then
    echo "Error: No command specified"
    show_help
    exit 1
  fi

  # Set editor from first argument
  editor="$(echo "${1}" | tr '[:upper:]' '[:lower:]')"
  case "${editor}" in
    "vscode" | "code" | "vsc" | "v")
      SETUP_EDITOR="vscode"
      ;;
    "vscode-insiders" | "code-insiders" | "insiders" | "vsci" | "i")
      SETUP_EDITOR="vscode-insiders"
      ;;
    "cursor" | "c")
      SETUP_EDITOR="cursor"
      ;;
    "windsurf" | "wind" | "surf" | "w")
      SETUP_EDITOR="windsurf"
      ;;
    *)
      echo "Error: Unsupported editor '${editor}'"
      echo "Supported editors: cursor, vscode (vsc), vscode-insiders (vsci), windsurf (wind)"
      exit 1
      ;;
  esac

  # Get command from second argument
  local command="${2}"
  shift 2

  # Default values for options
  local use_latest="false"

  # Parse additional options
  while [[ $# -gt 0 ]]; do
    case "$1" in
      --latest)
        use_latest="true"
        shift
        ;;
      *)
        echo "Error: Unknown option '$1'"
        show_help
        exit 1
        ;;
    esac
  done

  # Handle commands
  case "${command}" in
    "config" | "conf")
      do_symlink
      ;;
    "dump-extensions" | "dump")
      do_dump_extensions
      ;;
    "extensions" | "ext")
      do_install_extensions "${use_latest}"
      ;;
    "")
      echo "Error: No command provided"
      show_help
      exit 1
      ;;
    *)
      echo "Error: Unknown command '${command}'"
      show_help
      exit 1
      ;;
  esac
}

# Run main function.
main "$@"