@minca/core 0.1.10 → 0.1.12

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 (229) hide show
  1. package/README.md +1 -1
  2. package/dist/identity/abilities.js +1 -1
  3. package/dist/identity/channel.d.ts +1 -1
  4. package/dist/identity/channel.d.ts.map +1 -1
  5. package/dist/identity/channel.js +1 -1
  6. package/dist/identity/channel.js.map +1 -1
  7. package/dist/identity/contact-key.d.ts +15 -15
  8. package/dist/identity/contact-key.d.ts.map +1 -1
  9. package/dist/identity/contact-key.js +21 -28
  10. package/dist/identity/contact-key.js.map +1 -1
  11. package/dist/inbox/inbox.d.ts +132 -0
  12. package/dist/inbox/inbox.d.ts.map +1 -0
  13. package/dist/inbox/inbox.js +197 -0
  14. package/dist/inbox/inbox.js.map +1 -0
  15. package/dist/inbox/index.d.ts +9 -0
  16. package/dist/inbox/index.d.ts.map +1 -0
  17. package/dist/inbox/index.js +7 -0
  18. package/dist/inbox/index.js.map +1 -0
  19. package/dist/index.d.ts +8 -6
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +3 -3
  22. package/dist/index.js.map +1 -1
  23. package/dist/network/introductions.d.ts +1 -1
  24. package/dist/network/introductions.d.ts.map +1 -1
  25. package/dist/network/mesh.d.ts +4 -2
  26. package/dist/network/mesh.d.ts.map +1 -1
  27. package/dist/network/mesh.js +31 -45
  28. package/dist/network/mesh.js.map +1 -1
  29. package/dist/network/peer-auth.d.ts +4 -0
  30. package/dist/network/peer-auth.d.ts.map +1 -1
  31. package/dist/network/peer-auth.js +9 -7
  32. package/dist/network/peer-auth.js.map +1 -1
  33. package/dist/network/relay-minca.d.ts +6 -0
  34. package/dist/network/relay-minca.d.ts.map +1 -0
  35. package/dist/network/relay-minca.js +146 -0
  36. package/dist/network/relay-minca.js.map +1 -0
  37. package/dist/network/relay-nostr.d.ts +10 -0
  38. package/dist/network/relay-nostr.d.ts.map +1 -0
  39. package/dist/network/relay-nostr.js +247 -0
  40. package/dist/network/relay-nostr.js.map +1 -0
  41. package/dist/network/relay-socket.d.ts +87 -0
  42. package/dist/network/relay-socket.d.ts.map +1 -0
  43. package/dist/network/{signaling.js → relay-socket.js} +201 -167
  44. package/dist/network/relay-socket.js.map +1 -0
  45. package/dist/network/relays.d.ts +87 -0
  46. package/dist/network/relays.d.ts.map +1 -0
  47. package/dist/network/relays.js +43 -0
  48. package/dist/network/relays.js.map +1 -0
  49. package/dist/network/remote-transport.d.ts +1 -1
  50. package/dist/network/remote-transport.d.ts.map +1 -1
  51. package/dist/network/remote-transport.js +6 -31
  52. package/dist/network/remote-transport.js.map +1 -1
  53. package/dist/network/rendezvous.d.ts +59 -0
  54. package/dist/network/rendezvous.d.ts.map +1 -0
  55. package/dist/network/rendezvous.js +380 -0
  56. package/dist/network/rendezvous.js.map +1 -0
  57. package/dist/network/rtc-transport.d.ts.map +1 -1
  58. package/dist/network/rtc-transport.js +32 -17
  59. package/dist/network/rtc-transport.js.map +1 -1
  60. package/dist/network/transport.d.ts +7 -5
  61. package/dist/network/transport.d.ts.map +1 -1
  62. package/dist/node/actions.d.ts.map +1 -1
  63. package/dist/node/actions.js +28 -18
  64. package/dist/node/actions.js.map +1 -1
  65. package/dist/node/api.d.ts +11 -10
  66. package/dist/node/api.d.ts.map +1 -1
  67. package/dist/node/api.js +11 -10
  68. package/dist/node/api.js.map +1 -1
  69. package/dist/node/carrier.d.ts +11 -5
  70. package/dist/node/carrier.d.ts.map +1 -1
  71. package/dist/node/carrier.js +43 -2
  72. package/dist/node/carrier.js.map +1 -1
  73. package/dist/node/copy.d.ts +1 -1
  74. package/dist/node/copy.d.ts.map +1 -1
  75. package/dist/node/copy.js +10 -4
  76. package/dist/node/copy.js.map +1 -1
  77. package/dist/node/host.d.ts +2 -0
  78. package/dist/node/host.d.ts.map +1 -1
  79. package/dist/node/host.js +2 -0
  80. package/dist/node/host.js.map +1 -1
  81. package/dist/node/index.d.ts +1 -1
  82. package/dist/node/index.d.ts.map +1 -1
  83. package/dist/node/node.d.ts.map +1 -1
  84. package/dist/node/node.js +490 -298
  85. package/dist/node/node.js.map +1 -1
  86. package/dist/node/remote.d.ts.map +1 -1
  87. package/dist/node/remote.js +0 -2
  88. package/dist/node/remote.js.map +1 -1
  89. package/dist/node/space-runtime.d.ts +6 -2
  90. package/dist/node/space-runtime.d.ts.map +1 -1
  91. package/dist/node/space-runtime.js +5 -8
  92. package/dist/node/space-runtime.js.map +1 -1
  93. package/dist/node/types.d.ts +75 -46
  94. package/dist/node/types.d.ts.map +1 -1
  95. package/dist/react/use-invite-link.d.ts +1 -1
  96. package/dist/react/use-invite-link.d.ts.map +1 -1
  97. package/dist/react/use-invite-link.js +18 -11
  98. package/dist/react/use-invite-link.js.map +1 -1
  99. package/dist/records/loose.d.ts +52 -0
  100. package/dist/records/loose.d.ts.map +1 -0
  101. package/dist/records/loose.js +86 -0
  102. package/dist/records/loose.js.map +1 -0
  103. package/dist/schema/version.d.ts +2 -0
  104. package/dist/schema/version.d.ts.map +1 -1
  105. package/dist/schema/version.js +2 -1
  106. package/dist/schema/version.js.map +1 -1
  107. package/dist/schemas/choosing.d.ts +19 -0
  108. package/dist/schemas/choosing.d.ts.map +1 -0
  109. package/dist/schemas/choosing.js +69 -0
  110. package/dist/schemas/choosing.js.map +1 -0
  111. package/dist/schemas/contacts.d.ts +34 -87
  112. package/dist/schemas/contacts.d.ts.map +1 -1
  113. package/dist/schemas/contacts.js +32 -76
  114. package/dist/schemas/contacts.js.map +1 -1
  115. package/dist/schemas/index.d.ts +2 -2
  116. package/dist/schemas/index.d.ts.map +1 -1
  117. package/dist/schemas/index.js +1 -1
  118. package/dist/schemas/index.js.map +1 -1
  119. package/dist/schemas/library/annotations.d.ts +17 -285
  120. package/dist/schemas/library/annotations.d.ts.map +1 -1
  121. package/dist/schemas/library/annotations.js +9 -65
  122. package/dist/schemas/library/annotations.js.map +1 -1
  123. package/dist/schemas/library/community.d.ts +9 -17
  124. package/dist/schemas/library/community.d.ts.map +1 -1
  125. package/dist/schemas/library/community.js +5 -5
  126. package/dist/schemas/library/community.js.map +1 -1
  127. package/dist/schemas/library/life.d.ts +3 -3
  128. package/dist/schemas/library/life.d.ts.map +1 -1
  129. package/dist/schemas/library/life.js +2 -2
  130. package/dist/schemas/library/life.js.map +1 -1
  131. package/dist/schemas/library/media.d.ts +148 -541
  132. package/dist/schemas/library/media.d.ts.map +1 -1
  133. package/dist/schemas/library/media.js +28 -64
  134. package/dist/schemas/library/media.js.map +1 -1
  135. package/dist/schemas/library/money.d.ts +8 -8
  136. package/dist/schemas/library/money.d.ts.map +1 -1
  137. package/dist/schemas/library/money.js +4 -4
  138. package/dist/schemas/library/money.js.map +1 -1
  139. package/dist/schemas/library/planning.d.ts +23 -87
  140. package/dist/schemas/library/planning.d.ts.map +1 -1
  141. package/dist/schemas/library/planning.js +10 -26
  142. package/dist/schemas/library/planning.js.map +1 -1
  143. package/dist/schemas/library/publishing.d.ts +14 -14
  144. package/dist/schemas/library/publishing.d.ts.map +1 -1
  145. package/dist/schemas/library/publishing.js +7 -7
  146. package/dist/schemas/library/publishing.js.map +1 -1
  147. package/dist/schemas/library/social.d.ts +2 -2
  148. package/dist/schemas/library/social.d.ts.map +1 -1
  149. package/dist/schemas/library/social.js +1 -1
  150. package/dist/schemas/library/social.js.map +1 -1
  151. package/dist/schemas/standard.d.ts +1 -1
  152. package/dist/schemas/standard.d.ts.map +1 -1
  153. package/dist/schemas/standard.js +3 -3
  154. package/dist/schemas/standard.js.map +1 -1
  155. package/dist/session/auth.d.ts +5 -6
  156. package/dist/session/auth.d.ts.map +1 -1
  157. package/dist/session/auth.js +5 -6
  158. package/dist/session/auth.js.map +1 -1
  159. package/dist/session/channel-room.d.ts.map +1 -1
  160. package/dist/session/channel-room.js +3 -2
  161. package/dist/session/channel-room.js.map +1 -1
  162. package/dist/session/connect-code.d.ts +69 -55
  163. package/dist/session/connect-code.d.ts.map +1 -1
  164. package/dist/session/connect-code.js +189 -89
  165. package/dist/session/connect-code.js.map +1 -1
  166. package/dist/session/connect.d.ts +11 -15
  167. package/dist/session/connect.d.ts.map +1 -1
  168. package/dist/session/connect.js +8 -21
  169. package/dist/session/connect.js.map +1 -1
  170. package/dist/session/index.d.ts +2 -2
  171. package/dist/session/index.d.ts.map +1 -1
  172. package/dist/session/index.js +1 -1
  173. package/dist/session/index.js.map +1 -1
  174. package/dist/space/account-registry.d.ts +22 -0
  175. package/dist/space/account-registry.d.ts.map +1 -1
  176. package/dist/space/account-registry.js +18 -0
  177. package/dist/space/account-registry.js.map +1 -1
  178. package/dist/space/invitation.d.ts +61 -0
  179. package/dist/space/invitation.d.ts.map +1 -0
  180. package/dist/space/invitation.js +84 -0
  181. package/dist/space/invitation.js.map +1 -0
  182. package/dist/space/invite-link.d.ts +64 -0
  183. package/dist/space/invite-link.d.ts.map +1 -0
  184. package/dist/space/invite-link.js +212 -0
  185. package/dist/space/invite-link.js.map +1 -0
  186. package/dist/space/roles.d.ts.map +1 -1
  187. package/dist/space/roles.js +4 -2
  188. package/dist/space/roles.js.map +1 -1
  189. package/dist/space/space-manager.d.ts +21 -6
  190. package/dist/space/space-manager.d.ts.map +1 -1
  191. package/dist/space/space-manager.js +40 -23
  192. package/dist/space/space-manager.js.map +1 -1
  193. package/dist/types.d.ts +2 -0
  194. package/dist/types.d.ts.map +1 -1
  195. package/dist/types.js.map +1 -1
  196. package/docs/README.md +2 -2
  197. package/docs/actions.md +37 -37
  198. package/docs/agents.md +59 -37
  199. package/docs/automations.md +2 -2
  200. package/docs/blueprints-and-guides.md +44 -3
  201. package/docs/building-an-app.md +2 -2
  202. package/docs/contacts.md +48 -69
  203. package/docs/inbox.md +145 -0
  204. package/docs/node.md +68 -45
  205. package/docs/query-format.md +1 -1
  206. package/docs/sign-in.md +5 -7
  207. package/docs/spaces.md +33 -5
  208. package/docs/standard-library.md +111 -86
  209. package/package.json +6 -5
  210. package/dist/doors/doors.d.ts +0 -140
  211. package/dist/doors/doors.d.ts.map +0 -1
  212. package/dist/doors/doors.js +0 -226
  213. package/dist/doors/doors.js.map +0 -1
  214. package/dist/doors/index.d.ts +0 -9
  215. package/dist/doors/index.d.ts.map +0 -1
  216. package/dist/doors/index.js +0 -7
  217. package/dist/doors/index.js.map +0 -1
  218. package/dist/network/mailbox.d.ts +0 -45
  219. package/dist/network/mailbox.d.ts.map +0 -1
  220. package/dist/network/mailbox.js +0 -135
  221. package/dist/network/mailbox.js.map +0 -1
  222. package/dist/network/multi-signaling.d.ts +0 -41
  223. package/dist/network/multi-signaling.d.ts.map +0 -1
  224. package/dist/network/multi-signaling.js +0 -209
  225. package/dist/network/multi-signaling.js.map +0 -1
  226. package/dist/network/signaling.d.ts +0 -95
  227. package/dist/network/signaling.d.ts.map +0 -1
  228. package/dist/network/signaling.js.map +0 -1
  229. package/docs/doors.md +0 -151
