@gogenger/go-gen 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# 更新日志 / Changelog
+
+本文档记录项目的所有重要变更。
+
+All notable changes to this project will be documented in this file.
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [未发布 / Unreleased]
+
+### 新增 / Added
+
+- 初始文档结构 / Initial documentation structure
+- 贡献指南 / Contributing guidelines
+- 最佳实践指南 / Best practices guide
+
+## [1.0.0] - 2025-12-30
+
+### 新增 / Added
+
+- 首次发布 / Initial release
+- 🎯 Fetch 模式，支持直接请求 API / Fetch mode for direct API requests
+- 📄 OpenAPI 模式，支持批量生成 / OpenAPI mode for batch generation
+- 🔄 增量写入，智能合并文件 / Incremental write with smart merge
+- 🔀 自动冲突处理 / Automatic conflict resolution
+- 🌐 支持多种 HTTP 方法（GET、POST、PUT、DELETE、PATCH）/ Support for multiple HTTP methods
+- 🔐 认证支持（Bearer Token、Cookie）/ Authentication support
+- 🔁 自动重试机制 / Automatic retry mechanism
+- ⚙️ 双层配置系统（全局 + 项目）/ Dual-layer configuration system
+- ⚡ 批量生成模式 / Batch generation mode
+- 🎨 类型安全的代码生成 / Type-safe code generation
+
+[未发布 / Unreleased]: https://github.com/goGenger/go-gen/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/goGenger/go-gen/compare/v0.9.0...v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 goGenger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,151 @@
+# 🚀 go-gen
+
+[![npm version](https://badge.fury.io/js/go-gen.svg)](https://www.npmjs.com/package/go-gen)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/go-gen.svg)](https://nodejs.org)
+
+A TypeScript API code generator that supports generating TypeScript interface code and type definitions from API responses or OpenAPI documents with one click.
+
+English | [简体中文](./README.md)
+
+## ✨ Features
+
+- 🎯 **Fetch Mode** - Request API directly and auto-generate type definitions
+- 📄 **OpenAPI Mode** - Batch generate from Swagger/OpenAPI documents
+- 🔄 **Incremental Write** - Smart merge with existing files, no overwrite
+- 🔀 **Conflict Resolution** - Auto-detect and rename duplicate types
+- 🌐 **Multiple HTTP Methods** - Support GET, POST, PUT, DELETE, PATCH
+- 🔐 **Authentication Support** - Bearer Token, Cookie, and more
+- ⚙️ **Dual Configuration** - Global config + Project config for flexibility
+
+## 📦 Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @gogenger/go-gen
+```
+
+### Project Installation
+
+```bash
+npm install --save-dev @gogenger/go-gen
+```
+
+## 🎯 Quick Start
+
+### Fetch Mode - Request API Directly
+
+```bash
+go-gen fetch
+```
+
+Follow the interactive prompts to input API information and generate code:
+
+**Generated types.ts**
+
+```typescript
+export interface UserResponse {
+  id: number;
+  name: string;
+  email: string;
+}
+```
+
+**Generated api.ts**
+
+```typescript
+import request from '@/utils/request';
+import type { UserResponse } from './types';
+
+export function getUsers() {
+  return request.get<UserResponse>('https://api.example.com/users');
+}
+```
+
+### OpenAPI Mode - Generate from Documents
+
+```bash
+# Local file
+go-gen openapi ./swagger.json
+
+# Remote URL
+go-gen openapi https://api.example.com/swagger.json
+```
+
+Supports both batch generation and individual generation modes.
+
+## 📚 Documentation
+
+- [Features Documentation](./docs/FEATURES.md) - Detailed feature descriptions
+- [Configuration Guide](./docs/CONFIGURATION.md) - Configuration system explained
+- [Use Cases](./docs/USE_CASES.md) - Real-world application examples
+- [Best Practices](./docs/BEST_PRACTICES.md) - Team collaboration recommendations
+- [Troubleshooting](./docs/TROUBLESHOOTING.md) - Common issues and solutions
+
+## 📝 Main Commands
+
+```bash
+# Fetch mode
+go-gen fetch
+
+# OpenAPI mode
+go-gen openapi <source>
+
+# Initialize project config
+go-gen init
+
+# Configuration management
+go-gen config --show          # View config
+go-gen config --global        # Set global config
+
+# View help
+go-gen --help
+go-gen --version
+```
+
+## ⚙️ Quick Configuration
+
+```bash
+# Initialize project configuration
+go-gen init
+
+# Set global configuration
+go-gen config --global
+```
+
+Configuration priority: Project config > Global config > Default config
+
+See [Configuration Guide](./docs/CONFIGURATION.md) for details.
+
+## 🤝 Contributing
+
+Issues and Pull Requests are welcome!
+
+Check out [Contributing Guide](./CONTRIBUTING.md) to learn how to participate in development.
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+npm test
+
+# View coverage
+npm test -- --coverage
+```
+
+## 📄 License
+
+[MIT](./LICENSE)
+
+## 📮 Contact
+
+- GitHub: [@goGenger](https://github.com/goGenger)
+- Email: bg2582266166@gmail.com
+- Issues: [GitHub Issues](https://github.com/goGenger/go-gen/issues)
+
+---
+
+**Made with ❤️ by goGenger**
+
+If this project helps you, please give it a ⭐️ Star!

package/README.md

@@ -0,0 +1,151 @@
+# 🚀 go-gen
+
+[![npm version](https://badge.fury.io/js/go-gen.svg)](https://www.npmjs.com/package/go-gen)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/go-gen.svg)](https://nodejs.org)
+
+一款 TypeScript API 代码生成器，支持从 API 响应或 OpenAPI 文档一键生成 TypeScript 接口代码和类型定义。
+
+[English](./README.en.md) | 简体中文
+
+## ✨ 特性
+
+- 🎯 **Fetch 模式** - 直接请求 API，自动生成类型定义
+- 📄 **OpenAPI 模式** - 从 Swagger/OpenAPI 文档批量生成
+- 🔄 **增量写入** - 智能合并已存在的文件，避免覆盖
+- 🔀 **冲突处理** - 自动检测并重命名重复的类型
+- 🌐 **多种 HTTP 方法** - 支持 GET、POST、PUT、DELETE、PATCH
+- 🔐 **认证支持** - Bearer Token、Cookie 等多种认证方式
+- ⚙️ **双层配置** - 全局配置 + 项目配置，灵活适配多项目
+
+## 📦 安装
+
+### 全局安装（推荐）
+
+```bash
+npm install -g @gogenger/go-gen
+```
+
+### 项目内安装
+
+```bash
+npm install --save-dev @gogenger/go-gen
+```
+
+## 🎯 快速开始
+
+### Fetch 模式 - 直接请求 API
+
+```bash
+go-gen fetch
+```
+
+跟随交互式提示输入 API 信息，即可生成代码：
+
+**生成的 types.ts**
+
+```typescript
+export interface UserResponse {
+  id: number;
+  name: string;
+  email: string;
+}
+```
+
+**生成的 api.ts**
+
+```typescript
+import request from '@/utils/request';
+import type { UserResponse } from './types';
+
+export function getUsers() {
+  return request.get<UserResponse>('https://api.example.com/users');
+}
+```
+
+### OpenAPI 模式 - 从文档生成
+
+```bash
+# 本地文件
+go-gen openapi ./swagger.json
+
+# 远程 URL
+go-gen openapi https://api.example.com/swagger.json
+```
+
+支持批量生成和逐个生成两种模式。
+
+## 📚 文档
+
+- [完整特性文档](./docs/FEATURES.md) - 详细功能说明
+- [配置指南](./docs/CONFIGURATION.md) - 配置系统详解
+- [使用场景](./docs/USE_CASES.md) - 实际应用案例
+- [最佳实践](./docs/BEST_PRACTICES.md) - 团队协作建议
+- [故障排查](./docs/TROUBLESHOOTING.md) - 常见问题解决
+
+## 📝 主要命令
+
+```bash
+# Fetch 模式
+go-gen fetch
+
+# OpenAPI 模式
+go-gen openapi <source>
+
+# 初始化项目配置
+go-gen init
+
+# 配置管理
+go-gen config --show          # 查看配置
+go-gen config --global        # 设置全局配置
+
+# 查看帮助
+go-gen --help
+go-gen --version
+```
+
+## ⚙️ 快速配置
+
+```bash
+# 初始化项目配置
+go-gen init
+
+# 设置全局配置
+go-gen config --global
+```
+
+配置优先级：项目配置 > 全局配置 > 默认配置
+
+详见 [配置指南](./docs/CONFIGURATION.md)
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+查看 [贡献指南](./CONTRIBUTING.md) 了解如何参与项目开发。
+
+## 🧪 测试
+
+```bash
+# 运行所有测试
+npm test
+
+# 查看覆盖率
+npm test -- --coverage
+```
+
+## 📄 License
+
+[MIT](./LICENSE)
+
+## 📮 联系方式
+
+- GitHub: [@goGenger](https://github.com/goGenger)
+- Email: bg2582266166@gmail.com
+- Issues: [GitHub Issues](https://github.com/goGenger/go-gen/issues)
+
+---
+
+**Made with ❤️ by goGenger**
+
+如果这个项目对你有帮助，请给一个 ⭐️ Star！

package/bin/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const packageJson = require('../package.json');
+
+// 导入命令
+const fetchMode = require('../core/fetch-mode');
+const openapiMode = require('../core/openapi-mode');
+const { initLocalConfig, showConfig, configGlobal } = require('../core/config');
+
+// 设置程序信息
+program
+  .name('go-gen')
+  .version(packageJson.version)
+  .description('🚀 API 代码生成器');
+
+// fetch 命令
+program
+  .command('fetch')
+  .description('📡 Fetch 模式')
+  .action(async () => {
+    try {
+      console.log(chalk.cyan('🚀 Fetch 模式启动\n'));
+      await fetchMode();
+    } catch (error) {
+      console.error(chalk.red('错误:', error.message));
+      process.exit(1);
+    }
+  });
+
+// openapi 命令
+program
+  .command('openapi <source>')
+  .description('📄 OpenAPI 模式')
+  .action(async source => {
+    try {
+      console.log(chalk.cyan('🚀 OpenAPI 模式启动\n'));
+      await openapiMode(source);
+    } catch (error) {
+      console.error(chalk.red('错误:', error.message));
+      process.exit(1);
+    }
+  });
+
+// init 命令
+program
+  .command('init')
+  .description('⚙️ 初始化项目配置')
+  .action(async () => {
+    try {
+      await initLocalConfig();
+    } catch (error) {
+      console.error(chalk.red('错误:', error.message));
+      process.exit(1);
+    }
+  });
+
+// config 命令
+program
+  .command('config')
+  .description('🔧 配置管理')
+  .option('-s, --show', '显示配置')
+  .option('-g, --global', '全局配置')
+  .action(async options => {
+    try {
+      if (options.show) {
+        showConfig();
+      } else if (options.global) {
+        await configGlobal();
+      } else {
+        showConfig();
+      }
+    } catch (error) {
+      console.error(chalk.red('错误:', error.message));
+      process.exit(1);
+    }
+  });
+
+// 解析命令
+program.parse(process.argv);
+
+// 没有参数时显示帮助
+if (process.argv.length === 2) {
+  program.outputHelp();
+}

package/core/config.js

@@ -0,0 +1,176 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const LOCAL_CONFIG_FILE = '.apirc.json';
+const GLOBAL_CONFIG_FILE = path.join(os.homedir(), '.apirc.json');
+
+const defaultConfig = {
+  defaultOutputPath: 'current',
+  timeout: 10000,
+  autoRetry: true,
+  maxRetries: 3,
+  requestModule: '@/utils/request',
+  typePrefix: '',
+  apiPrefix: '',
+  defaultMethod: 'GET',
+};
+
+function loadConfig() {
+  let config = { ...defaultConfig };
+
+  if (fs.existsSync(GLOBAL_CONFIG_FILE)) {
+    try {
+      const globalConfig = JSON.parse(
+        fs.readFileSync(GLOBAL_CONFIG_FILE, 'utf-8'),
+      );
+      config = { ...config, ...globalConfig };
+    } catch (error) {
+      console.warn('⚠️  全局配置文件解析失败');
+    }
+  }
+
+  const localConfigPath = path.join(process.cwd(), LOCAL_CONFIG_FILE);
+  if (fs.existsSync(localConfigPath)) {
+    try {
+      const localConfig = JSON.parse(fs.readFileSync(localConfigPath, 'utf-8'));
+      config = { ...config, ...localConfig };
+    } catch (error) {
+      console.warn('⚠️  项目配置文件解析失败');
+    }
+  }
+
+  return config;
+}
+
+function saveGlobalConfig(config) {
+  fs.writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(config, null, 2));
+  console.log(`✅ 全局配置已保存: ${GLOBAL_CONFIG_FILE}`);
+}
+
+function saveLocalConfig(config) {
+  const localConfigPath = path.join(process.cwd(), LOCAL_CONFIG_FILE);
+  fs.writeFileSync(localConfigPath, JSON.stringify(config, null, 2));
+  console.log(`✅ 项目配置已保存: ${localConfigPath}`);
+}
+
+async function initLocalConfig() {
+  const prompts = require('prompts');
+  const chalk = require('chalk');
+
+  const localConfigPath = path.join(process.cwd(), LOCAL_CONFIG_FILE);
+
+  if (fs.existsSync(localConfigPath)) {
+    console.log(chalk.yellow('⚠️  项目配置文件已存在: ' + LOCAL_CONFIG_FILE));
+
+    const response = await prompts({
+      type: 'confirm',
+      name: 'overwrite',
+      message: '是否覆盖现有配置？',
+      initial: false,
+    });
+
+    if (!response.overwrite) {
+      console.log(chalk.yellow('操作已取消'));
+      return false;
+    }
+  }
+
+  const projectConfig = {
+    requestModule: '@/utils/request',
+    typePrefix: '',
+    apiPrefix: '',
+  };
+
+  saveLocalConfig(projectConfig);
+  console.log(chalk.green('✅ 项目配置创建成功！'));
+  console.log(
+    chalk.gray('💡 提示: 可以使用 go-gen config --global 设置全局偏好'),
+  );
+  return true;
+}
+
+function showConfig() {
+  const config = loadConfig();
+
+  console.log('\n📋 当前生效的配置:\n');
+
+  const hasLocal = fs.existsSync(path.join(process.cwd(), LOCAL_CONFIG_FILE));
+  const hasGlobal = fs.existsSync(GLOBAL_CONFIG_FILE);
+
+  console.log('配置来源:');
+  console.log(`  ${hasGlobal ? '✅' : '❌'} 全局配置: ${GLOBAL_CONFIG_FILE}`);
+  console.log(
+    `  ${hasLocal ? '✅' : '❌'} 项目配置: ${path.join(process.cwd(), LOCAL_CONFIG_FILE)}`,
+  );
+  console.log('');
+
+  console.log('最终配置:');
+  Object.entries(config).forEach(([key, value]) => {
+    console.log(`  ${key}: ${JSON.stringify(value)}`);
+  });
+
+  console.log('\n💡 提示:');
+  console.log('  • 项目配置优先级高于全局配置');
+  console.log('  • 使用 go-gen init 创建项目配置');
+  console.log('  • 使用 go-gen config --global 设置全局偏好\n');
+}
+
+async function configGlobal() {
+  const prompts = require('prompts');
+  const chalk = require('chalk');
+
+  console.log(chalk.cyan('⚙️ 配置全局设置\n'));
+
+  const currentConfig = loadConfig();
+
+  const response = await prompts([
+    {
+      type: 'select',
+      name: 'defaultOutputPath',
+      message: '📂 默认输出路径：',
+      choices: [
+        { title: '📁 当前目录', value: 'current' },
+        { title: '💻 桌面', value: 'desktop' },
+        { title: '🔍 每次询问', value: 'ask' },
+      ],
+      initial: currentConfig.defaultOutputPath === 'desktop' ? 1 : 0,
+    },
+    {
+      type: 'number',
+      name: 'timeout',
+      message: '⏱️ 请求超时时间（毫秒）：',
+      initial: currentConfig.timeout,
+    },
+    {
+      type: 'confirm',
+      name: 'autoRetry',
+      message: '🔄 失败时自动重试：',
+      initial: currentConfig.autoRetry,
+    },
+    {
+      type: prev => (prev ? 'number' : null),
+      name: 'maxRetries',
+      message: '🔁 最大重试次数：',
+      initial: currentConfig.maxRetries,
+    },
+  ]);
+
+  if (!response.defaultOutputPath) {
+    console.log(chalk.yellow('\n✋ 操作已取消'));
+    return;
+  }
+
+  saveGlobalConfig(response);
+  console.log(chalk.green('\n✅ 全局配置已更新！\n'));
+}
+
+module.exports = {
+  loadConfig,
+  saveGlobalConfig,
+  saveLocalConfig,
+  initLocalConfig,
+  showConfig,
+  configGlobal,
+  defaultConfig,
+};