update-version-table.yml

# This workflow is always run from main.
# Automated trigger: beamable/BeamableProduct fires a repository_dispatch
# event (type: unity-sdk-released) when a unity-sdk-X.Y.Z release tag is
# pushed. Use workflow_dispatch below for manual runs and testing.

name: Update SDK/CLI Version Table

on:
  repository_dispatch:
    types: [unity-sdk-released]
  workflow_dispatch:
    inputs:
      _note:
        description: >
          Manual trigger. Normally fired automatically by beamable/BeamableProduct
          on unity-sdk-X.Y.Z release tag pushes. Always run from main.
        required: false
        default: ''

jobs:
  update:
    name: Update table on ${{ matrix.branch }}
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    strategy:
      matrix:
        branch: [unity/v5.0, unity/v5.1]
    concurrency:
      group: update-version-table-${{ matrix.branch }}
      cancel-in-progress: false

    steps:
      - name: Checkout ${{ matrix.branch }}
        uses: actions/checkout@v6
        with:
          ref: ${{ matrix.branch }}
          token: ${{ secrets.DOCS_PAT }}

      - name: Extract branch minor version
        id: branch
        run: |
          BRANCH="${{ matrix.branch }}"
          echo "minor=${BRANCH#unity/v}" >> $GITHUB_OUTPUT

      - name: Build full version table from BeamableProduct tags
        env:
          GH_TOKEN: ${{ github.token }}
        run: |
          # Fetch all release tags (exclude PREVIEW and RC builds), newest first
          gh api repos/beamable/BeamableProduct/tags \
            --paginate \
            --jq '.[].name' \
            | grep -E '^unity-sdk-[0-9]+\.[0-9]+\.[0-9]+$' \
            | sort -V -r \
            > /tmp/release-tags.txt

          echo "Release tags found:"
          cat /tmp/release-tags.txt

          # Fetch the CLI version pinned at each tag
          > /tmp/table-rows.txt
          while IFS= read -r tag; do
            sdk_version="${tag#unity-sdk-}"
            cli_version=$(gh api \
              "repos/beamable/BeamableProduct/contents/client/Packages/com.beamable/Runtime/Environment/Resources/versions-default.json?ref=${tag}" \
              --jq '.content' | base64 -d | jq -r '.nugetPackageVersion')
            echo "| ${sdk_version} | ${cli_version} |" >> /tmp/table-rows.txt
          done < /tmp/release-tags.txt

          echo "Generated table rows:"
          cat /tmp/table-rows.txt

      - name: Build condensed table
        env:
          CURRENT_MINOR: ${{ steps.branch.outputs.minor }}
        run: |
          python3 - <<'EOF'
          import os, pathlib

          current_minor = os.environ["CURRENT_MINOR"]
          seen_minors = set()
          condensed = []

          for line in pathlib.Path("/tmp/table-rows.txt").read_text().splitlines(keepends=True):
              parts = line.strip().split("|")
              if len(parts) < 3:
                  continue
              sdk_version = parts[1].strip()
              major_minor = ".".join(sdk_version.split(".")[:2])

              if major_minor == current_minor:
                  condensed.append(line)
              elif major_minor not in seen_minors:
                  seen_minors.add(major_minor)
                  condensed.append(line)

          pathlib.Path("/tmp/condensed-rows.txt").write_text("".join(condensed))
          EOF

      - name: Update installing-beamable.md
        run: |
          python3 - <<'EOF'
          import re, pathlib

          md = pathlib.Path("docs/unity/getting-started/installing-beamable.md")
          rows = pathlib.Path("/tmp/condensed-rows.txt").read_text().rstrip("\n")

          new_table = (
              "| SDK Version | CLI Version |\n"
              "| :---------- | :---------- |\n"
              + rows
          )

          text = md.read_text()
          updated = re.sub(
              r'\| SDK Version \| CLI Version \|.*?(?=\n\n)',
              new_table,
              text,
              flags=re.DOTALL
          )

          if updated == text:
              print("Table unchanged — no edit needed.")
          else:
              md.write_text(updated)
              print("Table updated.")
          EOF

      - name: Write sdk-cli-version-history.md
        run: |
          python3 - <<'EOF'
          import pathlib

          rows = pathlib.Path("/tmp/table-rows.txt").read_text().rstrip("\n")

          full_table = (
              "| SDK Version | CLI Version |\n"
              "| :---------- | :---------- |\n"
              + rows
          )

          content = (
              "# SDK/CLI Version History\n"
              "\n"
              "Every Beamable Unity SDK release and the Beam CLI version it requires.\n"
              "\n"
              "For installation instructions and a summary of current versions,\n"
              "see [Installing Beamable](./installing-beamable.md).\n"
              "\n"
              + full_table
              + "\n"
          )

          pathlib.Path("docs/unity/getting-started/sdk-cli-version-history.md").write_text(content)
          print("Version history page written.")
          EOF

      - name: Commit and push if changed
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          if git diff --quiet && git ls-files --others --exclude-standard docs/unity/getting-started/sdk-cli-version-history.md | grep -q .; then
            git add docs/unity/getting-started/sdk-cli-version-history.md
          fi
          git add docs/unity/getting-started/installing-beamable.md \
                  docs/unity/getting-started/sdk-cli-version-history.md 2>/dev/null || true
          if git diff --cached --quiet; then
            echo "No changes to commit."
          else
            git commit -m "Update SDK/CLI version table and history page"
            git push
          fi