@fish-under-sea/magpie-dragonapi 0.0.0-stage → 0.1.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.
@@ -0,0 +1,498 @@
1
+ // 本地服务:页面真正住的地方。
2
+ //
3
+ // 为什么要有一个服务,而不是纯静态页面:
4
+ //
5
+ // magpie 的插件页跑在 `sandbox="allow-scripts"` 的 iframe 里,CSP 是
6
+ // `connect-src 'none'`——一条 fetch / XHR / WebSocket 都发不出去,连
7
+ // localStorage 都没有。页面唯一能做的联网动作是「把自己导航到别处」。
8
+ //
9
+ // 所以这里起一个只监听 127.0.0.1 的 HTTP 服务:`page/index.html` 是带路页,
10
+ // 它把框架导航到本服务,界面由本服务提供。这也正是社区插件
11
+ // `@magpie-community/page-chat` 的做法。
12
+ //
13
+ // 两个必须记住的约束:
14
+ //
15
+ // 1. 导航后文档的 origin 是 opaque(Origin: null),所以所有响应都要带
16
+ // `Access-Control-Allow-Origin: *`,且前端不能用 cookie / storage。
17
+ // 2. 服务只听 127.0.0.1。magpie web 部署在别的机器上时,`magpie.service`
18
+ // 会给出反代地址,带路页优先用它(见 page/boot.js)。
19
+
20
+ import { createServer } from 'node:http'
21
+ import { readFileSync, existsSync, statSync } from 'node:fs'
22
+ import { extname, join, normalize, resolve, sep } from 'node:path'
23
+ import { fileURLToPath } from 'node:url'
24
+
25
+ import { currencyOf, text, readPricing, readTokenUsage, readTokenLogs, readSelf, readUsableGroups, readKeys, createKey, revealKey, deleteKey } from './site.mjs'
26
+ import { buildCatalog, modelsOfGroup } from './catalog.mjs'
27
+ import { billingOf } from './pricing.mjs'
28
+ import { rowsOf, summarize, windowOf } from './usage.mjs'
29
+ import { loadState, saveState, maskKey, tailOf } from './store.mjs'
30
+
31
+ const here = resolve(fileURLToPath(new URL('..', import.meta.url)))
32
+
33
+ /** MIME 表只覆盖本插件真正会发的类型。 */
34
+ const MIME = {
35
+ '.html': 'text/html; charset=utf-8',
36
+ '.js': 'text/javascript; charset=utf-8',
37
+ '.mjs': 'text/javascript; charset=utf-8',
38
+ '.css': 'text/css; charset=utf-8',
39
+ '.svg': 'image/svg+xml',
40
+ '.png': 'image/png',
41
+ '.json': 'application/json; charset=utf-8',
42
+ '.woff2': 'font/woff2',
43
+ }
44
+
45
+ /** 一次响应:JSON + CORS + 不缓存(页面是活的,缓存只会让人看到旧数据)。 */
46
+ function json(res, code, body) {
47
+ const data = JSON.stringify(body)
48
+ res.writeHead(code, {
49
+ 'content-type': 'application/json; charset=utf-8',
50
+ 'content-length': Buffer.byteLength(data),
51
+ 'access-control-allow-origin': '*',
52
+ 'access-control-allow-headers': 'content-type',
53
+ 'access-control-allow-methods': 'GET, POST, DELETE, OPTIONS',
54
+ 'cache-control': 'no-store',
55
+ })
56
+ res.end(data)
57
+ }
58
+
59
+ /**
60
+ * 请求体错误单独一个类型:它该回 400,而不是和内部异常一起回 500。
61
+ * 不加这个区分时,客户端发一个坏 JSON 会被报成「服务器内部错误」,
62
+ * 排查时会误以为是服务挂了。
63
+ */
64
+ class BadRequest extends Error {
65
+ constructor(message) { super(message); this.badRequest = true }
66
+ }
67
+
68
+ /** 读请求体,限制 1 MB:这里只会收 JSON 小对象。 */
69
+ function readBody(req) {
70
+ return new Promise((resolve_, reject) => {
71
+ let size = 0
72
+ const chunks = []
73
+ req.on('data', (c) => {
74
+ size += c.length
75
+ if (size > 1 << 20) { reject(new BadRequest('请求体太大')); req.destroy(); return }
76
+ chunks.push(c)
77
+ })
78
+ req.on('end', () => {
79
+ const raw = Buffer.concat(chunks).toString('utf8').trim()
80
+ if (!raw) return resolve_({})
81
+ try { resolve_(JSON.parse(raw)) } catch { reject(new BadRequest('请求体不是 JSON')) }
82
+ })
83
+ req.on('error', reject)
84
+ })
85
+ }
86
+
87
+ /**
88
+ * 静态文件:只允许 ui/ 与 page/ 两个目录,且必须在目录内。
89
+ *
90
+ * 路径穿越在这里不是理论风险——这个服务监听 127.0.0.1,本机任何程序都能打。
91
+ */
92
+ function serveFile(res, root, rel) {
93
+ const clean = normalize(rel).replace(/^([/\\])+/, '')
94
+ if (clean.includes('..')) return false
95
+ const file = resolve(root, clean)
96
+ if (!file.startsWith(resolve(root) + sep) && file !== resolve(root)) return false
97
+ if (!existsSync(file)) return false
98
+ const st = statSync(file)
99
+ if (!st.isFile()) return false
100
+ const body = readFileSync(file)
101
+ res.writeHead(200, {
102
+ 'content-type': MIME[extname(file).toLowerCase()] || 'application/octet-stream',
103
+ 'content-length': body.length,
104
+ 'access-control-allow-origin': '*',
105
+ 'cache-control': 'no-cache',
106
+ 'x-content-type-options': 'nosniff',
107
+ 'referrer-policy': 'no-referrer',
108
+ })
109
+ res.end(body)
110
+ return true
111
+ }
112
+
113
+ /**
114
+ * startService 起本地服务。
115
+ *
116
+ * 这个模块只管「把状态呈现成 HTTP」:路由、CORS、静态文件、JSON 形状。
117
+ * 目录与站点参数**不在这里缓存**——它们各有唯一所有者(catalog-source /
118
+ * status-source),由 index.mjs 或 serve.mjs 注入进来。之前这里也缓存了一份,
119
+ * 结果「页面点刷新」刷的是另一份缓存,按钮点了没用。
120
+ *
121
+ * @param {object} o
122
+ * @param {number} o.port 首选端口;占用时往后试 10 个
123
+ * @param {string} o.dir magpie 的配置目录(状态文件写这里)
124
+ * @param {string} o.site 站点根地址
125
+ * @param {object} o.catalog 目录源(catalog-source 的实例)
126
+ * @param {object} o.status 站点参数源(status-source 的实例)
127
+ * @param {function} o.getState 取插件状态(账号、PAT、启用分组)
128
+ * @param {function} o.setPat 写/清 PAT
129
+ * @param {function} o.keyOf 按 tail 取钥匙明文(独立模式下没有,返回空)
130
+ */
131
+ export async function startService({ port = 3517, dir = '.', site, catalog, status, getState, setPat, keyOf } = {}) {
132
+ if (!catalog || typeof catalog.get !== 'function') throw new Error('startService 需要一个目录源(catalog)')
133
+ if (!status || typeof status.get !== 'function') throw new Error('startService 需要一个站点参数源(status)')
134
+
135
+ /**
136
+ * stateOf 把三样东西凑齐:插件状态、站点参数、目录快照。
137
+ *
138
+ * 目录与参数都从注入的源取,这里不做任何缓存——缓存归源所有,
139
+ * 这样「页面点刷新」刷的就是宿主看到的那一份。
140
+ */
141
+ async function stateOf({ refresh = false } = {}) {
142
+ const st = getState ? await getState() : { accounts: {}, pat: '' }
143
+ const [cat, site_] = await Promise.all([catalog.get({ force: refresh }), status.get({ force: refresh })])
144
+ const cur = currencyOf(site_)
145
+ const built = cat.env
146
+ ? buildCatalog(cat.env, { cur, enabledGroups: st.enabledGroups || [], site })
147
+ : { models: {}, rows: [], groups: [], vendors: [], version: '', autoGroups: [] }
148
+ return { st, cat, cur, built, status: site_ }
149
+ }
150
+
151
+ async function handler(req, res) {
152
+ const url = new URL(req.url || '/', 'http://127.0.0.1')
153
+ const path = url.pathname
154
+
155
+ // 预检:浏览器的 fetch 带自定义头时会先问一次。
156
+ if (req.method === 'OPTIONS') {
157
+ res.writeHead(204, {
158
+ 'access-control-allow-origin': '*',
159
+ 'access-control-allow-headers': 'content-type',
160
+ 'access-control-allow-methods': 'GET, POST, DELETE, OPTIONS',
161
+ 'access-control-max-age': '600',
162
+ })
163
+ res.end()
164
+ return
165
+ }
166
+
167
+ // ---- 静态:界面 ----
168
+ //
169
+ // index.html 用相对路径引 style.css / app.js,所以它从 `/` 打开时,
170
+ // 浏览器请求的是 `/style.css`、`/app.js`,不是 `/ui/style.css`。
171
+ // 两种前缀都要认,否则界面只剩 HTML,CSS/JS 全 404——页面看起来就是
172
+ // 一个巨大的裸 SVG(图标)铺满屏幕。
173
+ const uiDir = join(here, 'ui')
174
+ if (path === '/' || path === '/index.html') {
175
+ if (serveFile(res, uiDir, 'index.html')) return
176
+ json(res, 404, { ok: false, error: '界面文件缺失(ui/index.html)' })
177
+ return
178
+ }
179
+ if (path.startsWith('/ui/')) {
180
+ if (serveFile(res, uiDir, path.slice(4))) return
181
+ json(res, 404, { ok: false, error: '没有这个文件' })
182
+ return
183
+ }
184
+ // 根下的界面资源:只放行 ui/ 里真有的文件,其它一律落到 API 或 404。
185
+ if (req.method === 'GET' && /\.(css|js|mjs|svg|png|woff2?|json)$/i.test(path)) {
186
+ if (serveFile(res, uiDir, path.slice(1))) return
187
+ }
188
+
189
+ // ---- API ----
190
+ try {
191
+ if (path === '/api/ping' && req.method === 'GET') {
192
+ json(res, 200, { ok: true, version: '0.1.0', port })
193
+ return
194
+ }
195
+
196
+ if (path === '/api/state' && req.method === 'GET') {
197
+ const { st, cat, cur, built, status: site_ } = await stateOf()
198
+ const accounts = await accountViews(st, cur)
199
+ json(res, 200, {
200
+ ok: true,
201
+ site,
202
+ siteName: site_?.siteName || 'DragonAPI',
203
+ pat: { set: Boolean(st.pat), hint: st.patHint || '', scopes: st.patScopes || [] },
204
+ currency: cur,
205
+ accounts,
206
+ groups: built.groups,
207
+ counts: {
208
+ models: Array.isArray(cat.env?.data) ? cat.env.data.length : 0,
209
+ rows: built.rows.length,
210
+ groups: built.groups.length,
211
+ vendors: built.vendors.length,
212
+ },
213
+ catalogAt: cat.at,
214
+ health: { ok: cat.source === 'live', source: cat.source, error: cat.error, at: cat.at },
215
+ })
216
+ return
217
+ }
218
+
219
+ if (path === '/api/catalog' && req.method === 'GET') {
220
+ // 刷新就是 force:跳过 TTL,但仍然带 ETag 走条件请求。
221
+ // 这里直接让目录源自己刷,不再回调别处的 refresh——那样刷的是另一份缓存。
222
+ const force = url.searchParams.get('refresh') === '1'
223
+ const { cat, cur, built } = await stateOf({ refresh: force })
224
+ json(res, 200, {
225
+ ok: true,
226
+ version: built.version,
227
+ at: cat.at,
228
+ source: cat.source,
229
+ error: cat.error,
230
+ groups: built.groups,
231
+ vendors: built.vendors,
232
+ models: built.rows,
233
+ counts: {
234
+ models: Array.isArray(cat.env?.data) ? cat.env.data.length : 0,
235
+ rows: built.rows.length,
236
+ groups: built.groups.length,
237
+ },
238
+ })
239
+ return
240
+ }
241
+
242
+ if (path === '/api/model' && req.method === 'GET') {
243
+ const group = url.searchParams.get('group') || ''
244
+ const model = url.searchParams.get('model') || ''
245
+ const { cat, built } = await stateOf()
246
+ const row = built.rows.find((r) => r.group === group && r.name === model)
247
+ if (!row) { json(res, 404, { ok: false, error: '没有这个模型' }); return }
248
+ const raw = (Array.isArray(cat.env?.data) ? cat.env.data : []).find((m) => String(m?.model_name) === model)
249
+ json(res, 200, { ok: true, model: row, billing: raw ? billingOf(raw, row.groupRatio) : null })
250
+ return
251
+ }
252
+
253
+ if (path === '/api/usage' && req.method === 'GET') {
254
+ const range = url.searchParams.get('range') || 'day'
255
+ const { st, cur } = await stateOf()
256
+ const { start, end } = windowOf(range)
257
+ const all = []
258
+ for (const [key, meta] of Object.entries(st.accounts || {})) {
259
+ const secret = await readAccountKey(key)
260
+ if (!secret) continue
261
+ try {
262
+ const items = await readTokenLogs(site, secret, { pageSize: 500 })
263
+ all.push(...rowsOf(items, cur, meta?.label || key))
264
+ } catch { /* 一把钥匙读不到不该让整页失败 */ }
265
+ }
266
+ const sum = summarize(all, cur, start, end)
267
+ const rows = all.filter((r) => r.at >= start && r.at <= end).slice(0, 200)
268
+ json(res, 200, { ok: true, range, ...sum, rows })
269
+ return
270
+ }
271
+
272
+ if (path === '/api/logs' && req.method === 'GET') {
273
+ const limit = Math.max(1, Math.min(500, Number(url.searchParams.get('limit')) || 200))
274
+ const only = url.searchParams.get('account') || ''
275
+ const { st, cur } = await stateOf()
276
+ const all = []
277
+ for (const [key, meta] of Object.entries(st.accounts || {})) {
278
+ if (only && key !== only) continue
279
+ const secret = await readAccountKey(key)
280
+ if (!secret) continue
281
+ try {
282
+ const items = await readTokenLogs(site, secret, { pageSize: 500 })
283
+ all.push(...rowsOf(items, cur, meta?.label || key))
284
+ } catch { /* 同上 */ }
285
+ }
286
+ all.sort((a, b) => b.at - a.at)
287
+ json(res, 200, { ok: true, rows: all.slice(0, limit) })
288
+ return
289
+ }
290
+
291
+ if (path === '/api/keys' && req.method === 'GET') {
292
+ const { st } = await stateOf()
293
+ if (!st.pat) { json(res, 400, { ok: false, error: '还没有设置访问令牌(PAT),建钥匙需要 api_key:read / api_key:write 权限' }); return }
294
+ const keys = await readKeys(site, st.pat)
295
+ const groups = await readUsableGroups(site, st.pat).catch(() => [])
296
+ const boundTails = new Set(Object.values(st.accounts || {}).map((a) => String(a?.tail || '')).filter(Boolean))
297
+ json(res, 200, {
298
+ ok: true,
299
+ keys: keys.map((k) => ({ ...k, bound: boundTails.has(tailOf(k.key)) })),
300
+ groups,
301
+ })
302
+ return
303
+ }
304
+
305
+ if (path === '/api/keys' && req.method === 'POST') {
306
+ const { st } = await stateOf()
307
+ if (!st.pat) { json(res, 400, { ok: false, error: '还没有设置访问令牌(PAT)' }); return }
308
+ const body = await readBody(req)
309
+ const name = String(body?.name || '').trim()
310
+ const group = String(body?.group || '').trim()
311
+ if (!name) { json(res, 400, { ok: false, error: '钥匙名不能为空' }); return }
312
+ if (!group) { json(res, 400, { ok: false, error: '必须选一个分组:分组是这把钥匙能调哪些模型、按什么倍率计费的依据' }); return }
313
+ await createKey(site, st.pat, {
314
+ name,
315
+ group,
316
+ unlimited: body?.unlimited !== false,
317
+ remainQuota: body?.remainQuota,
318
+ expiredAt: body?.expiredAt,
319
+ })
320
+ // 建完立刻找回来:站点建钥匙的响应里不含明文,必须再查一次列表拿 id,
321
+ // 然后 reveal。这两步要当成一件事——中间失败会留下一把没人知道明文的钥匙,
322
+ // 所以失败时要把错误说清楚,并告诉用户去控制台手动删。
323
+ const keys = await readKeys(site, st.pat)
324
+ const made = keys.find((k) => k.name === name && k.group === group)
325
+ if (!made) {
326
+ json(res, 502, { ok: false, error: '钥匙已创建,但没能在列表里找到它(可能同名重复)。请到控制台核对并取回钥匙。' })
327
+ return
328
+ }
329
+ let secret = ''
330
+ try {
331
+ secret = await revealKey(site, st.pat, made.id)
332
+ } catch (e) {
333
+ json(res, 502, {
334
+ ok: false,
335
+ error: `钥匙已创建(id ${made.id}),但取明文失败:${String(e?.message || e)}。请在控制台手动复制,或给访问令牌加上 api_key:reveal 权限后点「查看完整钥匙」。`,
336
+ key: { id: made.id, name: made.name, group: made.group },
337
+ })
338
+ return
339
+ }
340
+ json(res, 200, {
341
+ ok: true,
342
+ key: { id: made.id, name: made.name, group: made.group, secret },
343
+ bind: {
344
+ how: [
345
+ '到 magpie 的供应商列表里打开 DragonAPI,点「添加账号」。',
346
+ '选「用访问令牌自动建钥匙」:下次选好分组,插件会再建一把并直接绑成账号。',
347
+ '或者选「DragonAPI API Key」,把上面这把 sk- 钥匙粘进去。',
348
+ ],
349
+ note: '分组决定这把钥匙能调哪些模型、按什么倍率计费;一把钥匙只属于一个分组。',
350
+ },
351
+ })
352
+ return
353
+ }
354
+
355
+ if (path.startsWith('/api/keys/') && req.method === 'DELETE') {
356
+ const { st } = await stateOf()
357
+ if (!st.pat) { json(res, 400, { ok: false, error: '还没有设置访问令牌(PAT)' }); return }
358
+ const id = Number(path.split('/')[3])
359
+ if (!Number.isFinite(id) || id <= 0) { json(res, 400, { ok: false, error: '钥匙 id 不对' }); return }
360
+ await deleteKey(site, st.pat, id)
361
+ json(res, 200, { ok: true })
362
+ return
363
+ }
364
+
365
+ if (path.startsWith('/api/keys/') && path.endsWith('/reveal') && req.method === 'POST') {
366
+ const { st } = await stateOf()
367
+ if (!st.pat) { json(res, 400, { ok: false, error: '还没有设置访问令牌(PAT)' }); return }
368
+ const id = Number(path.split('/')[3])
369
+ if (!Number.isFinite(id) || id <= 0) { json(res, 400, { ok: false, error: '钥匙 id 不对' }); return }
370
+ try {
371
+ const secret = await revealKey(site, st.pat, id)
372
+ json(res, 200, { ok: true, secret })
373
+ } catch (e) {
374
+ json(res, 403, { ok: false, error: String(e?.message || e) })
375
+ }
376
+ return
377
+ }
378
+
379
+ if (path === '/api/pat' && req.method === 'POST') {
380
+ const body = await readBody(req)
381
+ const pat = String(body?.pat || '').trim()
382
+ if (!pat) { json(res, 400, { ok: false, error: '访问令牌不能为空' }); return }
383
+ let user
384
+ try {
385
+ user = await readSelf(site, pat)
386
+ } catch (e) {
387
+ json(res, 400, { ok: false, error: `这份访问令牌不可用:${String(e?.message || e)}` })
388
+ return
389
+ }
390
+ // 顺便把 scope 探出来:能读钥匙列表说明有 api_key:read,能读用量说明有 usage:read。
391
+ const scopes = []
392
+ if (await readKeys(site, pat).then(() => true).catch(() => false)) scopes.push('api_key:read')
393
+ if (await readTokenLogs(site, '').then(() => true).catch(() => false)) scopes.push('usage:read')
394
+ await setPat({ pat, hint: maskKey(pat), scopes, user })
395
+ json(res, 200, { ok: true, pat: { set: true, hint: maskKey(pat), scopes }, user: { name: user.username, id: user.id } })
396
+ return
397
+ }
398
+
399
+ if (path === '/api/pat' && req.method === 'DELETE') {
400
+ await setPat({ pat: '', hint: '', scopes: [], user: null })
401
+ json(res, 200, { ok: true, pat: { set: false } })
402
+ return
403
+ }
404
+
405
+ if (path === '/api/bind-info' && req.method === 'GET') {
406
+ json(res, 200, {
407
+ ok: true,
408
+ how: [
409
+ '在 magpie 的供应商列表里打开 DragonAPI,点「添加账号」。',
410
+ '选「用访问令牌自动建钥匙」:插件会按你选的分组建一把新钥匙并自动绑定。',
411
+ '或者选「DragonAPI API Key」,把上面复制到的 sk- 钥匙粘进去。',
412
+ ],
413
+ auto: { method: 'pat', label: '用访问令牌自动建钥匙' },
414
+ note: '页面跑在沙箱里,写不了 magpie 的账号表,所以绑定只能走 magpie 自己的「添加账号」。',
415
+ })
416
+ return
417
+ }
418
+
419
+ if (path === '/api/health' && req.method === 'GET') {
420
+ // 健康记录归目录源所有:它才知道每次拉取成没成、花了多久。
421
+ json(res, 200, { ok: true, recent: typeof catalog.recent === 'function' ? catalog.recent() : [] })
422
+ return
423
+ }
424
+
425
+ json(res, 404, { ok: false, error: '没有这个接口' })
426
+ } catch (e) {
427
+ // 请求体坏了是客户端的问题,回 400;其它才是 500。
428
+ const code = e?.badRequest ? 400 : 500
429
+ json(res, code, { ok: false, error: String(e?.message || e) })
430
+ }
431
+ }
432
+
433
+ /**
434
+ * readAccountKey 取这个账号(按 tail)的钥匙明文。
435
+ *
436
+ * 钥匙不落盘,只在插件进程内存里留一份 tail → 明文 的映射,由 index.mjs
437
+ * 在每次 usage / loader / models 拿到 auth 时填进去。进程重启后第一次
438
+ * models() 就会重新填上,所以页面刷新一下就能看到余额。
439
+ */
440
+ async function readAccountKey(key) {
441
+ try {
442
+ const secret = keyOf ? keyOf(key) : ''
443
+ return String(secret || '')
444
+ } catch { return '' }
445
+ }
446
+
447
+ /** accountViews 把账号折成页面要的样子:带上余额与用量。 */
448
+ async function accountViews(st, cur) {
449
+ const out = []
450
+ for (const [key, meta] of Object.entries(st.accounts || {})) {
451
+ const secret = await readAccountKey(key)
452
+ const view = {
453
+ key,
454
+ label: meta?.label || key,
455
+ group: meta?.group || '',
456
+ masked: meta?.masked || '',
457
+ models: Number(meta?.models) || 0,
458
+ boundAt: Number(meta?.boundAt) || 0,
459
+ balance: '—',
460
+ balanceRaw: 0,
461
+ used: '—',
462
+ usedRaw: 0,
463
+ tokenName: '',
464
+ }
465
+ if (secret) {
466
+ try {
467
+ const u = await readTokenUsage(site, secret)
468
+ view.balance = text(u.available, cur)
469
+ view.balanceRaw = u.available
470
+ view.used = text(u.used, cur)
471
+ view.usedRaw = u.used
472
+ view.tokenName = u.name
473
+ } catch { /* 读不到就显示 —,不假装是 0 */ }
474
+ }
475
+ out.push(view)
476
+ }
477
+ return out
478
+ }
479
+
480
+ // 端口被占用时往后试,最多 10 个。撞端口在插件里很常见(另一个插件也占了)。
481
+ let server = null
482
+ let bound = port
483
+ for (let i = 0; i < 10; i++) {
484
+ const tryPort = port + i
485
+ const s = createServer((req, res) => { handler(req, res).catch(() => { try { json(res, 500, { ok: false, error: '内部错误' }) } catch { /* 已发送 */ } }) })
486
+ const ok = await new Promise((resolve_) => {
487
+ s.once('error', () => resolve_(false))
488
+ s.listen(tryPort, '127.0.0.1', () => resolve_(true))
489
+ })
490
+ if (ok) { server = s; bound = tryPort; break }
491
+ }
492
+ if (!server) throw new Error(`127.0.0.1 上 ${port}–${port + 9} 都被占用了,请到插件选项里换一个端口`)
493
+
494
+ return {
495
+ port: bound,
496
+ close: () => new Promise((resolve_) => server.close(() => resolve_(true))),
497
+ }
498
+ }