name: respec

# author: @MikeRalphson, @ralfhandl
# issue: https://github.com/OAI/OpenAPI-Specification/issues/1564

#
# This workflow creates a pull request for publishing HTML spec versions to the spec.openapis.org site.
#

# run this manually from main
on:
  workflow_dispatch: {}

jobs:
  respec:
    if: github.ref == 'refs/heads/main'

    runs-on: ubuntu-latest

    steps:
      - name: Generate access token
        id: generate-token
        uses: actions/create-github-app-token@v2
        with:
          app-id: ${{ secrets.OAI_SPEC_PUBLISHER_APPID }}
          private-key: ${{ secrets.OAI_SPEC_PUBLISHER_PRIVATE_KEY }}
          owner: OAI
          repositories: spec.openapis.org

      - uses: actions/checkout@v6 # checkout main branch of this repo
        with:
          fetch-depth: 0

      - uses: actions/setup-node@v6 # setup Node.js
        with:
          node-version: "22.x"

      - name: Install dependencies
        run: npm ci

      - uses: actions/checkout@v6 # checkout main branch of website repo
        with:
          token: ${{ steps.generate-token.outputs.token }}
          repository: OAI/spec.openapis.org
          ref: main
          path: deploy

      - name: run main script
        run: scripts/md2html/build.sh

      - name: Create Pull Request
        uses: peter-evans/create-pull-request@v8
        with:
          token: ${{ steps.generate-token.outputs.token }}
          branch: openapi-spec-versions
          base: main
          delete-branch: true
          path: deploy
          labels: OpenAPI,Specification
          reviewers: earth2marsh,lornajane,mikekistler,miqui,ralfhandl,whitlockjc,handrews,karenetheridge
          title: OpenAPI - update ReSpec-rendered specification versions
          commit-message: Update ReSpec-rendered specification versions
          signoff: true
          body: |
            This pull request is automatically generated by GitHub action `respec` in the OAI/OpenAPI-Specification repo.

            The `versions/*.md` files of the OpenAPI Specification have changed and the corresponding HTML files are regenerated.