refactor: remove Create API and implement per-API spec splitting

build-docs.sh

@@ -2,14 +2,17 @@
 
 DOCS_DIR=build/docs
 OAS3_YAML=api.oas3.yaml
-OAS3_JSON=api.oas3.json
+OAS3_JSON=$DOCS_DIR/api.bundled.json
 mkdir -p $DOCS_DIR
 
 # Validate OpenAPI 3.0 YAML
 ./node_modules/.bin/swagger-cli validate $OAS3_YAML
 
 # Resolve YAML files in to one master JSON file
-./node_modules/.bin/swagger-cli bundle -o $OAS3_JSON $OAS3_YAML
+./node_modules/.bin/swagger-cli bundle -o $OAS3_JSON $OAS3_YAML -t json
+
+# Split bundled spec into per-API JSON files (api.edit.json, api.serve.json, api.ingest.json)
+node scripts/split-by-api.cjs $OAS3_JSON $DOCS_DIR
 
 # Convert OpenAPI to doc to Shins Markdown
 ./node_modules/.bin/widdershins \
@@ -20,13 +23,9 @@ mkdir -p $DOCS_DIR
 
 cp $DOCS_DIR/index.html.md .shins/source/index.html.md
 
-# Replace Create, Serve, Ingest API URL's as overrides do not work
+# Replace Serve, Ingest API URL's as overrides do not work
 sed -i -e 's/https:\/\/api.shotstack.io\/edit\/{version}\/assets/https:\/\/api.shotstack.io\/serve\/{version}\/assets/g' .shins/source/index.html.md
 sed -i -e 's/https:\/\/api.shotstack.io\/edit\/{version}\/sources/https:\/\/api.shotstack.io\/ingest\/{version}\/sources/g' .shins/source/index.html.md
-sed -i -e 's/https:\/\/api.shotstack.io\/edit\/{version}\/createassets/https:\/\/api.shotstack.io\/create\/{version}\/assets/g' .shins/source/index.html.md
-
-# Openapi doesn't support duplicate path mapping
-sed -i -e 's/\/path_alias_createassets/\/assets/g' .shins/source/index.html.md
 
 # Build the Shins docs HTML
 cd .shins
@@ -51,4 +50,3 @@ if [ -f .tags ]; then
 fi
 
 rm -f ./$DOCS_DIR/index.html.md
-rm -f $OAS3_JSON

build-sdks.sh

@@ -101,13 +101,6 @@ $OPENAPI_GENERATOR generate -i $SPEC_FILE_JSON -g python -c $CONFIGS_DIR/python.
 printf "\n========================================= \n"
 printf "\nPython SDK Generated\n\n"
 
-# Openapi doesn't support duplicate path mapping
-sed -i -e 's/\/path_alias_createassets/\/assets/g' $BUILD_DIR/node/dist/api/CreateApi.js
-sed -i -e 's/\/path_alias_createassets/\/assets/g' $BUILD_DIR/typescript/api/createApi.ts
-sed -i -e 's/\/path_alias_createassets/\/assets/g' $BUILD_DIR/php/src/Api/CreateApi.php
-sed -i -e 's/\/path_alias_createassets/\/assets/g' $BUILD_DIR/python/shotstack_sdk/api/create_api.py
-sed -i -e 's/\/path_alias_createassets/\/assets/g' $BUILD_DIR/ruby/lib/shotstack/api/create_api.rb
-
 # Revert back to stable version
 $OPENAPI_GENERATOR version-manager set $OPENAPI_GENERATOR_VERSION_STABLE