shared

#!/usr/bin/env bash
# Shared configuration, utilities, and guards for sandbox scripts
# shellcheck disable=SC2034  # Variables are used by sourcing scripts

# Resolve directories
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
SANDBOX_HOME="${SCRIPT_DIR}"
ROOT_DIR="$(pwd)"

refresh_root_paths() {
  ROOT_DIR="${1:?root directory is required}"
  CONFIG_FILE="${ROOT_DIR}/opencode-sandbox-config.yaml"
  MISE_CONFIG_ROOT_FILE="${ROOT_DIR}/mise.toml"

  # Read sandbox-name from opencode-sandbox-config.yaml
  local sandbox_name=""
  if [[ -f "${CONFIG_FILE}" ]]; then
    while IFS= read -r line || [[ -n "${line}" ]]; do
      # Match top-level key: no leading whitespace, key is "sandbox-name", space optional
      if [[ "${line}" =~ ^sandbox-name:[[:space:]]*([^#[:space:]][^#]*) ]]; then
        # Trim trailing whitespace and inline comments from captured value
        sandbox_name="${BASH_REMATCH[1]}"
        sandbox_name="${sandbox_name%%#*}"
        sandbox_name="${sandbox_name%"${sandbox_name##*[! ]}"}"
        break
      fi
    done < "${CONFIG_FILE}"
  fi

  if [[ -z "${sandbox_name}" ]]; then
    if [[ -f "${CONFIG_FILE}" ]]; then
      echo "ERROR: 'sandbox-name' is not set in ${CONFIG_FILE}" >&2
      echo "  Add a top-level entry to the file, e.g.:" >&2
      echo "    sandbox-name: my-project" >&2
      echo "  Run ocs-init to regenerate the config with a sandbox name if needed." >&2
      return 1
    fi
    # Config file absent (e.g. during ocs-init before config is created) — leave paths unset
    SANDBOX_ID=""
    CONTAINER_NAME=""
    OPENCODE_SANDBOX_DIR=""
    OPENCODE_PASSWORD_FILE=""
    MISE_CONFIG_SANDBOX_FILE=""
    OPENCODE_STATE_DIR=""
    return 0
  fi

  # Validate sandbox-name for Docker naming rules: lowercase letters, digits, hyphens only.
  if [[ ! "${sandbox_name}" =~ ^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$ ]]; then
    echo "ERROR: 'sandbox-name' value '${sandbox_name}' in ${CONFIG_FILE} is not valid." >&2
    echo "  Docker requires names to contain only lowercase letters, digits, and hyphens," >&2
    echo "  and must start and end with a letter or digit." >&2
    echo "  Example: sandbox-name: my-project" >&2
    return 1
  fi

  # Compute SANDBOX_ID: combine sandbox-name with a short hash of the physical project root
  # path. Using realpath ensures symlinks don't produce different IDs for the same checkout.
  local config_dir
  if command -v realpath >/dev/null 2>&1; then
    config_dir="$(realpath "$(dirname "${CONFIG_FILE}")")"
  else
    config_dir="$(cd "$(dirname "${CONFIG_FILE}")" && pwd -P)"
  fi
  local dir_hash dir_hash_hex
  dir_hash="$(printf '%s' "${config_dir}" | cksum | cut -d' ' -f1)"
  dir_hash_hex="$(printf '%x' "${dir_hash}")"
  SANDBOX_ID="${sandbox_name}-${dir_hash_hex:0:6}"

  CONTAINER_NAME="opencode-sandbox-${SANDBOX_ID}"
  OPENCODE_SANDBOX_DIR="${HOME}/.opencode-sandbox/${SANDBOX_ID}"

  # File paths
  OPENCODE_PASSWORD_FILE="${OPENCODE_SANDBOX_DIR}/opencode-password"
  MISE_CONFIG_SANDBOX_FILE="${OPENCODE_SANDBOX_DIR}/mise.toml"
  OPENCODE_STATE_DIR="${OPENCODE_SANDBOX_DIR}/opencode-state"
}

find_sandbox_root() {
  local dir

  dir="$(pwd)"

  while [[ "${dir}" != "/" ]]; do
    if [[ -f "${dir}/opencode-sandbox-config.yaml" ]]; then
      printf '%s\n' "${dir}"
      return 0
    fi

    dir="$(dirname "${dir}")"
  done

  if [[ -f "/opencode-sandbox-config.yaml" ]]; then
    printf '/\n'
    return 0
  fi

  return 1
}

use_sandbox_root() {
  local detected_root

  detected_root="$(find_sandbox_root)" || {
    echo "No opencode-sandbox-config.yaml found in the current directory or any parent directory of $(pwd)." >&2
    echo "Run ocs-init from your project root to initialize the sandbox first." >&2
    return 1
  }

  refresh_root_paths "${detected_root}"
}

print_sandbox_dir() {
  echo ">> using sandbox directory: ${OPENCODE_SANDBOX_DIR}"
}

refresh_root_paths "${ROOT_DIR}"

# Container runtime: prefer docker, fall back to podman
if command -v docker >/dev/null 2>&1; then
  CONTAINER_RUNTIME=docker
elif command -v podman >/dev/null 2>&1; then
  CONTAINER_RUNTIME=podman
else
  echo "Neither docker nor podman found in PATH." >&2
  exit 1
fi

# Network configuration
PORT=4096
LOCALHOST=127.0.0.1

open_url() {
  local url="${1:?URL is required}"
  local opener
  local -a openers

  case "$(uname -s)" in
    Darwin)
      openers=(open)
      ;;
    Linux)
      openers=(xdg-open open)
      ;;
    *)
      openers=(open xdg-open)
      ;;
  esac

  for opener in "${openers[@]}"; do
    if command -v "${opener}" >/dev/null 2>&1; then
      "${opener}" "${url}"
      return 0
    fi
  done

  echo "Could not find a supported browser opener. Install xdg-open or open the URL manually: ${url}" >&2
  return 1
}