@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.
Files changed (2) hide show
  1. package/discovery/nostr.mjs +190 -21
  2. package/package.json +1 -1
@@ -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
- if (!relayUrls.length) throw new Error('nostr: no relay')
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(relayUrls.map(async relayUrl => {
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?.aborted) throw new Error('nostr: aborted')
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
- * 共享 relay 会话:多 SUB 复用同一 URL 的 WebSocket,避免 signal/presence/advert 各建一池。
358
- * 仍有活跃 sub 时断线会自动重连并重发 REQ。
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
- if (!session.subs.size) {
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.subs.size) {
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.subs.size) {
444
- if (!session.subs.size && isLiveSharedSession(relayUrl, session))
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.subs.size) {
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.subs.size) return
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 列表
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@steve02081504/fount-p2p",
3
- "version": "0.0.28",
3
+ "version": "0.0.29",
4
4
  "description": "fount federation P2P layer — link, trust graph, mailbox, DAG, EVFS.",
5
5
  "keywords": [
6
6
  "network",