publish.yml

name: Publish to Hex.pm

on:
  release:
    types: [published]

permissions:
  contents: read

env:
  ELIXIR_VERSION: "1.19.4"
  OTP_VERSION: "28"

jobs:
  publish:
    name: Publish to Hex.pm
    runs-on: ubuntu-latest

    steps:
      - name: Checkout code
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

      - name: Set up Elixir
        uses: erlef/setup-beam@5304e04ea2b355f03681464e683d92e3b2f18451 # v1.18.2
        with:
          elixir-version: ${{ env.ELIXIR_VERSION }}
          otp-version: ${{ env.OTP_VERSION }}

      - name: Install dependencies
        run: mix deps.get

      - name: Validate release tag format
        run: |
          if ! [[ "$GITHUB_REF_NAME" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
            echo "::error::Invalid release tag format: $GITHUB_REF_NAME (expected: vX.Y.Z or vX.Y.Z-suffix)"
            exit 1
          fi

      - name: Verify version tag matches mix.exs
        run: |
          # Extract version from GitHub release tag (v0.1.0 -> 0.1.0)
          TAG_VERSION="${GITHUB_REF_NAME#v}"

          # Extract version from mix.exs
          MIX_VERSION=$(grep -oP '@version "\K[^"]+' mix.exs)

          echo "Tag version: $TAG_VERSION"
          echo "mix.exs version: $MIX_VERSION"

          if [ "$TAG_VERSION" != "$MIX_VERSION" ]; then
            echo "::error::Version mismatch! Tag ($TAG_VERSION) does not match mix.exs ($MIX_VERSION)"
            exit 1
          fi

          echo "Version verified successfully: $MIX_VERSION"

      - name: Run tests before publish
        env:
          MIX_ENV: test
        run: mix test

      - name: Build documentation
        run: mix docs

      - name: Publish to Hex.pm
        env:
          HEX_API_KEY: ${{ secrets.HEX_API_KEY }}
        run: mix hex.publish --yes