@steve02081504/fount-p2p 0.0.28 → 0.0.29
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/discovery/nostr.mjs +190 -21
- package/package.json +1 -1
package/discovery/nostr.mjs
CHANGED
|
@@ -34,6 +34,8 @@ export const NOSTR_CLOSE_GRACE_MS = 1_000
|
|
|
34
34
|
export const NOSTR_PUBLISH_OK_TIMEOUT_MS = 3_000
|
|
35
35
|
/** 共享 relay 会话断线后重连间隔。 */
|
|
36
36
|
export const NOSTR_RECONNECT_DELAY_MS = 500
|
|
37
|
+
/** 无 sub/publish 工作时共享 relay 空闲回收延迟(给连续 send 复用窗口)。 */
|
|
38
|
+
export const NOSTR_IDLE_DROP_MS = 2_000
|
|
37
39
|
|
|
38
40
|
/** Nostr network advert 事件 kind(addressable,可存储)。 */
|
|
39
41
|
export const NOSTR_ADVERT_KIND = 30787
|
|
@@ -265,9 +267,10 @@ function connectRelay(relayUrl, timeoutMs = NOSTR_CONNECT_TIMEOUT_MS, signal) {
|
|
|
265
267
|
* @param {string} relayUrl 中继 URL
|
|
266
268
|
* @param {object} event 待发布事件
|
|
267
269
|
* @param {AbortSignal} [signal] 取消信号
|
|
270
|
+
* @param {() => boolean} [isCurrent] 该尝试是否仍是 publishRequest 的当前尝试(断线重发后过期)
|
|
268
271
|
* @returns {Promise<boolean>} relay 是否接受 EVENT
|
|
269
272
|
*/
|
|
270
|
-
function publishEventOnRelay(ws, relayUrl, event, signal) {
|
|
273
|
+
function publishEventOnRelay(ws, relayUrl, event, signal, isCurrent) {
|
|
271
274
|
return new Promise((resolve, reject) => {
|
|
272
275
|
if (signal?.aborted) {
|
|
273
276
|
reject(new Error('nostr: aborted'))
|
|
@@ -285,6 +288,8 @@ function publishEventOnRelay(ws, relayUrl, event, signal) {
|
|
|
285
288
|
clearTimeout(timer)
|
|
286
289
|
signal?.removeEventListener('abort', onAbort)
|
|
287
290
|
ws.off('message', onMessage)
|
|
291
|
+
// 过期的 in-flight 尝试:只清理自身监听器/定时器,不结算,避免影响重发后的当前尝试。
|
|
292
|
+
if (!isCurrent()) return
|
|
288
293
|
if (error) reject(error)
|
|
289
294
|
else resolve(ok)
|
|
290
295
|
}
|
|
@@ -331,42 +336,93 @@ function publishEventOnRelay(ws, relayUrl, event, signal) {
|
|
|
331
336
|
* @returns {Promise<void>}
|
|
332
337
|
*/
|
|
333
338
|
async function publishEvent(relayUrls, event, signal) {
|
|
334
|
-
|
|
339
|
+
const urls = dedupeRelayUrls(relayUrls)
|
|
340
|
+
if (!urls.length) throw new Error('nostr: no relay')
|
|
335
341
|
let published = false
|
|
336
342
|
let lastError = null
|
|
337
|
-
await Promise.allSettled(
|
|
338
|
-
if (signal?.aborted) throw new Error('nostr: aborted')
|
|
339
|
-
const ws = await connectRelay(relayUrl, NOSTR_CONNECT_TIMEOUT_MS, signal)
|
|
343
|
+
await Promise.allSettled(urls.map(async relayUrl => {
|
|
340
344
|
try {
|
|
341
|
-
if (signal
|
|
342
|
-
const ok = await publishEventOnRelay(ws, relayUrl, event, signal)
|
|
343
|
-
if (ok) published = true
|
|
345
|
+
if (await publishViaSharedRelay(relayUrl, event, signal)) published = true
|
|
344
346
|
}
|
|
345
347
|
catch (error) {
|
|
346
348
|
lastError = error
|
|
347
|
-
throw error
|
|
348
|
-
}
|
|
349
|
-
finally {
|
|
350
|
-
dropWebSocket(ws)
|
|
351
349
|
}
|
|
352
350
|
}))
|
|
353
351
|
if (!published) throw lastError || new Error('nostr: no relay accepted publish')
|
|
354
352
|
}
|
|
355
353
|
|
|
356
354
|
/**
|
|
357
|
-
*
|
|
358
|
-
*
|
|
355
|
+
* 一次共享 relay publish 请求:入队(pending)与已派发(inflight)时共用同一结构。
|
|
356
|
+
* attempt 标识每次实际发送尝试,断线重发会递增;旧的 in-flight 尝试据此自检为过期后自我清理,
|
|
357
|
+
* 不再结算当前尝试。
|
|
358
|
+
* @typedef {{
|
|
359
|
+
* event: object,
|
|
360
|
+
* signal: AbortSignal | undefined,
|
|
361
|
+
* attempt: number,
|
|
362
|
+
* onAbort: (() => void) | null,
|
|
363
|
+
* removeAbort: (() => void) | null,
|
|
364
|
+
* resolve: (ok: boolean) => void,
|
|
365
|
+
* reject: (err: Error) => void,
|
|
366
|
+
* }} NostrPublishRequest
|
|
367
|
+
*/
|
|
368
|
+
|
|
369
|
+
/**
|
|
370
|
+
* 共享 relay 会话:多 SUB / publish 复用同一 URL 的 WebSocket,避免 signal/presence/advert 各建一池、
|
|
371
|
+
* 以及每次 send 重开一条连接(内存泄漏)。
|
|
372
|
+
* 仍有活跃 sub 或待发 publish 时断线会自动重连并重发 REQ / 重发 EVENT。
|
|
359
373
|
* @typedef {{
|
|
360
374
|
* ws: import('ws').WebSocket | null,
|
|
361
375
|
* connecting: boolean,
|
|
362
376
|
* reconnectTimer: ReturnType<typeof setTimeout> | null,
|
|
377
|
+
* idleTimer: ReturnType<typeof setTimeout> | null,
|
|
363
378
|
* subs: Map<string, { filter: object, onEvent: (event: object, relayUrl: string) => void }>,
|
|
379
|
+
* pendingPublishes: Array<NostrPublishRequest>,
|
|
380
|
+
* inflightPublishes: Array<NostrPublishRequest>,
|
|
364
381
|
* }} SharedRelaySession
|
|
365
382
|
*/
|
|
366
383
|
|
|
367
384
|
/** @type {Map<string, SharedRelaySession>} */
|
|
368
385
|
const sharedRelaySessions = new Map()
|
|
369
386
|
|
|
387
|
+
/**
|
|
388
|
+
* 会话是否仍有需要连接的工作(sub 或待发 publish)。
|
|
389
|
+
* @param {SharedRelaySession} session 会话
|
|
390
|
+
* @returns {boolean} 是否有活跃工作
|
|
391
|
+
*/
|
|
392
|
+
function hasPendingWork(session) {
|
|
393
|
+
return session.subs.size || session.pendingPublishes.length || session.inflightPublishes.length
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
/**
|
|
397
|
+
* 取消会话的空闲回收定时器。
|
|
398
|
+
* @param {SharedRelaySession} session 会话
|
|
399
|
+
* @returns {void}
|
|
400
|
+
*/
|
|
401
|
+
function clearIdleDrop(session) {
|
|
402
|
+
if (!session.idleTimer) return
|
|
403
|
+
clearTimeout(session.idleTimer)
|
|
404
|
+
session.idleTimer = null
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
/**
|
|
408
|
+
* 会话无 sub 时,待 publish 清空后延迟回收空闲 socket(给连续 send 复用窗口)。
|
|
409
|
+
* @param {string} relayUrl 中继 URL
|
|
410
|
+
* @param {SharedRelaySession} session 会话
|
|
411
|
+
* @returns {void}
|
|
412
|
+
*/
|
|
413
|
+
function scheduleIdleDrop(relayUrl, session) {
|
|
414
|
+
if (session.subs.size || session.idleTimer) return
|
|
415
|
+
session.idleTimer = setTimeout(() => {
|
|
416
|
+
session.idleTimer = null
|
|
417
|
+
if (!isLiveSharedSession(relayUrl, session) || hasPendingWork(session)) return
|
|
418
|
+
sharedRelaySessions.delete(relayUrl)
|
|
419
|
+
clearSharedRelayReconnect(session)
|
|
420
|
+
if (session.ws) dropWebSocket(session.ws)
|
|
421
|
+
session.ws = null
|
|
422
|
+
}, NOSTR_IDLE_DROP_MS)
|
|
423
|
+
session.idleTimer.unref?.()
|
|
424
|
+
}
|
|
425
|
+
|
|
370
426
|
/**
|
|
371
427
|
* @param {string} relayUrl 中继 URL
|
|
372
428
|
* @param {SharedRelaySession} session 会话
|
|
@@ -408,7 +464,14 @@ function attachSharedRelaySocket(relayUrl, session, ws) {
|
|
|
408
464
|
ws.once('close', () => {
|
|
409
465
|
if (!isLiveSharedSession(relayUrl, session)) return
|
|
410
466
|
session.ws = null
|
|
411
|
-
|
|
467
|
+
// 尚未确认的 inflight publish 重新入队,重连后由 flushPendingPublishes 重发。
|
|
468
|
+
if (session.inflightPublishes.length) {
|
|
469
|
+
session.pendingPublishes.push(...session.inflightPublishes)
|
|
470
|
+
for (const publishRequest of session.inflightPublishes)
|
|
471
|
+
attachQueuedAbort(session, publishRequest)
|
|
472
|
+
session.inflightPublishes = []
|
|
473
|
+
}
|
|
474
|
+
if (!hasPendingWork(session)) {
|
|
412
475
|
sharedRelaySessions.delete(relayUrl)
|
|
413
476
|
return
|
|
414
477
|
}
|
|
@@ -416,6 +479,8 @@ function attachSharedRelaySocket(relayUrl, session, ws) {
|
|
|
416
479
|
})
|
|
417
480
|
for (const [subId, sub] of session.subs)
|
|
418
481
|
try { ws.send(JSON.stringify(['REQ', subId, sub.filter])) } catch { /* ignore */ }
|
|
482
|
+
flushPendingPublishes(relayUrl, session, ws)
|
|
483
|
+
if (!hasPendingWork(session)) scheduleIdleDrop(relayUrl, session)
|
|
419
484
|
}
|
|
420
485
|
|
|
421
486
|
/**
|
|
@@ -433,16 +498,15 @@ function scheduleSharedRelayConnect(relayUrl, session, delayMs = 0) {
|
|
|
433
498
|
const start = () => {
|
|
434
499
|
session.reconnectTimer = null
|
|
435
500
|
if (!isLiveSharedSession(relayUrl, session) || session.connecting || session.ws) return
|
|
436
|
-
if (!session
|
|
501
|
+
if (!hasPendingWork(session)) {
|
|
437
502
|
sharedRelaySessions.delete(relayUrl)
|
|
438
503
|
return
|
|
439
504
|
}
|
|
440
505
|
session.connecting = true
|
|
441
506
|
void connectRelay(relayUrl, NOSTR_CONNECT_TIMEOUT_MS).then(ws => {
|
|
442
507
|
session.connecting = false
|
|
443
|
-
if (!isLiveSharedSession(relayUrl, session) || !session
|
|
444
|
-
|
|
445
|
-
sharedRelaySessions.delete(relayUrl)
|
|
508
|
+
if (!isLiveSharedSession(relayUrl, session) || !hasPendingWork(session)) {
|
|
509
|
+
sharedRelaySessions.delete(relayUrl)
|
|
446
510
|
dropWebSocket(ws)
|
|
447
511
|
return
|
|
448
512
|
}
|
|
@@ -454,7 +518,7 @@ function scheduleSharedRelayConnect(relayUrl, session, delayMs = 0) {
|
|
|
454
518
|
url: relayUrl,
|
|
455
519
|
err: String(error?.message || error),
|
|
456
520
|
})
|
|
457
|
-
if (!session
|
|
521
|
+
if (!hasPendingWork(session)) {
|
|
458
522
|
sharedRelaySessions.delete(relayUrl)
|
|
459
523
|
return
|
|
460
524
|
}
|
|
@@ -483,7 +547,10 @@ function acquireSharedRelay(relayUrl) {
|
|
|
483
547
|
ws: null,
|
|
484
548
|
connecting: false,
|
|
485
549
|
reconnectTimer: null,
|
|
550
|
+
idleTimer: null,
|
|
486
551
|
subs: new Map(),
|
|
552
|
+
pendingPublishes: [],
|
|
553
|
+
inflightPublishes: [],
|
|
487
554
|
}
|
|
488
555
|
sharedRelaySessions.set(relayUrl, session)
|
|
489
556
|
scheduleSharedRelayConnect(relayUrl, session)
|
|
@@ -502,9 +569,10 @@ function releaseSharedRelaySub(relayUrl, subscriptionId) {
|
|
|
502
569
|
const { ws } = session
|
|
503
570
|
if (ws?.readyState === WebSocket.OPEN)
|
|
504
571
|
try { ws.send(JSON.stringify(['CLOSE', subscriptionId])) } catch { /* ignore */ }
|
|
505
|
-
if (session
|
|
572
|
+
if (hasPendingWork(session)) return
|
|
506
573
|
sharedRelaySessions.delete(relayUrl)
|
|
507
574
|
clearSharedRelayReconnect(session)
|
|
575
|
+
clearIdleDrop(session)
|
|
508
576
|
if (ws) dropWebSocket(ws)
|
|
509
577
|
}
|
|
510
578
|
|
|
@@ -518,11 +586,112 @@ function releaseSharedRelaySub(relayUrl, subscriptionId) {
|
|
|
518
586
|
*/
|
|
519
587
|
function registerSharedRelaySub(session, subscriptionId, filter, onEvent) {
|
|
520
588
|
session.subs.set(subscriptionId, { filter, onEvent })
|
|
589
|
+
clearIdleDrop(session)
|
|
521
590
|
const { ws } = session
|
|
522
591
|
if (ws?.readyState !== WebSocket.OPEN) return
|
|
523
592
|
try { ws.send(JSON.stringify(['REQ', subscriptionId, filter])) } catch { /* ignore */ }
|
|
524
593
|
}
|
|
525
594
|
|
|
595
|
+
/**
|
|
596
|
+
* 将已入队的 publish 逐个派发到已打开 socket 上;复用 publishEventOnRelay 等 OK 回执。
|
|
597
|
+
* 每个 publish 独立携带自己的 message/abort 监听,socket 共享安全。
|
|
598
|
+
* @param {string} relayUrl 中继 URL
|
|
599
|
+
* @param {SharedRelaySession} session 会话
|
|
600
|
+
* @param {import('ws').WebSocket} socket 已打开连接
|
|
601
|
+
* @returns {void}
|
|
602
|
+
*/
|
|
603
|
+
function flushPendingPublishes(relayUrl, session, socket) {
|
|
604
|
+
const pending = session.pendingPublishes
|
|
605
|
+
session.pendingPublishes = []
|
|
606
|
+
for (const publishRequest of pending) {
|
|
607
|
+
publishRequest.removeAbort?.()
|
|
608
|
+
publishRequest.onAbort = null
|
|
609
|
+
publishRequest.removeAbort = null
|
|
610
|
+
const attempt = ++publishRequest.attempt
|
|
611
|
+
session.inflightPublishes.push(publishRequest)
|
|
612
|
+
void publishEventOnRelay(socket, relayUrl, publishRequest.event, publishRequest.signal, () => publishRequest.attempt === attempt)
|
|
613
|
+
.then(
|
|
614
|
+
ok => settleInflightPublish(relayUrl, session, publishRequest, attempt, () => publishRequest.resolve(ok)),
|
|
615
|
+
error => settleInflightPublish(relayUrl, session, publishRequest, attempt, () => publishRequest.reject(error)),
|
|
616
|
+
)
|
|
617
|
+
}
|
|
618
|
+
}
|
|
619
|
+
|
|
620
|
+
/**
|
|
621
|
+
* 为队列中的 publish 挂上 abort 处理:先移除监听器(释放 signal 对回调/event/session 的引用),
|
|
622
|
+
* 再从队列删除并 reject。
|
|
623
|
+
* @param {SharedRelaySession} session 会话
|
|
624
|
+
* @param {SharedRelaySession['pendingPublishes'][number]} publishRequest 待发请求
|
|
625
|
+
* @returns {void}
|
|
626
|
+
*/
|
|
627
|
+
function attachQueuedAbort(session, publishRequest) {
|
|
628
|
+
const { signal, reject } = publishRequest
|
|
629
|
+
/**
|
|
630
|
+
* 处理 abort 事件
|
|
631
|
+
*/
|
|
632
|
+
publishRequest.onAbort = () => {
|
|
633
|
+
publishRequest.removeAbort?.()
|
|
634
|
+
const pendingIndex = session.pendingPublishes.indexOf(publishRequest)
|
|
635
|
+
if (pendingIndex < 0) return
|
|
636
|
+
session.pendingPublishes.splice(pendingIndex, 1)
|
|
637
|
+
reject(new Error('nostr: aborted'))
|
|
638
|
+
}
|
|
639
|
+
/**
|
|
640
|
+
* 移除 abort 监听器
|
|
641
|
+
*/
|
|
642
|
+
publishRequest.removeAbort = () => {
|
|
643
|
+
if (signal) signal.removeEventListener('abort', publishRequest.onAbort)
|
|
644
|
+
}
|
|
645
|
+
if (signal) signal.addEventListener('abort', publishRequest.onAbort, { once: true })
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
/**
|
|
649
|
+
* publish 在 socket 上得到 OK / 失败 / abort 后结算:从 inflight 移除并 settle。
|
|
650
|
+
* 仅结算仍与当前 attempt 匹配的请求:断线重发后 attempt 已递增,旧尝试的结算在此短路,
|
|
651
|
+
* 避免提前结算重发后的当前尝试。已被 requeue(断线重发)的请求不在 inflight,跳过结算。
|
|
652
|
+
* @param {string} relayUrl 中继 URL
|
|
653
|
+
* @param {SharedRelaySession} session 会话
|
|
654
|
+
* @param {SharedRelaySession['inflightPublishes'][number]} publishRequest 已发送请求
|
|
655
|
+
* @param {number} attempt 本次发送的 attempt 标识
|
|
656
|
+
* @param {() => void} settle 结算回调(resolve/reject)
|
|
657
|
+
* @returns {void}
|
|
658
|
+
*/
|
|
659
|
+
function settleInflightPublish(relayUrl, session, publishRequest, attempt, settle) {
|
|
660
|
+
if (publishRequest.attempt !== attempt) return
|
|
661
|
+
const inflightIndex = session.inflightPublishes.indexOf(publishRequest)
|
|
662
|
+
if (inflightIndex < 0) return
|
|
663
|
+
session.inflightPublishes.splice(inflightIndex, 1)
|
|
664
|
+
settle()
|
|
665
|
+
if (!hasPendingWork(session)) scheduleIdleDrop(relayUrl, session)
|
|
666
|
+
}
|
|
667
|
+
|
|
668
|
+
/**
|
|
669
|
+
* 通过共享 relay 会话发布 EVENT:复用已打开 socket,避免每次 send 重开一条连接(内存泄漏)。
|
|
670
|
+
* 无现成连接时入队并触发连接,连上后由 flushPendingPublishes 统一派发。
|
|
671
|
+
* @param {string} relayUrl 中继 URL
|
|
672
|
+
* @param {object} event 待发布事件
|
|
673
|
+
* @param {AbortSignal} [signal] 取消信号
|
|
674
|
+
* @returns {Promise<boolean>} relay 是否接受 EVENT
|
|
675
|
+
*/
|
|
676
|
+
function publishViaSharedRelay(relayUrl, event, signal) {
|
|
677
|
+
return new Promise((resolve, reject) => {
|
|
678
|
+
if (signal?.aborted) {
|
|
679
|
+
reject(new Error('nostr: aborted'))
|
|
680
|
+
return
|
|
681
|
+
}
|
|
682
|
+
const session = acquireSharedRelay(relayUrl)
|
|
683
|
+
clearIdleDrop(session)
|
|
684
|
+
/** @type {SharedRelaySession['pendingPublishes'][number]} */
|
|
685
|
+
const publishRequest = { event, signal, attempt: 0, resolve, reject, onAbort: null, removeAbort: null }
|
|
686
|
+
attachQueuedAbort(session, publishRequest)
|
|
687
|
+
session.pendingPublishes.push(publishRequest)
|
|
688
|
+
if (session.ws?.readyState === WebSocket.OPEN)
|
|
689
|
+
flushPendingPublishes(relayUrl, session, session.ws)
|
|
690
|
+
else
|
|
691
|
+
scheduleSharedRelayConnect(relayUrl, session)
|
|
692
|
+
})
|
|
693
|
+
}
|
|
694
|
+
|
|
526
695
|
/**
|
|
527
696
|
* 内部:按 rendezvous 键订阅 Nostr kind(topic 不导出)。多订阅共享每 URL 一条连接。
|
|
528
697
|
* @param {string[]} relayUrls 中继 URL 列表
|