DRAFT: Showcasing changes for exposing npm cli with flattening transformation logic

package.json

@@ -0,0 +1,20 @@
+{
+  "name": "atlas-sdk-go-tools",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Root package to expose the transformer CLI for npx usage",
+  "bin": {
+    "atlas-openapi-transformer": "tools/transformer/src/cli.js"
+  },
+  "dependencies": {
+    "simple-node-logger": "^21.8.12",
+    "yaml": "2.8.1",
+    "yargs": "^17.7.2"
+  },
+  "engines": {
+    "node": ">= 16",
+    "npm": ">= 8"
+  }
+}
+
+

tools/README.md

@@ -18,6 +18,21 @@ Typically a SDK is generated by:
 - `releaser` - release automation scripts and documentation
 - `transformer` - OpenAPI transformation engine and it's documentation
 
+### Transformer CLI usage
+
+The transformer is also available as a CLI for local use:
+
+```bash
+# Full transform (in-place)
+node ./transformer/bin/atlas-openapi-transformer.js transform -i ../openapi/atlas-api-transformed.yaml
+
+# Flatten-only, reading from stdin and writing to stdout
+cat ../openapi/atlas-api.yaml | node ./transformer/bin/atlas-openapi-transformer.js flatten --stdin --stdout > ../openapi/atlas-api-flattened.yaml
+
+# Adjust log level
+node ./transformer/bin/atlas-openapi-transformer.js transform -i ../openapi/atlas-api-transformed.yaml --log-level info
+```
+
 ## SDK Generation Workflow
 
 ```mermaid

tools/package.json

@@ -4,9 +4,13 @@
   "version": "0.1.0",
   "private": "true",
   "main": "transformer/src/index.js",
+  "bin": {
+    "atlas-openapi-transformer": "./transformer/src/cli.js"
+  },
   "dependencies": {
     "simple-node-logger": "^21.8.12",
-    "yaml": "2.8.1"
+    "yaml": "2.8.1",
+    "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@openapitools/openapi-generator-cli": "2.24.0",
@@ -15,7 +19,8 @@
     "prettier": "3.6.2"
   },
   "scripts": {
-    "sdk:transform": "node ./transformer/src/transform",
+    "sdk:transform": "node ./transformer/src/cli.js transform",
+    "sdk:flatten": "node ./transformer/src/cli.js flatten",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "test": "jest **/__tests__/**.test.js",

tools/scripts/transform.sh

@@ -19,4 +19,4 @@ echo "# Running transformation from $transformed_file OpenAPI from $OPENAPI_FILE
 cp "$OPENAPI_FOLDER/$OPENAPI_FILE_NAME" "$openapiFileLocation"
 
 npm install
-npm run sdk:transform -- "$openapiFileLocation"
+npx atlas-openapi-transformer transform --input "$openapiFileLocation"