action.yaml

name: "Lint and Validate OpenAPI v2 Spec"
description: "Lint and validate an OpenAPI v2 (Swagger) specification using Spectral and Swagger CLI"
inputs:
  apim-env:
    description: "APIM environment for constructing the spec"
    required: true

runs:
  using: "composite"
  steps:
    - name: Set up Node.js
      uses: actions/setup-node@v4
      with:
        node-version: "20"

    - name: Install system dependencies
      shell: bash
      run: |
        sudo apt-get update
        sudo apt-get install -y make

    - name: Install CLI tools locally
      shell: bash
      run: |
        npm ci

    - name: Construct OpenAPI Spec
      shell: bash
      run: |
        make construct-spec APIM_ENV=${{ inputs.apim-env }}

    - name: Lint OpenAPI Spec with Spectral
      shell: bash
      run: |
        npx spectral lint --ruleset .spectral.yaml build/specification/${{ inputs.apim-env }}/eligibility-signposting-api.yaml

    - name: Validate OpenAPI Spec with Swagger CLI
      shell: bash
      run: |
        npx swagger-cli validate build/specification/${{ inputs.apim-env }}/eligibility-signposting-api.yaml