action.yml

name: bqschema
description: Gate BabelQueue per-URN schema changes in CI — validate the registry and lint backward-compatibility (versioning-policy §3)
author: muhammetsafak
branding:
  icon: git-merge
  color: blue

inputs:
  version:
    description: bqschema version to install (a release tag like "v0.1.0", or "latest")
    required: false
    default: latest
  command:
    description: bqschema subcommand to run — "check" (registry self-validation), "validate", "compat", or "export-asyncapi"
    required: false
    default: check
  registry:
    description: Path to the registry.json manifest (used by check/validate/export-asyncapi)
    required: false
    default: registry.json
  dir:
    description: Working directory to run bqschema in (registry paths resolve relative to this)
    required: false
    default: "."
  args:
    description: >-
      Extra arguments appended verbatim after the subcommand, for cases the typed inputs do not cover
      (e.g. `compat`'s two positional <old> <new> schema files, or `validate`'s envelope files).
      When set, this is the escape hatch — `registry` is still passed for check/validate/export-asyncapi.
    required: false
    default: ""

runs:
  using: composite
  steps:
    - uses: actions/setup-go@v5
      with:
        go-version: stable

    - shell: bash
      run: go install github.com/babelqueue/babelqueue-registry/cmd/bqschema@${{ inputs.version }}

    # bqschema exits non-zero on a gate failure (1 = breaking change / validation failure,
    # 2 = usage or IO error), so a failing schema change fails the step and blocks the merge.
    # `compat` takes two positional schema files — pass them via `args`; `registry` is ignored there.
    - shell: bash
      working-directory: ${{ inputs.dir }}
      run: |
        cmd="${{ inputs.command }}"
        case "$cmd" in
          compat)
            bqschema "$cmd" ${{ inputs.args }}
            ;;
          *)
            bqschema "$cmd" --registry "${{ inputs.registry }}" ${{ inputs.args }}
            ;;
        esac