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

package/src/cli/config.ts

@@ -1,140 +1,140 @@
-import fs from 'fs-extra';
-import { join } from 'path';
-import * as p from '@clack/prompts';
-import type { GeneratorBackend, ConfigGenerator } from './types.js';
-
-const { existsSync } = fs;
-
-/**
- * Configuration options for the generator
- */
-export interface GeneratorConfig {
-  /** Path or URL to OpenAPI specification */
-  input?: string;
-  /** Output directory for generated files */
-  output?: string;
-  /** Base URL for API requests */
-  baseUrl?: string;
-  /** Generation mode: client or server */
-  mode?: 'client' | 'server';
-  /** Generate only specific tags */
-  tags?: string[];
-  /** Exclude specific tags */
-  excludeTags?: string[];
-  /** Overwrite existing files without prompting */
-  overwrite?: boolean;
-  /** Preview changes without writing files */
-  dryRun?: boolean;
-  /** Enable verbose logging */
-  verbose?: boolean;
-  /** Watch mode - regenerate on file changes */
-  watch?: boolean;
-  /** Generator types to use */
-  generators?: ('useFetch' | 'useAsyncData' | 'nuxtServer')[];
-  /** Server route path (for nuxtServer mode) */
-  serverRoutePath?: string;
-  /** Enable BFF pattern (for nuxtServer mode) */
-  enableBff?: boolean;
-  /** Generator backend: official (Java) or heyapi (Node.js) */
-  backend?: GeneratorBackend;
-  /**
-   * Generation engine to use.
-   * - 'openapi': @openapitools/openapi-generator-cli (requires Java 11+)
-   * - 'heyapi': @hey-api/openapi-ts (Node.js native, no Java required)
-   * When set, the CLI will not ask which engine to use.
-   */
-  generator?: ConfigGenerator;
-}
-
-/**
- * Load configuration from nxh.config.js, nuxt-openapi-generator.config.js, or package.json
- */
-export async function loadConfig(cwd: string = process.cwd()): Promise<GeneratorConfig | null> {
-  // Try different config file names
-  const configFiles = [
-    'nxh.config.js',
-    'nxh.config.mjs',
-    'nuxt-openapi-hyperfetch.js',
-    'nuxt-openapi-hyperfetch.mjs',
-  ];
-
-  for (const configFile of configFiles) {
-    const configPath = join(cwd, configFile);
-    if (existsSync(configPath)) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-        const config = await import(`file://${configPath}`);
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
-        const exportedConfig = config.default || config;
-        return exportedConfig as GeneratorConfig;
-      } catch (error) {
-        p.log.warn(`Failed to load config from ${configFile}: ${String(error)}`);
-      }
-    }
-  }
-
-  // Try package.json
-  const packageJsonPath = join(cwd, 'package.json');
-  if (existsSync(packageJsonPath)) {
-    try {
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-      const packageJson = await import(`file://${packageJsonPath}`, {
-        assert: { type: 'json' },
-      });
-      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-      if (packageJson.default?.['nuxt-openapi-hyperfetch']) {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-        return packageJson.default['nuxt-openapi-hyperfetch'] as GeneratorConfig;
-      }
-    } catch {
-      // Silently ignore package.json errors
-    }
-  }
-
-  return null;
-}
-
-/**
- * Merge CLI options with config file, CLI takes precedence
- */
-export function mergeConfig(
-  fileConfig: GeneratorConfig | null,
-  cliOptions: Partial<GeneratorConfig>
-): GeneratorConfig {
-  return {
-    ...fileConfig,
-    ...cliOptions,
-    // Handle arrays specially - CLI should override completely
-    tags: cliOptions.tags || fileConfig?.tags,
-    excludeTags: cliOptions.excludeTags || fileConfig?.excludeTags,
-    generators: cliOptions.generators || fileConfig?.generators,
-  };
-}
-
-/**
- * Parse comma-separated tags string into array
- */
-export function parseTags(tagsString?: string): string[] | undefined {
-  if (!tagsString) {
-    return undefined;
-  }
-  return tagsString
-    .split(',')
-    .map((t) => t.trim())
-    .filter(Boolean);
-}
-
-/**
- * Parse generators string into array
- */
-export function parseGenerators(
-  generatorsString?: string
-): ('useFetch' | 'useAsyncData' | 'nuxtServer')[] | undefined {
-  if (!generatorsString) {
-    return undefined;
-  }
-  const parts = generatorsString.split(',').map((g) => g.trim());
-  return parts.filter((g): g is 'useFetch' | 'useAsyncData' | 'nuxtServer' =>
-    ['useFetch', 'useAsyncData', 'nuxtServer'].includes(g)
-  );
-}
+import fs from 'fs-extra';
+import { join } from 'path';
+import * as p from '@clack/prompts';
+import type { GeneratorBackend, ConfigGenerator } from './types.js';
+
+const { existsSync } = fs;
+
+/**
+ * Configuration options for the generator
+ */
+export interface GeneratorConfig {
+  /** Path or URL to OpenAPI specification */
+  input?: string;
+  /** Output directory for generated files */
+  output?: string;
+  /** Base URL for API requests */
+  baseUrl?: string;
+  /** Generation mode: client or server */
+  mode?: 'client' | 'server';
+  /** Generate only specific tags */
+  tags?: string[];
+  /** Exclude specific tags */
+  excludeTags?: string[];
+  /** Overwrite existing files without prompting */
+  overwrite?: boolean;
+  /** Preview changes without writing files */
+  dryRun?: boolean;
+  /** Enable verbose logging */
+  verbose?: boolean;
+  /** Watch mode - regenerate on file changes */
+  watch?: boolean;
+  /** Generator types to use */
+  generators?: ('useFetch' | 'useAsyncData' | 'nuxtServer')[];
+  /** Server route path (for nuxtServer mode) */
+  serverRoutePath?: string;
+  /** Enable BFF pattern (for nuxtServer mode) */
+  enableBff?: boolean;
+  /** Generator backend: official (Java) or heyapi (Node.js) */
+  backend?: GeneratorBackend;
+  /**
+   * Generation engine to use.
+   * - 'openapi': @openapitools/openapi-generator-cli (requires Java 11+)
+   * - 'heyapi': @hey-api/openapi-ts (Node.js native, no Java required)
+   * When set, the CLI will not ask which engine to use.
+   */
+  generator?: ConfigGenerator;
+}
+
+/**
+ * Load configuration from nxh.config.js, nuxt-openapi-generator.config.js, or package.json
+ */
+export async function loadConfig(cwd: string = process.cwd()): Promise<GeneratorConfig | null> {
+  // Try different config file names
+  const configFiles = [
+    'nxh.config.js',
+    'nxh.config.mjs',
+    'nuxt-openapi-hyperfetch.js',
+    'nuxt-openapi-hyperfetch.mjs',
+  ];
+
+  for (const configFile of configFiles) {
+    const configPath = join(cwd, configFile);
+    if (existsSync(configPath)) {
+      try {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const config = await import(`file://${configPath}`);
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment
+        const exportedConfig = config.default || config;
+        return exportedConfig as GeneratorConfig;
+      } catch (error) {
+        p.log.warn(`Failed to load config from ${configFile}: ${String(error)}`);
+      }
+    }
+  }
+
+  // Try package.json
+  const packageJsonPath = join(cwd, 'package.json');
+  if (existsSync(packageJsonPath)) {
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+      const packageJson = await import(`file://${packageJsonPath}`, {
+        assert: { type: 'json' },
+      });
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+      if (packageJson.default?.['nuxt-openapi-hyperfetch']) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+        return packageJson.default['nuxt-openapi-hyperfetch'] as GeneratorConfig;
+      }
+    } catch {
+      // Silently ignore package.json errors
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Merge CLI options with config file, CLI takes precedence
+ */
+export function mergeConfig(
+  fileConfig: GeneratorConfig | null,
+  cliOptions: Partial<GeneratorConfig>
+): GeneratorConfig {
+  return {
+    ...fileConfig,
+    ...cliOptions,
+    // Handle arrays specially - CLI should override completely
+    tags: cliOptions.tags || fileConfig?.tags,
+    excludeTags: cliOptions.excludeTags || fileConfig?.excludeTags,
+    generators: cliOptions.generators || fileConfig?.generators,
+  };
+}
+
+/**
+ * Parse comma-separated tags string into array
+ */
+export function parseTags(tagsString?: string): string[] | undefined {
+  if (!tagsString) {
+    return undefined;
+  }
+  return tagsString
+    .split(',')
+    .map((t) => t.trim())
+    .filter(Boolean);
+}
+
+/**
+ * Parse generators string into array
+ */
+export function parseGenerators(
+  generatorsString?: string
+): ('useFetch' | 'useAsyncData' | 'nuxtServer')[] | undefined {
+  if (!generatorsString) {
+    return undefined;
+  }
+  const parts = generatorsString.split(',').map((g) => g.trim());
+  return parts.filter((g): g is 'useFetch' | 'useAsyncData' | 'nuxtServer' =>
+    ['useFetch', 'useAsyncData', 'nuxtServer'].includes(g)
+  );
+}

package/src/cli/logger.ts

@@ -1,66 +1,124 @@
-/**
- * Centralized logging utilities using @clack/prompts
- * Re-exports @clack for easy use across the project
- */
-import * as p from '@clack/prompts';
-
-/**
- * Re-export @clack/prompts for consistent usage
- */
-export { p };
-
-/**
- * Create and manage a spinner for long operations
- *
- * @example
- * const spinner = createSpinner();
- * spinner.start('Processing files');
- * // do work
- * spinner.stop('Files processed');
- */
-export function createSpinner() {
-  return p.spinner();
-}
-
-/**
- * Log a success message (replaces console.log with ✓)
- */
-export function logSuccess(message: string) {
-  p.log.success(message);
-}
-
-/**
- * Log an error message
- */
-export function logError(message: string) {
-  p.log.error(message);
-}
-
-/**
- * Log a warning message
- */
-export function logWarning(message: string) {
-  p.log.warn(message);
-}
-
-/**
- * Log an info message
- */
-export function logInfo(message: string) {
-  p.log.info(message);
-}
-
-/**
- * Display a note/box with multiple lines of information
- * Great for "Next steps" sections
- */
-export function logNote(message: string, title?: string) {
-  p.note(message, title);
-}
-
-/**
- * Display section separator
- */
-export function logStep(message: string) {
-  p.log.step(message);
-}
+/**
+ * Centralized logging utilities using @clack/prompts
+ * Re-exports @clack for easy use across the project
+ */
+import * as p from '@clack/prompts';
+
+/**
+ * Re-export @clack/prompts for consistent usage
+ */
+export { p };
+
+/**
+ * Create and manage a spinner for long operations
+ *
+ * @example
+ * const spinner = createSpinner();
+ * spinner.start('Processing files');
+ * // do work
+ * spinner.stop('Files processed');
+ */
+export function createSpinner() {
+  return p.spinner();
+}
+
+/**
+ * Log a success message (replaces console.log with ✓)
+ */
+export function logSuccess(message: string) {
+  p.log.success(message);
+}
+
+/**
+ * Log an error message
+ */
+export function logError(message: string) {
+  p.log.error(message);
+}
+
+/**
+ * Log a warning message
+ */
+export function logWarning(message: string) {
+  p.log.warn(message);
+}
+
+/**
+ * Log an info message
+ */
+export function logInfo(message: string) {
+  p.log.info(message);
+}
+
+/**
+ * Display a note/box with multiple lines of information
+ * Great for "Next steps" sections
+ */
+export function logNote(message: string, title?: string) {
+  p.note(message, title);
+}
+
+/**
+ * Display section separator
+ */
+export function logStep(message: string) {
+  p.log.step(message);
+}
+
+// ---------------------------------------------------------------------------
+// Logger abstraction — allows generators to run in both CLI and Nuxt module
+// ---------------------------------------------------------------------------
+
+/**
+ * Abstract logger interface used by generators.
+ * Decouples generator output from @clack/prompts so the same generators work
+ * in the interactive CLI and in the Nuxt module (where clack is irrelevant).
+ */
+export interface Logger {
+  spinner(): { start(msg: string): void; stop(msg: string): void };
+  log: {
+    warn(msg: string): void;
+    info(msg: string): void;
+    success(msg: string): void;
+    error(msg: string): void;
+  };
+  note(msg: string, title?: string): void;
+}
+
+/**
+ * Creates a Logger backed by @clack/prompts — used by the CLI.
+ */
+export function createClackLogger(): Logger {
+  return {
+    spinner: () => p.spinner(),
+    log: {
+      warn: (msg) => p.log.warn(msg),
+      info: (msg) => p.log.info(msg),
+      success: (msg) => p.log.success(msg),
+      error: (msg) => p.log.error(msg),
+    },
+    note: (msg, title) => p.note(msg, title),
+  };
+}
+
+/**
+ * Creates a Logger backed by console — used by the Nuxt module.
+ */
+export function createConsoleLogger(): Logger {
+  const prefix = '[nuxt-openapi-hyperfetch]';
+  return {
+    spinner() {
+      return {
+        start: (msg: string) => console.log(`${prefix} ⏳ ${msg}`),
+        stop: (msg: string) => console.log(`${prefix} ✓ ${msg}`),
+      };
+    },
+    log: {
+      warn: (msg) => console.warn(`${prefix} ⚠ ${msg}`),
+      info: (msg) => console.info(`${prefix} ℹ ${msg}`),
+      success: (msg) => console.log(`${prefix} ✓ ${msg}`),
+      error: (msg) => console.error(`${prefix} ✗ ${msg}`),
+    },
+    note: (msg, title) => console.log(title ? `\n${prefix} ${title}:\n${msg}\n` : `\n${msg}\n`),
+  };
+}

package/src/cli/logo.ts

@@ -1,25 +1,25 @@
-import gradient from 'gradient-string';
-
-const NUXT_LOGO = `███╗   ██╗██╗   ██╗██╗  ██╗████████╗
-████╗  ██║██║   ██║╚██╗██╔╝╚══██╔══╝
-██╔██╗ ██║██║   ██║ ╚███╔╝    ██║
-██║╚██╗██║██║   ██║ ██╔██╗    ██║
-██║ ╚████║╚██████╔╝██╔╝ ██╗   ██║
-╚═╝  ╚═══╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝`;
-
-const SUBTITLE = 'Nuxt OpenAPI Generator - useFetch, useAsyncData & Nuxt server';
-
-/**
- * Display the Nuxt logo with gradient colors
- * - Green gradient for Nuxt logo (official Nuxt color #00DC82)
- * - Blue gradient for Swagger subtitle
- */
-export function displayLogo(): void {
-  const nuxtGradient = gradient('#00DC82', '#00E090');
-  const swaggerGradient = gradient('#3B82F6', '#0EA5E9');
-
-  console.log('\n');
-  console.log(nuxtGradient(NUXT_LOGO));
-  console.log(swaggerGradient(SUBTITLE));
-  console.log('\n');
-}
+import gradient from 'gradient-string';
+
+const NUXT_LOGO = `███╗   ██╗██╗   ██╗██╗  ██╗████████╗
+████╗  ██║██║   ██║╚██╗██╔╝╚══██╔══╝
+██╔██╗ ██║██║   ██║ ╚███╔╝    ██║
+██║╚██╗██║██║   ██║ ██╔██╗    ██║
+██║ ╚████║╚██████╔╝██╔╝ ██╗   ██║
+╚═╝  ╚═══╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝`;
+
+const SUBTITLE = 'Nuxt OpenAPI Generator - useFetch, useAsyncData & Nuxt server';
+
+/**
+ * Display the Nuxt logo with gradient colors
+ * - Green gradient for Nuxt logo (official Nuxt color #00DC82)
+ * - Blue gradient for Swagger subtitle
+ */
+export function displayLogo(): void {
+  const nuxtGradient = gradient('#00DC82', '#00E090');
+  const swaggerGradient = gradient('#3B82F6', '#0EA5E9');
+
+  console.log('\n');
+  console.log(nuxtGradient(NUXT_LOGO));
+  console.log(swaggerGradient(SUBTITLE));
+  console.log('\n');
+}

package/src/cli/types.ts

@@ -1,50 +1,50 @@
-/**
- * TypeScript types for CLI prompts and responses
- */
-
-/**
- * Generator backend selector (internal)
- */
-export type GeneratorBackend = 'official' | 'heyapi';
-
-/**
- * Generator engine value for nxh.config — user-facing alias
- * 'openapi' maps to the official Java-based OpenAPI Generator
- * 'heyapi' maps to @hey-api/openapi-ts (Node.js native)
- */
-export type ConfigGenerator = 'openapi' | 'heyapi';
-
-/**
- * Initial input and output paths
- */
-export interface InitialInputs {
-  inputPath: string;
-  outputPath: string;
-}
-
-/**
- * Composables selection (checkbox response)
- */
-export interface ComposablesSelection {
-  composables: Array<'useFetch' | 'useAsyncData' | 'nuxtServer'>;
-}
-
-/**
- * Server route path configuration
- */
-export interface ServerRouteConfig {
-  serverPath: string;
-  customPath?: string;
-}
-
-/**
- * BFF (Backend for Frontend) configuration
- */
-export interface BffConfig {
-  enableBff: boolean;
-}
-
-/**
- * Valid composable types
- */
-export type ComposableType = 'useFetch' | 'useAsyncData' | 'nuxtServer';
+/**
+ * TypeScript types for CLI prompts and responses
+ */
+
+/**
+ * Generator backend selector (internal)
+ */
+export type GeneratorBackend = 'official' | 'heyapi';
+
+/**
+ * Generator engine value for nxh.config — user-facing alias
+ * 'openapi' maps to the official Java-based OpenAPI Generator
+ * 'heyapi' maps to @hey-api/openapi-ts (Node.js native)
+ */
+export type ConfigGenerator = 'openapi' | 'heyapi';
+
+/**
+ * Initial input and output paths
+ */
+export interface InitialInputs {
+  inputPath: string;
+  outputPath: string;
+}
+
+/**
+ * Composables selection (checkbox response)
+ */
+export interface ComposablesSelection {
+  composables: Array<'useFetch' | 'useAsyncData' | 'nuxtServer'>;
+}
+
+/**
+ * Server route path configuration
+ */
+export interface ServerRouteConfig {
+  serverPath: string;
+  customPath?: string;
+}
+
+/**
+ * BFF (Backend for Frontend) configuration
+ */
+export interface BffConfig {
+  enableBff: boolean;
+}
+
+/**
+ * Valid composable types
+ */
+export type ComposableType = 'useFetch' | 'useAsyncData' | 'nuxtServer';