nuxt-openapi-hyperfetch 0.2.7-alpha.1 → 0.3.0-beta

package/src/cli/logger.ts

@@ -1,124 +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);
-}
-
-// ---------------------------------------------------------------------------
-// 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`),
-  };
-}
+/**
+ * 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/messages.ts

@@ -67,6 +67,10 @@ export const CHOICES = {
     },
   ],
 
+  // Connectors prompt (shown only when useAsyncData is selected)
+  connectorsPrompt:
+    'Generate headless UI connectors? (tables, pagination, forms & delete logic built on top of useAsyncData)',
+
   // Server path options
   serverPaths: [
     {

package/src/cli/prompts.ts

@@ -96,7 +96,7 @@ export async function promptComposablesSelection(): Promise<ComposablesSelection
   });
   checkCancellation(result);
 
-  return { composables: result as ComposableType[] };
+  return { composables: result as ('useFetch' | 'useAsyncData' | 'nuxtServer')[] };
 }
 
 /**
@@ -141,3 +141,16 @@ export async function promptBffConfig(): Promise<BffConfig> {
 
   return { enableBff: result as boolean };
 }
+
+/**
+ * Ask whether to generate headless UI connectors on top of useAsyncData.
+ * Only called when useAsyncData was selected and no config value is present.
+ */
+export async function promptConnectors(): Promise<boolean> {
+  const result = await p.confirm({
+    message: CHOICES.connectorsPrompt,
+    initialValue: false,
+  });
+  checkCancellation(result);
+  return result as boolean;
+}

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' | 'connectors';