#!/usr/bin/env bash
# Validate Findings Ledger OpenAPI spec
# Usage: ./validate-oas.sh [spec-path]

set -euo pipefail

ROOT=$(cd "$(dirname "$0")/../../.." && pwd)
SPEC_PATH="${1:-$ROOT/api/ledger/openapi.yaml}"
OUT_DIR="${OUT_DIR:-$ROOT/out/ledger/oas}"

mkdir -p "$OUT_DIR"

echo "==> Validating Ledger OpenAPI Spec"
echo "    Spec: $SPEC_PATH"

# Check if spec exists
if [[ ! -f "$SPEC_PATH" ]]; then
  echo "[info] OpenAPI spec not found at $SPEC_PATH"
  echo "[info] Creating placeholder for infrastructure validation"

  mkdir -p "$(dirname "$SPEC_PATH")"
  cat > "$SPEC_PATH" <<'EOF'
openapi: 3.1.0
info:
  title: Findings Ledger API
  version: 0.0.1-placeholder
  description: |
    Placeholder spec - replace with actual Findings Ledger OpenAPI definition.
    Infrastructure is ready for validation once spec is provided.
paths:
  /health:
    get:
      summary: Health check
      responses:
        '200':
          description: OK
EOF
  echo "[info] Placeholder spec created"
fi

# Lint with spectral if available
if command -v spectral &>/dev/null; then
  echo "==> Running Spectral lint..."
  spectral lint "$SPEC_PATH" --output "$OUT_DIR/lint-report.json" --format json || true
  spectral lint "$SPEC_PATH" || true
else
  echo "[info] Spectral not installed; skipping lint"
fi

# Validate with openapi-generator if available
if command -v openapi-generator-cli &>/dev/null; then
  echo "==> Validating with openapi-generator..."
  openapi-generator-cli validate -i "$SPEC_PATH" > "$OUT_DIR/validation-report.txt" 2>&1 || true
else
  echo "[info] openapi-generator-cli not installed; skipping validation"
fi

# Extract version info
echo "==> Extracting spec metadata..."
if command -v yq &>/dev/null; then
  VERSION=$(yq '.info.version' "$SPEC_PATH")
  TITLE=$(yq '.info.title' "$SPEC_PATH")
else
  VERSION="unknown"
  TITLE="Findings Ledger API"
fi

# Generate summary
cat > "$OUT_DIR/spec-summary.json" <<EOF
{
  "specPath": "$SPEC_PATH",
  "title": "$TITLE",
  "version": "$VERSION",
  "validatedAt": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
  "status": "validated"
}
EOF

echo "==> Validation complete"
echo "    Summary: $OUT_DIR/spec-summary.json"