Add ci checks for api [WIP]

.circleci/config.yml

@@ -11,13 +11,27 @@ jobs:
       - checkout
 
       - run:
-          name: install
+          name: install json-spec
           command: |
             cd json-spec
             npm install
 
       - run:
-          name: validate
+          name: install api-spec
+          command: |
+            cd api-spec
+            npm install
+
+      - run:
+          name: validate api-spec
+          command: |
+            cd api-spec
+            npm run generate-all
+            git diff-index HEAD --
+            if git diff-index HEAD -- | grep -q -e yaml; then echo "the main yaml files are not auto-generated"; exit 1; fi
+
+      - run:
+          name: validate json-spec
           command: |
             cd json-spec
             echo 'doing nothing'

.gitignore

@@ -35,6 +35,7 @@ build/Release
 # Dependency directories
 node_modules/
 jspm_packages/
+package-lock.json
 
 # Typescript v1 declaration files
 typings/

api-spec/README.md

@@ -72,4 +72,15 @@ for a GET endpoint, which are included in the openapi specifications. The GET re
 fields as the POST fields, and are based on WFS 3 requests. It is recommended for implementations to implement both, but 
 only POST is required. 
 
+## Development & Contribution
 
+The yaml files under `api-spec` directory are generated from yaml files under `defintions` and `extensions` folders. Do **NOT** edit them directly.
+
+All edits should be applied to files under `defintions` and `extensions` folder.
+
+To generate the main yaml files, run:
+
+     $ npm install
+     $ npm run generate-all
+
+There is CI check to make sure correct yaml files are generated. The CI build will fail if you forget to generate and commit and main yaml files.

api-spec/STAC-query.yaml

@@ -41,7 +41,6 @@ paths:
       operationId: getSearchSTAC
       tags:
         - STAC
-        - STAC
       parameters:
         - $ref: '#/components/parameters/bbox'
         - $ref: '#/components/parameters/time'