@@ -1,56 +1,23 @@
1
1
  /**
2
- * WebRTC signaling over one WebSocket to a relay.
3
- *
4
- * One socket serves every room this peer is in: it joins and leaves rooms as
5
- * spaces open and close, and joins them all again after a reconnect. It
6
- * reconnects for as long as it is wanted: a relay unreachable for a minute,
7
- * a laptop asleep, a network switched, all end with the socket back.
2
+ * One WebSocket to a relay, of any kind, kept open for as long as it is wanted:
3
+ * a relay unreachable for a minute, a laptop asleep, a network switched, all
4
+ * end with the socket back. Each kind of relay (`relay-minca.ts`,
5
+ * `relay-nostr.ts`) says what to send when it opens and what to make of what
6
+ * comes back; this keeps it open.
8
7
  *
9
8
  * A socket can die without closing: after a sleep or a network switch the
10
- * relay has dropped it and its rooms, but nothing tells this end, which goes
11
- * on looking open to a room with nobody in it. So the client watches its own
12
- * clock: timers stop while a device sleeps, and one that fires long after it
13
- * was due means the device woke, and every socket is dialled again. That
14
- * needs nothing of the relay. Relays that answer `ping` also catch a socket
15
- * that dies while awake; one that never has is not held to it.
9
+ * relay has dropped it, but nothing tells this end, which goes on looking
10
+ * open. So the socket watches its own clock: timers stop while a device
11
+ * sleeps, and one that fires long after it was due means the device woke, and
12
+ * the socket is dialled again. That needs nothing of the relay. A kind that
13
+ * can ask its relay whether it is still there (`ping`) also catches a socket
14
+ * that dies while awake; a relay that never answers is not held to it.
16
15
  */
