@nervur.org/installer-node 0.0.0-stage → 0.37.1

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 (362) hide show
  1. package/LICENSE +105 -0
  2. package/README.md +158 -2
  3. package/SECURITY.md +8 -0
  4. package/bin/nervur.js +5 -0
  5. package/cargo/emscripten-module.wasm +0 -0
  6. package/cargo/manifest.json +1 -0
  7. package/cargo/sqlite3.wasm +0 -0
  8. package/cargo/table-i-i.wasm +0 -0
  9. package/cargo/table-i-ii.wasm +0 -0
  10. package/cargo/table-i-iii.wasm +0 -0
  11. package/cargo/table-i-iiii.wasm +0 -0
  12. package/cargo/table-i-iiiii.wasm +0 -0
  13. package/cargo/table-i-iiij.wasm +0 -0
  14. package/cargo/table-i-ij.wasm +0 -0
  15. package/cargo/table-v-ii.wasm +0 -0
  16. package/cargo/table-v-iii.wasm +0 -0
  17. package/cargo/worker.js +30756 -0
  18. package/organs/console/node/guard.d.ts +10 -0
  19. package/organs/console/node/guard.js +52 -0
  20. package/organs/console/node/index.d.ts +4 -0
  21. package/organs/console/node/index.js +5 -0
  22. package/organs/console/node/line.d.ts +16 -0
  23. package/organs/console/node/line.js +150 -0
  24. package/organs/console/node/main.js +51 -0
  25. package/organs/console/node/program.d.ts +1 -0
  26. package/organs/console/node/program.js +5 -0
  27. package/organs/console/node/proof.d.ts +15 -0
  28. package/organs/console/node/proof.js +84 -0
  29. package/organs/console/node/socket.d.ts +15 -0
  30. package/organs/console/node/socket.js +99 -0
  31. package/organs/disk/index.d.ts +1 -0
  32. package/organs/disk/index.js +2 -0
  33. package/organs/disk/node/files.js +162 -0
  34. package/organs/disk/node/main.js +20 -0
  35. package/organs/disk/node/program.d.ts +1 -0
  36. package/organs/disk/node/program.js +5 -0
  37. package/organs/disk/organ.d.ts +5 -0
  38. package/organs/disk/organ.js +69 -0
  39. package/organs/network/node/fill.d.ts +21 -0
  40. package/organs/network/node/fill.js +195 -0
  41. package/organs/network/node/flows.js +66 -0
  42. package/organs/network/node/half.js +260 -0
  43. package/organs/network/node/lines.d.ts +29 -0
  44. package/organs/network/node/lines.js +236 -0
  45. package/organs/network/node/link.d.ts +24 -0
  46. package/organs/network/node/link.js +215 -0
  47. package/organs/network/node/main.js +41 -0
  48. package/organs/network/node/moved.d.ts +2 -0
  49. package/organs/network/node/moved.js +20 -0
  50. package/organs/network/node/near.d.ts +63 -0
  51. package/organs/network/node/near.js +263 -0
  52. package/organs/network/node/program.d.ts +1 -0
  53. package/organs/network/node/program.js +5 -0
  54. package/organs/network/node/schemes.d.ts +1 -0
  55. package/organs/network/node/schemes.js +2 -0
  56. package/organs/network/node/sent.d.ts +13 -0
  57. package/organs/network/node/sent.js +101 -0
  58. package/organs/network/node/served.d.ts +19 -0
  59. package/organs/network/node/served.js +237 -0
  60. package/organs/screen/node/client.js +3 -0
  61. package/organs/screen/node/follow.js +266 -0
  62. package/organs/screen/node/frames.js +26 -0
  63. package/organs/screen/node/held.js +27 -0
  64. package/organs/screen/node/http.js +179 -0
  65. package/organs/screen/node/lay.js +116 -0
  66. package/organs/screen/node/leave.js +27 -0
  67. package/organs/screen/node/linked.js +69 -0
  68. package/organs/screen/node/listen.js +61 -0
  69. package/organs/screen/node/look.js +121 -0
  70. package/organs/screen/node/loop.js +154 -0
  71. package/organs/screen/node/main.js +74 -0
  72. package/organs/screen/node/mirror.js +112 -0
  73. package/organs/screen/node/notice.js +44 -0
  74. package/organs/screen/node/presser.js +11 -0
  75. package/organs/screen/node/presses.js +108 -0
  76. package/organs/screen/node/program.d.ts +1 -0
  77. package/organs/screen/node/program.js +5 -0
  78. package/organs/screen/node/shown.js +205 -0
  79. package/organs/screen/node/standing.js +29 -0
  80. package/organs/screen/node/state.js +80 -0
  81. package/organs/screen/node/tell.js +47 -0
  82. package/organs/screen/node/uid.js +65 -0
  83. package/organs/screen/node/worn.js +23 -0
  84. package/organs/shell/index.d.ts +1 -0
  85. package/organs/shell/index.js +2 -0
  86. package/organs/shell/node/main.js +26 -0
  87. package/organs/shell/node/output.js +70 -0
  88. package/organs/shell/node/pressure.js +14 -0
  89. package/organs/shell/node/program.d.ts +1 -0
  90. package/organs/shell/node/program.js +5 -0
  91. package/organs/shell/node/runs.js +220 -0
  92. package/organs/shell/node/told.js +70 -0
  93. package/organs/shell/organ.d.ts +5 -0
  94. package/organs/shell/organ.js +59 -0
  95. package/package.json +43 -4
  96. package/src/command/act.d.ts +31 -0
  97. package/src/command/act.js +256 -0
  98. package/src/command/answers.d.ts +3 -0
  99. package/src/command/answers.js +232 -0
  100. package/src/command/args.d.ts +14 -0
  101. package/src/command/args.js +220 -0
  102. package/src/command/arrive.d.ts +2 -0
  103. package/src/command/arrive.js +21 -0
  104. package/src/command/asked.d.ts +18 -0
  105. package/src/command/asked.js +49 -0
  106. package/src/command/backup.d.ts +18 -0
  107. package/src/command/backup.js +261 -0
  108. package/src/command/before.d.ts +41 -0
  109. package/src/command/before.js +237 -0
  110. package/src/command/born.d.ts +27 -0
  111. package/src/command/born.js +103 -0
  112. package/src/command/bridge.d.ts +19 -0
  113. package/src/command/bridge.js +152 -0
  114. package/src/command/chain.d.ts +9 -0
  115. package/src/command/chain.js +48 -0
  116. package/src/command/channel.d.ts +29 -0
  117. package/src/command/channel.js +263 -0
  118. package/src/command/choices.d.ts +35 -0
  119. package/src/command/choices.js +173 -0
  120. package/src/command/claim.d.ts +12 -0
  121. package/src/command/claim.js +46 -0
  122. package/src/command/commands.d.ts +16 -0
  123. package/src/command/commands.js +257 -0
  124. package/src/command/ends.d.ts +16 -0
  125. package/src/command/ends.js +78 -0
  126. package/src/command/follow.d.ts +12 -0
  127. package/src/command/follow.js +66 -0
  128. package/src/command/given.d.ts +39 -0
  129. package/src/command/given.js +53 -0
  130. package/src/command/held.d.ts +15 -0
  131. package/src/command/held.js +56 -0
  132. package/src/command/index.d.ts +1 -0
  133. package/src/command/index.js +203 -0
  134. package/src/command/jailer.d.ts +28 -0
  135. package/src/command/jailer.js +135 -0
  136. package/src/command/laid.d.ts +6 -0
  137. package/src/command/laid.js +31 -0
  138. package/src/command/left.d.ts +9 -0
  139. package/src/command/left.js +34 -0
  140. package/src/command/line.d.ts +7 -0
  141. package/src/command/line.js +39 -0
  142. package/src/command/link.d.ts +30 -0
  143. package/src/command/link.js +123 -0
  144. package/src/command/lobes.d.ts +1 -0
  145. package/src/command/lobes.js +10 -0
  146. package/src/command/locks.d.ts +17 -0
  147. package/src/command/locks.js +76 -0
  148. package/src/command/mcp/calls.d.ts +27 -0
  149. package/src/command/mcp/calls.js +155 -0
  150. package/src/command/mcp/notices.d.ts +22 -0
  151. package/src/command/mcp/notices.js +203 -0
  152. package/src/command/mcp/resources.d.ts +31 -0
  153. package/src/command/mcp/resources.js +108 -0
  154. package/src/command/mcp/server.d.ts +19 -0
  155. package/src/command/mcp/server.js +149 -0
  156. package/src/command/mcp/tools.d.ts +39 -0
  157. package/src/command/mcp/tools.js +131 -0
  158. package/src/command/mcp.d.ts +8 -0
  159. package/src/command/mcp.js +39 -0
  160. package/src/command/noticed.d.ts +11 -0
  161. package/src/command/noticed.js +55 -0
  162. package/src/command/older.d.ts +11 -0
  163. package/src/command/older.js +45 -0
  164. package/src/command/open.d.ts +24 -0
  165. package/src/command/open.js +107 -0
  166. package/src/command/passphrase.d.ts +6 -0
  167. package/src/command/passphrase.js +82 -0
  168. package/src/command/reclaim.d.ts +7 -0
  169. package/src/command/reclaim.js +47 -0
  170. package/src/command/refused.d.ts +4 -0
  171. package/src/command/refused.js +27 -0
  172. package/src/command/release.d.ts +27 -0
  173. package/src/command/release.js +153 -0
  174. package/src/command/repo.d.ts +31 -0
  175. package/src/command/repo.js +133 -0
  176. package/src/command/rewrap.d.ts +16 -0
  177. package/src/command/rewrap.js +175 -0
  178. package/src/command/runtime.d.ts +25 -0
  179. package/src/command/runtime.js +175 -0
  180. package/src/command/salvage.d.ts +4 -0
  181. package/src/command/salvage.js +42 -0
  182. package/src/command/screen.d.ts +14 -0
  183. package/src/command/screen.js +62 -0
  184. package/src/command/spawn.d.ts +23 -0
  185. package/src/command/spawn.js +213 -0
  186. package/src/command/start.d.ts +34 -0
  187. package/src/command/start.js +246 -0
  188. package/src/command/state.d.ts +5 -0
  189. package/src/command/state.js +39 -0
  190. package/src/command/token.d.ts +1 -0
  191. package/src/command/token.js +9 -0
  192. package/src/command/trial.d.ts +17 -0
  193. package/src/command/trial.js +92 -0
  194. package/src/command/vouch.d.ts +1 -0
  195. package/src/command/vouch.js +15 -0
  196. package/src/command/windows-processes.d.ts +2 -0
  197. package/src/command/windows-processes.js +22 -0
  198. package/src/command/wipe.d.ts +9 -0
  199. package/src/command/wipe.js +105 -0
  200. package/src/command/words.d.ts +5 -0
  201. package/src/command/words.js +53 -0
  202. package/src/door/claim.d.ts +5 -0
  203. package/src/door/claim.js +21 -0
  204. package/src/door/claimed.d.ts +7 -0
  205. package/src/door/claimed.js +110 -0
  206. package/src/door/configuration.d.ts +40 -0
  207. package/src/door/configuration.js +206 -0
  208. package/src/door/design.d.ts +13 -0
  209. package/src/door/design.js +71 -0
  210. package/src/door/digests.d.ts +7 -0
  211. package/src/door/digests.js +36 -0
  212. package/src/door/distribution.d.ts +25 -0
  213. package/src/door/distribution.js +88 -0
  214. package/src/door/door.d.ts +41 -0
  215. package/src/door/door.js +219 -0
  216. package/src/door/dressed.d.ts +34 -0
  217. package/src/door/dressed.js +182 -0
  218. package/src/door/faculties.d.ts +29 -0
  219. package/src/door/faculties.js +88 -0
  220. package/src/door/longest.d.ts +6 -0
  221. package/src/door/longest.js +25 -0
  222. package/src/fills/account-only.d.ts +3 -0
  223. package/src/fills/account-only.js +24 -0
  224. package/src/fills/boot-key.d.ts +21 -0
  225. package/src/fills/boot-key.js +70 -0
  226. package/src/fills/boot-move.d.ts +25 -0
  227. package/src/fills/boot-move.js +86 -0
  228. package/src/fills/bridge.d.ts +13 -0
  229. package/src/fills/bridge.js +86 -0
  230. package/src/fills/chance.d.ts +2 -0
  231. package/src/fills/chance.js +7 -0
  232. package/src/fills/crypto.d.ts +2 -0
  233. package/src/fills/crypto.js +94 -0
  234. package/src/fills/flushed.d.ts +9 -0
  235. package/src/fills/flushed.js +80 -0
  236. package/src/fills/hardware.d.ts +18 -0
  237. package/src/fills/hardware.js +70 -0
  238. package/src/fills/held.d.ts +31 -0
  239. package/src/fills/held.js +171 -0
  240. package/src/fills/keepers.d.ts +23 -0
  241. package/src/fills/keepers.js +151 -0
  242. package/src/fills/keyring.d.ts +19 -0
  243. package/src/fills/keyring.js +131 -0
  244. package/src/fills/pages.d.ts +3 -0
  245. package/src/fills/pages.js +260 -0
  246. package/src/fills/reserve.d.ts +11 -0
  247. package/src/fills/reserve.js +72 -0
  248. package/src/fills/time.d.ts +2 -0
  249. package/src/fills/time.js +29 -0
  250. package/src/fills/unlocker.d.ts +6 -0
  251. package/src/fills/unlocker.js +26 -0
  252. package/src/fills/vitals.d.ts +8 -0
  253. package/src/fills/vitals.js +100 -0
  254. package/src/fills/windows-start.d.ts +2 -0
  255. package/src/fills/windows-start.js +21 -0
  256. package/src/halves/build.d.ts +10 -0
  257. package/src/halves/build.js +219 -0
  258. package/src/halves/end.d.ts +17 -0
  259. package/src/halves/end.js +157 -0
  260. package/src/halves/genome.d.ts +3 -0
  261. package/src/halves/genome.js +21 -0
  262. package/src/halves/handler.d.ts +8 -0
  263. package/src/halves/handler.js +40 -0
  264. package/src/halves/index.d.ts +5 -0
  265. package/src/halves/index.js +6 -0
  266. package/src/halves/laid.d.ts +12 -0
  267. package/src/halves/laid.js +103 -0
  268. package/src/halves/lent.d.ts +6 -0
  269. package/src/halves/lent.js +147 -0
  270. package/src/halves/native.d.ts +12 -0
  271. package/src/halves/native.js +53 -0
  272. package/src/halves/statements.d.ts +23 -0
  273. package/src/halves/statements.js +165 -0
  274. package/src/halves/tokens.d.ts +22 -0
  275. package/src/halves/tokens.js +135 -0
  276. package/src/link/link.d.ts +4 -0
  277. package/src/link/link.js +4 -0
  278. package/src/link/placeholder.d.ts +1 -0
  279. package/src/link/placeholder.js +21 -0
  280. package/src/link/steps.d.ts +52 -0
  281. package/src/link/steps.js +118 -0
  282. package/src/lobes/calls.d.ts +76 -0
  283. package/src/lobes/calls.js +61 -0
  284. package/src/lobes/channel.d.ts +76 -0
  285. package/src/lobes/channel.js +202 -0
  286. package/src/lobes/index.d.ts +1 -0
  287. package/src/lobes/index.js +2 -0
  288. package/src/lobes/lobes.d.ts +15 -0
  289. package/src/lobes/lobes.js +244 -0
  290. package/src/lobes/main.js +107 -0
  291. package/src/lobes/thread.d.ts +22 -0
  292. package/src/lobes/thread.js +270 -0
  293. package/src/organism/act.d.ts +8 -0
  294. package/src/organism/act.js +63 -0
  295. package/src/organism/beat.d.ts +5 -0
  296. package/src/organism/beat.js +45 -0
  297. package/src/organism/compiled.d.ts +2 -0
  298. package/src/organism/compiled.js +24 -0
  299. package/src/organism/folder.d.ts +88 -0
  300. package/src/organism/folder.js +259 -0
  301. package/src/organism/main.d.ts +1 -0
  302. package/src/organism/main.js +11 -0
  303. package/src/organism/organism.d.ts +1 -0
  304. package/src/organism/organism.js +219 -0
  305. package/src/organism/said.d.ts +12 -0
  306. package/src/organism/said.js +30 -0
  307. package/src/organism/told.d.ts +5 -0
  308. package/src/organism/told.js +110 -0
  309. package/src/organism/unlock.d.ts +8 -0
  310. package/src/organism/unlock.js +95 -0
  311. package/src/organism/upgrade.d.ts +24 -0
  312. package/src/organism/upgrade.js +145 -0
  313. package/src/organism/via.d.ts +7 -0
  314. package/src/organism/via.js +20 -0
  315. package/src/service/body.d.ts +8 -0
  316. package/src/service/body.js +34 -0
  317. package/src/service/handler.d.ts +20 -0
  318. package/src/service/handler.js +128 -0
  319. package/src/service/index.d.ts +4 -0
  320. package/src/service/index.js +16 -0
  321. package/src/service/manager.d.ts +18 -0
  322. package/src/service/manager.js +185 -0
  323. package/src/service/service.d.ts +24 -0
  324. package/src/service/service.js +200 -0
  325. package/src/service/swap.d.ts +12 -0
  326. package/src/service/swap.js +74 -0
  327. package/src/service/watchdog.d.ts +6 -0
  328. package/src/service/watchdog.js +31 -0
  329. package/src/tcp/crowd.d.ts +18 -0
  330. package/src/tcp/crowd.js +85 -0
  331. package/src/tcp/dial.d.ts +23 -0
  332. package/src/tcp/dial.js +102 -0
  333. package/src/tcp/frame.d.ts +23 -0
  334. package/src/tcp/frame.js +159 -0
  335. package/src/tcp/listen.d.ts +50 -0
  336. package/src/tcp/listen.js +207 -0
  337. package/src/tcp/source.d.ts +2 -0
  338. package/src/tcp/source.js +26 -0
  339. package/src/version/index.d.ts +1 -0
  340. package/src/version/index.js +2 -0
  341. package/src/version/version.d.ts +1 -0
  342. package/src/version/version.js +2 -0
  343. package/src/work/first.d.ts +11 -0
  344. package/src/work/first.js +91 -0
  345. package/src/work/index.d.ts +2 -0
  346. package/src/work/index.js +15 -0
  347. package/src/work/work.d.ts +20 -0
  348. package/src/work/work.js +136 -0
  349. package/src/ws/dial.d.ts +7 -0
  350. package/src/ws/dial.js +252 -0
  351. package/src/ws/dialing.d.ts +50 -0
  352. package/src/ws/dialing.js +72 -0
  353. package/src/ws/frame.d.ts +32 -0
  354. package/src/ws/frame.js +124 -0
  355. package/src/ws/handshake.d.ts +4 -0
  356. package/src/ws/handshake.js +27 -0
  357. package/src/ws/line.d.ts +45 -0
  358. package/src/ws/line.js +250 -0
  359. package/src/ws/listen.d.ts +42 -0
  360. package/src/ws/listen.js +272 -0
  361. package/src/ws/rfc6455.d.ts +18 -0
  362. package/src/ws/rfc6455.js +187 -0
