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

package/eslint.config.js

@@ -1,85 +1,85 @@
-// @ts-check
-import eslint from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import prettierConfig from 'eslint-config-prettier';
-import prettierPlugin from 'eslint-plugin-prettier';
-
-export default tseslint.config(
-  eslint.configs.recommended,
-  ...tseslint.configs.recommendedTypeChecked,
-  prettierConfig,
-  {
-    plugins: {
-      prettier: prettierPlugin,
-    },
-    languageOptions: {
-      parserOptions: {
-        project: './tsconfig.json',
-        tsconfigRootDir: import.meta.dirname,
-      },
-    },
-    rules: {
-      'prettier/prettier': 'error',
-      '@typescript-eslint/no-explicit-any': 'warn',
-      '@typescript-eslint/explicit-function-return-type': 'off',
-      '@typescript-eslint/explicit-module-boundary-types': 'off',
-      '@typescript-eslint/no-unused-vars': [
-        'error',
-        {
-          argsIgnorePattern: '^_',
-          varsIgnorePattern: '^_',
-        },
-      ],
-      '@typescript-eslint/no-floating-promises': 'error',
-      '@typescript-eslint/no-misused-promises': 'error',
-      '@typescript-eslint/no-unsafe-assignment': 'warn',
-      '@typescript-eslint/no-unsafe-member-access': 'warn',
-      '@typescript-eslint/no-unsafe-call': 'warn',
-      '@typescript-eslint/no-unsafe-return': 'warn',
-      '@typescript-eslint/no-unsafe-argument': 'warn',
-      '@typescript-eslint/restrict-template-expressions': 'warn',
-      '@typescript-eslint/ban-ts-comment': [
-        'error',
-        {
-          'ts-nocheck': 'allow-with-description',
-          minimumDescriptionLength: 10,
-        },
-      ],
-      'no-console': 'off',
-      'prefer-const': 'error',
-      'no-var': 'error',
-      'no-useless-escape': 'warn',
-      eqeqeq: ['error', 'always'],
-      curly: ['error', 'all'],
-    },
-  },
-  {
-    // src/module/** uses @nuxt/kit types that only resolve fully inside a real
-    // Nuxt project. Disable the unsafe-* rules here to avoid false positives
-    // while keeping all other rules active.
-    files: ['src/module/**/*.ts'],
-    rules: {
-      '@typescript-eslint/no-unsafe-assignment': 'off',
-      '@typescript-eslint/no-unsafe-member-access': 'off',
-      '@typescript-eslint/no-unsafe-call': 'off',
-      '@typescript-eslint/no-unsafe-argument': 'off',
-      '@typescript-eslint/no-unsafe-return': 'off',
-    },
-  },
-  {
-    ignores: [
-      'dist/**',
-      'node_modules/**',
-      'swagger/**',
-      'test-*/**',
-      'index.ts',
-      // Ignore runtime files - they run in user's project with different rules
-      'src/generators/*/runtime/**',
-      'src/generators/shared/runtime/**',
-      'src/generators/shared/templates/**',
-      '*.js',
-      '*.mjs',
-      '*.cjs',
-    ],
-  }
-);
+// @ts-check
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import prettierConfig from 'eslint-config-prettier';
+import prettierPlugin from 'eslint-plugin-prettier';
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  prettierConfig,
+  {
+    plugins: {
+      prettier: prettierPlugin,
+    },
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      'prettier/prettier': 'error',
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': 'error',
+      '@typescript-eslint/no-unsafe-assignment': 'warn',
+      '@typescript-eslint/no-unsafe-member-access': 'warn',
+      '@typescript-eslint/no-unsafe-call': 'warn',
+      '@typescript-eslint/no-unsafe-return': 'warn',
+      '@typescript-eslint/no-unsafe-argument': 'warn',
+      '@typescript-eslint/restrict-template-expressions': 'warn',
+      '@typescript-eslint/ban-ts-comment': [
+        'error',
+        {
+          'ts-nocheck': 'allow-with-description',
+          minimumDescriptionLength: 10,
+        },
+      ],
+      'no-console': 'off',
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'no-useless-escape': 'warn',
+      eqeqeq: ['error', 'always'],
+      curly: ['error', 'all'],
+    },
+  },
+  {
+    // src/module/** uses @nuxt/kit types that only resolve fully inside a real
+    // Nuxt project. Disable the unsafe-* rules here to avoid false positives
+    // while keeping all other rules active.
+    files: ['src/module/**/*.ts'],
+    rules: {
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+      '@typescript-eslint/no-unsafe-return': 'off',
+    },
+  },
+  {
+    ignores: [
+      'dist/**',
+      'node_modules/**',
+      'swagger/**',
+      'test-*/**',
+      'index.ts',
+      // Ignore runtime files - they run in user's project with different rules
+      'src/generators/*/runtime/**',
+      'src/generators/shared/runtime/**',
+      'src/generators/shared/templates/**',
+      '*.js',
+      '*.mjs',
+      '*.cjs',
+    ],
+  }
+);

package/package.json

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

package/src/cli/config.ts

@@ -1,140 +1,147 @@
-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' | 'connectors')[];
+  /** 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;
+  /**
+   * 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 generated.
+   * @default false
+   */
+  createUseAsyncDataConnectors?: boolean;
+}
+
+/**
+ * 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' | 'connectors')[] | undefined {
+  if (!generatorsString) {
+    return undefined;
+  }
+  const parts = generatorsString.split(',').map((g) => g.trim());
+  return parts.filter((g): g is 'useFetch' | 'useAsyncData' | 'nuxtServer' | 'connectors' =>
+    ['useFetch', 'useAsyncData', 'nuxtServer', 'connectors'].includes(g)
+  );
+}