@api-now/cli 1.13.3 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +21 -0
  2. package/dist/index.js +98 -34
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -313,6 +313,27 @@ apinow api read --file <file_id> [--org <org_id>]
313
313
  apinow api read --file <file_id> --media [--org <org_id>]
314
314
  ```
315
315
 
316
+ #### Generate OpenAPI Specification (`api oas`)
317
+
318
+ Generate an OpenAPI Specification (OAS 3.1) from an API model (live cloud model, local schema file, or STDIN).
319
+
320
+ ```bash
321
+ # Generate OAS from a remote API model file (automatically resolves Data Domain from Data Catalog)
322
+ apinow api oas --file <file_id> [--org <org_id>]
323
+
324
+ # Generate OAS with custom server URL(s)
325
+ apinow api oas <file_id> --server https://api.example.com/v1
326
+
327
+ # Generate OAS from local files
328
+ apinow api oas ./api.json --domain ./domain.json
329
+
330
+ # Generate OAS from schema piped via STDIN
331
+ cat ./api.json | apinow api oas --stdin --domain ./domain.json
332
+
333
+ # Save OAS output directly to a file
334
+ apinow api oas <file_id> -o ./openapi.json
335
+ ```
336
+
316
337
  ### 7. Schema Validation (`validate`)
317
338
 
318
339
  Validate local or remote Data Domain and API Model schemas against syntax, modeling rules, and naming conventions.