@xixka/dsh-hub 0.2.1-rc.8 → 0.2.2

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.
Files changed (355) hide show
  1. package/README.md +60 -854
  2. package/lib/accio-adapter.d.ts.map +1 -1
  3. package/lib/accio-adapter.js +3 -1
  4. package/lib/accio-adapter.js.map +1 -1
  5. package/lib/account-pool.d.ts +162 -1
  6. package/lib/account-pool.d.ts.map +1 -1
  7. package/lib/account-pool.js +322 -15
  8. package/lib/account-pool.js.map +1 -1
  9. package/lib/aggregate-adapter.d.ts +38 -0
  10. package/lib/aggregate-adapter.d.ts.map +1 -1
  11. package/lib/aggregate-adapter.js +145 -12
  12. package/lib/aggregate-adapter.js.map +1 -1
  13. package/lib/aggregate-expiry.d.ts.map +1 -1
  14. package/lib/aggregate-expiry.js +4 -0
  15. package/lib/aggregate-expiry.js.map +1 -1
  16. package/lib/analyze-image.d.ts.map +1 -1
  17. package/lib/analyze-image.js.map +1 -1
  18. package/lib/astudio-adapter.d.ts.map +1 -1
  19. package/lib/astudio-adapter.js +3 -1
  20. package/lib/astudio-adapter.js.map +1 -1
  21. package/lib/buddy-adapter.d.ts.map +1 -1
  22. package/lib/buddy-adapter.js +22 -4
  23. package/lib/buddy-adapter.js.map +1 -1
  24. package/lib/buddy.d.ts +7 -2
  25. package/lib/buddy.d.ts.map +1 -1
  26. package/lib/buddy.js +7 -2
  27. package/lib/buddy.js.map +1 -1
  28. package/lib/canonical-models.d.ts.map +1 -1
  29. package/lib/canonical-models.js +20 -0
  30. package/lib/canonical-models.js.map +1 -1
  31. package/lib/chromium-session.d.ts +174 -0
  32. package/lib/chromium-session.d.ts.map +1 -1
  33. package/lib/chromium-session.js +418 -1
  34. package/lib/chromium-session.js.map +1 -1
  35. package/lib/client/jet-hub.js +287 -13303
  36. package/lib/codearts-credits.d.ts +123 -13
  37. package/lib/codearts-credits.d.ts.map +1 -1
  38. package/lib/codearts-credits.js +168 -25
  39. package/lib/codearts-credits.js.map +1 -1
  40. package/lib/codearts-vision.d.ts +95 -4
  41. package/lib/codearts-vision.d.ts.map +1 -1
  42. package/lib/codearts-vision.js +136 -5
  43. package/lib/codearts-vision.js.map +1 -1
  44. package/lib/codely-adapter.d.ts +36 -3
  45. package/lib/codely-adapter.d.ts.map +1 -1
  46. package/lib/codely-adapter.js +252 -11
  47. package/lib/codely-adapter.js.map +1 -1
  48. package/lib/codely-auth-service.d.ts +17 -0
  49. package/lib/codely-auth-service.d.ts.map +1 -1
  50. package/lib/codely-auth-service.js +40 -3
  51. package/lib/codely-auth-service.js.map +1 -1
  52. package/lib/codely-auth.d.ts.map +1 -1
  53. package/lib/codely-auth.js +23 -0
  54. package/lib/codely-auth.js.map +1 -1
  55. package/lib/codely-credits.d.ts.map +1 -1
  56. package/lib/codely-credits.js +18 -1
  57. package/lib/codely-credits.js.map +1 -1
  58. package/lib/codely-product.d.ts +10 -5
  59. package/lib/codely-product.d.ts.map +1 -1
  60. package/lib/codely-product.js +4 -2
  61. package/lib/codely-product.js.map +1 -1
  62. package/lib/credential-resolver.d.ts +41 -1
  63. package/lib/credential-resolver.d.ts.map +1 -1
  64. package/lib/credential-resolver.js +31 -6
  65. package/lib/credential-resolver.js.map +1 -1
  66. package/lib/image-budget.d.ts +3 -11
  67. package/lib/image-budget.d.ts.map +1 -1
  68. package/lib/image-budget.js +43 -5
  69. package/lib/image-budget.js.map +1 -1
  70. package/lib/image-data-cache.d.ts +87 -0
  71. package/lib/image-data-cache.d.ts.map +1 -0
  72. package/lib/image-data-cache.js +144 -0
  73. package/lib/image-data-cache.js.map +1 -0
  74. package/lib/index.d.ts +0 -51
  75. package/lib/index.d.ts.map +1 -1
  76. package/lib/index.js +290 -164
  77. package/lib/index.js.map +1 -1
  78. package/lib/jet-hub-rpc.d.ts +14 -17
  79. package/lib/jet-hub-rpc.d.ts.map +1 -1
  80. package/lib/jet-hub-rpc.js +812 -328
  81. package/lib/jet-hub-rpc.js.map +1 -1
  82. package/lib/jet-hub-store.d.ts +74 -1
  83. package/lib/jet-hub-store.d.ts.map +1 -1
  84. package/lib/jet-hub-store.js +72 -4
  85. package/lib/jet-hub-store.js.map +1 -1
  86. package/lib/llm-adapter.d.ts +96 -5
  87. package/lib/llm-adapter.d.ts.map +1 -1
  88. package/lib/llm-adapter.js +742 -62
  89. package/lib/llm-adapter.js.map +1 -1
  90. package/lib/lobsterai-adapter.d.ts.map +1 -1
  91. package/lib/lobsterai-adapter.js +54 -15
  92. package/lib/lobsterai-adapter.js.map +1 -1
  93. package/lib/login.d.ts +5 -13
  94. package/lib/login.d.ts.map +1 -1
  95. package/lib/login.js +75 -14
  96. package/lib/login.js.map +1 -1
  97. package/lib/loomy-adapter.d.ts +3 -0
  98. package/lib/loomy-adapter.d.ts.map +1 -1
  99. package/lib/loomy-adapter.js +11 -3
  100. package/lib/loomy-adapter.js.map +1 -1
  101. package/lib/loomy-auth.d.ts +51 -0
  102. package/lib/loomy-auth.d.ts.map +1 -1
  103. package/lib/loomy-auth.js +149 -2
  104. package/lib/loomy-auth.js.map +1 -1
  105. package/lib/loomy-oauth.d.ts +44 -0
  106. package/lib/loomy-oauth.d.ts.map +1 -1
  107. package/lib/loomy-oauth.js +48 -1
  108. package/lib/loomy-oauth.js.map +1 -1
  109. package/lib/loomy-sms-login.d.ts +61 -0
  110. package/lib/loomy-sms-login.d.ts.map +1 -0
  111. package/lib/loomy-sms-login.js +330 -0
  112. package/lib/loomy-sms-login.js.map +1 -0
  113. package/lib/loomy.d.ts +22 -0
  114. package/lib/loomy.d.ts.map +1 -1
  115. package/lib/loomy.js +10 -0
  116. package/lib/loomy.js.map +1 -1
  117. package/lib/magicrew-adapter.d.ts +201 -0
  118. package/lib/magicrew-adapter.d.ts.map +1 -0
  119. package/lib/magicrew-adapter.js +595 -0
  120. package/lib/magicrew-adapter.js.map +1 -0
  121. package/lib/magicrew-auth.d.ts +494 -0
  122. package/lib/magicrew-auth.d.ts.map +1 -0
  123. package/lib/magicrew-auth.js +951 -0
  124. package/lib/magicrew-auth.js.map +1 -0
  125. package/lib/magicrew-browser-login.d.ts +333 -0
  126. package/lib/magicrew-browser-login.d.ts.map +1 -0
  127. package/lib/magicrew-browser-login.js +740 -0
  128. package/lib/magicrew-browser-login.js.map +1 -0
  129. package/lib/magicrew-catalog.d.ts +19 -0
  130. package/lib/magicrew-catalog.d.ts.map +1 -0
  131. package/lib/magicrew-catalog.js +80 -0
  132. package/lib/magicrew-catalog.js.map +1 -0
  133. package/lib/magicrew-credits.d.ts +112 -0
  134. package/lib/magicrew-credits.d.ts.map +1 -0
  135. package/lib/magicrew-credits.js +319 -0
  136. package/lib/magicrew-credits.js.map +1 -0
  137. package/lib/magicrew-local-browser.d.ts +123 -0
  138. package/lib/magicrew-local-browser.d.ts.map +1 -0
  139. package/lib/magicrew-local-browser.js +321 -0
  140. package/lib/magicrew-local-browser.js.map +1 -0
  141. package/lib/magicrew-product.d.ts +127 -0
  142. package/lib/magicrew-product.d.ts.map +1 -0
  143. package/lib/magicrew-product.js +159 -0
  144. package/lib/magicrew-product.js.map +1 -0
  145. package/lib/magicrew-profile.d.ts +74 -0
  146. package/lib/magicrew-profile.d.ts.map +1 -0
  147. package/lib/magicrew-profile.js +148 -0
  148. package/lib/magicrew-profile.js.map +1 -0
  149. package/lib/magicrew.d.ts +185 -0
  150. package/lib/magicrew.d.ts.map +1 -0
  151. package/lib/magicrew.js +215 -0
  152. package/lib/magicrew.js.map +1 -0
  153. package/lib/model-catalog.d.ts +8 -0
  154. package/lib/model-catalog.d.ts.map +1 -1
  155. package/lib/model-catalog.js +127 -5
  156. package/lib/model-catalog.js.map +1 -1
  157. package/lib/models.d.ts +216 -32
  158. package/lib/models.d.ts.map +1 -1
  159. package/lib/models.js +500 -47
  160. package/lib/models.js.map +1 -1
  161. package/lib/modelscope-adapter.d.ts.map +1 -1
  162. package/lib/modelscope-adapter.js +7 -2
  163. package/lib/modelscope-adapter.js.map +1 -1
  164. package/lib/modelscope-product.d.ts +44 -6
  165. package/lib/modelscope-product.d.ts.map +1 -1
  166. package/lib/modelscope-product.js +98 -9
  167. package/lib/modelscope-product.js.map +1 -1
  168. package/lib/officeace-adapter.d.ts.map +1 -1
  169. package/lib/officeace-adapter.js +147 -21
  170. package/lib/officeace-adapter.js.map +1 -1
  171. package/lib/officeace-auth.d.ts +15 -0
  172. package/lib/officeace-auth.d.ts.map +1 -1
  173. package/lib/officeace-auth.js +99 -2
  174. package/lib/officeace-auth.js.map +1 -1
  175. package/lib/openai-gateway/tencent-fingerprint.d.ts.map +1 -1
  176. package/lib/openai-gateway/tencent-fingerprint.js +28 -3
  177. package/lib/openai-gateway/tencent-fingerprint.js.map +1 -1
  178. package/lib/opencode-adapter.d.ts +27 -0
  179. package/lib/opencode-adapter.d.ts.map +1 -1
  180. package/lib/opencode-adapter.js +57 -8
  181. package/lib/opencode-adapter.js.map +1 -1
  182. package/lib/opencode-bun-tls.d.ts +103 -0
  183. package/lib/opencode-bun-tls.d.ts.map +1 -0
  184. package/lib/opencode-bun-tls.js +212 -0
  185. package/lib/opencode-bun-tls.js.map +1 -0
  186. package/lib/opencode-messages.d.ts +0 -19
  187. package/lib/opencode-messages.d.ts.map +1 -1
  188. package/lib/opencode-messages.js +30 -33
  189. package/lib/opencode-messages.js.map +1 -1
  190. package/lib/opencode-official-prompt.d.ts +62 -0
  191. package/lib/opencode-official-prompt.d.ts.map +1 -0
  192. package/lib/opencode-official-prompt.js +119 -0
  193. package/lib/opencode-official-prompt.js.map +1 -0
  194. package/lib/opencode-official-tools.d.ts +27 -0
  195. package/lib/opencode-official-tools.d.ts.map +1 -0
  196. package/lib/opencode-official-tools.js +340 -0
  197. package/lib/opencode-official-tools.js.map +1 -0
  198. package/lib/opencode-product.d.ts.map +1 -1
  199. package/lib/opencode-product.js +3 -2
  200. package/lib/opencode-product.js.map +1 -1
  201. package/lib/opencode-stream.d.ts.map +1 -1
  202. package/lib/opencode-stream.js +8 -7
  203. package/lib/opencode-stream.js.map +1 -1
  204. package/lib/product.d.ts +15 -3
  205. package/lib/product.d.ts.map +1 -1
  206. package/lib/product.js +44 -11
  207. package/lib/product.js.map +1 -1
  208. package/lib/provider-credits.d.ts +2 -0
  209. package/lib/provider-credits.d.ts.map +1 -1
  210. package/lib/provider-credits.js +46 -17
  211. package/lib/provider-credits.js.map +1 -1
  212. package/lib/provider-expiry.d.ts.map +1 -1
  213. package/lib/provider-expiry.js +29 -0
  214. package/lib/provider-expiry.js.map +1 -1
  215. package/lib/provider-http-pool.d.ts +85 -0
  216. package/lib/provider-http-pool.d.ts.map +1 -0
  217. package/lib/provider-http-pool.js +224 -0
  218. package/lib/provider-http-pool.js.map +1 -0
  219. package/lib/provider-registry.d.ts.map +1 -1
  220. package/lib/provider-registry.js +73 -39
  221. package/lib/provider-registry.js.map +1 -1
  222. package/lib/qiniu-adapter.d.ts +276 -0
  223. package/lib/qiniu-adapter.d.ts.map +1 -0
  224. package/lib/qiniu-adapter.js +689 -0
  225. package/lib/qiniu-adapter.js.map +1 -0
  226. package/lib/qiniu-auth.d.ts +130 -0
  227. package/lib/qiniu-auth.d.ts.map +1 -0
  228. package/lib/qiniu-auth.js +234 -0
  229. package/lib/qiniu-auth.js.map +1 -0
  230. package/lib/qiniu-messages.d.ts +96 -0
  231. package/lib/qiniu-messages.d.ts.map +1 -0
  232. package/lib/qiniu-messages.js +97 -0
  233. package/lib/qiniu-messages.js.map +1 -0
  234. package/lib/qiniu-product.d.ts +126 -0
  235. package/lib/qiniu-product.d.ts.map +1 -0
  236. package/lib/qiniu-product.js +269 -0
  237. package/lib/qiniu-product.js.map +1 -0
  238. package/lib/qiniu-rpc.d.ts +119 -0
  239. package/lib/qiniu-rpc.d.ts.map +1 -0
  240. package/lib/qiniu-rpc.js +214 -0
  241. package/lib/qiniu-rpc.js.map +1 -0
  242. package/lib/qiniu.d.ts +145 -0
  243. package/lib/qiniu.d.ts.map +1 -0
  244. package/lib/qiniu.js +164 -0
  245. package/lib/qiniu.js.map +1 -0
  246. package/lib/raccoon-adapter.d.ts +18 -2
  247. package/lib/raccoon-adapter.d.ts.map +1 -1
  248. package/lib/raccoon-adapter.js +154 -21
  249. package/lib/raccoon-adapter.js.map +1 -1
  250. package/lib/raccoon-auth.d.ts +6 -0
  251. package/lib/raccoon-auth.d.ts.map +1 -1
  252. package/lib/raccoon-auth.js +9 -1
  253. package/lib/raccoon-auth.js.map +1 -1
  254. package/lib/raccoon-credits.d.ts +38 -5
  255. package/lib/raccoon-credits.d.ts.map +1 -1
  256. package/lib/raccoon-credits.js +127 -6
  257. package/lib/raccoon-credits.js.map +1 -1
  258. package/lib/raccoon.d.ts +14 -2
  259. package/lib/raccoon.d.ts.map +1 -1
  260. package/lib/raccoon.js +14 -2
  261. package/lib/raccoon.js.map +1 -1
  262. package/lib/service.d.ts +46 -6
  263. package/lib/service.d.ts.map +1 -1
  264. package/lib/service.js +104 -16
  265. package/lib/service.js.map +1 -1
  266. package/lib/session-balance.d.ts +203 -0
  267. package/lib/session-balance.d.ts.map +1 -0
  268. package/lib/session-balance.js +279 -0
  269. package/lib/session-balance.js.map +1 -0
  270. package/lib/sign.d.ts +97 -1
  271. package/lib/sign.d.ts.map +1 -1
  272. package/lib/sign.js +174 -2
  273. package/lib/sign.js.map +1 -1
  274. package/lib/token-ledger-store.d.ts.map +1 -1
  275. package/lib/token-ledger-store.js +121 -27
  276. package/lib/token-ledger-store.js.map +1 -1
  277. package/lib/trae-adapter.d.ts.map +1 -1
  278. package/lib/trae-adapter.js +3 -1
  279. package/lib/trae-adapter.js.map +1 -1
  280. package/lib/types.d.ts +165 -13
  281. package/lib/types.d.ts.map +1 -1
  282. package/lib/types.js.map +1 -1
  283. package/lib/usage-badge.d.ts +77 -7
  284. package/lib/usage-badge.d.ts.map +1 -1
  285. package/lib/usage-badge.js +190 -28
  286. package/lib/usage-badge.js.map +1 -1
  287. package/lib/webdav-auto-sync.d.ts +96 -0
  288. package/lib/webdav-auto-sync.d.ts.map +1 -0
  289. package/lib/webdav-auto-sync.js +0 -0
  290. package/lib/webdav-auto-sync.js.map +1 -0
  291. package/lib/webdav-sync-crypto.d.ts +18 -0
  292. package/lib/webdav-sync-crypto.d.ts.map +1 -0
  293. package/lib/webdav-sync-crypto.js +72 -0
  294. package/lib/webdav-sync-crypto.js.map +1 -0
  295. package/lib/webdav-sync-merge.d.ts +31 -0
  296. package/lib/webdav-sync-merge.d.ts.map +1 -0
  297. package/lib/webdav-sync-merge.js +0 -0
  298. package/lib/webdav-sync-merge.js.map +1 -0
  299. package/lib/webdav-sync.d.ts +155 -0
  300. package/lib/webdav-sync.d.ts.map +1 -0
  301. package/lib/webdav-sync.js +412 -0
  302. package/lib/webdav-sync.js.map +1 -0
  303. package/lib/zcode-adapter.d.ts +4 -2
  304. package/lib/zcode-adapter.d.ts.map +1 -1
  305. package/lib/zcode-adapter.js +132 -37
  306. package/lib/zcode-adapter.js.map +1 -1
  307. package/lib/zcode-upstream.d.ts +59 -0
  308. package/lib/zcode-upstream.d.ts.map +1 -1
  309. package/lib/zcode-upstream.js +137 -2
  310. package/lib/zcode-upstream.js.map +1 -1
  311. package/package.json +5 -4
  312. package/lib/stepcode-adapter.d.ts +0 -158
  313. package/lib/stepcode-adapter.d.ts.map +0 -1
  314. package/lib/stepcode-adapter.js +0 -318
  315. package/lib/stepcode-adapter.js.map +0 -1
  316. package/lib/stepcode-auth.d.ts +0 -154
  317. package/lib/stepcode-auth.d.ts.map +0 -1
  318. package/lib/stepcode-auth.js +0 -287
  319. package/lib/stepcode-auth.js.map +0 -1
  320. package/lib/stepcode-oauth.d.ts +0 -194
  321. package/lib/stepcode-oauth.d.ts.map +0 -1
  322. package/lib/stepcode-oauth.js +0 -496
  323. package/lib/stepcode-oauth.js.map +0 -1
  324. package/lib/stepcode-product.d.ts +0 -255
  325. package/lib/stepcode-product.d.ts.map +0 -1
  326. package/lib/stepcode-product.js +0 -256
  327. package/lib/stepcode-product.js.map +0 -1
  328. package/lib/stepcode.d.ts +0 -230
  329. package/lib/stepcode.d.ts.map +0 -1
  330. package/lib/stepcode.js +0 -300
  331. package/lib/stepcode.js.map +0 -1
  332. package/lib/teleagent-adapter.d.ts +0 -116
  333. package/lib/teleagent-adapter.d.ts.map +0 -1
  334. package/lib/teleagent-adapter.js +0 -293
  335. package/lib/teleagent-adapter.js.map +0 -1
  336. package/lib/teleagent-auth.d.ts +0 -279
  337. package/lib/teleagent-auth.d.ts.map +0 -1
  338. package/lib/teleagent-auth.js +0 -512
  339. package/lib/teleagent-auth.js.map +0 -1
  340. package/lib/teleagent-cdp-login.d.ts +0 -100
  341. package/lib/teleagent-cdp-login.d.ts.map +0 -1
  342. package/lib/teleagent-cdp-login.js +0 -402
  343. package/lib/teleagent-cdp-login.js.map +0 -1
  344. package/lib/teleagent-credits.d.ts +0 -120
  345. package/lib/teleagent-credits.d.ts.map +0 -1
  346. package/lib/teleagent-credits.js +0 -288
  347. package/lib/teleagent-credits.js.map +0 -1
  348. package/lib/teleagent-product.d.ts +0 -196
  349. package/lib/teleagent-product.d.ts.map +0 -1
  350. package/lib/teleagent-product.js +0 -212
  351. package/lib/teleagent-product.js.map +0 -1
  352. package/lib/teleagent.d.ts +0 -288
  353. package/lib/teleagent.d.ts.map +0 -1
  354. package/lib/teleagent.js +0 -450
  355. package/lib/teleagent.js.map +0 -1
