auto-api-hooks 1.0.0 → 1.0.1

package/README.md

@@ -564,7 +564,7 @@ await generate({
 
 Full support for OpenAPI 3.0 and 3.1 specifications, including:
 
-- `$ref` resolution across the document
+- `$ref` resolution across the document, including multi-file specs with external `$ref` paths (e.g. `$ref: './paths/users.yaml'`)
 - `components.schemas` mapped to TypeScript types and optional Zod schemas
 - `servers[0].url` used as the default base URL
 - All HTTP methods: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
@@ -575,7 +575,7 @@ Full support for OpenAPI 3.0 and 3.1 specifications, including:
 - Tag-based grouping of generated hooks
 - `x-pagination` vendor extension for explicit pagination hints
 
-**Supported file formats:** `.yaml`, `.yml`, `.json`
+**Supported file formats:** `.yaml`, `.yml`, `.json` (single-file or multi-file with relative `$ref` references)
 
 ### Swagger 2.0
 
@@ -584,8 +584,9 @@ Full support for Swagger 2.0 specifications, including:
 - `definitions` mapped to TypeScript types
 - `host` + `basePath` combined into the base URL
 - All standard Swagger features (parameters, responses, tags)
+- Multi-file specs with external `$ref` paths
 
-**Supported file formats:** `.yaml`, `.yml`, `.json`
+**Supported file formats:** `.yaml`, `.yml`, `.json` (single-file or multi-file with relative `$ref` references)
 
 ### GraphQL
 

package/dist/cli.js

@@ -454,7 +454,7 @@ var openApiParser = {
   },
   async parse(input, options) {
     const derefed = await SwaggerParser.dereference(
-      input,
+      options?.filePath ?? input,
       { dereference: { circular: "ignore" } }
     );
     const doc = derefed;
@@ -789,7 +789,7 @@ var swaggerParser = {
   },
   async parse(input, options) {
     const derefed = await SwaggerParser.dereference(
-      input,
+      options?.filePath ?? input,
       { dereference: { circular: "ignore" } }
     );
     const doc = derefed;
@@ -1215,9 +1215,14 @@ async function parseSpec(input, options) {
   } else {
     resolved = input;
   }
+  const resolvedOptions = { ...options };
+  if (typeof input === "string" && /\.[a-z]{2,10}$/i.test(input) && !input.includes("\n")) {
+    const { resolve } = await import('path');
+    resolvedOptions.filePath = resolve(input);
+  }
   for (const parser of parsers) {
     if (parser.canParse(resolved)) {
-      const spec = await parser.parse(resolved, options);
+      const spec = await parser.parse(resolved, resolvedOptions);
       return applyPaginationDetection(spec);
     }
   }