@xixka/dsh-hub 0.4.9 → 0.4.11
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/README.md +123 -11
- package/lib/buddy-adapter.d.ts +15 -0
- package/lib/buddy-adapter.d.ts.map +1 -1
- package/lib/buddy-adapter.js +17 -1
- package/lib/buddy-adapter.js.map +1 -1
- package/lib/buddy.d.ts +23 -0
- package/lib/buddy.d.ts.map +1 -1
- package/lib/buddy.js +27 -0
- package/lib/buddy.js.map +1 -1
- package/lib/chromium-session.d.ts +57 -0
- package/lib/chromium-session.d.ts.map +1 -1
- package/lib/chromium-session.js +128 -3
- package/lib/chromium-session.js.map +1 -1
- package/lib/client/jet-hub.js +75 -17938
- package/lib/doubao-login.d.ts +20 -0
- package/lib/doubao-login.d.ts.map +1 -1
- package/lib/doubao-login.js +21 -64
- package/lib/doubao-login.js.map +1 -1
- package/lib/doubao-signin.d.ts +32 -0
- package/lib/doubao-signin.d.ts.map +1 -1
- package/lib/doubao-signin.js +37 -38
- package/lib/doubao-signin.js.map +1 -1
- package/lib/index.d.ts +1 -0
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +57 -4
- package/lib/index.js.map +1 -1
- package/lib/jet-hub-rpc.d.ts +24 -0
- package/lib/jet-hub-rpc.d.ts.map +1 -1
- package/lib/jet-hub-rpc.js +45 -0
- package/lib/jet-hub-rpc.js.map +1 -1
- package/lib/llm-register-compat.d.ts +50 -0
- package/lib/llm-register-compat.d.ts.map +1 -1
- package/lib/llm-register-compat.js +78 -1
- package/lib/llm-register-compat.js.map +1 -1
- package/lib/lobsterai-adapter.d.ts +98 -4
- package/lib/lobsterai-adapter.d.ts.map +1 -1
- package/lib/lobsterai-adapter.js +275 -7
- package/lib/lobsterai-adapter.js.map +1 -1
- package/lib/login.d.ts +8 -2
- package/lib/login.d.ts.map +1 -1
- package/lib/login.js +11 -50
- package/lib/login.js.map +1 -1
- package/lib/loomy-adapter.d.ts.map +1 -1
- package/lib/loomy-adapter.js +56 -3
- package/lib/loomy-adapter.js.map +1 -1
- package/lib/model-promotions.d.ts +147 -1
- package/lib/model-promotions.d.ts.map +1 -1
- package/lib/model-promotions.js +336 -11
- package/lib/model-promotions.js.map +1 -1
- package/lib/openai-compat.d.ts.map +1 -1
- package/lib/openai-compat.js +21 -1
- package/lib/openai-compat.js.map +1 -1
- package/lib/promotion-tooltip.d.ts +108 -0
- package/lib/promotion-tooltip.d.ts.map +1 -0
- package/lib/promotion-tooltip.js +165 -0
- package/lib/promotion-tooltip.js.map +1 -0
- package/lib/qoder-adapter.d.ts +17 -0
- package/lib/qoder-adapter.d.ts.map +1 -1
- package/lib/qoder-adapter.js +24 -0
- package/lib/qoder-adapter.js.map +1 -1
- package/lib/raccoon-adapter.d.ts +6 -0
- package/lib/raccoon-adapter.d.ts.map +1 -1
- package/lib/raccoon-adapter.js +43 -0
- package/lib/raccoon-adapter.js.map +1 -1
- package/lib/raccoon-auth.d.ts +2 -1
- package/lib/raccoon-auth.d.ts.map +1 -1
- package/lib/raccoon-auth.js +2 -1
- package/lib/raccoon-auth.js.map +1 -1
- package/lib/raccoon-authorize.d.ts +311 -0
- package/lib/raccoon-authorize.d.ts.map +1 -0
- package/lib/raccoon-authorize.js +698 -0
- package/lib/raccoon-authorize.js.map +1 -0
- package/lib/raccoon-login-page.d.ts +15 -0
- package/lib/raccoon-login-page.d.ts.map +1 -1
- package/lib/raccoon-login-page.js +346 -15
- package/lib/raccoon-login-page.js.map +1 -1
- package/lib/raccoon-product.d.ts +3 -3
- package/lib/raccoon-product.d.ts.map +1 -1
- package/lib/raccoon-product.js +59 -11
- package/lib/raccoon-product.js.map +1 -1
- package/lib/system-ca-trust.d.ts +6 -0
- package/lib/system-ca-trust.d.ts.map +1 -0
- package/lib/system-ca-trust.js +88 -0
- package/lib/system-ca-trust.js.map +1 -0
- package/lib/trae-adapter.d.ts +33 -0
- package/lib/trae-adapter.d.ts.map +1 -1
- package/lib/trae-adapter.js +66 -0
- package/lib/trae-adapter.js.map +1 -1
- package/lib/trae.d.ts +78 -0
- package/lib/trae.d.ts.map +1 -1
- package/lib/trae.js +111 -0
- package/lib/trae.js.map +1 -1
- package/package.json +4 -1
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Raccoon Work 的**浏览器授权**登录(官方客户端自己的那条链)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么要有这个模块
|
|
5
|
+
*
|
|
6
|
+
* 官方桌面端 2026-11-05 的构建**不再走扫码确认页**:它开的是 `/authorize`
|
|
7
|
+
* 授权页(系统浏览器),用户在**网页里**完成登录(手机号 / 微信扫码 —— 那是
|
|
8
|
+
* 页面自己的一张**活的**二维码,与已死的 `/login/mp` 不是同一张),
|
|
9
|
+
* 确认后页面申请一枚**一次性** `authorization_code`,再把它**投递回调用方**:
|
|
10
|
+
* 要么是注册过的 `office-raccoon://` 自定义协议(只有官方 App 能收),
|
|
11
|
+
* 要么是 **`127.0.0.1:<port>` 上的回环接收端**(Windows/Linux 兼容形态,
|
|
12
|
+
* 第三方可以自己托管)。
|
|
13
|
+
*
|
|
14
|
+
* ⚠️ **本仓为什么必须走回环形态**:`office-raccoon://` 是宿主 Node 进程
|
|
15
|
+
* **收不到**的自定义协议回调。而本仓原先的扫码链**已经死了** ——
|
|
16
|
+
* 扫码确认页 `/login/mp` 自 2026-11-04 起**全部 404**(含微信 UA),
|
|
17
|
+
* 而**签发本身是成功的** ⇒ 用户扫进去只看到一个 404 页,零报错。
|
|
18
|
+
* 本模块是那半条死链的**替代**:官方客户端的授权页 + 回环接收端 + 换码。
|
|
19
|
+
*
|
|
20
|
+
* ## 机制参照,不是抄端口
|
|
21
|
+
*
|
|
22
|
+
* 线上的事实取自三处(2026-11-17 实测):
|
|
23
|
+
*
|
|
24
|
+
* 1. 官网 `/authorize` 页**在线**(HTTP 200,且把它收到的
|
|
25
|
+
* `login_source` / `appname` / `desktop_callback` / `redirect` / `state`
|
|
26
|
+
* **原样回显**进页面上下文);
|
|
27
|
+
* 2. 该页 chunk 里的**解析器规则**(见下「官方页自己的规则」);
|
|
28
|
+
* 3. 换码端点 `POST /api/web/auth/v1/login_with_authorization_code` ——
|
|
29
|
+
* 实测一枚瞎编的 code 回 **HTTP 400 `{code:200035}`**(= 官方常量
|
|
30
|
+
* `AUTHORIZATION_CODE_NOT_FOUND`),证明端点与错误码都还在。
|
|
31
|
+
*
|
|
32
|
+
* ## 官方页自己的规则(我们逐条前置校验)
|
|
33
|
+
*
|
|
34
|
+
* 页面的解析器(chunk `app/(identity)/authorize/page-…js`)要求:
|
|
35
|
+
*
|
|
36
|
+
* - `redirect` 必须匹配 `^http://127\.0\.0\.1:[1-9][0-9]{3,4}/auth/callback$`
|
|
37
|
+
* (端口 4~5 位、首位非 0),且端口落在 1024..65535;
|
|
38
|
+
* - `state` 必须是 **64 位小写 hex**;
|
|
39
|
+
* - `login_source` 存在时**必须**是 `desktop`;
|
|
40
|
+
* - `desktop_callback` 存在时**必须**是 `loopback`,且此时
|
|
41
|
+
* `login_source` 必为 `desktop`、`ide` 必为空、`redirect` 必过上面那条;
|
|
42
|
+
* - 参数名**只能**取自 `{login_source, appname, state, redirect, ide, org,
|
|
43
|
+
* lang, desktop_callback}` —— 多一个键整条链接就作废。
|
|
44
|
+
*
|
|
45
|
+
* ⇒ 一个页面会拒收的 URL **不该**拿给用户(那是个没有下一步的死路)。
|
|
46
|
+
* 所以 {@link buildRaccoonAuthorizeUrl} 在**发出之前**就按这些规则自查。
|
|
47
|
+
*
|
|
48
|
+
* ## 回环接收端的七条规则(官方接收端的规则逐条重述)
|
|
49
|
+
*
|
|
50
|
+
* 授权码是一次性凭据,而一个敞开的接收端就是「凭据交换漏洞」 ⇒ 七条检查
|
|
51
|
+
* **一条都不能少**:GET-only、`Host` 等于我们自己的 authority、来源地址是
|
|
52
|
+
* 回环、存在的 `Origin` 必须等于网关 origin、存在的 `Sec-Fetch-Dest`
|
|
53
|
+
* 必须是 `document`、路径与查询键严格受限、`state` 常量时间比对通过。
|
|
54
|
+
*
|
|
55
|
+
* ## 凭据的边界
|
|
56
|
+
*
|
|
57
|
+
* 换码的结果**只**回到调用方(换码成功后由登录页流程落进 DSH 凭据服务)。
|
|
58
|
+
* 本模块**不打印**任何凭据值:失败结果只带**原因词**,不带报文原文
|
|
59
|
+
* (报文可能回显那枚 code)。
|
|
60
|
+
*
|
|
61
|
+
* @module dsh-providers-hub/raccoon-authorize
|
|
62
|
+
*/
|
|
63
|
+
import { RACCOON_API_BASE, type RaccoonCredential } from './raccoon.js';
|
|
64
|
+
import { type RaccoonProduct } from './raccoon-product.js';
|
|
65
|
+
/**
|
|
66
|
+
* 网关 origin —— 本模块构造的每条 URL 都以它为底。
|
|
67
|
+
*
|
|
68
|
+
* ⚠️ **重导出**(不是只 import):调用方与测试都要拿它当「授权页 origin」和
|
|
69
|
+
* 「`Origin` 头必须等于的那个值」,而这个模块**就是**这条链的定义处 ⇒
|
|
70
|
+
* 从这里导出才是**单一真相源**(从别处 import 会让「改了常量、这边没改」
|
|
71
|
+
* 成为可能)。
|
|
72
|
+
*/
|
|
73
|
+
export { RACCOON_API_BASE };
|
|
74
|
+
/** 官方客户端在系统浏览器里打开的授权页路径。 */
|
|
75
|
+
export declare const RACCOON_AUTHORIZE_PATH = "/authorize";
|
|
76
|
+
/**
|
|
77
|
+
* 回环接收端的回调路径 —— **由官方页面写死**,不可改。
|
|
78
|
+
*
|
|
79
|
+
* 页面投递时用的参数名在 desktop 形态下是 **`code`**(非 desktop 才是
|
|
80
|
+
* `authorization_code`;见页面 chunk 的
|
|
81
|
+
* `r.searchParams.set(e.desktop ? "code" : "authorization_code", t)`)。
|
|
82
|
+
*/
|
|
83
|
+
export declare const RACCOON_LOOPBACK_CALLBACK_PATH = "/auth/callback";
|
|
84
|
+
/**
|
|
85
|
+
* 授权页上显示的「申请授权的应用」名。
|
|
86
|
+
*
|
|
87
|
+
* 官方客户端自己的 `DESKTOP_AUTH_PARAMS` 字面量(desktopLogin.js),
|
|
88
|
+
* 也是 2026-11-17 那次真机授权**成功走完**时用的名字。
|
|
89
|
+
*
|
|
90
|
+
* ⚠️ 官方页的解析器对三个 appname 有白名单(办公小浣熊客户端 / 商汤小浣熊
|
|
91
|
+
* 客户端 / Office Raccoon),其余名字**也能解析**,但确认文案会照抄
|
|
92
|
+
* 那个**未知字符串** ⇒ 页面上一句「此应用希望使用你的账号登录」会变成
|
|
93
|
+
* 一句没头没尾的话。故默认用**实测走通的那个**。
|
|
94
|
+
*/
|
|
95
|
+
export declare const RACCOON_AUTH_APPNAME = "\u529E\u516C\u5C0F\u6D63\u718A\u5BA2\u6237\u7AEF";
|
|
96
|
+
/**
|
|
97
|
+
* 网关的「这枚授权码不存在 / 已过期 / 已消费」错误码。
|
|
98
|
+
*
|
|
99
|
+
* 实测(2026-11-17):一枚瞎编的 code 打
|
|
100
|
+
* `POST /api/web/auth/v1/login_with_authorization_code` ⇒ HTTP 400
|
|
101
|
+
* `{"code":200035,"message":"authorization_code_not_found_error"}`。
|
|
102
|
+
* 官方客户端的常量 `AUTHORIZATION_CODE_NOT_FOUND` 是**同一个值**。
|
|
103
|
+
*
|
|
104
|
+
* ⚠️ 这是**唯一**的出路:重发同一枚码没有任何用处,只能**重开一轮**。
|
|
105
|
+
*/
|
|
106
|
+
export declare const RACCOON_AUTHORIZATION_CODE_NOT_FOUND = 200035;
|
|
107
|
+
/**
|
|
108
|
+
* 回环等待的默认时限(毫秒)。
|
|
109
|
+
*
|
|
110
|
+
* 官方回环自己的默认值(`timeoutMs ?? 300000`)。一次「网页里重新登录」
|
|
111
|
+
* (含手机号验证码)能从容落在这五分钟内。
|
|
112
|
+
*/
|
|
113
|
+
export declare const RACCOON_AUTHORIZE_TIMEOUT_MS: number;
|
|
114
|
+
/**
|
|
115
|
+
* IAM 令牌必须带的 `iss`。
|
|
116
|
+
*
|
|
117
|
+
* 官方客户端算的是 `new URL(LOGIN_URL).host + "/iam"` —— **裸 host、无 scheme**。
|
|
118
|
+
* ⚠️ **无 scheme 这件事是承重的**:`iss` 是**等值**比较,若按带 scheme 的
|
|
119
|
+
* 严格等值去比,会**误拒每一枚真令牌**。
|
|
120
|
+
*/
|
|
121
|
+
export declare const RACCOON_IAM_ISSUER: string;
|
|
122
|
+
/**
|
|
123
|
+
* 回调 URL 的**总长度上限**。
|
|
124
|
+
*
|
|
125
|
+
* ## 为什么是 4096 而不是官方的 8192
|
|
126
|
+
*
|
|
127
|
+
* 官方接收端写的是 `rawUrl.length > 8192`。但**在我们这儿那个上限是够不着的**:
|
|
128
|
+
* Node 的 `maxHeaderSize: 8192`(**含**请求行与方法/版本/Host 等头)在 URL
|
|
129
|
+
* 长到约 **8160** 时就会先回 **431 Request Header Fields Too Large**
|
|
130
|
+
* (实测:URL 长 8150 → 200、8160 → 431)⇒ **任何长于 8192 的 URL 根本到不了
|
|
131
|
+
* 我们的处理器** ⇒ 写 8192 等于**一条永远走不到的死代码**(本仓反复记过
|
|
132
|
+
* 「判据够不着 ⇒ 等于没有」)。
|
|
133
|
+
*
|
|
134
|
+
* ⇒ 取 **4096**:既**真的**在 Node 的 431 之前(⇒ 这条判据**有牙**、
|
|
135
|
+
* 能被单测打到),又远高于任何**正常**回调的长度
|
|
136
|
+
* (路径 13 + `code` ≤ 4096 + `state` 64 + 分隔符 ≈ 4200 —— 嗯,正好在
|
|
137
|
+
* 边界上,所以 code 那条 4096 的上限与它**同量级**,两条腿合起来把
|
|
138
|
+
* 「畸形超长」挡在门外)。
|
|
139
|
+
*
|
|
140
|
+
* ⚠️ 代价要说清:**一条 code 极长(接近 4096)的合法回调**可能被这条 URL
|
|
141
|
+
* 上限拒掉。但那种 code 上游自己也不会签发(官方对 code 的上限也是 4096,
|
|
142
|
+
* 而带 64 位 state 与路径后总量必然更小)⇒ 实际不可达。
|
|
143
|
+
*/
|
|
144
|
+
export declare const RACCOON_CALLBACK_URL_MAX_LENGTH = 4096;
|
|
145
|
+
/**
|
|
146
|
+
* 单个 socket 的空闲超时(毫秒)—— 官方接收端同款(20000)。
|
|
147
|
+
*
|
|
148
|
+
* ⚠️ **可注入**(`options.socketTimeoutMs`):20 秒在单测里没法等 ⇒
|
|
149
|
+
* 没有注入点,那条判据就**够不着**(变异验证会如实报「无牙」——
|
|
150
|
+
* 那不是判据没用,是**够不着**)。
|
|
151
|
+
*/
|
|
152
|
+
export declare const RACCOON_SOCKET_TIMEOUT_MS = 20000;
|
|
153
|
+
/**
|
|
154
|
+
* 判断一枚令牌**是不是** IAM 形态 —— 官方 `iamToken.js` 的规则:
|
|
155
|
+
* `iss` 以 `/iam` 结尾。
|
|
156
|
+
*
|
|
157
|
+
* ⚠️ **不验签**:签名由服务端负责校验;这里只决定**走成功门的哪一半**。
|
|
158
|
+
*
|
|
159
|
+
* @param token - 候选 JWT。
|
|
160
|
+
* @returns 是否 IAM 形态。
|
|
161
|
+
*/
|
|
162
|
+
export declare function isRaccoonIamToken(token: unknown): boolean;
|
|
163
|
+
/**
|
|
164
|
+
* 官方 `iamTokenIsValid` 的重述:同一个 issuer、非空 `sub`、未来的有限 `exp`
|
|
165
|
+
* —— 且 `exp` 不能大到让 `new Date(exp*1000)` 不是一个日期。
|
|
166
|
+
*
|
|
167
|
+
* @param token - access token。
|
|
168
|
+
* @param issuer - 期望的 `iss`(默认 {@link RACCOON_IAM_ISSUER})。
|
|
169
|
+
* @returns 是否通过。
|
|
170
|
+
*/
|
|
171
|
+
export declare function raccoonIamTokenIsValid(token: unknown, issuer?: string): boolean;
|
|
172
|
+
/**
|
|
173
|
+
* 构造「一次浏览器登录」打开的那条 URL。
|
|
174
|
+
*
|
|
175
|
+
* 每个参数都在**发出之前**按官方页面的规则自查(见文件头「官方页自己的
|
|
176
|
+
* 规则」);不合规就**抛错**(带名字),让调用方能给出一句有下一步的话,
|
|
177
|
+
* 而不是丢一个页面会拒收的链接给用户。
|
|
178
|
+
*
|
|
179
|
+
* @param options
|
|
180
|
+
* @param options.port - 回环端口(整数 1024..65535)。
|
|
181
|
+
* @param options.state - 64 位小写 hex 的 state(公开的 CSRF 令牌)。
|
|
182
|
+
* @param options.appname - 授权页显示的应用名(默认 {@link RACCOON_AUTH_APPNAME})。
|
|
183
|
+
* @param options.base - 网关 origin(默认 {@link RACCOON_API_BASE})。
|
|
184
|
+
* @returns 完整 URL。
|
|
185
|
+
* @throws {Error} 具名的违规说明。
|
|
186
|
+
*/
|
|
187
|
+
export declare function buildRaccoonAuthorizeUrl({ port, state, appname, base, }: {
|
|
188
|
+
port: unknown;
|
|
189
|
+
state: unknown;
|
|
190
|
+
appname?: unknown;
|
|
191
|
+
base?: unknown;
|
|
192
|
+
}): string;
|
|
193
|
+
/** 回环接收端的终态。 */
|
|
194
|
+
export interface RaccoonAuthorizeReceiverResult {
|
|
195
|
+
/** 是否拿到了授权码。 */
|
|
196
|
+
ok: boolean;
|
|
197
|
+
/** 授权码**只**在这里出现(不进响应体、不进日志)。 */
|
|
198
|
+
code?: string;
|
|
199
|
+
/** 失败的原因词。 */
|
|
200
|
+
reason?: 'timeout' | 'closed' | 'failed';
|
|
201
|
+
}
|
|
202
|
+
/** 一个活着的回环接收端及其归宿。 */
|
|
203
|
+
export interface RaccoonAuthorizeReceiver {
|
|
204
|
+
/** 接收端期待的 state(64 hex,公开)。 */
|
|
205
|
+
state: string;
|
|
206
|
+
/** 实际监听的端口。 */
|
|
207
|
+
port: number;
|
|
208
|
+
/** `/authorize` URL 携带的回跳目标。 */
|
|
209
|
+
redirect: string;
|
|
210
|
+
/** 要在系统浏览器里打开的完整 `/authorize` URL。 */
|
|
211
|
+
authorizeUrl: string;
|
|
212
|
+
/** 只落定一次:回调带来的 code,或终态原因。 */
|
|
213
|
+
result: Promise<RaccoonAuthorizeReceiverResult>;
|
|
214
|
+
/** 立刻关闭接收端(结果落定为 `{ok:false, reason:'closed'}`)。 */
|
|
215
|
+
cancel: () => void;
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
* 启动回环接收端 —— 官方 `/authorize` 页的回调落点。
|
|
219
|
+
*
|
|
220
|
+
* 工厂是**异步**的:端口只有在操作系统分配之后才知道(`port 0`),调用方
|
|
221
|
+
* 必须在把 URL 交给浏览器**之前** await 它 —— 那时接收端**已经在听**,
|
|
222
|
+
* 不存在「页面往一个还不是我们的端口上跳」的窗口。
|
|
223
|
+
*
|
|
224
|
+
* ⚠️ 绑不上端口(EADDRINUSE)**不抛**:调用方正处在一个请求里、需要一句
|
|
225
|
+
* 答复,而它报出来的失败是用户**能动作**的(重开一轮)。
|
|
226
|
+
*
|
|
227
|
+
* @param options
|
|
228
|
+
* @param options.port - 指定端口;缺省 / 0 = 由操作系统分配。
|
|
229
|
+
* @param options.state - 64 位 hex;缺省时随机生成。
|
|
230
|
+
* @param options.timeoutMs - 等待时限(默认 {@link RACCOON_AUTHORIZE_TIMEOUT_MS})。
|
|
231
|
+
* @param options.authorizationOrigin - 存在的 `Origin` 头必须等于它(默认网关 origin)。
|
|
232
|
+
* @param options.appname - 授权页的应用名。
|
|
233
|
+
* @param options.base - 网关 origin。
|
|
234
|
+
* @returns 接收端句柄。
|
|
235
|
+
*/
|
|
236
|
+
export declare function startRaccoonAuthorizeReceiver(options?: {
|
|
237
|
+
port?: unknown;
|
|
238
|
+
state?: unknown;
|
|
239
|
+
timeoutMs?: unknown;
|
|
240
|
+
authorizationOrigin?: unknown;
|
|
241
|
+
appname?: unknown;
|
|
242
|
+
base?: unknown;
|
|
243
|
+
/** 单个 socket 的空闲超时(毫秒);默认 {@link RACCOON_SOCKET_TIMEOUT_MS}。 */
|
|
244
|
+
socketTimeoutMs?: unknown;
|
|
245
|
+
}): Promise<RaccoonAuthorizeReceiver>;
|
|
246
|
+
/**
|
|
247
|
+
* 用系统默认浏览器打开 URL;**永不抛出**。
|
|
248
|
+
*
|
|
249
|
+
* ⚠️⚠️ **绝不能用 `cmd /c start`** —— 它把 URL 里每个 `&` 当命令分隔符,
|
|
250
|
+
* 于是 `?...&...` 会被**截断**在第一个 `&` 上(症状极具误导性:授权页显示
|
|
251
|
+
* 「链接无效」、参数全丢)。`rundll32` **不经过 shell**,参数原样传递
|
|
252
|
+
* (与 `accio-oauth.ts` 的 `openBrowser` 同一处方)。
|
|
253
|
+
*
|
|
254
|
+
* ⚠️ 永不抛出的兑现方式是那个**空回调**:Node 只在 `execFile` **带回调**时
|
|
255
|
+
* 才代为挂上 `'error'` 监听器 ⇒ 那个 `() => {}` 不是装饰,删掉它,
|
|
256
|
+
* `ENOENT` 会变成**未捕获异常**并打挂宿主进程。
|
|
257
|
+
*/
|
|
258
|
+
export declare function openRaccoonAuthorizePage(url: string): void;
|
|
259
|
+
/** 换码的结果。 */
|
|
260
|
+
export interface RaccoonAuthorizeExchange {
|
|
261
|
+
/** 是否换到了可用的一对凭据。 */
|
|
262
|
+
ok: boolean;
|
|
263
|
+
/** 拒绝的原因词(**没有**报文原文:报文可能回显那枚 code)。 */
|
|
264
|
+
reason?: 'code_not_found' | 'session_dead' | 'server_error' | 'network' | 'invalid_response' | 'refresh_missing' | 'token_invalid';
|
|
265
|
+
/** 换到的凭据(仅 `ok` 时存在)。 */
|
|
266
|
+
credential?: RaccoonCredential;
|
|
267
|
+
}
|
|
268
|
+
/**
|
|
269
|
+
* 用一次性授权码换凭据。
|
|
270
|
+
*
|
|
271
|
+
* 请求形状与官方**逐字节相同**:`POST {authApi}/login_with_authorization_code`,
|
|
272
|
+
* 只带一个 `Content-Type` 头,body 是 `{ authorization_code }`。
|
|
273
|
+
* 网关的 web-auth 这一族用的是**数字** `code === 0` 信封。
|
|
274
|
+
*
|
|
275
|
+
* ## 成功门(官方的那道门,逐字重述)
|
|
276
|
+
*
|
|
277
|
+
* 必须有 `access_token`,**并且**满足**二者之一**:
|
|
278
|
+
*
|
|
279
|
+
* - 一枚**有效**的 IAM 令牌(官方规则:同一 issuer + 非空 `sub` + 未来的
|
|
280
|
+
* `exp`)—— 这一半**不要求**带 refresh;
|
|
281
|
+
* - 或一枚 refresh token(legacy 那一对)。
|
|
282
|
+
*
|
|
283
|
+
* 差一点就是**拒绝 + 具名原因**,**绝不**产出半截凭据(存下半个凭据 = 存下
|
|
284
|
+
* 一个轮换之后什么都不剩的东西)。
|
|
285
|
+
*
|
|
286
|
+
* ⚠️ 上面第一半(IAM 令牌)**不要求** refresh ⇒ 那种凭据落库后
|
|
287
|
+
* `isRaccoonRefreshable()`(`src/raccoon.ts`)为 **false**,账号**不可静默续期**:
|
|
288
|
+
* 续期调度器跳过它(`src/raccoon-auth.ts` 的 `if (!entry.refreshable) continue`),
|
|
289
|
+
* 而推理侧遇到 401/403 时 `refresh()` 会**在发任何网络请求之前**抛
|
|
290
|
+
* `RefreshTokenExpiredError('凭据缺少 refresh_token,请重新登录')`。
|
|
291
|
+
* 这是**有意的**(官方规则如此,且行为诚实、不白烧凭据),但后果用户可见:
|
|
292
|
+
* **到期后必须重新登录**。
|
|
293
|
+
*
|
|
294
|
+
* @param code - 一次性授权码(最多换一次;上游会对重放回 400)。
|
|
295
|
+
* @param options
|
|
296
|
+
* @param options.product - 产品配置(默认 {@link RACCOON})。
|
|
297
|
+
* @param options.fetcher - 注入的 fetch(测试用)。
|
|
298
|
+
* @param options.authApiBase - 换码端点前缀(默认取 `product`)。
|
|
299
|
+
* @param options.iamIssuer - IAM 令牌必须带的 `iss`(默认 {@link RACCOON_IAM_ISSUER})。
|
|
300
|
+
* @param options.signal - 调用方自带的取消信号(缺省时用请求超时)。
|
|
301
|
+
* @returns 换码结果。
|
|
302
|
+
*/
|
|
303
|
+
export declare function exchangeRaccoonAuthorizationCode(code: unknown, options?: {
|
|
304
|
+
product?: RaccoonProduct;
|
|
305
|
+
fetcher?: typeof fetch;
|
|
306
|
+
authApiBase?: unknown;
|
|
307
|
+
iamIssuer?: unknown;
|
|
308
|
+
/** 调用方自带的取消信号(缺省时挂 {@link RACCOON_REQUEST_TIMEOUT_MS} 的截止时间)。 */
|
|
309
|
+
signal?: AbortSignal;
|
|
310
|
+
}): Promise<RaccoonAuthorizeExchange>;
|
|
311
|
+
//# sourceMappingURL=raccoon-authorize.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"raccoon-authorize.d.ts","sourceRoot":"","sources":["../src/raccoon-authorize.ts"],"names":[],"mappings":"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"}
|