@codewithagents/openapi-server 1.3.1 → 1.4.0

package/README.md

@@ -10,7 +10,7 @@
 Generate a typed service interface from your OpenAPI 3.x spec. Framework-agnostic by design: wire it to Hono, Express, Fastify, or any router you already use.
 
 - **Framework-agnostic service interface**: `service.ts` is a plain TypeScript interface with no framework imports. Implement it however you want: Hono, Express, Fastify, Koa, plain `http`, Bun, Deno, or anything else.
-- **Optional router scaffolding**: set `"framework": "hono"` and get a ready-to-mount Hono router as a starting point. Set `"framework": "none"` and wire the interface yourself. The generated code only ever imports what you already have.
+- **Optional router scaffolding**: set `"framework"` to `"hono"`, `"express"`, or `"fastify"` and get a ready-to-mount router as a starting point. Set `"framework": "none"` (the default) and wire the interface yourself. The generated code only ever imports what you already have.
 - **Type-safe contract**: the compiler tells you if your implementation drifts from the spec. Add an endpoint in the spec and forget to implement it. TypeScript fails the build.
 - **Prettier-clean output**: every generated file passes `prettier --check` out of the box.
 - **OpenAPI 3.x**: 3.1.x primary target, 3.0.x best-effort. Full support for `$ref`, `allOf`, `anyOf`, `oneOf`, `nullable`.
@@ -38,7 +38,7 @@ Requires [`@codewithagents/openapi-gen`](../openapi-gen). Run both generators to
 {
   "input_openapi": "./spec/api.json",
   "output": "./generated",
-  "framework": "hono"   // or "none" to skip the router and use any framework
+  "framework": "hono"   // or "express", "fastify", "none" (none = service.ts only, default)
 }
 ```
 
@@ -215,7 +215,7 @@ See the [full configuration reference](https://openapi.codewithagents.de/openapi
 {
   "input_openapi": "./spec/api.json",       // required: path to OpenAPI 3.x spec (JSON or YAML)
   "output": "./generated",                  // required: directory to write generated files
-  "framework": "hono",                      // optional: router target (default: "hono")
+  "framework": "hono",                      // optional: router target (default: "none")
   "input_schema": "./generated/schemas.ts"  // optional: Zod schema file for request validation
 }
 ```
@@ -224,7 +224,7 @@ See the [full configuration reference](https://openapi.codewithagents.de/openapi
 |---|---|---|---|
 | `input_openapi` | Yes | n/a | Path to OpenAPI 3.x spec |
 | `output` | Yes | n/a | Directory to write `service.ts` and `router.ts` |
-| `framework` | No | `"hono"` | Router framework to generate. Use `"none"` to generate only `service.ts` |
+| `framework` | No | `"none"` | Router framework to generate: `"hono"`, `"express"`, `"fastify"`, or `"none"`. Use `"none"` to generate only `service.ts` |
 | `input_schema` | No | none | Path to user-owned Zod schema file. Enables server-side request validation (see below) |
 
 Use `--config <path>` to point at a config file in a different location:

package/dist/cli-args.d.ts

@@ -0,0 +1,23 @@
+/** The parsed result of CLI arguments. */
+export type CliAction = {
+    action: 'help';
+} | {
+    action: 'version';
+} | {
+    action: 'run';
+    configFile?: string;
+    cwd: string;
+} | {
+    action: 'error';
+    message: string;
+};
+/**
+ * Parse raw process.argv into a structured action.
+ *
+ * Pure function: no I/O, no process.exit. Testable in isolation.
+ *
+ * @param argv  process.argv (first two entries are node + script path)
+ * @param cwd   the working directory to resolve paths against
+ */
+export declare function parseCliArgs(argv: string[], cwd: string): CliAction;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CA8BnE"}

package/dist/cli-args.js

@@ -0,0 +1,37 @@
+import { resolve, dirname } from 'node:path';
+/**
+ * Parse raw process.argv into a structured action.
+ *
+ * Pure function: no I/O, no process.exit. Testable in isolation.
+ *
+ * @param argv  process.argv (first two entries are node + script path)
+ * @param cwd   the working directory to resolve paths against
+ */
+export function parseCliArgs(argv, cwd) {
+    const args = argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        return { action: 'help' };
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        return { action: 'version' };
+    }
+    const configIdx = args.indexOf('--config');
+    if (configIdx !== -1) {
+        const next = args[configIdx + 1];
+        if (next === undefined || next.startsWith('--')) {
+            return {
+                action: 'error',
+                message: [
+                    'Error: --config requires a file path argument',
+                    'Usage: openapi-server [--config <path-to-config.json>]',
+                ].join('\n'),
+            };
+        }
+        const configFile = resolve(cwd, next);
+        // Relative paths inside the config resolve from the config file's directory,
+        // not from the shell's CWD. This matches how most tooling works.
+        return { action: 'run', configFile, cwd: dirname(configFile) };
+    }
+    return { action: 'run', cwd };
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAS5C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,GAAW;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAE1B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;QAChC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE;oBACP,+CAA+C;oBAC/C,wDAAwD;iBACzD,CAAC,IAAI,CAAC,IAAI,CAAC;aACb,CAAA;QACH,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACrC,6EAA6E;QAC7E,iEAAiE;QACjE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAA;IAChE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AAC/B,CAAC"}