@axiomify/cli 6.0.0 → 6.2.0

package/README.md

@@ -1,6 +1,5 @@
 # @axiomify/cli
 
-
 [![npm version](https://img.shields.io/npm/v/@axiomify/cli.svg)](https://npmjs.com/package//@axiomify/cli)
 [![codecov](https://codecov.io/github/otopman/axiomify/graph/badge.svg)](https://codecov.io/github/otopman/axiomify)
 [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/OTopman/axiomify/badge)](https://securityscorecards.dev/viewer/?uri=github.com/OTopman/axiomify)
@@ -23,20 +22,21 @@ the same major as your `@axiomify/*` runtime packages.
 
 ## Commands at a glance
 
-| Command | Purpose |
-|---|---|
-| `axiomify init [directory]` | Bootstrap a new project |
-| `axiomify dev [entry]` | Hot-reload dev server (esbuild watch) |
-| `axiomify build [entry]` | Compile a production bundle to `dist/` |
-| `axiomify routes [entry]` | Inspect every HTTP + WebSocket route |
-| `axiomify openapi [entry]` | Generate the OpenAPI 3.0.3 spec |
-| `axiomify check [entry]` | Static production-readiness audit |
-| `axiomify doctor` | Diagnose the host environment |
+| Command                     | Purpose                                          |
+| --------------------------- | ------------------------------------------------ |
+| `axiomify init [directory]` | Bootstrap a new project                          |
+| `axiomify dev [entry]`      | Hot-reload dev server (esbuild watch)            |
+| `axiomify build [entry]`    | Compile a production bundle to `dist/`           |
+| `axiomify routes [entry]`   | Inspect every HTTP + WebSocket route             |
+| `axiomify openapi [entry]`  | Generate the OpenAPI 3.0.3 spec                  |
+| `axiomify check [entry]`    | Static production-readiness audit                |
+| `axiomify doctor`           | Diagnose the host environment                    |
+| `axiomify sdk <subcommand>` | Manage, generate, build, validate, and diff SDKs |
 
 `[entry]` defaults to `src/index.ts` everywhere it's accepted.
 
 For the full reference (flags, exit codes, CI examples), see
-[`[./docs/packages/cli.md](./docs/packages/cli.md)`](https://github.com/OTopman/axiomify/blob/main/docs/packages/cli.md).
+[`./docs/packages/cli.md`](https://github.com/OTopman/axiomify/blob/main/docs/packages/cli.md).
 
 ## `axiomify init`
 
@@ -65,7 +65,7 @@ hooks can drain, with a SIGKILL fallback after 3 seconds.
 
 ## `axiomify routes`
 
-Inspects the app *without* booting a listener. Prints a
+Inspects the app _without_ booting a listener. Prints a
 Unicode-bordered table with colour-coded HTTP methods, validation
 badges, OpenAPI tags + `operationId`, plugin count, timeout, and
 deprecation marker.
@@ -144,14 +144,40 @@ alignment, uWS bindings load successfully, recent build artefact, port
 Run on a fresh clone or new CI runner before chasing test failures that
 turn out to be Node-version mismatches.
 
+## `axiomify sdk`
+
+Subcommands for compiling type-safe client SDKs from specs:
+
+```bash
+# Generate SDKs for TS, Python, and Go:
+axiomify sdk generate spec.json --target typescript python go -o ./sdks
+
+# Deep structural diff for breaking changes:
+axiomify sdk diff old-spec.json new-spec.json
+
+# Get client migration guidance:
+axiomify sdk migrate old-spec.json new-spec.json
+
+# Run generation hot-reloads on file change:
+axiomify sdk watch spec.json --target typescript python
+
+# Run local toolchain diagnostics:
+axiomify sdk doctor
+
+# Run compiler and emitter throughput benchmarks:
+axiomify sdk benchmark
+```
+
 ## CI example
 
 ```yaml
-- run: npx axiomify doctor    # environment sanity
-- run: npx axiomify check     # static readiness audit
+- run: npx axiomify doctor # environment sanity
+- run: npx axiomify check # static readiness audit
 - run: npx axiomify build
 - run: npx axiomify openapi -o ./openapi.json --spec-version "$GITHUB_SHA"
-- run: npx axiomify routes --json > routes.json   # surface snapshot
+- run: npx axiomify routes --json > routes.json # surface snapshot
+- run: npx axiomify sdk validate ./openapi.json # schema verification
+- run: npx axiomify sdk diff old-spec.json ./openapi.json # check breaking changes
 ```
 
 Diff `routes.json` between commits to detect accidental API changes

package/dist/{dist-SYWHGZLI.mjs → dist-IQQ2XGG4.mjs}

@@ -64,7 +64,8 @@ var OpenApiGenerator = class {
       if (s.callbacks) operation.callbacks = s.callbacks;
       const body = this.extractBody(route);
       if (body) {
-        if (s.requestBodyDescription) body.description = s.requestBodyDescription;
+        if (s.requestBodyDescription)
+          body.description = s.requestBodyDescription;
         operation.requestBody = body;
       }
       paths[openApiPath][method] = operation;
@@ -78,14 +79,23 @@ var OpenApiGenerator = class {
   extractParameters(route) {
     const parameters = [];
     if (route.schema?.params) {
-      const paramSchema = zodSchemaToOpenApi(route.schema.params);
+      const paramSchema = zodSchemaToOpenApi(
+        route.schema.params
+      );
       const properties = paramSchema.properties ?? {};
       for (const [key, prop] of Object.entries(properties)) {
-        parameters.push({ name: key, in: "path", required: true, schema: prop });
+        parameters.push({
+          name: key,
+          in: "path",
+          required: true,
+          schema: prop
+        });
       }
     }
     if (route.schema?.query) {
-      const querySchema = zodSchemaToOpenApi(route.schema.query);
+      const querySchema = zodSchemaToOpenApi(
+        route.schema.query
+      );
       const properties = querySchema.properties ?? {};
       const required = querySchema.required ?? [];
       for (const [key, prop] of Object.entries(properties)) {
@@ -129,11 +139,18 @@ var OpenApiGenerator = class {
     if (!route.schema?.body && !route.schema?.files) return void 0;
     const hasFiles = !!route.schema.files;
     const contentType = hasFiles ? "multipart/form-data" : "application/json";
-    let finalSchema = { type: "object", properties: {} };
+    let finalSchema = {
+      type: "object",
+      properties: {}
+    };
     if (route.schema.body) {
-      const bodySchema = zodSchemaToOpenApi(route.schema.body);
+      const bodySchema = zodSchemaToOpenApi(
+        route.schema.body
+      );
       if (bodySchema.type === "object") {
-        finalSchema.properties = { ...bodySchema.properties };
+        finalSchema.properties = {
+          ...bodySchema.properties
+        };
         if (bodySchema.required) finalSchema.required = bodySchema.required;
         if (bodySchema.additionalProperties !== void 0) {
           finalSchema.additionalProperties = bodySchema.additionalProperties;
@@ -155,7 +172,10 @@ var OpenApiGenerator = class {
       }
       finalSchema.properties = props;
     }
-    return { required: true, content: { [contentType]: { schema: finalSchema } } };
+    return {
+      required: true,
+      content: { [contentType]: { schema: finalSchema } }
+    };
   }
   extractResponses(route) {
     const descriptions = route.schema?.responseDescriptions ?? {};
@@ -195,7 +215,7 @@ function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
 function escapeJsString(s) {
-  return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+  return JSON.stringify(s).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
 function defineSecuritySchemes(schemes) {
   return {
@@ -325,7 +345,7 @@ function useOpenAPI(app, options) {
           <script>
             window.onload = () => {
               window.ui = SwaggerUIBundle({
-                url: '${escapeJsString(specUrl)}',
+                url: ${escapeJsString(specUrl)},
                 dom_id: '#swagger-ui',
               });
             };