nuxt-openapi-hyperfetch 0.3.2-beta → 0.3.4-beta

package/dist/generators/components/schema-analyzer/intent-detector.js

@@ -36,6 +36,13 @@ function getSuccessResponseSchema(operation) {
 function isArraySchema(schema) {
     return schema.type === 'array' || schema.items !== undefined;
 }
+/** True when schema is a primitive scalar (string, number, integer, boolean) — not a resource */
+function isPrimitiveSchema(schema) {
+    return (schema.type === 'string' ||
+        schema.type === 'number' ||
+        schema.type === 'integer' ||
+        schema.type === 'boolean');
+}
 // ─── Request body schema ──────────────────────────────────────────────────────
 function getRequestBodySchema(operation) {
     if (!operation.requestBody?.content) {
@@ -84,6 +91,11 @@ export function detectIntent(method, path, operation) {
             if (isArraySchema(responseSchema)) {
                 return 'list';
             }
+            // Primitive response (string, number, boolean) → not a CRUD resource
+            // e.g. GET /user/login returns a string token — not a list or detail
+            if (isPrimitiveSchema(responseSchema)) {
+                return 'unknown';
+            }
             // Object response — distinguish list vs detail by path structure:
             //   GET /pets/{id}  → has path param → detail (single item fetch)
             //   GET /pets       → no path param  → list (likely paginated envelope: { data: [], total: n })

package/dist/generators/components/schema-analyzer/schema-field-mapper.js

@@ -132,7 +132,7 @@ function baseZodExpr(prop) {
         case 'array':
             return arrayZodExpr(prop);
         case 'object':
-            return 'z.record(z.unknown())';
+            return objectZodExpr(prop);
         default:
             // $ref already resolved, unknown type → permissive
             return 'z.unknown()';
@@ -181,6 +181,27 @@ function numberZodExpr(prop) {
     }
     return expr;
 }
+function objectZodExpr(prop) {
+    const { additionalProperties } = prop;
+    // additionalProperties: false or undefined → plain object
+    if (!additionalProperties || additionalProperties === true) {
+        return 'z.record(z.unknown())';
+    }
+    // additionalProperties has a known primitive type → typed record
+    const valueExpr = additionalPropsZodExpr(additionalProperties);
+    return `z.record(${valueExpr})`;
+}
+function additionalPropsZodExpr(schema) {
+    switch (schema.type) {
+        case 'string': return stringZodExpr(schema);
+        case 'integer': return integerZodExpr(schema);
+        case 'number': return numberZodExpr(schema);
+        case 'boolean': return 'z.boolean()';
+        case 'array': return arrayZodExpr(schema);
+        case 'object': return objectZodExpr(schema);
+        default: return 'z.unknown()';
+    }
+}
 function arrayZodExpr(prop) {
     const itemExpr = prop.items ? baseZodExpr(prop.items) : 'z.unknown()';
     let expr = `z.array(${itemExpr})`;

package/dist/index.js

@@ -196,6 +196,19 @@ program
             }
         }
         // Generate headless connectors if requested (requires useAsyncData)
+        if (generateConnectorsFlag) {
+            // Check zod is available in the user's project before attempting generation
+            try {
+                // Use a variable to prevent TypeScript from resolving the module at compile time
+                const zodId = 'zod';
+                await import(zodId);
+            }
+            catch {
+                p.log.warn('Skipping connectors: "zod" is not installed in this project.\n' +
+                    '  Run: npm install zod');
+                generateConnectorsFlag = false;
+            }
+        }
         if (generateConnectorsFlag) {
             const spinner = p.spinner();
             spinner.start('Generating headless UI connectors...');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-openapi-hyperfetch",
-  "version": "0.3.2-beta",
+  "version": "0.3.4-beta",
   "description": "Nuxt useFetch, useAsyncData and Nuxt server OpenAPI generator",
   "type": "module",
   "author": "",
@@ -40,7 +40,8 @@
     "format": "prettier --write \"**/*.{ts,json,md,yaml,yml}\"",
     "format:check": "prettier --check \"**/*.{ts,json,md,yaml,yml}\"",
     "type-check": "tsc --noEmit",
-    "validate": "npm run type-check && npm run lint && npm run format:check"
+    "validate": "npm run type-check && npm run lint && npm run format:check",
+    "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
     "@nuxt/kit": "^3.0.0 || ^4.0.0",

package/src/generators/components/schema-analyzer/intent-detector.ts

@@ -49,6 +49,16 @@ function isArraySchema(schema: OpenApiPropertySchema): boolean {
   return schema.type === 'array' || schema.items !== undefined;
 }
 
+/** True when schema is a primitive scalar (string, number, integer, boolean) — not a resource */
+function isPrimitiveSchema(schema: OpenApiPropertySchema): boolean {
+  return (
+    schema.type === 'string' ||
+    schema.type === 'number' ||
+    schema.type === 'integer' ||
+    schema.type === 'boolean'
+  );
+}
+
 // ─── Request body schema ──────────────────────────────────────────────────────
 
 function getRequestBodySchema(operation: OpenApiOperation): OpenApiPropertySchema | undefined {
@@ -113,6 +123,12 @@ export function detectIntent(
         return 'list';
       }
 
+      // Primitive response (string, number, boolean) → not a CRUD resource
+      // e.g. GET /user/login returns a string token — not a list or detail
+      if (isPrimitiveSchema(responseSchema)) {
+        return 'unknown';
+      }
+
       // Object response — distinguish list vs detail by path structure:
       //   GET /pets/{id}  → has path param → detail (single item fetch)
       //   GET /pets       → no path param  → list (likely paginated envelope: { data: [], total: n })

package/src/generators/components/schema-analyzer/schema-field-mapper.ts

@@ -167,7 +167,7 @@ function baseZodExpr(prop: OpenApiPropertySchema): string {
       return arrayZodExpr(prop);
 
     case 'object':
-      return 'z.record(z.unknown())';
+      return objectZodExpr(prop);
 
     default:
       // $ref already resolved, unknown type → permissive
@@ -224,6 +224,31 @@ function numberZodExpr(prop: OpenApiPropertySchema): string {
   return expr;
 }
 
+function objectZodExpr(prop: OpenApiPropertySchema): string {
+  const { additionalProperties } = prop;
+
+  // additionalProperties: false or undefined → plain object
+  if (!additionalProperties || additionalProperties === true) {
+    return 'z.record(z.unknown())';
+  }
+
+  // additionalProperties has a known primitive type → typed record
+  const valueExpr = additionalPropsZodExpr(additionalProperties);
+  return `z.record(${valueExpr})`;
+}
+
+function additionalPropsZodExpr(schema: OpenApiPropertySchema): string {
+  switch (schema.type) {
+    case 'string':   return stringZodExpr(schema);
+    case 'integer':  return integerZodExpr(schema);
+    case 'number':   return numberZodExpr(schema);
+    case 'boolean':  return 'z.boolean()';
+    case 'array':    return arrayZodExpr(schema);
+    case 'object':   return objectZodExpr(schema);
+    default:         return 'z.unknown()';
+  }
+}
+
 function arrayZodExpr(prop: OpenApiPropertySchema): string {
   const itemExpr = prop.items ? baseZodExpr(prop.items) : 'z.unknown()';
   let expr = `z.array(${itemExpr})`;

package/src/index.ts

@@ -253,6 +253,21 @@ program
       }
 
       // Generate headless connectors if requested (requires useAsyncData)
+      if (generateConnectorsFlag) {
+        // Check zod is available in the user's project before attempting generation
+        try {
+          // Use a variable to prevent TypeScript from resolving the module at compile time
+          const zodId = 'zod';
+          await import(zodId);
+        } catch {
+          p.log.warn(
+            'Skipping connectors: "zod" is not installed in this project.\n' +
+            '  Run: npm install zod'
+          );
+          generateConnectorsFlag = false;
+        }
+      }
+
       if (generateConnectorsFlag) {
         const spinner = p.spinner();
         spinner.start('Generating headless UI connectors...');