17
16
  import { createEmitter } from '../utils/events.js';
18
17
  import { isObject } from '../utils/guards.js';
19
18
  import { backoff, createRetry } from '../utils/backoff.js';
20
- const SIGNAL_KINDS = new Set(['offer', 'answer', 'candidate']);
21
- /** Whether a value names an offer, answer or candidate */
22
- export function isSignalKind(value) {
23
- return SIGNAL_KINDS.has(value);
24
- }
25
- /** A relay's TURN offer, kept only if it has the shape of one: `turn:`/`turns:` URLs, a username and a password */
26
- function iceFrom(payload) {
27
- if (!isObject(payload))
28
- return null;
29
- const { servers, expiresAt } = payload;
30
- if (!Array.isArray(servers) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt))
31
- return null;
32
- const kept = [];
33
- for (const server of servers.slice(0, 4)) {
34
- if (!isObject(server))
35
- continue;
36
- const urls = (Array.isArray(server.urls) ? server.urls : [server.urls]).filter((url) => typeof url === 'string' && url.length < 256 && /^turns?:/.test(url));
37
- if (urls.length === 0 || typeof server.username !== 'string' || typeof server.credential !== 'string')
38
- continue;
39
- kept.push({ urls, username: server.username, credential: server.credential });
40
- }
41
- return kept.length > 0 ? { servers: kept, expiresAt } : null;
42
- }
43
- /** What the relay closes a socket with when its DID is already in a room (`packages/relay/relay.mjs`) */
44
- export const CLOSE_DID_TAKEN = 4009;
45
19
  /** Longest wait between attempts. There is no last attempt: a relay that comes back is found again. */
