nuxt-openapi-hyperfetch 0.1.8-alpha.1 → 0.2.8-alpha.1

package/dist/generators/use-fetch/templates.js

@@ -2,18 +2,18 @@
  * Generate file header with auto-generation warning
  */
 function generateFileHeader() {
-    return `/**
- * ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
- *
- * This file was automatically generated by nuxt-openapi-generator.
- * Any manual changes will be overwritten on the next generation.
- *
- * @generated by nuxt-openapi-generator
- * @see https://github.com/dmartindiaz/nuxt-openapi-hyperfetch
- */
-
-/* eslint-disable */
-// @ts-nocheck
+    return `/**
+ * ⚠️ AUTO-GENERATED FILE - DO NOT EDIT MANUALLY
+ *
+ * This file was automatically generated by nuxt-openapi-generator.
+ * Any manual changes will be overwritten on the next generation.
+ *
+ * @generated by nuxt-openapi-generator
+ * @see https://github.com/dmartindiaz/nuxt-openapi-hyperfetch
+ */
+
+/* eslint-disable */
+// @ts-nocheck
 `;
 }
 /**
@@ -95,8 +95,8 @@ function generateFunctionBody(method, options) {
     const fetchOptions = generateFetchOptions(method, options);
     const description = method.description ? `/**\n * ${method.description}\n */\n` : '';
     const pInit = hasParams ? `\n  const p = shallowRef(params)` : '';
-    return `${description}export const ${method.composableName} = (${args}) => {${pInit}
-  return useApiRequest${responseTypeGeneric}(${url}, ${fetchOptions})
+    return `${description}export const ${method.composableName} = (${args}) => {${pInit}
+  return useApiRequest${responseTypeGeneric}(${url}, ${fetchOptions})
 }`;
 }
 /**

package/dist/index.js

@@ -6,7 +6,7 @@ import { generateUseFetchComposables } from './generators/use-fetch/generator.js
 import { generateUseAsyncDataComposables } from './generators/use-async-data/generator.js';
 import { generateNuxtServerRoutes } from './generators/nuxt-server/generator.js';
 import { generateConnectors } from './generators/components/connector-generator/generator.js';
-import { promptInitialInputs, promptInputPath, promptComposablesSelection, promptServerRoutePath, promptBffConfig, promptGeneratorBackend, } from './cli/prompts.js';
+import { promptInitialInputs, promptInputPath, promptComposablesSelection, promptServerRoutePath, promptBffConfig, promptGeneratorBackend, promptConnectors, } from './cli/prompts.js';
 import { MESSAGES } from './cli/messages.js';
 import { displayLogo } from './cli/logo.js';
 import { loadConfig, mergeConfig, parseTags, parseGenerators } from './cli/config.js';
@@ -26,6 +26,7 @@ program
     .option('-v, --verbose', 'Enable verbose logging', false)
     .option('--watch', 'Watch mode - regenerate on file changes', false)
     .option('--generators <types>', 'Generators to use: useFetch,useAsyncData,nuxtServer')
+    .option('--connectors', 'Generate headless UI connectors on top of useAsyncData', false)
     .option('--server-route-path <path>', 'Server route path (for nuxtServer mode)')
     .option('--enable-bff', 'Enable BFF pattern (for nuxtServer mode)', false)
     .option('--backend <type>', 'Generator backend: official (Java) or heyapi (Node.js)')
@@ -54,6 +55,7 @@ program
             backend: options.backend === 'official' || options.backend === 'heyapi'
                 ? options.backend
                 : undefined,
+            createUseAsyncDataConnectors: options.connectors,
         });
         if (config.verbose) {
             console.log('Configuration:', config);
@@ -85,7 +87,8 @@ program
         // 1. Determine composables to generate FIRST
         let composables;
         if (config.generators) {
-            composables = config.generators;
+            // filter out 'connectors' — handled separately below
+            composables = config.generators.filter((g) => g !== 'connectors');
             if (config.verbose) {
                 console.log(`Using generators from config: ${composables.join(', ')}`);
             }
@@ -114,7 +117,17 @@ program
             inputPath = await promptInputPath(config.input);
             outputPath = config.output ?? './swagger';
         }
-        // 3. Ask for server route path if nuxtServer is selected
+        // 3. Ask whether to generate headless connectors (only if useAsyncData selected)
+        let generateConnectorsFlag = false;
+        if (composables.includes('useAsyncData')) {
+            if (config.createUseAsyncDataConnectors !== undefined) {
+                generateConnectorsFlag = config.createUseAsyncDataConnectors;
+            }
+            else {
+                generateConnectorsFlag = await promptConnectors();
+            }
+        }
+        // 4. Ask for server route path if nuxtServer is selected
         let serverRoutePath = config.serverRoutePath || '';
         let enableBff = config.enableBff || false;
         if (needsNuxtServer && !config.serverRoutePath) {
@@ -181,6 +194,29 @@ program
                 throw error;
             }
         }
+        // Generate headless connectors if requested (requires useAsyncData)
+        if (generateConnectorsFlag) {
+            const spinner = p.spinner();
+            spinner.start('Generating headless UI connectors...');
+            try {
+                if (!config.dryRun) {
+                    await generateConnectors({
+                        inputSpec: inputPath,
+                        outputDir: `${composablesOutputDir}/connectors`,
+                        composablesRelDir: '../use-async-data',
+                        runtimeRelDir: '../../runtime',
+                    });
+                    spinner.stop('✓ Generated headless UI connectors');
+                }
+                else {
+                    spinner.stop('Would generate headless UI connectors (dry-run)');
+                }
+            }
+            catch (error) {
+                spinner.stop('✗ Failed to generate connectors');
+                throw error;
+            }
+        }
         if (config.dryRun) {
             p.outro('🔍 Dry run complete - no files were modified');
         }
@@ -211,28 +247,4 @@ program
         process.exit(1);
     }
 });
-program
-    .command('connectors')
-    .description('Generate headless connector composables from an OpenAPI spec')
-    .requiredOption('-i, --input <path>', 'Path to OpenAPI YAML or JSON spec')
-    .requiredOption('-o, --output <path>', 'Output directory for connector composables')
-    .option('--composables-dir <relPath>', 'Relative path from output dir to useAsyncData composables (default: ../use-async-data)')
-    .option('--runtime-dir <relPath>', 'Relative path from output dir where runtime helpers are copied (default: ../runtime)')
-    .action(async (options) => {
-    try {
-        displayLogo();
-        p.intro('Generating connector composables…');
-        await generateConnectors({
-            inputSpec: options.input,
-            outputDir: options.output,
-            composablesRelDir: options.composablesDir,
-            runtimeRelDir: options.runtimeDir,
-        });
-        p.outro('Done!');
-    }
-    catch (error) {
-        p.log.error(`Error: ${String(error)}`);
-        process.exit(1);
-    }
-});
 program.parse();

package/dist/module/index.js

@@ -5,6 +5,7 @@ import { checkJavaInstalled } from '../generate.js';
 import { generateUseFetchComposables } from '../generators/use-fetch/generator.js';
 import { generateUseAsyncDataComposables } from '../generators/use-async-data/generator.js';
 import { generateNuxtServerRoutes } from '../generators/nuxt-server/generator.js';
+import { generateConnectors } from '../generators/components/connector-generator/generator.js';
 import { createConsoleLogger } from '../cli/logger.js';
 export default defineNuxtModule({
     meta: {
@@ -19,6 +20,7 @@ export default defineNuxtModule({
         enableProductionBuild: true,
         enableAutoGeneration: false,
         enableAutoImport: true,
+        createUseAsyncDataConnectors: false,
     },
     setup(options, nuxt) {
         // --- Guard: input is required ---
@@ -64,6 +66,20 @@ export default defineNuxtModule({
                 const serverRoutePath = path.resolve(nuxt.options.rootDir, options.serverRoutePath ?? 'server/routes/api');
                 await generateNuxtServerRoutes(resolvedOutput, serverRoutePath, { enableBff: options.enableBff, backend }, logger);
             }
+            // 3. Generate headless connectors if requested (requires useAsyncData)
+            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 ---
         const isDev = nuxt.options.dev;
@@ -88,6 +104,9 @@ export default defineNuxtModule({
             if (selectedGenerators.includes('useAsyncData')) {
                 addImportsDir(path.join(composablesOutputDir, 'use-async-data', 'composables'));
             }
+            if (options.createUseAsyncDataConnectors && selectedGenerators.includes('useAsyncData')) {
+                addImportsDir(path.join(composablesOutputDir, 'connectors'));
+            }
         }
     },
 });

package/dist/module/types.d.ts

@@ -24,4 +24,11 @@ export interface ModuleOptions extends GeneratorConfig {
      * @default true
      */
     enableAutoImport?: boolean;
+    /**
+     * Generate headless UI connector composables on top of useAsyncData.
+     * Connectors provide ready-made logic for tables, pagination, forms and delete actions.
+     * Requires useAsyncData to also be in generators.
+     * @default false
+     */
+    createUseAsyncDataConnectors?: boolean;
 }