publish-docs.yml

name: Publish docs

on:
  workflow_dispatch:
  workflow_call:

jobs:
  docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        # Note: submodules and LFS not needed for docs generation
        # Doxygen only reads from include/, docs/, README.md, and examples/

      # Doxygen is available on ubuntu-latest, but we install explicitly for stability
      - name: Install Doxygen
        run: |
          sudo apt-get update
          sudo apt-get install -y doxygen graphviz

      - name: Build Docs (Doxygen)
        run: |
          doxygen docs/Doxyfile

      - name: S3 Upload
        run: |
          DOCS_DIR="html"
          if [[ ! -d "$DOCS_DIR" ]]; then
            echo "Expected docs at $DOCS_DIR but directory not found."
            exit 1
          fi

          # Upload to rolling latest (no versioned docs, always overwrite)
          aws s3 cp "$DOCS_DIR"/ s3://livekit-docs/client-sdk-cpp --recursive
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          AWS_DEFAULT_REGION: "us-east-1"

      - name: Invalidate cloudfront cache
        run: |
          aws cloudfront create-invalidation --distribution-id EJJ40KLJ3TRY9 --paths "/client-sdk-cpp/*"
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          AWS_DEFAULT_REGION: "us-east-1"