build: fix api-doc workflow and replace api-lint with spectral lint (#…

…569)

.github/workflows/api-doc.yml

@@ -18,8 +18,9 @@ name: api-doc
 
 env:
   API_TYPES: 'OAS'
-  API_DIRECTORIES: 'src/main/resources/swagger.api'
-  API_EXCLUDES: 'paths responses'
+  API_DIRECTORIES: 'target/api/openapi'
+  API_INPUT_SPEC: 'src/main/resources/swagger.api/mod-search.yaml'
+  API_EXCLUDES: ''
   OUTPUT_DIR: 'folio-api-docs'
   AWS_S3_BUCKET: 'foliodocs'
   AWS_S3_FOLDER: 'api'
@@ -28,6 +29,7 @@ env:
   AWS_S3_ACCESS_KEY: ${{ secrets.S3_SECRET_ACCESS_KEY }}
 
 on:
+  workflow_dispatch:
   push:
     branches: [ main, master ]
     paths:
@@ -43,6 +45,13 @@ jobs:
         with:
           ref: ${{ github.REF }}
           submodules: recursive
+      - name: Build spec
+        uses: s4u/[email protected]
+      - run: |
+          mvn openapi-generator:generate \
+          -Dopenapi.generator.maven.plugin.inputSpec=${{ env.API_INPUT_SPEC }} \
+          -Dopenapi.generator.maven.plugin.generatorName=openapi-yaml \
+          -Dopenapi.generator.maven.plugin.output=target/api
       - name: Prepare folio-tools
         run: |
           git clone https://github.com/folio-org/folio-tools
@@ -88,4 +97,3 @@ jobs:
           destination_prefix: ${{ env.AWS_S3_FOLDER }}
           delete: false
           quiet: false
-

.github/workflows/api-lint.yml

@@ -26,13 +26,13 @@ env:
   API_EXCLUDES: 'paths responses'
   API_WARNINGS: false
 
-on:
-  push:
-    paths:
-      - 'src/main/resources/swagger.api/**'
-  pull_request:
-    paths:
-      - 'src/main/resources/swagger.api/**'
+#on:
+#  push:
+#    paths:
+#      - 'src/main/resources/swagger.api/**'
+#  pull_request:
+#    paths:
+#      - 'src/main/resources/swagger.api/**'
 
 jobs:
   api-lint:

.github/workflows/api-schema-lint.yml

@@ -16,13 +16,13 @@ env:
   API_DIRECTORIES: 'src/main/resources/swagger.api'
   API_EXCLUDES: ''
 
-on:
-  push:
-    paths:
-      - 'src/main/resources/swagger.api/**'
-  pull_request:
-    paths:
-      - 'src/main/resources/swagger.api/**'
+#on:
+#  push:
+#    paths:
+#      - 'src/main/resources/swagger.api/**'
+#  pull_request:
+#    paths:
+#      - 'src/main/resources/swagger.api/**'
 
 jobs:
   api-schema-lint:

.github/workflows/spectral-lint.yml

@@ -1,7 +1,12 @@
 name: Run Spectral on Pull Requests
 
 on:
-  - pull_request
+  push:
+    paths:
+      - 'src/main/resources/swagger.api/**'
+  pull_request:
+    paths:
+      - 'src/main/resources/swagger.api/**'
 
 jobs:
   build: