nuxt-openapi-hyperfetch 0.3.1-beta → 0.3.3-beta

package/dist/generators/components/connector-generator/generator.js

@@ -62,7 +62,7 @@ export async function generateConnectors(options, logger = createClackLogger())
     const generatedNames = [];
     for (const resource of resourceMap.values()) {
         try {
-            const code = generateConnectorFile(resource, composablesRelDir);
+            const code = generateConnectorFile(resource, composablesRelDir, '../..', runtimeRelDir);
             const formatted = await formatCode(code, logger);
             const fileName = connectorFileName(resource.composableName);
             const filePath = path.join(outputDir, fileName);

package/dist/generators/components/connector-generator/templates.d.ts

@@ -6,7 +6,7 @@ import type { ResourceInfo } from '../schema-analyzer/types.js';
  * @param composablesRelDir  Relative path from the connector dir to the
  *                           useAsyncData composables dir (e.g. '../use-async-data')
  */
-export declare function generateConnectorFile(resource: ResourceInfo, composablesRelDir: string, sdkRelDir?: string): string;
+export declare function generateConnectorFile(resource: ResourceInfo, composablesRelDir: string, sdkRelDir?: string, runtimeRelDir?: string): string;
 /**
  * Derive the output filename for a connector.
  * 'usePetsConnector' → 'use-pets-connector.ts'

package/dist/generators/components/connector-generator/templates.js

@@ -33,7 +33,7 @@ function toFileName(composableName) {
 /**
  * Build all `import` lines for a resource connector.
  */
-function buildImports(resource, composablesRelDir, sdkRelDir) {
+function buildImports(resource, composablesRelDir, sdkRelDir, runtimeRelDir) {
     const lines = [];
     // zod
     lines.push(`import { z } from 'zod';`);
@@ -49,7 +49,7 @@ function buildImports(resource, composablesRelDir, sdkRelDir) {
     if (resource.deleteEndpoint) {
         connectorTypeImports.push('DeleteConnectorReturn');
     }
-    lines.push(`import type { ${connectorTypeImports.join(', ')} } from '#nxh/runtime/connector-types';`);
+    lines.push(`import type { ${connectorTypeImports.join(', ')} } from '${runtimeRelDir}/connector-types';`);
     lines.push('');
     // SDK request/response types (for the params overload signature)
     if (resource.listEndpoint) {
@@ -57,7 +57,7 @@ function buildImports(resource, composablesRelDir, sdkRelDir) {
         lines.push(`import type { ${requestTypeName} } from '${sdkRelDir}';`);
         lines.push('');
     }
-    // runtime helpers (Nuxt alias — set up by the Nuxt module)
+    // runtime helpers — relative path works in both CLI and Nuxt module contexts
     // useListConnector is always imported to support the optional factory pattern
     const runtimeHelpers = ['useListConnector'];
     if (resource.detailEndpoint) {
@@ -70,7 +70,7 @@ function buildImports(resource, composablesRelDir, sdkRelDir) {
         runtimeHelpers.push('useDeleteConnector');
     }
     for (const helper of runtimeHelpers) {
-        lines.push(`import { ${helper} } from '#nxh/runtime/${helper}';`);
+        lines.push(`import { ${helper} } from '${runtimeRelDir}/${helper}';`);
     }
     lines.push('');
     // generated useAsyncData composables
@@ -312,9 +312,9 @@ function buildFunctionBody(resource) {
  * @param composablesRelDir  Relative path from the connector dir to the
  *                           useAsyncData composables dir (e.g. '../use-async-data')
  */
-export function generateConnectorFile(resource, composablesRelDir, sdkRelDir = '../..') {
+export function generateConnectorFile(resource, composablesRelDir, sdkRelDir = '../..', runtimeRelDir = '../../runtime') {
     const header = generateFileHeader();
-    const imports = buildImports(resource, composablesRelDir, sdkRelDir);
+    const imports = buildImports(resource, composablesRelDir, sdkRelDir, runtimeRelDir);
     const schemas = buildZodSchemas(resource);
     const columns = buildColumns(resource);
     const optionsInterface = buildOptionsInterface(resource);

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/dist/module/index.js

@@ -70,15 +70,12 @@ export default defineNuxtModule({
             if (options.createUseAsyncDataConnectors &&
                 selectedGenerators.includes('useAsyncData')) {
                 const connectorsOutputDir = path.join(composablesOutputDir, 'connectors');
-                const runtimeDir = path.join(resolvedOutput, 'runtime');
                 await generateConnectors({
                     inputSpec: resolvedInput,
                     outputDir: connectorsOutputDir,
                     composablesRelDir: '../use-async-data',
                     runtimeRelDir: '../../runtime',
                 }, logger);
-                // Register #nxh alias so generated connector imports resolve
-                nuxt.options.alias['#nxh'] = runtimeDir;
             }
         };
         // --- Hooks: dev build / production build ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-openapi-hyperfetch",
-  "version": "0.3.1-beta",
+  "version": "0.3.3-beta",
   "description": "Nuxt useFetch, useAsyncData and Nuxt server OpenAPI generator",
   "type": "module",
   "author": "",

package/src/generators/components/connector-generator/generator.ts

@@ -78,7 +78,7 @@ export async function generateConnectors(
 
   for (const resource of resourceMap.values()) {
     try {
-      const code = generateConnectorFile(resource, composablesRelDir);
+      const code = generateConnectorFile(resource, composablesRelDir, '../..', runtimeRelDir);
       const formatted = await formatCode(code, logger);
       const fileName = connectorFileName(resource.composableName);
       const filePath = path.join(outputDir, fileName);

package/src/generators/components/connector-generator/templates.ts

@@ -41,7 +41,7 @@ function toFileName(composableName: string): string {
 /**
  * Build all `import` lines for a resource connector.
  */
-function buildImports(resource: ResourceInfo, composablesRelDir: string, sdkRelDir: string): string {
+function buildImports(resource: ResourceInfo, composablesRelDir: string, sdkRelDir: string, runtimeRelDir: string): string {
   const lines: string[] = [];
 
   // zod
@@ -59,7 +59,7 @@ function buildImports(resource: ResourceInfo, composablesRelDir: string, sdkRelD
   if (resource.deleteEndpoint) {
     connectorTypeImports.push('DeleteConnectorReturn');
   }
-  lines.push(`import type { ${connectorTypeImports.join(', ')} } from '#nxh/runtime/connector-types';`);
+  lines.push(`import type { ${connectorTypeImports.join(', ')} } from '${runtimeRelDir}/connector-types';`);
   lines.push('');
 
   // SDK request/response types (for the params overload signature)
@@ -69,7 +69,7 @@ function buildImports(resource: ResourceInfo, composablesRelDir: string, sdkRelD
     lines.push('');
   }
 
-  // runtime helpers (Nuxt alias — set up by the Nuxt module)
+  // runtime helpers — relative path works in both CLI and Nuxt module contexts
   // useListConnector is always imported to support the optional factory pattern
   const runtimeHelpers: string[] = ['useListConnector'];
   if (resource.detailEndpoint) {
@@ -83,7 +83,7 @@ function buildImports(resource: ResourceInfo, composablesRelDir: string, sdkRelD
   }
 
   for (const helper of runtimeHelpers) {
-    lines.push(`import { ${helper} } from '#nxh/runtime/${helper}';`);
+    lines.push(`import { ${helper} } from '${runtimeRelDir}/${helper}';`);
   }
   lines.push('');
 
@@ -375,10 +375,11 @@ function buildFunctionBody(resource: ResourceInfo): string {
 export function generateConnectorFile(
   resource: ResourceInfo,
   composablesRelDir: string,
-  sdkRelDir = '../..'
+  sdkRelDir = '../..',
+  runtimeRelDir = '../../runtime'
 ): string {
   const header = generateFileHeader();
-  const imports = buildImports(resource, composablesRelDir, sdkRelDir);
+  const imports = buildImports(resource, composablesRelDir, sdkRelDir, runtimeRelDir);
   const schemas = buildZodSchemas(resource);
   const columns = buildColumns(resource);
   const optionsInterface = buildOptionsInterface(resource);

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...');

package/src/module/index.ts

@@ -108,7 +108,6 @@ export default defineNuxtModule<ModuleOptions>({
         selectedGenerators.includes('useAsyncData')
       ) {
         const connectorsOutputDir = path.join(composablesOutputDir, 'connectors');
-        const runtimeDir = path.join(resolvedOutput, 'runtime');
         await generateConnectors(
           {
             inputSpec: resolvedInput,
@@ -118,8 +117,6 @@ export default defineNuxtModule<ModuleOptions>({
           },
           logger
         );
-        // Register #nxh alias so generated connector imports resolve
-        nuxt.options.alias['#nxh'] = runtimeDir;
       }
     };