@@ -0,0 +1,951 @@
1
+ /**
2
+ * Magicrew 的三层凭证与续期。
3
+ *
4
+ * ## 三层凭证(有效期完全不同,实测 2026-10-28)
5
+ *
6
+ * | 层 | 有效期 | 用途 | 续期方式 |
7
+ * |---|---|---|---|
8
+ * | 网页 JWT | 30 天 | 业务 API(目录/计费/积分) | 手机号+密码重登 |
9
+ * | `mgw_` api_key | **2 小时** | 模型网关(推理) | `PUT /tokens` |
10
+ * | refresh_token | 7 天,**一次性轮换** | 换 api_key | 同上,**必须串行** |
11
+ *
12
+ * ## ⚠️ 两条不能违反的规则(magpie 侧真实事故换来的,AGENTS.md 坑 #3 / #4)
13
+ *
14
+ * 1. **签新 key 会吊销旧 key** ⇒ 绝不在热路径上签发。只允许「登录」与「续期」两个入口。
15
+ * 2. **refresh_token 只能有一个出口** ⇒ 只允许本文件的 `refreshMagicrewKey` 持有,
16
+ * 别的模块不得自持第二份(分叉的后果是两处 token 不一致、用户莫名掉登录)。
17
+ */
18
+ import { createHash } from 'node:crypto';
19
+ import { Service } from '@deepseek-ai/cordis';
20
+ import { credentialRef } from '@deepseek-ai/dsh-credentials';
21
+ import { shouldRefreshNow } from './expiry-sync.js';
22
+ import { MAGICREW_BROWSER_LOGIN_TIMEOUT_MS, startMagicrewBrowserLogin, } from './magicrew-browser-login.js';
23
+ import { jwtTimes, readMagicrewLocalCreds } from './magicrew-local-browser.js';
24
+ import { fetchMagicrewProfile } from './magicrew-profile.js';
25
+ import { SerialQueue } from './serial-queue.js';
26
+ import { MAGICREW, MAGICREW_GATEWAY_TOKENS_PATH, } from './magicrew-product.js';
27
+ function readString(source, key) {
28
+ const value = source[key];
29
+ return typeof value === 'string' && value.length > 0 ? value : undefined;
30
+ }
31
+ function readNumber(source, key) {
32
+ const value = source[key];
33
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
34
+ }
35
+ /**
36
+ * 把账号池里的 `unknown` 收窄成 {@link MagicrewCredential}。
37
+ *
38
+ * 判据:**`jwt` 是唯一必需字段**(业务 API 全靠它;api_key 缺失可由 refresh_token 救回,
39
+ * 而 jwt 缺失意味着连目录都拉不到)⇒ 此时返回 `undefined`(账号不可用)。
40
+ */
41
+ export function parseMagicrewCredential(raw) {
42
+ if (typeof raw !== 'object' || raw === null)
43
+ return undefined;
44
+ const source = raw;
45
+ const jwt = readString(source, 'jwt');
46
+ if (jwt === undefined)
47
+ return undefined;
48
+ const apiKey = readString(source, 'apiKey');
49
+ const refreshToken = readString(source, 'refreshToken');
50
+ const phone = readString(source, 'phone');
51
+ const apiKeyExpiresAt = readNumber(source, 'apiKeyExpiresAt');
52
+ const refreshTokenExpiresAt = readNumber(source, 'refreshTokenExpiresAt');
53
+ // ⚠️ `nickname` 必须过 parse:卡片的展示名可以来自**刚落库的返回值**(那条路
54
+ // 不经过本函数),但任何「从凭据库读回来再展示」的路径都经过它 —— 漏掉这一行
55
+ // 会让重启后的卡片**又变回**「超级麦吉」(而登录那一刻是对的,极难归因)。
56
+ const nickname = readString(source, 'nickname');
57
+ return {
58
+ jwt,
59
+ organizationCode: readString(source, 'organizationCode') ?? '',
60
+ ...apiKey === undefined ? {} : { apiKey },
61
+ ...apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt },
62
+ ...refreshToken === undefined ? {} : { refreshToken },
63
+ ...refreshTokenExpiresAt === undefined ? {} : { refreshTokenExpiresAt },
64
+ ...phone === undefined ? {} : { phone },
65
+ ...nickname === undefined ? {} : { nickname },
66
+ };
67
+ }
68
+ /**
69
+ * 凭据指纹(**按 jwt 算**)—— 用于「同一账号是否已存在」的判重。
70
+ *
71
+ * ⚠️ 不能用 `apiKey`:它 2 小时一换,会把同一个账号认成新账号。
72
+ * jwt 的 payload 在 30 天内稳定(`refresh` 不改它)。
73
+ */
74
+ export function magicrewCredentialFingerprint(jwt) {
75
+ if (typeof jwt !== 'string' || jwt.length === 0)
76
+ return '';
77
+ return createHash('sha256').update(jwt).digest('hex').slice(0, 16);
78
+ }
79
+ /**
80
+ * 展示昵称:**上游昵称 → 手机号脱敏(`130****2222`) → 渠道名**。
81
+ *
82
+ * ## ⚠️ 优先级为什么是这个顺序(真机报障 2026-10-29)
83
+ *
84
+ * 原先只有后两条腿,而**浏览器登录**(本机浏览器导入 / 网页版登录)落库的凭据里
85
+ * **没有 `phone`** ⇒ 卡片恒显示 `product.displayName`(=「超级麦吉」),
86
+ * 而用户自己的昵称是 `Nick`(上游 `/api/v1/contact/accounts/me/users` 实测返回)。
87
+ * ⇒ 登录时把昵称写进凭据({@link MagicrewAuthOptions.profileFetcher}),这里优先用它。
88
+ *
89
+ * ## ⚠️⚠️ 向后兼容是硬约束:老凭据(无 `nickname`)必须逐字节不变
90
+ *
91
+ * 老凭据没有 `nickname` ⇒ 第一腿不成立,后两腿的判据与顺序**一字未改**:
92
+ * 11 位手机号仍出脱敏号、其余仍回落 `displayName`。这个「老凭据」格是本次改动
93
+ * 最重要的用例(改坏它 = 所有存量账号的卡片一起变样)。
94
+ *
95
+ * ⚠️ 昵称判据用 `trim()` 只为**判空**(全空白不算昵称),返回值**原样**给出去 ——
96
+ * 上游昵称里的空格是上游的事,展示层不替它改写。
97
+ */
98
+ export function magicrewDisplayNickname(credential, product = MAGICREW) {
99
+ const nickname = credential.nickname;
100
+ if (nickname !== undefined && nickname.trim().length > 0)
101
+ return nickname;
102
+ const phone = credential.phone;
103
+ if (phone !== undefined && /^\d{11}$/.test(phone)) {
104
+ return `${phone.slice(0, 3)}****${phone.slice(7)}`;
105
+ }
106
+ return product.displayName;
107
+ }
108
+ /**
109
+ * 账号卡片上「有效期」该取哪个时刻(`undefined` = 如实显示「未知」)。
110
+ *
111
+ * ## 判据
112
+ *
113
+ * 1. `apiKeyExpiresAt` 有值 ⇒ 用它(精确,且续期成功后被不断刷新);
114
+ * 2. 否则用 **JWT 的 `exp`**(本家**登录会话**的寿命,实测 30 天、可离线解出);
115
+ * 3. 都拿不到 ⇒ `undefined`(**不编造** —— 卡片如实显示「未知」,不写 0/NaN)。
116
+ *
117
+ * ## ⚠️⚠️ 为什么不能只取 `apiKeyExpiresAt`(真机报障:卡片「有效期 未知」)
118
+ *
119
+ * `mgw_` key 只有 **2 小时**且会自动续期,而**浏览器登录**落库的凭据里
120
+ * **根本没有 `apiKeyExpiresAt` 这个字段**(实测 `~/.dsh/.credentials.yaml` 只有
121
+ * `apiKey`/`jwt`/`organizationCode`/`refreshToken`)⇒ `account.create` 写池时那一格
122
+ * 是 `{}` ⇒ 卡片恒显示「未知」。
123
+ *
124
+ * ⚠️ 反过来也不能只用 JWT exp:JWT 过期(30 天)之后 `refresh_token` 仍可能有效,
125
+ * `apiKeyExpiresAt` 是「更近的真相」⇒ 两条腿**各管一段**,顺序不能换。
126
+ *
127
+ * ⚠️ JWT 解不出来时 `jwtTimes` 返回 `exp = 0`(**不猜**)⇒ 这里同样返回 `undefined`。
128
+ */
129
+ export function magicrewExpiresAtMs(credential) {
130
+ if (credential.apiKeyExpiresAt !== undefined)
131
+ return credential.apiKeyExpiresAt;
132
+ const { exp } = jwtTimes(credential.jwt);
133
+ return exp > 0 ? exp * 1000 : undefined;
134
+ }
135
+ // ── 登录与三层凭证的签发 / 续期 ──────────────────────────────────────────
136
+ //
137
+ // 本节只做**网络层**:登录换 JWT、JWT 签 `mgw_` key、refresh_token 换 key。
138
+ // 账号池侧(串行续期、写回 `expiresAt`)在文件末尾的「账号池适配层」一节(任务 3b),
139
+ // **不要**并进本节的网络层 —— 那一层是有状态的,混进来会让「纯网络原语」不再可复用。
140
+ /** 上游业务码:`1000` = ok,其余都是错误(magpie 侧实测,2026-10-28)。 */
141
+ const MAGICREW_OK_CODE = 1000;
142
+ /**
143
+ * 取账号资料(昵称)的**小超时**:6 秒。
144
+ *
145
+ * ⚠️⚠️ 这个值刻意**远短于** `product.requestTimeoutMs`(30 秒,业务 API 口径):
146
+ * 资料只用来给卡片取个昵称,而它挂在**登录**这条用户正盯着屏幕等的路径上 ——
147
+ * 30 秒的静默等待与「点了登录没反应」同形。
148
+ *
149
+ * 兑现方式:调用方把 `product.requestTimeoutMs` **换成这个值**再交给
150
+ * `fetchMagicrewProfile`(它的 `AbortSignal.timeout(product.requestTimeoutMs)` 是
151
+ * 唯一超时出口,不为「小超时」另开一个参数 —— 两处超时门是漂移源)。
152
+ */
153
+ export const MAGICREW_PROFILE_TIMEOUT_MS = 6_000;
154
+ /** 上游 UA(缺了偶发 403;与 magpie 侧逐字一致)。 */
155
+ const MAGICREW_USER_AGENT = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 '
156
+ + '(KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36';
157
+ /**
158
+ * 发一次请求并剥掉业务信封。
159
+ *
160
+ * ⚠️⚠️ **必须看业务码,不能只看 HTTP 状态**:实测用错配的 key 会得到
161
+ * **HTTP 200 + `{"code":403,"message":"token无效"}`** —— 错误藏在 body 里,
162
+ * 只判 `res.ok` 会把这次失败当成功,症状是「模型不回复」而日志零报错。
163
+ *
164
+ * ⚠️ 判据顺序是**刻意**的(先解析 → 再业务码 → 最后 HTTP 状态):
165
+ * 业务码优先于 HTTP 状态,否则 `200 + code:403` 这一格永远不会走到业务码那条腿。
166
+ * 反过来「HTTP 500 + 非 JSON」也不会被误判成业务错误 —— 它在第一步就带着
167
+ * HTTP 状态抛出可读报文(国际站实测:缺 `organization-code` 回 **22 字节裸文本**,
168
+ * 不是 JSON,极易被误读成「网关挂了」)。
169
+ *
170
+ * ⚠️ 响应体**没有** `code` 键时视为「无信封」(例如裸 200 的探测响应),
171
+ * 交给 `response.ok` 判 —— 不要凭「缺 code」直接判失败,那会把非信封端点全打死。
172
+ */
173
+ async function magicrewCall(params) {
174
+ const response = await params.fetchImpl(params.url, {
175
+ method: params.method,
176
+ headers: params.headers,
177
+ ...params.body === undefined ? {} : { body: params.body },
178
+ /**
179
+ * ⚠️ **超时必须有**(2026-10-29 最终审查 I5):本函数是**全部** auth 网络调用的
180
+ * 唯一出口(登录 / 签发 / 续期),原先零超时 ⇒ 一次挂死会让 `SerialQueue`
181
+ * 后排队的所有账号续期一起卡住(且它在 `refreshAll` 的 per-account try 之外
182
+ * 没有第二道闸)。其余每家 `*-credits.ts` 都有 `AbortSignal.timeout`。
183
+ * 用 `requestTimeoutMs`(业务 API 口径);**不要**用推理那三个超时。
184
+ */
185
+ signal: AbortSignal.timeout(MAGICREW.requestTimeoutMs),
186
+ });
187
+ const text = await response.text();
188
+ let parsed;
189
+ try {
190
+ parsed = text.length === 0 ? {} : JSON.parse(text);
191
+ }
192
+ catch {
193
+ throw new Error(`返回的不是 JSON(HTTP ${response.status}):${text.slice(0, 200)}`);
194
+ }
195
+ // ⚠️ `JSON.parse('null')` 是**合法 JSON**,`null` 上取 `.code` 会抛
196
+ // `TypeError: Cannot read properties of null` —— 对「网关回了字面量 null」这种
197
+ // 真实现象,原始报错既没有 HTTP 状态也没有上游原文,现场只剩一句 JS 内部错误。
198
+ if (typeof parsed !== 'object' || parsed === null) {
199
+ throw new Error(`返回的不是对象(HTTP ${response.status}):${text.slice(0, 200)}`);
200
+ }
201
+ const envelope = parsed;
202
+ const code = typeof envelope.code === 'number' ? envelope.code : undefined;
203
+ if (code !== undefined && code !== MAGICREW_OK_CODE) {
204
+ // ⚠️ 优先用上游原文:`token无效` 这类文案是 {@link isMagicrewApiKeyDeadError}
205
+ // 的唯一判据,包装成「请求失败(code 403)」会把它抹掉 ⇒ 续期永远不被触发。
206
+ const message = typeof envelope.message === 'string' ? envelope.message : `code ${code}`;
207
+ throw new Error(message);
208
+ }
209
+ if (!response.ok) {
210
+ throw new Error(`HTTP ${response.status}`);
211
+ }
212
+ return parsed;
213
+ }
214
+ /**
215
+ * 拼请求头。
216
+ *
217
+ * ⚠️ `origin` **必须**带(网关会看它,缺了偶发 403);`organization-code` 只在
218
+ * 有值时带(国内站不强制,国际站缺了回 HTTP 500)。
219
+ */
220
+ function magicrewHeaders(params) {
221
+ const headers = {
222
+ 'content-type': 'application/json',
223
+ accept: params.accept ?? 'application/json',
224
+ 'user-agent': params.userAgent ?? MAGICREW_USER_AGENT,
225
+ // 网关会看 Origin,缺了偶发 403(magpie 侧记录)。
226
+ origin: params.webOrigin,
227
+ };
228
+ if (params.token !== undefined && params.token.length > 0) {
229
+ headers.authorization = `Bearer ${params.token}`;
230
+ }
231
+ if (params.organizationCode !== undefined && params.organizationCode.length > 0) {
232
+ headers['organization-code'] = params.organizationCode;
233
+ }
234
+ return headers;
235
+ }
236
+ /**
237
+ * 把用户输入的手机号归一成上游要的**本地号码**(纯数字,不含国家码)。
238
+ *
239
+ * ⚠️⚠️ 上游 `phone` 字段必须是**本地号码**(带 `+86` 前缀会登录失败,实测),
240
+ * 国家码走独立的 `state_code`。而递进来的形态五花八门:
241
+ * `+86 130-1111-2222`、`130 1111 2222`、`8613011112222`。
242
+ *
243
+ * 只做「删非数字」会得到 `8613011112222`(13 位)—— 上游按本地号码解析 ⇒ 登录失败,
244
+ * 而错误文案只说「手机号格式错误」,看不出是插件多留了国家码。
245
+ *
246
+ * 判据(四条腿,每条都有独立用例钉住):
247
+ * 1. 删非数字后**以 `state_code` 的数字为前缀**(不是这个前缀就原样返回 ——
248
+ * 删掉这条会把 `13011112222` 按 `86` 切掉前两位,变成 `800138000`);
249
+ * 2. 剥完剩下的仍是完整号码(**≥ 6 位**)—— 挡住「短号恰好以国家码开头」;
250
+ * 3. **1 位国家码在没有显式 `+` 时不剥**:`+1` 这类单位数国家码与「本地号码首位」
251
+ * 在语法上不可区分(`1234567890` 是本地号,还是 `1` + `234567890`?)⇒ **不猜**,
252
+ * 宁可按本地号原样发(上游会明确报手机号格式错,可查),也不静默吃掉首位;
253
+ * 4. 显式写了 `+` 时国家码是用户明示的(`+1 415 555 2671`)⇒ 可以直接剥。
254
+ */
255
+ function magicrewPhoneOf(phone, stateCode) {
256
+ const text = String(phone ?? '').trim();
257
+ const digits = text.replace(/[^\d]/g, '');
258
+ const stateDigits = stateCode.replace(/[^\d]/g, '');
259
+ if (stateDigits.length === 0 || !digits.startsWith(stateDigits))
260
+ return digits;
261
+ const rest = digits.slice(stateDigits.length);
262
+ if (rest.length < 6)
263
+ return digits;
264
+ if (text.startsWith('+') || stateDigits.length >= 2)
265
+ return rest;
266
+ return digits;
267
+ }
268
+ /**
269
+ * 用登录 JWT 签发一把 `mgw_` key(2 小时)。
270
+ *
271
+ * ⚠️⚠️ **签新 key 会吊销旧 key**(magpie 坑 #3)⇒ 本函数**只允许**在
272
+ * 「登录成功」与「续期」两个入口调用,**绝不在热路径**(推理前)调用。
273
+ * 热路径上签一次,正在并发的另一次请求立刻拿到死 key(症状:偶发「token无效」,
274
+ * 而重试又能成 —— 极难复现的那种)。
275
+ */
276
+ export async function issueMagicrewGatewayKey(params) {
277
+ const product = params.product ?? MAGICREW;
278
+ const fetchImpl = params.fetchImpl ?? fetch;
279
+ const parsed = await magicrewCall({
280
+ url: `${product.host}${MAGICREW_GATEWAY_TOKENS_PATH}`,
281
+ method: 'POST',
282
+ headers: magicrewHeaders({
283
+ token: params.jwt,
284
+ organizationCode: params.organizationCode,
285
+ webOrigin: product.webOrigin,
286
+ }),
287
+ body: '{}',
288
+ fetchImpl,
289
+ });
290
+ const data = (parsed.data ?? {});
291
+ const apiKey = readString(data, 'api_key');
292
+ if (apiKey === undefined) {
293
+ throw new Error('签发密钥失败:没有 api_key');
294
+ }
295
+ const refreshToken = readString(data, 'refresh_token');
296
+ const apiKeyExpiresAt = readNumber(data, 'api_key_expires_at');
297
+ const refreshTokenExpiresAt = readNumber(data, 'refresh_token_expires_at');
298
+ return {
299
+ apiKey,
300
+ ...refreshToken === undefined ? {} : { refreshToken },
301
+ ...apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt },
302
+ ...refreshTokenExpiresAt === undefined ? {} : { refreshTokenExpiresAt },
303
+ };
304
+ }
305
+ /**
306
+ * 用 refresh_token 换新的 api_key。**不需要登录态**(JWT 过期也能续)。
307
+ *
308
+ * ⚠️⚠️ refresh_token 是**一次性**的(每换一次就轮换)⇒ 调用方**必须串行**,
309
+ * 并发两次会让其中一个的 token 立即失效(表现为「账号突然掉登录」,而重登又好了)。
310
+ *
311
+ * ⚠️ **本函数是全仓唯一持有 refresh_token 的地方**(magpie 坑 #4):
312
+ * 别处再存一份就会分叉。
313
+ */
314
+ export async function refreshMagicrewKey(params) {
315
+ const product = params.product ?? MAGICREW;
316
+ const fetchImpl = params.fetchImpl ?? fetch;
317
+ // ⚠️ 续期走 **PUT 且 body 只带 refresh_token**:带上 JWT 反而会在 JWT 过期时
318
+ // 把「能续的」变成「不能续的」(这条路径的存在意义就是 JWT 已经没用了)。
319
+ const parsed = await magicrewCall({
320
+ url: `${product.host}${MAGICREW_GATEWAY_TOKENS_PATH}`,
321
+ method: 'PUT',
322
+ headers: magicrewHeaders({ webOrigin: product.webOrigin }),
323
+ body: JSON.stringify({ refresh_token: params.refreshToken }),
324
+ fetchImpl,
325
+ });
326
+ const data = (parsed.data ?? {});
327
+ const apiKey = readString(data, 'api_key');
328
+ if (apiKey === undefined) {
329
+ throw new Error('续期失败:没有 api_key');
330
+ }
331
+ const refreshToken = readString(data, 'refresh_token');
332
+ const apiKeyExpiresAt = readNumber(data, 'api_key_expires_at');
333
+ return {
334
+ apiKey,
335
+ ...refreshToken === undefined ? {} : { refreshToken },
336
+ ...apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt },
337
+ };
338
+ }
339
+ /**
340
+ * 判断一个错误是否是「api_key 失效」(应当续期重试,而不是判账号死)。
341
+ *
342
+ * ⚠️ 只判**消息文本**:上游把鉴权失败装在业务码里(HTTP 200 + `code:403` +
343
+ * `message:"token无效"`)⇒ 状态码根本不是判据。
344
+ *
345
+ * ⚠️ **刻意不把 HTTP 401 / 403 塞进来**:那两类是**传输层**的失败(可能是网关抖动、
346
+ * 出口 IP 被拦、甚至 `organization-code` 错配),把它们当成「key 失效」会触发续期
347
+ * ⇒ 而续期**会吊销当前 key** ⇒ 一次误判就把本来能用的凭据烧掉。
348
+ */
349
+ export function isMagicrewApiKeyDeadError(error) {
350
+ const message = error instanceof Error ? error.message : String(error ?? '');
351
+ return /token无效|token invalid|unauthorized/i.test(message);
352
+ }
353
+ /**
354
+ * 一次性 refresh_token 的**串行续期器**。
355
+ *
356
+ * ⚠️⚠️ 为什么必须串行:refresh_token **一次性轮换**(每换一次就作废旧的)。
357
+ * 两个并发请求会拿同一个 token 去换 ⇒ 第二个必然失败,而**前一个已经把新 token
358
+ * 写回了** ⇒ 表面上「莫名掉登录」,实际是竞态。
359
+ *
360
+ * ⚠️ 这里刻意做成「共享同一个 state 对象」而不是闭包变量:调用方(`MagicrewAuth`)
361
+ * 持有那份 state,续期成功后**就地更新** `refreshToken`,下一轮才有得用。
362
+ *
363
+ * 并发到来时**后来的等前一个的结果**(而不是各发一次)—— `SerialQueue` 保证
364
+ * 「同一刻只有一个 PUT 在飞」,`inFlight` 保证**同一次续期只真发一次请求**。
365
+ *
366
+ * ⚠️⚠️ `inFlight` **必须按 `state` 分键**(`WeakMap`),不能是一个裸变量:
367
+ * 本实例由 `MagicrewAuth` 构造时**只创建一份**、被全部账号共用,裸变量会让
368
+ * 「账号 A 续期中、账号 B 同时要续期」变成**B 直接拿到 A 的新 key**
369
+ * (`fetch` 只发一次、B 的凭据被写成 A 的 `mgw_` 密钥 ⇒ 跨账号串号,
370
+ * 症状是 B 偶发「token无效」而 A 一切正常)。同一个 `state` 才该去重。
371
+ */
372
+ export function createMagicrewRefreshOnce(deps) {
373
+ const queue = new SerialQueue();
374
+ const inFlight = new WeakMap();
375
+ return async (state) => {
376
+ if (state.refreshToken === undefined || state.refreshToken.length === 0)
377
+ return undefined;
378
+ const pending = inFlight.get(state);
379
+ if (pending !== undefined)
380
+ return await pending;
381
+ const task = queue.run(async () => {
382
+ // ⚠️ token 必须读在**闭包内**(排队期间可能已被前一个任务轮换掉)。
383
+ const key = await refreshMagicrewKey({
384
+ refreshToken: state.refreshToken,
385
+ ...deps.product === undefined ? {} : { product: deps.product },
386
+ ...deps.fetchImpl === undefined ? {} : { fetchImpl: deps.fetchImpl },
387
+ });
388
+ // ⚠️ **就地写回**(成功才写):失败时保留旧 token,让下一次还有机会。
389
+ state.apiKey = key.apiKey;
390
+ if (key.apiKeyExpiresAt !== undefined)
391
+ state.apiKeyExpiresAt = key.apiKeyExpiresAt;
392
+ // ⚠️ 这里**不**登记 `staleRefreshToken`:marker 的语义是「凭据库里现在放着哪条
393
+ // 已被消费的 token」,只有**写回失败的那一刻**才知道(见其字段注释)。
394
+ if (key.refreshToken !== undefined)
395
+ state.refreshToken = key.refreshToken;
396
+ return key;
397
+ });
398
+ inFlight.set(state, task);
399
+ try {
400
+ return await task;
401
+ }
402
+ finally {
403
+ inFlight.delete(state);
404
+ }
405
+ };
406
+ }
407
+ /**
408
+ * 账号池侧的续期入口(`index.ts` 的 `auths.magicrew` 用它)。
409
+ *
410
+ * ## ⚠️ 四条铁律(照 `AstudioAuth` 的既有口径,全部来自真实事故)
411
+ *
412
+ * 1. **续期成功后必须把新 `expiresAt` 写回账号池** —— 否则凭据续好了、
413
+ * 界面纹丝不动,用户没有任何自救手段(issue !IKIRTT)。
414
+ * 2. **`refreshAll` 只按凭据材料过滤**:不看 `enabled`(停用只影响自动选号,
415
+ * 与「凭据该不该保持新鲜」无关 —— 按它过滤会让停用期间的 token 一路放到失效,
416
+ * 用户重新启用后拿到死凭据),也不看池里的 `refreshable`(那是**对账结果**,
417
+ * 拿它当门禁会把一次瞬时失败固化成**单向门**)。
418
+ * 3. **串行**:走 {@link createMagicrewRefreshOnce},不要自己 `await refreshMagicrewKey`。
419
+ * 4. ⚠️⚠️ **`refreshAll` 必须带 lead-time 过滤**(`shouldRefreshNow(apiKeyExpiresAt)`),
420
+ * 且**只有**这一层带:本家 `mgw_` key TTL 仅 **2 小时**、调度器 **30 分钟**一轮
421
+ * (`src/index.ts` 的 `REFRESH_INTERVAL_MS`),无条件续期等于每 2 小时窗口
422
+ * **白签 4 次**,而**签新 key 会吊销旧 key**(本文件头第 1 条硬约束)⇒ 轮换瞬间
423
+ * 在途的推理请求可能拿到刚被吊销的 key。其余轮换型 provider 同样走
424
+ * `src/expiry-sync.ts:112` 的 `shouldRefreshNow`。
425
+ * ⚠️ 但**不能**把它挪进 {@link refreshAccountCredential}:那是
426
+ * `account.refresh`(用户点了按钮就要刷)的入口 —— 加进去等于按钮变哑的。
427
+ * ⚠️ 唯一的例外是**写回失败态**(`MagicrewRefreshState.staleRefreshToken` 非空):
428
+ * 此时凭据库里的 `expiresAt` 是上一轮的陈旧值,按它判会把这个账号的自愈推迟到
429
+ * 库里那个时刻进入 lead 窗口(≤1 小时)⇒ `refreshAll` 对这类账号**跳过 lead-time 门**。
430
+ */
431
+ export class MagicrewAuth extends Service {
432
+ product;
433
+ fetchImpl;
434
+ warnImpl;
435
+ store;
436
+ /** 注入的浏览器 User Data 根目录(单测);`undefined` = 扫真实浏览器目录。 */
437
+ browserRoots;
438
+ /** 网页版登录的会话工厂(单测注入;缺省真起浏览器)。 */
439
+ browserLoginFactory;
440
+ /** 账号资料(昵称)取数器(单测注入;缺省真发一次 GET)。 */
441
+ profileFetcher;
442
+ refreshOnce;
443
+ /** 每账号一份在途状态(含最新 refresh_token)。 */
444
+ states = new Map();
445
+ /**
446
+ * 登录态是否活跃。`stop()` / `logout()` 置 false,**阻止在途续期回写**。
447
+ *
448
+ * ⚠️ 为什么必须有:续期是**异步**的(一次网络往返)。用户中途登出或插件被停用时,
449
+ * 那个在途请求回来若照常 `store.set` + `pool.updateAccount`,就会把凭据写回
450
+ * 一个**已被删除/已登出**的账号(症状:删了账号又「复活」,或登出后仍能调用)。
451
+ * 照 `astudio-auth.ts` 的同款(`:429` / `:926` / `:936`)。
452
+ */
453
+ active = true;
454
+ constructor(ctx, options = {}) {
455
+ const product = options.product ?? MAGICREW;
456
+ // ⚠️ 服务名 = `${product.id}Auth`(cordis 文档硬要求:id 同时是服务名)。
457
+ super(ctx, `${product.id}Auth`);
458
+ this.product = product;
459
+ this.fetchImpl = options.fetchImpl ?? fetch;
460
+ this.warnImpl = options.warn;
461
+ this.store = options.store;
462
+ this.browserRoots = options.browserRoots;
463
+ /**
464
+ * ⚠️ 缺省是真起浏览器 —— **不要**在这里塞一个「测试也安全」的假实现
465
+ * (那样生产路径就没有用例覆盖了;理由见选项上的注释)。
466
+ */
467
+ this.browserLoginFactory = options.browserLoginFactory
468
+ ?? ((loginOptions) => {
469
+ // ⚠️ 逐项展开而**不**整个传 `{product, timeoutMs}`:`startMagicrewBrowserLogin`
470
+ // 的选项里还有 `sessionFactory`,本层的 `loginOptions` 没有它(也不该有)。
471
+ return startMagicrewBrowserLogin({
472
+ ...loginOptions?.product === undefined ? {} : { product: loginOptions.product },
473
+ ...loginOptions?.timeoutMs === undefined ? {} : { timeoutMs: loginOptions.timeoutMs },
474
+ /**
475
+ * ⚠️⚠️ **必须**把诊断出口接进去(真机报障 2026-10-29):
476
+ * 超时时那一行「CDP 与磁盘都没读到凭据(CDP 尝试 N 次 / 最后一次失败原因:…)」
477
+ * 是下次报障时**唯一**能区分「用户没登」与「我们读的方式坏了」的东西。
478
+ * 不接 ⇒ `deps.log === undefined` ⇒ 那行**根本不会产生**(静默)。
479
+ *
480
+ * 走 `warn`(不是 `info`):它是「一次等待收口且没读到」,属于需要被看见的
481
+ * 诊断;本仓库既有出口里 `warnImpl` 也已有单测钉住「不许静默」。
482
+ */
483
+ log: (message) => {
484
+ if (this.warnImpl !== undefined)
485
+ this.warnImpl(message);
486
+ else
487
+ this.ctx.logger?.warn?.(message);
488
+ },
489
+ });
490
+ });
491
+ this.refreshOnce = createMagicrewRefreshOnce({
492
+ fetchImpl: this.fetchImpl,
493
+ product: this.product,
494
+ });
495
+ /**
496
+ * ⚠️ 缺省**真的去取**(理由见选项上的注释)。这里把 `product.requestTimeoutMs`
497
+ * 换成 {@link MAGICREW_PROFILE_TIMEOUT_MS}(6 秒)—— 它是这条腿**唯一**的超时门
498
+ * (`fetchMagicrewProfile` 内部只有 `AbortSignal.timeout(product.requestTimeoutMs)`
499
+ * 一个出口)。**不要**改成再传一个 `timeoutMs` 参数:两处超时会漂移。
500
+ */
501
+ this.profileFetcher = options.profileFetcher ?? (profileParams => fetchMagicrewProfile({
502
+ jwt: profileParams.jwt,
503
+ organizationCode: profileParams.organizationCode,
504
+ product: { ...profileParams.product, requestTimeoutMs: MAGICREW_PROFILE_TIMEOUT_MS },
505
+ fetchImpl: this.fetchImpl,
506
+ }));
507
+ }
508
+ /**
509
+ * 给凭据补上**上游昵称**(`credential.nickname`)。
510
+ *
511
+ * ## 调用时机:签发 gateway key **之后**
512
+ *
513
+ * 两条登录腿都在这之后调它。刻意放在签发那段的 `try/catch` **外面**:昵称只需要
514
+ * `jwt` + `organizationCode`,与「key 签发成功没有」无关 —— 放在里面会让
515
+ * 「签发失败(网关抖动)」顺带把昵称也丢掉,而那种情况下卡片本可以显示对的名字。
516
+ *
517
+ * ## ⚠️⚠️ 失败**不挡登录**,但**必须留痕**
518
+ *
519
+ * 昵称只是展示名:取不到时卡片回落「脱敏手机号 / 渠道名」,登录本身完全不受影响。
520
+ * 但**不许静默** —— 本仓库记过「静默停摆、功能上线起一次都没成功过」的教训
521
+ * (本文件里 `importFromLocalBrowser` / `loginViaBrowser` 的签发失败走同一条纪律)。
522
+ *
523
+ * ⚠️ 代价受 {@link MAGICREW_PROFILE_TIMEOUT_MS}(6 秒)约束,不给登录加长等待。
524
+ */
525
+ async withProfileNickname(credential) {
526
+ let profile;
527
+ try {
528
+ profile = await this.profileFetcher({
529
+ jwt: credential.jwt,
530
+ organizationCode: credential.organizationCode,
531
+ product: this.product,
532
+ });
533
+ }
534
+ catch (error) {
535
+ this.warn('[magicrew] 读取账号资料失败(卡片昵称回落为脱敏手机号 / 渠道名,不影响登录):'
536
+ + String(error));
537
+ return credential;
538
+ }
539
+ if (profile.nickname.trim().length === 0) {
540
+ // 「取到了资料、但里面没有昵称」也是一种**未达成**(卡片仍会显示渠道名)
541
+ // ⇒ 同样留痕,否则这一格与「压根没调」在日志里不可区分。
542
+ this.warn('[magicrew] 账号资料里没有昵称(卡片昵称回落为脱敏手机号 / 渠道名)');
543
+ return credential;
544
+ }
545
+ return { ...credential, nickname: profile.nickname };
546
+ }
547
+ /**
548
+ * 读本账号的**展示昵称** —— `account.list` 的自愈回填用(2026-10-30)。
549
+ *
550
+ * ## 为什么要有这个公开入口(而不是让 RPC 层直接调 `fetchMagicrewProfile`)
551
+ *
552
+ * ⚠️ 必须与登录走**同一个注入点**({@link MagicrewAuthOptions.profileFetcher}):
553
+ * ① 单测要能注入假取数器(否则「回填」那条腿只能真发网络 ⇒ 不可测);
554
+ * ② 超时与告警纪律只有这一份 —— 另起一条调用链必然与登录那条分叉
555
+ * (本仓库「一语义一套判据」的红线)。
556
+ *
557
+ * ⚠️ 读不到 ⇒ `undefined`,**不抛**:回填是尽力而为,调用方(`account.list`)
558
+ * 不该因为一个展示名取不到而让整个列表失败。
559
+ * ⚠️ 但仍然**留痕**(与 {@link withProfileNickname} 同一条纪律:不许静默 ——
560
+ * 本仓库记过「静默停摆、功能上线起一次都没成功过」的教训)。
561
+ */
562
+ async readProfileNickname(credential) {
563
+ if (credential.jwt.length === 0)
564
+ return undefined;
565
+ try {
566
+ const profile = await this.profileFetcher({
567
+ jwt: credential.jwt,
568
+ organizationCode: credential.organizationCode,
569
+ product: this.product,
570
+ });
571
+ const nickname = profile.nickname.trim();
572
+ if (nickname.length === 0) {
573
+ this.warn('[magicrew] 账号资料里没有昵称(卡片昵称回落为脱敏手机号 / 渠道名)');
574
+ return undefined;
575
+ }
576
+ return nickname;
577
+ }
578
+ catch (error) {
579
+ this.warn('[magicrew] 读取账号资料失败(卡片昵称回落为脱敏手机号 / 渠道名):' + String(error));
580
+ return undefined;
581
+ }
582
+ }
583
+ /** 告警出口(`warnImpl` 优先,否则宿主 logger)。 */
584
+ warn(message) {
585
+ if (this.warnImpl !== undefined)
586
+ this.warnImpl(message);
587
+ else
588
+ this.ctx.logger?.warn?.(message);
589
+ }
590
+ /**
591
+ * 续期**指定账号**并写回账号池。
592
+ *
593
+ * ⚠️ `pool` 与 `accountId` **必须都传**(issue !IKIRTT 的修法)。
594
+ */
595
+ async refreshAccountCredential(refName, pool, accountId) {
596
+ if (!this.active)
597
+ return;
598
+ const credential = await this.currentCredential(refName);
599
+ if (credential === undefined)
600
+ return;
601
+ const state = this.stateOf(refName, credential);
602
+ const key = await this.refreshOnce(state);
603
+ if (key === undefined)
604
+ return;
605
+ // ⚠️ **回来时再判一次**:`refreshOnce` 是一次网络往返,期间用户可能已登出。
606
+ // 不判就会把凭据写回一个已删除/已登出的账号。
607
+ if (!this.active)
608
+ return;
609
+ const next = {
610
+ ...credential,
611
+ apiKey: key.apiKey,
612
+ ...key.apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt: key.apiKeyExpiresAt },
613
+ ...state.refreshToken === undefined ? {} : { refreshToken: state.refreshToken },
614
+ };
615
+ // ⚠️ 序列化在这里做(宿主只收字符串)。
616
+ try {
617
+ await this.storeFor()?.set(credentialRef(refName), JSON.stringify(next));
618
+ // 写回成功 ⇒ 库里已是新 token,不存在「已消费但仍在库里」的值 ⇒ 清空 marker。
619
+ state.staleRefreshToken = undefined;
620
+ }
621
+ catch (error) {
622
+ // ⚠️⚠️ 写回**失败** ⇒ 库里仍然是刚被消费的那条旧 token(我们一个字节都没写进去)
623
+ // ⇒ 就地登记它,marker 由此**恒与库同步**(每次失败重新上膛、成功即清空)。
624
+ // 登记的是**本次调用开始时读到的库值**(`credential.refreshToken`),而不是
625
+ // 内存里那条新 token —— 后者上游还没见过,绝不能被后续 `stateOf` 跳过。
626
+ state.staleRefreshToken = credential.refreshToken;
627
+ throw error;
628
+ }
629
+ // ⚠️ 必须写回:凭据续好了但界面不更新等于没修(issue !IKIRTT)。
630
+ const expiresAt = key.apiKeyExpiresAt;
631
+ if (expiresAt !== undefined) {
632
+ await pool.updateAccount(accountId, { expiresAt });
633
+ }
634
+ }
635
+ /**
636
+ * 批量续期该 provider 的**全部账号**(`src/index.ts` 的定时器/首轮入口)。
637
+ *
638
+ * ⚠️ 过滤口径见类注释第 2、4 条:**不看** `enabled` / `refreshable`,
639
+ * **但要看 lead-time**(`shouldRefreshNow`)。
640
+ */
641
+ async refreshAll(pool) {
642
+ // ⚠⚠ **`listAccountsByProvider` 返回的是同步数组,不是 Promise** ——
643
+ // 不要 `await` 它(issue IKLPTZ:把它当 Promise 调 `.catch()` 会**恒抛 TypeError**,
644
+ // 被逐个 try 吞成一条 warn、界面零提示)。
645
+ // ⚠️ 判断必须**在循环之前**:写进循环里时 for...of 早已先抛错,判据永远轮不到。
646
+ const accounts = pool.listAccountsByProvider(this.product.id);
647
+ for (const account of accounts) {
648
+ const refName = account.credentialRef;
649
+ if (typeof refName !== 'string' || refName.length === 0)
650
+ continue;
651
+ try {
652
+ // ⚠️⚠️ **写回失败态必须绕开 lead-time 门**:此时凭据库里放的是**上一轮的**
653
+ // `expiresAt`(甚至是被刚吊销的旧 key),权威时刻只在内存
654
+ // (`state.apiKeyExpiresAt`)。若照常按库值判「远未到期」就会跳过 ⇒ 用死 key
655
+ // 一路失败到库里那个陈旧时刻进入 lead 窗口(≤1 小时),且池里 `expiresAt`
656
+ // 也没更新 ⇒ UI 仍显示有效,用户无从自救。
657
+ // marker 非空 = 这个账号正处在那个状态 ⇒ 必续。
658
+ if (this.states.get(refName)?.staleRefreshToken === undefined) {
659
+ // ⚠️⚠️ **lead-time 过滤**(类注释第 4 条):`shouldRefreshNow` 的语义是
660
+ // 「距过期 ≤1 小时 / 已过期 / 读不到到期时刻」才续。读不到**视为该续**
661
+ // (没有到期时刻的凭据不能放着烂掉)。判据用**凭据里的**时刻而非池里的
662
+ // `expiresAt`:池值可能因上一轮写回失败而陈旧(`expiry-sync.ts` 的既定口径)。
663
+ const credential = await this.currentCredential(refName);
664
+ if (credential !== undefined && !shouldRefreshNow(credential.apiKeyExpiresAt))
665
+ continue;
666
+ }
667
+ await this.refreshAccountCredential(refName, pool, account.id);
668
+ }
669
+ catch (error) {
670
+ // 单个账号失败不拖累其余账号。
671
+ console.warn(`[magicrew] 续期 ${refName} 失败:${String(error)}`);
672
+ }
673
+ }
674
+ }
675
+ /** 登出:置非活跃,**阻止在途续期回写**(否则会把凭据写回一个已删的账号)。 */
676
+ /**
677
+ * 从本机浏览器读取已登录的凭据(**不开窗口**)。读不到 ⇒ `undefined`。
678
+ *
679
+ * ## 为什么需要它
680
+ *
681
+ * magicrew 没有 OAuth 回调:用户在自己浏览器里登录成功后,插件**收不到任何通知**
682
+ * (那是另一个浏览器)。而凭据本来就明文躺在 Chromium 系的
683
+ * `<User Data>/<Default|Profile N>/Local Storage/leveldb/` 里
684
+ * ⇒ 直接读文件即可,既不用开窗口也不用让用户粘任何东西。
685
+ *
686
+ * ## 语义上这就是一次「登录」
687
+ *
688
+ * 读到 jwt 之后**签发一次 `mgw_` key**(与 {@link login} 同一条腿):不签的话
689
+ * 池里会出现一个「有账号、每请求都抛 `AUTH`」的幽灵条目(适配器缺 api_key 时
690
+ * 恒抛「账号未登录或缺少 api_key」),用户只会看到「明明导入成功却不回复」。
691
+ * 签发失败**不吞掉导入结果**(jwt 能拉目录 / 积分,api_key 可由续期或重登救回),
692
+ * 但**不许静默** —— 走 `warn`(与 {@link login} 一字不差的纪律)。
693
+ *
694
+ * ⚠️ 签新 key 会吊销旧 key 是本家硬约束(模块头第 1 条)。这里等同「重新登录」,
695
+ * 故仍在允许的范围内;但**不要在热路径上重试本方法**。
696
+ *
697
+ * ⚠️ 写回的 ref 是 {@link MagicrewProduct.defaultCredentialRef}(**不是**某个
698
+ * `MAGICREW_ACCOUNT_*`):账号 id / ref 由 `account.create` 分配,本方法只管
699
+ * 「把这台机器上已登录的那份凭据取回来并落库」。
700
+ */
701
+ async importFromLocalBrowser() {
702
+ const found = this.readLocalBrowserCreds();
703
+ if (found === undefined)
704
+ return undefined;
705
+ const base = {
706
+ jwt: found.jwt,
707
+ organizationCode: found.organizationCode,
708
+ };
709
+ let credential = base;
710
+ try {
711
+ const key = await issueMagicrewGatewayKey({
712
+ jwt: found.jwt,
713
+ organizationCode: found.organizationCode,
714
+ product: this.product,
715
+ fetchImpl: this.fetchImpl,
716
+ });
717
+ credential = {
718
+ ...base,
719
+ apiKey: key.apiKey,
720
+ ...key.apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt: key.apiKeyExpiresAt },
721
+ ...key.refreshToken === undefined ? {} : { refreshToken: key.refreshToken },
722
+ ...key.refreshTokenExpiresAt === undefined
723
+ ? {} : { refreshTokenExpiresAt: key.refreshTokenExpiresAt },
724
+ };
725
+ }
726
+ catch (error) {
727
+ const message = '[magicrew] 从本机浏览器读到登录态,但签发 gateway key 失败'
728
+ + '(先用 jwt 继续;api_key 可由续期或重新登录救回):' + String(error);
729
+ if (this.warnImpl !== undefined)
730
+ this.warnImpl(message);
731
+ else
732
+ this.ctx.logger?.warn?.(message);
733
+ }
734
+ /**
735
+ * ⚠️ 昵称在**签发之后**取(见 {@link withProfileNickname}):浏览器登录的凭据里
736
+ * 没有 `phone`,卡片昵称的唯一来源就是这个端点。失败只 warn,不挡登录。
737
+ */
738
+ credential = await this.withProfileNickname(credential);
739
+ // ⚠️ 写回失败**不吞**:调用方(`account.create`)随后要把这个 ref 写进账号池,
740
+ // 落库失败还建账号就是幽灵账号(池里有、凭据库没有)。
741
+ await this.storeFor()?.set(credentialRef(this.product.defaultCredentialRef), JSON.stringify(credential));
742
+ return credential;
743
+ }
744
+ /**
745
+ * **网页版登录**:开一个独立 profile 的浏览器窗口 → 等用户在里面登完 →
746
+ * 把凭据取回来(并签发一次 `mgw_` key)。
747
+ *
748
+ * ## 三条登录路径里的第 ② 条
749
+ *
750
+ * | # | 路径 | 门槛 | 方法 |
751
+ * |---|---|---|---|
752
+ * | ① | 本机浏览器已登录态 | 零 | {@link importFromLocalBrowser} |
753
+ * | ② | **网页版登录(本方法)** | 低(开窗,用户自己登) | 本方法 |
754
+ * | ③ | 手机号 + 密码 | 要密码 + 上游风控 | **已下线**(见 `jet-hub-rpc.ts`) |
755
+ *
756
+ * ② 存在的理由:①在「用户从没在本机浏览器登过这个站」「用户用的是另一个
757
+ * profile」两种情形下读不到,而它与「没登录」在结果上同形;③要用户交出密码、
758
+ * 且参考实现里那条 `phone_password` 是**零调用者**的探索代码。
759
+ * ② 是唯一「用户看着官方页面自己登、凭据自然落盘」的路径。
760
+ *
761
+ * ## ⚠️⚠️ 成功后**必须**签发一次 `mgw_` key(与 ① 同一条腿)
762
+ *
763
+ * 本仓库适配器在 `credential.apiKey` 缺失时**恒抛** `AUTH`
764
+ * 「超级麦吉账号未登录或缺少 api_key,请重新登录」⇒ 只落 jwt 的池条目 =
765
+ * 「登录成功但每请求都不回复」的**幽灵账号**,用户只会以为插件坏了。
766
+ * 派生细节逐条同 {@link importFromLocalBrowser}(签发失败**不吞掉**结果、
767
+ * 只 warn —— jwt 能拉目录 / 积分,api_key 可由续期救回)。
768
+ *
769
+ * ## 返回 `undefined` 的两种情形(都**不是**错误)
770
+ *
771
+ * 1. 用户在 `timeoutMs` 内没登完(关掉了窗口 / 还在输密码);
772
+ * 2. 用户在等的时候插件被停用({@link stop})—— 见下面的 `isStopped` 闸门。
773
+ *
774
+ * ⚠️ 调用方**不得**把 `undefined` 当失败弹错:那是**正常的「还没登完」**。
775
+ * 真正失败(浏览器起不来 / 签发网络异常)才抛错,且文案可读。
776
+ *
777
+ * ⚠️ `close()` 在 `finally` 里 —— 不调就会留下一个可见的浏览器窗口 + 200-400MB
778
+ * 的进程树(`ChromiumSession.dispose()` 里那套 `taskkill /T` 才是唯一正确的收法)。
779
+ */
780
+ async loginViaBrowser(options) {
781
+ const timeoutMs = options?.timeoutMs ?? MAGICREW_BROWSER_LOGIN_TIMEOUT_MS;
782
+ /**
783
+ * ⚠️ 会话在 `try` **外面**声明:`finally` 里要能拿到它。
784
+ * ⚠️ 起浏览器失败(找不到浏览器)会在这里抛 → 直接向上冒(`account.create`
785
+ * 把它的 `browserNotFoundMessage` 原样送到用户眼前,别在这里包一层)。
786
+ */
787
+ let login;
788
+ try {
789
+ login = await this.browserLoginFactory({ product: this.product, timeoutMs });
790
+ const found = await login.waitForCredential(timeoutMs);
791
+ // ⚠️ **回来时再判一次**:等用户登录是**分钟级**的,期间插件可能已被停用/登出
792
+ // (与 `refreshAccountCredential` 里那道 `this.active` 闸门同因)。
793
+ // 不判就会把一个已停用插件的凭据写进库 —— 之后没人续期、也没人展示它。
794
+ if (found === undefined)
795
+ return undefined;
796
+ if (!this.active)
797
+ return undefined;
798
+ const base = {
799
+ jwt: found.jwt,
800
+ organizationCode: found.organizationCode,
801
+ };
802
+ let credential = base;
803
+ try {
804
+ const key = await issueMagicrewGatewayKey({
805
+ jwt: found.jwt,
806
+ organizationCode: found.organizationCode,
807
+ product: this.product,
808
+ fetchImpl: this.fetchImpl,
809
+ });
810
+ credential = {
811
+ ...base,
812
+ apiKey: key.apiKey,
813
+ ...key.apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt: key.apiKeyExpiresAt },
814
+ ...key.refreshToken === undefined ? {} : { refreshToken: key.refreshToken },
815
+ ...key.refreshTokenExpiresAt === undefined
816
+ ? {} : { refreshTokenExpiresAt: key.refreshTokenExpiresAt },
817
+ };
818
+ }
819
+ catch (error) {
820
+ const message = '[magicrew] 网页版登录读到登录态,但签发 gateway key 失败'
821
+ + '(先用 jwt 继续;api_key 可由续期救回):' + String(error);
822
+ if (this.warnImpl !== undefined)
823
+ this.warnImpl(message);
824
+ else
825
+ this.ctx.logger?.warn?.(message);
826
+ }
827
+ /**
828
+ * ⚠️ 与 `importFromLocalBrowser` 同一条腿、同一处时机(签发之后、落库之前):
829
+ * 两条登录路径都必须取昵称,漏一条就是「两条路径显示不一样」。
830
+ */
831
+ credential = await this.withProfileNickname(credential);
832
+ // ⚠️ 写回失败**不吞**:调用方(`account.create`)随后要把 ref 写进账号池,
833
+ // 落库失败还建账号就是幽灵账号(池里有、凭据库没有)。
834
+ await this.storeFor()?.set(credentialRef(this.product.defaultCredentialRef), JSON.stringify(credential));
835
+ return credential;
836
+ }
837
+ finally {
838
+ /**
839
+ * ⚠️⚠️ `close()` 必须在 `finally`(含**抛错**路径):`waitForCredential` 抛错
840
+ * 时窗口还开着,不关就是一个没人收的可见浏览器。
841
+ * ⚠️ `close()` 本身幂等(实现里有一道 `closed` 闸门),重复调不炸。
842
+ */
843
+ login?.close();
844
+ }
845
+ }
846
+ /**
847
+ * 读本机浏览器里的凭据(纯读,无网络)。
848
+ *
849
+ * ⚠️⚠️ **先试网页 origin、再试 API host**:localStorage 的 key 是
850
+ * `_https://<origin>\x00\x01<name>`,而 magicrew 的网页在 `www.letsmagic.cn`、
851
+ * API 在 `i-magic-service.letsmagic.cn`(`product.host`)—— 用户登录发生在
852
+ * **网页**那个 origin 上 ⇒ 只按 `product.host` 找会**恒读不到**(且完全静默)。
853
+ * 两个都试,谁命中用谁。
854
+ */
855
+ readLocalBrowserCreds() {
856
+ const options = this.browserRoots === undefined ? {} : { roots: this.browserRoots };
857
+ for (const hostname of this.localBrowserHostnames()) {
858
+ const found = readMagicrewLocalCreds(hostname, options);
859
+ if (found !== undefined)
860
+ return found;
861
+ }
862
+ return undefined;
863
+ }
864
+ /** 候选站点 host(网页 origin 优先,见 {@link readLocalBrowserCreds})。 */
865
+ localBrowserHostnames() {
866
+ const hostnames = [];
867
+ for (const url of [this.product.webOrigin, this.product.host]) {
868
+ try {
869
+ const hostname = new URL(url).hostname;
870
+ if (hostname.length > 0 && !hostnames.includes(hostname))
871
+ hostnames.push(hostname);
872
+ }
873
+ catch {
874
+ // product 常量写成非法 URL ⇒ 跳过(不要静默去扫一个错的站点)。
875
+ }
876
+ }
877
+ return hostnames;
878
+ }
879
+ async logout() {
880
+ this.active = false;
881
+ }
882
+ /** 插件被停用时调用(与 {@link logout} 同因)。 */
883
+ stop() {
884
+ this.active = false;
885
+ }
886
+ /**
887
+ * 拉目录(供适配器注入 `fetchRemoteModels`)。
888
+ *
889
+ * ⚠️ 任务 3b 刻意省略过它(当时 `magicrew-catalog.ts` 还不存在),4a 该文件已落地
890
+ * ⇒ 4d 加回。**参数是显式的 `jwt` + `organizationCode`**(不是「读当前凭据」):
891
+ * 目录是**按账号**下发的,调用方必须能指定用哪个账号的 jwt;这也让单测可以
892
+ * 完全不碰凭据库(零真实凭据)。
893
+ *
894
+ * ⚠️ 动态 `import()` 是刻意的:`magicrew-catalog.ts` 只在**真的拉目录**时才需要,
895
+ * 而本文件在插件启动路径上。
896
+ */
897
+ async fetchCatalogModels(jwt, organizationCode) {
898
+ const { fetchMagicrewCatalogModels } = await import('./magicrew-catalog.js');
899
+ return await fetchMagicrewCatalogModels({
900
+ jwt, organizationCode, product: this.product, fetchImpl: this.fetchImpl,
901
+ });
902
+ }
903
+ /** 读当前凭据(账号池未提供 ref 时用默认 ref)。 */
904
+ async currentCredential(refName) {
905
+ const name = refName ?? this.product.defaultCredentialRef;
906
+ const store = this.storeFor();
907
+ if (store === undefined)
908
+ return undefined;
909
+ try {
910
+ const resolved = await store.resolve(credentialRef(name));
911
+ if (resolved === undefined || resolved === null)
912
+ return undefined;
913
+ // ⚠️ 宿主存的是**字符串** ⇒ 序列化要自己做;解析失败当“无凭据”而不报错。
914
+ return parseMagicrewCredential(JSON.parse(resolved.value));
915
+ }
916
+ catch {
917
+ return undefined;
918
+ }
919
+ }
920
+ /** 凭据库:注入的替身优先,否则用宿主 `ctx.credentials`(与 `astudio-auth.ts:451` 同款)。 */
921
+ storeFor() {
922
+ if (this.store !== undefined)
923
+ return this.store;
924
+ const ctx = this.ctx;
925
+ return ctx.credentials;
926
+ }
927
+ /** 取(或建)某 ref 的续期状态 —— 让最新 refresh_token 在内存里只有一份。 */
928
+ stateOf(refName, credential) {
929
+ const existing = this.states.get(refName);
930
+ if (existing !== undefined) {
931
+ // 凭据里的更新(比如刚登录)优先覆盖内存态
932
+ // ⚠️ **例外**:那条 token 若正是「上次轮换掉、但因写回失败仍留在库里」的旧值,
933
+ // 覆盖它就是把**已被上游消费**的 token 再抬回来 ⇒ 后续每轮续期都失败,
934
+ // 单向门(只能重新登录)。这不是理论风险:`store.set` 抛错即可达。
935
+ // 判据见 {@link MagicrewRefreshState.staleRefreshToken}。
936
+ if (credential.refreshToken !== undefined
937
+ && credential.refreshToken !== existing.staleRefreshToken) {
938
+ existing.refreshToken = credential.refreshToken;
939
+ }
940
+ return existing;
941
+ }
942
+ const created = {
943
+ ...credential.refreshToken === undefined ? {} : { refreshToken: credential.refreshToken },
944
+ ...credential.apiKey === undefined ? {} : { apiKey: credential.apiKey },
945
+ ...credential.apiKeyExpiresAt === undefined ? {} : { apiKeyExpiresAt: credential.apiKeyExpiresAt },
946
+ };
947
+ this.states.set(refName, created);
948
+ return created;
949
+ }
950
+ }
951
+ //# sourceMappingURL=magicrew-auth.js.map