#!/usr/bin/env bash
  #
  # @project       : Domuscan App
  # @filename      : libreria_backup.sh
  # @author        : Damiano | <dagneni@gmail.com>
  # @description   : Funzioni condivise da backup.sh e ripristino.sh: lettura del file .env con le
  #                  stesse regole di sorgenti/comune/configurazione.php, percorsi, credenziali del
  #                  database in un file temporaneo, blocco contro esecuzioni sovrapposte, log.
  #                  Da includere con: source "$(dirname "$0")/libreria_backup.sh"
  # @creation date : 13-11-2026
  # @last update   : 13-11-2026
  #
  # @version: 0.1.0
  #

RADICE_PROGETTO="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
declare -gA AMBIENTE=()

  #
  # @description: Toglie spazi, tabulazioni e ritorni a capo (CR) iniziali e finali
  # @param string $1 Testo
  # @return string Testo senza spazi esterni
  #
function rimuoviSpazi() {
  local testo="${1//$'\r'/}"
  testo="${testo#"${testo%%[![:space:]]*}"}"
  testo="${testo%"${testo##*[![:space:]]}"}"
  printf '%s' "$testo"
}

  #
  # @description: Carica un file .env nell'array AMBIENTE. Stesse regole di leggiFileAmbiente() in PHP:
  #               ignora righe vuote e commenti (#), separa al primo =, toglie gli apici esterni,
  #               non esegue espansioni (il file non viene mai eseguito con source).
  # @param string $1 Percorso del file .env
  # @return int 0 se caricato, 1 se il file manca o contiene una riga non valida
  #
function caricaFileAmbiente() {
  local file_ambiente="$1" riga nome valore numero_riga=0
  if [ ! -r "$file_ambiente" ]; then
    echo "File di configurazione non trovato: $file_ambiente" >&2
    return 1
  fi
  while IFS= read -r riga || [ -n "$riga" ]; do
    numero_riga=$((numero_riga + 1))
    riga=$(rimuoviSpazi "$riga")
    if [ -z "$riga" ] || [[ "$riga" == \#* ]]; then
      continue
    fi
    if [[ "$riga" != *=* ]]; then
      echo "Riga non valida nel file di configurazione: $numero_riga" >&2
      return 1
    fi
    nome=$(rimuoviSpazi "${riga%%=*}")
    valore=$(rimuoviSpazi "${riga#*=}")
    if ! [[ "$nome" =~ ^[A-Z][A-Z0-9_]*$ ]]; then
      echo "Nome di variabile non valido alla riga $numero_riga" >&2
      return 1
    fi
    if [ "${#valore}" -ge 2 ] && [[ "${valore:0:1}" == '"' || "${valore:0:1}" == "'" ]] \
      && [ "${valore: -1}" == "${valore:0:1}" ]; then
      valore="${valore:1:${#valore}-2}"
    fi
    AMBIENTE["$nome"]="$valore"
  done < "$file_ambiente"
  return 0
}

  #
  # @description: Restituisce un valore del file .env caricato
  # @param string $1 Nome della variabile
  # @param string $2 Valore predefinito se la variabile manca o è vuota (facoltativo)
  # @return string Valore della variabile
  #
function valoreAmbiente() {
  local valore="${AMBIENTE[$1]:-}"
  printf '%s' "${valore:-${2:-}}"
}

  #
  # @description: Converte un percorso della configurazione in assoluto, come percorsoAssoluto() in PHP:
  #               i percorsi relativi (es. ./dati/log) sono riferiti alla radice del progetto.
  #               Su Windows (Git Bash) i percorsi C:/... sono convertiti nel formato /c/...
  # @param string $1 Percorso assoluto o relativo
  # @return string Percorso assoluto, senza separatore finale
  #
function percorsoAssoluto() {
  local percorso="$1"
  if [[ "$percorso" =~ ^[A-Za-z]:[\\/] ]]; then
    if command -v cygpath > /dev/null 2>&1; then
      percorso=$(cygpath -u "$percorso")
    fi
  elif [[ "$percorso" != /* ]]; then
    percorso="$RADICE_PROGETTO/${percorso#./}"
  fi
  printf '%s' "${percorso%/}"
}

  #
  # @description: Converte un percorso per i programmi Windows nativi (mariadb, mariadb-dump),
  #               che non capiscono i percorsi /tmp/... di Git Bash. Su Linux lo lascia invariato.
  # @param string $1 Percorso
  # @return string Percorso utilizzabile dal programma
  #
function percorsoNativo() {
  if command -v cygpath > /dev/null 2>&1; then
    cygpath -m "$1"
  else
    printf '%s' "$1"
  fi
}

  #
  # @description: Restituisce il primo comando disponibile tra quelli indicati
  # @param string $@ Nomi dei comandi alternativi
  # @return string Nome del comando trovato (vuoto se nessuno)
  #
function primoComandoDisponibile() {
  local comando
  for comando in "$@"; do
    if command -v "$comando" > /dev/null 2>&1; then
      printf '%s' "$comando"
      return
    fi
  done
}

  #
  # @description: Scrive le credenziali del database in un file di opzioni MariaDB, così la password
  #               non compare tra gli argomenti dei processi (visibili con ps a tutti gli utenti)
  # @param string $1 Percorso del file da creare
  # @return void
  #
function scriviCredenzialiDatabase() {
  local file_credenziali="$1" password
  password=$(valoreAmbiente DB_PASSWORD)
  password="${password//\\/\\\\}"
  password="${password//\"/\\\"}"
  ( umask 077
    {
      echo "[client]"
      echo "host=$(valoreAmbiente DB_HOST 127.0.0.1)"
      echo "port=$(valoreAmbiente DB_PORTA 3306)"
      echo "user=$(valoreAmbiente DB_UTENTE)"
      echo "password=\"$password\""
      echo "default-character-set=utf8mb4"
    } > "$file_credenziali" )
}

  #
  # @description: Acquisisce il blocco contro esecuzioni sovrapposte, creando una cartella (operazione
  #               atomica su ogni filesystem, a differenza di flock non disponibile in Git Bash).
  #               Un blocco lasciato da un processo terminato viene rimosso.
  # @param string $1 Cartella del blocco
  # @return int 0 se acquisito, 1 se un'altra esecuzione è in corso
  #
function acquisisciBlocco() {
  local cartella_blocco="$1" pid_esistente
  if mkdir "$cartella_blocco" 2> /dev/null; then
    echo "$$" > "$cartella_blocco/pid"
    return 0
  fi
  pid_esistente=$(cat "$cartella_blocco/pid" 2> /dev/null)
  if [ -n "$pid_esistente" ] && kill -0 "$pid_esistente" 2> /dev/null; then
    return 1
  fi
  rm -rf "$cartella_blocco"
  mkdir "$cartella_blocco" 2> /dev/null || return 1
  echo "$$" > "$cartella_blocco/pid"
  return 0
}

  #
  # @description: Aggiunge una riga al log dei backup (PERCORSO_LOG/backup.log) e la stampa
  # @param string $1 Testo della riga
  # @return void
  #
function scriviLogBackup() {
  local cartella_log riga
  riga="$(date -u '+%Y-%m-%dT%H:%M:%SZ') $1"
  echo "$riga"
  cartella_log=$(percorsoAssoluto "$(valoreAmbiente PERCORSO_LOG ./dati/log)")
  mkdir -p "$cartella_log" 2> /dev/null && echo "$riga" >> "$cartella_log/backup.log"
}
