check_api_updates.yml

name: Check MTProto API Schema Updates

on:
  schedule:
    - cron: '0 */12 * * *'
  workflow_dispatch:
    inputs:
      force_update:
        description: 'Force update even if no changes detected'
        required: false
        default: false
        type: boolean

jobs:
  check-schema-updates:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write

    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          ref: ${{ github.ref }}

      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
          cache: 'pip'

      - name: Install dependencies
        run: |
          pip install requests

      - name: Check for API schema updates
        id: check-updates
        run: |
          # Allow the check script to exit with non-zero codes without failing the whole step
          # (the script returns 0 when updates found, 2 when no updates, other codes indicate errors)
          set +e
          FORCE_UPDATE=""
          if [[ "${{ github.event_name }}" == "workflow_dispatch" && "${{ github.event.inputs.force_update }}" == "true" ]]; then
            FORCE_UPDATE="--force-update"
          fi

          python dev_tools/check_api_schema_updates.py $FORCE_UPDATE
          EXIT_CODE=$?
          # Re-enable "exit on error" for the remainder of the step
          set -e

          if [ $EXIT_CODE -eq 0 ]; then
            echo "updates_detected=true" >> $GITHUB_OUTPUT
            CURRENT_LAYER=$(grep -oP "// LAYER \K\d+" compiler/api/source/main_api.tl || echo "Unknown")
            echo "layer_version=$CURRENT_LAYER" >> $GITHUB_OUTPUT
          elif [ $EXIT_CODE -eq 2 ]; then
            # No updates detected — set output and continue (do NOT fail the job)
            echo "updates_detected=false" >> $GITHUB_OUTPUT
          else
            echo "Error checking for updates"
            exit 1
          fi

      - name: Set up Git config
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          git config --global user.name "github-actions[bot]"
          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"

      - name: Check existing PR and branch
        if: steps.check-updates.outputs.updates_detected == 'true'
        id: check-pr
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          BRANCH_NAME="update/mtproto-api-updates"

          # Fetch to check remote branches
          git fetch origin

          # Check if remote branch exists
          if git ls-remote --heads origin $BRANCH_NAME | grep -q $BRANCH_NAME; then
            echo "branch_exists=true" >> $GITHUB_OUTPUT
          else
            echo "branch_exists=false" >> $GITHUB_OUTPUT
          fi

          # Check if there's an open PR for this branch
          PR_NUMBER=$(gh pr list --head "$BRANCH_NAME" --state open --json number -q '.[0].number' || echo "")

          if [ -n "$PR_NUMBER" ]; then
            echo "existing_pr=true" >> $GITHUB_OUTPUT
            echo "pr_number=$PR_NUMBER" >> $GITHUB_OUTPUT
          else
            echo "existing_pr=false" >> $GITHUB_OUTPUT
          fi

      - name: Create API update news entry
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          LAYER_VERSION="${{ steps.check-updates.outputs.layer_version }}"
          TIMESTAMP=$(date +"%Y%m%d%H%M%S")
          NEWS_FILE="news/${TIMESTAMP}.misc.rst"

          mkdir -p news

          echo "API Layer Update" > $NEWS_FILE
          echo "================" >> $NEWS_FILE
          echo "" >> $NEWS_FILE
          echo "Updated MTProto API schema to Layer $LAYER_VERSION." >> $NEWS_FILE

      - name: Install package dependencies
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          pip install -e .

      - name: Compile API
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          python -m compiler.api.compiler

      - name: Compile errors
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          python -m compiler.errors.compiler

      - name: Create or update branch and commit changes
        if: steps.check-updates.outputs.updates_detected == 'true'
        run: |
          LAYER_VERSION="${{ steps.check-updates.outputs.layer_version }}"
          BRANCH_NAME="update/mtproto-api-updates"
          BASE_BRANCH="${{ github.event.repository.default_branch }}"

          # Create or reset branch based on default branch
          git checkout -B $BRANCH_NAME origin/$BASE_BRANCH

          # Add all changed and new files
          git add -A compiler/api/source/main_api.tl
          git add -A hydrogram/raw/
          git add -A hydrogram/errors/
          git add -A news/
          
          # Check if there are changes to commit
          if git diff --staged --quiet; then
            echo "No changes to commit"
            exit 1
          fi
          
          git commit -m "Update MTProto API schema to Layer ${LAYER_VERSION}"

          # Force push to create or update the branch
          git push --force --set-upstream origin $BRANCH_NAME

      - name: Create Pull Request
        if: steps.check-updates.outputs.updates_detected == 'true' && steps.check-pr.outputs.existing_pr == 'false'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          LAYER_VERSION="${{ steps.check-updates.outputs.layer_version }}"
          BRANCH_NAME="update/mtproto-api-updates"
          BASE_BRANCH="${{ github.event.repository.default_branch }}"
          PR_TITLE="Update MTProto API schema"
          PR_BODY="This PR automatically updates the MTProto API schema to Layer ${LAYER_VERSION}.\n\n- Updated main schema file\n- Recompiled raw and errors modules\n- Created news entry for changelog"

          gh pr create \
            --title "$PR_TITLE" \
            --body "$PR_BODY" \
            --base "$BASE_BRANCH" \
            --head "$BRANCH_NAME" \
            --label "enhancement" \
            --label "automated"

      - name: Update Pull Request Title and Description
        if: steps.check-updates.outputs.updates_detected == 'true' && steps.check-pr.outputs.existing_pr == 'true'
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          LAYER_VERSION="${{ steps.check-updates.outputs.layer_version }}"
          PR_NUMBER="${{ steps.check-pr.outputs.pr_number }}"
          PR_TITLE="Update MTProto API schema"
          PR_BODY="This PR automatically updates the MTProto API schema to Layer ${LAYER_VERSION}.\n\n- Updated main schema file\n- Recompiled raw and errors modules\n- Created news entry for changelog"

          gh pr edit $PR_NUMBER --title "$PR_TITLE" --body "$PR_BODY"

          PR_COMMENT="Updated the MTProto API schema to Layer ${LAYER_VERSION}.\n\n- Updated main schema file\n- Recompiled raw and errors modules\n- Added new news entry for changelog"
          gh pr comment $PR_NUMBER --body "$PR_COMMENT"