@wkgeo/cli 2.0.3 → 2.2.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 +19 -2
- package/README.md +7 -7
- package/SKILL.md +1038 -1038
- package/lib/api.mjs +351 -351
- package/lib/args.mjs +235 -235
- package/lib/build.mjs +1047 -0
- package/lib/cms.mjs +328 -328
- package/lib/commands/auth.mjs +1280 -1280
- package/lib/commands/data.mjs +694 -694
- package/lib/commands/index.mjs +17 -1
- package/lib/commands/init.mjs +111 -111
- package/lib/commands/orders.mjs +691 -691
- package/lib/commands/site.mjs +82 -0
- package/lib/commands/siteops.mjs +382 -0
- package/lib/commands/sites.mjs +968 -801
- package/lib/commands/spec.mjs +72 -72
- package/lib/commands/template.mjs +1484 -1484
- package/lib/config.mjs +57 -4
- package/lib/errors.mjs +446 -336
- package/lib/manifest-apply.mjs +1650 -1650
- package/lib/manifest-schema.json +480 -480
- package/lib/manifest.mjs +1106 -1106
- package/lib/runtime.mjs +798 -654
- package/lib/site-create.mjs +537 -537
- package/lib/site-credentials.mjs +157 -0
- package/lib/site-meta.mjs +474 -0
- package/lib/site-publish.mjs +410 -0
- package/lib/site-spec.mjs +302 -302
- package/lib/site-template.mjs +405 -0
- package/lib/template-gen.mjs +1354 -1354
- package/lib/template-publish.mjs +696 -696
- package/lib/templates-sync.mjs +676 -644
- package/lib/workspace-sync.mjs +386 -0
- package/package.json +56 -56
- package/spec/SITE-SPEC.md +198 -198
package/lib/api.mjs
CHANGED
|
@@ -1,351 +1,351 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 业务 API 封装:`/cli`(业务面,**全部动作走 CLI 自持云函数**)+ 插件面 `/<plug>` + `/api/oauth/*`(授权面)。
|
|
3
|
-
*
|
|
4
|
-
* ⚠️ 2026-10-22:`/api/data` 已下线。`wkgeo-data` 原本是"47 条动作全转发"的空壳,
|
|
5
|
-
* 现在 CLI 直连真实函数,不再经过它。
|
|
6
|
-
*
|
|
7
|
-
* ⚠️ 2026-10-28(老板拍板「所有 cli 的操作都通过自己的云函数来实现」):业务面**收敛到 `/cli`**
|
|
8
|
-
* (云函数 `wkgeo-cli-fc`)—— 站点 / 域名 / 模板 / 发布 / 资产 / 钱包 / 套餐 / 应用授权
|
|
9
|
-
* 这些动作在 `wkgeo-cli-fc` 里**自持重建**(进程内副本),金融面 13 条由它**白名单转发**给
|
|
10
|
-
* `wkgeo-order`。CLI 侧不再需要「action → 哪个函数」那套路由表猜谜。
|
|
11
|
-
* · 默认:`data()` 一律打 `/cli`;只有**插件面**动作按 `GATEWAY_PREFIXES` 打各自前缀
|
|
12
|
-
* (`/form` `/member` `/channel`;`/ai` `/ai-tools` 仅显式 `prefix:` 时用)。
|
|
13
|
-
* · 逃生阀:`WKONGAI_LEGACY_ENDPOINTS=1` 恢复 2026-10-28 之前的直连
|
|
14
|
-
* (order / domain / user 三个前缀各打各的),**默认关**;只为线上回滚留一条路。
|
|
15
|
-
*
|
|
16
|
-
* 设计约定:
|
|
17
|
-
* 1. **只在这里碰 HTTP**。命令层拿到的要么是 `data`,要么是抛出的 CliError。
|
|
18
|
-
* 2. `data()` 返回的是信封里的 `data` 字段(服务端 `ok(x)` → `{code:0,data:x}`)。
|
|
19
|
-
* 如果某个 action 的 data 是标量(字符串/数组),也原样返回。
|
|
20
|
-
* 3. **不做自动重试**。限流(429)自动重试会掩盖问题,也让"写操作"变得不可预测(重试下单=重复下单!)。
|
|
21
|
-
* 只在错误里给出 retry_after,让人/脚本决定。
|
|
22
|
-
* 4. token 只在 Authorization 头里出现;**任何日志/错误里都不带 token**。
|
|
23
|
-
*/
|
|
24
|
-
|
|
25
|
-
import { request, encodeForm } from './http.mjs';
|
|
26
|
-
import { classifyResponse, toCliError, networkError, CliError } from './errors.mjs';
|
|
27
|
-
|
|
28
|
-
/**
|
|
29
|
-
* 金融面动作(`FN_ORDER` 13 条;`wkgeo-order` 现 dispatch 20 个动作)—— 2026-10-28 起**不再由 CLI 直接寻址**,
|
|
30
|
-
* 而是 `wkgeo-cli-fc` 用白名单转发(`ORDER_FORWARD_ACTIONS`)。
|
|
31
|
-
*
|
|
32
|
-
* 这张表留在 CLI 侧只做两件事:
|
|
33
|
-
* ① 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 时恢复老直连(打 `/order`);
|
|
34
|
-
* ② 肉眼核对「哪些动作算钱」——转发白名单必须与它逐条一致。
|
|
35
|
-
*
|
|
36
|
-
* 为什么当初要把这份表搬到 CLI:CLI 以前统一打 `/api/data`,靠 data 内部转发;
|
|
37
|
-
* data 下线后必须自己决定打哪个函数。**只列 order / domain 的例外,其余一律 user**
|
|
38
|
-
* —— 逃生阀口径:`FN_ORDER` 13 条打 `/order`、`FN_DOMAIN` 9 条打 `/domain`、其余打 `/user`
|
|
39
|
-
* (data 当年那份 47 条映射已随 data 下线,不再是真源)。
|
|
40
|
-
*
|
|
41
|
-
* ⚠️ 加新 action 时:先确认它属于哪个函数,不在这两个集合里就当 user(user 会回"未知操作",与以前 data 的行为一致)。
|
|
42
|
-
*
|
|
43
|
-
* ★ 2026-11-17(task-627):**下单已改调账务域** `billing.orderCreate`(网关 `/billing-core`),
|
|
44
|
-
* 由 `wkgeo-cli-fc` 白名单转发。所以 `orderCreate` **故意不在这张表里**:
|
|
45
|
-
* 老 `/order` 从来没有这个动作,逃生阀也回不到它 —— `fnOf()` 里单独把它钉在 `cli`。
|
|
46
|
-
*/
|
|
47
|
-
const FN_ORDER = new Set([
|
|
48
|
-
'createRechargeOrder',
|
|
49
|
-
'createRechargeTicket',
|
|
50
|
-
'createRechargeOrderByTicket',
|
|
51
|
-
'getRechargeTicketInfo',
|
|
52
|
-
'createQuotaOrder',
|
|
53
|
-
'createSiteRenewOrder',
|
|
54
|
-
'userQuoteBundle',
|
|
55
|
-
'userCreateBundleOrder',
|
|
56
|
-
'getOrderPayParams',
|
|
57
|
-
'cancelOrder',
|
|
58
|
-
'checkOrder',
|
|
59
|
-
'sweepOrders',
|
|
60
|
-
'paymentNotify',
|
|
61
|
-
]);
|
|
62
|
-
|
|
63
|
-
/* ★ 2026-11-19 task-1250(老板:CLI 只做 CMS 内容管理,跟域名没有关系):
|
|
64
|
-
原 `FN_DOMAIN`(`wkgeo-domain` 的 9 条动作 → 前缀 `/domain`)已整张删除 ——
|
|
65
|
-
CLI 不再有任何域名动作,逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 也回不到 `/domain`。 */
|
|
66
|
-
|
|
67
|
-
/**
|
|
68
|
-
* 表单插件(`plug/contact-form/fn/src/index.js`)的后台动作 —— 前缀 `/form`。
|
|
69
|
-
*
|
|
70
|
-
* ⚠️ 这些动作**目前只有 CMS 会话 Cookie 能调**(`loadSession` 只认 `cms_session`,
|
|
71
|
-
* 不认 `Authorization: Bearer`),所以 CLI 真调会拿到 401/403。命令照发、错误照译,
|
|
72
|
-
* 后端补 Bearer 桥以后**不用改 CLI** —— 这就是这里保留映射的原因。
|
|
73
|
-
*/
|
|
74
|
-
const FN_FORM = new Set([
|
|
75
|
-
'formList',
|
|
76
|
-
'formGet',
|
|
77
|
-
'formEntryList',
|
|
78
|
-
'formEntryDetail',
|
|
79
|
-
'formEntryCounts',
|
|
80
|
-
]);
|
|
81
|
-
|
|
82
|
-
/** 会员插件(`plug/member/fn/src/index.js`)→ 前缀 `/member` */
|
|
83
|
-
const FN_MEMBER = new Set(['memberRegister', 'memberLogin', 'memberMe', 'memberProfileSave']);
|
|
84
|
-
|
|
85
|
-
/** 渠道码插件(`plug/channel-code/fn/src/index.js`)→ 前缀 `/channel` */
|
|
86
|
-
const FN_CHANNEL = new Set(['channelVisit', 'channelRenderVisit']);
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* 网关前缀 → 目标云函数(来源:`aliyun/fc/wkgeo-gw/src/index.js` 的 `defaultRoutes`,**别猜**)。
|
|
90
|
-
*
|
|
91
|
-
* 前缀就是 URL 的第一段:`POST {base}/form` = 打到 contact-form 那个函数。
|
|
92
|
-
*
|
|
93
|
-
* **2026-10-28 收敛**:业务面只剩 `cli` 一个(`wkgeo-cli-fc`,自持 + 白名单转发),
|
|
94
|
-
* 其余都是**插件面**(动作在 body 里,函数自己的鉴权口径,CLI 只是把动作转发过去)。
|
|
95
|
-
* `order` / `domain` / `user` 三个前缀**已从这张表移除** —— 它们只在逃生阀
|
|
96
|
-
* `WKONGAI_LEGACY_ENDPOINTS=1` 时由 `fnOf()` 直接返回名字(不走这张表的合法性闸门)。
|
|
97
|
-
* `ai` / `ai-tools` 目前 CLI 不直调(`wkgeo ai` 连的是**本机**模型),但前缀先登记好,
|
|
98
|
-
* 将来加动作时直接可以 `data(action, payload, { prefix: 'ai' })`。
|
|
99
|
-
*/
|
|
100
|
-
export const GATEWAY_PREFIXES = Object.freeze({
|
|
101
|
-
cli: 'wkgeo-cli-fc',
|
|
102
|
-
form: 'wkgeo-plugin-contact-form',
|
|
103
|
-
ai: 'wkgeo-ai',
|
|
104
|
-
member: 'wkgeo-plugin-member',
|
|
105
|
-
channel: 'wkgeo-plugin-channel-code',
|
|
106
|
-
'ai-tools': 'wkgeo-plugin-ai-tools',
|
|
107
|
-
/**
|
|
108
|
-
* ★ 2026-11-10(数据交换单):三个**只读**数据面,供 `wkgeo data chat|stats|usage` 用。
|
|
109
|
-
*
|
|
110
|
-
* · `aikefu` → `wkgeo-plugin-aikefu`(MaxKB 会话/消息,只读库)
|
|
111
|
-
* · `analytics` → `wkgeo-plugin-analytics`(PV / UV / IP 唯一数、Top 页面/来源)
|
|
112
|
-
* · `admin` → `wkgeo-admin`(大模型费用账单 `llmCostSummary`,只读位 `llm:cost_read`)
|
|
113
|
-
*
|
|
114
|
-
* 为什么现在才登记:这三个前缀网关早就有了(`wkgeo-gw` 的 `defaultRoutes`),
|
|
115
|
-
* 但 CLI 以前没有命令要打它们。**只登记前缀,不改任何现有动作的路由**:
|
|
116
|
-
* `fnOf()` 的默认仍是 `cli`,只有显式 `prefix:` 才会走这三条。
|
|
117
|
-
*/
|
|
118
|
-
aikefu: 'wkgeo-plugin-aikefu',
|
|
119
|
-
analytics: 'wkgeo-plugin-analytics',
|
|
120
|
-
admin: 'wkgeo-admin',
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
/** 前缀是否合法(HTTP 层的唯一闸门:不认的前缀直接报用法错误,绝不瞎打) */
|
|
124
|
-
export function isGatewayPrefix(prefix) {
|
|
125
|
-
return typeof prefix === 'string' && Object.prototype.hasOwnProperty.call(GATEWAY_PREFIXES, prefix);
|
|
126
|
-
}
|
|
127
|
-
|
|
128
|
-
/** 逃生阀:`WKONGAI_LEGACY_ENDPOINTS=1` ⇒ 回到 2026-10-28 之前的直连(默认关) */
|
|
129
|
-
const LEGACY_ENV = 'WKONGAI_LEGACY_ENDPOINTS';
|
|
130
|
-
|
|
131
|
-
export function legacyEndpointsEnabled(env = process.env) {
|
|
132
|
-
const v = String((env && env[LEGACY_ENV]) || '').trim().toLowerCase();
|
|
133
|
-
return v === '1' || v === 'true' || v === 'yes' || v === 'on';
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
/**
|
|
137
|
-
* 动作 → 网关前缀。
|
|
138
|
-
*
|
|
139
|
-
* 规则(默认,2026-10-28 起):
|
|
140
|
-
* 1. **插件面**(form / member / channel)照旧打各自前缀 —— 那是别人函数的面,CLI 只做信使;
|
|
141
|
-
* 2. **其余一切**(站点 / 域名 / 模板 / 发布 / 资产 / 钱包 / 套餐 / 应用授权 / 金融面 / 不认识的)
|
|
142
|
-
* 一律 `cli` —— `wkgeo-cli-fc` 自己分发;不认识的动作由它回 `400 未知动作`。
|
|
143
|
-
*
|
|
144
|
-
* 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 时退回老口径:
|
|
145
|
-
* order / form / member / channel 按显式表,其余 `user`(`/domain` 已随 task-1250 删除)。
|
|
146
|
-
*/
|
|
147
|
-
export function fnOf(action, { legacy = legacyEndpointsEnabled() } = {}) {
|
|
148
|
-
if (FN_FORM.has(action)) return 'form';
|
|
149
|
-
if (FN_MEMBER.has(action)) return 'member';
|
|
150
|
-
if (FN_CHANNEL.has(action)) return 'channel';
|
|
151
|
-
/**
|
|
152
|
-
* ★ 2026-11-17(task-627):账务域下单**只在 `/cli` 后面**(cli-fc 再转发到 `/billing-core`)。
|
|
153
|
-
* 逃生阀也回不去:`/order` 没有 `orderCreate` 这个动作,`/user` 更没有。
|
|
154
|
-
*
|
|
155
|
-
* ★ 2026-11-20(cli-price-quote):账务域**只读报价** `orderQuote` 同理(cli-fc 白名单转发)——
|
|
156
|
-
* 加购价的唯一来源是它(与 `orderCreate` 实收同源),逃生阀也不许绕到别的函数。
|
|
157
|
-
*/
|
|
158
|
-
if (action === 'orderCreate' || action === 'orderQuote') return 'cli';
|
|
159
|
-
if (legacy) {
|
|
160
|
-
if (FN_ORDER.has(action)) return 'order';
|
|
161
|
-
return 'user';
|
|
162
|
-
}
|
|
163
|
-
return 'cli';
|
|
164
|
-
}
|
|
165
|
-
|
|
166
|
-
export function createApi({ config, fetchImpl = globalThis.fetch } = {}) {
|
|
167
|
-
const base = config.base;
|
|
168
|
-
const timeoutMs = config.httpTimeoutMs;
|
|
169
|
-
|
|
170
|
-
async function raw(url, options = {}) {
|
|
171
|
-
return request(url, { ...options, fetchImpl, timeoutMs: options.timeoutMs ?? timeoutMs });
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
/** 决定成败的唯一依据是 body.code(项目约定 HTTP 恒 200) */
|
|
175
|
-
function unwrap(res, action) {
|
|
176
|
-
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
177
|
-
const cls = classifyResponse({
|
|
178
|
-
httpStatus: res.status,
|
|
179
|
-
body: res.body,
|
|
180
|
-
action,
|
|
181
|
-
retryAfterHeader: res.headers && typeof res.headers.get === 'function' ? res.headers.get('retry-after') : null,
|
|
182
|
-
cmdName: config.cmdName || 'wkgeo',
|
|
183
|
-
});
|
|
184
|
-
if (!cls.ok) throw toCliError(cls, { action, raw: { status: res.status, body: res.body } });
|
|
185
|
-
return res.body ? res.body.data : null;
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
return {
|
|
189
|
-
config,
|
|
190
|
-
|
|
191
|
-
/**
|
|
192
|
-
* 业务面:POST /<fn> {action, ...payload} —— fn 由 `fnOf(action)` 决定。
|
|
193
|
-
*
|
|
194
|
-
* 默认 `/cli`(`wkgeo-cli-fc`);插件面按 `GATEWAY_PREFIXES` 打各自前缀。
|
|
195
|
-
* 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 让 `fnOf()` 退回老的 order/domain/user 直连。
|
|
196
|
-
*
|
|
197
|
-
* @param {string} action
|
|
198
|
-
* @param {object} [payload]
|
|
199
|
-
* @param {{token?:string, prefix?:string, headers?:object, timeoutMs?:number}} [opts]
|
|
200
|
-
* `prefix` 覆盖自动推断(打 `/form` `/ai` `/member` `/channel` `/ai-tools` 时用;
|
|
201
|
-
* 只接受 `GATEWAY_PREFIXES` 里的值);`headers` 是额外请求头(如 `x-cms-site`、`Origin`)。
|
|
202
|
-
*/
|
|
203
|
-
async data(action, payload = {}, { token, prefix, headers, timeoutMs } = {}) {
|
|
204
|
-
if (!action) throw new CliError('内部错误:缺少 action');
|
|
205
|
-
if (prefix !== undefined && !isGatewayPrefix(prefix)) {
|
|
206
|
-
throw new CliError(`内部错误:不支持的前缀「${prefix}」(可用:${Object.keys(GATEWAY_PREFIXES).join(' / ')})`, {
|
|
207
|
-
kind: 'internal',
|
|
208
|
-
});
|
|
209
|
-
}
|
|
210
|
-
const fn = prefix || fnOf(action);
|
|
211
|
-
const res = await raw(`${base}/${fn}`, {
|
|
212
|
-
method: 'POST',
|
|
213
|
-
timeoutMs,
|
|
214
|
-
headers: {
|
|
215
|
-
'Content-Type': 'application/json',
|
|
216
|
-
Accept: 'application/json',
|
|
217
|
-
...(token ? { Authorization: `Bearer ${token}` } : {}),
|
|
218
|
-
...(headers || {}),
|
|
219
|
-
},
|
|
220
|
-
body: JSON.stringify({ action, ...payload }),
|
|
221
|
-
});
|
|
222
|
-
return unwrap(res, action);
|
|
223
|
-
},
|
|
224
|
-
|
|
225
|
-
/** 授权服务器元数据(授权前用它发现 authorization_endpoint / token 有效期策略) */
|
|
226
|
-
async metadata() {
|
|
227
|
-
const res = await raw(`${base}/api/oauth/metadata`, { method: 'GET', headers: { Accept: 'application/json' } });
|
|
228
|
-
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
229
|
-
if (res.status !== 200 || !res.body) {
|
|
230
|
-
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'metadata', cmdName: config.cmdName || 'wkgeo' });
|
|
231
|
-
throw toCliError(cls, { action: 'metadata', raw: { status: res.status, body: res.body } });
|
|
232
|
-
}
|
|
233
|
-
return res.body;
|
|
234
|
-
},
|
|
235
|
-
|
|
236
|
-
/**
|
|
237
|
-
* 用户信息(身份的唯一权威来源)。
|
|
238
|
-
* ⚠️ 这个端点**不走统一信封**:HTTP 401 + `{error:'invalid_token'}`。
|
|
239
|
-
*/
|
|
240
|
-
async userinfo(token) {
|
|
241
|
-
const res = await raw(`${base}/api/oauth/userinfo`, {
|
|
242
|
-
method: 'GET',
|
|
243
|
-
headers: { Accept: 'application/json', Authorization: `Bearer ${token}` },
|
|
244
|
-
});
|
|
245
|
-
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
246
|
-
if (res.status === 200 && res.body && res.body.sub) return res.body;
|
|
247
|
-
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'userinfo', cmdName: config.cmdName || 'wkgeo' });
|
|
248
|
-
throw toCliError(cls, { action: 'userinfo', raw: { status: res.status, body: res.body } });
|
|
249
|
-
},
|
|
250
|
-
|
|
251
|
-
/**
|
|
252
|
-
* 换令牌 / 刷新令牌(OAuth 标准表单)。
|
|
253
|
-
* ⚠️ 成功响应里**有明文 access_token** —— 返回值只允许写进凭据文件,禁止打印。
|
|
254
|
-
*/
|
|
255
|
-
async token(form) {
|
|
256
|
-
const res = await raw(`${base}/api/oauth/token`, {
|
|
257
|
-
method: 'POST',
|
|
258
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
259
|
-
body: encodeForm(form),
|
|
260
|
-
});
|
|
261
|
-
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
262
|
-
if (res.status === 200 && res.body && res.body.access_token) return res.body;
|
|
263
|
-
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'token', cmdName: config.cmdName || 'wkgeo' });
|
|
264
|
-
throw toCliError(cls, { action: 'token', raw: { status: res.status, body: res.body } });
|
|
265
|
-
},
|
|
266
|
-
|
|
267
|
-
/**
|
|
268
|
-
* 原样发一个 OAuth 表单请求,**不抛异常**(返回 status/body/networkError)。
|
|
269
|
-
*
|
|
270
|
-
* 为什么需要它:设备码轮询里 `authorization_pending` / `slow_down` / `expired_token`
|
|
271
|
-
* 都是**正常预期**的中间态,不是错误 —— 用一个会抛的封装会让轮询逻辑写成一团 try/catch。
|
|
272
|
-
*/
|
|
273
|
-
async oauthForm(pathname, form) {
|
|
274
|
-
const res = await raw(`${base}${pathname}`, {
|
|
275
|
-
method: 'POST',
|
|
276
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
277
|
-
body: encodeForm(form),
|
|
278
|
-
});
|
|
279
|
-
return res;
|
|
280
|
-
},
|
|
281
|
-
|
|
282
|
-
/** 自省(RFC 7662):返回 {active,...},**不是错误**,调用方自己看 active */
|
|
283
|
-
async introspect(token) {
|
|
284
|
-
const res = await raw(`${base}/api/oauth/introspect`, {
|
|
285
|
-
method: 'POST',
|
|
286
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
287
|
-
body: encodeForm({ token }),
|
|
288
|
-
});
|
|
289
|
-
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
290
|
-
if (res.status === 200 && res.body) return res.body;
|
|
291
|
-
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'introspect', cmdName: config.cmdName || 'wkgeo' });
|
|
292
|
-
throw toCliError(cls, { action: 'introspect', raw: { status: res.status, body: res.body } });
|
|
293
|
-
},
|
|
294
|
-
|
|
295
|
-
/**
|
|
296
|
-
* 吊销(RFC 7009)。
|
|
297
|
-
* best-effort:未知 token 也回 200;网络失败**不阻塞 logout**(本地删掉才是关键),
|
|
298
|
-
* 但把失败原因返回给调用方,让 logout 能如实告诉用户"服务端没吊销成功"。
|
|
299
|
-
*/
|
|
300
|
-
async revoke(token) {
|
|
301
|
-
try {
|
|
302
|
-
const res = await raw(`${base}/api/oauth/revoke`, {
|
|
303
|
-
method: 'POST',
|
|
304
|
-
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
305
|
-
body: encodeForm({ token, client_id: config.clientId }),
|
|
306
|
-
});
|
|
307
|
-
if (res.networkError) return { ok: false, reason: res.networkError };
|
|
308
|
-
if (res.status >= 200 && res.status < 300) return { ok: true };
|
|
309
|
-
return { ok: false, reason: `HTTP ${res.status} ${res.text ? res.text.slice(0, 200) : ''}`.trim() };
|
|
310
|
-
} catch (e) {
|
|
311
|
-
return { ok: false, reason: (e && e.message) || String(e) };
|
|
312
|
-
}
|
|
313
|
-
},
|
|
314
|
-
};
|
|
315
|
-
}
|
|
316
|
-
|
|
317
|
-
/**
|
|
318
|
-
* 具名动作封装(不用 this,避免解构后 this 丢失 —— 踩过)。
|
|
319
|
-
* 用法:`const api = createApi({config}); await api.data('listSites', {...}, {token})`
|
|
320
|
-
*/
|
|
321
|
-
export const ACTIONS = {
|
|
322
|
-
sites: {
|
|
323
|
-
list: 'listSites',
|
|
324
|
-
get: 'getSite',
|
|
325
|
-
create: 'createSite',
|
|
326
|
-
remove: 'deleteSite',
|
|
327
|
-
purge: 'purgeSite',
|
|
328
|
-
},
|
|
329
|
-
wallet: {
|
|
330
|
-
get: 'getMyWallet',
|
|
331
|
-
billing: 'getMyBilling',
|
|
332
|
-
},
|
|
333
|
-
orders: {
|
|
334
|
-
/**
|
|
335
|
-
* ★ 2026-11-17(task-627):下单 = `billing.orderCreate`(账务域),
|
|
336
|
-
* payload 必须带 `kind`(CLI 只用 `'quota'`)。旧的 `createQuotaOrder` 不再调用。
|
|
337
|
-
*/
|
|
338
|
-
createQuota: 'orderCreate',
|
|
339
|
-
check: 'checkOrder',
|
|
340
|
-
list: 'listMyOrders',
|
|
341
|
-
cancel: 'cancelOrder',
|
|
342
|
-
},
|
|
343
|
-
catalog: {
|
|
344
|
-
products: 'listProducts',
|
|
345
|
-
entitlements: 'listMyEntitlements',
|
|
346
|
-
},
|
|
347
|
-
apps: {
|
|
348
|
-
list: 'listMyOAuthAuthorizations',
|
|
349
|
-
revoke: 'revokeMyOAuthAuthorization',
|
|
350
|
-
},
|
|
351
|
-
};
|
|
1
|
+
/**
|
|
2
|
+
* 业务 API 封装:`/cli`(业务面,**全部动作走 CLI 自持云函数**)+ 插件面 `/<plug>` + `/api/oauth/*`(授权面)。
|
|
3
|
+
*
|
|
4
|
+
* ⚠️ 2026-10-22:`/api/data` 已下线。`wkgeo-data` 原本是"47 条动作全转发"的空壳,
|
|
5
|
+
* 现在 CLI 直连真实函数,不再经过它。
|
|
6
|
+
*
|
|
7
|
+
* ⚠️ 2026-10-28(老板拍板「所有 cli 的操作都通过自己的云函数来实现」):业务面**收敛到 `/cli`**
|
|
8
|
+
* (云函数 `wkgeo-cli-fc`)—— 站点 / 域名 / 模板 / 发布 / 资产 / 钱包 / 套餐 / 应用授权
|
|
9
|
+
* 这些动作在 `wkgeo-cli-fc` 里**自持重建**(进程内副本),金融面 13 条由它**白名单转发**给
|
|
10
|
+
* `wkgeo-order`。CLI 侧不再需要「action → 哪个函数」那套路由表猜谜。
|
|
11
|
+
* · 默认:`data()` 一律打 `/cli`;只有**插件面**动作按 `GATEWAY_PREFIXES` 打各自前缀
|
|
12
|
+
* (`/form` `/member` `/channel`;`/ai` `/ai-tools` 仅显式 `prefix:` 时用)。
|
|
13
|
+
* · 逃生阀:`WKONGAI_LEGACY_ENDPOINTS=1` 恢复 2026-10-28 之前的直连
|
|
14
|
+
* (order / domain / user 三个前缀各打各的),**默认关**;只为线上回滚留一条路。
|
|
15
|
+
*
|
|
16
|
+
* 设计约定:
|
|
17
|
+
* 1. **只在这里碰 HTTP**。命令层拿到的要么是 `data`,要么是抛出的 CliError。
|
|
18
|
+
* 2. `data()` 返回的是信封里的 `data` 字段(服务端 `ok(x)` → `{code:0,data:x}`)。
|
|
19
|
+
* 如果某个 action 的 data 是标量(字符串/数组),也原样返回。
|
|
20
|
+
* 3. **不做自动重试**。限流(429)自动重试会掩盖问题,也让"写操作"变得不可预测(重试下单=重复下单!)。
|
|
21
|
+
* 只在错误里给出 retry_after,让人/脚本决定。
|
|
22
|
+
* 4. token 只在 Authorization 头里出现;**任何日志/错误里都不带 token**。
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import { request, encodeForm } from './http.mjs';
|
|
26
|
+
import { classifyResponse, toCliError, networkError, CliError } from './errors.mjs';
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* 金融面动作(`FN_ORDER` 13 条;`wkgeo-order` 现 dispatch 20 个动作)—— 2026-10-28 起**不再由 CLI 直接寻址**,
|
|
30
|
+
* 而是 `wkgeo-cli-fc` 用白名单转发(`ORDER_FORWARD_ACTIONS`)。
|
|
31
|
+
*
|
|
32
|
+
* 这张表留在 CLI 侧只做两件事:
|
|
33
|
+
* ① 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 时恢复老直连(打 `/order`);
|
|
34
|
+
* ② 肉眼核对「哪些动作算钱」——转发白名单必须与它逐条一致。
|
|
35
|
+
*
|
|
36
|
+
* 为什么当初要把这份表搬到 CLI:CLI 以前统一打 `/api/data`,靠 data 内部转发;
|
|
37
|
+
* data 下线后必须自己决定打哪个函数。**只列 order / domain 的例外,其余一律 user**
|
|
38
|
+
* —— 逃生阀口径:`FN_ORDER` 13 条打 `/order`、`FN_DOMAIN` 9 条打 `/domain`、其余打 `/user`
|
|
39
|
+
* (data 当年那份 47 条映射已随 data 下线,不再是真源)。
|
|
40
|
+
*
|
|
41
|
+
* ⚠️ 加新 action 时:先确认它属于哪个函数,不在这两个集合里就当 user(user 会回"未知操作",与以前 data 的行为一致)。
|
|
42
|
+
*
|
|
43
|
+
* ★ 2026-11-17(task-627):**下单已改调账务域** `billing.orderCreate`(网关 `/billing-core`),
|
|
44
|
+
* 由 `wkgeo-cli-fc` 白名单转发。所以 `orderCreate` **故意不在这张表里**:
|
|
45
|
+
* 老 `/order` 从来没有这个动作,逃生阀也回不到它 —— `fnOf()` 里单独把它钉在 `cli`。
|
|
46
|
+
*/
|
|
47
|
+
const FN_ORDER = new Set([
|
|
48
|
+
'createRechargeOrder',
|
|
49
|
+
'createRechargeTicket',
|
|
50
|
+
'createRechargeOrderByTicket',
|
|
51
|
+
'getRechargeTicketInfo',
|
|
52
|
+
'createQuotaOrder',
|
|
53
|
+
'createSiteRenewOrder',
|
|
54
|
+
'userQuoteBundle',
|
|
55
|
+
'userCreateBundleOrder',
|
|
56
|
+
'getOrderPayParams',
|
|
57
|
+
'cancelOrder',
|
|
58
|
+
'checkOrder',
|
|
59
|
+
'sweepOrders',
|
|
60
|
+
'paymentNotify',
|
|
61
|
+
]);
|
|
62
|
+
|
|
63
|
+
/* ★ 2026-11-19 task-1250(老板:CLI 只做 CMS 内容管理,跟域名没有关系):
|
|
64
|
+
原 `FN_DOMAIN`(`wkgeo-domain` 的 9 条动作 → 前缀 `/domain`)已整张删除 ——
|
|
65
|
+
CLI 不再有任何域名动作,逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 也回不到 `/domain`。 */
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* 表单插件(`plug/contact-form/fn/src/index.js`)的后台动作 —— 前缀 `/form`。
|
|
69
|
+
*
|
|
70
|
+
* ⚠️ 这些动作**目前只有 CMS 会话 Cookie 能调**(`loadSession` 只认 `cms_session`,
|
|
71
|
+
* 不认 `Authorization: Bearer`),所以 CLI 真调会拿到 401/403。命令照发、错误照译,
|
|
72
|
+
* 后端补 Bearer 桥以后**不用改 CLI** —— 这就是这里保留映射的原因。
|
|
73
|
+
*/
|
|
74
|
+
const FN_FORM = new Set([
|
|
75
|
+
'formList',
|
|
76
|
+
'formGet',
|
|
77
|
+
'formEntryList',
|
|
78
|
+
'formEntryDetail',
|
|
79
|
+
'formEntryCounts',
|
|
80
|
+
]);
|
|
81
|
+
|
|
82
|
+
/** 会员插件(`plug/member/fn/src/index.js`)→ 前缀 `/member` */
|
|
83
|
+
const FN_MEMBER = new Set(['memberRegister', 'memberLogin', 'memberMe', 'memberProfileSave']);
|
|
84
|
+
|
|
85
|
+
/** 渠道码插件(`plug/channel-code/fn/src/index.js`)→ 前缀 `/channel` */
|
|
86
|
+
const FN_CHANNEL = new Set(['channelVisit', 'channelRenderVisit']);
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* 网关前缀 → 目标云函数(来源:`aliyun/fc/wkgeo-gw/src/index.js` 的 `defaultRoutes`,**别猜**)。
|
|
90
|
+
*
|
|
91
|
+
* 前缀就是 URL 的第一段:`POST {base}/form` = 打到 contact-form 那个函数。
|
|
92
|
+
*
|
|
93
|
+
* **2026-10-28 收敛**:业务面只剩 `cli` 一个(`wkgeo-cli-fc`,自持 + 白名单转发),
|
|
94
|
+
* 其余都是**插件面**(动作在 body 里,函数自己的鉴权口径,CLI 只是把动作转发过去)。
|
|
95
|
+
* `order` / `domain` / `user` 三个前缀**已从这张表移除** —— 它们只在逃生阀
|
|
96
|
+
* `WKONGAI_LEGACY_ENDPOINTS=1` 时由 `fnOf()` 直接返回名字(不走这张表的合法性闸门)。
|
|
97
|
+
* `ai` / `ai-tools` 目前 CLI 不直调(`wkgeo ai` 连的是**本机**模型),但前缀先登记好,
|
|
98
|
+
* 将来加动作时直接可以 `data(action, payload, { prefix: 'ai' })`。
|
|
99
|
+
*/
|
|
100
|
+
export const GATEWAY_PREFIXES = Object.freeze({
|
|
101
|
+
cli: 'wkgeo-cli-fc',
|
|
102
|
+
form: 'wkgeo-plugin-contact-form',
|
|
103
|
+
ai: 'wkgeo-ai',
|
|
104
|
+
member: 'wkgeo-plugin-member',
|
|
105
|
+
channel: 'wkgeo-plugin-channel-code',
|
|
106
|
+
'ai-tools': 'wkgeo-plugin-ai-tools',
|
|
107
|
+
/**
|
|
108
|
+
* ★ 2026-11-10(数据交换单):三个**只读**数据面,供 `wkgeo data chat|stats|usage` 用。
|
|
109
|
+
*
|
|
110
|
+
* · `aikefu` → `wkgeo-plugin-aikefu`(MaxKB 会话/消息,只读库)
|
|
111
|
+
* · `analytics` → `wkgeo-plugin-analytics`(PV / UV / IP 唯一数、Top 页面/来源)
|
|
112
|
+
* · `admin` → `wkgeo-admin`(大模型费用账单 `llmCostSummary`,只读位 `llm:cost_read`)
|
|
113
|
+
*
|
|
114
|
+
* 为什么现在才登记:这三个前缀网关早就有了(`wkgeo-gw` 的 `defaultRoutes`),
|
|
115
|
+
* 但 CLI 以前没有命令要打它们。**只登记前缀,不改任何现有动作的路由**:
|
|
116
|
+
* `fnOf()` 的默认仍是 `cli`,只有显式 `prefix:` 才会走这三条。
|
|
117
|
+
*/
|
|
118
|
+
aikefu: 'wkgeo-plugin-aikefu',
|
|
119
|
+
analytics: 'wkgeo-plugin-analytics',
|
|
120
|
+
admin: 'wkgeo-admin',
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
/** 前缀是否合法(HTTP 层的唯一闸门:不认的前缀直接报用法错误,绝不瞎打) */
|
|
124
|
+
export function isGatewayPrefix(prefix) {
|
|
125
|
+
return typeof prefix === 'string' && Object.prototype.hasOwnProperty.call(GATEWAY_PREFIXES, prefix);
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/** 逃生阀:`WKONGAI_LEGACY_ENDPOINTS=1` ⇒ 回到 2026-10-28 之前的直连(默认关) */
|
|
129
|
+
const LEGACY_ENV = 'WKONGAI_LEGACY_ENDPOINTS';
|
|
130
|
+
|
|
131
|
+
export function legacyEndpointsEnabled(env = process.env) {
|
|
132
|
+
const v = String((env && env[LEGACY_ENV]) || '').trim().toLowerCase();
|
|
133
|
+
return v === '1' || v === 'true' || v === 'yes' || v === 'on';
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* 动作 → 网关前缀。
|
|
138
|
+
*
|
|
139
|
+
* 规则(默认,2026-10-28 起):
|
|
140
|
+
* 1. **插件面**(form / member / channel)照旧打各自前缀 —— 那是别人函数的面,CLI 只做信使;
|
|
141
|
+
* 2. **其余一切**(站点 / 域名 / 模板 / 发布 / 资产 / 钱包 / 套餐 / 应用授权 / 金融面 / 不认识的)
|
|
142
|
+
* 一律 `cli` —— `wkgeo-cli-fc` 自己分发;不认识的动作由它回 `400 未知动作`。
|
|
143
|
+
*
|
|
144
|
+
* 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 时退回老口径:
|
|
145
|
+
* order / form / member / channel 按显式表,其余 `user`(`/domain` 已随 task-1250 删除)。
|
|
146
|
+
*/
|
|
147
|
+
export function fnOf(action, { legacy = legacyEndpointsEnabled() } = {}) {
|
|
148
|
+
if (FN_FORM.has(action)) return 'form';
|
|
149
|
+
if (FN_MEMBER.has(action)) return 'member';
|
|
150
|
+
if (FN_CHANNEL.has(action)) return 'channel';
|
|
151
|
+
/**
|
|
152
|
+
* ★ 2026-11-17(task-627):账务域下单**只在 `/cli` 后面**(cli-fc 再转发到 `/billing-core`)。
|
|
153
|
+
* 逃生阀也回不去:`/order` 没有 `orderCreate` 这个动作,`/user` 更没有。
|
|
154
|
+
*
|
|
155
|
+
* ★ 2026-11-20(cli-price-quote):账务域**只读报价** `orderQuote` 同理(cli-fc 白名单转发)——
|
|
156
|
+
* 加购价的唯一来源是它(与 `orderCreate` 实收同源),逃生阀也不许绕到别的函数。
|
|
157
|
+
*/
|
|
158
|
+
if (action === 'orderCreate' || action === 'orderQuote') return 'cli';
|
|
159
|
+
if (legacy) {
|
|
160
|
+
if (FN_ORDER.has(action)) return 'order';
|
|
161
|
+
return 'user';
|
|
162
|
+
}
|
|
163
|
+
return 'cli';
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
export function createApi({ config, fetchImpl = globalThis.fetch } = {}) {
|
|
167
|
+
const base = config.base;
|
|
168
|
+
const timeoutMs = config.httpTimeoutMs;
|
|
169
|
+
|
|
170
|
+
async function raw(url, options = {}) {
|
|
171
|
+
return request(url, { ...options, fetchImpl, timeoutMs: options.timeoutMs ?? timeoutMs });
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/** 决定成败的唯一依据是 body.code(项目约定 HTTP 恒 200) */
|
|
175
|
+
function unwrap(res, action) {
|
|
176
|
+
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
177
|
+
const cls = classifyResponse({
|
|
178
|
+
httpStatus: res.status,
|
|
179
|
+
body: res.body,
|
|
180
|
+
action,
|
|
181
|
+
retryAfterHeader: res.headers && typeof res.headers.get === 'function' ? res.headers.get('retry-after') : null,
|
|
182
|
+
cmdName: config.cmdName || 'wkgeo',
|
|
183
|
+
});
|
|
184
|
+
if (!cls.ok) throw toCliError(cls, { action, raw: { status: res.status, body: res.body } });
|
|
185
|
+
return res.body ? res.body.data : null;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
return {
|
|
189
|
+
config,
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* 业务面:POST /<fn> {action, ...payload} —— fn 由 `fnOf(action)` 决定。
|
|
193
|
+
*
|
|
194
|
+
* 默认 `/cli`(`wkgeo-cli-fc`);插件面按 `GATEWAY_PREFIXES` 打各自前缀。
|
|
195
|
+
* 逃生阀 `WKONGAI_LEGACY_ENDPOINTS=1` 让 `fnOf()` 退回老的 order/domain/user 直连。
|
|
196
|
+
*
|
|
197
|
+
* @param {string} action
|
|
198
|
+
* @param {object} [payload]
|
|
199
|
+
* @param {{token?:string, prefix?:string, headers?:object, timeoutMs?:number}} [opts]
|
|
200
|
+
* `prefix` 覆盖自动推断(打 `/form` `/ai` `/member` `/channel` `/ai-tools` 时用;
|
|
201
|
+
* 只接受 `GATEWAY_PREFIXES` 里的值);`headers` 是额外请求头(如 `x-cms-site`、`Origin`)。
|
|
202
|
+
*/
|
|
203
|
+
async data(action, payload = {}, { token, prefix, headers, timeoutMs } = {}) {
|
|
204
|
+
if (!action) throw new CliError('内部错误:缺少 action');
|
|
205
|
+
if (prefix !== undefined && !isGatewayPrefix(prefix)) {
|
|
206
|
+
throw new CliError(`内部错误:不支持的前缀「${prefix}」(可用:${Object.keys(GATEWAY_PREFIXES).join(' / ')})`, {
|
|
207
|
+
kind: 'internal',
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
const fn = prefix || fnOf(action);
|
|
211
|
+
const res = await raw(`${base}/${fn}`, {
|
|
212
|
+
method: 'POST',
|
|
213
|
+
timeoutMs,
|
|
214
|
+
headers: {
|
|
215
|
+
'Content-Type': 'application/json',
|
|
216
|
+
Accept: 'application/json',
|
|
217
|
+
...(token ? { Authorization: `Bearer ${token}` } : {}),
|
|
218
|
+
...(headers || {}),
|
|
219
|
+
},
|
|
220
|
+
body: JSON.stringify({ action, ...payload }),
|
|
221
|
+
});
|
|
222
|
+
return unwrap(res, action);
|
|
223
|
+
},
|
|
224
|
+
|
|
225
|
+
/** 授权服务器元数据(授权前用它发现 authorization_endpoint / token 有效期策略) */
|
|
226
|
+
async metadata() {
|
|
227
|
+
const res = await raw(`${base}/api/oauth/metadata`, { method: 'GET', headers: { Accept: 'application/json' } });
|
|
228
|
+
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
229
|
+
if (res.status !== 200 || !res.body) {
|
|
230
|
+
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'metadata', cmdName: config.cmdName || 'wkgeo' });
|
|
231
|
+
throw toCliError(cls, { action: 'metadata', raw: { status: res.status, body: res.body } });
|
|
232
|
+
}
|
|
233
|
+
return res.body;
|
|
234
|
+
},
|
|
235
|
+
|
|
236
|
+
/**
|
|
237
|
+
* 用户信息(身份的唯一权威来源)。
|
|
238
|
+
* ⚠️ 这个端点**不走统一信封**:HTTP 401 + `{error:'invalid_token'}`。
|
|
239
|
+
*/
|
|
240
|
+
async userinfo(token) {
|
|
241
|
+
const res = await raw(`${base}/api/oauth/userinfo`, {
|
|
242
|
+
method: 'GET',
|
|
243
|
+
headers: { Accept: 'application/json', Authorization: `Bearer ${token}` },
|
|
244
|
+
});
|
|
245
|
+
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
246
|
+
if (res.status === 200 && res.body && res.body.sub) return res.body;
|
|
247
|
+
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'userinfo', cmdName: config.cmdName || 'wkgeo' });
|
|
248
|
+
throw toCliError(cls, { action: 'userinfo', raw: { status: res.status, body: res.body } });
|
|
249
|
+
},
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* 换令牌 / 刷新令牌(OAuth 标准表单)。
|
|
253
|
+
* ⚠️ 成功响应里**有明文 access_token** —— 返回值只允许写进凭据文件,禁止打印。
|
|
254
|
+
*/
|
|
255
|
+
async token(form) {
|
|
256
|
+
const res = await raw(`${base}/api/oauth/token`, {
|
|
257
|
+
method: 'POST',
|
|
258
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
259
|
+
body: encodeForm(form),
|
|
260
|
+
});
|
|
261
|
+
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
262
|
+
if (res.status === 200 && res.body && res.body.access_token) return res.body;
|
|
263
|
+
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'token', cmdName: config.cmdName || 'wkgeo' });
|
|
264
|
+
throw toCliError(cls, { action: 'token', raw: { status: res.status, body: res.body } });
|
|
265
|
+
},
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* 原样发一个 OAuth 表单请求,**不抛异常**(返回 status/body/networkError)。
|
|
269
|
+
*
|
|
270
|
+
* 为什么需要它:设备码轮询里 `authorization_pending` / `slow_down` / `expired_token`
|
|
271
|
+
* 都是**正常预期**的中间态,不是错误 —— 用一个会抛的封装会让轮询逻辑写成一团 try/catch。
|
|
272
|
+
*/
|
|
273
|
+
async oauthForm(pathname, form) {
|
|
274
|
+
const res = await raw(`${base}${pathname}`, {
|
|
275
|
+
method: 'POST',
|
|
276
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
277
|
+
body: encodeForm(form),
|
|
278
|
+
});
|
|
279
|
+
return res;
|
|
280
|
+
},
|
|
281
|
+
|
|
282
|
+
/** 自省(RFC 7662):返回 {active,...},**不是错误**,调用方自己看 active */
|
|
283
|
+
async introspect(token) {
|
|
284
|
+
const res = await raw(`${base}/api/oauth/introspect`, {
|
|
285
|
+
method: 'POST',
|
|
286
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
287
|
+
body: encodeForm({ token }),
|
|
288
|
+
});
|
|
289
|
+
if (res.networkError) throw networkError(res.networkError, { raw: res });
|
|
290
|
+
if (res.status === 200 && res.body) return res.body;
|
|
291
|
+
const cls = classifyResponse({ httpStatus: res.status, body: res.body, action: 'introspect', cmdName: config.cmdName || 'wkgeo' });
|
|
292
|
+
throw toCliError(cls, { action: 'introspect', raw: { status: res.status, body: res.body } });
|
|
293
|
+
},
|
|
294
|
+
|
|
295
|
+
/**
|
|
296
|
+
* 吊销(RFC 7009)。
|
|
297
|
+
* best-effort:未知 token 也回 200;网络失败**不阻塞 logout**(本地删掉才是关键),
|
|
298
|
+
* 但把失败原因返回给调用方,让 logout 能如实告诉用户"服务端没吊销成功"。
|
|
299
|
+
*/
|
|
300
|
+
async revoke(token) {
|
|
301
|
+
try {
|
|
302
|
+
const res = await raw(`${base}/api/oauth/revoke`, {
|
|
303
|
+
method: 'POST',
|
|
304
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
|
|
305
|
+
body: encodeForm({ token, client_id: config.clientId }),
|
|
306
|
+
});
|
|
307
|
+
if (res.networkError) return { ok: false, reason: res.networkError };
|
|
308
|
+
if (res.status >= 200 && res.status < 300) return { ok: true };
|
|
309
|
+
return { ok: false, reason: `HTTP ${res.status} ${res.text ? res.text.slice(0, 200) : ''}`.trim() };
|
|
310
|
+
} catch (e) {
|
|
311
|
+
return { ok: false, reason: (e && e.message) || String(e) };
|
|
312
|
+
}
|
|
313
|
+
},
|
|
314
|
+
};
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/**
|
|
318
|
+
* 具名动作封装(不用 this,避免解构后 this 丢失 —— 踩过)。
|
|
319
|
+
* 用法:`const api = createApi({config}); await api.data('listSites', {...}, {token})`
|
|
320
|
+
*/
|
|
321
|
+
export const ACTIONS = {
|
|
322
|
+
sites: {
|
|
323
|
+
list: 'listSites',
|
|
324
|
+
get: 'getSite',
|
|
325
|
+
create: 'createSite',
|
|
326
|
+
remove: 'deleteSite',
|
|
327
|
+
purge: 'purgeSite',
|
|
328
|
+
},
|
|
329
|
+
wallet: {
|
|
330
|
+
get: 'getMyWallet',
|
|
331
|
+
billing: 'getMyBilling',
|
|
332
|
+
},
|
|
333
|
+
orders: {
|
|
334
|
+
/**
|
|
335
|
+
* ★ 2026-11-17(task-627):下单 = `billing.orderCreate`(账务域),
|
|
336
|
+
* payload 必须带 `kind`(CLI 只用 `'quota'`)。旧的 `createQuotaOrder` 不再调用。
|
|
337
|
+
*/
|
|
338
|
+
createQuota: 'orderCreate',
|
|
339
|
+
check: 'checkOrder',
|
|
340
|
+
list: 'listMyOrders',
|
|
341
|
+
cancel: 'cancelOrder',
|
|
342
|
+
},
|
|
343
|
+
catalog: {
|
|
344
|
+
products: 'listProducts',
|
|
345
|
+
entitlements: 'listMyEntitlements',
|
|
346
|
+
},
|
|
347
|
+
apps: {
|
|
348
|
+
list: 'listMyOAuthAuthorizations',
|
|
349
|
+
revoke: 'revokeMyOAuthAuthorization',
|
|
350
|
+
},
|
|
351
|
+
};
|