@fxri/swagger2api 1.2.15 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +60 -1
- package/README.md +115 -111
- package/dist/cli.cjs +8 -1
- package/dist/cli.d.cts +1 -1
- package/dist/cli.d.ts +1 -1
- package/dist/cli.js +8 -1
- package/dist/index.cjs +3 -1
- package/dist/index.js +3 -1
- package/dist/templates/api.ejs +30 -2
- package/dist/templates/route-docs.ejs +4 -1
- package/dist/templates/route-types.ejs +18 -3
- package/package.json +9 -9
package/CHANGELOG.md
CHANGED
|
@@ -1,4 +1,63 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Swagger 转 API
|
|
2
|
+
|
|
3
|
+
## 1.3.0
|
|
4
|
+
|
|
5
|
+
> 2026-11-21 发布
|
|
6
|
+
|
|
7
|
+
### ✨ 新增功能
|
|
8
|
+
|
|
9
|
+
- 分层配置 `.swagger2apirc.json` / `.swagger2apirc.local.json` / `~/.swagger2apirc.json`,支持段级覆盖与 `FX_S2A_*` 环境变量
|
|
10
|
+
- `swagger2api init` 交互向导与 `--from-script` 脚本迁移,`swagger2api config status` 排障命令
|
|
11
|
+
- `--config` 与 `--profile` 参数;旧命令行参数与 `saconfig.json` 保持兼容
|
|
12
|
+
- 外部 `$ref` 按官方策略校验(同源放行、其余仅公网 http(s)、逐跳校验重定向、拒绝私网与回环),不合规直接报错
|
|
13
|
+
- 注入与私网引用夹具,并在 `pnpm verify` 增加安全夹具步骤
|
|
14
|
+
- 分组输出,`output.mode = grouped`(或 `--modular`)时按组拆分多文件并补写聚合入口;每个模块文件只渲染本组接口,聚合入口共享同一个请求实例,调用形态保持 `api.<组>.<方法>`
|
|
15
|
+
- `grouping` 配置支持 rules / tag / path 三种策略与 minRoutes、maxRoutes 阈值,`--dry-run` 输出分组报表
|
|
16
|
+
- 分组命名契约,组名统一转为合法模块名——路径字符与标点作分隔、数字开头补前缀、超长截断加哈希、Windows 设备名与 `index` 等保留名追加序号;同名组各自独立并追加序号,不再合并或覆盖
|
|
17
|
+
- `grouping.names` 手工指定可读模块名,`--dry-run` 输出命名映射与重命名原因,`--dry-run --json` 输出结构化报表
|
|
18
|
+
- `swagger2api grouping` 展示标签与路径分布,交互式写入分组配置(非交互终端只输出报表);规则策略支持逐条录入「匹配方式 + 匹配值 + 组名」
|
|
19
|
+
- 向导预览「原始组名 → 模块名」,对兜底名、保留名冲突与重名组询问改名并写入 `grouping.names`,手工名非法或冲突时拒绝写入
|
|
20
|
+
- `grouping.preserveTags`(默认 true),JSDoc 的 `@tags` 保留原始标签,分组名只用于文件与类名
|
|
21
|
+
|
|
22
|
+
### 🔧 功能调整
|
|
23
|
+
|
|
24
|
+
- 生成失败不再静默——存在不合规文档时以非 0 退出,并在 stderr 指出被忽略的文档
|
|
25
|
+
- 运行时下限放宽至 node 18.12.0,构建目标同步改为 node18,CI 新增 node18 运行时回归 job
|
|
26
|
+
- `swagger-typescript-api` 降到 13.0.28,13.1 起改用 biome WASM 格式化,在 node 18 上生成即失败
|
|
27
|
+
|
|
28
|
+
### ⚡ 优化改进
|
|
29
|
+
|
|
30
|
+
- `init` 写入受管 `.gitignore` 片段,避免个人配置误入库
|
|
31
|
+
- 补充 `swagger-typescript-api` 的最小类型声明与 `package.json` 的 `types` 入口
|
|
32
|
+
- 分组模式先生成命名表再渲染,模板类名与聚合挂载同源,生成后按命名表校验文件名与类名;`--replace-tags` 先于分组执行,避免模块名被二次改写
|
|
33
|
+
- 分组结果同时输出「方法:路径 → 原始标签」映射,供模板回显
|
|
34
|
+
- `tsconfig` 开启 `skipLibCheck`,适配降级后依赖自带的声明文件
|
|
35
|
+
- `lodash` 通过 overrides 升到 4.18.1,修复其代码注入与原型污染告警
|
|
36
|
+
- `pnpm verify` 新增分组产物一致性检查(axios / fetch 各生成一次,断言不串组且可解析)与分组命名边界检查
|
|
37
|
+
- Windows 与 GitLab CI 补 node18 运行时作业,覆盖平台 × 运行时下限组合
|
|
38
|
+
|
|
39
|
+
### 🐛 问题修复
|
|
40
|
+
|
|
41
|
+
- 把官方 13.12.2 的代码注入与 SSRF 修复回移到本工具生成链(路径、枚举、默认值、servers 地址转义)
|
|
42
|
+
- 批量生成失败提示不再统一归因为安全问题,改为按实际原因查看上方输出
|
|
43
|
+
|
|
44
|
+
### 📝 文档更新
|
|
45
|
+
|
|
46
|
+
- 说明 node18 线生成器版本的已知安全告警(代码注入 / SSRF)及其适用边界
|
|
47
|
+
- README、快速开始、首页与 FAQ 更新推荐用法(init → 生成 → grouping)与分组入口
|
|
48
|
+
|
|
49
|
+
### 🧹 清理移除
|
|
50
|
+
|
|
51
|
+
- 移除 `glob` 依赖,配置文件扫描改为内部递归遍历,保持原有匹配范围、忽略规则与排序
|
|
52
|
+
|
|
53
|
+
## 1.2.16
|
|
54
|
+
|
|
55
|
+
> 2026-11-13 发布
|
|
56
|
+
|
|
57
|
+
### ⚡ 优化改进
|
|
58
|
+
|
|
59
|
+
- 文档站导航与侧栏抽为 `docs/site-nav.json` 单一数据源,站点配置只做引用展开
|
|
60
|
+
- 导航与产物校验改由工具命令执行,删除三份本地校验脚本
|
|
2
61
|
|
|
3
62
|
## 1.2.15
|
|
4
63
|
|
package/README.md
CHANGED
|
@@ -1,111 +1,115 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img src="./docs/public/logo.png" width="128" alt="Swagger 转 API">
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
# Swagger 转 API
|
|
6
|
-
|
|
7
|
-
[](https://github.com/fxri-net/swagger2api/actions/workflows/ci.yml)
|
|
8
|
-
[](https://www.npmjs.com/package/@fxri/swagger2api)
|
|
9
|
-
[](./LICENSE)
|
|
11
|
-
[](https://fxri-net.github.io/swagger2api/)
|
|
12
|
-
|
|
13
|
-
> 国内网络建议优先 [Gitee 镜像](https://gitee.com/fxri/swagger2api)(与 GitHub 同源同步);问题反馈走 [GitHub Issues](https://github.com/fxri-net/swagger2api/issues) 或 [Gitee Issues](https://gitee.com/fxri/swagger2api/issues)。
|
|
14
|
-
|
|
15
|
-
基于 [swagger-typescript-api](https://github.com/acacode/swagger-typescript-api) 封装的 CLI 工具:Swagger 文档一键转 TS/JS 格式的 API 文件。
|
|
16
|
-
|
|
17
|
-
后端给到 Swagger 文档,接口代码还要照着手写;接口一多重名 `_n` 后缀满屏;多个项目的接口配置散落各处,更新要挨个跑命令。本工具把这些沉淀为**一行命令**:配置落盘可复用,生成静默无感,调用即取即用。
|
|
18
|
-
|
|
19
|
-
- **多文档配置**:自动扫描项目下全部 `saconfig*.json`,多项目接口集中管理,搭配快速模式一行命令全量更新([怎么玩?](./docs/guide.md#多文档配置))
|
|
20
|
-
- **唯一 operationId**:接口地址 + 请求方法拼接,从源头告别 `_n` 重名后缀([拼接规则](./docs/guide.md#唯一-operationid-拼接规则))
|
|
21
|
-
- **不懂生成的代码也能用**:接口文件含请求方法与类型定义,导入即调;参数全部有默认值,交互引导填写([30 秒上手](./docs/getting-started.md))
|
|
22
|
-
|
|
23
|
-
## 🚀 30 秒上手
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
# 1.
|
|
27
|
-
pnpm dlx @fxri/swagger2api
|
|
28
|
-
|
|
29
|
-
# 2.
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
| [
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
##
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
##
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="./docs/public/logo.png" width="128" alt="Swagger 转 API">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
# Swagger 转 API
|
|
6
|
+
|
|
7
|
+
[](https://github.com/fxri-net/swagger2api/actions/workflows/ci.yml)
|
|
8
|
+
[](https://www.npmjs.com/package/@fxri/swagger2api)
|
|
9
|
+
[](./docs/getting-started.md#安装)
|
|
10
|
+
[](./LICENSE)
|
|
11
|
+
[](https://fxri-net.github.io/swagger2api/)
|
|
12
|
+
|
|
13
|
+
> 国内网络建议优先 [Gitee 镜像](https://gitee.com/fxri/swagger2api)(与 GitHub 同源同步);问题反馈走 [GitHub Issues](https://github.com/fxri-net/swagger2api/issues) 或 [Gitee Issues](https://gitee.com/fxri/swagger2api/issues)。
|
|
14
|
+
|
|
15
|
+
基于 [swagger-typescript-api](https://github.com/acacode/swagger-typescript-api) 封装的 CLI 工具:Swagger 文档一键转 TS/JS 格式的 API 文件。
|
|
16
|
+
|
|
17
|
+
后端给到 Swagger 文档,接口代码还要照着手写;接口一多重名 `_n` 后缀满屏;多个项目的接口配置散落各处,更新要挨个跑命令。本工具把这些沉淀为**一行命令**:配置落盘可复用,生成静默无感,调用即取即用。
|
|
18
|
+
|
|
19
|
+
- **多文档配置**:自动扫描项目下全部 `saconfig*.json`,多项目接口集中管理,搭配快速模式一行命令全量更新([怎么玩?](./docs/guide.md#多文档配置))
|
|
20
|
+
- **唯一 operationId**:接口地址 + 请求方法拼接,从源头告别 `_n` 重名后缀([拼接规则](./docs/guide.md#唯一-operationid-拼接规则))
|
|
21
|
+
- **不懂生成的代码也能用**:接口文件含请求方法与类型定义,导入即调;参数全部有默认值,交互引导填写([30 秒上手](./docs/getting-started.md))
|
|
22
|
+
|
|
23
|
+
## 🚀 30 秒上手
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# 1. 首次:交互式写入 .swagger2apirc.json(团队共享,可提交)
|
|
27
|
+
pnpm dlx @fxri/swagger2api init
|
|
28
|
+
|
|
29
|
+
# 2. 之后一行生成:读取配置,无参即可;换人 clone 仓库后同样两条命令
|
|
30
|
+
pnpm dlx @fxri/swagger2api
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
接口规模大时,先 `swagger2api grouping` 选择分组方式,再生成即可输出多文件 + 单一出口,详见[完整攻略 · 分组输出](./docs/guide.md#分组输出)。
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
import { Api } from "./src/api/index"
|
|
37
|
+
|
|
38
|
+
/** 请求器 */
|
|
39
|
+
export const request = new Api()
|
|
40
|
+
request.getUsers().then((res) => console.log(res))
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
完整步骤见 [快速开始](./docs/getting-started.md)。
|
|
44
|
+
|
|
45
|
+
## ✨ 能力矩阵
|
|
46
|
+
|
|
47
|
+
| 能力 | 适用场景 | 文档 |
|
|
48
|
+
| --- | --- | --- |
|
|
49
|
+
| 快速生成 | 从 Swagger JSON 生成 TS/JS 接口文件,含请求方法与类型定义 | [快速开始](./docs/getting-started.md) |
|
|
50
|
+
| 多文档配置 | 自动扫描 `./**/saconfig*.json`,多项目接口配置集中管理 | [完整攻略](./docs/guide.md#多文档配置) |
|
|
51
|
+
| 快速模式 | 配置齐全时跳过二次确认,搭配脚本一行命令静默更新 | [完整攻略](./docs/guide.md#快速模式) |
|
|
52
|
+
| 分层配置与向导 | `.swagger2apirc.json` 项目 / 个人 / 全局三层合并,`init` 向导建设配置,`config status` 排障 | [配置参考](./docs/config.md) |
|
|
53
|
+
| 分组输出 | 大文档按规则 / tag / 路径段拆分为多文件,聚合入口保持单一出口 | [完整攻略](./docs/guide.md#分组输出) |
|
|
54
|
+
| 唯一 operationId | 接口地址 + 请求方法拼接唯一 ID,可选 get 转 query 作区分 | [完整攻略](./docs/guide.md#唯一-operationid-拼接规则) |
|
|
55
|
+
| 灵活裁剪 | 移除路径参数 / 前缀索引、替换标签、移除空组件定义 | [配置参考](./docs/config.md) |
|
|
56
|
+
| 响应提取 | AxiosResponse 转移到 raw 字段,根部字段自行声明 | [完整攻略](./docs/guide.md#提取响应--extract-response-raw-err) |
|
|
57
|
+
| STA 参数透传 | swagger-typescript-api 原生参数全量可用 | [CLI 参考](./docs/cli.md) |
|
|
58
|
+
|
|
59
|
+
## 📚 文档
|
|
60
|
+
|
|
61
|
+
| 文档 | 适合谁 |
|
|
62
|
+
| --- | --- |
|
|
63
|
+
| [快速开始](./docs/getting-started.md) | 第一次接触,想 30 秒跑起来 |
|
|
64
|
+
| [完整攻略](./docs/guide.md) | 日常使用:三种模式、响应提取、配置文件 |
|
|
65
|
+
| [CLI 参考](./docs/cli.md) | 查命令、参数、默认值 |
|
|
66
|
+
| [常见问题](./docs/faq.md) | 遇到问题先来这里找 |
|
|
67
|
+
| [完整文档站](https://fxri-net.github.io/swagger2api/) | 在线阅读体验 |
|
|
68
|
+
|
|
69
|
+
## 📦 安装
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
pnpm add -D @fxri/swagger2api # 项目依赖(团队推荐,版本随仓库锁定)
|
|
73
|
+
pnpm i -g @fxri/swagger2api # 全局(个人多项目推荐)
|
|
74
|
+
pnpm dlx @fxri/swagger2api # 不安装临时执行
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
npm / yarn 用户、同名工具冲突说明见 [新手指南 · 安装](./docs/getting-started.md#安装)。
|
|
78
|
+
|
|
79
|
+
## 📁 多文档配置
|
|
80
|
+
|
|
81
|
+
默认配置文件为 `saconfig.json`;工具会扫描项目下所有 `saconfig*.json`(如 `saconfig.admin.json`、`config/saconfig.json`),多文件时提供选择列表。搭配快速模式与加载全部配置参数,`package.json` 一行脚本即可静默更新所有项目的接口代码:
|
|
82
|
+
|
|
83
|
+
```json
|
|
84
|
+
{
|
|
85
|
+
"scripts": {
|
|
86
|
+
"api": "swagger2api --axios --responses -q -rpi 0 -err -ca"
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
此功能扩展使用的话,可以作为一个独立工具使用,同时管理多个项目的接口配置。详见 [完整攻略 · 多文档配置](./docs/guide.md#多文档配置)。
|
|
92
|
+
|
|
93
|
+
## ⚙️ 环境要求
|
|
94
|
+
|
|
95
|
+
- Node.js >= 18.12.0
|
|
96
|
+
|
|
97
|
+
## 🛠️ 开发约定
|
|
98
|
+
|
|
99
|
+
验收统一执行 `pnpm verify`:步骤清单的唯一真源在 `scripts/verify.mjs`,本地与 CI 共用同一份;构建、调试与提交规则见 [AGENTS.md](./AGENTS.md)。
|
|
100
|
+
|
|
101
|
+
## 📄 版权信息
|
|
102
|
+
|
|
103
|
+
作者:唐启云 <tqy@fxri.net>
|
|
104
|
+
|
|
105
|
+
出品:方弦研究所
|
|
106
|
+
|
|
107
|
+
版权:Copyright © 2025-2026 唐启云. All rights reserved.
|
|
108
|
+
|
|
109
|
+
网站:[方弦研究信息网](https://fxri.net:444/)
|
|
110
|
+
|
|
111
|
+
协议:[MIT License](./LICENSE)
|
|
112
|
+
|
|
113
|
+
商标:"方弦®"为第42类注册商标(注册号89648411),本开源许可不授予商标使用权,详见 [TRADEMARK.md](./TRADEMARK.md)
|
|
114
|
+
|
|
115
|
+
> 方弦研究所为唐启云个人项目品牌与出品方,非独立法人实体;本软件著作权归唐启云所有。
|
package/dist/cli.cjs
CHANGED
|
@@ -1 +1,8 @@
|
|
|
1
|
-
var F=Object.create;var S=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty;var I=(e,r,o,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let i of C(r))!_.call(e,i)&&i!==o&&S(e,i,{get:()=>r[i],enumerable:!(s=N(r,i))||s.enumerable});return e};var c=(e,r,o)=>(o=e!=null?F(J(e)):{},I(r||!e||!e.__esModule?S(o,"default",{value:e,enumerable:!0}):o,e));var q=c(require("axios"),1),A=require("child_process"),j=c(require("os"),1),g=c(require("fs"),1),l=c(require("path"),1),v=c(require("prompts"),1),E=require("swagger-typescript-api");var b=e=>/^(https?:\/\/|:?\/\/)/.test(e);var f=c(require("fs"),1),w=c(require("url"),1),d=c(require("path"),1),U={},u={param:process.argv.filter((e,r)=>r>1)};function y(e,r="value",o={}){Array.isArray(e)||(e=[e]);let s;return u.param.forEach((i,m)=>{if(e.includes(i))["value"].includes(r)?s=u.param[m+1]:["array"].includes(r)?s=Array.from({length:o.length??1}).map((K,D)=>u.param[m+D+1]):s=!["false"].includes(u.param[m+1]);else return}),s}function t(e){return y(e,"key")}function p(e){return y(e,"value")}function P(e,r={}){return y(e,"array",r)??[]}function x(e,r){let o=d.default.dirname(e);f.default.existsSync(o)||f.default.mkdirSync(o,{recursive:!0}),f.default.writeFileSync(e,r)}function L(){return typeof require<"u"&&typeof module<"u"?__filename:w.default.fileURLToPath(U.url)}function R(){return typeof require<"u"&&typeof module<"u"?__dirname:d.default.dirname(L())}var T=require("glob"),a={files:[],param:{}},n={home:j.default.homedir(),enum:{}};function h(e){e&&console.log(e),process.exit()}async function G(){n.param={config:p(["--config","-c"]),configScan:t(["--config-scan","-cs"])??!0,configAll:t(["--config-all","-ca"]),quick:t(["--quick","-q"]),replaceTags:P(["--replace-tags","-rt"],{length:2}),convertGet:t(["--convert-get","-cg"]),removeParam:t(["--remove-param","-rp"]),removePrefixIndex:p(["--remove-prefix-index","-rpi"]),removeDts:t(["--remove-dts","-rd"]),removeEmptyComponents:t(["--remove-empty-components","-rec"])??!0,extractRequestQuery:p(["--extract-request-query","-erq"]),extractResponseRaw:t(["--extract-response-raw","-err"]),template:l.default.resolve(R(),"./templates")},n.config={templates:p(["--templates","-t"])??n.param.template,defaultResponseAsSuccess:t(["--default-as-success","-d"]),generateResponses:t(["--responses","-r"]),generateUnionEnums:t("--union-enums"),addReadonly:t("--add-readonly"),generateRouteTypes:t("--route-types"),generateClient:!t("--no-client"),enumNamesAsValues:t("--enum-names-as-values"),extractRequestParams:t("--extract-request-params"),extractRequestBody:t("--extract-request-body"),extractResponseBody:t("--extract-response-body"),extractResponseError:t("--extract-response-error"),modular:t("--modular"),toJS:t("--js"),moduleNameIndex:Number(p("--module-name-index")??0),moduleNameFirstTag:t("--module-name-first-tag"),httpClientType:t("--axios")?"axios":"fetch",unwrapResponseData:t("--unwrap-response-data"),disableThrowOnError:t("--disable-throw-on-error"),singleHttpClient:t("--single-http-client"),silent:t("--silent")??!0,defaultResponseType:p("--default-response")??"void",typePrefix:p("--type-prefix")??"",typeSuffix:p("--type-suffix")??"",cleanOutput:t("--clean-output"),...p("--api-class-name")?{apiClassName:p("--api-class-name")}:{},patch:t("--patch"),debug:t("--debug"),anotherArrayType:t("--another-array-type"),sortTypes:t("--sort-types"),extractEnums:t("--extract-enums")}}async function V(){n.param.config?a.files=n.param.config.split(","):n.param.configScan&&(a.files=(0,T.globSync)(["./**/saconfig*.json"],{ignore:"node_modules/**"})),a.files.length==0&&(a.files=["saconfig.json"]),!n.param.configAll&&a.files.length>1&&(a.files=(await(0,v.default)({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:a.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:h("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),a.files?.length>0||h("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function B(){try{a.param={},a.param=JSON.parse(g.default.readFileSync(a.file,"utf-8"))}catch{}(!n.param.quick||[a.param.url,a.param.output,a.param.name].includes(void 0))&&(a.param=await(0,v.default)([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:a.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:a.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:a.param.name??"index"}])),[a.param.url,a.param.output,a.param.name].includes(void 0)&&h("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),n.docFile=l.default.resolve(`${a.param.output}/${a.param.name}-${new Date().getTime()}.json`)}async function O(e=0){if(a.file=a.files[e],await B(),b(a.param.url))await q.default.get(a.param.url).then(r=>$(r.data)).catch(r=>console.log("\u5931\u8D25\uFF1A",r));else try{await $(JSON.parse(g.default.readFileSync(l.default.resolve(a.param.url),"utf8")))}catch(r){console.log("\u5931\u8D25\uFF1A",r)}a.files[e+1]&&O(e+1)}async function $(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");Object.entries(e.paths).forEach(r=>{Object.keys(r[1]).forEach(o=>{n.param.replaceTags.length&&(e.paths[r[0]][o].tags=e.paths[r[0]][o].tags?.map(m=>m.replace(new RegExp(`^${n.param.replaceTags[0]}$`,"g"),n.param.replaceTags[1]??"")));let s=`${r[0]}/${o}`;if(n.param.convertGet&&(s=s.replace(/([^\}]\/)get$/g,"$1query")),n.param.removeParam&&(s=s.replace(/\/\{.+?\}/g,"")),n.param.removePrefixIndex){let m=s.split("/");m=m.slice(0,1).concat(m.slice(Number(n.param.removePrefixIndex)+2)),s=m.join("/")}e.paths[r[0]][o].operationId=s;let i=s.split("/").slice(-1)[0];typeof n.enum[i]=="number"?n.enum[i]++:n.enum[i]=1})}),Object.entries(e.components).forEach(r=>{Object.keys(r[1]).forEach(o=>{n.param.removeEmptyComponents&&!Object.keys(e.components[r[0]][o]).length&&delete e.components[r[0]][o]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(n.enum).map(r=>r.join("-"))),x(n.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",a.file),await(0,E.generateApi)({fileName:`${a.param.name}.ts`,output:l.default.resolve(a.param.output),input:n.docFile,...n.config,param:n.param}),console.log("\u5B8C\u6210\uFF1A",l.default.resolve(a.param.output,`${a.param.name}${n.config.toJS?".js":".ts"}`)),n.config.toJS&&console.log("\u5B8C\u6210\uFF1A",l.default.resolve(a.param.output,`${a.param.name}.d.ts`)),g.default.unlinkSync(n.docFile),n.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",l.default.resolve(a.param.output,`${a.param.name}.d.ts`)),(0,A.execSync)(`npx rimraf ${l.default.resolve(a.param.output,`${a.param.name}.d.ts`)}`,{cwd:n.home}).toString()),x(a.file,JSON.stringify(a.param,null,2))}async function k(){await G(),await V(),O()}k();
|
|
1
|
+
var Ve=Object.create;var me=Object.defineProperty;var Qe=Object.getOwnPropertyDescriptor;var Ke=Object.getOwnPropertyNames;var Xe=Object.getPrototypeOf,Ze=Object.prototype.hasOwnProperty;var Ye=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of Ke(t))!Ze.call(e,s)&&s!==n&&me(e,s,{get:()=>t[s],enumerable:!(r=Qe(t,s))||r.enumerable});return e};var w=(e,t,n)=>(n=e!=null?Ve(Xe(e)):{},Ye(t||!e||!e.__esModule?me(n,"default",{value:e,enumerable:!0}):n,e));var Ge=w(require("axios"),1),Le=require("child_process"),Pe=w(require("os"),1),F=w(require("fs"),1),S=w(require("path"),1),ue=w(require("prompts"),1),Te=require("swagger-typescript-api");var Z=e=>/^(https?:\/\/|:?\/\/)/.test(e);var L=w(require("fs"),1),de=w(require("url"),1),P=w(require("path"),1),tt={},H={param:process.argv.filter((e,t)=>t>1)};function Y(e,t="value",n={}){Array.isArray(e)||(e=[e]);let r;return H.param.forEach((s,o)=>{if(e.includes(s))["value"].includes(t)?r=H.param[o+1]:["array"].includes(t)?r=Array.from({length:n.length??1}).map((i,a)=>H.param[o+a+1]):r=!["false"].includes(H.param[o+1]);else return}),r}function y(e){return Y(e,"key")}function N(e){return Y(e,"value")}function ye(e,t={}){return Y(e,"array",t)??[]}function ee(e,t){let n=P.default.dirname(e);L.default.existsSync(n)||L.default.mkdirSync(n,{recursive:!0}),L.default.writeFileSync(e,t)}function et(){return typeof require<"u"&&typeof module<"u"?__filename:de.default.fileURLToPath(tt.url)}function he(){return typeof require<"u"&&typeof module<"u"?__dirname:P.default.dirname(et())}function xe(e=process.cwd()){let t=[],n=r=>{for(let s of L.default.readdirSync(r,{withFileTypes:!0})){if(s.name.startsWith("."))continue;let o=P.default.join(r,s.name);if(s.isDirectory()){if(s.name==="node_modules")continue;n(o)}else s.isFile()&&s.name.startsWith("saconfig")&&s.name.endsWith(".json")&&t.push(P.default.relative(e,o))}};return n(e),t.sort()}function W(e){return JSON.stringify(e).slice(1,-1)}function $e(e){return e.replace(/\\/g,"\\\\").replace(/`/g,"\\`").replace(/\$\{/g,"\\${")}var ve=w(require("dns/promises"),1),re=w(require("net"),1),rt=5,T=async e=>{try{return(await ve.lookup(e,{all:!0,verbatim:!0})).map(n=>n.address)}catch{return[]}};function te(e){let t=e.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);if(!t)return!1;let n=t.slice(1).map(Number);if(n.some(o=>o>255))return!1;let[r,s]=n;return r===0||r===10||r===127||r===169&&s===254||r===172&&s>=16&&s<=31||r===192&&s===168}function nt(e){let t=e.toLowerCase();if(t==="::"||t==="::1"||t.startsWith("fe80:"))return!0;let n=t.split(":")[0]??"";if(n>="fc00"&&n<="fdff")return!0;let r=t.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);if(r?.[1])return te(r[1]);let s=t.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);if(s?.[1]&&s?.[2]){let o=parseInt(s[1],16),i=parseInt(s[2],16);return te(`${o>>8&255}.${o&255}.${i>>8&255}.${i&255}`)}return!1}function we(e){let t=re.isIP(e);return t===4?te(e):t===6?nt(e):!1}function st(e){let t=e.toLowerCase();return t==="localhost"||t.endsWith(".localhost")}async function ot(e,t=T){let n;try{n=new URL(e)}catch{return!1}if(n.protocol!=="http:"&&n.protocol!=="https:")return!1;let r=n.hostname.startsWith("[")&&n.hostname.endsWith("]")?n.hostname.slice(1,-1):n.hostname;if(st(r))return!1;if(re.isIP(r))return!we(r);let s=await t(r);return s.length===0?!1:s.every(o=>!we(o))}function it(e,t){if(typeof t!="string")return!1;try{let n=new URL(e),r=new URL(t);return n.protocol===r.protocol&&n.host===r.host}catch{return!1}}function Re(e){return e.split("#")[0]||e}async function ne(e,t,n=T){let{specSourceUrl:r,allowExplicitSpecUrl:s=!1}=t;return s&&typeof r=="string"&&Re(e)===Re(r)||typeof r=="string"&&it(e,r)?!0:ot(e,n)}function at(e,t){try{return new URL(e,t).toString()}catch{return null}}async function Se(e,t,n,r=T,s=fetch){let o=e,i=0;for(;;){if(!await ne(o,{specSourceUrl:n.specSourceUrl,allowExplicitSpecUrl:n.allowExplicitSpecUrl&&i===0},r))return null;let l=await s(o,{...t,redirect:"manual"});if(l.status>=300&&l.status<400){let c=l.headers.get("location");if(!c||i>=rt)return null;let m=at(c,o);if(!m)return null;o=m,i+=1;continue}return l}}var B=/["\\\u0000-\u001f]/;function ct(e){if(e.paths&&typeof e.paths=="object"){let t={};for(let[n,r]of Object.entries(e.paths))t[$e(n)]=r;e.paths=t}if(Array.isArray(e.servers))for(let t of e.servers)t&&typeof t.url=="string"&&(t.url=W(t.url));se(e)}function se(e){if(Array.isArray(e)){e.forEach(t=>se(t));return}if(!(!e||typeof e!="object"))for(let t of Object.keys(e)){let n=e[t];t==="enum"&&Array.isArray(n)?e[t]=n.map(r=>typeof r=="string"?W(r):r):t==="default"&&typeof n=="string"?e[t]=W(n):se(n)}}function lt(e){let t=[],n=(r,s)=>{if(Array.isArray(r)){r.forEach((o,i)=>n(o,`${s}[${i}]`));return}if(!(!r||typeof r!="object")){if(r.properties&&typeof r.properties=="object")for(let o of Object.keys(r.properties))B.test(o)&&t.push(`${s}.properties\uFF1A\u5C5E\u6027\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(Array.isArray(r.required))for(let o of r.required)typeof o=="string"&&B.test(o)&&t.push(`${s}.required\uFF1A\u5FC5\u586B\u5B57\u6BB5\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(r.discriminator&&typeof r.discriminator=="object"&&(typeof r.discriminator.propertyName=="string"&&B.test(r.discriminator.propertyName)&&t.push(`${s}.discriminator.propertyName\uFF1A\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(r.discriminator.propertyName)}`),r.discriminator.mapping&&typeof r.discriminator.mapping=="object"))for(let o of Object.keys(r.discriminator.mapping))B.test(o)&&t.push(`${s}.discriminator.mapping\uFF1A\u952E\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);for(let o of Object.keys(r))n(r[o],`${s}.${o}`)}};return n(e,"#"),t}async function pt(e,t={}){let n=[],r={baseUrl:t.baseUrl,resolve:t.resolve??T,fetchImpl:t.fetchImpl??fetch,docs:new Map,errors:n},s=async(i,a,l)=>{if(Array.isArray(i)){let m=[];for(let p=0;p<i.length;p+=1)m.push(await s(i[p],`${a}[${p}]`,l));return m}if(!i||typeof i!="object")return i;let c=i.$ref;if(typeof c=="string"&&!c.startsWith("#")){let m=await o(c,a,l);return m===null?i:s(m,a,l)}for(let m of Object.keys(i))i[m]=await s(i[m],`${a}.${m}`,l);return i},o=async(i,a,l)=>{if(!/^https?:\/\//i.test(i))return n.push(`${a}\uFF1A\u4E0D\u652F\u6301\u7684\u5916\u90E8\u5F15\u7528\uFF08\u4EC5\u5141\u8BB8\u6587\u6863\u5185 #/ \u6216 http(s)\uFF09\uFF1A${i}`),null;let c=i.indexOf("#"),m=c===-1?i:i.slice(0,c),p=c===-1?"":i.slice(c+1),f;try{f=r.baseUrl?new URL(m,r.baseUrl).toString():m}catch{return n.push(`${a}\uFF1A\u65E0\u6CD5\u89E3\u6790\u7684\u5F15\u7528\u5730\u5740\uFF1A${i}`),null}let x=`${f}#${p}`;if(l.includes(x))return n.push(`${a}\uFF1A\u68C0\u6D4B\u5230\u5F15\u7528\u73AF\uFF1A${[...l,x].join(" -> ")}`),null;if(!await ne(f,{specSourceUrl:r.baseUrl},r.resolve))return n.push(`${a}\uFF1A\u62D2\u7EDD\u62C9\u53D6\u975E\u516C\u7F51\u6216\u975E\u4FE1\u4EFB\u6765\u6E90\u7684\u5916\u90E8\u5F15\u7528\uFF1A${i}`),null;let R=await ut(f,r);if(!R)return null;let d=ft(R,p);if(d===void 0)return n.push(`${a}\uFF1A\u5F15\u7528\u7247\u6BB5\u4E0D\u5B58\u5728\uFF1A${i}`),null;let $=await s(structuredClone(d),a,[...l,x]),j=gt(e,p,$,f);return j?{$ref:`#/components/schemas/${j}`}:$};return await s(e,"#",[]),n}async function ut(e,t){if(t.docs.has(e))return t.docs.get(e);let n=await Se(e,{},{specSourceUrl:t.baseUrl},t.resolve,t.fetchImpl);if(!n?.ok)return t.errors.push(`\u5916\u90E8\u5F15\u7528\u62C9\u53D6\u5931\u8D25\uFF1A${e}`),null;let r=await n.text();try{let s=JSON.parse(r);return t.docs.set(e,s),s}catch{return t.errors.push(`\u5916\u90E8\u5F15\u7528\u6587\u6863\u4EC5\u652F\u6301 JSON \u683C\u5F0F\uFF1A${e}`),null}}function ft(e,t){if(!t||t==="/")return e;let n=e;for(let r of t.replace(/^\//,"").split("/")){if(n===null||typeof n!="object")return;let s=decodeURIComponent(r).replace(/~1/g,"/").replace(/~0/g,"~");n=n[s]}return n}function gt(e,t,n,r){let s=t.match(/^\/components\/schemas\/([^/]+)$/);if(!s)return null;let o=decodeURIComponent(s[1]).replace(/~1/g,"/").replace(/~0/g,"~");e.components=e.components??{},e.components.schemas=e.components.schemas??{};let i=e.components.schemas;if(i[o]===void 0)return i[o]=n,o;if(JSON.stringify(i[o])===JSON.stringify(n))return o;let a=(r.split("/").pop()??"ref").replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9_$]/g,"_")||"ref",l=`${o}_${a}`,c=2;for(;i[l]!==void 0&&JSON.stringify(i[l])!==JSON.stringify(n);)l=`${o}_${a}_${c}`,c+=1;return i[l]=n,l}async function Ne(e,t={}){let n=await pt(e,t);return ct(e),{errors:[...n,...lt(e)]}}var z=w(require("fs"),1),je=w(require("os"),1),O=w(require("path"),1),V=".swagger2apirc.json",mt=".swagger2apirc.local.json",dt=".swagger2apirc.json";function oe(e,t,n){let r={layer:t,file:e,hit:!1,sections:[],config:null};if(!e||!z.default.existsSync(e))return r;try{let s=JSON.parse(z.default.readFileSync(e,"utf8"));return!s||typeof s!="object"||Array.isArray(s)?(n.push(`${e}\uFF1A\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),{...r,hit:!1}):{layer:t,file:e,hit:!0,sections:Object.keys(s),config:s}}catch(s){return n.push(`${e}\uFF1A\u89E3\u6790\u5931\u8D25\uFF08${s.message}\uFF09\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),r}}function be(e,t){let n=O.default.resolve(t);for(;;){let r=O.default.join(n,e);if(z.default.existsSync(r))return r;let s=O.default.dirname(n);if(s===n)return null;n=s}}function yt(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let n={...e};for(let[r,s]of Object.entries(t))n[r]=s;return n}function ie(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let n={...e};for(let[r,s]of Object.entries(t)){let o=n[r];n[r]=o&&typeof o=="object"&&!Array.isArray(o)&&s&&typeof s=="object"&&!Array.isArray(s)?{...o,...s}:s}return n}function D(e=process.cwd(),t={}){let n=[],r=oe(O.default.join(t.homeDir??je.default.homedir(),dt),"\u5168\u5C40\u5C42",n),s=t.projectFile?O.default.resolve(t.projectFile):be(V,e),o=oe(s,"\u9879\u76EE\u5C42",n),i=oe(be(mt,e),"\u672C\u5730\u5C42",n),a=ie(yt(r.config,o.config),i.config);return{global:r,project:o,local:i,merged:a,warnings:n}}var ae=[{env:"FX_S2A_INPUT",key:"input.url",type:"string"},{env:"FX_S2A_OUTPUT",key:"output.dir",type:"string"},{env:"FX_S2A_NAME",key:"output.name",type:"string"},{env:"FX_S2A_CLIENT",key:"client.type",type:"string"},{env:"FX_S2A_LANGUAGE",key:"language.target",type:"string"},{env:"FX_S2A_CLEAN",key:"output.clean",type:"boolean"}];function ht(e,t,n){let r=t.split("."),s=e;r.forEach((o,i)=>{if(i===r.length-1){s[o]=n;return}(!s[o]||typeof s[o]!="object")&&(s[o]={}),s=s[o]})}function _(e,t=process.env){let n=e?structuredClone(e):{};for(let r of ae){let s=t[r.env];s===void 0||s===""||ht(n,r.key,r.type==="boolean"?!["0","false"].includes(s.toLowerCase()):s)}return n}function U(e,t){let n=e?structuredClone(e):{};if(!t)return n;let r=n.profiles?.[t];if(!r||typeof r!="object")return n;for(let[s,o]of Object.entries(r)){if(s==="profiles")continue;let i=n[s];n[s]=i&&typeof i=="object"&&!Array.isArray(i)&&o&&typeof o=="object"&&!Array.isArray(o)?{...i,...o}:o}return n}function J(e=process.argv.slice(2)){let t=n=>n.reduce((r,s)=>r??(e.includes(s)?e[e.indexOf(s)+1]:void 0),void 0);return{configFile:t(["--config","-c"]),profile:t(["--profile"])}}function Ce(e){let t=[];for(let n of[e.global,e.project,e.local])t.push(`${n.layer}\uFF1A${n.file??"\u672A\u547D\u4E2D"}${n.hit?`\uFF08\u6BB5\uFF1A${n.sections.join("\u3001")||"\u65E0"}\uFF09`:""}`);return t}var b=w(require("fs"),1),q=w(require("path"),1);var xt=new Set(["index","datacontracts","httpclient"]),$t=new Set(["HttpClient","RequestParams","ContentType","AxiosRequestConfig","AxiosResponse"]),wt=new Set(["con","prn","aux","nul",...Array.from({length:9},(e,t)=>`com${t+1}`),...Array.from({length:9},(e,t)=>`lpt${t+1}`)]),Ee=64;function A(e){return String(e).normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"")}function Rt(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1 $2").split(" ").filter(Boolean)}function vt(e){let t=e.normalize("NFKC"),n=[];for(let r of t.matchAll(/[A-Za-z0-9]+|[\p{L}\p{N}]+/gu)){let s=r[0];/^[A-Za-z0-9]+$/.test(s)?n.push(...Rt(s)):n.push(s)}return n}function St(e){return e.map((t,n)=>{if(/^[A-Za-z0-9]+$/.test(t)){let r=t.toLowerCase();return n===0?r:r.charAt(0).toUpperCase()+r.slice(1)}return t}).join("")}function Nt(e){let t=2166136261;for(let n of e)t^=n.codePointAt(0)??0,t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0").slice(0,6)}function Oe(e){let t=[],n=vt(e),r=St(n);return r?(/^[0-9]/.test(r)&&(r=`g${r}`,t.push("\u6570\u5B57\u5F00\u5934")),[...r].length>Ee&&(r=[...r].slice(0,Ee-6).join("")+Nt(e),t.push("\u8D85\u957F\u622A\u65AD")),{slug:r,reason:t.join("\u3001")}):{slug:"",reason:"\u540D\u79F0\u4E0D\u542B\u53EF\u7528\u5B57\u7B26"}}function ce(e){return e.charAt(0).toUpperCase()+e.slice(1)}function Ae(e,t={}){let n=[],r=[],s=[...new Set(e)].sort((f,x)=>f<x?-1:f>x?1:0),o=new Map,i=new Set;for(let[f,x]of Object.entries(t))o.set(f,x),o.set(A(f),x);let a=new Set,l=[],c=(f,x=2)=>{let h=f,R=x;for(;a.has(h.toLowerCase());)h=`${f}${R}`,R+=1;return a.add(h.toLowerCase()),h},m=new Map;for(let f of s){let x=o.get(f)??o.get(A(f));if(x===void 0)continue;i.add(f),i.add(A(f));let{slug:h}=Oe(x);if(!h){n.push(`\u624B\u5DE5\u540D\u4E0D\u53EF\u7528\uFF1A${f} \u2192 ${x}`);continue}let R=m.get(h.toLowerCase());R?n.push(`\u624B\u5DE5\u540D\u51B2\u7A81\uFF1A${R} \u4E0E ${f} \u90FD\u6307\u5411 ${h}`):m.set(h.toLowerCase(),f);let d=c(h),$=ce(d);l.push({raw:f,key:A(f),fileName:$,className:$,property:d,reason:d===h?"\u624B\u5DE5\u6307\u5B9A":"\u624B\u5DE5\u6307\u5B9A\u3001\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D",source:"manual"})}let p=1;for(let f of s){if(l.some(ze=>ze.raw===f))continue;let{slug:x,reason:h}=Oe(f),R=!x,d=x;if(R){for(;a.has(`group${p}`.toLowerCase());)p+=1;d=`group${p}`,p+=1}let $=xt.has(d.toLowerCase())||wt.has(d.toLowerCase())||$t.has(ce(d)),j=$?c(`${d}2`,3):c(d),ge=ce(j),X=[h];$?X.push("\u4E0E\u4FDD\u7559\u540D\u51B2\u7A81"):j!==d&&X.push("\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D"),l.push({raw:f,key:A(f),fileName:ge,className:ge,property:j,reason:X.filter(Boolean).join("\u3001"),source:R?"fallback":"auto"})}for(let f of Object.keys(t))!i.has(f)&&!i.has(A(f))&&r.push(`grouping.names \u4E2D\u7684\u952E\u672A\u51FA\u73B0\u5728\u672C\u6B21\u5206\u7EC4\u7ED3\u679C\uFF1A${f}`);return{entries:l,errors:n,warnings:r}}function Ie(e){let t={};for(let n of e)t[n.fileName]=n.className,t[n.fileName.charAt(0).toLowerCase()+n.fileName.slice(1)]=n.className;return t}function Q(e,t,n){let r=new Set(t.map(o=>`${o.fileName}${n}`)),s=new Set([`index${n}`,"index.d.ts",`data-contracts${n}`,`http-client${n}`,`route-types${n}`]);return e.filter(o=>o.endsWith(n)&&!o.endsWith(`.d${n}`)&&!r.has(o)&&!s.has(o)&&!o.endsWith(`_Route${n}`))}var bt=new Set(["index","data-contracts","http-client"]);function jt(e){return String(e).split(/[^A-Za-z0-9]+/).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}function Ct(e,t){if(!b.default.existsSync(e))return[];let n=[];for(let r of b.default.readdirSync(e)){if(!r.endsWith(t)||r.endsWith(`.d${t}`))continue;let s=r.slice(0,-t.length);if(bt.has(s)||s.endsWith("Route"))continue;let o=jt(s);n.push({base:s,className:o,property:o.charAt(0).toLowerCase()+o.slice(1)})}return n.sort((r,s)=>r.base.localeCompare(s.base))}function ke(e){return e.map(t=>({base:t.fileName,className:t.className,property:t.property}))}function Et(e,t,n,r){let s=t||"Api",o=e.map(c=>{let m=c.className===s?`${c.className}Module`:c.className,p=`${n?`${n.replace(/\\/g,"/")}/`:""}${c.base}`;return`import { ${c.className}${m===c.className?"":` as ${m}`} } from "./${p}"`}),i=e.map(c=>`${c.property} = new ${c.className===s?`${c.className}Module`:c.className}()`),a=e.map(c=>` this.${c.property}.instance = this.instance`);return['import { HttpClient } from "./http-client"',...o,'export * from "./data-contracts"',"","/** \u805A\u5408\u5165\u53E3\uFF1A\u5404\u6A21\u5757\u5171\u4EAB\u540C\u4E00\u4E2A\u8BF7\u6C42\u5B9E\u4F8B */",`export class ${s}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...i.map(c=>` ${c}`),""," constructor(config?: any) {"," super(config)",...a," }","}",""].join(`
|
|
2
|
+
`)}function le(e,t,n,r){let s=n?".js":".ts",o=r??Ct(e,s);if(o.length===0)return[];let i=Et(o,t,"",n),a=[],l=q.default.join(e,`index${s}`);if(b.default.writeFileSync(l,i),a.push(l),n){let c=Ot(o,t),m=q.default.join(e,"index.d.ts");b.default.writeFileSync(m,c),a.push(m)}return a}function pe(e,t,n,r={}){let s=n?".js":".ts",o=[];for(let a of t){let l=q.default.join(e,`${a.fileName}${s}`);if(!b.default.existsSync(l)){o.push(`\u7F3A\u5C11\u6A21\u5757\u6587\u4EF6\uFF1A\u671F\u671B ${a.fileName}${s}\uFF08\u539F\u59CB\u7EC4\u540D ${a.raw}\uFF09`);continue}b.default.readFileSync(l,"utf8").includes(`class ${a.className}`)||o.push(`\u7C7B\u540D\u4E0E\u547D\u540D\u8868\u4E0D\u4E00\u81F4\uFF1A${a.fileName}${s} \u671F\u671B ${a.className}`)}if(r.aggregate!==!1){let a=q.default.join(e,`index${s}`);if(!b.default.existsSync(a))o.push(`\u7F3A\u5C11\u805A\u5408\u5165\u53E3\uFF1Aindex${s}`);else{let l=b.default.readFileSync(a,"utf8");for(let c of t)l.includes(`this.${c.property}.instance = this.instance`)||o.push(`\u805A\u5408\u5165\u53E3\u7F3A\u5C11\u6A21\u5757\u6302\u8F7D\uFF1A${c.property}`)}}let i=b.default.existsSync(e)?Q(b.default.readdirSync(e),t,s):[];return{errors:o,orphans:i}}function Ot(e,t){let n=t||"Api",r=e.map(o=>{let i=o.className===n?`${o.className}Module`:o.className;return`import { ${o.className}${i===o.className?"":` as ${i}`} } from "./${o.base}"`}),s=e.map(o=>{let i=o.className===n?`${o.className}Module`:o.className;return` ${o.property}: ${i}`});return['import { HttpClient } from "./http-client"',...r,'export * from "./data-contracts"',"",`export declare class ${n}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...s," constructor(config?: any)","}",""].join(`
|
|
3
|
+
`)}var At=["get","post","put","delete","patch","head","options"];function It(e,t,n){let r=n.strategy?.length?n.strategy:["rules","tag","path"],s=n.fallback??"misc";for(let o of r)if(o==="rules")for(let[i,a]of(n.rules??[]).entries()){let l=a.match??{};if(l.prefix&&e.startsWith(l.prefix))return{group:a.group,source:"rules",ruleIndex:i};if(l.regex&&new RegExp(l.regex).test(e))return{group:a.group,source:"rules",ruleIndex:i};if(l.tag&&(t.tags??[]).includes(l.tag))return{group:a.group,source:"rules",ruleIndex:i};if(l.operationId&&t.operationId===l.operationId)return{group:a.group,source:"rules",ruleIndex:i}}else if(o==="tag"){let i=(t.tags??[])[0];if(i)return{group:String(i),source:"tag"}}else if(o==="path"){let i=e.split("/").filter(Boolean),a=n.pathDepth??0;if(i[a])return{group:i[a],source:"path"}}return{group:s,source:"fallback"}}function M(e,t){let n=t.fallback??"misc",r=[],s=new Set;for(let[p,f]of Object.entries(e.paths??{}))for(let x of At){let h=f[x];if(!h||typeof h!="object")continue;let R=It(p,h,t);R.ruleIndex!==void 0&&s.add(R.ruleIndex),r.push({path:p,method:x,operation:h,group:R.group,ruleIndex:R.ruleIndex})}let o=new Map;r.forEach(({group:p})=>o.set(p,(o.get(p)??0)+1));for(let p of r){let f=o.get(p.group)??0;if(t.minRoutes&&f<t.minRoutes&&p.group!==n)p.group=n;else if(t.maxRoutes&&f>t.maxRoutes){let h=p.path.split("/").filter(Boolean)[(t.pathDepth??0)+1];h&&(p.group=`${p.group}_${h}`)}}let i=Ae(r.map(p=>p.group),t.names),a=new Map(i.entries.map(p=>[p.raw,p])),l={},c={};for(let p of r){let f=Array.isArray(p.operation.tags)?p.operation.tags.join(", "):"";f&&(l[`${p.method.toUpperCase()}:${p.path}`]=f);let x=a.get(p.group);x&&(p.operation.tags=[x.fileName]),c[p.group]=(c[p.group]??0)+1}let m=Array.from({length:t.rules?.length??0},(p,f)=>f).filter(p=>!s.has(p));return{counts:c,originalTags:l,entries:i.entries,unmatchedRules:m,errors:i.errors,warnings:i.warnings}}var g={files:[],param:{}},u={home:Pe.default.homedir(),enum:{}},k=0,I=[],kt=()=>process.argv.includes("--dry-run"),Ft=()=>process.argv.includes("--json");function K(e,t=0){e&&console.log(e),process.exit(t)}async function Gt(){u.param={config:N(["--config","-c"]),configScan:y(["--config-scan","-cs"])??!0,configAll:y(["--config-all","-ca"]),quick:y(["--quick","-q"]),replaceTags:ye(["--replace-tags","-rt"],{length:2}),convertGet:y(["--convert-get","-cg"]),removeParam:y(["--remove-param","-rp"]),removePrefixIndex:N(["--remove-prefix-index","-rpi"]),removeDts:y(["--remove-dts","-rd"]),removeEmptyComponents:y(["--remove-empty-components","-rec"])??!0,extractRequestQuery:N(["--extract-request-query","-erq"]),extractResponseRaw:y(["--extract-response-raw","-err"]),template:S.default.resolve(he(),"./templates")},u.config={templates:N(["--templates","-t"])??u.param.template,defaultResponseAsSuccess:y(["--default-as-success","-d"]),generateResponses:y(["--responses","-r"]),generateUnionEnums:y("--union-enums"),addReadonly:y("--add-readonly"),generateRouteTypes:y("--route-types"),generateClient:!y("--no-client"),enumNamesAsValues:y("--enum-names-as-values"),extractRequestParams:y("--extract-request-params"),extractRequestBody:y("--extract-request-body"),extractResponseBody:y("--extract-response-body"),extractResponseError:y("--extract-response-error"),modular:y("--modular"),toJS:y("--js"),moduleNameIndex:Number(N("--module-name-index")??0),moduleNameFirstTag:y("--module-name-first-tag"),httpClientType:y("--axios")?"axios":"fetch",unwrapResponseData:y("--unwrap-response-data"),disableThrowOnError:y("--disable-throw-on-error"),singleHttpClient:y("--single-http-client"),silent:y("--silent")??!0,defaultResponseType:N("--default-response")??"void",typePrefix:N("--type-prefix")??"",typeSuffix:N("--type-suffix")??"",cleanOutput:y("--clean-output"),...N("--api-class-name")?{apiClassName:N("--api-class-name")}:{},patch:y("--patch"),debug:y("--debug"),anotherArrayType:y("--another-array-type"),sortTypes:y("--sort-types"),extractEnums:y("--extract-enums")},Lt()}function v(e){let t=process.argv.slice(2);return e.some(n=>t.includes(n))}function Lt(){let e=J(),t=D(process.cwd(),{projectFile:e.configFile});t.warnings.forEach(p=>console.error("\u26A0\uFE0F",p));let n=_(U(t.merged,e.profile)),r=n.input??{},s=n.output??{},o=n.types??{},i=n.naming??{},a=n.grouping??{},l=r.url??r.file;if(!l)return;u.rcDriven=!0,u.rcUrl=l,u.rcOutput=s.dir??"./src/api",u.rcName=s.name??"index";let c=u.param;c.quick=!0,!v(["--remove-prefix-index","-rpi"])&&i.pathPrefixIndex!==void 0&&(c.removePrefixIndex=String(i.pathPrefixIndex)),!v(["--convert-get","-cg"])&&i.convertGetToQuery!==void 0&&(c.convertGet=i.convertGetToQuery),!v(["--remove-param","-rp"])&&i.dropPathParams!==void 0&&(c.removeParam=i.dropPathParams),!v(["--extract-request-query","-erq"])&&o.extractQuery!==void 0&&(c.extractRequestQuery=o.extractQuery),!v(["--remove-dts","-rd"])&&o.removeDts!==void 0&&(c.removeDts=o.removeDts),!v(["--replace-tags","-rt"])&&i.tagRewrite&&(c.replaceTags=i.tagRewrite);let m=u.config;!v(["--axios"])&&n.client?.type&&(m.httpClientType=n.client.type==="axios"?"axios":"fetch"),!v(["--js"])&&n.language?.target&&(m.toJS=n.language.target==="js"),!v(["--responses","-r"])&&o.responses!==void 0&&(m.generateResponses=!!o.responses),!v(["--unwrap-response-data"])&&o.unwrapData!==void 0&&(m.unwrapResponseData=!!o.unwrapData),!v(["--extract-request-params"])&&o.extractParams!==void 0&&(m.extractRequestParams=!!o.extractParams),!v(["--clean-output"])&&s.clean!==void 0&&(m.cleanOutput=!!s.clean),!v(["--modular"])&&s.mode==="grouped"&&(m.modular=!0),!v(["--module-name-index"])&&a.pathDepth!==void 0&&(m.moduleNameIndex=Number(a.pathDepth)),Object.keys(a).length&&(m.grouping=a)}async function Pt(){if(u.rcDriven){g.files=["(swagger2apirc)"];return}u.param.config?g.files=u.param.config.split(","):u.param.configScan&&(g.files=xe()),g.files.length==0&&(g.files=["saconfig.json"]),!u.param.configAll&&g.files.length>1&&(g.files=(await(0,ue.default)({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:g.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:K("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),g.files?.length>0||K("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function Tt(){if(u.rcDriven){g.param={url:u.rcUrl,output:u.rcOutput,name:u.rcName},u.docFile=S.default.resolve(`${u.rcOutput}/${u.rcName}-${new Date().getTime()}.json`);return}try{g.param={},g.param=JSON.parse(F.default.readFileSync(g.file,"utf-8"))}catch{}(!u.param.quick||[g.param.url,g.param.output,g.param.name].includes(void 0))&&(g.param=await(0,ue.default)([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:g.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:g.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:g.param.name??"index"}])),[g.param.url,g.param.output,g.param.name].includes(void 0)&&K("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),u.docFile=S.default.resolve(`${g.param.output}/${g.param.name}-${new Date().getTime()}.json`)}async function De(e=0){if(g.file=g.files[e],await Tt(),Z(g.param.url))await Ge.default.get(g.param.url).then(t=>Fe(t.data)).catch(t=>console.log("\u5931\u8D25\uFF1A",t));else try{await Fe(JSON.parse(F.default.readFileSync(S.default.resolve(g.param.url),"utf8")))}catch(t){console.log("\u5931\u8D25\uFF1A",t)}g.files[e+1]?await De(e+1):k>0&&K(`\u7ED3\u675F\uFF1A${k} \u4E2A\u6587\u6863\u672A\u751F\u6210\uFF0C\u5931\u8D25\u539F\u56E0\u89C1\u4E0A\u65B9\u8F93\u51FA`,1)}function Dt(e){let t=u.param.replaceTags;t?.length&&Object.values(e.paths??{}).forEach(n=>{Object.values(n).forEach(r=>{Array.isArray(r?.tags)&&(r.tags=r.tags.map(s=>s.replace(new RegExp(`^${t[0]}$`,"g"),t[1]??"")))})})}function _t(e,t){let n=u.config.toJS?".js":".ts",r=S.default.resolve(g.param.output??"./src/api"),s=F.default.existsSync(r)?F.default.readdirSync(r):[],o=e.map(a=>`${a.fileName}${n}`).filter(a=>!s.includes(a)),i=Q(s,e,n);if(Ft()){console.log(JSON.stringify({groups:e.map(({raw:a,fileName:l,className:c,property:m,reason:p,source:f})=>({raw:a,fileName:l,className:c,property:m,reason:p,source:f})),unmatchedRules:t,add:o,orphans:i},null,2));return}e.forEach(a=>console.log(`\u547D\u540D\uFF1A${a.raw} \u2192 ${a.fileName}\uFF08\u7C7B ${a.className}${a.reason?`\uFF0C${a.reason}`:""}\uFF09`)),t.length&&console.error(`\u26A0\uFE0F \u672A\u547D\u4E2D\u89C4\u5219\uFF1A${t.map(a=>a+1).join("\u3001")}`),o.length&&console.log(`\u9884\u8BA1\u65B0\u589E\uFF1A${o.join("\u3001")}`),i.length&&console.error(`\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A${i.join("\u3001")}`)}async function Fe(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");let t=await Ne(e,{baseUrl:Z(g.param.url)?g.param.url:void 0});if(t.errors.length>0){t.errors.forEach(r=>console.error("\u5931\u8D25\uFF1A",r)),k+=1;return}I=[],u.param.moduleClassNames=void 0,Dt(e);let n=u.config.grouping;if(u.config.modular&&n&&(n.strategy?.length||n.rules?.length)){let r=M(e,n);if(r.warnings.forEach(s=>console.error("\u26A0\uFE0F",s)),r.errors.length>0){r.errors.forEach(s=>console.error("\u5931\u8D25\uFF1A",s)),k+=1;return}if(I=r.entries,u.config.moduleNameFirstTag=!0,u.param.moduleClassNames=Ie(r.entries),n.preserveTags!==!1&&(u.param.groupOriginalTags=r.originalTags),console.log("\u5206\u7EC4\uFF1A",...Object.entries(r.counts).map(([s,o])=>`${s}-${o}`)),kt()){_t(r.entries,r.unmatchedRules);return}}if(Object.entries(e.paths).forEach(r=>{Object.keys(r[1]).forEach(s=>{let o=`${r[0]}/${s}`;if(u.param.convertGet&&(o=o.replace(/([^\}]\/)get$/g,"$1query")),u.param.removeParam&&(o=o.replace(/\/\{.+?\}/g,"")),u.param.removePrefixIndex){let a=o.split("/");a=a.slice(0,1).concat(a.slice(Number(u.param.removePrefixIndex)+2)),o=a.join("/")}o=o.replace(/["\\`\r\n]/g,"_").replace(/\$\{/g,"_"),e.paths[r[0]][s].operationId=o;let i=o.split("/").slice(-1)[0];typeof u.enum[i]=="number"?u.enum[i]++:u.enum[i]=1})}),Object.entries(e.components).forEach(r=>{Object.keys(r[1]).forEach(s=>{u.param.removeEmptyComponents&&!Object.keys(e.components[r[0]][s]).length&&delete e.components[r[0]][s]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(u.enum).map(r=>r.join("-"))),ee(u.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",g.file),await(0,Te.generateApi)({fileName:`${g.param.name}.ts`,output:S.default.resolve(g.param.output),input:u.docFile,...u.config,param:u.param}),console.log("\u5B8C\u6210\uFF1A",S.default.resolve(g.param.output,`${g.param.name}${u.config.toJS?".js":".ts"}`)),u.config.modular){let r=S.default.resolve(g.param.output),s=String(u.config.apiClassName??"Api"),o=!!u.config.toJS;if(I.length){let i=pe(r,I,o,{aggregate:!1});if(i.errors.length>0){i.errors.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),k+=1;return}le(r,s,o,ke(I));let{errors:a,orphans:l}=pe(r,I,o);if(a.length>0){a.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),k+=1;return}l.forEach(c=>console.error("\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A",c))}else le(r,s,o)}u.config.toJS&&console.log("\u5B8C\u6210\uFF1A",S.default.resolve(g.param.output,`${g.param.name}.d.ts`)),F.default.unlinkSync(u.docFile),u.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",S.default.resolve(g.param.output,`${g.param.name}.d.ts`)),(0,Le.execSync)(`npx rimraf ${S.default.resolve(g.param.output,`${g.param.name}.d.ts`)}`,{cwd:u.home}).toString()),u.rcDriven||ee(g.file,JSON.stringify(g.param,null,2))}async function _e(){await Gt(),await Pt(),De()}var C=w(require("fs"),1),E=w(require("path"),1),G=w(require("prompts"),1),We=w(require("axios"),1);var Ue=w(require("fs"),1),Je=w(require("path"),1);function Ut(e){let t=[],n="",r=null;for(let s=0;s<e.length;s+=1){let o=e[s];if(r){o==="\\"&&r==='"'&&s+1<e.length?(n+=e[s+1],s+=1):o===r?r=null:n+=o;continue}o==='"'||o==="'"?r=o:/\s/.test(o)?(n&&t.push(n),n=""):n+=o}return n&&t.push(n),t}function Jt(e){let t={},n=[],r=(i,a,l)=>{t[i]=t[i]??{},t[i][a]=l},s={"--axios":()=>r("client","type","axios"),"--responses":()=>r("types","responses",!0),"-r":()=>r("types","responses",!0),"--js":()=>r("language","target","js"),"-cg":()=>r("naming","convertGetToQuery",!0),"--convert-get":()=>r("naming","convertGetToQuery",!0),"-rp":()=>r("naming","dropPathParams",!0),"--remove-param":()=>r("naming","dropPathParams",!0),"-err":()=>r("types","unwrapData",!0),"--extract-response-raw":()=>r("types","unwrapData",!0),"-rd":()=>r("types","removeDts",!0),"--remove-dts":()=>r("types","removeDts",!0),"--modular":()=>r("output","mode","grouped"),"--clean-output":()=>r("output","clean",!0)},o={"-rpi":i=>r("naming","pathPrefixIndex",Number(i)),"--remove-prefix-index":i=>r("naming","pathPrefixIndex",Number(i)),"-erq":i=>r("types","extractQuery",i),"--extract-request-query":i=>r("types","extractQuery",i),"--module-name-index":i=>r("grouping","pathDepth",Number(i))};for(let i=0;i<e.length;i+=1){let a=e[i];if(a==="$1"||a==="--config"||a==="-c"||a==="--quick"||a==="-q"){(a==="--config"||a==="-c")&&(i+=1);continue}if(a==="-rt"||a==="--replace-tags"){let l=e[i+1],c=e[i+2]??"";if(l!==void 0){r("naming","tagRewrite",[l,c]),i+=2;continue}}if(o[a]){o[a](e[i+1]??""),i+=1;continue}if(s[a]){s[a]();continue}a.startsWith("-")&&n.push(a)}return{config:t,unknown:n}}function qe(e,t){let n=Je.default.resolve(e),s=JSON.parse(Ue.default.readFileSync(n,"utf8")).scripts??{},o=Object.entries(s).filter(([,h])=>typeof h=="string"&&h.includes("swagger2api"));if(o.length===0)throw new Error(`\u672A\u5728 ${n} \u4E2D\u627E\u5230\u5305\u542B swagger2api \u7684\u811A\u672C`);let i=t?o.find(([h])=>h===t):o[0];if(!i)throw new Error(`${n} \u4E2D\u4E0D\u5B58\u5728\u811A\u672C ${t}`);let[a,l]=i,c=Ut(l),m=c.findIndex(h=>h.endsWith("swagger2api")||h==="swagger2api"),p=m===-1?c:c.slice(m+1),{config:f,unknown:x}=Jt(p);return{config:f,unknown:x,scriptName:a}}var Me="# @fxri/swagger2api",qt=["*.swagger2apirc.local.json"];function He(e){let t=E.default.join(e,".gitignore"),n=[`${Me} \u4E2A\u4EBA\u914D\u7F6E\u4E0D\u5165\u5E93`,...qt],r=C.default.existsSync(t)?C.default.readFileSync(t,"utf8"):"";if(r.includes(Me))return;let s=r&&!r.endsWith(`
|
|
4
|
+
`)?`${r}
|
|
5
|
+
`:r;C.default.writeFileSync(t,`${s}${n.join(`
|
|
6
|
+
`)}
|
|
7
|
+
`)}function fe(e,t){let n=C.default.existsSync(e)?JSON.parse(C.default.readFileSync(e,"utf8")):{},r=ie(n,t);C.default.mkdirSync(E.default.dirname(e),{recursive:!0}),C.default.writeFileSync(e,`${JSON.stringify(r,null,2)}
|
|
8
|
+
`)}async function Mt(){let e=await(0,G.default)([{name:"url",type:"text",message:"Swagger \u5730\u5740\u6216\u672C\u5730\u6587\u4EF6:",initial:""},{name:"dir",type:"text",message:"\u8F93\u51FA\u76EE\u5F55:",initial:"./src/api"},{name:"name",type:"text",message:"\u5165\u53E3\u6587\u4EF6\u540D:",initial:"index"},{name:"client",type:"select",message:"HTTP \u5BA2\u6237\u7AEF:",choices:[{title:"axios",value:"axios"},{title:"fetch",value:"fetch"}],initial:0},{name:"language",type:"select",message:"\u8F93\u51FA\u8BED\u8A00:",choices:[{title:"TypeScript",value:"ts"},{title:"JavaScript",value:"js"}],initial:0},{name:"responses",type:"toggle",message:"\u751F\u6210\u54CD\u5E94\u7C7B\u578B\u4FE1\u606F?",initial:!0,active:"\u662F",inactive:"\u5426"},{name:"grouped",type:"toggle",message:"\u6309\u7EC4\u62C6\u5206\u4E3A\u591A\u6587\u4EF6?",initial:!1,active:"\u662F",inactive:"\u5426"}]);return{input:{url:e.url},output:{dir:e.dir,name:e.name,mode:e.grouped?"grouped":"single"},client:{type:e.client},language:{target:e.language},types:{responses:!!e.responses}}}async function Ht(){let e=process.argv.slice(2),t=e.findIndex(i=>i==="--config"||i==="-c"),n=t===-1?E.default.join(process.cwd(),V):E.default.resolve(e[t+1]),r=e.findIndex(i=>i==="--from-script"),s=r===-1?void 0:E.default.resolve(e[r+1]??"package.json");if(s){let i=qe(s);return fe(n,i.config),He(process.cwd()),console.log(`\u5DF2\u4ECE\u811A\u672C ${i.scriptName} \u8FC1\u79FB\u914D\u7F6E\u5230 ${n}`),i.unknown.length&&console.error(`\u26A0\uFE0F \u4EE5\u4E0B\u53C2\u6570\u672A\u80FD\u8BC6\u522B\uFF0C\u8BF7\u624B\u52A8\u8865\u5145\uFF1A${i.unknown.join("\u3001")}`),i.unknown.length?1:0}if(!process.stdout.isTTY)return console.error("init \u9700\u8981\u4EA4\u4E92\u5F0F\u7EC8\u7AEF\uFF1B\u975E\u4EA4\u4E92\u73AF\u5883\u8BF7\u4F7F\u7528 --from-script \u6216\u624B\u5199\u914D\u7F6E\u6587\u4EF6"),1;let o=await Mt();return fe(n,o),He(process.cwd()),console.log(`\u5DF2\u5199\u5165\u914D\u7F6E\uFF1A${n}`),0}function Wt(){let{configFile:e,profile:t}=J(),n=D(process.cwd(),{projectFile:e}),r=_(U(n.merged,t)),s={layers:Ce(n),envOverrides:ae.filter(o=>process.env[o.env]!==void 0).map(o=>`${o.env} \u2192 ${o.key}`),profile:t??null,effective:r,warnings:n.warnings};return process.argv.includes("--json")?console.log(JSON.stringify(s,null,2)):(s.layers.forEach(o=>console.log(o)),s.envOverrides.length?console.log(`\u73AF\u5883\u53D8\u91CF\uFF1A${s.envOverrides.join("\uFF1B")}`):console.log("\u73AF\u5883\u53D8\u91CF\uFF1A\u65E0"),console.log(`\u9884\u8BBE\uFF1A${s.profile??"\u672A\u6307\u5B9A"}`),s.warnings.forEach(o=>console.error(`\u26A0\uFE0F ${o}`))),0}async function Bt(e){return/^https?:\/\//i.test(e)?(await We.default.get(e)).data:JSON.parse(C.default.readFileSync(E.default.resolve(e),"utf8"))}function zt(e){let t={},n={},r=0;for(let[s,o]of Object.entries(e.paths??{})){let i=s.split("/").filter(Boolean)[0]??"(root)";n[i]=(n[i]??0)+1;for(let a of["get","post","put","delete","patch","head","options"]){let l=o[a];if(!l||typeof l!="object")continue;r+=1;let c=(l.tags??[])[0]??"(\u65E0\u6807\u7B7E)";t[c]=(t[c]??0)+1}}return{tags:t,prefixes:n,total:r}}async function Vt(){let{configFile:e,profile:t}=J(),n=D(process.cwd(),{projectFile:e}),r=_(U(n.merged,t)),s=r.input?.url??r.input?.file;if(!s)return console.error("\u672A\u627E\u5230 input \u914D\u7F6E\uFF0C\u8BF7\u5148\u6267\u884C swagger2api init"),1;let o;try{o=await Bt(s)}catch(d){return console.error(`\u8BFB\u53D6\u6587\u6863\u5931\u8D25\uFF1A${d.message}`),1}let i=zt(o);if(console.log(`\u5171 ${i.total} \u4E2A\u63A5\u53E3`),console.log("\u6309\u6807\u7B7E\u5206\u5E03\uFF1A",...Object.entries(i.tags).map(([d,$])=>`${d}-${$}`)),console.log("\u6309\u8DEF\u5F84\u9996\u6BB5\u5206\u5E03\uFF1A",...Object.entries(i.prefixes).map(([d,$])=>`${d}-${$}`)),!process.stdout.isTTY)return console.log("\u975E\u4EA4\u4E92\u7EC8\u7AEF\uFF1A\u4EC5\u8F93\u51FA\u62A5\u8868\uFF0C\u5206\u7EC4\u89C4\u5219\u8BF7\u76F4\u63A5\u5199\u5165\u914D\u7F6E\u6587\u4EF6\u7684 grouping \u6BB5"),0;let a=await(0,G.default)([{name:"strategy",type:"select",message:"\u5206\u7EC4\u4F9D\u636E\uFF1A",choices:[{title:"\u6309\u6807\u7B7E\uFF08tag\uFF09",value:"tag"},{title:"\u6309\u8DEF\u5F84\u6BB5",value:"path"},{title:"\u6309\u663E\u5F0F\u89C4\u5219\uFF08\u7A0D\u540E\u5728\u914D\u7F6E\u91CC\u8865\uFF09",value:"rules"}],initial:0},{name:"pathDepth",type:"number",message:"\u8DEF\u5F84\u6BB5\u6DF1\u5EA6\uFF08\u6309\u8DEF\u5F84\u5206\u7EC4\u65F6\u751F\u6548\uFF09:",initial:0},{name:"minRoutes",type:"number",message:"\u5C11\u4E8E\u591A\u5C11\u63A5\u53E3\u5E76\u5165\u515C\u5E95\u7EC4:",initial:0},{name:"maxRoutes",type:"number",message:"\u591A\u4E8E\u591A\u5C11\u63A5\u53E3\u518D\u62C6\u4E00\u5C42\uFF080 \u8868\u793A\u4E0D\u62C6\uFF09:",initial:0},{name:"fallback",type:"text",message:"\u515C\u5E95\u7EC4\u540D:",initial:"misc"}]),l=[];if(a.strategy==="rules"){let d=!0;for(;d;){let $=await(0,G.default)([{name:"kind",type:"select",message:"\u89C4\u5219\u5339\u914D\u65B9\u5F0F\uFF1A",choices:[{title:"\u8DEF\u5F84\u524D\u7F00",value:"prefix"},{title:"\u6807\u7B7E",value:"tag"}],initial:0},{name:"value",type:"text",message:"\u5339\u914D\u503C\uFF08\u7559\u7A7A\u7ED3\u675F\uFF09\uFF1A"},{name:"group",type:"text",message:"\u5F52\u5165\u7EC4\u540D\uFF1A"}]);if(!$.value||!$.group)break;l.push({match:{[$.kind]:$.value},group:$.group}),d=!!(await(0,G.default)({name:"again",type:"confirm",message:"\u7EE7\u7EED\u6DFB\u52A0\u89C4\u5219\uFF1F",initial:!1})).again}}let c={strategy:[a.strategy],pathDepth:Number(a.pathDepth??0),rules:l,minRoutes:Number(a.minRoutes??0),maxRoutes:Number(a.maxRoutes??0),fallback:a.fallback||"misc",preserveTags:!0},m=r.grouping?.names??{},p=M(JSON.parse(JSON.stringify(o)),{...c,names:m});p.warnings.forEach(d=>console.error(`\u26A0\uFE0F ${d}`)),console.log("\u547D\u540D\u9884\u89C8\uFF1A"),p.entries.forEach(d=>{let $=[d.source==="fallback"?"\u515C\u5E95":d.source==="manual"?"\u624B\u5DE5":"",d.reason].filter(Boolean).join("\uFF1B");console.log(` ${d.raw} \u2192 ${d.fileName}${$?`\uFF08${$}\uFF09`:""}`)});let f={...m},x=p.entries.filter(d=>d.source!=="auto"&&d.source!=="manual"||d.reason.includes("\u91CD\u540D")||d.reason.includes("\u4FDD\u7559\u540D"));for(let d of x){let $=await(0,G.default)({name:"name",type:"text",message:`\u7EC4\u300C${d.raw}\u300D\u7684\u6A21\u5757\u540D\uFF08\u7559\u7A7A\u4FDD\u7559 ${d.fileName}\uFF09:`}),j=String($.name??"").trim();j&&(f[d.raw]=j)}Object.keys(f).length&&(c.names=f);let h=M(JSON.parse(JSON.stringify(o)),c);if(h.errors.length)return h.errors.forEach(d=>console.error(`\u5931\u8D25\uFF1A${d}`)),1;console.log("\u5C06\u5199\u5165\uFF1A",JSON.stringify(c));let R=e?E.default.resolve(e):E.default.join(process.cwd(),V);return fe(R,{grouping:c}),console.log(`\u5DF2\u5199\u5165\u5206\u7EC4\u914D\u7F6E\uFF1A${R}`),0}async function Be(e){let t=process.argv.slice(2),[n,r]=t.filter(s=>!s.startsWith("-"));if(n==="init"){process.exitCode=await Ht();return}if(n==="grouping"){process.exitCode=await Vt();return}if(n==="config"&&r==="status"){process.exitCode=Wt();return}await e()}Be(_e);
|
package/dist/cli.d.cts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
|
|
2
|
-
export {
|
|
2
|
+
export { }
|
package/dist/cli.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
|
|
2
|
-
export {
|
|
2
|
+
export { }
|
package/dist/cli.js
CHANGED
|
@@ -1 +1,8 @@
|
|
|
1
|
-
var u=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(n,o)=>(typeof require<"u"?require:n)[o]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});import E from"axios";import{execSync as T}from"child_process";import O from"os";import x from"fs";import m from"path";import P from"prompts";import{generateApi as k}from"swagger-typescript-api";var h=e=>/^(https?:\/\/|:?\/\/)/.test(e);import f from"fs";import A from"url";import v from"path";var c={param:process.argv.filter((e,n)=>n>1)};function g(e,n="value",o={}){Array.isArray(e)||(e=[e]);let s;return c.param.forEach((l,p)=>{if(e.includes(l))["value"].includes(n)?s=c.param[p+1]:["array"].includes(n)?s=Array.from({length:o.length??1}).map((J,q)=>c.param[p+q+1]):s=!["false"].includes(c.param[p+1]);else return}),s}function r(e){return g(e,"key")}function i(e){return g(e,"value")}function S(e,n={}){return g(e,"array",n)??[]}function d(e,n){let o=v.dirname(e);f.existsSync(o)||f.mkdirSync(o,{recursive:!0}),f.writeFileSync(e,n)}function j(){return typeof u<"u"&&typeof module<"u"?__filename:A.fileURLToPath(import.meta.url)}function b(){return typeof u<"u"&&typeof module<"u"?__dirname:v.dirname(j())}import{globSync as D}from"glob";var a={files:[],param:{}},t={home:O.homedir(),enum:{}};function y(e){e&&console.log(e),process.exit()}async function F(){t.param={config:i(["--config","-c"]),configScan:r(["--config-scan","-cs"])??!0,configAll:r(["--config-all","-ca"]),quick:r(["--quick","-q"]),replaceTags:S(["--replace-tags","-rt"],{length:2}),convertGet:r(["--convert-get","-cg"]),removeParam:r(["--remove-param","-rp"]),removePrefixIndex:i(["--remove-prefix-index","-rpi"]),removeDts:r(["--remove-dts","-rd"]),removeEmptyComponents:r(["--remove-empty-components","-rec"])??!0,extractRequestQuery:i(["--extract-request-query","-erq"]),extractResponseRaw:r(["--extract-response-raw","-err"]),template:m.resolve(b(),"./templates")},t.config={templates:i(["--templates","-t"])??t.param.template,defaultResponseAsSuccess:r(["--default-as-success","-d"]),generateResponses:r(["--responses","-r"]),generateUnionEnums:r("--union-enums"),addReadonly:r("--add-readonly"),generateRouteTypes:r("--route-types"),generateClient:!r("--no-client"),enumNamesAsValues:r("--enum-names-as-values"),extractRequestParams:r("--extract-request-params"),extractRequestBody:r("--extract-request-body"),extractResponseBody:r("--extract-response-body"),extractResponseError:r("--extract-response-error"),modular:r("--modular"),toJS:r("--js"),moduleNameIndex:Number(i("--module-name-index")??0),moduleNameFirstTag:r("--module-name-first-tag"),httpClientType:r("--axios")?"axios":"fetch",unwrapResponseData:r("--unwrap-response-data"),disableThrowOnError:r("--disable-throw-on-error"),singleHttpClient:r("--single-http-client"),silent:r("--silent")??!0,defaultResponseType:i("--default-response")??"void",typePrefix:i("--type-prefix")??"",typeSuffix:i("--type-suffix")??"",cleanOutput:r("--clean-output"),...i("--api-class-name")?{apiClassName:i("--api-class-name")}:{},patch:r("--patch"),debug:r("--debug"),anotherArrayType:r("--another-array-type"),sortTypes:r("--sort-types"),extractEnums:r("--extract-enums")}}async function N(){t.param.config?a.files=t.param.config.split(","):t.param.configScan&&(a.files=D(["./**/saconfig*.json"],{ignore:"node_modules/**"})),a.files.length==0&&(a.files=["saconfig.json"]),!t.param.configAll&&a.files.length>1&&(a.files=(await P({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:a.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:y("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),a.files?.length>0||y("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function C(){try{a.param={},a.param=JSON.parse(x.readFileSync(a.file,"utf-8"))}catch{}(!t.param.quick||[a.param.url,a.param.output,a.param.name].includes(void 0))&&(a.param=await P([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:a.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:a.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:a.param.name??"index"}])),[a.param.url,a.param.output,a.param.name].includes(void 0)&&y("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),t.docFile=m.resolve(`${a.param.output}/${a.param.name}-${new Date().getTime()}.json`)}async function R(e=0){if(a.file=a.files[e],await C(),h(a.param.url))await E.get(a.param.url).then(n=>w(n.data)).catch(n=>console.log("\u5931\u8D25\uFF1A",n));else try{await w(JSON.parse(x.readFileSync(m.resolve(a.param.url),"utf8")))}catch(n){console.log("\u5931\u8D25\uFF1A",n)}a.files[e+1]&&R(e+1)}async function w(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");Object.entries(e.paths).forEach(n=>{Object.keys(n[1]).forEach(o=>{t.param.replaceTags.length&&(e.paths[n[0]][o].tags=e.paths[n[0]][o].tags?.map(p=>p.replace(new RegExp(`^${t.param.replaceTags[0]}$`,"g"),t.param.replaceTags[1]??"")));let s=`${n[0]}/${o}`;if(t.param.convertGet&&(s=s.replace(/([^\}]\/)get$/g,"$1query")),t.param.removeParam&&(s=s.replace(/\/\{.+?\}/g,"")),t.param.removePrefixIndex){let p=s.split("/");p=p.slice(0,1).concat(p.slice(Number(t.param.removePrefixIndex)+2)),s=p.join("/")}e.paths[n[0]][o].operationId=s;let l=s.split("/").slice(-1)[0];typeof t.enum[l]=="number"?t.enum[l]++:t.enum[l]=1})}),Object.entries(e.components).forEach(n=>{Object.keys(n[1]).forEach(o=>{t.param.removeEmptyComponents&&!Object.keys(e.components[n[0]][o]).length&&delete e.components[n[0]][o]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(t.enum).map(n=>n.join("-"))),d(t.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",a.file),await k({fileName:`${a.param.name}.ts`,output:m.resolve(a.param.output),input:t.docFile,...t.config,param:t.param}),console.log("\u5B8C\u6210\uFF1A",m.resolve(a.param.output,`${a.param.name}${t.config.toJS?".js":".ts"}`)),t.config.toJS&&console.log("\u5B8C\u6210\uFF1A",m.resolve(a.param.output,`${a.param.name}.d.ts`)),x.unlinkSync(t.docFile),t.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",m.resolve(a.param.output,`${a.param.name}.d.ts`)),T(`npx rimraf ${m.resolve(a.param.output,`${a.param.name}.d.ts`)}`,{cwd:t.home}).toString()),d(a.file,JSON.stringify(a.param,null,2))}async function $(){await F(),await N(),R()}$();
|
|
1
|
+
var K=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(t,n)=>(typeof require<"u"?require:t)[n]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});import ht from"axios";import{execSync as xt}from"child_process";import $t from"os";import D from"fs";import S from"path";import Ae from"prompts";import{generateApi as wt}from"swagger-typescript-api";var X=e=>/^(https?:\/\/|:?\/\/)/.test(e);import J from"fs";import De from"url";import q from"path";var U={param:process.argv.filter((e,t)=>t>1)};function Z(e,t="value",n={}){Array.isArray(e)||(e=[e]);let r;return U.param.forEach((s,o)=>{if(e.includes(s))["value"].includes(t)?r=U.param[o+1]:["array"].includes(t)?r=Array.from({length:n.length??1}).map((i,a)=>U.param[o+a+1]):r=!["false"].includes(U.param[o+1]);else return}),r}function y(e){return Z(e,"key")}function v(e){return Z(e,"value")}function ge(e,t={}){return Z(e,"array",t)??[]}function Y(e,t){let n=q.dirname(e);J.existsSync(n)||J.mkdirSync(n,{recursive:!0}),J.writeFileSync(e,t)}function _e(){return typeof K<"u"&&typeof module<"u"?__filename:De.fileURLToPath(import.meta.url)}function me(){return typeof K<"u"&&typeof module<"u"?__dirname:q.dirname(_e())}function de(e=process.cwd()){let t=[],n=r=>{for(let s of J.readdirSync(r,{withFileTypes:!0})){if(s.name.startsWith("."))continue;let o=q.join(r,s.name);if(s.isDirectory()){if(s.name==="node_modules")continue;n(o)}else s.isFile()&&s.name.startsWith("saconfig")&&s.name.endsWith(".json")&&t.push(q.relative(e,o))}};return n(e),t.sort()}function M(e){return JSON.stringify(e).slice(1,-1)}function ye(e){return e.replace(/\\/g,"\\\\").replace(/`/g,"\\`").replace(/\$\{/g,"\\${")}import*as $e from"dns/promises";import*as te from"net";var Ue=5,I=async e=>{try{return(await $e.lookup(e,{all:!0,verbatim:!0})).map(n=>n.address)}catch{return[]}};function ee(e){let t=e.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);if(!t)return!1;let n=t.slice(1).map(Number);if(n.some(o=>o>255))return!1;let[r,s]=n;return r===0||r===10||r===127||r===169&&s===254||r===172&&s>=16&&s<=31||r===192&&s===168}function Je(e){let t=e.toLowerCase();if(t==="::"||t==="::1"||t.startsWith("fe80:"))return!0;let n=t.split(":")[0]??"";if(n>="fc00"&&n<="fdff")return!0;let r=t.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);if(r?.[1])return ee(r[1]);let s=t.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);if(s?.[1]&&s?.[2]){let o=parseInt(s[1],16),i=parseInt(s[2],16);return ee(`${o>>8&255}.${o&255}.${i>>8&255}.${i&255}`)}return!1}function he(e){let t=te.isIP(e);return t===4?ee(e):t===6?Je(e):!1}function qe(e){let t=e.toLowerCase();return t==="localhost"||t.endsWith(".localhost")}async function Me(e,t=I){let n;try{n=new URL(e)}catch{return!1}if(n.protocol!=="http:"&&n.protocol!=="https:")return!1;let r=n.hostname.startsWith("[")&&n.hostname.endsWith("]")?n.hostname.slice(1,-1):n.hostname;if(qe(r))return!1;if(te.isIP(r))return!he(r);let s=await t(r);return s.length===0?!1:s.every(o=>!he(o))}function He(e,t){if(typeof t!="string")return!1;try{let n=new URL(e),r=new URL(t);return n.protocol===r.protocol&&n.host===r.host}catch{return!1}}function xe(e){return e.split("#")[0]||e}async function re(e,t,n=I){let{specSourceUrl:r,allowExplicitSpecUrl:s=!1}=t;return s&&typeof r=="string"&&xe(e)===xe(r)||typeof r=="string"&&He(e,r)?!0:Me(e,n)}function We(e,t){try{return new URL(e,t).toString()}catch{return null}}async function we(e,t,n,r=I,s=fetch){let o=e,i=0;for(;;){if(!await re(o,{specSourceUrl:n.specSourceUrl,allowExplicitSpecUrl:n.allowExplicitSpecUrl&&i===0},r))return null;let l=await s(o,{...t,redirect:"manual"});if(l.status>=300&&l.status<400){let c=l.headers.get("location");if(!c||i>=Ue)return null;let m=We(c,o);if(!m)return null;o=m,i+=1;continue}return l}}var H=/["\\\u0000-\u001f]/;function Be(e){if(e.paths&&typeof e.paths=="object"){let t={};for(let[n,r]of Object.entries(e.paths))t[ye(n)]=r;e.paths=t}if(Array.isArray(e.servers))for(let t of e.servers)t&&typeof t.url=="string"&&(t.url=M(t.url));ne(e)}function ne(e){if(Array.isArray(e)){e.forEach(t=>ne(t));return}if(!(!e||typeof e!="object"))for(let t of Object.keys(e)){let n=e[t];t==="enum"&&Array.isArray(n)?e[t]=n.map(r=>typeof r=="string"?M(r):r):t==="default"&&typeof n=="string"?e[t]=M(n):ne(n)}}function ze(e){let t=[],n=(r,s)=>{if(Array.isArray(r)){r.forEach((o,i)=>n(o,`${s}[${i}]`));return}if(!(!r||typeof r!="object")){if(r.properties&&typeof r.properties=="object")for(let o of Object.keys(r.properties))H.test(o)&&t.push(`${s}.properties\uFF1A\u5C5E\u6027\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(Array.isArray(r.required))for(let o of r.required)typeof o=="string"&&H.test(o)&&t.push(`${s}.required\uFF1A\u5FC5\u586B\u5B57\u6BB5\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(r.discriminator&&typeof r.discriminator=="object"&&(typeof r.discriminator.propertyName=="string"&&H.test(r.discriminator.propertyName)&&t.push(`${s}.discriminator.propertyName\uFF1A\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(r.discriminator.propertyName)}`),r.discriminator.mapping&&typeof r.discriminator.mapping=="object"))for(let o of Object.keys(r.discriminator.mapping))H.test(o)&&t.push(`${s}.discriminator.mapping\uFF1A\u952E\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);for(let o of Object.keys(r))n(r[o],`${s}.${o}`)}};return n(e,"#"),t}async function Ve(e,t={}){let n=[],r={baseUrl:t.baseUrl,resolve:t.resolve??I,fetchImpl:t.fetchImpl??fetch,docs:new Map,errors:n},s=async(i,a,l)=>{if(Array.isArray(i)){let m=[];for(let p=0;p<i.length;p+=1)m.push(await s(i[p],`${a}[${p}]`,l));return m}if(!i||typeof i!="object")return i;let c=i.$ref;if(typeof c=="string"&&!c.startsWith("#")){let m=await o(c,a,l);return m===null?i:s(m,a,l)}for(let m of Object.keys(i))i[m]=await s(i[m],`${a}.${m}`,l);return i},o=async(i,a,l)=>{if(!/^https?:\/\//i.test(i))return n.push(`${a}\uFF1A\u4E0D\u652F\u6301\u7684\u5916\u90E8\u5F15\u7528\uFF08\u4EC5\u5141\u8BB8\u6587\u6863\u5185 #/ \u6216 http(s)\uFF09\uFF1A${i}`),null;let c=i.indexOf("#"),m=c===-1?i:i.slice(0,c),p=c===-1?"":i.slice(c+1),f;try{f=r.baseUrl?new URL(m,r.baseUrl).toString():m}catch{return n.push(`${a}\uFF1A\u65E0\u6CD5\u89E3\u6790\u7684\u5F15\u7528\u5730\u5740\uFF1A${i}`),null}let x=`${f}#${p}`;if(l.includes(x))return n.push(`${a}\uFF1A\u68C0\u6D4B\u5230\u5F15\u7528\u73AF\uFF1A${[...l,x].join(" -> ")}`),null;if(!await re(f,{specSourceUrl:r.baseUrl},r.resolve))return n.push(`${a}\uFF1A\u62D2\u7EDD\u62C9\u53D6\u975E\u516C\u7F51\u6216\u975E\u4FE1\u4EFB\u6765\u6E90\u7684\u5916\u90E8\u5F15\u7528\uFF1A${i}`),null;let w=await Qe(f,r);if(!w)return null;let d=Ke(w,p);if(d===void 0)return n.push(`${a}\uFF1A\u5F15\u7528\u7247\u6BB5\u4E0D\u5B58\u5728\uFF1A${i}`),null;let $=await s(structuredClone(d),a,[...l,x]),N=Xe(e,p,$,f);return N?{$ref:`#/components/schemas/${N}`}:$};return await s(e,"#",[]),n}async function Qe(e,t){if(t.docs.has(e))return t.docs.get(e);let n=await we(e,{},{specSourceUrl:t.baseUrl},t.resolve,t.fetchImpl);if(!n?.ok)return t.errors.push(`\u5916\u90E8\u5F15\u7528\u62C9\u53D6\u5931\u8D25\uFF1A${e}`),null;let r=await n.text();try{let s=JSON.parse(r);return t.docs.set(e,s),s}catch{return t.errors.push(`\u5916\u90E8\u5F15\u7528\u6587\u6863\u4EC5\u652F\u6301 JSON \u683C\u5F0F\uFF1A${e}`),null}}function Ke(e,t){if(!t||t==="/")return e;let n=e;for(let r of t.replace(/^\//,"").split("/")){if(n===null||typeof n!="object")return;let s=decodeURIComponent(r).replace(/~1/g,"/").replace(/~0/g,"~");n=n[s]}return n}function Xe(e,t,n,r){let s=t.match(/^\/components\/schemas\/([^/]+)$/);if(!s)return null;let o=decodeURIComponent(s[1]).replace(/~1/g,"/").replace(/~0/g,"~");e.components=e.components??{},e.components.schemas=e.components.schemas??{};let i=e.components.schemas;if(i[o]===void 0)return i[o]=n,o;if(JSON.stringify(i[o])===JSON.stringify(n))return o;let a=(r.split("/").pop()??"ref").replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9_$]/g,"_")||"ref",l=`${o}_${a}`,c=2;for(;i[l]!==void 0&&JSON.stringify(i[l])!==JSON.stringify(n);)l=`${o}_${a}_${c}`,c+=1;return i[l]=n,l}async function Re(e,t={}){let n=await Ve(e,t);return Be(e),{errors:[...n,...ze(e)]}}import oe from"fs";import Ze from"os";import k from"path";var W=".swagger2apirc.json",Ye=".swagger2apirc.local.json",et=".swagger2apirc.json";function se(e,t,n){let r={layer:t,file:e,hit:!1,sections:[],config:null};if(!e||!oe.existsSync(e))return r;try{let s=JSON.parse(oe.readFileSync(e,"utf8"));return!s||typeof s!="object"||Array.isArray(s)?(n.push(`${e}\uFF1A\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),{...r,hit:!1}):{layer:t,file:e,hit:!0,sections:Object.keys(s),config:s}}catch(s){return n.push(`${e}\uFF1A\u89E3\u6790\u5931\u8D25\uFF08${s.message}\uFF09\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),r}}function ve(e,t){let n=k.resolve(t);for(;;){let r=k.join(n,e);if(oe.existsSync(r))return r;let s=k.dirname(n);if(s===n)return null;n=s}}function tt(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let n={...e};for(let[r,s]of Object.entries(t))n[r]=s;return n}function ie(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let n={...e};for(let[r,s]of Object.entries(t)){let o=n[r];n[r]=o&&typeof o=="object"&&!Array.isArray(o)&&s&&typeof s=="object"&&!Array.isArray(s)?{...o,...s}:s}return n}function F(e=process.cwd(),t={}){let n=[],r=se(k.join(t.homeDir??Ze.homedir(),et),"\u5168\u5C40\u5C42",n),s=t.projectFile?k.resolve(t.projectFile):ve(W,e),o=se(s,"\u9879\u76EE\u5C42",n),i=se(ve(Ye,e),"\u672C\u5730\u5C42",n),a=ie(tt(r.config,o.config),i.config);return{global:r,project:o,local:i,merged:a,warnings:n}}var ae=[{env:"FX_S2A_INPUT",key:"input.url",type:"string"},{env:"FX_S2A_OUTPUT",key:"output.dir",type:"string"},{env:"FX_S2A_NAME",key:"output.name",type:"string"},{env:"FX_S2A_CLIENT",key:"client.type",type:"string"},{env:"FX_S2A_LANGUAGE",key:"language.target",type:"string"},{env:"FX_S2A_CLEAN",key:"output.clean",type:"boolean"}];function rt(e,t,n){let r=t.split("."),s=e;r.forEach((o,i)=>{if(i===r.length-1){s[o]=n;return}(!s[o]||typeof s[o]!="object")&&(s[o]={}),s=s[o]})}function G(e,t=process.env){let n=e?structuredClone(e):{};for(let r of ae){let s=t[r.env];s===void 0||s===""||rt(n,r.key,r.type==="boolean"?!["0","false"].includes(s.toLowerCase()):s)}return n}function L(e,t){let n=e?structuredClone(e):{};if(!t)return n;let r=n.profiles?.[t];if(!r||typeof r!="object")return n;for(let[s,o]of Object.entries(r)){if(s==="profiles")continue;let i=n[s];n[s]=i&&typeof i=="object"&&!Array.isArray(i)&&o&&typeof o=="object"&&!Array.isArray(o)?{...i,...o}:o}return n}function P(e=process.argv.slice(2)){let t=n=>n.reduce((r,s)=>r??(e.includes(s)?e[e.indexOf(s)+1]:void 0),void 0);return{configFile:t(["--config","-c"]),profile:t(["--profile"])}}function Se(e){let t=[];for(let n of[e.global,e.project,e.local])t.push(`${n.layer}\uFF1A${n.file??"\u672A\u547D\u4E2D"}${n.hit?`\uFF08\u6BB5\uFF1A${n.sections.join("\u3001")||"\u65E0"}\uFF09`:""}`);return t}import b from"fs";import z from"path";var nt=new Set(["index","datacontracts","httpclient"]),st=new Set(["HttpClient","RequestParams","ContentType","AxiosRequestConfig","AxiosResponse"]),ot=new Set(["con","prn","aux","nul",...Array.from({length:9},(e,t)=>`com${t+1}`),...Array.from({length:9},(e,t)=>`lpt${t+1}`)]),Ne=64;function E(e){return String(e).normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"")}function it(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1 $2").split(" ").filter(Boolean)}function at(e){let t=e.normalize("NFKC"),n=[];for(let r of t.matchAll(/[A-Za-z0-9]+|[\p{L}\p{N}]+/gu)){let s=r[0];/^[A-Za-z0-9]+$/.test(s)?n.push(...it(s)):n.push(s)}return n}function ct(e){return e.map((t,n)=>{if(/^[A-Za-z0-9]+$/.test(t)){let r=t.toLowerCase();return n===0?r:r.charAt(0).toUpperCase()+r.slice(1)}return t}).join("")}function lt(e){let t=2166136261;for(let n of e)t^=n.codePointAt(0)??0,t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0").slice(0,6)}function be(e){let t=[],n=at(e),r=ct(n);return r?(/^[0-9]/.test(r)&&(r=`g${r}`,t.push("\u6570\u5B57\u5F00\u5934")),[...r].length>Ne&&(r=[...r].slice(0,Ne-6).join("")+lt(e),t.push("\u8D85\u957F\u622A\u65AD")),{slug:r,reason:t.join("\u3001")}):{slug:"",reason:"\u540D\u79F0\u4E0D\u542B\u53EF\u7528\u5B57\u7B26"}}function ce(e){return e.charAt(0).toUpperCase()+e.slice(1)}function je(e,t={}){let n=[],r=[],s=[...new Set(e)].sort((f,x)=>f<x?-1:f>x?1:0),o=new Map,i=new Set;for(let[f,x]of Object.entries(t))o.set(f,x),o.set(E(f),x);let a=new Set,l=[],c=(f,x=2)=>{let h=f,w=x;for(;a.has(h.toLowerCase());)h=`${f}${w}`,w+=1;return a.add(h.toLowerCase()),h},m=new Map;for(let f of s){let x=o.get(f)??o.get(E(f));if(x===void 0)continue;i.add(f),i.add(E(f));let{slug:h}=be(x);if(!h){n.push(`\u624B\u5DE5\u540D\u4E0D\u53EF\u7528\uFF1A${f} \u2192 ${x}`);continue}let w=m.get(h.toLowerCase());w?n.push(`\u624B\u5DE5\u540D\u51B2\u7A81\uFF1A${w} \u4E0E ${f} \u90FD\u6307\u5411 ${h}`):m.set(h.toLowerCase(),f);let d=c(h),$=ce(d);l.push({raw:f,key:E(f),fileName:$,className:$,property:d,reason:d===h?"\u624B\u5DE5\u6307\u5B9A":"\u624B\u5DE5\u6307\u5B9A\u3001\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D",source:"manual"})}let p=1;for(let f of s){if(l.some(Te=>Te.raw===f))continue;let{slug:x,reason:h}=be(f),w=!x,d=x;if(w){for(;a.has(`group${p}`.toLowerCase());)p+=1;d=`group${p}`,p+=1}let $=nt.has(d.toLowerCase())||ot.has(d.toLowerCase())||st.has(ce(d)),N=$?c(`${d}2`,3):c(d),fe=ce(N),Q=[h];$?Q.push("\u4E0E\u4FDD\u7559\u540D\u51B2\u7A81"):N!==d&&Q.push("\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D"),l.push({raw:f,key:E(f),fileName:fe,className:fe,property:N,reason:Q.filter(Boolean).join("\u3001"),source:w?"fallback":"auto"})}for(let f of Object.keys(t))!i.has(f)&&!i.has(E(f))&&r.push(`grouping.names \u4E2D\u7684\u952E\u672A\u51FA\u73B0\u5728\u672C\u6B21\u5206\u7EC4\u7ED3\u679C\uFF1A${f}`);return{entries:l,errors:n,warnings:r}}function Ce(e){let t={};for(let n of e)t[n.fileName]=n.className,t[n.fileName.charAt(0).toLowerCase()+n.fileName.slice(1)]=n.className;return t}function B(e,t,n){let r=new Set(t.map(o=>`${o.fileName}${n}`)),s=new Set([`index${n}`,"index.d.ts",`data-contracts${n}`,`http-client${n}`,`route-types${n}`]);return e.filter(o=>o.endsWith(n)&&!o.endsWith(`.d${n}`)&&!r.has(o)&&!s.has(o)&&!o.endsWith(`_Route${n}`))}var pt=new Set(["index","data-contracts","http-client"]);function ut(e){return String(e).split(/[^A-Za-z0-9]+/).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}function ft(e,t){if(!b.existsSync(e))return[];let n=[];for(let r of b.readdirSync(e)){if(!r.endsWith(t)||r.endsWith(`.d${t}`))continue;let s=r.slice(0,-t.length);if(pt.has(s)||s.endsWith("Route"))continue;let o=ut(s);n.push({base:s,className:o,property:o.charAt(0).toLowerCase()+o.slice(1)})}return n.sort((r,s)=>r.base.localeCompare(s.base))}function Ee(e){return e.map(t=>({base:t.fileName,className:t.className,property:t.property}))}function gt(e,t,n,r){let s=t||"Api",o=e.map(c=>{let m=c.className===s?`${c.className}Module`:c.className,p=`${n?`${n.replace(/\\/g,"/")}/`:""}${c.base}`;return`import { ${c.className}${m===c.className?"":` as ${m}`} } from "./${p}"`}),i=e.map(c=>`${c.property} = new ${c.className===s?`${c.className}Module`:c.className}()`),a=e.map(c=>` this.${c.property}.instance = this.instance`);return['import { HttpClient } from "./http-client"',...o,'export * from "./data-contracts"',"","/** \u805A\u5408\u5165\u53E3\uFF1A\u5404\u6A21\u5757\u5171\u4EAB\u540C\u4E00\u4E2A\u8BF7\u6C42\u5B9E\u4F8B */",`export class ${s}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...i.map(c=>` ${c}`),""," constructor(config?: any) {"," super(config)",...a," }","}",""].join(`
|
|
2
|
+
`)}function le(e,t,n,r){let s=n?".js":".ts",o=r??ft(e,s);if(o.length===0)return[];let i=gt(o,t,"",n),a=[],l=z.join(e,`index${s}`);if(b.writeFileSync(l,i),a.push(l),n){let c=mt(o,t),m=z.join(e,"index.d.ts");b.writeFileSync(m,c),a.push(m)}return a}function pe(e,t,n,r={}){let s=n?".js":".ts",o=[];for(let a of t){let l=z.join(e,`${a.fileName}${s}`);if(!b.existsSync(l)){o.push(`\u7F3A\u5C11\u6A21\u5757\u6587\u4EF6\uFF1A\u671F\u671B ${a.fileName}${s}\uFF08\u539F\u59CB\u7EC4\u540D ${a.raw}\uFF09`);continue}b.readFileSync(l,"utf8").includes(`class ${a.className}`)||o.push(`\u7C7B\u540D\u4E0E\u547D\u540D\u8868\u4E0D\u4E00\u81F4\uFF1A${a.fileName}${s} \u671F\u671B ${a.className}`)}if(r.aggregate!==!1){let a=z.join(e,`index${s}`);if(!b.existsSync(a))o.push(`\u7F3A\u5C11\u805A\u5408\u5165\u53E3\uFF1Aindex${s}`);else{let l=b.readFileSync(a,"utf8");for(let c of t)l.includes(`this.${c.property}.instance = this.instance`)||o.push(`\u805A\u5408\u5165\u53E3\u7F3A\u5C11\u6A21\u5757\u6302\u8F7D\uFF1A${c.property}`)}}let i=b.existsSync(e)?B(b.readdirSync(e),t,s):[];return{errors:o,orphans:i}}function mt(e,t){let n=t||"Api",r=e.map(o=>{let i=o.className===n?`${o.className}Module`:o.className;return`import { ${o.className}${i===o.className?"":` as ${i}`} } from "./${o.base}"`}),s=e.map(o=>{let i=o.className===n?`${o.className}Module`:o.className;return` ${o.property}: ${i}`});return['import { HttpClient } from "./http-client"',...r,'export * from "./data-contracts"',"",`export declare class ${n}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...s," constructor(config?: any)","}",""].join(`
|
|
3
|
+
`)}var dt=["get","post","put","delete","patch","head","options"];function yt(e,t,n){let r=n.strategy?.length?n.strategy:["rules","tag","path"],s=n.fallback??"misc";for(let o of r)if(o==="rules")for(let[i,a]of(n.rules??[]).entries()){let l=a.match??{};if(l.prefix&&e.startsWith(l.prefix))return{group:a.group,source:"rules",ruleIndex:i};if(l.regex&&new RegExp(l.regex).test(e))return{group:a.group,source:"rules",ruleIndex:i};if(l.tag&&(t.tags??[]).includes(l.tag))return{group:a.group,source:"rules",ruleIndex:i};if(l.operationId&&t.operationId===l.operationId)return{group:a.group,source:"rules",ruleIndex:i}}else if(o==="tag"){let i=(t.tags??[])[0];if(i)return{group:String(i),source:"tag"}}else if(o==="path"){let i=e.split("/").filter(Boolean),a=n.pathDepth??0;if(i[a])return{group:i[a],source:"path"}}return{group:s,source:"fallback"}}function T(e,t){let n=t.fallback??"misc",r=[],s=new Set;for(let[p,f]of Object.entries(e.paths??{}))for(let x of dt){let h=f[x];if(!h||typeof h!="object")continue;let w=yt(p,h,t);w.ruleIndex!==void 0&&s.add(w.ruleIndex),r.push({path:p,method:x,operation:h,group:w.group,ruleIndex:w.ruleIndex})}let o=new Map;r.forEach(({group:p})=>o.set(p,(o.get(p)??0)+1));for(let p of r){let f=o.get(p.group)??0;if(t.minRoutes&&f<t.minRoutes&&p.group!==n)p.group=n;else if(t.maxRoutes&&f>t.maxRoutes){let h=p.path.split("/").filter(Boolean)[(t.pathDepth??0)+1];h&&(p.group=`${p.group}_${h}`)}}let i=je(r.map(p=>p.group),t.names),a=new Map(i.entries.map(p=>[p.raw,p])),l={},c={};for(let p of r){let f=Array.isArray(p.operation.tags)?p.operation.tags.join(", "):"";f&&(l[`${p.method.toUpperCase()}:${p.path}`]=f);let x=a.get(p.group);x&&(p.operation.tags=[x.fileName]),c[p.group]=(c[p.group]??0)+1}let m=Array.from({length:t.rules?.length??0},(p,f)=>f).filter(p=>!s.has(p));return{counts:c,originalTags:l,entries:i.entries,unmatchedRules:m,errors:i.errors,warnings:i.warnings}}var g={files:[],param:{}},u={home:$t.homedir(),enum:{}},A=0,O=[],Rt=()=>process.argv.includes("--dry-run"),vt=()=>process.argv.includes("--json");function V(e,t=0){e&&console.log(e),process.exit(t)}async function St(){u.param={config:v(["--config","-c"]),configScan:y(["--config-scan","-cs"])??!0,configAll:y(["--config-all","-ca"]),quick:y(["--quick","-q"]),replaceTags:ge(["--replace-tags","-rt"],{length:2}),convertGet:y(["--convert-get","-cg"]),removeParam:y(["--remove-param","-rp"]),removePrefixIndex:v(["--remove-prefix-index","-rpi"]),removeDts:y(["--remove-dts","-rd"]),removeEmptyComponents:y(["--remove-empty-components","-rec"])??!0,extractRequestQuery:v(["--extract-request-query","-erq"]),extractResponseRaw:y(["--extract-response-raw","-err"]),template:S.resolve(me(),"./templates")},u.config={templates:v(["--templates","-t"])??u.param.template,defaultResponseAsSuccess:y(["--default-as-success","-d"]),generateResponses:y(["--responses","-r"]),generateUnionEnums:y("--union-enums"),addReadonly:y("--add-readonly"),generateRouteTypes:y("--route-types"),generateClient:!y("--no-client"),enumNamesAsValues:y("--enum-names-as-values"),extractRequestParams:y("--extract-request-params"),extractRequestBody:y("--extract-request-body"),extractResponseBody:y("--extract-response-body"),extractResponseError:y("--extract-response-error"),modular:y("--modular"),toJS:y("--js"),moduleNameIndex:Number(v("--module-name-index")??0),moduleNameFirstTag:y("--module-name-first-tag"),httpClientType:y("--axios")?"axios":"fetch",unwrapResponseData:y("--unwrap-response-data"),disableThrowOnError:y("--disable-throw-on-error"),singleHttpClient:y("--single-http-client"),silent:y("--silent")??!0,defaultResponseType:v("--default-response")??"void",typePrefix:v("--type-prefix")??"",typeSuffix:v("--type-suffix")??"",cleanOutput:y("--clean-output"),...v("--api-class-name")?{apiClassName:v("--api-class-name")}:{},patch:y("--patch"),debug:y("--debug"),anotherArrayType:y("--another-array-type"),sortTypes:y("--sort-types"),extractEnums:y("--extract-enums")},Nt()}function R(e){let t=process.argv.slice(2);return e.some(n=>t.includes(n))}function Nt(){let e=P(),t=F(process.cwd(),{projectFile:e.configFile});t.warnings.forEach(p=>console.error("\u26A0\uFE0F",p));let n=G(L(t.merged,e.profile)),r=n.input??{},s=n.output??{},o=n.types??{},i=n.naming??{},a=n.grouping??{},l=r.url??r.file;if(!l)return;u.rcDriven=!0,u.rcUrl=l,u.rcOutput=s.dir??"./src/api",u.rcName=s.name??"index";let c=u.param;c.quick=!0,!R(["--remove-prefix-index","-rpi"])&&i.pathPrefixIndex!==void 0&&(c.removePrefixIndex=String(i.pathPrefixIndex)),!R(["--convert-get","-cg"])&&i.convertGetToQuery!==void 0&&(c.convertGet=i.convertGetToQuery),!R(["--remove-param","-rp"])&&i.dropPathParams!==void 0&&(c.removeParam=i.dropPathParams),!R(["--extract-request-query","-erq"])&&o.extractQuery!==void 0&&(c.extractRequestQuery=o.extractQuery),!R(["--remove-dts","-rd"])&&o.removeDts!==void 0&&(c.removeDts=o.removeDts),!R(["--replace-tags","-rt"])&&i.tagRewrite&&(c.replaceTags=i.tagRewrite);let m=u.config;!R(["--axios"])&&n.client?.type&&(m.httpClientType=n.client.type==="axios"?"axios":"fetch"),!R(["--js"])&&n.language?.target&&(m.toJS=n.language.target==="js"),!R(["--responses","-r"])&&o.responses!==void 0&&(m.generateResponses=!!o.responses),!R(["--unwrap-response-data"])&&o.unwrapData!==void 0&&(m.unwrapResponseData=!!o.unwrapData),!R(["--extract-request-params"])&&o.extractParams!==void 0&&(m.extractRequestParams=!!o.extractParams),!R(["--clean-output"])&&s.clean!==void 0&&(m.cleanOutput=!!s.clean),!R(["--modular"])&&s.mode==="grouped"&&(m.modular=!0),!R(["--module-name-index"])&&a.pathDepth!==void 0&&(m.moduleNameIndex=Number(a.pathDepth)),Object.keys(a).length&&(m.grouping=a)}async function bt(){if(u.rcDriven){g.files=["(swagger2apirc)"];return}u.param.config?g.files=u.param.config.split(","):u.param.configScan&&(g.files=de()),g.files.length==0&&(g.files=["saconfig.json"]),!u.param.configAll&&g.files.length>1&&(g.files=(await Ae({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:g.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:V("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),g.files?.length>0||V("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function jt(){if(u.rcDriven){g.param={url:u.rcUrl,output:u.rcOutput,name:u.rcName},u.docFile=S.resolve(`${u.rcOutput}/${u.rcName}-${new Date().getTime()}.json`);return}try{g.param={},g.param=JSON.parse(D.readFileSync(g.file,"utf-8"))}catch{}(!u.param.quick||[g.param.url,g.param.output,g.param.name].includes(void 0))&&(g.param=await Ae([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:g.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:g.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:g.param.name??"index"}])),[g.param.url,g.param.output,g.param.name].includes(void 0)&&V("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),u.docFile=S.resolve(`${g.param.output}/${g.param.name}-${new Date().getTime()}.json`)}async function Ie(e=0){if(g.file=g.files[e],await jt(),X(g.param.url))await ht.get(g.param.url).then(t=>Oe(t.data)).catch(t=>console.log("\u5931\u8D25\uFF1A",t));else try{await Oe(JSON.parse(D.readFileSync(S.resolve(g.param.url),"utf8")))}catch(t){console.log("\u5931\u8D25\uFF1A",t)}g.files[e+1]?await Ie(e+1):A>0&&V(`\u7ED3\u675F\uFF1A${A} \u4E2A\u6587\u6863\u672A\u751F\u6210\uFF0C\u5931\u8D25\u539F\u56E0\u89C1\u4E0A\u65B9\u8F93\u51FA`,1)}function Ct(e){let t=u.param.replaceTags;t?.length&&Object.values(e.paths??{}).forEach(n=>{Object.values(n).forEach(r=>{Array.isArray(r?.tags)&&(r.tags=r.tags.map(s=>s.replace(new RegExp(`^${t[0]}$`,"g"),t[1]??"")))})})}function Et(e,t){let n=u.config.toJS?".js":".ts",r=S.resolve(g.param.output??"./src/api"),s=D.existsSync(r)?D.readdirSync(r):[],o=e.map(a=>`${a.fileName}${n}`).filter(a=>!s.includes(a)),i=B(s,e,n);if(vt()){console.log(JSON.stringify({groups:e.map(({raw:a,fileName:l,className:c,property:m,reason:p,source:f})=>({raw:a,fileName:l,className:c,property:m,reason:p,source:f})),unmatchedRules:t,add:o,orphans:i},null,2));return}e.forEach(a=>console.log(`\u547D\u540D\uFF1A${a.raw} \u2192 ${a.fileName}\uFF08\u7C7B ${a.className}${a.reason?`\uFF0C${a.reason}`:""}\uFF09`)),t.length&&console.error(`\u26A0\uFE0F \u672A\u547D\u4E2D\u89C4\u5219\uFF1A${t.map(a=>a+1).join("\u3001")}`),o.length&&console.log(`\u9884\u8BA1\u65B0\u589E\uFF1A${o.join("\u3001")}`),i.length&&console.error(`\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A${i.join("\u3001")}`)}async function Oe(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");let t=await Re(e,{baseUrl:X(g.param.url)?g.param.url:void 0});if(t.errors.length>0){t.errors.forEach(r=>console.error("\u5931\u8D25\uFF1A",r)),A+=1;return}O=[],u.param.moduleClassNames=void 0,Ct(e);let n=u.config.grouping;if(u.config.modular&&n&&(n.strategy?.length||n.rules?.length)){let r=T(e,n);if(r.warnings.forEach(s=>console.error("\u26A0\uFE0F",s)),r.errors.length>0){r.errors.forEach(s=>console.error("\u5931\u8D25\uFF1A",s)),A+=1;return}if(O=r.entries,u.config.moduleNameFirstTag=!0,u.param.moduleClassNames=Ce(r.entries),n.preserveTags!==!1&&(u.param.groupOriginalTags=r.originalTags),console.log("\u5206\u7EC4\uFF1A",...Object.entries(r.counts).map(([s,o])=>`${s}-${o}`)),Rt()){Et(r.entries,r.unmatchedRules);return}}if(Object.entries(e.paths).forEach(r=>{Object.keys(r[1]).forEach(s=>{let o=`${r[0]}/${s}`;if(u.param.convertGet&&(o=o.replace(/([^\}]\/)get$/g,"$1query")),u.param.removeParam&&(o=o.replace(/\/\{.+?\}/g,"")),u.param.removePrefixIndex){let a=o.split("/");a=a.slice(0,1).concat(a.slice(Number(u.param.removePrefixIndex)+2)),o=a.join("/")}o=o.replace(/["\\`\r\n]/g,"_").replace(/\$\{/g,"_"),e.paths[r[0]][s].operationId=o;let i=o.split("/").slice(-1)[0];typeof u.enum[i]=="number"?u.enum[i]++:u.enum[i]=1})}),Object.entries(e.components).forEach(r=>{Object.keys(r[1]).forEach(s=>{u.param.removeEmptyComponents&&!Object.keys(e.components[r[0]][s]).length&&delete e.components[r[0]][s]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(u.enum).map(r=>r.join("-"))),Y(u.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",g.file),await wt({fileName:`${g.param.name}.ts`,output:S.resolve(g.param.output),input:u.docFile,...u.config,param:u.param}),console.log("\u5B8C\u6210\uFF1A",S.resolve(g.param.output,`${g.param.name}${u.config.toJS?".js":".ts"}`)),u.config.modular){let r=S.resolve(g.param.output),s=String(u.config.apiClassName??"Api"),o=!!u.config.toJS;if(O.length){let i=pe(r,O,o,{aggregate:!1});if(i.errors.length>0){i.errors.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),A+=1;return}le(r,s,o,Ee(O));let{errors:a,orphans:l}=pe(r,O,o);if(a.length>0){a.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),A+=1;return}l.forEach(c=>console.error("\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A",c))}else le(r,s,o)}u.config.toJS&&console.log("\u5B8C\u6210\uFF1A",S.resolve(g.param.output,`${g.param.name}.d.ts`)),D.unlinkSync(u.docFile),u.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",S.resolve(g.param.output,`${g.param.name}.d.ts`)),xt(`npx rimraf ${S.resolve(g.param.output,`${g.param.name}.d.ts`)}`,{cwd:u.home}).toString()),u.rcDriven||Y(g.file,JSON.stringify(g.param,null,2))}async function ke(){await St(),await bt(),Ie()}import j from"fs";import C from"path";import _ from"prompts";import Ft from"axios";import Ot from"fs";import At from"path";function It(e){let t=[],n="",r=null;for(let s=0;s<e.length;s+=1){let o=e[s];if(r){o==="\\"&&r==='"'&&s+1<e.length?(n+=e[s+1],s+=1):o===r?r=null:n+=o;continue}o==='"'||o==="'"?r=o:/\s/.test(o)?(n&&t.push(n),n=""):n+=o}return n&&t.push(n),t}function kt(e){let t={},n=[],r=(i,a,l)=>{t[i]=t[i]??{},t[i][a]=l},s={"--axios":()=>r("client","type","axios"),"--responses":()=>r("types","responses",!0),"-r":()=>r("types","responses",!0),"--js":()=>r("language","target","js"),"-cg":()=>r("naming","convertGetToQuery",!0),"--convert-get":()=>r("naming","convertGetToQuery",!0),"-rp":()=>r("naming","dropPathParams",!0),"--remove-param":()=>r("naming","dropPathParams",!0),"-err":()=>r("types","unwrapData",!0),"--extract-response-raw":()=>r("types","unwrapData",!0),"-rd":()=>r("types","removeDts",!0),"--remove-dts":()=>r("types","removeDts",!0),"--modular":()=>r("output","mode","grouped"),"--clean-output":()=>r("output","clean",!0)},o={"-rpi":i=>r("naming","pathPrefixIndex",Number(i)),"--remove-prefix-index":i=>r("naming","pathPrefixIndex",Number(i)),"-erq":i=>r("types","extractQuery",i),"--extract-request-query":i=>r("types","extractQuery",i),"--module-name-index":i=>r("grouping","pathDepth",Number(i))};for(let i=0;i<e.length;i+=1){let a=e[i];if(a==="$1"||a==="--config"||a==="-c"||a==="--quick"||a==="-q"){(a==="--config"||a==="-c")&&(i+=1);continue}if(a==="-rt"||a==="--replace-tags"){let l=e[i+1],c=e[i+2]??"";if(l!==void 0){r("naming","tagRewrite",[l,c]),i+=2;continue}}if(o[a]){o[a](e[i+1]??""),i+=1;continue}if(s[a]){s[a]();continue}a.startsWith("-")&&n.push(a)}return{config:t,unknown:n}}function Fe(e,t){let n=At.resolve(e),s=JSON.parse(Ot.readFileSync(n,"utf8")).scripts??{},o=Object.entries(s).filter(([,h])=>typeof h=="string"&&h.includes("swagger2api"));if(o.length===0)throw new Error(`\u672A\u5728 ${n} \u4E2D\u627E\u5230\u5305\u542B swagger2api \u7684\u811A\u672C`);let i=t?o.find(([h])=>h===t):o[0];if(!i)throw new Error(`${n} \u4E2D\u4E0D\u5B58\u5728\u811A\u672C ${t}`);let[a,l]=i,c=It(l),m=c.findIndex(h=>h.endsWith("swagger2api")||h==="swagger2api"),p=m===-1?c:c.slice(m+1),{config:f,unknown:x}=kt(p);return{config:f,unknown:x,scriptName:a}}var Ge="# @fxri/swagger2api",Gt=["*.swagger2apirc.local.json"];function Le(e){let t=C.join(e,".gitignore"),n=[`${Ge} \u4E2A\u4EBA\u914D\u7F6E\u4E0D\u5165\u5E93`,...Gt],r=j.existsSync(t)?j.readFileSync(t,"utf8"):"";if(r.includes(Ge))return;let s=r&&!r.endsWith(`
|
|
4
|
+
`)?`${r}
|
|
5
|
+
`:r;j.writeFileSync(t,`${s}${n.join(`
|
|
6
|
+
`)}
|
|
7
|
+
`)}function ue(e,t){let n=j.existsSync(e)?JSON.parse(j.readFileSync(e,"utf8")):{},r=ie(n,t);j.mkdirSync(C.dirname(e),{recursive:!0}),j.writeFileSync(e,`${JSON.stringify(r,null,2)}
|
|
8
|
+
`)}async function Lt(){let e=await _([{name:"url",type:"text",message:"Swagger \u5730\u5740\u6216\u672C\u5730\u6587\u4EF6:",initial:""},{name:"dir",type:"text",message:"\u8F93\u51FA\u76EE\u5F55:",initial:"./src/api"},{name:"name",type:"text",message:"\u5165\u53E3\u6587\u4EF6\u540D:",initial:"index"},{name:"client",type:"select",message:"HTTP \u5BA2\u6237\u7AEF:",choices:[{title:"axios",value:"axios"},{title:"fetch",value:"fetch"}],initial:0},{name:"language",type:"select",message:"\u8F93\u51FA\u8BED\u8A00:",choices:[{title:"TypeScript",value:"ts"},{title:"JavaScript",value:"js"}],initial:0},{name:"responses",type:"toggle",message:"\u751F\u6210\u54CD\u5E94\u7C7B\u578B\u4FE1\u606F?",initial:!0,active:"\u662F",inactive:"\u5426"},{name:"grouped",type:"toggle",message:"\u6309\u7EC4\u62C6\u5206\u4E3A\u591A\u6587\u4EF6?",initial:!1,active:"\u662F",inactive:"\u5426"}]);return{input:{url:e.url},output:{dir:e.dir,name:e.name,mode:e.grouped?"grouped":"single"},client:{type:e.client},language:{target:e.language},types:{responses:!!e.responses}}}async function Pt(){let e=process.argv.slice(2),t=e.findIndex(i=>i==="--config"||i==="-c"),n=t===-1?C.join(process.cwd(),W):C.resolve(e[t+1]),r=e.findIndex(i=>i==="--from-script"),s=r===-1?void 0:C.resolve(e[r+1]??"package.json");if(s){let i=Fe(s);return ue(n,i.config),Le(process.cwd()),console.log(`\u5DF2\u4ECE\u811A\u672C ${i.scriptName} \u8FC1\u79FB\u914D\u7F6E\u5230 ${n}`),i.unknown.length&&console.error(`\u26A0\uFE0F \u4EE5\u4E0B\u53C2\u6570\u672A\u80FD\u8BC6\u522B\uFF0C\u8BF7\u624B\u52A8\u8865\u5145\uFF1A${i.unknown.join("\u3001")}`),i.unknown.length?1:0}if(!process.stdout.isTTY)return console.error("init \u9700\u8981\u4EA4\u4E92\u5F0F\u7EC8\u7AEF\uFF1B\u975E\u4EA4\u4E92\u73AF\u5883\u8BF7\u4F7F\u7528 --from-script \u6216\u624B\u5199\u914D\u7F6E\u6587\u4EF6"),1;let o=await Lt();return ue(n,o),Le(process.cwd()),console.log(`\u5DF2\u5199\u5165\u914D\u7F6E\uFF1A${n}`),0}function Tt(){let{configFile:e,profile:t}=P(),n=F(process.cwd(),{projectFile:e}),r=G(L(n.merged,t)),s={layers:Se(n),envOverrides:ae.filter(o=>process.env[o.env]!==void 0).map(o=>`${o.env} \u2192 ${o.key}`),profile:t??null,effective:r,warnings:n.warnings};return process.argv.includes("--json")?console.log(JSON.stringify(s,null,2)):(s.layers.forEach(o=>console.log(o)),s.envOverrides.length?console.log(`\u73AF\u5883\u53D8\u91CF\uFF1A${s.envOverrides.join("\uFF1B")}`):console.log("\u73AF\u5883\u53D8\u91CF\uFF1A\u65E0"),console.log(`\u9884\u8BBE\uFF1A${s.profile??"\u672A\u6307\u5B9A"}`),s.warnings.forEach(o=>console.error(`\u26A0\uFE0F ${o}`))),0}async function Dt(e){return/^https?:\/\//i.test(e)?(await Ft.get(e)).data:JSON.parse(j.readFileSync(C.resolve(e),"utf8"))}function _t(e){let t={},n={},r=0;for(let[s,o]of Object.entries(e.paths??{})){let i=s.split("/").filter(Boolean)[0]??"(root)";n[i]=(n[i]??0)+1;for(let a of["get","post","put","delete","patch","head","options"]){let l=o[a];if(!l||typeof l!="object")continue;r+=1;let c=(l.tags??[])[0]??"(\u65E0\u6807\u7B7E)";t[c]=(t[c]??0)+1}}return{tags:t,prefixes:n,total:r}}async function Ut(){let{configFile:e,profile:t}=P(),n=F(process.cwd(),{projectFile:e}),r=G(L(n.merged,t)),s=r.input?.url??r.input?.file;if(!s)return console.error("\u672A\u627E\u5230 input \u914D\u7F6E\uFF0C\u8BF7\u5148\u6267\u884C swagger2api init"),1;let o;try{o=await Dt(s)}catch(d){return console.error(`\u8BFB\u53D6\u6587\u6863\u5931\u8D25\uFF1A${d.message}`),1}let i=_t(o);if(console.log(`\u5171 ${i.total} \u4E2A\u63A5\u53E3`),console.log("\u6309\u6807\u7B7E\u5206\u5E03\uFF1A",...Object.entries(i.tags).map(([d,$])=>`${d}-${$}`)),console.log("\u6309\u8DEF\u5F84\u9996\u6BB5\u5206\u5E03\uFF1A",...Object.entries(i.prefixes).map(([d,$])=>`${d}-${$}`)),!process.stdout.isTTY)return console.log("\u975E\u4EA4\u4E92\u7EC8\u7AEF\uFF1A\u4EC5\u8F93\u51FA\u62A5\u8868\uFF0C\u5206\u7EC4\u89C4\u5219\u8BF7\u76F4\u63A5\u5199\u5165\u914D\u7F6E\u6587\u4EF6\u7684 grouping \u6BB5"),0;let a=await _([{name:"strategy",type:"select",message:"\u5206\u7EC4\u4F9D\u636E\uFF1A",choices:[{title:"\u6309\u6807\u7B7E\uFF08tag\uFF09",value:"tag"},{title:"\u6309\u8DEF\u5F84\u6BB5",value:"path"},{title:"\u6309\u663E\u5F0F\u89C4\u5219\uFF08\u7A0D\u540E\u5728\u914D\u7F6E\u91CC\u8865\uFF09",value:"rules"}],initial:0},{name:"pathDepth",type:"number",message:"\u8DEF\u5F84\u6BB5\u6DF1\u5EA6\uFF08\u6309\u8DEF\u5F84\u5206\u7EC4\u65F6\u751F\u6548\uFF09:",initial:0},{name:"minRoutes",type:"number",message:"\u5C11\u4E8E\u591A\u5C11\u63A5\u53E3\u5E76\u5165\u515C\u5E95\u7EC4:",initial:0},{name:"maxRoutes",type:"number",message:"\u591A\u4E8E\u591A\u5C11\u63A5\u53E3\u518D\u62C6\u4E00\u5C42\uFF080 \u8868\u793A\u4E0D\u62C6\uFF09:",initial:0},{name:"fallback",type:"text",message:"\u515C\u5E95\u7EC4\u540D:",initial:"misc"}]),l=[];if(a.strategy==="rules"){let d=!0;for(;d;){let $=await _([{name:"kind",type:"select",message:"\u89C4\u5219\u5339\u914D\u65B9\u5F0F\uFF1A",choices:[{title:"\u8DEF\u5F84\u524D\u7F00",value:"prefix"},{title:"\u6807\u7B7E",value:"tag"}],initial:0},{name:"value",type:"text",message:"\u5339\u914D\u503C\uFF08\u7559\u7A7A\u7ED3\u675F\uFF09\uFF1A"},{name:"group",type:"text",message:"\u5F52\u5165\u7EC4\u540D\uFF1A"}]);if(!$.value||!$.group)break;l.push({match:{[$.kind]:$.value},group:$.group}),d=!!(await _({name:"again",type:"confirm",message:"\u7EE7\u7EED\u6DFB\u52A0\u89C4\u5219\uFF1F",initial:!1})).again}}let c={strategy:[a.strategy],pathDepth:Number(a.pathDepth??0),rules:l,minRoutes:Number(a.minRoutes??0),maxRoutes:Number(a.maxRoutes??0),fallback:a.fallback||"misc",preserveTags:!0},m=r.grouping?.names??{},p=T(JSON.parse(JSON.stringify(o)),{...c,names:m});p.warnings.forEach(d=>console.error(`\u26A0\uFE0F ${d}`)),console.log("\u547D\u540D\u9884\u89C8\uFF1A"),p.entries.forEach(d=>{let $=[d.source==="fallback"?"\u515C\u5E95":d.source==="manual"?"\u624B\u5DE5":"",d.reason].filter(Boolean).join("\uFF1B");console.log(` ${d.raw} \u2192 ${d.fileName}${$?`\uFF08${$}\uFF09`:""}`)});let f={...m},x=p.entries.filter(d=>d.source!=="auto"&&d.source!=="manual"||d.reason.includes("\u91CD\u540D")||d.reason.includes("\u4FDD\u7559\u540D"));for(let d of x){let $=await _({name:"name",type:"text",message:`\u7EC4\u300C${d.raw}\u300D\u7684\u6A21\u5757\u540D\uFF08\u7559\u7A7A\u4FDD\u7559 ${d.fileName}\uFF09:`}),N=String($.name??"").trim();N&&(f[d.raw]=N)}Object.keys(f).length&&(c.names=f);let h=T(JSON.parse(JSON.stringify(o)),c);if(h.errors.length)return h.errors.forEach(d=>console.error(`\u5931\u8D25\uFF1A${d}`)),1;console.log("\u5C06\u5199\u5165\uFF1A",JSON.stringify(c));let w=e?C.resolve(e):C.join(process.cwd(),W);return ue(w,{grouping:c}),console.log(`\u5DF2\u5199\u5165\u5206\u7EC4\u914D\u7F6E\uFF1A${w}`),0}async function Pe(e){let t=process.argv.slice(2),[n,r]=t.filter(s=>!s.startsWith("-"));if(n==="init"){process.exitCode=await Pt();return}if(n==="grouping"){process.exitCode=await Ut();return}if(n==="config"&&r==="status"){process.exitCode=Tt();return}await e()}Pe(ke);
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1,3 @@
|
|
|
1
|
-
var F=Object.create;var u=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var J=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty;var I=(e,r)=>{for(var o in r)u(e,o,{get:r[o],enumerable:!0})},b=(e,r,o,s)=>{if(r&&typeof r=="object"||typeof r=="function")for(let i of C(r))!_.call(e,i)&&i!==o&&u(e,i,{get:()=>r[i],enumerable:!(s=N(r,i))||s.enumerable});return e};var c=(e,r,o)=>(o=e!=null?F(J(e)):{},b(r||!e||!e.__esModule?u(o,"default",{value:e,enumerable:!0}):o,e)),L=e=>b(u({},"__esModule",{value:!0}),e);var M={};I(M,{generateApi:()=>H});module.exports=L(M);var j=c(require("axios"),1),A=require("child_process"),E=c(require("os"),1),d=c(require("fs"),1),l=c(require("path"),1),S=c(require("prompts"),1),T=require("swagger-typescript-api");var w=e=>/^(https?:\/\/|:?\/\/)/.test(e);var g=c(require("fs"),1),P=c(require("url"),1),y=c(require("path"),1),G={},f={param:process.argv.filter((e,r)=>r>1)};function x(e,r="value",o={}){Array.isArray(e)||(e=[e]);let s;return f.param.forEach((i,m)=>{if(e.includes(i))["value"].includes(r)?s=f.param[m+1]:["array"].includes(r)?s=Array.from({length:o.length??1}).map((Q,D)=>f.param[m+D+1]):s=!["false"].includes(f.param[m+1]);else return}),s}function t(e){return x(e,"key")}function p(e){return x(e,"value")}function R(e,r={}){return x(e,"array",r)??[]}function h(e,r){let o=y.default.dirname(e);g.default.existsSync(o)||g.default.mkdirSync(o,{recursive:!0}),g.default.writeFileSync(e,r)}function U(){return typeof require<"u"&&typeof module<"u"?__filename:P.default.fileURLToPath(G.url)}function $(){return typeof require<"u"&&typeof module<"u"?__dirname:y.default.dirname(U())}var O=require("glob"),a={files:[],param:{}},n={home:E.default.homedir(),enum:{}};function v(e){e&&console.log(e),process.exit()}async function V(){n.param={config:p(["--config","-c"]),configScan:t(["--config-scan","-cs"])??!0,configAll:t(["--config-all","-ca"]),quick:t(["--quick","-q"]),replaceTags:R(["--replace-tags","-rt"],{length:2}),convertGet:t(["--convert-get","-cg"]),removeParam:t(["--remove-param","-rp"]),removePrefixIndex:p(["--remove-prefix-index","-rpi"]),removeDts:t(["--remove-dts","-rd"]),removeEmptyComponents:t(["--remove-empty-components","-rec"])??!0,extractRequestQuery:p(["--extract-request-query","-erq"]),extractResponseRaw:t(["--extract-response-raw","-err"]),template:l.default.resolve($(),"./templates")},n.config={templates:p(["--templates","-t"])??n.param.template,defaultResponseAsSuccess:t(["--default-as-success","-d"]),generateResponses:t(["--responses","-r"]),generateUnionEnums:t("--union-enums"),addReadonly:t("--add-readonly"),generateRouteTypes:t("--route-types"),generateClient:!t("--no-client"),enumNamesAsValues:t("--enum-names-as-values"),extractRequestParams:t("--extract-request-params"),extractRequestBody:t("--extract-request-body"),extractResponseBody:t("--extract-response-body"),extractResponseError:t("--extract-response-error"),modular:t("--modular"),toJS:t("--js"),moduleNameIndex:Number(p("--module-name-index")??0),moduleNameFirstTag:t("--module-name-first-tag"),httpClientType:t("--axios")?"axios":"fetch",unwrapResponseData:t("--unwrap-response-data"),disableThrowOnError:t("--disable-throw-on-error"),singleHttpClient:t("--single-http-client"),silent:t("--silent")??!0,defaultResponseType:p("--default-response")??"void",typePrefix:p("--type-prefix")??"",typeSuffix:p("--type-suffix")??"",cleanOutput:t("--clean-output"),...p("--api-class-name")?{apiClassName:p("--api-class-name")}:{},patch:t("--patch"),debug:t("--debug"),anotherArrayType:t("--another-array-type"),sortTypes:t("--sort-types"),extractEnums:t("--extract-enums")}}async function B(){n.param.config?a.files=n.param.config.split(","):n.param.configScan&&(a.files=(0,O.globSync)(["./**/saconfig*.json"],{ignore:"node_modules/**"})),a.files.length==0&&(a.files=["saconfig.json"]),!n.param.configAll&&a.files.length>1&&(a.files=(await(0,S.default)({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:a.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:v("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),a.files?.length>0||v("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function K(){try{a.param={},a.param=JSON.parse(d.default.readFileSync(a.file,"utf-8"))}catch{}(!n.param.quick||[a.param.url,a.param.output,a.param.name].includes(void 0))&&(a.param=await(0,S.default)([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:a.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:a.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:a.param.name??"index"}])),[a.param.url,a.param.output,a.param.name].includes(void 0)&&v("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),n.docFile=l.default.resolve(`${a.param.output}/${a.param.name}-${new Date().getTime()}.json`)}async function k(e=0){if(a.file=a.files[e],await K(),w(a.param.url))await j.default.get(a.param.url).then(r=>q(r.data)).catch(r=>console.log("\u5931\u8D25\uFF1A",r));else try{await q(JSON.parse(d.default.readFileSync(l.default.resolve(a.param.url),"utf8")))}catch(r){console.log("\u5931\u8D25\uFF1A",r)}a.files[e+1]&&k(e+1)}async function q(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");Object.entries(e.paths).forEach(r=>{Object.keys(r[1]).forEach(o=>{n.param.replaceTags.length&&(e.paths[r[0]][o].tags=e.paths[r[0]][o].tags?.map(m=>m.replace(new RegExp(`^${n.param.replaceTags[0]}$`,"g"),n.param.replaceTags[1]??"")));let s=`${r[0]}/${o}`;if(n.param.convertGet&&(s=s.replace(/([^\}]\/)get$/g,"$1query")),n.param.removeParam&&(s=s.replace(/\/\{.+?\}/g,"")),n.param.removePrefixIndex){let m=s.split("/");m=m.slice(0,1).concat(m.slice(Number(n.param.removePrefixIndex)+2)),s=m.join("/")}e.paths[r[0]][o].operationId=s;let i=s.split("/").slice(-1)[0];typeof n.enum[i]=="number"?n.enum[i]++:n.enum[i]=1})}),Object.entries(e.components).forEach(r=>{Object.keys(r[1]).forEach(o=>{n.param.removeEmptyComponents&&!Object.keys(e.components[r[0]][o]).length&&delete e.components[r[0]][o]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(n.enum).map(r=>r.join("-"))),h(n.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",a.file),await(0,T.generateApi)({fileName:`${a.param.name}.ts`,output:l.default.resolve(a.param.output),input:n.docFile,...n.config,param:n.param}),console.log("\u5B8C\u6210\uFF1A",l.default.resolve(a.param.output,`${a.param.name}${n.config.toJS?".js":".ts"}`)),n.config.toJS&&console.log("\u5B8C\u6210\uFF1A",l.default.resolve(a.param.output,`${a.param.name}.d.ts`)),d.default.unlinkSync(n.docFile),n.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",l.default.resolve(a.param.output,`${a.param.name}.d.ts`)),(0,A.execSync)(`npx rimraf ${l.default.resolve(a.param.output,`${a.param.name}.d.ts`)}`,{cwd:n.home}).toString()),h(a.file,JSON.stringify(a.param,null,2))}async function H(){await V(),await B(),k()}0&&(module.exports={generateApi});
|
|
1
|
+
var ke=Object.create;var P=Object.defineProperty;var Fe=Object.getOwnPropertyDescriptor;var Ge=Object.getOwnPropertyNames;var Pe=Object.getPrototypeOf,Ue=Object.prototype.hasOwnProperty;var _e=(e,t)=>{for(var r in t)P(e,r,{get:t[r],enumerable:!0})},ne=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of Ge(t))!Ue.call(e,s)&&s!==r&&P(e,s,{get:()=>t[s],enumerable:!(n=Fe(t,s))||n.enumerable});return e};var $=(e,t,r)=>(r=e!=null?ke(Pe(e)):{},ne(t||!e||!e.__esModule?P(r,"default",{value:e,enumerable:!0}):r,e)),De=e=>ne(P({},"__esModule",{value:!0}),e);var It={};_e(It,{generateApi:()=>Et});module.exports=De(It);var je=$(require("axios"),1),Ce=require("child_process"),Ee=$(require("os"),1),O=$(require("fs"),1),S=$(require("path"),1),te=$(require("prompts"),1),Ie=require("swagger-typescript-api");var H=e=>/^(https?:\/\/|:?\/\/)/.test(e);var L=$(require("fs"),1),se=$(require("url"),1),k=$(require("path"),1),Me={},U={param:process.argv.filter((e,t)=>t>1)};function W(e,t="value",r={}){Array.isArray(e)||(e=[e]);let n;return U.param.forEach((s,o)=>{if(e.includes(s))["value"].includes(t)?n=U.param[o+1]:["array"].includes(t)?n=Array.from({length:r.length??1}).map((a,i)=>U.param[o+i+1]):n=!["false"].includes(U.param[o+1]);else return}),n}function d(e){return W(e,"key")}function N(e){return W(e,"value")}function oe(e,t={}){return W(e,"array",t)??[]}function B(e,t){let r=k.default.dirname(e);L.default.existsSync(r)||L.default.mkdirSync(r,{recursive:!0}),L.default.writeFileSync(e,t)}function Te(){return typeof require<"u"&&typeof module<"u"?__filename:se.default.fileURLToPath(Me.url)}function ae(){return typeof require<"u"&&typeof module<"u"?__dirname:k.default.dirname(Te())}function ie(e=process.cwd()){let t=[],r=n=>{for(let s of L.default.readdirSync(n,{withFileTypes:!0})){if(s.name.startsWith("."))continue;let o=k.default.join(n,s.name);if(s.isDirectory()){if(s.name==="node_modules")continue;r(o)}else s.isFile()&&s.name.startsWith("saconfig")&&s.name.endsWith(".json")&&t.push(k.default.relative(e,o))}};return r(e),t.sort()}function _(e){return JSON.stringify(e).slice(1,-1)}function ce(e){return e.replace(/\\/g,"\\\\").replace(/`/g,"\\`").replace(/\$\{/g,"\\${")}var le=$(require("dns/promises"),1),V=$(require("net"),1),qe=5,F=async e=>{try{return(await le.lookup(e,{all:!0,verbatim:!0})).map(r=>r.address)}catch{return[]}};function z(e){let t=e.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);if(!t)return!1;let r=t.slice(1).map(Number);if(r.some(o=>o>255))return!1;let[n,s]=r;return n===0||n===10||n===127||n===169&&s===254||n===172&&s>=16&&s<=31||n===192&&s===168}function Je(e){let t=e.toLowerCase();if(t==="::"||t==="::1"||t.startsWith("fe80:"))return!0;let r=t.split(":")[0]??"";if(r>="fc00"&&r<="fdff")return!0;let n=t.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);if(n?.[1])return z(n[1]);let s=t.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);if(s?.[1]&&s?.[2]){let o=parseInt(s[1],16),a=parseInt(s[2],16);return z(`${o>>8&255}.${o&255}.${a>>8&255}.${a&255}`)}return!1}function pe(e){let t=V.isIP(e);return t===4?z(e):t===6?Je(e):!1}function He(e){let t=e.toLowerCase();return t==="localhost"||t.endsWith(".localhost")}async function We(e,t=F){let r;try{r=new URL(e)}catch{return!1}if(r.protocol!=="http:"&&r.protocol!=="https:")return!1;let n=r.hostname.startsWith("[")&&r.hostname.endsWith("]")?r.hostname.slice(1,-1):r.hostname;if(He(n))return!1;if(V.isIP(n))return!pe(n);let s=await t(n);return s.length===0?!1:s.every(o=>!pe(o))}function Be(e,t){if(typeof t!="string")return!1;try{let r=new URL(e),n=new URL(t);return r.protocol===n.protocol&&r.host===n.host}catch{return!1}}function ue(e){return e.split("#")[0]||e}async function K(e,t,r=F){let{specSourceUrl:n,allowExplicitSpecUrl:s=!1}=t;return s&&typeof n=="string"&&ue(e)===ue(n)||typeof n=="string"&&Be(e,n)?!0:We(e,r)}function ze(e,t){try{return new URL(e,t).toString()}catch{return null}}async function fe(e,t,r,n=F,s=fetch){let o=e,a=0;for(;;){if(!await K(o,{specSourceUrl:r.specSourceUrl,allowExplicitSpecUrl:r.allowExplicitSpecUrl&&a===0},n))return null;let u=await s(o,{...t,redirect:"manual"});if(u.status>=300&&u.status<400){let c=u.headers.get("location");if(!c||a>=qe)return null;let m=ze(c,o);if(!m)return null;o=m,a+=1;continue}return u}}var D=/["\\\u0000-\u001f]/;function Ve(e){if(e.paths&&typeof e.paths=="object"){let t={};for(let[r,n]of Object.entries(e.paths))t[ce(r)]=n;e.paths=t}if(Array.isArray(e.servers))for(let t of e.servers)t&&typeof t.url=="string"&&(t.url=_(t.url));X(e)}function X(e){if(Array.isArray(e)){e.forEach(t=>X(t));return}if(!(!e||typeof e!="object"))for(let t of Object.keys(e)){let r=e[t];t==="enum"&&Array.isArray(r)?e[t]=r.map(n=>typeof n=="string"?_(n):n):t==="default"&&typeof r=="string"?e[t]=_(r):X(r)}}function Ke(e){let t=[],r=(n,s)=>{if(Array.isArray(n)){n.forEach((o,a)=>r(o,`${s}[${a}]`));return}if(!(!n||typeof n!="object")){if(n.properties&&typeof n.properties=="object")for(let o of Object.keys(n.properties))D.test(o)&&t.push(`${s}.properties\uFF1A\u5C5E\u6027\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(Array.isArray(n.required))for(let o of n.required)typeof o=="string"&&D.test(o)&&t.push(`${s}.required\uFF1A\u5FC5\u586B\u5B57\u6BB5\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(n.discriminator&&typeof n.discriminator=="object"&&(typeof n.discriminator.propertyName=="string"&&D.test(n.discriminator.propertyName)&&t.push(`${s}.discriminator.propertyName\uFF1A\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(n.discriminator.propertyName)}`),n.discriminator.mapping&&typeof n.discriminator.mapping=="object"))for(let o of Object.keys(n.discriminator.mapping))D.test(o)&&t.push(`${s}.discriminator.mapping\uFF1A\u952E\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);for(let o of Object.keys(n))r(n[o],`${s}.${o}`)}};return r(e,"#"),t}async function Xe(e,t={}){let r=[],n={baseUrl:t.baseUrl,resolve:t.resolve??F,fetchImpl:t.fetchImpl??fetch,docs:new Map,errors:r},s=async(a,i,u)=>{if(Array.isArray(a)){let m=[];for(let l=0;l<a.length;l+=1)m.push(await s(a[l],`${i}[${l}]`,u));return m}if(!a||typeof a!="object")return a;let c=a.$ref;if(typeof c=="string"&&!c.startsWith("#")){let m=await o(c,i,u);return m===null?a:s(m,i,u)}for(let m of Object.keys(a))a[m]=await s(a[m],`${i}.${m}`,u);return a},o=async(a,i,u)=>{if(!/^https?:\/\//i.test(a))return r.push(`${i}\uFF1A\u4E0D\u652F\u6301\u7684\u5916\u90E8\u5F15\u7528\uFF08\u4EC5\u5141\u8BB8\u6587\u6863\u5185 #/ \u6216 http(s)\uFF09\uFF1A${a}`),null;let c=a.indexOf("#"),m=c===-1?a:a.slice(0,c),l=c===-1?"":a.slice(c+1),g;try{g=n.baseUrl?new URL(m,n.baseUrl).toString():m}catch{return r.push(`${i}\uFF1A\u65E0\u6CD5\u89E3\u6790\u7684\u5F15\u7528\u5730\u5740\uFF1A${a}`),null}let y=`${g}#${l}`;if(u.includes(y))return r.push(`${i}\uFF1A\u68C0\u6D4B\u5230\u5F15\u7528\u73AF\uFF1A${[...u,y].join(" -> ")}`),null;if(!await K(g,{specSourceUrl:n.baseUrl},n.resolve))return r.push(`${i}\uFF1A\u62D2\u7EDD\u62C9\u53D6\u975E\u516C\u7F51\u6216\u975E\u4FE1\u4EFB\u6765\u6E90\u7684\u5916\u90E8\u5F15\u7528\uFF1A${a}`),null;let x=await Ze(g,n);if(!x)return null;let R=Qe(x,l);if(R===void 0)return r.push(`${i}\uFF1A\u5F15\u7528\u7247\u6BB5\u4E0D\u5B58\u5728\uFF1A${a}`),null;let b=await s(structuredClone(R),i,[...u,y]),A=Ye(e,l,b,g);return A?{$ref:`#/components/schemas/${A}`}:b};return await s(e,"#",[]),r}async function Ze(e,t){if(t.docs.has(e))return t.docs.get(e);let r=await fe(e,{},{specSourceUrl:t.baseUrl},t.resolve,t.fetchImpl);if(!r?.ok)return t.errors.push(`\u5916\u90E8\u5F15\u7528\u62C9\u53D6\u5931\u8D25\uFF1A${e}`),null;let n=await r.text();try{let s=JSON.parse(n);return t.docs.set(e,s),s}catch{return t.errors.push(`\u5916\u90E8\u5F15\u7528\u6587\u6863\u4EC5\u652F\u6301 JSON \u683C\u5F0F\uFF1A${e}`),null}}function Qe(e,t){if(!t||t==="/")return e;let r=e;for(let n of t.replace(/^\//,"").split("/")){if(r===null||typeof r!="object")return;let s=decodeURIComponent(n).replace(/~1/g,"/").replace(/~0/g,"~");r=r[s]}return r}function Ye(e,t,r,n){let s=t.match(/^\/components\/schemas\/([^/]+)$/);if(!s)return null;let o=decodeURIComponent(s[1]).replace(/~1/g,"/").replace(/~0/g,"~");e.components=e.components??{},e.components.schemas=e.components.schemas??{};let a=e.components.schemas;if(a[o]===void 0)return a[o]=r,o;if(JSON.stringify(a[o])===JSON.stringify(r))return o;let i=(n.split("/").pop()??"ref").replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9_$]/g,"_")||"ref",u=`${o}_${i}`,c=2;for(;a[u]!==void 0&&JSON.stringify(a[u])!==JSON.stringify(r);)u=`${o}_${i}_${c}`,c+=1;return a[u]=r,u}async function ge(e,t={}){let r=await Xe(e,t);return Ve(e),{errors:[...r,...Ke(e)]}}var T=$(require("fs"),1),de=$(require("os"),1),j=$(require("path"),1),et=".swagger2apirc.json",tt=".swagger2apirc.local.json",rt=".swagger2apirc.json";function Z(e,t,r){let n={layer:t,file:e,hit:!1,sections:[],config:null};if(!e||!T.default.existsSync(e))return n;try{let s=JSON.parse(T.default.readFileSync(e,"utf8"));return!s||typeof s!="object"||Array.isArray(s)?(r.push(`${e}\uFF1A\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),{...n,hit:!1}):{layer:t,file:e,hit:!0,sections:Object.keys(s),config:s}}catch(s){return r.push(`${e}\uFF1A\u89E3\u6790\u5931\u8D25\uFF08${s.message}\uFF09\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),n}}function me(e,t){let r=j.default.resolve(t);for(;;){let n=j.default.join(r,e);if(T.default.existsSync(n))return n;let s=j.default.dirname(r);if(s===r)return null;r=s}}function nt(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let r={...e};for(let[n,s]of Object.entries(t))r[n]=s;return r}function st(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let r={...e};for(let[n,s]of Object.entries(t)){let o=r[n];r[n]=o&&typeof o=="object"&&!Array.isArray(o)&&s&&typeof s=="object"&&!Array.isArray(s)?{...o,...s}:s}return r}function ye(e=process.cwd(),t={}){let r=[],n=Z(j.default.join(t.homeDir??de.default.homedir(),rt),"\u5168\u5C40\u5C42",r),s=t.projectFile?j.default.resolve(t.projectFile):me(et,e),o=Z(s,"\u9879\u76EE\u5C42",r),a=Z(me(tt,e),"\u672C\u5730\u5C42",r),i=st(nt(n.config,o.config),a.config);return{global:n,project:o,local:a,merged:i,warnings:r}}var ot=[{env:"FX_S2A_INPUT",key:"input.url",type:"string"},{env:"FX_S2A_OUTPUT",key:"output.dir",type:"string"},{env:"FX_S2A_NAME",key:"output.name",type:"string"},{env:"FX_S2A_CLIENT",key:"client.type",type:"string"},{env:"FX_S2A_LANGUAGE",key:"language.target",type:"string"},{env:"FX_S2A_CLEAN",key:"output.clean",type:"boolean"}];function at(e,t,r){let n=t.split("."),s=e;n.forEach((o,a)=>{if(a===n.length-1){s[o]=r;return}(!s[o]||typeof s[o]!="object")&&(s[o]={}),s=s[o]})}function he(e,t=process.env){let r=e?structuredClone(e):{};for(let n of ot){let s=t[n.env];s===void 0||s===""||at(r,n.key,n.type==="boolean"?!["0","false"].includes(s.toLowerCase()):s)}return r}function xe(e,t){let r=e?structuredClone(e):{};if(!t)return r;let n=r.profiles?.[t];if(!n||typeof n!="object")return r;for(let[s,o]of Object.entries(n)){if(s==="profiles")continue;let a=r[s];r[s]=a&&typeof a=="object"&&!Array.isArray(a)&&o&&typeof o=="object"&&!Array.isArray(o)?{...a,...o}:o}return r}function $e(e=process.argv.slice(2)){let t=r=>r.reduce((n,s)=>n??(e.includes(s)?e[e.indexOf(s)+1]:void 0),void 0);return{configFile:t(["--config","-c"]),profile:t(["--profile"])}}var v=$(require("fs"),1),G=$(require("path"),1);var it=new Set(["index","datacontracts","httpclient"]),ct=new Set(["HttpClient","RequestParams","ContentType","AxiosRequestConfig","AxiosResponse"]),pt=new Set(["con","prn","aux","nul",...Array.from({length:9},(e,t)=>`com${t+1}`),...Array.from({length:9},(e,t)=>`lpt${t+1}`)]),Re=64;function C(e){return String(e).normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"")}function ut(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1 $2").split(" ").filter(Boolean)}function lt(e){let t=e.normalize("NFKC"),r=[];for(let n of t.matchAll(/[A-Za-z0-9]+|[\p{L}\p{N}]+/gu)){let s=n[0];/^[A-Za-z0-9]+$/.test(s)?r.push(...ut(s)):r.push(s)}return r}function ft(e){return e.map((t,r)=>{if(/^[A-Za-z0-9]+$/.test(t)){let n=t.toLowerCase();return r===0?n:n.charAt(0).toUpperCase()+n.slice(1)}return t}).join("")}function gt(e){let t=2166136261;for(let r of e)t^=r.codePointAt(0)??0,t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0").slice(0,6)}function we(e){let t=[],r=lt(e),n=ft(r);return n?(/^[0-9]/.test(n)&&(n=`g${n}`,t.push("\u6570\u5B57\u5F00\u5934")),[...n].length>Re&&(n=[...n].slice(0,Re-6).join("")+gt(e),t.push("\u8D85\u957F\u622A\u65AD")),{slug:n,reason:t.join("\u3001")}):{slug:"",reason:"\u540D\u79F0\u4E0D\u542B\u53EF\u7528\u5B57\u7B26"}}function Q(e){return e.charAt(0).toUpperCase()+e.slice(1)}function Se(e,t={}){let r=[],n=[],s=[...new Set(e)].sort((g,y)=>g<y?-1:g>y?1:0),o=new Map,a=new Set;for(let[g,y]of Object.entries(t))o.set(g,y),o.set(C(g),y);let i=new Set,u=[],c=(g,y=2)=>{let h=g,x=y;for(;i.has(h.toLowerCase());)h=`${g}${x}`,x+=1;return i.add(h.toLowerCase()),h},m=new Map;for(let g of s){let y=o.get(g)??o.get(C(g));if(y===void 0)continue;a.add(g),a.add(C(g));let{slug:h}=we(y);if(!h){r.push(`\u624B\u5DE5\u540D\u4E0D\u53EF\u7528\uFF1A${g} \u2192 ${y}`);continue}let x=m.get(h.toLowerCase());x?r.push(`\u624B\u5DE5\u540D\u51B2\u7A81\uFF1A${x} \u4E0E ${g} \u90FD\u6307\u5411 ${h}`):m.set(h.toLowerCase(),g);let R=c(h),b=Q(R);u.push({raw:g,key:C(g),fileName:b,className:b,property:R,reason:R===h?"\u624B\u5DE5\u6307\u5B9A":"\u624B\u5DE5\u6307\u5B9A\u3001\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D",source:"manual"})}let l=1;for(let g of s){if(u.some(Le=>Le.raw===g))continue;let{slug:y,reason:h}=we(g),x=!y,R=y;if(x){for(;i.has(`group${l}`.toLowerCase());)l+=1;R=`group${l}`,l+=1}let b=it.has(R.toLowerCase())||pt.has(R.toLowerCase())||ct.has(Q(R)),A=b?c(`${R}2`,3):c(R),re=Q(A),J=[h];b?J.push("\u4E0E\u4FDD\u7559\u540D\u51B2\u7A81"):A!==R&&J.push("\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D"),u.push({raw:g,key:C(g),fileName:re,className:re,property:A,reason:J.filter(Boolean).join("\u3001"),source:x?"fallback":"auto"})}for(let g of Object.keys(t))!a.has(g)&&!a.has(C(g))&&n.push(`grouping.names \u4E2D\u7684\u952E\u672A\u51FA\u73B0\u5728\u672C\u6B21\u5206\u7EC4\u7ED3\u679C\uFF1A${g}`);return{entries:u,errors:r,warnings:n}}function Ne(e){let t={};for(let r of e)t[r.fileName]=r.className,t[r.fileName.charAt(0).toLowerCase()+r.fileName.slice(1)]=r.className;return t}function M(e,t,r){let n=new Set(t.map(o=>`${o.fileName}${r}`)),s=new Set([`index${r}`,"index.d.ts",`data-contracts${r}`,`http-client${r}`,`route-types${r}`]);return e.filter(o=>o.endsWith(r)&&!o.endsWith(`.d${r}`)&&!n.has(o)&&!s.has(o)&&!o.endsWith(`_Route${r}`))}var mt=new Set(["index","data-contracts","http-client"]);function dt(e){return String(e).split(/[^A-Za-z0-9]+/).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}function yt(e,t){if(!v.default.existsSync(e))return[];let r=[];for(let n of v.default.readdirSync(e)){if(!n.endsWith(t)||n.endsWith(`.d${t}`))continue;let s=n.slice(0,-t.length);if(mt.has(s)||s.endsWith("Route"))continue;let o=dt(s);r.push({base:s,className:o,property:o.charAt(0).toLowerCase()+o.slice(1)})}return r.sort((n,s)=>n.base.localeCompare(s.base))}function ve(e){return e.map(t=>({base:t.fileName,className:t.className,property:t.property}))}function ht(e,t,r,n){let s=t||"Api",o=e.map(c=>{let m=c.className===s?`${c.className}Module`:c.className,l=`${r?`${r.replace(/\\/g,"/")}/`:""}${c.base}`;return`import { ${c.className}${m===c.className?"":` as ${m}`} } from "./${l}"`}),a=e.map(c=>`${c.property} = new ${c.className===s?`${c.className}Module`:c.className}()`),i=e.map(c=>` this.${c.property}.instance = this.instance`);return['import { HttpClient } from "./http-client"',...o,'export * from "./data-contracts"',"","/** \u805A\u5408\u5165\u53E3\uFF1A\u5404\u6A21\u5757\u5171\u4EAB\u540C\u4E00\u4E2A\u8BF7\u6C42\u5B9E\u4F8B */",`export class ${s}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...a.map(c=>` ${c}`),""," constructor(config?: any) {"," super(config)",...i," }","}",""].join(`
|
|
2
|
+
`)}function Y(e,t,r,n){let s=r?".js":".ts",o=n??yt(e,s);if(o.length===0)return[];let a=ht(o,t,"",r),i=[],u=G.default.join(e,`index${s}`);if(v.default.writeFileSync(u,a),i.push(u),r){let c=xt(o,t),m=G.default.join(e,"index.d.ts");v.default.writeFileSync(m,c),i.push(m)}return i}function ee(e,t,r,n={}){let s=r?".js":".ts",o=[];for(let i of t){let u=G.default.join(e,`${i.fileName}${s}`);if(!v.default.existsSync(u)){o.push(`\u7F3A\u5C11\u6A21\u5757\u6587\u4EF6\uFF1A\u671F\u671B ${i.fileName}${s}\uFF08\u539F\u59CB\u7EC4\u540D ${i.raw}\uFF09`);continue}v.default.readFileSync(u,"utf8").includes(`class ${i.className}`)||o.push(`\u7C7B\u540D\u4E0E\u547D\u540D\u8868\u4E0D\u4E00\u81F4\uFF1A${i.fileName}${s} \u671F\u671B ${i.className}`)}if(n.aggregate!==!1){let i=G.default.join(e,`index${s}`);if(!v.default.existsSync(i))o.push(`\u7F3A\u5C11\u805A\u5408\u5165\u53E3\uFF1Aindex${s}`);else{let u=v.default.readFileSync(i,"utf8");for(let c of t)u.includes(`this.${c.property}.instance = this.instance`)||o.push(`\u805A\u5408\u5165\u53E3\u7F3A\u5C11\u6A21\u5757\u6302\u8F7D\uFF1A${c.property}`)}}let a=v.default.existsSync(e)?M(v.default.readdirSync(e),t,s):[];return{errors:o,orphans:a}}function xt(e,t){let r=t||"Api",n=e.map(o=>{let a=o.className===r?`${o.className}Module`:o.className;return`import { ${o.className}${a===o.className?"":` as ${a}`} } from "./${o.base}"`}),s=e.map(o=>{let a=o.className===r?`${o.className}Module`:o.className;return` ${o.property}: ${a}`});return['import { HttpClient } from "./http-client"',...n,'export * from "./data-contracts"',"",`export declare class ${r}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...s," constructor(config?: any)","}",""].join(`
|
|
3
|
+
`)}var $t=["get","post","put","delete","patch","head","options"];function Rt(e,t,r){let n=r.strategy?.length?r.strategy:["rules","tag","path"],s=r.fallback??"misc";for(let o of n)if(o==="rules")for(let[a,i]of(r.rules??[]).entries()){let u=i.match??{};if(u.prefix&&e.startsWith(u.prefix))return{group:i.group,source:"rules",ruleIndex:a};if(u.regex&&new RegExp(u.regex).test(e))return{group:i.group,source:"rules",ruleIndex:a};if(u.tag&&(t.tags??[]).includes(u.tag))return{group:i.group,source:"rules",ruleIndex:a};if(u.operationId&&t.operationId===u.operationId)return{group:i.group,source:"rules",ruleIndex:a}}else if(o==="tag"){let a=(t.tags??[])[0];if(a)return{group:String(a),source:"tag"}}else if(o==="path"){let a=e.split("/").filter(Boolean),i=r.pathDepth??0;if(a[i])return{group:a[i],source:"path"}}return{group:s,source:"fallback"}}function be(e,t){let r=t.fallback??"misc",n=[],s=new Set;for(let[l,g]of Object.entries(e.paths??{}))for(let y of $t){let h=g[y];if(!h||typeof h!="object")continue;let x=Rt(l,h,t);x.ruleIndex!==void 0&&s.add(x.ruleIndex),n.push({path:l,method:y,operation:h,group:x.group,ruleIndex:x.ruleIndex})}let o=new Map;n.forEach(({group:l})=>o.set(l,(o.get(l)??0)+1));for(let l of n){let g=o.get(l.group)??0;if(t.minRoutes&&g<t.minRoutes&&l.group!==r)l.group=r;else if(t.maxRoutes&&g>t.maxRoutes){let h=l.path.split("/").filter(Boolean)[(t.pathDepth??0)+1];h&&(l.group=`${l.group}_${h}`)}}let a=Se(n.map(l=>l.group),t.names),i=new Map(a.entries.map(l=>[l.raw,l])),u={},c={};for(let l of n){let g=Array.isArray(l.operation.tags)?l.operation.tags.join(", "):"";g&&(u[`${l.method.toUpperCase()}:${l.path}`]=g);let y=i.get(l.group);y&&(l.operation.tags=[y.fileName]),c[l.group]=(c[l.group]??0)+1}let m=Array.from({length:t.rules?.length??0},(l,g)=>g).filter(l=>!s.has(l));return{counts:c,originalTags:u,entries:a.entries,unmatchedRules:m,errors:a.errors,warnings:a.warnings}}var f={files:[],param:{}},p={home:Ee.default.homedir(),enum:{}},I=0,E=[],wt=()=>process.argv.includes("--dry-run"),St=()=>process.argv.includes("--json");function q(e,t=0){e&&console.log(e),process.exit(t)}async function Nt(){p.param={config:N(["--config","-c"]),configScan:d(["--config-scan","-cs"])??!0,configAll:d(["--config-all","-ca"]),quick:d(["--quick","-q"]),replaceTags:oe(["--replace-tags","-rt"],{length:2}),convertGet:d(["--convert-get","-cg"]),removeParam:d(["--remove-param","-rp"]),removePrefixIndex:N(["--remove-prefix-index","-rpi"]),removeDts:d(["--remove-dts","-rd"]),removeEmptyComponents:d(["--remove-empty-components","-rec"])??!0,extractRequestQuery:N(["--extract-request-query","-erq"]),extractResponseRaw:d(["--extract-response-raw","-err"]),template:S.default.resolve(ae(),"./templates")},p.config={templates:N(["--templates","-t"])??p.param.template,defaultResponseAsSuccess:d(["--default-as-success","-d"]),generateResponses:d(["--responses","-r"]),generateUnionEnums:d("--union-enums"),addReadonly:d("--add-readonly"),generateRouteTypes:d("--route-types"),generateClient:!d("--no-client"),enumNamesAsValues:d("--enum-names-as-values"),extractRequestParams:d("--extract-request-params"),extractRequestBody:d("--extract-request-body"),extractResponseBody:d("--extract-response-body"),extractResponseError:d("--extract-response-error"),modular:d("--modular"),toJS:d("--js"),moduleNameIndex:Number(N("--module-name-index")??0),moduleNameFirstTag:d("--module-name-first-tag"),httpClientType:d("--axios")?"axios":"fetch",unwrapResponseData:d("--unwrap-response-data"),disableThrowOnError:d("--disable-throw-on-error"),singleHttpClient:d("--single-http-client"),silent:d("--silent")??!0,defaultResponseType:N("--default-response")??"void",typePrefix:N("--type-prefix")??"",typeSuffix:N("--type-suffix")??"",cleanOutput:d("--clean-output"),...N("--api-class-name")?{apiClassName:N("--api-class-name")}:{},patch:d("--patch"),debug:d("--debug"),anotherArrayType:d("--another-array-type"),sortTypes:d("--sort-types"),extractEnums:d("--extract-enums")},vt()}function w(e){let t=process.argv.slice(2);return e.some(r=>t.includes(r))}function vt(){let e=$e(),t=ye(process.cwd(),{projectFile:e.configFile});t.warnings.forEach(l=>console.error("\u26A0\uFE0F",l));let r=he(xe(t.merged,e.profile)),n=r.input??{},s=r.output??{},o=r.types??{},a=r.naming??{},i=r.grouping??{},u=n.url??n.file;if(!u)return;p.rcDriven=!0,p.rcUrl=u,p.rcOutput=s.dir??"./src/api",p.rcName=s.name??"index";let c=p.param;c.quick=!0,!w(["--remove-prefix-index","-rpi"])&&a.pathPrefixIndex!==void 0&&(c.removePrefixIndex=String(a.pathPrefixIndex)),!w(["--convert-get","-cg"])&&a.convertGetToQuery!==void 0&&(c.convertGet=a.convertGetToQuery),!w(["--remove-param","-rp"])&&a.dropPathParams!==void 0&&(c.removeParam=a.dropPathParams),!w(["--extract-request-query","-erq"])&&o.extractQuery!==void 0&&(c.extractRequestQuery=o.extractQuery),!w(["--remove-dts","-rd"])&&o.removeDts!==void 0&&(c.removeDts=o.removeDts),!w(["--replace-tags","-rt"])&&a.tagRewrite&&(c.replaceTags=a.tagRewrite);let m=p.config;!w(["--axios"])&&r.client?.type&&(m.httpClientType=r.client.type==="axios"?"axios":"fetch"),!w(["--js"])&&r.language?.target&&(m.toJS=r.language.target==="js"),!w(["--responses","-r"])&&o.responses!==void 0&&(m.generateResponses=!!o.responses),!w(["--unwrap-response-data"])&&o.unwrapData!==void 0&&(m.unwrapResponseData=!!o.unwrapData),!w(["--extract-request-params"])&&o.extractParams!==void 0&&(m.extractRequestParams=!!o.extractParams),!w(["--clean-output"])&&s.clean!==void 0&&(m.cleanOutput=!!s.clean),!w(["--modular"])&&s.mode==="grouped"&&(m.modular=!0),!w(["--module-name-index"])&&i.pathDepth!==void 0&&(m.moduleNameIndex=Number(i.pathDepth)),Object.keys(i).length&&(m.grouping=i)}async function bt(){if(p.rcDriven){f.files=["(swagger2apirc)"];return}p.param.config?f.files=p.param.config.split(","):p.param.configScan&&(f.files=ie()),f.files.length==0&&(f.files=["saconfig.json"]),!p.param.configAll&&f.files.length>1&&(f.files=(await(0,te.default)({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:f.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:q("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),f.files?.length>0||q("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function At(){if(p.rcDriven){f.param={url:p.rcUrl,output:p.rcOutput,name:p.rcName},p.docFile=S.default.resolve(`${p.rcOutput}/${p.rcName}-${new Date().getTime()}.json`);return}try{f.param={},f.param=JSON.parse(O.default.readFileSync(f.file,"utf-8"))}catch{}(!p.param.quick||[f.param.url,f.param.output,f.param.name].includes(void 0))&&(f.param=await(0,te.default)([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:f.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:f.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:f.param.name??"index"}])),[f.param.url,f.param.output,f.param.name].includes(void 0)&&q("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),p.docFile=S.default.resolve(`${f.param.output}/${f.param.name}-${new Date().getTime()}.json`)}async function Oe(e=0){if(f.file=f.files[e],await At(),H(f.param.url))await je.default.get(f.param.url).then(t=>Ae(t.data)).catch(t=>console.log("\u5931\u8D25\uFF1A",t));else try{await Ae(JSON.parse(O.default.readFileSync(S.default.resolve(f.param.url),"utf8")))}catch(t){console.log("\u5931\u8D25\uFF1A",t)}f.files[e+1]?await Oe(e+1):I>0&&q(`\u7ED3\u675F\uFF1A${I} \u4E2A\u6587\u6863\u672A\u751F\u6210\uFF0C\u5931\u8D25\u539F\u56E0\u89C1\u4E0A\u65B9\u8F93\u51FA`,1)}function jt(e){let t=p.param.replaceTags;t?.length&&Object.values(e.paths??{}).forEach(r=>{Object.values(r).forEach(n=>{Array.isArray(n?.tags)&&(n.tags=n.tags.map(s=>s.replace(new RegExp(`^${t[0]}$`,"g"),t[1]??"")))})})}function Ct(e,t){let r=p.config.toJS?".js":".ts",n=S.default.resolve(f.param.output??"./src/api"),s=O.default.existsSync(n)?O.default.readdirSync(n):[],o=e.map(i=>`${i.fileName}${r}`).filter(i=>!s.includes(i)),a=M(s,e,r);if(St()){console.log(JSON.stringify({groups:e.map(({raw:i,fileName:u,className:c,property:m,reason:l,source:g})=>({raw:i,fileName:u,className:c,property:m,reason:l,source:g})),unmatchedRules:t,add:o,orphans:a},null,2));return}e.forEach(i=>console.log(`\u547D\u540D\uFF1A${i.raw} \u2192 ${i.fileName}\uFF08\u7C7B ${i.className}${i.reason?`\uFF0C${i.reason}`:""}\uFF09`)),t.length&&console.error(`\u26A0\uFE0F \u672A\u547D\u4E2D\u89C4\u5219\uFF1A${t.map(i=>i+1).join("\u3001")}`),o.length&&console.log(`\u9884\u8BA1\u65B0\u589E\uFF1A${o.join("\u3001")}`),a.length&&console.error(`\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A${a.join("\u3001")}`)}async function Ae(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");let t=await ge(e,{baseUrl:H(f.param.url)?f.param.url:void 0});if(t.errors.length>0){t.errors.forEach(n=>console.error("\u5931\u8D25\uFF1A",n)),I+=1;return}E=[],p.param.moduleClassNames=void 0,jt(e);let r=p.config.grouping;if(p.config.modular&&r&&(r.strategy?.length||r.rules?.length)){let n=be(e,r);if(n.warnings.forEach(s=>console.error("\u26A0\uFE0F",s)),n.errors.length>0){n.errors.forEach(s=>console.error("\u5931\u8D25\uFF1A",s)),I+=1;return}if(E=n.entries,p.config.moduleNameFirstTag=!0,p.param.moduleClassNames=Ne(n.entries),r.preserveTags!==!1&&(p.param.groupOriginalTags=n.originalTags),console.log("\u5206\u7EC4\uFF1A",...Object.entries(n.counts).map(([s,o])=>`${s}-${o}`)),wt()){Ct(n.entries,n.unmatchedRules);return}}if(Object.entries(e.paths).forEach(n=>{Object.keys(n[1]).forEach(s=>{let o=`${n[0]}/${s}`;if(p.param.convertGet&&(o=o.replace(/([^\}]\/)get$/g,"$1query")),p.param.removeParam&&(o=o.replace(/\/\{.+?\}/g,"")),p.param.removePrefixIndex){let i=o.split("/");i=i.slice(0,1).concat(i.slice(Number(p.param.removePrefixIndex)+2)),o=i.join("/")}o=o.replace(/["\\`\r\n]/g,"_").replace(/\$\{/g,"_"),e.paths[n[0]][s].operationId=o;let a=o.split("/").slice(-1)[0];typeof p.enum[a]=="number"?p.enum[a]++:p.enum[a]=1})}),Object.entries(e.components).forEach(n=>{Object.keys(n[1]).forEach(s=>{p.param.removeEmptyComponents&&!Object.keys(e.components[n[0]][s]).length&&delete e.components[n[0]][s]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(p.enum).map(n=>n.join("-"))),B(p.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",f.file),await(0,Ie.generateApi)({fileName:`${f.param.name}.ts`,output:S.default.resolve(f.param.output),input:p.docFile,...p.config,param:p.param}),console.log("\u5B8C\u6210\uFF1A",S.default.resolve(f.param.output,`${f.param.name}${p.config.toJS?".js":".ts"}`)),p.config.modular){let n=S.default.resolve(f.param.output),s=String(p.config.apiClassName??"Api"),o=!!p.config.toJS;if(E.length){let a=ee(n,E,o,{aggregate:!1});if(a.errors.length>0){a.errors.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),I+=1;return}Y(n,s,o,ve(E));let{errors:i,orphans:u}=ee(n,E,o);if(i.length>0){i.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),I+=1;return}u.forEach(c=>console.error("\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A",c))}else Y(n,s,o)}p.config.toJS&&console.log("\u5B8C\u6210\uFF1A",S.default.resolve(f.param.output,`${f.param.name}.d.ts`)),O.default.unlinkSync(p.docFile),p.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",S.default.resolve(f.param.output,`${f.param.name}.d.ts`)),(0,Ce.execSync)(`npx rimraf ${S.default.resolve(f.param.output,`${f.param.name}.d.ts`)}`,{cwd:p.home}).toString()),p.rcDriven||B(f.file,JSON.stringify(f.param,null,2))}async function Et(){await Nt(),await bt(),Oe()}0&&(module.exports={generateApi});
|
package/dist/index.js
CHANGED
|
@@ -1 +1,3 @@
|
|
|
1
|
-
var u=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(n,o)=>(typeof require<"u"?require:n)[o]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});import A from"axios";import{execSync as E}from"child_process";import T from"os";import x from"fs";import m from"path";import P from"prompts";import{generateApi as O}from"swagger-typescript-api";var h=e=>/^(https?:\/\/|:?\/\/)/.test(e);import f from"fs";import q from"url";import v from"path";var c={param:process.argv.filter((e,n)=>n>1)};function g(e,n="value",o={}){Array.isArray(e)||(e=[e]);let s;return c.param.forEach((l,p)=>{if(e.includes(l))["value"].includes(n)?s=c.param[p+1]:["array"].includes(n)?s=Array.from({length:o.length??1}).map((C,$)=>c.param[p+$+1]):s=!["false"].includes(c.param[p+1]);else return}),s}function r(e){return g(e,"key")}function i(e){return g(e,"value")}function S(e,n={}){return g(e,"array",n)??[]}function d(e,n){let o=v.dirname(e);f.existsSync(o)||f.mkdirSync(o,{recursive:!0}),f.writeFileSync(e,n)}function j(){return typeof u<"u"&&typeof module<"u"?__filename:q.fileURLToPath(import.meta.url)}function b(){return typeof u<"u"&&typeof module<"u"?__dirname:v.dirname(j())}import{globSync as k}from"glob";var a={files:[],param:{}},t={home:T.homedir(),enum:{}};function y(e){e&&console.log(e),process.exit()}async function D(){t.param={config:i(["--config","-c"]),configScan:r(["--config-scan","-cs"])??!0,configAll:r(["--config-all","-ca"]),quick:r(["--quick","-q"]),replaceTags:S(["--replace-tags","-rt"],{length:2}),convertGet:r(["--convert-get","-cg"]),removeParam:r(["--remove-param","-rp"]),removePrefixIndex:i(["--remove-prefix-index","-rpi"]),removeDts:r(["--remove-dts","-rd"]),removeEmptyComponents:r(["--remove-empty-components","-rec"])??!0,extractRequestQuery:i(["--extract-request-query","-erq"]),extractResponseRaw:r(["--extract-response-raw","-err"]),template:m.resolve(b(),"./templates")},t.config={templates:i(["--templates","-t"])??t.param.template,defaultResponseAsSuccess:r(["--default-as-success","-d"]),generateResponses:r(["--responses","-r"]),generateUnionEnums:r("--union-enums"),addReadonly:r("--add-readonly"),generateRouteTypes:r("--route-types"),generateClient:!r("--no-client"),enumNamesAsValues:r("--enum-names-as-values"),extractRequestParams:r("--extract-request-params"),extractRequestBody:r("--extract-request-body"),extractResponseBody:r("--extract-response-body"),extractResponseError:r("--extract-response-error"),modular:r("--modular"),toJS:r("--js"),moduleNameIndex:Number(i("--module-name-index")??0),moduleNameFirstTag:r("--module-name-first-tag"),httpClientType:r("--axios")?"axios":"fetch",unwrapResponseData:r("--unwrap-response-data"),disableThrowOnError:r("--disable-throw-on-error"),singleHttpClient:r("--single-http-client"),silent:r("--silent")??!0,defaultResponseType:i("--default-response")??"void",typePrefix:i("--type-prefix")??"",typeSuffix:i("--type-suffix")??"",cleanOutput:r("--clean-output"),...i("--api-class-name")?{apiClassName:i("--api-class-name")}:{},patch:r("--patch"),debug:r("--debug"),anotherArrayType:r("--another-array-type"),sortTypes:r("--sort-types"),extractEnums:r("--extract-enums")}}async function F(){t.param.config?a.files=t.param.config.split(","):t.param.configScan&&(a.files=k(["./**/saconfig*.json"],{ignore:"node_modules/**"})),a.files.length==0&&(a.files=["saconfig.json"]),!t.param.configAll&&a.files.length>1&&(a.files=(await P({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:a.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:y("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),a.files?.length>0||y("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function N(){try{a.param={},a.param=JSON.parse(x.readFileSync(a.file,"utf-8"))}catch{}(!t.param.quick||[a.param.url,a.param.output,a.param.name].includes(void 0))&&(a.param=await P([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:a.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:a.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:a.param.name??"index"}])),[a.param.url,a.param.output,a.param.name].includes(void 0)&&y("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),t.docFile=m.resolve(`${a.param.output}/${a.param.name}-${new Date().getTime()}.json`)}async function R(e=0){if(a.file=a.files[e],await N(),h(a.param.url))await A.get(a.param.url).then(n=>w(n.data)).catch(n=>console.log("\u5931\u8D25\uFF1A",n));else try{await w(JSON.parse(x.readFileSync(m.resolve(a.param.url),"utf8")))}catch(n){console.log("\u5931\u8D25\uFF1A",n)}a.files[e+1]&&R(e+1)}async function w(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");Object.entries(e.paths).forEach(n=>{Object.keys(n[1]).forEach(o=>{t.param.replaceTags.length&&(e.paths[n[0]][o].tags=e.paths[n[0]][o].tags?.map(p=>p.replace(new RegExp(`^${t.param.replaceTags[0]}$`,"g"),t.param.replaceTags[1]??"")));let s=`${n[0]}/${o}`;if(t.param.convertGet&&(s=s.replace(/([^\}]\/)get$/g,"$1query")),t.param.removeParam&&(s=s.replace(/\/\{.+?\}/g,"")),t.param.removePrefixIndex){let p=s.split("/");p=p.slice(0,1).concat(p.slice(Number(t.param.removePrefixIndex)+2)),s=p.join("/")}e.paths[n[0]][o].operationId=s;let l=s.split("/").slice(-1)[0];typeof t.enum[l]=="number"?t.enum[l]++:t.enum[l]=1})}),Object.entries(e.components).forEach(n=>{Object.keys(n[1]).forEach(o=>{t.param.removeEmptyComponents&&!Object.keys(e.components[n[0]][o]).length&&delete e.components[n[0]][o]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(t.enum).map(n=>n.join("-"))),d(t.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",a.file),await O({fileName:`${a.param.name}.ts`,output:m.resolve(a.param.output),input:t.docFile,...t.config,param:t.param}),console.log("\u5B8C\u6210\uFF1A",m.resolve(a.param.output,`${a.param.name}${t.config.toJS?".js":".ts"}`)),t.config.toJS&&console.log("\u5B8C\u6210\uFF1A",m.resolve(a.param.output,`${a.param.name}.d.ts`)),x.unlinkSync(t.docFile),t.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",m.resolve(a.param.output,`${a.param.name}.d.ts`)),E(`npx rimraf ${m.resolve(a.param.output,`${a.param.name}.d.ts`)}`,{cwd:t.home}).toString()),d(a.file,JSON.stringify(a.param,null,2))}async function ne(){await D(),await F(),R()}export{ne as generateApi};
|
|
1
|
+
var M=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(t,r)=>(typeof require<"u"?require:t)[r]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});import it from"axios";import{execSync as ct}from"child_process";import pt from"os";import O from"fs";import S from"path";import Se from"prompts";import{generateApi as ut}from"swagger-typescript-api";var q=e=>/^(https?:\/\/|:?\/\/)/.test(e);import k from"fs";import be from"url";import F from"path";var L={param:process.argv.filter((e,t)=>t>1)};function J(e,t="value",r={}){Array.isArray(e)||(e=[e]);let n;return L.param.forEach((s,o)=>{if(e.includes(s))["value"].includes(t)?n=L.param[o+1]:["array"].includes(t)?n=Array.from({length:r.length??1}).map((a,i)=>L.param[o+i+1]):n=!["false"].includes(L.param[o+1]);else return}),n}function d(e){return J(e,"key")}function w(e){return J(e,"value")}function te(e,t={}){return J(e,"array",t)??[]}function H(e,t){let r=F.dirname(e);k.existsSync(r)||k.mkdirSync(r,{recursive:!0}),k.writeFileSync(e,t)}function Ae(){return typeof M<"u"&&typeof module<"u"?__filename:be.fileURLToPath(import.meta.url)}function re(){return typeof M<"u"&&typeof module<"u"?__dirname:F.dirname(Ae())}function ne(e=process.cwd()){let t=[],r=n=>{for(let s of k.readdirSync(n,{withFileTypes:!0})){if(s.name.startsWith("."))continue;let o=F.join(n,s.name);if(s.isDirectory()){if(s.name==="node_modules")continue;r(o)}else s.isFile()&&s.name.startsWith("saconfig")&&s.name.endsWith(".json")&&t.push(F.relative(e,o))}};return r(e),t.sort()}function G(e){return JSON.stringify(e).slice(1,-1)}function se(e){return e.replace(/\\/g,"\\\\").replace(/`/g,"\\`").replace(/\$\{/g,"\\${")}import*as ie from"dns/promises";import*as B from"net";var je=5,E=async e=>{try{return(await ie.lookup(e,{all:!0,verbatim:!0})).map(r=>r.address)}catch{return[]}};function W(e){let t=e.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);if(!t)return!1;let r=t.slice(1).map(Number);if(r.some(o=>o>255))return!1;let[n,s]=r;return n===0||n===10||n===127||n===169&&s===254||n===172&&s>=16&&s<=31||n===192&&s===168}function Ce(e){let t=e.toLowerCase();if(t==="::"||t==="::1"||t.startsWith("fe80:"))return!0;let r=t.split(":")[0]??"";if(r>="fc00"&&r<="fdff")return!0;let n=t.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/);if(n?.[1])return W(n[1]);let s=t.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);if(s?.[1]&&s?.[2]){let o=parseInt(s[1],16),a=parseInt(s[2],16);return W(`${o>>8&255}.${o&255}.${a>>8&255}.${a&255}`)}return!1}function oe(e){let t=B.isIP(e);return t===4?W(e):t===6?Ce(e):!1}function Ee(e){let t=e.toLowerCase();return t==="localhost"||t.endsWith(".localhost")}async function Ie(e,t=E){let r;try{r=new URL(e)}catch{return!1}if(r.protocol!=="http:"&&r.protocol!=="https:")return!1;let n=r.hostname.startsWith("[")&&r.hostname.endsWith("]")?r.hostname.slice(1,-1):r.hostname;if(Ee(n))return!1;if(B.isIP(n))return!oe(n);let s=await t(n);return s.length===0?!1:s.every(o=>!oe(o))}function Oe(e,t){if(typeof t!="string")return!1;try{let r=new URL(e),n=new URL(t);return r.protocol===n.protocol&&r.host===n.host}catch{return!1}}function ae(e){return e.split("#")[0]||e}async function z(e,t,r=E){let{specSourceUrl:n,allowExplicitSpecUrl:s=!1}=t;return s&&typeof n=="string"&&ae(e)===ae(n)||typeof n=="string"&&Oe(e,n)?!0:Ie(e,r)}function Le(e,t){try{return new URL(e,t).toString()}catch{return null}}async function ce(e,t,r,n=E,s=fetch){let o=e,a=0;for(;;){if(!await z(o,{specSourceUrl:r.specSourceUrl,allowExplicitSpecUrl:r.allowExplicitSpecUrl&&a===0},n))return null;let u=await s(o,{...t,redirect:"manual"});if(u.status>=300&&u.status<400){let c=u.headers.get("location");if(!c||a>=je)return null;let m=Le(c,o);if(!m)return null;o=m,a+=1;continue}return u}}var P=/["\\\u0000-\u001f]/;function ke(e){if(e.paths&&typeof e.paths=="object"){let t={};for(let[r,n]of Object.entries(e.paths))t[se(r)]=n;e.paths=t}if(Array.isArray(e.servers))for(let t of e.servers)t&&typeof t.url=="string"&&(t.url=G(t.url));V(e)}function V(e){if(Array.isArray(e)){e.forEach(t=>V(t));return}if(!(!e||typeof e!="object"))for(let t of Object.keys(e)){let r=e[t];t==="enum"&&Array.isArray(r)?e[t]=r.map(n=>typeof n=="string"?G(n):n):t==="default"&&typeof r=="string"?e[t]=G(r):V(r)}}function Fe(e){let t=[],r=(n,s)=>{if(Array.isArray(n)){n.forEach((o,a)=>r(o,`${s}[${a}]`));return}if(!(!n||typeof n!="object")){if(n.properties&&typeof n.properties=="object")for(let o of Object.keys(n.properties))P.test(o)&&t.push(`${s}.properties\uFF1A\u5C5E\u6027\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(Array.isArray(n.required))for(let o of n.required)typeof o=="string"&&P.test(o)&&t.push(`${s}.required\uFF1A\u5FC5\u586B\u5B57\u6BB5\u540D\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);if(n.discriminator&&typeof n.discriminator=="object"&&(typeof n.discriminator.propertyName=="string"&&P.test(n.discriminator.propertyName)&&t.push(`${s}.discriminator.propertyName\uFF1A\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(n.discriminator.propertyName)}`),n.discriminator.mapping&&typeof n.discriminator.mapping=="object"))for(let o of Object.keys(n.discriminator.mapping))P.test(o)&&t.push(`${s}.discriminator.mapping\uFF1A\u952E\u542B\u975E\u6CD5\u5B57\u7B26\uFF1A${JSON.stringify(o)}`);for(let o of Object.keys(n))r(n[o],`${s}.${o}`)}};return r(e,"#"),t}async function Ge(e,t={}){let r=[],n={baseUrl:t.baseUrl,resolve:t.resolve??E,fetchImpl:t.fetchImpl??fetch,docs:new Map,errors:r},s=async(a,i,u)=>{if(Array.isArray(a)){let m=[];for(let l=0;l<a.length;l+=1)m.push(await s(a[l],`${i}[${l}]`,u));return m}if(!a||typeof a!="object")return a;let c=a.$ref;if(typeof c=="string"&&!c.startsWith("#")){let m=await o(c,i,u);return m===null?a:s(m,i,u)}for(let m of Object.keys(a))a[m]=await s(a[m],`${i}.${m}`,u);return a},o=async(a,i,u)=>{if(!/^https?:\/\//i.test(a))return r.push(`${i}\uFF1A\u4E0D\u652F\u6301\u7684\u5916\u90E8\u5F15\u7528\uFF08\u4EC5\u5141\u8BB8\u6587\u6863\u5185 #/ \u6216 http(s)\uFF09\uFF1A${a}`),null;let c=a.indexOf("#"),m=c===-1?a:a.slice(0,c),l=c===-1?"":a.slice(c+1),g;try{g=n.baseUrl?new URL(m,n.baseUrl).toString():m}catch{return r.push(`${i}\uFF1A\u65E0\u6CD5\u89E3\u6790\u7684\u5F15\u7528\u5730\u5740\uFF1A${a}`),null}let y=`${g}#${l}`;if(u.includes(y))return r.push(`${i}\uFF1A\u68C0\u6D4B\u5230\u5F15\u7528\u73AF\uFF1A${[...u,y].join(" -> ")}`),null;if(!await z(g,{specSourceUrl:n.baseUrl},n.resolve))return r.push(`${i}\uFF1A\u62D2\u7EDD\u62C9\u53D6\u975E\u516C\u7F51\u6216\u975E\u4FE1\u4EFB\u6765\u6E90\u7684\u5916\u90E8\u5F15\u7528\uFF1A${a}`),null;let x=await Pe(g,n);if(!x)return null;let $=Ue(x,l);if($===void 0)return r.push(`${i}\uFF1A\u5F15\u7528\u7247\u6BB5\u4E0D\u5B58\u5728\uFF1A${a}`),null;let v=await s(structuredClone($),i,[...u,y]),b=_e(e,l,v,g);return b?{$ref:`#/components/schemas/${b}`}:v};return await s(e,"#",[]),r}async function Pe(e,t){if(t.docs.has(e))return t.docs.get(e);let r=await ce(e,{},{specSourceUrl:t.baseUrl},t.resolve,t.fetchImpl);if(!r?.ok)return t.errors.push(`\u5916\u90E8\u5F15\u7528\u62C9\u53D6\u5931\u8D25\uFF1A${e}`),null;let n=await r.text();try{let s=JSON.parse(n);return t.docs.set(e,s),s}catch{return t.errors.push(`\u5916\u90E8\u5F15\u7528\u6587\u6863\u4EC5\u652F\u6301 JSON \u683C\u5F0F\uFF1A${e}`),null}}function Ue(e,t){if(!t||t==="/")return e;let r=e;for(let n of t.replace(/^\//,"").split("/")){if(r===null||typeof r!="object")return;let s=decodeURIComponent(n).replace(/~1/g,"/").replace(/~0/g,"~");r=r[s]}return r}function _e(e,t,r,n){let s=t.match(/^\/components\/schemas\/([^/]+)$/);if(!s)return null;let o=decodeURIComponent(s[1]).replace(/~1/g,"/").replace(/~0/g,"~");e.components=e.components??{},e.components.schemas=e.components.schemas??{};let a=e.components.schemas;if(a[o]===void 0)return a[o]=r,o;if(JSON.stringify(a[o])===JSON.stringify(r))return o;let i=(n.split("/").pop()??"ref").replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9_$]/g,"_")||"ref",u=`${o}_${i}`,c=2;for(;a[u]!==void 0&&JSON.stringify(a[u])!==JSON.stringify(r);)u=`${o}_${i}_${c}`,c+=1;return a[u]=r,u}async function pe(e,t={}){let r=await Ge(e,t);return ke(e),{errors:[...r,...Fe(e)]}}import X from"fs";import De from"os";import I from"path";var Te=".swagger2apirc.json",Me=".swagger2apirc.local.json",qe=".swagger2apirc.json";function K(e,t,r){let n={layer:t,file:e,hit:!1,sections:[],config:null};if(!e||!X.existsSync(e))return n;try{let s=JSON.parse(X.readFileSync(e,"utf8"));return!s||typeof s!="object"||Array.isArray(s)?(r.push(`${e}\uFF1A\u6839\u8282\u70B9\u5FC5\u987B\u662F\u5BF9\u8C61\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),{...n,hit:!1}):{layer:t,file:e,hit:!0,sections:Object.keys(s),config:s}}catch(s){return r.push(`${e}\uFF1A\u89E3\u6790\u5931\u8D25\uFF08${s.message}\uFF09\uFF0C\u5DF2\u5FFD\u7565\u8BE5\u5C42`),n}}function ue(e,t){let r=I.resolve(t);for(;;){let n=I.join(r,e);if(X.existsSync(n))return n;let s=I.dirname(r);if(s===r)return null;r=s}}function Je(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let r={...e};for(let[n,s]of Object.entries(t))r[n]=s;return r}function He(e,t){if(!e)return t?{...t}:null;if(!t)return{...e};let r={...e};for(let[n,s]of Object.entries(t)){let o=r[n];r[n]=o&&typeof o=="object"&&!Array.isArray(o)&&s&&typeof s=="object"&&!Array.isArray(s)?{...o,...s}:s}return r}function le(e=process.cwd(),t={}){let r=[],n=K(I.join(t.homeDir??De.homedir(),qe),"\u5168\u5C40\u5C42",r),s=t.projectFile?I.resolve(t.projectFile):ue(Te,e),o=K(s,"\u9879\u76EE\u5C42",r),a=K(ue(Me,e),"\u672C\u5730\u5C42",r),i=He(Je(n.config,o.config),a.config);return{global:n,project:o,local:a,merged:i,warnings:r}}var We=[{env:"FX_S2A_INPUT",key:"input.url",type:"string"},{env:"FX_S2A_OUTPUT",key:"output.dir",type:"string"},{env:"FX_S2A_NAME",key:"output.name",type:"string"},{env:"FX_S2A_CLIENT",key:"client.type",type:"string"},{env:"FX_S2A_LANGUAGE",key:"language.target",type:"string"},{env:"FX_S2A_CLEAN",key:"output.clean",type:"boolean"}];function Be(e,t,r){let n=t.split("."),s=e;n.forEach((o,a)=>{if(a===n.length-1){s[o]=r;return}(!s[o]||typeof s[o]!="object")&&(s[o]={}),s=s[o]})}function fe(e,t=process.env){let r=e?structuredClone(e):{};for(let n of We){let s=t[n.env];s===void 0||s===""||Be(r,n.key,n.type==="boolean"?!["0","false"].includes(s.toLowerCase()):s)}return r}function ge(e,t){let r=e?structuredClone(e):{};if(!t)return r;let n=r.profiles?.[t];if(!n||typeof n!="object")return r;for(let[s,o]of Object.entries(n)){if(s==="profiles")continue;let a=r[s];r[s]=a&&typeof a=="object"&&!Array.isArray(a)&&o&&typeof o=="object"&&!Array.isArray(o)?{...a,...o}:o}return r}function me(e=process.argv.slice(2)){let t=r=>r.reduce((n,s)=>n??(e.includes(s)?e[e.indexOf(s)+1]:void 0),void 0);return{configFile:t(["--config","-c"]),profile:t(["--profile"])}}import N from"fs";import _ from"path";var ze=new Set(["index","datacontracts","httpclient"]),Ve=new Set(["HttpClient","RequestParams","ContentType","AxiosRequestConfig","AxiosResponse"]),Ke=new Set(["con","prn","aux","nul",...Array.from({length:9},(e,t)=>`com${t+1}`),...Array.from({length:9},(e,t)=>`lpt${t+1}`)]),de=64;function A(e){return String(e).normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}]+/gu,"")}function Xe(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g,"$1 $2").split(" ").filter(Boolean)}function Ze(e){let t=e.normalize("NFKC"),r=[];for(let n of t.matchAll(/[A-Za-z0-9]+|[\p{L}\p{N}]+/gu)){let s=n[0];/^[A-Za-z0-9]+$/.test(s)?r.push(...Xe(s)):r.push(s)}return r}function Qe(e){return e.map((t,r)=>{if(/^[A-Za-z0-9]+$/.test(t)){let n=t.toLowerCase();return r===0?n:n.charAt(0).toUpperCase()+n.slice(1)}return t}).join("")}function Ye(e){let t=2166136261;for(let r of e)t^=r.codePointAt(0)??0,t=Math.imul(t,16777619);return(t>>>0).toString(16).padStart(8,"0").slice(0,6)}function ye(e){let t=[],r=Ze(e),n=Qe(r);return n?(/^[0-9]/.test(n)&&(n=`g${n}`,t.push("\u6570\u5B57\u5F00\u5934")),[...n].length>de&&(n=[...n].slice(0,de-6).join("")+Ye(e),t.push("\u8D85\u957F\u622A\u65AD")),{slug:n,reason:t.join("\u3001")}):{slug:"",reason:"\u540D\u79F0\u4E0D\u542B\u53EF\u7528\u5B57\u7B26"}}function Z(e){return e.charAt(0).toUpperCase()+e.slice(1)}function he(e,t={}){let r=[],n=[],s=[...new Set(e)].sort((g,y)=>g<y?-1:g>y?1:0),o=new Map,a=new Set;for(let[g,y]of Object.entries(t))o.set(g,y),o.set(A(g),y);let i=new Set,u=[],c=(g,y=2)=>{let h=g,x=y;for(;i.has(h.toLowerCase());)h=`${g}${x}`,x+=1;return i.add(h.toLowerCase()),h},m=new Map;for(let g of s){let y=o.get(g)??o.get(A(g));if(y===void 0)continue;a.add(g),a.add(A(g));let{slug:h}=ye(y);if(!h){r.push(`\u624B\u5DE5\u540D\u4E0D\u53EF\u7528\uFF1A${g} \u2192 ${y}`);continue}let x=m.get(h.toLowerCase());x?r.push(`\u624B\u5DE5\u540D\u51B2\u7A81\uFF1A${x} \u4E0E ${g} \u90FD\u6307\u5411 ${h}`):m.set(h.toLowerCase(),g);let $=c(h),v=Z($);u.push({raw:g,key:A(g),fileName:v,className:v,property:$,reason:$===h?"\u624B\u5DE5\u6307\u5B9A":"\u624B\u5DE5\u6307\u5B9A\u3001\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D",source:"manual"})}let l=1;for(let g of s){if(u.some(ve=>ve.raw===g))continue;let{slug:y,reason:h}=ye(g),x=!y,$=y;if(x){for(;i.has(`group${l}`.toLowerCase());)l+=1;$=`group${l}`,l+=1}let v=ze.has($.toLowerCase())||Ke.has($.toLowerCase())||Ve.has(Z($)),b=v?c(`${$}2`,3):c($),ee=Z(b),T=[h];v?T.push("\u4E0E\u4FDD\u7559\u540D\u51B2\u7A81"):b!==$&&T.push("\u4E0E\u5DF2\u6709\u7EC4\u91CD\u540D"),u.push({raw:g,key:A(g),fileName:ee,className:ee,property:b,reason:T.filter(Boolean).join("\u3001"),source:x?"fallback":"auto"})}for(let g of Object.keys(t))!a.has(g)&&!a.has(A(g))&&n.push(`grouping.names \u4E2D\u7684\u952E\u672A\u51FA\u73B0\u5728\u672C\u6B21\u5206\u7EC4\u7ED3\u679C\uFF1A${g}`);return{entries:u,errors:r,warnings:n}}function xe(e){let t={};for(let r of e)t[r.fileName]=r.className,t[r.fileName.charAt(0).toLowerCase()+r.fileName.slice(1)]=r.className;return t}function U(e,t,r){let n=new Set(t.map(o=>`${o.fileName}${r}`)),s=new Set([`index${r}`,"index.d.ts",`data-contracts${r}`,`http-client${r}`,`route-types${r}`]);return e.filter(o=>o.endsWith(r)&&!o.endsWith(`.d${r}`)&&!n.has(o)&&!s.has(o)&&!o.endsWith(`_Route${r}`))}var et=new Set(["index","data-contracts","http-client"]);function tt(e){return String(e).split(/[^A-Za-z0-9]+/).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}function rt(e,t){if(!N.existsSync(e))return[];let r=[];for(let n of N.readdirSync(e)){if(!n.endsWith(t)||n.endsWith(`.d${t}`))continue;let s=n.slice(0,-t.length);if(et.has(s)||s.endsWith("Route"))continue;let o=tt(s);r.push({base:s,className:o,property:o.charAt(0).toLowerCase()+o.slice(1)})}return r.sort((n,s)=>n.base.localeCompare(s.base))}function $e(e){return e.map(t=>({base:t.fileName,className:t.className,property:t.property}))}function nt(e,t,r,n){let s=t||"Api",o=e.map(c=>{let m=c.className===s?`${c.className}Module`:c.className,l=`${r?`${r.replace(/\\/g,"/")}/`:""}${c.base}`;return`import { ${c.className}${m===c.className?"":` as ${m}`} } from "./${l}"`}),a=e.map(c=>`${c.property} = new ${c.className===s?`${c.className}Module`:c.className}()`),i=e.map(c=>` this.${c.property}.instance = this.instance`);return['import { HttpClient } from "./http-client"',...o,'export * from "./data-contracts"',"","/** \u805A\u5408\u5165\u53E3\uFF1A\u5404\u6A21\u5757\u5171\u4EAB\u540C\u4E00\u4E2A\u8BF7\u6C42\u5B9E\u4F8B */",`export class ${s}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...a.map(c=>` ${c}`),""," constructor(config?: any) {"," super(config)",...i," }","}",""].join(`
|
|
2
|
+
`)}function Q(e,t,r,n){let s=r?".js":".ts",o=n??rt(e,s);if(o.length===0)return[];let a=nt(o,t,"",r),i=[],u=_.join(e,`index${s}`);if(N.writeFileSync(u,a),i.push(u),r){let c=st(o,t),m=_.join(e,"index.d.ts");N.writeFileSync(m,c),i.push(m)}return i}function Y(e,t,r,n={}){let s=r?".js":".ts",o=[];for(let i of t){let u=_.join(e,`${i.fileName}${s}`);if(!N.existsSync(u)){o.push(`\u7F3A\u5C11\u6A21\u5757\u6587\u4EF6\uFF1A\u671F\u671B ${i.fileName}${s}\uFF08\u539F\u59CB\u7EC4\u540D ${i.raw}\uFF09`);continue}N.readFileSync(u,"utf8").includes(`class ${i.className}`)||o.push(`\u7C7B\u540D\u4E0E\u547D\u540D\u8868\u4E0D\u4E00\u81F4\uFF1A${i.fileName}${s} \u671F\u671B ${i.className}`)}if(n.aggregate!==!1){let i=_.join(e,`index${s}`);if(!N.existsSync(i))o.push(`\u7F3A\u5C11\u805A\u5408\u5165\u53E3\uFF1Aindex${s}`);else{let u=N.readFileSync(i,"utf8");for(let c of t)u.includes(`this.${c.property}.instance = this.instance`)||o.push(`\u805A\u5408\u5165\u53E3\u7F3A\u5C11\u6A21\u5757\u6302\u8F7D\uFF1A${c.property}`)}}let a=N.existsSync(e)?U(N.readdirSync(e),t,s):[];return{errors:o,orphans:a}}function st(e,t){let r=t||"Api",n=e.map(o=>{let a=o.className===r?`${o.className}Module`:o.className;return`import { ${o.className}${a===o.className?"":` as ${a}`} } from "./${o.base}"`}),s=e.map(o=>{let a=o.className===r?`${o.className}Module`:o.className;return` ${o.property}: ${a}`});return['import { HttpClient } from "./http-client"',...n,'export * from "./data-contracts"',"",`export declare class ${r}<SecurityDataType = unknown> extends HttpClient<SecurityDataType> {`,...s," constructor(config?: any)","}",""].join(`
|
|
3
|
+
`)}var ot=["get","post","put","delete","patch","head","options"];function at(e,t,r){let n=r.strategy?.length?r.strategy:["rules","tag","path"],s=r.fallback??"misc";for(let o of n)if(o==="rules")for(let[a,i]of(r.rules??[]).entries()){let u=i.match??{};if(u.prefix&&e.startsWith(u.prefix))return{group:i.group,source:"rules",ruleIndex:a};if(u.regex&&new RegExp(u.regex).test(e))return{group:i.group,source:"rules",ruleIndex:a};if(u.tag&&(t.tags??[]).includes(u.tag))return{group:i.group,source:"rules",ruleIndex:a};if(u.operationId&&t.operationId===u.operationId)return{group:i.group,source:"rules",ruleIndex:a}}else if(o==="tag"){let a=(t.tags??[])[0];if(a)return{group:String(a),source:"tag"}}else if(o==="path"){let a=e.split("/").filter(Boolean),i=r.pathDepth??0;if(a[i])return{group:a[i],source:"path"}}return{group:s,source:"fallback"}}function Re(e,t){let r=t.fallback??"misc",n=[],s=new Set;for(let[l,g]of Object.entries(e.paths??{}))for(let y of ot){let h=g[y];if(!h||typeof h!="object")continue;let x=at(l,h,t);x.ruleIndex!==void 0&&s.add(x.ruleIndex),n.push({path:l,method:y,operation:h,group:x.group,ruleIndex:x.ruleIndex})}let o=new Map;n.forEach(({group:l})=>o.set(l,(o.get(l)??0)+1));for(let l of n){let g=o.get(l.group)??0;if(t.minRoutes&&g<t.minRoutes&&l.group!==r)l.group=r;else if(t.maxRoutes&&g>t.maxRoutes){let h=l.path.split("/").filter(Boolean)[(t.pathDepth??0)+1];h&&(l.group=`${l.group}_${h}`)}}let a=he(n.map(l=>l.group),t.names),i=new Map(a.entries.map(l=>[l.raw,l])),u={},c={};for(let l of n){let g=Array.isArray(l.operation.tags)?l.operation.tags.join(", "):"";g&&(u[`${l.method.toUpperCase()}:${l.path}`]=g);let y=i.get(l.group);y&&(l.operation.tags=[y.fileName]),c[l.group]=(c[l.group]??0)+1}let m=Array.from({length:t.rules?.length??0},(l,g)=>g).filter(l=>!s.has(l));return{counts:c,originalTags:u,entries:a.entries,unmatchedRules:m,errors:a.errors,warnings:a.warnings}}var f={files:[],param:{}},p={home:pt.homedir(),enum:{}},C=0,j=[],lt=()=>process.argv.includes("--dry-run"),ft=()=>process.argv.includes("--json");function D(e,t=0){e&&console.log(e),process.exit(t)}async function gt(){p.param={config:w(["--config","-c"]),configScan:d(["--config-scan","-cs"])??!0,configAll:d(["--config-all","-ca"]),quick:d(["--quick","-q"]),replaceTags:te(["--replace-tags","-rt"],{length:2}),convertGet:d(["--convert-get","-cg"]),removeParam:d(["--remove-param","-rp"]),removePrefixIndex:w(["--remove-prefix-index","-rpi"]),removeDts:d(["--remove-dts","-rd"]),removeEmptyComponents:d(["--remove-empty-components","-rec"])??!0,extractRequestQuery:w(["--extract-request-query","-erq"]),extractResponseRaw:d(["--extract-response-raw","-err"]),template:S.resolve(re(),"./templates")},p.config={templates:w(["--templates","-t"])??p.param.template,defaultResponseAsSuccess:d(["--default-as-success","-d"]),generateResponses:d(["--responses","-r"]),generateUnionEnums:d("--union-enums"),addReadonly:d("--add-readonly"),generateRouteTypes:d("--route-types"),generateClient:!d("--no-client"),enumNamesAsValues:d("--enum-names-as-values"),extractRequestParams:d("--extract-request-params"),extractRequestBody:d("--extract-request-body"),extractResponseBody:d("--extract-response-body"),extractResponseError:d("--extract-response-error"),modular:d("--modular"),toJS:d("--js"),moduleNameIndex:Number(w("--module-name-index")??0),moduleNameFirstTag:d("--module-name-first-tag"),httpClientType:d("--axios")?"axios":"fetch",unwrapResponseData:d("--unwrap-response-data"),disableThrowOnError:d("--disable-throw-on-error"),singleHttpClient:d("--single-http-client"),silent:d("--silent")??!0,defaultResponseType:w("--default-response")??"void",typePrefix:w("--type-prefix")??"",typeSuffix:w("--type-suffix")??"",cleanOutput:d("--clean-output"),...w("--api-class-name")?{apiClassName:w("--api-class-name")}:{},patch:d("--patch"),debug:d("--debug"),anotherArrayType:d("--another-array-type"),sortTypes:d("--sort-types"),extractEnums:d("--extract-enums")},mt()}function R(e){let t=process.argv.slice(2);return e.some(r=>t.includes(r))}function mt(){let e=me(),t=le(process.cwd(),{projectFile:e.configFile});t.warnings.forEach(l=>console.error("\u26A0\uFE0F",l));let r=fe(ge(t.merged,e.profile)),n=r.input??{},s=r.output??{},o=r.types??{},a=r.naming??{},i=r.grouping??{},u=n.url??n.file;if(!u)return;p.rcDriven=!0,p.rcUrl=u,p.rcOutput=s.dir??"./src/api",p.rcName=s.name??"index";let c=p.param;c.quick=!0,!R(["--remove-prefix-index","-rpi"])&&a.pathPrefixIndex!==void 0&&(c.removePrefixIndex=String(a.pathPrefixIndex)),!R(["--convert-get","-cg"])&&a.convertGetToQuery!==void 0&&(c.convertGet=a.convertGetToQuery),!R(["--remove-param","-rp"])&&a.dropPathParams!==void 0&&(c.removeParam=a.dropPathParams),!R(["--extract-request-query","-erq"])&&o.extractQuery!==void 0&&(c.extractRequestQuery=o.extractQuery),!R(["--remove-dts","-rd"])&&o.removeDts!==void 0&&(c.removeDts=o.removeDts),!R(["--replace-tags","-rt"])&&a.tagRewrite&&(c.replaceTags=a.tagRewrite);let m=p.config;!R(["--axios"])&&r.client?.type&&(m.httpClientType=r.client.type==="axios"?"axios":"fetch"),!R(["--js"])&&r.language?.target&&(m.toJS=r.language.target==="js"),!R(["--responses","-r"])&&o.responses!==void 0&&(m.generateResponses=!!o.responses),!R(["--unwrap-response-data"])&&o.unwrapData!==void 0&&(m.unwrapResponseData=!!o.unwrapData),!R(["--extract-request-params"])&&o.extractParams!==void 0&&(m.extractRequestParams=!!o.extractParams),!R(["--clean-output"])&&s.clean!==void 0&&(m.cleanOutput=!!s.clean),!R(["--modular"])&&s.mode==="grouped"&&(m.modular=!0),!R(["--module-name-index"])&&i.pathDepth!==void 0&&(m.moduleNameIndex=Number(i.pathDepth)),Object.keys(i).length&&(m.grouping=i)}async function dt(){if(p.rcDriven){f.files=["(swagger2apirc)"];return}p.param.config?f.files=p.param.config.split(","):p.param.configScan&&(f.files=ne()),f.files.length==0&&(f.files=["saconfig.json"]),!p.param.configAll&&f.files.length>1&&(f.files=(await Se({type:"multiselect",name:"files",message:"\u9009\u62E9\u914D\u7F6E\u6587\u4EF6",hint:"\u53EF\u591A\u9009\uFF0C\u7A7A\u683C\u952E\u52FE\u9009\uFF0C\u56DE\u8F66\u5B8C\u6210",choices:f.files.map(e=>({title:e.replace(/\\/g,"/"),value:e}))}).then(e=>e.files?.length!=0?e:D("\u7ED3\u675F\uFF1A\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u914D\u7F6E\u6587\u4EF6"))).files),f.files?.length>0||D("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA")}async function yt(){if(p.rcDriven){f.param={url:p.rcUrl,output:p.rcOutput,name:p.rcName},p.docFile=S.resolve(`${p.rcOutput}/${p.rcName}-${new Date().getTime()}.json`);return}try{f.param={},f.param=JSON.parse(O.readFileSync(f.file,"utf-8"))}catch{}(!p.param.quick||[f.param.url,f.param.output,f.param.name].includes(void 0))&&(f.param=await Se([{name:"url",type:"text",message:"Swagger docs \u5730\u5740:",initial:f.param.url??"https://example.com/v3/api-docs"},{name:"output",type:"text",message:"\u8F93\u51FA\u5730\u5740:",initial:f.param.output??"./src/api"},{name:"name",type:"text",message:"\u6587\u4EF6\u540D:",initial:f.param.name??"index"}])),[f.param.url,f.param.output,f.param.name].includes(void 0)&&D("\u7ED3\u675F\uFF1A\u624B\u52A8\u9000\u51FA"),p.docFile=S.resolve(`${f.param.output}/${f.param.name}-${new Date().getTime()}.json`)}async function Ne(e=0){if(f.file=f.files[e],await yt(),q(f.param.url))await it.get(f.param.url).then(t=>we(t.data)).catch(t=>console.log("\u5931\u8D25\uFF1A",t));else try{await we(JSON.parse(O.readFileSync(S.resolve(f.param.url),"utf8")))}catch(t){console.log("\u5931\u8D25\uFF1A",t)}f.files[e+1]?await Ne(e+1):C>0&&D(`\u7ED3\u675F\uFF1A${C} \u4E2A\u6587\u6863\u672A\u751F\u6210\uFF0C\u5931\u8D25\u539F\u56E0\u89C1\u4E0A\u65B9\u8F93\u51FA`,1)}function ht(e){let t=p.param.replaceTags;t?.length&&Object.values(e.paths??{}).forEach(r=>{Object.values(r).forEach(n=>{Array.isArray(n?.tags)&&(n.tags=n.tags.map(s=>s.replace(new RegExp(`^${t[0]}$`,"g"),t[1]??"")))})})}function xt(e,t){let r=p.config.toJS?".js":".ts",n=S.resolve(f.param.output??"./src/api"),s=O.existsSync(n)?O.readdirSync(n):[],o=e.map(i=>`${i.fileName}${r}`).filter(i=>!s.includes(i)),a=U(s,e,r);if(ft()){console.log(JSON.stringify({groups:e.map(({raw:i,fileName:u,className:c,property:m,reason:l,source:g})=>({raw:i,fileName:u,className:c,property:m,reason:l,source:g})),unmatchedRules:t,add:o,orphans:a},null,2));return}e.forEach(i=>console.log(`\u547D\u540D\uFF1A${i.raw} \u2192 ${i.fileName}\uFF08\u7C7B ${i.className}${i.reason?`\uFF0C${i.reason}`:""}\uFF09`)),t.length&&console.error(`\u26A0\uFE0F \u672A\u547D\u4E2D\u89C4\u5219\uFF1A${t.map(i=>i+1).join("\u3001")}`),o.length&&console.log(`\u9884\u8BA1\u65B0\u589E\uFF1A${o.join("\u3001")}`),a.length&&console.error(`\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A${a.join("\u3001")}`)}async function we(e){if(typeof e?.paths!="object")return console.log("\u5931\u8D25\uFF1A\u7F3A\u5C11paths\u5B57\u6BB5");let t=await pe(e,{baseUrl:q(f.param.url)?f.param.url:void 0});if(t.errors.length>0){t.errors.forEach(n=>console.error("\u5931\u8D25\uFF1A",n)),C+=1;return}j=[],p.param.moduleClassNames=void 0,ht(e);let r=p.config.grouping;if(p.config.modular&&r&&(r.strategy?.length||r.rules?.length)){let n=Re(e,r);if(n.warnings.forEach(s=>console.error("\u26A0\uFE0F",s)),n.errors.length>0){n.errors.forEach(s=>console.error("\u5931\u8D25\uFF1A",s)),C+=1;return}if(j=n.entries,p.config.moduleNameFirstTag=!0,p.param.moduleClassNames=xe(n.entries),r.preserveTags!==!1&&(p.param.groupOriginalTags=n.originalTags),console.log("\u5206\u7EC4\uFF1A",...Object.entries(n.counts).map(([s,o])=>`${s}-${o}`)),lt()){xt(n.entries,n.unmatchedRules);return}}if(Object.entries(e.paths).forEach(n=>{Object.keys(n[1]).forEach(s=>{let o=`${n[0]}/${s}`;if(p.param.convertGet&&(o=o.replace(/([^\}]\/)get$/g,"$1query")),p.param.removeParam&&(o=o.replace(/\/\{.+?\}/g,"")),p.param.removePrefixIndex){let i=o.split("/");i=i.slice(0,1).concat(i.slice(Number(p.param.removePrefixIndex)+2)),o=i.join("/")}o=o.replace(/["\\`\r\n]/g,"_").replace(/\$\{/g,"_"),e.paths[n[0]][s].operationId=o;let a=o.split("/").slice(-1)[0];typeof p.enum[a]=="number"?p.enum[a]++:p.enum[a]=1})}),Object.entries(e.components).forEach(n=>{Object.keys(n[1]).forEach(s=>{p.param.removeEmptyComponents&&!Object.keys(e.components[n[0]][s]).length&&delete e.components[n[0]][s]})}),console.log("\u5C31\u7EEA\uFF1A",...Object.entries(p.enum).map(n=>n.join("-"))),H(p.docFile,JSON.stringify(e)),console.log("\u6267\u884C\uFF1A",f.file),await ut({fileName:`${f.param.name}.ts`,output:S.resolve(f.param.output),input:p.docFile,...p.config,param:p.param}),console.log("\u5B8C\u6210\uFF1A",S.resolve(f.param.output,`${f.param.name}${p.config.toJS?".js":".ts"}`)),p.config.modular){let n=S.resolve(f.param.output),s=String(p.config.apiClassName??"Api"),o=!!p.config.toJS;if(j.length){let a=Y(n,j,o,{aggregate:!1});if(a.errors.length>0){a.errors.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),C+=1;return}Q(n,s,o,$e(j));let{errors:i,orphans:u}=Y(n,j,o);if(i.length>0){i.forEach(c=>console.error("\u5931\u8D25\uFF1A",c)),C+=1;return}u.forEach(c=>console.error("\u26A0\uFE0F \u8868\u5916\u4EA7\u7269\uFF08\u5EFA\u8BAE\u5F00\u542F output.clean\uFF09\uFF1A",c))}else Q(n,s,o)}p.config.toJS&&console.log("\u5B8C\u6210\uFF1A",S.resolve(f.param.output,`${f.param.name}.d.ts`)),O.unlinkSync(p.docFile),p.param.removeDts&&(console.log("\u6E05\u7406\uFF1A",S.resolve(f.param.output,`${f.param.name}.d.ts`)),ct(`npx rimraf ${S.resolve(f.param.output,`${f.param.name}.d.ts`)}`,{cwd:p.home}).toString()),p.rcDriven||H(f.file,JSON.stringify(f.param,null,2))}async function cr(){await gt(),await dt(),Ne()}export{cr as generateApi};
|
package/dist/templates/api.ejs
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
<%
|
|
2
|
-
const { apiConfig, routes, utils, config } = it;
|
|
2
|
+
const { apiConfig, routes, utils, config, route } = it;
|
|
3
3
|
const { info, servers, externalDocs } = apiConfig;
|
|
4
|
-
const { _, require, formatDescription } = utils;
|
|
4
|
+
const { _, require, formatDescription, pascalCase } = utils;
|
|
5
5
|
|
|
6
6
|
const server = (servers && servers[0]) || { url: "" };
|
|
7
|
+
const isModular = Boolean(config.modular && route);
|
|
8
|
+
const moduleName = isModular ? route.moduleName : "";
|
|
9
|
+
// 分组模式由命名表提供类名,与聚合入口同源;未分组时沿用依赖的 pascalCase
|
|
10
|
+
const moduleClassName = isModular ? (config.param?.moduleClassNames?.[moduleName] ?? pascalCase(moduleName)) : "";
|
|
11
|
+
const moduleRoutes = isModular ? (route.routes || []) : [];
|
|
12
|
+
const dataContractsFile = config.fileNames?.dataContracts ?? "data-contracts";
|
|
13
|
+
const httpClientFile = config.fileNames?.httpClient ?? "http-client";
|
|
14
|
+
const dataContracts = isModular ? _.map(it.modelTypes, "name") : [];
|
|
7
15
|
|
|
8
16
|
const descriptionLines = _.compact([
|
|
9
17
|
`@title ${info.title || "No title"}`,
|
|
@@ -26,6 +34,25 @@ const descriptionLines = _.compact([
|
|
|
26
34
|
|
|
27
35
|
%>
|
|
28
36
|
|
|
37
|
+
<% if (isModular) { %>
|
|
38
|
+
|
|
39
|
+
<% if (config.httpClientType === config.constants.HTTP_CLIENT.AXIOS && !config.param?.extractResponseRaw) { %> import type { AxiosRequestConfig, AxiosResponse } from "axios"; <% } %>
|
|
40
|
+
|
|
41
|
+
import { HttpClient, RequestParams, ContentType } from "./<%~ httpClientFile %>";
|
|
42
|
+
<% if (dataContracts.length) { %>
|
|
43
|
+
import { <%~ dataContracts.join(", ") %> } from "./<%~ dataContractsFile %>"
|
|
44
|
+
<% } %>
|
|
45
|
+
|
|
46
|
+
/** <%~ moduleName %> 模块 */
|
|
47
|
+
export class <%~ moduleClassName %><SecurityDataType = unknown> extends HttpClient<SecurityDataType> {
|
|
48
|
+
<% for (const item of moduleRoutes) { %>
|
|
49
|
+
|
|
50
|
+
<%~ includeFile('./procedure-call.ejs', { ...it, route: { ...item, namespace: undefined } }) %>
|
|
51
|
+
<% } %>
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
<% } else { %>
|
|
55
|
+
|
|
29
56
|
<% if (config.httpClientType === config.constants.HTTP_CLIENT.AXIOS && !config.param?.extractResponseRaw) { %> import type { AxiosRequestConfig, AxiosResponse } from "axios"; <% } %>
|
|
30
57
|
|
|
31
58
|
<% if (descriptionLines.length) { %>
|
|
@@ -67,3 +94,4 @@ export class <%~ config.apiClassName %><SecurityDataType extends unknown><% if (
|
|
|
67
94
|
<% } %>
|
|
68
95
|
<% } %>
|
|
69
96
|
}
|
|
97
|
+
<% } %>
|
|
@@ -6,8 +6,11 @@ const { raw, request, routeName } = route;
|
|
|
6
6
|
const jsDocDescription = raw.description ?
|
|
7
7
|
` * @description ${formatDescription(raw.description, true)}` :
|
|
8
8
|
fmtToJSDocLine('No description', { eol: false });
|
|
9
|
+
// 分组改写 tags 后,JSDoc 仍展示原始标签(由 config.param.groupOriginalTags 提供)
|
|
10
|
+
const originalTags = config.param?.groupOriginalTags?.[`${_.upperCase(request.method)}:${raw.route}`];
|
|
11
|
+
const displayTags = originalTags ? _.split(originalTags, ", ") : raw.tags;
|
|
9
12
|
const jsDocLines = _.compact([
|
|
10
|
-
_.size(
|
|
13
|
+
_.size(displayTags) && ` * @tags ${displayTags.join(", ")}`,
|
|
11
14
|
` * @name ${pascalCase(routeName.usage)}`,
|
|
12
15
|
raw.summary && ` * @summary ${raw.summary}`,
|
|
13
16
|
` * @request ${_.upperCase(request.method)}:${raw.route}`,
|
|
@@ -1,13 +1,27 @@
|
|
|
1
1
|
<%
|
|
2
|
-
const { utils, config, routes, modelTypes } = it;
|
|
2
|
+
const { utils, config, routes, modelTypes, route } = it;
|
|
3
3
|
const { _, pascalCase } = utils;
|
|
4
4
|
const dataContracts = config.modular ? _.map(modelTypes, "name") : [];
|
|
5
|
+
const dataContractsFile = config.fileNames?.dataContracts ?? "data-contracts";
|
|
6
|
+
const isModular = Boolean(config.modular && route);
|
|
7
|
+
// 分组模式由命名表提供名称空间,与模块类名同源
|
|
8
|
+
const moduleName = isModular ? (config.param?.moduleClassNames?.[route.moduleName] ?? pascalCase(route.moduleName)) : "";
|
|
5
9
|
%>
|
|
6
|
-
|
|
7
10
|
<% if (dataContracts.length) { %>
|
|
8
|
-
import { <%~ dataContracts.join(", ") %> } from "./<%~
|
|
11
|
+
import { <%~ dataContracts.join(", ") %> } from "./<%~ dataContractsFile %>"
|
|
9
12
|
<% } %>
|
|
10
13
|
|
|
14
|
+
<% if (isModular) { %>
|
|
15
|
+
|
|
16
|
+
export namespace <%~ moduleName %> {
|
|
17
|
+
<% for (const item of route.routes || []) { %>
|
|
18
|
+
|
|
19
|
+
<%~ includeFile('./route-type.ejs', { ...it, route: item }) %>
|
|
20
|
+
<% } %>
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
<% } else { %>
|
|
24
|
+
|
|
11
25
|
<%
|
|
12
26
|
/* TODO: outOfModule, combined should be attributes of route, which will allow to avoid duplication of code */
|
|
13
27
|
%>
|
|
@@ -30,3 +44,4 @@ import { <%~ dataContracts.join(", ") %> } from "./<%~ config.fileNames.dataCont
|
|
|
30
44
|
|
|
31
45
|
<% } %>
|
|
32
46
|
<% } %>
|
|
47
|
+
<% } %>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fxri/swagger2api",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"description": "基于 swagger-typescript-api,将 Swagger 文档自动转为 TypeScript 格式的 API 文件。",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": {
|
|
@@ -18,6 +18,7 @@
|
|
|
18
18
|
"homepage": "https://fxri-net.github.io/swagger2api/",
|
|
19
19
|
"type": "module",
|
|
20
20
|
"main": "./dist/index.js",
|
|
21
|
+
"types": "./dist/index.d.ts",
|
|
21
22
|
"bin": {
|
|
22
23
|
"swagger2api": "dist/cli.js"
|
|
23
24
|
},
|
|
@@ -38,27 +39,26 @@
|
|
|
38
39
|
"fxri"
|
|
39
40
|
],
|
|
40
41
|
"engines": {
|
|
41
|
-
"node": ">=
|
|
42
|
+
"node": ">=18.12.0"
|
|
42
43
|
},
|
|
43
44
|
"dependencies": {
|
|
44
45
|
"axios": "^1.21.0",
|
|
45
|
-
"glob": "^14.0.3",
|
|
46
46
|
"prompts": "^2.4.2",
|
|
47
|
-
"swagger-typescript-api": "
|
|
47
|
+
"swagger-typescript-api": "13.0.28"
|
|
48
48
|
},
|
|
49
49
|
"devDependencies": {
|
|
50
|
-
"@types/node": "^
|
|
50
|
+
"@types/node": "^18.19.0",
|
|
51
51
|
"@types/prompts": "^2.4.9",
|
|
52
52
|
"@typescript-eslint/eslint-plugin": "^8.69.0",
|
|
53
53
|
"@typescript-eslint/parser": "^8.69.0",
|
|
54
54
|
"cross-env": "^10.1.0",
|
|
55
55
|
"esbuild-plugin-copy": "^2.1.1",
|
|
56
|
-
"eslint": "^
|
|
57
|
-
"eslint-config-prettier": "^
|
|
58
|
-
"tsup": "^
|
|
56
|
+
"eslint": "^10.15.0",
|
|
57
|
+
"eslint-config-prettier": "^10.1.8",
|
|
58
|
+
"tsup": "^8.5.1",
|
|
59
59
|
"typescript": "^5.9.3",
|
|
60
60
|
"vitepress": "^1.6.4",
|
|
61
|
-
"vitest": "^
|
|
61
|
+
"vitest": "^4.1.12"
|
|
62
62
|
},
|
|
63
63
|
"publishConfig": {
|
|
64
64
|
"registry": "https://registry.npmjs.org/",
|