sync-api-docs.yml

name: Sync API Docs
on:
  push:
    paths:
      - "docs/**"
      - "!docs/utils-reference/**"
    branches: ["main"]

jobs:
  push-api-docs-to-upstream:
    if: github.repository == 'raycast/extensions'
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 2

      - name: Setup Node.js
        uses: raycast/github-actions/setup-node@master

      - name: Get changed files in the docs folder
        id: changed-files
        uses: tj-actions/changed-files@v42
        with:
          files: |
            docs/**
            !docs/.config.json
            !docs/utils-reference/**

      - name: Setup git
        uses: raycast/github-actions/setup-git@master

      - name: Update the docs in the main repo
        if: steps.changed-files.outputs.any_changed == 'true' || steps.changed-files.outputs.any_deleted == 'true'
        id: commit
        env:
          API_TOKEN_GITHUB: ${{ secrets.RAYCAST_BOT_API_ACCESS_TOKEN }}
        run: |
          ###########################
          # sync docs
          ###########################

          echo "🛠️ Syncing to main repo..."

          cd ${{ github.workspace }}

          git clone --depth=1 --single-branch --branch "master" "https://$API_TOKEN_GITHUB@github.com/raycast/raycast-macos.git" "raycast-macos"

          for file in ${{ steps.changed-files.outputs.deleted_files }}; do
            echo "Removing raycast-macos/Commands/$file"
            # If it's already removed, that's ok
            rm "raycast-macos/Commands/$file" || true
          done

          for file in ${{ steps.changed-files.outputs.all_changed_files }}; do
            echo "Updating raycast-macos/Commands/$file"
            # If this fails, it's because there is a space in the filename
            # so it's from GitBook messing things up. Ignore it
            rsync -arv "$file" "raycast-macos/Commands/$file" || true
          done

          cd raycast-macos

          if [[ $(git diff --stat) != '' ]]; then
            git checkout -b docs-sync-${{ github.sha }}
            git add .
            git commit -m 'API Docs: Update from the extensions repo'
            git push origin docs-sync-${{ github.sha }}
            echo 'has_commit=true' >> $GITHUB_OUTPUT
          else
            echo 'No changes'
            echo 'has_commit=false' >> $GITHUB_OUTPUT
          fi

      - name: Open PR on the main repo
        uses: actions/github-script@v7
        if: steps.commit.outputs.has_commit == 'true'
        with:
          github-token: ${{ secrets.RAYCAST_BOT_API_ACCESS_TOKEN }}
          script: |
            github.rest.pulls.create({
              owner: 'raycast',
              repo: 'raycast-macos',
              head: 'docs-sync-${{ github.sha }}',
              base: 'master',
              title: 'API Docs: Update from the extensions repo'
            })

      - name: Notify Failure to Slack
        if: failure()
        uses: raycast/github-actions/slack-send@master
        with:
          webhook: ${{ secrets.SLACK_RELEASE_CHANNEL_WEBHOOK_URL }}
          color: "danger"
          text: |
            :no_entry_sign: ${env.GITHUB_WORKFLOW} has failed
            <${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}|Action logs> | <${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/commit/${ env.GITHUB_SHA }|Commit: ${ env.GITHUB_SHA.substr(0,8) }>