bump-version-flutter-lib.yml

name: bump version / flutter lib

on:
  workflow_call:
    inputs:
      level:
        description: Bump level
        required: true
        type: string
    secrets:
      APP_ID:
        description: GitHub App installation ID
        required: true
      APP_PRIVATE_KEY:
        description: GitHub App private key
        required: true

jobs:
  prepare_next_release:
    name: prepare next release
    runs-on: ubuntu-latest
    steps:
      - name: Validate bump level
        env:
          INPUTS_LEVEL: ${{ inputs.level }}
        run: |
          case "${INPUTS_LEVEL}" in
            major|minor|patch) ;;
            *)
              echo "::error::Invalid level '${INPUTS_LEVEL}' (expected major, minor, or patch)."
              exit 1
              ;;
          esac

      - id: generate_token
        name: Generate a GitHub App token
        uses: tibdex/github-app-token@3beb63f4bd073e61482598c45c71c1019b59b73a
        with:
          app_id: ${{ secrets.APP_ID }}
          private_key: ${{ secrets.APP_PRIVATE_KEY }}

      - name: Checkout source code
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
        with:
          token: ${{ steps.generate_token.outputs.token }}
          ref: main
          fetch-depth: 0
          persist-credentials: false

      - name: Add Toolbox Envy to PATH
        uses: EarthmanMuons/toolbox-envy/.github/actions/add-to-path@main
        with:
          include_bins: |
            common
            flutter

      - name: Configure Git identity
        run: |
          git config user.name "senile-errata[bot]"
          git config user.email "senile-errata@users.noreply.github.com"

      - name: Set up Flutter
        uses: subosito/flutter-action@fd55f4c5af5b953cc57a2be44cb082c8f6635e8e
        with:
          channel: stable
          flutter-version-file: pubspec.yaml
          cache: true

      - name: Install dependencies
        run: flutter pub get --enforce-lockfile

      - name: Update dependencies
        run: flutter pub upgrade --unlock-transitive

      - name: Bump ${{ inputs.level }} version for project
        env:
          INPUTS_LEVEL: ${{ inputs.level }}
        run: |
          get-project-version | bump-semver --"${INPUTS_LEVEL}" | set-project-version

      - name: Bump CHANGELOG version to match
        run: get-project-version | bump-changelog-version

      - name: Fix up CHANGELOG formatting
        run: npx --yes prettier@latest --color --prose-wrap always --write -- **/CHANGELOG.md

      - name: Rotate unreleased whatsnew docs into release directory
        run: get-project-version | rotate-whatsnew

      - id: version
        name: Get the new release version
        run: |
          echo "release_version=$(get-project-version)" >>"$GITHUB_OUTPUT"

      - id: cpr
        name: Create pull request
        uses: peter-evans/create-pull-request@c0f553fe549906ede9cf27b5156039d195d2ece0
        with:
          token: ${{ steps.generate_token.outputs.token }}
          branch: release/bump-version
          branch-suffix: timestamp
          commit-message: Release v${{ steps.version.outputs.release_version }}
          title: Prepare the v${{ steps.version.outputs.release_version }} ${{ inputs.level }} release
          body: |-
            This PR was automatically created by the [bump-version](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) workflow, which ran the following commands:


            ```
            $ flutter pub upgrade --unlock-transitive
            $ get-project-version | bump-semver --${{ inputs.level }} | set-project-version
            $ get-project-version | bump-changelog-version
            $ get-project-version | rotate-whatsnew
            ```

            **Please review the submitted changes.**

            Once this PR is merged into the _main_ branch, an automated process will tag the commit and create a draft GitHub Release with signed assets attached for final review before publishing.

      - name: Annotate workflow run with PR URL
        env:
          INPUTS_LEVEL: ${{ inputs.level }}
          STEPS_VERSION_OUTPUTS_RELEASE_VERSION: ${{ steps.version.outputs.release_version }}
          STEPS_CPR_OUTPUTS_PULL_REQUEST_URL: ${{ steps.cpr.outputs.pull-request-url }}
        run: |
          set -euo pipefail
          {
          echo "### :shipit: Opened pull request for ${INPUTS_LEVEL} release v${STEPS_VERSION_OUTPUTS_RELEASE_VERSION}"
          echo
          echo "- ${STEPS_CPR_OUTPUTS_PULL_REQUEST_URL}"
          } >>"$GITHUB_STEP_SUMMARY"