nuxt-openapi-hyperfetch 0.1.7-alpha.1 → 0.2.7-alpha.1

package/src/module/index.ts

@@ -0,0 +1,133 @@
+import { defineNuxtModule, addImportsDir } from '@nuxt/kit';
+import { execSync } from 'child_process';
+import * as path from 'path';
+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 { createConsoleLogger } from '../cli/logger.js';
+import type { ModuleOptions } from './types.js';
+
+export default defineNuxtModule<ModuleOptions>({
+  meta: {
+    name: 'nuxt-openapi-hyperfetch',
+    configKey: 'openApiHyperFetch',
+  },
+
+  defaults: {
+    output: './composables/api',
+    generators: ['useFetch', 'useAsyncData'],
+    backend: 'heyapi',
+    enableDevBuild: true,
+    enableProductionBuild: true,
+    enableAutoGeneration: false,
+    enableAutoImport: true,
+  },
+
+  setup(options: ModuleOptions, nuxt) {
+    // --- Guard: input is required ---
+    if (!options.input) {
+      console.warn(
+        '[nuxt-openapi-hyperfetch] No input configured — skipping generation.\n' +
+          "Add `openApiHyperFetch: { input: './swagger.yaml' }` to your nuxt.config.ts"
+      );
+      return;
+    }
+
+    const resolvedInput = path.resolve(nuxt.options.rootDir, options.input);
+    const resolvedOutput = path.resolve(nuxt.options.rootDir, options.output!);
+    const composablesOutputDir = path.join(resolvedOutput, 'composables');
+    const selectedGenerators = options.generators ?? ['useFetch', 'useAsyncData'];
+    const backend = options.backend ?? 'heyapi';
+    const logger = createConsoleLogger();
+
+    // --- Core generation function ---
+    const runGeneration = async () => {
+      logger.log.info('Generating OpenAPI composables...');
+
+      // 1. Generate OpenAPI SDK files
+      if (backend === 'official') {
+        if (!checkJavaInstalled()) {
+          throw new Error(
+            '[nuxt-openapi-hyperfetch] Java not found. The official backend requires Java 11+.\n' +
+              'Install from: https://adoptium.net or set backend: "heyapi" in nuxt.config.ts'
+          );
+        }
+        execSync(
+          `npx @openapitools/openapi-generator-cli generate -i "${resolvedInput}" -g typescript-fetch -o "${resolvedOutput}"`,
+          { stdio: 'inherit' }
+        );
+      } else {
+        const { createClient } = await import('@hey-api/openapi-ts');
+        await createClient({
+          input: resolvedInput,
+          output: resolvedOutput,
+          plugins: ['@hey-api/typescript', '@hey-api/sdk'],
+        });
+      }
+
+      // 2. Run selected composable generators
+      const genOptions = { backend };
+
+      if (selectedGenerators.includes('useFetch')) {
+        await generateUseFetchComposables(
+          resolvedOutput,
+          path.join(composablesOutputDir, 'use-fetch'),
+          genOptions,
+          logger
+        );
+      }
+
+      if (selectedGenerators.includes('useAsyncData')) {
+        await generateUseAsyncDataComposables(
+          resolvedOutput,
+          path.join(composablesOutputDir, 'use-async-data'),
+          genOptions,
+          logger
+        );
+      }
+
+      if (selectedGenerators.includes('nuxtServer')) {
+        const serverRoutePath = path.resolve(
+          nuxt.options.rootDir,
+          options.serverRoutePath ?? 'server/routes/api'
+        );
+        await generateNuxtServerRoutes(
+          resolvedOutput,
+          serverRoutePath,
+          { enableBff: options.enableBff, backend },
+          logger
+        );
+      }
+    };
+
+    // --- Hooks: dev build / production build ---
+    const isDev = nuxt.options.dev;
+    if ((isDev && options.enableDevBuild) || (!isDev && options.enableProductionBuild)) {
+      nuxt.hook('build:before', runGeneration);
+    }
+
+    // --- Hook: auto-regeneration on input file change (dev only) ---
+    if (options.enableAutoGeneration) {
+      nuxt.hook('builder:watch', async (event: string, watchedPath: string) => {
+        const absWatchedPath = path.resolve(nuxt.options.rootDir, watchedPath);
+        if (absWatchedPath === resolvedInput && (event === 'change' || event === 'add')) {
+          logger.log.info(`Detected change in ${watchedPath}, regenerating composables...`);
+          await runGeneration();
+        }
+      });
+    }
+
+    // --- Auto-import: register composable directories ---
+    if (options.enableAutoImport !== false) {
+      if (selectedGenerators.includes('useFetch')) {
+        addImportsDir(path.join(composablesOutputDir, 'use-fetch', 'composables'));
+      }
+      if (selectedGenerators.includes('useAsyncData')) {
+        addImportsDir(path.join(composablesOutputDir, 'use-async-data', 'composables'));
+      }
+    }
+  },
+});
+
+export type { ModuleOptions };

package/src/module/types.ts

@@ -0,0 +1,31 @@
+import type { GeneratorConfig } from '../cli/config.js';
+
+/**
+ * Configuration options for the nuxt-openapi-hyperfetch Nuxt module.
+ * Extends the CLI GeneratorConfig so the same fields work in both nxh.config.js and nuxt.config.ts.
+ */
+export interface ModuleOptions extends GeneratorConfig {
+  /**
+   * Generate composables before the dev server starts.
+   * @default true
+   */
+  enableDevBuild?: boolean;
+
+  /**
+   * Generate composables before the production build.
+   * @default true
+   */
+  enableProductionBuild?: boolean;
+
+  /**
+   * Watch the input file and regenerate composables on change (dev mode only).
+   * @default false
+   */
+  enableAutoGeneration?: boolean;
+
+  /**
+   * Automatically import generated useFetch/useAsyncData composables project-wide.
+   * @default true
+   */
+  enableAutoImport?: boolean;
+}

package/src/generators/tanstack-query/generator.ts

@@ -1,11 +0,0 @@
-/**
- * Placeholder for TanStack Query composables generator
- * TODO: Implement TanStack Query generation
- */
-export function generateTanstackQueryComposables(inputDir: string, outputDir: string): void {
-  console.log('\n📦 @tanstack/vue-query generator\n');
-  console.log(`   Input: ${inputDir}`);
-  console.log(`   Output: ${outputDir}`);
-  console.log('\n⚠️  This generator is not yet implemented.');
-  console.log('   Coming soon!\n');
-}