@qualisero/openapi-endpoint 0.18.1 → 0.18.3

package/README.md

@@ -1,7 +1,7 @@
 # OpenApiEndpoint
 
-[![npm version](https://badge.fury.io/js/@qualisero%2Fopenapi-endpoint.svg?refresh=20260225)](https://badge.fury.io/js/@qualisero%2Fopenapi-endpoint)
-[![CI](https://github.com/qualisero/openapi-endpoint/workflows/CI/badge.svg?refresh=20260225)](https://github.com/qualisero/openapi-endpoint/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/@qualisero%2Fopenapi-endpoint.svg?v=0.18.1)](https://badge.fury.io/js/@qualisero%2Fopenapi-endpoint)
+[![CI](https://github.com/qualisero/openapi-endpoint/workflows/CI/badge.svg?refresh=20260226)](https://github.com/qualisero/openapi-endpoint/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Documentation](https://img.shields.io/badge/docs-online-brightgreen.svg)](https://qualisero.github.io/openapi-endpoint/)
 

package/dist/cli.js

@@ -359,25 +359,47 @@ function addEnumIfUnique(enumName, enumValues, sourcePath, enums, seenEnumValues
 /**
  * Extracts all enums from an OpenAPI spec.
  * Walks through:
- * 1. components.schemas and their properties
+ * 1. components.schemas and their properties (inline enum or $ref to enum schema)
  * 2. Operation parameters (query, header, path, cookie)
  * Deduplicates by comparing enum value sets.
  */
 function extractEnumsFromSpec(openApiSpec) {
     const enums = [];
     const seenEnumValues = new Map(); // Maps JSON stringified values -> enum name (for deduplication)
+    // Build lookup of schemas that ARE enums (have enum property on the schema itself)
+    const schemaEnumLookup = new Map();
+    if (openApiSpec.components?.schemas) {
+        for (const [schemaName, schema] of Object.entries(openApiSpec.components.schemas)) {
+            if (schema.enum && Array.isArray(schema.enum)) {
+                const enumValues = schema.enum.filter((v) => v !== null);
+                if (enumValues.length > 0) {
+                    schemaEnumLookup.set(schemaName, enumValues);
+                }
+            }
+        }
+    }
+    // Helper to resolve enum values from a schema (inline or $ref)
+    function resolveEnumValues(schema) {
+        // Inline enum
+        if (schema.enum && Array.isArray(schema.enum)) {
+            const enumValues = schema.enum.filter((v) => v !== null);
+            return enumValues.length > 0 ? enumValues : null;
+        }
+        // $ref to an enum schema
+        if (typeof schema.$ref === 'string') {
+            const refName = schema.$ref.split('/').pop();
+            return schemaEnumLookup.get(refName) ?? null;
+        }
+        return null;
+    }
     // Extract from components.schemas
     if (openApiSpec.components?.schemas) {
         for (const [schemaName, schema] of Object.entries(openApiSpec.components.schemas)) {
             if (!schema.properties)
                 continue;
             for (const [propName, propSchema] of Object.entries(schema.properties)) {
-                if (!propSchema.enum || !Array.isArray(propSchema.enum))
-                    continue;
-                // Filter out null values from enum array
-                const enumValues = propSchema.enum.filter((v) => v !== null);
-                // Skip if all values were null
-                if (enumValues.length === 0)
+                const enumValues = resolveEnumValues(propSchema);
+                if (!enumValues)
                     continue;
                 // Use schema name as-is (already PascalCase), convert property name from snake_case
                 const enumName = schemaName + toPascalCase(propName);
@@ -401,10 +423,10 @@ function extractEnumsFromSpec(openApiSpec) {
                         const paramName = paramObj.name;
                         const paramIn = paramObj.in;
                         const paramSchema = paramObj.schema;
-                        if (!paramName || !paramIn || !paramSchema?.enum)
+                        if (!paramName || !paramIn || !paramSchema)
                             continue;
-                        const enumValues = paramSchema.enum.filter((v) => v !== null);
-                        if (enumValues.length === 0)
+                        const enumValues = resolveEnumValues(paramSchema);
+                        if (!enumValues)
                             continue;
                         // Create a descriptive name: OperationName + ParamName
                         const operationName = op.operationId

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qualisero/openapi-endpoint",
-  "version": "0.18.1",
+  "version": "0.18.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/qualisero/openapi-endpoint.git"