46
20
  const MAX_BACKOFF_MS = 30_000;
47
- /**
48
- * After a refusal: the relay reaps a silent socket within two heartbeats (15 s
49
- * each), so trying much sooner is refused again; and a live node holding the
50
- * DID lets go only when it stops, so each refusal in a row waits twice as long.
51
- */
52
- const DID_TAKEN_WAIT_MS = 10_000;
53
- const MAX_DID_TAKEN_WAIT_MS = 60_000;
54
21
  /** How often the clock is looked at, to notice a sleep */
55
22
  const WAKE_CHECK_MS = 5_000;
56
23
  /** A look this late means the device slept for longer than a relay keeps a silent socket (two 15 s heartbeats) */
@@ -59,26 +26,26 @@ const SLEPT_MS = 30_000;
59
26
  const PING_MS = 30_000;
60
27
  /** Pings in a row a relay may leave unanswered before its socket is taken for dead */
61
28
  const MAX_UNANSWERED = 2;
62
- /** Why a socket closed, for a person to read */
63
- function closeReason(code, reason, opened) {
64
- if (code === CLOSE_DID_TAKEN)
65
- return 'The relay already has a connection with this key: this app open in another tab or window, or an earlier connection it lets go of within 30 seconds.';
66
- if (reason)
67
- return reason;
68
- return opened ? 'The connection to the relay closed.' : 'Could not reach the relay.';
69
- }
29
+ /**
30
+ * Messages a socket sends at most, a second and in a burst: below a Minca
31
+ * relay's budget (50/s, burst 100), so a node in many rooms is paced rather
32
+ * than cut off when it watches them all again and says hello in each.
33
+ */
34
+ const SEND_PER_SECOND = 20;
35
+ const SEND_BURST = 40;
36
+ /** Messages waiting their turn; past this the oldest go, as they would be stale */
37
+ const MAX_QUEUED = 2048;
70
38
  /**
71
39
  * Once connected it stays connected: a socket that closes is opened again,
72
40
  * waiting longer each time up to 30 seconds and never giving up, and sooner
73
41
  * when the device comes back online or its page is looked at again. Only
74
42
  * `disconnect` stops it.
75
43
  */