@@ -0,0 +1,260 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { WEB_PIECE, } from '@nervur.org/genome/seams';
3
+ import { error, isFields, result, } from '@nervur.org/genome/standard';
4
+
5
+ import { dialingOf, sendOf } from '../../../src/tcp/dial.js';
6
+ import { boundedBy, listeningOf, listenOf, LONGEST_SPAN, openedOf, replyOf } from '../../../src/tcp/listen.js';
7
+ import { flowsOf, } from './flows.js';
8
+ import { PORT_SCHEMES } from './schemes.js';
9
+ import { isLine, lineAsks, linesOf, } from './lines.js';
10
+ import { textsIn, webOf } from './served.js';
11
+
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+
22
+
23
+ const refused = (message ) => error('refused', message);
24
+
25
+ const unavailable = ({ why } ) => error('unavailable', why);
26
+
27
+ const textAt = (args , key ) => (typeof args[key] === 'string' ? args[key] : null);
28
+
29
+ const waitAt = (args ) => {
30
+ const wait = args['wait'];
31
+ return typeof wait === 'number' && Number.isSafeInteger(wait) && wait >= 0 ? wait : null;
32
+ };
33
+
34
+ const exchangeAt = (args ) => {
35
+ const exchange = args['exchange'];
36
+ return typeof exchange === 'number' && Number.isSafeInteger(exchange) && exchange >= 0 ? exchange : null;
37
+ };
38
+
39
+ const pieceIn = (data ) => {
40
+ if (!isFields(data)) return null;
41
+ const { body, more } = data;
42
+ return body instanceof Uint8Array && body.length <= WEB_PIECE && typeof more === 'boolean'
43
+ ? { bytes: body, more }
44
+ : null;
45
+ };
46
+
47
+ const responseIn = (data ) => {
48
+ if (!isFields(data)) return null;
49
+ const { status } = data;
50
+ const headers = textsIn(data['headers'] ?? {});
51
+ const body = pieceIn(data);
52
+ if (typeof status !== 'number' || !Number.isSafeInteger(status) || status < 100 || status > 599) return null;
53
+ return headers === null || body === null ? null : { status, headers, body };
54
+ };
55
+
56
+
57
+
58
+
59
+
60
+
61
+
62
+
63
+ const listensOf = (listen , tell ) => {
64
+ const listens = new Map ();
65
+ return (endpoint) => {
66
+ const kept = listens.get(endpoint);
67
+ if (kept !== undefined) return kept;
68
+ const listened = listen(
69
+ endpoint,
70
+ (exchange, bytes, ward, source) =>
71
+ tell('arrived', {
72
+ endpoint,
73
+ carrier: 'tcp',
74
+ exchange,
75
+ bytes,
76
+ ...(ward === undefined ? {} : { ward }),
77
+ ...(source === undefined ? {} : { source }),
78
+ }),
79
+ (now) => tell('addresses', { endpoint, addresses: [...now] }),
80
+ ).then((found) => {
81
+ if ('why' in found) listens.delete(endpoint);
82
+ return found;
83
+ });
84
+ listens.set(endpoint, listened);
85
+ return listened;
86
+ };
87
+ };
88
+
89
+ const wordsIn = (data ) => {
90
+ if (!isFields(data)) return null;
91
+ const words = {};
92
+ for (const [name, word] of Object.entries(data)) {
93
+ if (typeof word !== 'number' || !Number.isSafeInteger(word) || word < 1) return null;
94
+ words[name] = word;
95
+ }
96
+ return words;
97
+ };
98
+
99
+ const replyAsk = (args , listening , lines ) => {
100
+ const exchange = exchangeAt(args);
101
+ const bytes = args['bytes'];
102
+ const carrier = args['carrier'];
103
+ if (
104
+ exchange === null ||
105
+ !(bytes === null || bytes instanceof Uint8Array) ||
106
+ !(carrier === 'tcp' || carrier === 'ws' || carrier === 'line')
107
+ )
108
+ return refused('a reply names its exchange, its carrier, and bytes or null');
109
+ if (carrier === 'tcp') replyOf(listening)(exchange, bytes);
110
+ else lines.reply(carrier, exchange, bytes);
111
+ return result(null);
112
+ };
113
+
114
+ const openedAsk = (args , listening , lines ) => {
115
+ const exchange = exchangeAt(args);
116
+ const carrier = args['carrier'];
117
+ if (exchange === null || !(carrier === 'tcp' || carrier === 'ws' || carrier === 'line'))
118
+ return refused('an opened names its exchange and its carrier');
119
+ if (carrier === 'tcp') openedOf(listening)(exchange);
120
+ else lines.opened(carrier, exchange);
121
+ return result(null);
122
+ };
123
+
124
+ const quoAsks = (announced , named , tell ) => {
125
+ const counted = (count ) => () => tell('counted', { count });
126
+ const listening = listeningOf(undefined, counted('unreplied'));
127
+ const dialing = dialingOf(counted('redialed'));
128
+ const lines = linesOf(announced, named, tell);
129
+ const listenTo = listensOf(listenOf(listening, announced), tell);
130
+ const asks = new Map ();
131
+ asks.set('schemes', () => result([...PORT_SCHEMES]));
132
+ asks.set('listen', async (args) => {
133
+ const endpoint = textAt(args, 'endpoint');
134
+ if (endpoint === null) return refused('a listen names its endpoint');
135
+ const found = await (isLine(endpoint) ? lines.listen(endpoint) : listenTo(endpoint));
136
+ return 'why' in found ? unavailable(found) : result({ addresses: [...found.addresses] });
137
+ });
138
+ asks.set('reply', (args) => replyAsk(args, listening, lines));
139
+ asks.set('opened', (args) => openedAsk(args, listening, lines));
140
+ asks.set('send', async (args) => {
141
+ const address = textAt(args, 'address');
142
+ const { bytes, ward } = args;
143
+ const wait = waitAt(args);
144
+ if (address === null || !(bytes instanceof Uint8Array) || wait === null)
145
+ return refused('a send names its address, its bytes and its wait');
146
+ if (ward !== undefined && typeof ward !== 'string') return refused('a ward is a text');
147
+ const sent = await (isLine(address)
148
+ ? lines.send(address, bytes, wait, ward)
149
+ : sendOf(dialing)(address, bytes, wait, ward));
150
+ return 'why' in sent ? unavailable(sent) : result({ reply: sent.reply });
151
+ });
152
+ for (const [name, ask] of Object.entries(lineAsks(lines))) asks.set(name, ask);
153
+ const close = () => {
154
+ for (const line of dialing.lines.values()) line.socket.destroy();
155
+ for (const socket of listening.sockets) socket.destroy();
156
+ for (const server of listening.servers) server.close();
157
+ lines.close();
158
+ };
159
+ const bounds = (words) => {
160
+ boundedBy(listening, words);
161
+ lines.bounds(words);
162
+ };
163
+ return { asks, close, bounds };
164
+ };
165
+
166
+ const requestIn = (data ) => {
167
+ if (!isFields(data)) return null;
168
+ const { method, url } = data;
169
+ const headers = textsIn(data['headers'] ?? {});
170
+ const body = pieceIn(data);
171
+ return typeof method !== 'string' || typeof url !== 'string' || headers === null || body === null
172
+ ? null
173
+ : { method, url, headers, body };
174
+ };
175
+
176
+ const pieceOut = (piece ) => ({
177
+ body: piece.bytes,
178
+ more: piece.more,
179
+ });
180
+
181
+ const flowAsks = (asks , flows ) => {
182
+ asks.set('piece', async (args) => {
183
+ const flow = textAt(args, 'flow');
184
+ const pulled = flow === null ? null : flows.pull(flow);
185
+ if (pulled === null) return refused('no body that came holds more under that flow');
186
+ const piece = await pulled;
187
+ return 'why' in piece ? unavailable(piece) : result(pieceOut(piece));
188
+ });
189
+ asks.set('put', (args) => {
190
+ const flow = textAt(args, 'flow');
191
+ const why = textAt(args, 'why');
192
+ const piece = why === null ? pieceIn(args) : { why };
193
+ if (flow === null || piece === null || !flows.put(flow, piece))
194
+ return refused('a put names a flow that wants a piece, and the piece or why none comes');
195
+ return result(null);
196
+ });
197
+ };
198
+
199
+ const webAsks = (announced , tell ) => {
200
+ const web = webOf(announced);
201
+ const asks = new Map ();
202
+ const flows = flowsOf((flow) => tell('wants', { flow }));
203
+ asks.set('serve', async (args) => {
204
+ const endpoint = textAt(args, 'endpoint');
205
+ if (endpoint === null) return refused('a serve names its endpoint');
206
+ const found = await web.serve(endpoint, (exchange, request, rest) => {
207
+ if (request.body.more) flows.came(`e${exchange}`, rest);
208
+ const { body, ...head } = request;
209
+ tell('requested', { endpoint, exchange, request: { ...head, headers: { ...head.headers }, ...pieceOut(body) } });
210
+ });
211
+ return 'why' in found ? unavailable(found) : result({ origin: found.origin });
212
+ });
213
+ flowAsks(asks, flows);
214
+ asks.set('respond', (args) => {
215
+ const exchange = exchangeAt(args);
216
+ const response = responseIn(args['response']);
217
+ if (exchange === null || response === null)
218
+ return refused('a respond names its exchange and a response, its status, headers and first piece');
219
+ web.respond(exchange, response, flows.wanted(`e${exchange}`));
220
+ return result(null);
221
+ });
222
+ asks.set('request', async (args) => {
223
+ const request = requestIn(args['request']);
224
+ const wait = waitAt(args);
225
+ const flow = textAt(args, 'flow');
226
+ if (request === null || wait === null || flow === null)
227
+ return refused('a request names its method, URL, headers and first piece, its wait and its flow');
228
+ const sent = await web.request(request, flows.wanted(flow), wait);
229
+ if ('why' in sent) return unavailable(sent);
230
+ if (sent.response.body.more) flows.came(flow, sent.rest);
231
+ const { status, headers, body } = sent.response;
232
+ return result({ status, headers: { ...headers }, ...pieceOut(body) });
233
+ });
234
+ const bounds = (words) => {
235
+ web.bound(words);
236
+ flows.bound(words['wait'] === undefined ? undefined : Math.min(words['wait'], LONGEST_SPAN));
237
+ };
238
+ return { asks, close: web.close, bounds };
239
+ };
240
+
241
+ export const networkHalfOf = (announced , named , tell ) => {
242
+ const carriers = [quoAsks(announced, named, tell), webAsks(announced, tell)];
243
+ const asks = new Map(carriers.flatMap((one) => [...one.asks]));
244
+ asks.set('bounds', (args) => {
245
+ const words = wordsIn(args['words']);
246
+ if (words === null) return refused('a bounds names its words, each a count');
247
+ for (const one of carriers) one.bounds(words);
248
+ return result(null);
249
+ });
250
+ return {
251
+ answer: (method, args) => {
252
+ const ask = asks.get(method);
253
+ if (ask === undefined) return error('unavailable', `network's half holds no ${method}`);
254
+ return isFields(args) ? ask(args) : refused(`the args of ${method} are no object`);
255
+ },
256
+ close: () => {
257
+ for (const one of carriers) one.close();
258
+ },
259
+ };
260
+ };
@@ -0,0 +1,29 @@
1
+ import { type Proven } from '@nervur.org/genome/seams';
2
+ import { type Answer as Answered, type Data, type Fields } from '@nervur.org/genome/standard';
3
+ import { type Wanted } from '../../../src/ws/dialing.js';
4
+ import type { Answer } from '../../../src/ws/line.js';
5
+ export type Carrier = 'tcp' | 'ws' | 'line';
6
+ export type Told = (method: 'arrived' | 'held' | 'declared' | 'counted' | 'challenged', args: Data) => void;
7
+ type Listened = {
8
+ readonly addresses: readonly string[];
9
+ } | {
10
+ readonly why: string;
11
+ };
12
+ export type Lines = {
13
+ readonly bounds: (words: {
14
+ readonly [name: string]: number;
15
+ }) => void;
16
+ readonly listen: (endpoint: string) => Promise<Listened>;
17
+ readonly send: (address: string, bytes: Uint8Array, wait: number, ward: string | undefined) => Promise<Answer>;
18
+ readonly reply: (carrier: 'ws' | 'line', exchange: number, bytes: Uint8Array | null) => void;
19
+ readonly opened: (carrier: 'ws' | 'line', exchange: number) => void;
20
+ readonly hold: (lines: readonly Wanted[]) => readonly string[];
21
+ readonly proved: (address: string, nonce: Uint8Array, proven: readonly Proven[]) => void;
22
+ readonly close: () => void;
23
+ };
24
+ export declare const isLine: (address: string) => boolean;
25
+ export declare const linesOf: (announced: string | null, named: readonly string[], tell: Told) => Lines;
26
+ export declare const lineAsks: (lines: Lines) => {
27
+ readonly [name: string]: (args: Fields) => Answered;
28
+ };
29
+ export {};
@@ -0,0 +1,236 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { BOX_SIZE, } from '@nervur.org/genome/seams';
3
+ import { error, isFields, result, } from '@nervur.org/genome/standard';
4
+ import { holdOf, provedOf, replyOn as replyHeld, sendOf as sendHeld } from '../../../src/ws/dial.js';
5
+ import { dialingOf, SETTINGS, } from '../../../src/ws/dialing.js';
6
+ import { addressOf } from '../../../src/ws/frame.js';
7
+
8
+ import {
9
+ boundedBy,
10
+ listeningOf,
11
+ listenOf,
12
+ openedOn,
13
+ replyOn as replyListened,
14
+ sendOf as sendListened,
15
+
16
+ } from '../../../src/ws/listen.js';
17
+
18
+
19
+
20
+
21
+
22
+
23
+
24
+
25
+
26
+
27
+
28
+
29
+
30
+
31
+
32
+
33
+
34
+
35
+
36
+
37
+ export const isLine = (address ) => /^wss?:\/\//i.test(address);
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+ const upWithinOf =
47
+ (dialing , waiting ) =>
48
+ (address , wait ) => {
49
+ if (dialing.lines.get(address)?.up === true) return Promise.resolve('up');
50
+ return new Promise((done) => {
51
+ const woke = (came ) => {
52
+ clearTimeout(timer);
53
+ waiting.get(address)?.delete(woke);
54
+ done(came);
55
+ };
56
+ const timer = setTimeout(() => {
57
+ waiting.get(address)?.delete(woke);
58
+ done('silent');
59
+ }, wait);
60
+ waiting.set(address, (waiting.get(address) ?? new Set()).add(woke));
61
+ });
62
+ };
63
+
64
+ const onceOf = () => {
65
+ const waiting = new Map ();
66
+ const users = new Map ();
67
+ const missed = new Map ();
68
+ const told = (address , came ) => {
69
+ for (const woke of waiting.get(address) ?? []) woke(came);
70
+ };
71
+ const dialing = dialingOf(
72
+ (exchange) => replyHeld(dialing)(exchange, null),
73
+ (address, up) => {
74
+ if (up) told(address, 'up');
75
+ },
76
+ () => undefined,
77
+ undefined,
78
+ undefined,
79
+ (address, bounded) => told(address, bounded ? 'bounded' : 'refused'),
80
+ );
81
+ const hold = () => {
82
+ holdOf(dialing)([...users.keys()].map((address) => ({ address, wards: [] })));
83
+ };
84
+ const upWithin = upWithinOf(dialing, waiting);
85
+ const send = async (address, bytes, wait, ward) => {
86
+ const began = performance.now();
87
+ const last = missed.get(address);
88
+ if (last !== undefined && began - last < SETTINGS.last)
89
+ return {
90
+ why: `no line to ${address} came up within the last ${SETTINGS.last} ms`,
91
+ };
92
+ missed.delete(address);
93
+ users.set(address, (users.get(address) ?? 0) + 1);
94
+ hold();
95
+ try {
96
+ const came = await upWithin(address, wait);
97
+ if (came === 'bounded') return { reply: null };
98
+ if (came !== 'up') {
99
+ if (came === 'silent') missed.set(address, performance.now());
100
+ return { why: `no line to ${address} came up` };
101
+ }
102
+ return await sendHeld(dialing)(address, bytes, Math.max(0, wait - (performance.now() - began)), ward);
103
+ } finally {
104
+ const left = (users.get(address) ?? 1) - 1;
105
+ if (left > 0) users.set(address, left);
106
+ else users.delete(address);
107
+ hold();
108
+ }
109
+ };
110
+ return { send, close: () => holdOf(dialing)([]) };
111
+ };
112
+
113
+ const listensOf = (
114
+ listening ,
115
+ announced ,
116
+ named ,
117
+ own ,
118
+ tell ,
119
+ ) => {
120
+ const listens = new Map ();
121
+ return (endpoint) => {
122
+ const kept = listens.get(endpoint);
123
+ if (kept !== undefined) return kept;
124
+ const listened = listenOf(listening, announced)(
125
+ endpoint,
126
+ (exchange, bytes, ward, source) =>
127
+ tell('arrived', {
128
+ endpoint,
129
+ carrier: 'ws',
130
+ exchange,
131
+ bytes,
132
+ ward,
133
+ source,
134
+ }),
135
+ (wards, up) => tell('declared', { endpoint, wards: [...wards], up }),
136
+ ).then((found) => {
137
+ if ('why' in found) {
138
+ listens.delete(endpoint);
139
+ return found;
140
+ }
141
+ for (const address of found.addresses) own.add(address);
142
+ for (const address of named) own.add(address);
143
+ return { addresses: named.length === 0 ? found.addresses : [...named] };
144
+ });
145
+ listens.set(endpoint, listened);
146
+ return listened;
147
+ };
148
+ };
149
+
150
+ export const linesOf = (announced , named , tell ) => {
151
+ const counted = (count ) => () => tell('counted', { count });
152
+ const listening = listeningOf(undefined, counted('unreplied'));
153
+ const held = dialingOf(
154
+ (exchange, bytes, ward) => tell('arrived', { carrier: 'line', exchange, bytes, ward }),
155
+ (address, up) => tell('held', { address, up }),
156
+ (address, { nonce, identity }) => tell('challenged', { address, nonce, identity }),
157
+ counted('redialed'),
158
+ );
159
+ const once = onceOf();
160
+ const own = new Set ();
161
+
162
+ const send = (address, bytes, wait, ward) => {
163
+ if (addressOf(address) === null) return Promise.resolve({ why: `${address} is no ws address` });
164
+ if (bytes.length > BOX_SIZE)
165
+ return Promise.resolve({
166
+ why: `${bytes.length} bytes is more than a box holds`,
167
+ });
168
+ if (ward === undefined) return Promise.resolve({ why: 'an ask over a line names its ward' });
169
+ if (own.has(address)) return sendListened(listening)(ward, bytes, wait);
170
+ return held.lines.has(address) ? sendHeld(held)(address, bytes, wait, ward) : once.send(address, bytes, wait, ward);
171
+ };
172
+
173
+ return {
174
+ bounds: (words) => boundedBy(listening, words),
175
+ listen: listensOf(listening, announced, named, own, tell),
176
+ send,
177
+ reply: (carrier, exchange, bytes) =>
178
+ (carrier === 'ws' ? replyListened(listening) : replyHeld(held))(exchange, bytes),
179
+ opened: (carrier, exchange) => {
180
+ if (carrier === 'ws') openedOn(listening)(exchange);
181
+ },
182
+ hold: holdOf(held),
183
+ proved: provedOf(held),
184
+ close: () => {
185
+ holdOf(held)([]);
186
+ once.close();
187
+ for (const line of listening.named.keys()) line.socket.destroy();
188
+ for (const server of listening.servers) server.close();
189
+ },
190
+ };
191
+ };
192
+
193
+ const texts = (list ) => Array.isArray(list) && list.every((one) => typeof one === 'string');
194
+
195
+ const linesIn = (data ) => {
196
+ if (!Array.isArray(data)) return null;
197
+ const wanted = [];
198
+ for (const one of data) {
199
+ if (!isFields(one)) return null;
200
+ const { address, wards, ping } = one;
201
+ if (typeof address !== 'string' || !texts(wards)) return null;
202
+ if (ping !== undefined && !(typeof ping === 'number' && Number.isSafeInteger(ping) && ping > 0)) return null;
203
+ wanted.push({
204
+ address,
205
+ wards: [...wards],
206
+ ...(ping === undefined ? {} : { ping }),
207
+ });
208
+ }
209
+ return wanted;
210
+ };
211
+
212
+ const provenIn = (data ) => {
213
+ if (!Array.isArray(data)) return null;
214
+ const proven = [];
215
+ for (const one of data) {
216
+ if (!isFields(one) || typeof one['ward'] !== 'string' || !(one['proof'] instanceof Uint8Array)) return null;
217
+ proven.push({ ward: one['ward'], proof: one['proof'] });
218
+ }
219
+ return proven;
220
+ };
221
+
222
+ export const lineAsks = (lines ) => ({
223
+ hold: (args) => {
224
+ const wanted = linesIn(args['lines']);
225
+ if (wanted === null) return error('refused', 'a hold names its lines, each an address and its wards');
226
+ return result({ refused: [...lines.hold(wanted)] });
227
+ },
228
+ proved: (args) => {
229
+ const { address, nonce } = args;
230
+ const proven = provenIn(args['proofs']);
231
+ if (typeof address !== 'string' || !(nonce instanceof Uint8Array) || proven === null)
232
+ return error('refused', 'a proved names its address, its nonce and its wards with their proofs');
233
+ lines.proved(address, nonce, proven);
234
+ return result(null);
235
+ },
236
+ });
@@ -0,0 +1,24 @@
1
+ import { type Line, type Stream, type WebArrival, type WebPiece, type WebResponse } from '@nervur.org/genome/seams';
2
+ import { type Answer, type Data, type Fields } from '@nervur.org/genome/standard';
3
+ import type { Near } from './near.js';
4
+ export type Link = {
5
+ readonly connected: boolean;
6
+ readonly ask: (method: string, args: Data, within?: number) => Promise<Answer>;
7
+ readonly close: () => Promise<void>;
8
+ };
9
+ export type Linking = {
10
+ readonly first: string;
11
+ readonly within: number;
12
+ readonly connected: (link: Link) => void;
13
+ readonly told: (method: string, args: Fields) => void;
14
+ readonly ended: (why: string) => void;
15
+ };
16
+ export declare const fieldIn: (data: Data, key: string) => Data;
17
+ export declare const textIn: (data: Data, key: string) => string | null;
18
+ export declare const addressesIn: (data: Data) => readonly string[] | null;
19
+ export declare const wantedIn: (lines: readonly Line[]) => Data;
20
+ export declare const pieceIn: (data: Data | undefined) => WebPiece | null;
21
+ export declare const responseIn: (data: Data) => WebResponse | null;
22
+ export declare const arrivalIn: (data: Data | undefined) => WebArrival | null;
23
+ export declare const linkOf: (stream: Stream, linking: Linking) => Link;
24
+ export declare const answeredOf: (near: Pick<Near, 'holding' | 'link'>, address: unknown, nonce: unknown, identity: unknown) => void;