76
- export function createSignalingClient(url, did) {
44
+ export function createRelaySocket(options) {
45
+ const { url } = options;
77
46
  let ws = null;
78
47
  let wanted = false;
79
- /** Refusals in a row; the count of failures cannot tell them, since a refused socket did open */
80
- let refusals = 0;
81
- const rooms = new Set();
48
+ let topics = 0;
82
49
  /** Lets go of the socket in use as if it had closed, for one that is likely dead */
83
50
  let drop = null;
84
51
  const { on, off, emit } = createEmitter();
@@ -90,20 +57,44 @@ export function createSignalingClient(url, did) {
90
57
  failures: 0,
91
58
  retryAt: null,
92
59
  problem: null,
93
- closeCode: null,
94
- rooms: 0,
60
+ topics: 0,
95
61
  });
96
62
  const setStatus = (patch) => {
97
- const next = { ...status, ...patch, rooms: rooms.size };
63
+ const next = { ...status, ...patch, topics };
98
64
  if (next.state !== status.state)
99
65
  next.since = Date.now();
100
66
  status = Object.freeze(next);
101
67
  emit('status', status);
102
68
  };
103
- const sendMessage = (msg) => {
69
+ // A token bucket: what can't go now waits, in order, for the next token.
70
+ let queue = [];
71
+ let tokens = SEND_BURST;
72
+ let refilled = Date.now();
73
+ let draining;
74
+ const drain = () => {
75
+ draining = undefined;
76
+ const now = Date.now();
77
+ tokens = Math.min(SEND_BURST, tokens + ((now - refilled) / 1000) * SEND_PER_SECOND);
78
+ refilled = now;
79
+ while (queue.length > 0 && tokens >= 1) {
80
+ if (!ws || ws.readyState !== WebSocket.OPEN) {
81
+ queue = [];
82
+ return;
83
+ }
84
+ ws.send(queue.shift());
85
+ tokens -= 1;
86
+ }
87
+ if (queue.length > 0)
88
+ draining = setTimeout(drain, 1000 / SEND_PER_SECOND);
89
+ };
90
+ const send = (message) => {
104
91
  if (!ws || ws.readyState !== WebSocket.OPEN)
105
92
  return;
106
- ws.send(JSON.stringify({ ...msg, from: did }));
93
+ queue.push(JSON.stringify(message));
94
+ if (queue.length > MAX_QUEUED)
95
+ queue.shift();
96
+ if (draining === undefined)
97
+ drain();
107
98
  };
108
99
  // A failed open's close schedules the next try.
109
100
  const retry = createRetry(() => open().catch(() => { }));
@@ -120,7 +111,7 @@ export function createSignalingClient(url, did) {
120
111
  retry.clear();
121
112
  let socket;
122
113
  try {
123
- socket = new WebSocket(url);
114
+ socket = new WebSocket(options.dial);
124
115
  }
125
116
  catch (err) {
126
117
  const error = err instanceof Error ? err : new Error(String(err));
@@ -132,7 +123,7 @@ export function createSignalingClient(url, did) {
132
123
  }
133
124
  ws = socket;
134
125
  let opened = false;
135
- /** Whether this relay answers pings: one that never has (an older relay) is not held to it */
126
+ /** Whether this relay answers pings: one that never has is not held to it */
136
127
  let answers = false;
137
128
  /** Pings sent since the relay last said anything */
138
129
  let unanswered = 0;
@@ -149,23 +140,24 @@ export function createSignalingClient(url, did) {
149
140
  if (ws !== socket)
150
141
  return;
151
142
  opened = true;
152
- setStatus({ state: 'open', openedAt: Date.now(), failures: 0, problem: null, closeCode: null });
143
+ setStatus({ state: 'open', openedAt: Date.now(), failures: 0, problem: null });
153
144
  emit('connected');
154
- for (const room of rooms)
155
- sendMessage({ type: 'join', room });
156
- pinging = setInterval(() => {
157
- // Replaced or let go of, with its close still to come.
158
- if (ws !== socket)
159
- return clearInterval(pinging);
160
- if (heard) {
161
- heard = false;
162
- return;
163
- }
164
- if (answers && unanswered >= MAX_UNANSWERED)
165
- return drop?.('The relay stopped answering.');
166
- unanswered++;
167
- sendMessage({ type: 'ping' });
168
- }, PING_MS);
145
+ options.opened(send);
146
+ const { ping } = options;
147
+ if (ping)
148
+ pinging = setInterval(() => {
149
+ // Replaced or let go of, with its close still to come.
150
+ if (ws !== socket)
151
+ return clearInterval(pinging);
152
+ if (heard) {
153
+ heard = false;
154
+ return;
155
+ }
156
+ if (answers && unanswered >= MAX_UNANSWERED)
157
+ return drop?.('The relay stopped answering.');
158
+ unanswered++;
159
+ send(ping.ask);
160
+ }, PING_MS);
169
161
  resolve();
170
162
  };
171
163
  socket.onmessage = (event) => {
@@ -173,78 +165,49 @@ export function createSignalingClient(url, did) {
173
165
  return;
174
166
  unanswered = 0;
175
167
  heard = true;
168
+ let message;
176
169
  try {
177
- const msg = JSON.parse(String(event.data));
178
- if (!isObject(msg))
179
- throw new Error('Not a signaling message');
180
- const { type, from, room, to, payload } = msg;
181
- if (type === 'pong') {
182
- answers = true;
183
- return;
184
- }
185
- if (type === 'ice') {
186
- const offered = iceFrom(payload);
187
- if (offered)
188
- emit('ice', offered.servers, offered.expiresAt);
189
- return;
190
- }
191
- // The relay stamps who each message is from.
192
- if (typeof from !== 'string')
193
- return;
194
- if (isSignalKind(type))
195
- emit('signal', {
196
- type,
197
- from,
198
- payload,
199
- ...(typeof to === 'string' ? { to } : {}),
200
- ...(typeof room === 'string' ? { room } : {}),
201
- });
202
- else if (typeof room !== 'string')
203
- return;
204
- else if (type === 'join')
205
- emit('peer-joined', from, room);
206
- else if (type === 'leave')
207
- emit('peer-left', from, room);
170
+ message = JSON.parse(String(event.data));
208
171
  }
209
- catch (err) {
210
- emit('error', err instanceof Error ? err : new Error(String(err)));
172
+ catch {
173
+ return;
211
174
  }
175
+ if (options.ping?.isAnswer(message)) {
176
+ answers = true;
177
+ return;
178
+ }
179
+ options.heard(message, send);
212
180
  };
213
181
  socket.onerror = () => {
214
182
  if (ws !== socket)
215
183
  return;
216
- const error = new Error('WebSocket error occurred');
217
- emit('error', error);
218
184
  if (!opened)
219
- reject(error);
185
+ reject(new Error(`Could not reach ${url}`));
220
186
  };
221
187
  // A socket already replaced or let go of says nothing about the one in use.
222
188
  const ended = (event) => {
223
189
  clearInterval(pinging);
190
+ if (ws === socket) {
191
+ queue = [];
192
+ clearTimeout(draining);
193
+ draining = undefined;
194
+ }
224
195
  if (ws !== socket)
225
196
  return;
226
197
  ws = null;
227
198
  drop = null;
228
199
  const failures = opened ? 0 : status.failures + 1;
229
- const problem = closeReason(event?.code, event?.reason, opened);
230
- setStatus({ failures, problem, closeCode: event?.code ?? null });
231
- const refused = event?.code === CLOSE_DID_TAKEN;
232
- refusals = refused ? refusals + 1 : 0;
200
+ const problem = event?.reason || (opened ? 'The connection to the relay closed.' : 'Could not reach the relay.');
201
+ setStatus({ failures, problem });
233
202
  if (opened)
234
203
  emit('disconnected');
235
204
  else
236
205
  reject(new Error(problem));
237
- if (refused)
238
- emit('refused');
239
206
  if (!wanted) {
240
207
  setStatus({ state: 'stopped', retryAt: null });
241
208
  return;
242
209
  }
243
- // Refused for holding the DID twice: an old socket goes at the relay's pace, and
244
- // another node's when it stops; either way, asking every second does not help.
245
- scheduleRetry(refused
246
- ? Math.min(DID_TAKEN_WAIT_MS * 2 ** (refusals - 1), MAX_DID_TAKEN_WAIT_MS)
247
- : backoff(failures, MAX_BACKOFF_MS));
210
+ scheduleRetry(backoff(failures, MAX_BACKOFF_MS));
248
211
  };
249
212
  socket.onclose = ended;
250
213
  });
@@ -283,52 +246,123 @@ export function createSignalingClient(url, did) {
283
246
  redial();
284
247
  }, WAKE_CHECK_MS);
285
248
  };
286
- const connect = () => {
287
- if (!wanted) {
288
- wanted = true;
289
- listen(true);
290
- }
291
- return open();
292
- };
293
- const disconnect = () => {
294
- const was = status.state === 'open';
295
- if (wanted)
296
- listen(false);
297
- wanted = false;
298
- retry.clear();
299
- const socket = ws;
300
- ws = null;
301
- drop = null;
302
- socket?.close();
303
- rooms.clear();
304
- refusals = 0;
305
- setStatus({ state: 'stopped', retryAt: null, failures: 0 });
306
- if (was)
307
- emit('disconnected');
308
- };
309
249
  return Object.freeze({
310
- connect,
311
- disconnect,
312
- join: (room) => {
313
- if (rooms.has(room))
314
- return;
315
- rooms.add(room);
316
- sendMessage({ type: 'join', room });
317
- setStatus({});
250
+ connect: () => {
251
+ if (!wanted) {
252
+ wanted = true;
253
+ listen(true);
254
+ }
255
+ return open();
318
256
  },
319
- leave: (room) => {
320
- if (!rooms.delete(room))
321
- return;
322
- sendMessage({ type: 'leave', room });
323
- setStatus({});
257
+ disconnect: () => {
258
+ const was = status.state === 'open';
259
+ if (wanted)
260
+ listen(false);
261
+ wanted = false;
262
+ retry.clear();
263
+ const socket = ws;
264
+ ws = null;
265
+ drop = null;
266
+ queue = [];
267
+ clearTimeout(draining);
268
+ draining = undefined;
269
+ socket?.close();
270
+ topics = 0;
271
+ setStatus({ state: 'stopped', retryAt: null, failures: 0 });
272
+ if (was)
273
+ emit('disconnected');
324
274
  },
325
- signal: (kind, targetDid, payload) => sendMessage({ type: kind, to: targetDid, payload }),
326
- requestIce: () => sendMessage({ type: 'ice' }),
327
275
  reconnect,
328
- on,
329
- off,
276
+ send,
330
277
  isConnected: () => status.state === 'open',
331
278
  status: () => status,
279
+ count: (watched) => {
280
+ topics = watched;
281
+ setStatus({});
282
+ },
283
+ on,
284
+ off,
332
285
  });
333
286
  }
334
- //# sourceMappingURL=signaling.js.map
287
+ /**
288
+ * A short conversation with a relay on a socket of its own: `start` says the
289
+ * first thing, `hear` answers what comes back (it may `send` again) and
290
+ * settles it by returning a value. Mailboxes talk this way, so the relay can't
291
+ * tie what is dropped or fetched to a peer's long-lived socket.
292
+ */
293
+ export function converse(dial, options, start, hear) {
294
+ const Socket = options.WebSocket ?? globalThis.WebSocket;
295
+ if (!Socket)
296
+ return Promise.reject(new Error('No WebSocket here to reach a relay with'));
297
+ return new Promise((resolve, reject) => {
298
+ let settled = false;
299
+ let ws;
300
+ try {
301
+ ws = new Socket(dial);
302
+ }
303
+ catch (error) {
304
+ reject(error instanceof Error ? error : new Error(String(error)));
305
+ return;
306
+ }
307
+ const settle = () => {
308
+ if (settled)
309
+ return false;
310
+ settled = true;
311
+ clearTimeout(timer);
312
+ try {
313
+ ws.close();
314
+ }
315
+ catch {
316
+ // already closing
317
+ }
318
+ return true;
319
+ };
320
+ const fail = (error) => {
321
+ if (settle())
322
+ reject(error);
323
+ };
324
+ const timer = setTimeout(() => fail(new Error(`${dial} did not answer`)), options.timeoutMs);
325
+ const say = (message) => ws.send(JSON.stringify(message));
326
+ ws.onopen = () => start(say);
327
+ ws.onerror = () => fail(new Error(`Could not reach ${dial}`));
328
+ ws.onclose = () => fail(new Error(`${dial} closed the connection`));
329
+ ws.onmessage = (event) => {
330
+ let answer;
331
+ try {
332
+ answer = JSON.parse(String(event.data));
333
+ }
334
+ catch {
335
+ return;
336
+ }
337
+ Promise.resolve()
338
+ .then(() => hear(answer, say))
339
+ .then((value) => {
340
+ if (value !== undefined && settle())
341
+ resolve(value);
342
+ }, (error) => fail(error instanceof Error ? error : new Error(String(error))));
343
+ };
344
+ });
345
+ }
346
+ /** A relay's TURN offer, kept only if it has the shape of one: `turn:`/`turns:` URLs, a username and a password */
347
+ export function iceFrom(payload) {
348
+ if (!isObject(payload))
349
+ return null;
350
+ const { servers, expiresAt } = payload;
351
+ if (!Array.isArray(servers) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt))
352
+ return null;
353
+ const kept = [];
354
+ for (const server of servers.slice(0, 4)) {
355
+ if (!isObject(server))
356
+ continue;
357
+ const urls = (Array.isArray(server.urls) ? server.urls : [server.urls]).filter((url) => typeof url === 'string' && url.length < 256 && /^turns?:/.test(url));
358
+ if (urls.length === 0 || typeof server.username !== 'string' || typeof server.credential !== 'string')
359
+ continue;
360
+ kept.push({ urls, username: server.username, credential: server.credential });
361
+ }
362
+ return kept.length > 0 ? { servers: kept, expiresAt } : null;
363
+ }
364
+ /** What to dial for a relay: its address with the kind taken off the scheme (`nostr+wss://x` → `wss://x`) */
365
+ export function dialOf(url) {
366
+ return url.replace(/^[a-z][a-z0-9.-]*\+(wss?:)/i, '$1');
367
+ }
368
+ //# sourceMappingURL=relay-socket.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relay-socket.js","sourceRoot":"","sources":["../../src/network/relay-socket.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Relays of every kind behind one contract (spec 04 §1). A relay moves sealed
3
+ * blobs under a topic and understands none of them: peers meet by publishing
4
+ * to a room's topic (`rendezvous.ts`), and an inbox or a short link leaves
5
+ * blobs to be fetched later (a mailbox).
6
+ *
7
+ * A relay's kind is its URL's scheme: `wss://` is a Minca relay
8
+ * (`relay-minca.ts`), `nostr+wss://` a Nostr relay (`relay-nostr.ts`). A
9
+ * kind this library doesn't know is passed over, so a space can name one
10
+ * before every member's app can use it.
11
+ */
12
+ import type { RelayStatus } from './relay-socket.js';
13
+ export type RelayLinkEvents = {
14
+ /** A blob published under a topic this link watches */
15
+ blob: (topic: string, blob: string) => void;
16
+ /**
17
+ * TURN servers the relay offers, with passwords that stop working at
18
+ * `expiresAt` (ms). Only Minca relays with TURN offer them.
19
+ */
20
+ ice: (servers: ReadonlyArray<RTCIceServer>, expiresAt: number) => void;
21
+ connected: () => void;
22
+ disconnected: () => void;
23
+ /** The socket opened, closed, or is waiting to try again */
24
+ status: (status: RelayStatus) => void;
25
+ };
26
+ /** A socket to one relay, kept open, publishing and watching topics that are not kept */
27
+ export interface RelayLink {
28
+ readonly url: string;
29
+ readonly connect: () => Promise<void>;
30
+ readonly disconnect: () => void;
31
+ /** Tries again now, if waiting to */
32
+ readonly reconnect: () => void;
33
+ /** Hears what is published under a topic, now and after every reconnect */
34
+ readonly watch: (topic: string) => void;
35
+ readonly unwatch: (topic: string) => void;
36
+ /** Hands a blob to whoever watches the topic now; nobody keeps it */
37
+ readonly publish: (topic: string, blob: string) => void;
38
+ /** Asks for fresh TURN passwords; they arrive as an `ice` event, from relays that have TURN */
39
+ readonly requestIce: () => void;
40
+ readonly isConnected: () => boolean;
41
+ readonly status: () => RelayStatus;
42
+ readonly on: <K extends keyof RelayLinkEvents>(event: K, callback: RelayLinkEvents[K]) => void;
43
+ readonly off: <K extends keyof RelayLinkEvents>(event: K, callback: RelayLinkEvents[K]) => void;
44
+ }
45
+ /** One blob a mailbox holds */
46
+ export interface MailItem {
47
+ /** Increases with every blob that mailbox takes; fetch `after` the last one seen */
48
+ readonly seq: number;
49
+ /** base64url SHA-256 of the blob: the same at every mailbox */
50
+ readonly id: string;
51
+ readonly blob: string;
52
+ }
53
+ export interface MailboxClient {
54
+ /**
55
+ * Leaves a blob under a topic, kept for `ttlSeconds` or the relay's own
56
+ * limit, whichever is shorter.
57
+ * @returns The blob's id
58
+ * @throws When the relay refuses it, or can't be reached
59
+ */
60
+ drop(relay: string, topic: string, blob: string, ttlSeconds?: number): Promise<string>;
61
+ /** Everything a relay holds under a topic, after a sequence number, in at most `pages` pages (default 8) */
62
+ fetch(relay: string, topic: string, after?: number, pages?: number): Promise<ReadonlyArray<MailItem>>;
63
+ /**
64
+ * Clears blobs from a topic — all of them, or those named — as the inbox's
65
+ * owner: shows the signing key and signs the relay's challenge with it.
66
+ * @throws Where the relay's kind can't clear (a Nostr relay)
67
+ */
68
+ purge(relay: string, topic: string, sign: string, ids: ReadonlyArray<string> | null, signChallenge: (nonce: string) => Promise<string>): Promise<number>;
69
+ }
70
+ export interface MailboxOptions {
71
+ /** How long to wait for a relay to answer. Default 8 seconds. */
72
+ readonly timeoutMs?: number;
73
+ /** The WebSocket to use. Default the global one (browsers, Node 22+). */
74
+ readonly WebSocket?: typeof WebSocket;
75
+ }
76
+ /** The kinds of relay this library speaks */
77
+ export type RelayKind = 'minca' | 'nostr';
78
+ /**
79
+ * A relay's kind, from its scheme: `wss:` (or `ws:`) is Minca's own,
80
+ * `nostr+wss:` Nostr's; null for a kind this library doesn't speak.
81
+ */
82
+ export declare function relayKind(url: string): RelayKind | null;
83
+ /** A socket to a relay, or null for a kind this library doesn't speak */
84
+ export declare function createRelayLink(url: string): RelayLink | null;
85
+ /** Mailboxes of every kind: each call goes to the kind its relay's URL names */
86
+ export declare function createMailboxClient(options?: MailboxOptions): MailboxClient;
87
+ //# sourceMappingURL=relays.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relays.d.ts","sourceRoot":"","sources":["../../src/network/relays.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import { createMincaLink, createMincaMailbox } from './relay-minca.js';
2
+ import { createNostrLink, createNostrMailbox } from './relay-nostr.js';
3
+ /**
4
+ * A relay's kind, from its scheme: `wss:` (or `ws:`) is Minca's own,
5
+ * `nostr+wss:` Nostr's; null for a kind this library doesn't speak.
6
+ */
7
+ export function relayKind(url) {
8
+ const scheme = /^([a-z][a-z0-9+.-]*):/i.exec(url)?.[1]?.toLowerCase();
9
+ if (scheme === 'wss' || scheme === 'ws')
10
+ return 'minca';
11
+ if (scheme === 'nostr+wss' || scheme === 'nostr+ws')
12
+ return 'nostr';
13
+ return null;
14
+ }
15
+ /** A socket to a relay, or null for a kind this library doesn't speak */
16
+ export function createRelayLink(url) {
17
+ const kind = relayKind(url);
18
+ if (kind === 'minca')
19
+ return createMincaLink(url);
20
+ if (kind === 'nostr')
21
+ return createNostrLink(url);
22
+ return null;
23
+ }
24
+ /** Mailboxes of every kind: each call goes to the kind its relay's URL names */
25
+ export function createMailboxClient(options = {}) {
26
+ const minca = createMincaMailbox(options);
27
+ const nostr = createNostrMailbox(options);
28
+ const of = (relay) => {
29
+ const kind = relayKind(relay);
30
+ if (kind === 'minca')
31
+ return minca;
32
+ if (kind === 'nostr')
33
+ return nostr;
34
+ throw new Error(`${relay} is a kind of relay this app doesn't speak`);
35
+ };
36
+ const client = {
37
+ drop: (relay, topic, blob, ttl) => of(relay).drop(relay, topic, blob, ttl),
38
+ fetch: (relay, topic, after, pages) => of(relay).fetch(relay, topic, after, pages),
39
+ purge: (relay, topic, sign, ids, signChallenge) => of(relay).purge(relay, topic, sign, ids, signChallenge),
40
+ };
41
+ return Object.freeze(client);
42
+ }
43
+ //# sourceMappingURL=relays.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relays.js","sourceRoot":"","sources":["../../src/network/relays.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA+EvE;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACtE,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IACxD,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,OAAO,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAAmB,EAAE;IAC9D,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,CAAC,KAAa,EAAiB,EAAE;QAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;QACnC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,4CAA4C,CAAC,CAAC;IACxE,CAAC,CAAC;IACF,MAAM,MAAM,GAAkB;QAC5B,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC;QAC1E,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;QAClF,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,EAAE,CAChD,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC;KAC1D,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}
@@ -3,7 +3,7 @@
3
3
  * other. A node running in a worker can't count on `RTCPeerConnection` being
4
4
  * there (not every browser has it in workers), so the page keeps the
5
5
  * connections (`serveTransport`) and the worker's mesh drives them
6
- * (`remoteTransport`): offers, answers and candidates go one way, frames and
6
+ * (`remoteTransport`): offers and answers go one way, frames and
7
7
  * connection events come back.
8
8
  *
9
9
  * The ICE servers travel with each offer and answer, because the mesh in the