@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,107 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { spawn } from 'node:child_process';
3
+ import { mkdirSync, writeFileSync } from 'node:fs';
4
+ import { join } from 'node:path';
5
+ import { pathToFileURL } from 'node:url';
6
+ import { readFolder } from '../organism/folder.js';
7
+ import { stateAt } from './asked.js';
8
+ import { organismOf, } from './given.js';
9
+ import { isLink } from './link.js';
10
+ import { screenOf } from './screen.js';
11
+ import { runningOf } from './spawn.js';
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+ export const openerOf = (platform ) => {
22
+ if (platform === 'darwin') return ['/usr/bin/open'];
23
+ if (platform === 'linux') return ['xdg-open'];
24
+ if (platform === 'win32') return ['rundll32', 'url.dll,FileProtocolHandler'];
25
+ return null;
26
+ };
27
+
28
+ const shown = (address ) => {
29
+ const opener = openerOf(process.platform);
30
+ const [program, ...words] = opener ?? [];
31
+ if (program === undefined) return Promise.resolve(`Node's installer opens no address on ${process.platform} yet`);
32
+ return new Promise((resolve) => {
33
+ const child = spawn(program, [...words, address], { detached: true, stdio: 'ignore' });
34
+ child.once('error', (thrown) => resolve(`${program} did not start: ${thrown.message}`));
35
+ child.once('spawn', () => {
36
+ child.unref();
37
+ resolve(null);
38
+ });
39
+ });
40
+ };
41
+
42
+ export const screenIn = async (home ) => {
43
+ const organism = organismOf(home);
44
+ const read = readFolder(organism);
45
+ if ('why' in read) return read;
46
+ if (runningOf(organism) === null)
47
+ return { why: 'the organism is not running: start it with `nervur start`, then open the link again' };
48
+ const state = await stateAt(organism);
49
+ return 'why' in state ? state : screenOf(state.data);
50
+ };
51
+
52
+ export const reachesOf = (home ) => ({
53
+ screen: () => screenIn(home),
54
+ show: shown,
55
+ write: (file, text) => {
56
+ mkdirSync(home, { recursive: true });
57
+ writeFileSync(file, text, { mode: 0o600 });
58
+ },
59
+ });
60
+
61
+ const escaped = (text ) => text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
62
+
63
+ export const notTaken = (why ) =>
64
+ [
65
+ '<!doctype html>',
66
+ '<meta charset="utf-8">',
67
+ '<meta name="viewport" content="width=device-width">',
68
+ '<title>Nervur</title>',
69
+ '<body style="font: 1rem/1.5 system-ui, sans-serif; max-width: 34rem; margin: 4rem auto; padding: 0 1rem">',
70
+ '<h1 style="font-size: 1.25rem">The link was not opened</h1>',
71
+ `<p>${escaped(why)}</p>`,
72
+ '<p>Nothing was accepted, and the link is not spent.</p>',
73
+ '',
74
+ ].join('\n');
75
+
76
+ export const openLink = async (
77
+ link ,
78
+ home ,
79
+ reaches ,
80
+ ) => {
81
+ const screen =
82
+ link !== undefined && isLink(link) ? await reaches.screen() : { why: 'what was opened is no link of Quo' };
83
+ let why ;
84
+ if ('address' in screen) {
85
+ const address = `${screen.address}#${encodeURIComponent(link ?? '')}`;
86
+ const failed = await reaches.show(address);
87
+ if (failed === null) return { opened: address };
88
+ why = failed;
89
+ } else why = screen.why;
90
+ const file = join(home, 'link-not-opened.html');
91
+ reaches.write(file, notTaken(why));
92
+ const unseen = await reaches.show(pathToFileURL(file).href);
93
+ return unseen === null
94
+ ? { told: why }
95
+ : { why: `the link was not opened: ${why}; and that could not be shown: ${unseen}` };
96
+ };
97
+
98
+ export const open = async (given , reaches = reachesOf(given.home)) => {
99
+ const done = await openLink(given.words[1], given.home, reaches);
100
+ if ('why' in done) return done;
101
+ given.print(
102
+ 'opened' in done
103
+ ? 'This home’s screen is opened at the link, in your browser: it asks there before anything is accepted.'
104
+ : `The link was not opened: ${done.told}. Nothing was accepted.`,
105
+ );
106
+ return null;
107
+ };
@@ -0,0 +1,6 @@
1
+ export type Asker = {
2
+ readonly ask: (prompt: string) => Promise<string | null>;
3
+ readonly close: () => void;
4
+ };
5
+ export declare const askerOf: () => Asker;
6
+ export declare const askedOnce: (asker: Asker) => Asker;
@@ -0,0 +1,82 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+
3
+
4
+
5
+
6
+
7
+
8
+ const ENTER = new Set(['\r', '\n']);
9
+ const ERASE = new Set(['\u007f', '\b']);
10
+ const INTERRUPT = '\u0003';
11
+ const END = '\u0004';
12
+
13
+ const unseen = (prompt ) =>
14
+ new Promise((done) => {
15
+ const { stdin, stderr } = process;
16
+ stderr.write(prompt);
17
+ stdin.setRawMode(true);
18
+ stdin.resume();
19
+ let typed = '';
20
+ const finish = (line ) => {
21
+ stdin.off('data', typing);
22
+ stdin.setRawMode(false);
23
+ stdin.pause();
24
+ stderr.write('\n');
25
+ done(line);
26
+ };
27
+ const typing = (chunk ) => {
28
+ for (const char of chunk.toString('utf8')) {
29
+ if (ENTER.has(char)) return finish(typed);
30
+ if (char === INTERRUPT || char === END) return finish(null);
31
+ typed = ERASE.has(char) ? typed.slice(0, -1) : typed + char;
32
+ }
33
+ };
34
+ stdin.on('data', typing);
35
+ });
36
+
37
+ const piped = () => {
38
+ const lines = [];
39
+ const waiting = [];
40
+ let held = '';
41
+ let ended = false;
42
+ process.stdin.setEncoding('utf8');
43
+ process.stdin.on('data', (chunk ) => {
44
+ held += chunk;
45
+ const parts = held.split('\n');
46
+ held = parts.pop() ?? '';
47
+ for (const line of parts) {
48
+ const next = waiting.shift();
49
+ if (next === undefined) lines.push(line);
50
+ else next(line);
51
+ }
52
+ });
53
+ process.stdin.on('end', () => {
54
+ ended = true;
55
+ for (const next of waiting.splice(0)) next(null);
56
+ });
57
+ return {
58
+ ask: (prompt) => {
59
+ process.stderr.write(`${prompt}\n`);
60
+ const line = lines.shift();
61
+ if (line !== undefined) return Promise.resolve(line);
62
+ if (ended) return Promise.resolve(null);
63
+ return new Promise((done) => waiting.push(done));
64
+ },
65
+ close: () => process.stdin.destroy(),
66
+ };
67
+ };
68
+
69
+ export const askerOf = () =>
70
+ process.stdin.isTTY ? { ask: unseen, close: () => process.stdin.pause() } : piped();
71
+
72
+ export const askedOnce = (asker ) => {
73
+ const heard = new Map ();
74
+ return {
75
+ ...asker,
76
+ ask: (question) => {
77
+ const asked = heard.get(question) ?? asker.ask(question);
78
+ heard.set(question, asked);
79
+ return asked;
80
+ },
81
+ };
82
+ };
@@ -0,0 +1,7 @@
1
+ import { type Given, type Outcome } from './given.js';
2
+ type Why = {
3
+ readonly why: string;
4
+ };
5
+ export declare const reclaimEnded: (started: Why | null, opened: Why | null) => Outcome;
6
+ export declare const reclaim: (given: Given) => Promise<Outcome>;
7
+ export {};
@@ -0,0 +1,47 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { hex, unhex } from '@nervur.org/genome/standard';
3
+ import { layFolderAgain, readFolder } from '../organism/folder.js';
4
+ import { unclaimed } from './claim.js';
5
+ import { humanEnds } from '../fills/held.js';
6
+ import { organismOf, } from './given.js';
7
+ import { bootKeyIn, doorHere, stoppedHere } from './held.js';
8
+ import { startedOn } from './start.js';
9
+
10
+
11
+
12
+ const signerOf =
13
+ (given ) =>
14
+ async (challenge ) => {
15
+ given.print(`The reclaim's challenge, to sign with a recovery key's secret off this device: ${hex(challenge)}`);
16
+ const typed = await given.asker.ask('Its Ed25519 signature, as hex: ');
17
+ const read = typed === null ? null : unhex(typed.trim());
18
+ return read === null || 'why' in read ? null : read.bytes;
19
+ };
20
+
21
+ export const reclaimEnded = (started , opened ) => {
22
+ if (started !== null) return started;
23
+ return opened === null ? null : { why: `the organism is not reclaimed: ${opened.why}; it boots as it stood` };
24
+ };
25
+
26
+ export const reclaim = async (given ) => {
27
+ const home = organismOf(given.home);
28
+ const folder = readFolder(home);
29
+ if ('why' in folder) return folder;
30
+ const { laid } = folder;
31
+ const key = await bootKeyIn(given, home, laid);
32
+ if ('why' in key) return key;
33
+ const halted = await stoppedHere(home);
34
+ if (halted !== null) return halted;
35
+ const opened = await doorHere(given, home, unclaimed(laid), { kind: 'reclaim', sign: signerOf(given) }, key.key);
36
+ if (!('why' in opened)) await opened.door.stop();
37
+ const forgot = 'why' in opened || unclaimed(laid) === laid ? null : layFolderAgain(home, unclaimed(laid));
38
+ const started = await startedOn(home, humanEnds(laid) ? key.key : null);
39
+ const ended = reclaimEnded(started, 'why' in opened ? opened : null);
40
+ if (ended !== null) return ended;
41
+ if (forgot !== null)
42
+ return { why: `the organism is reclaimed, its anchor the console's, but its claim still stands: ${forgot.why}` };
43
+ given.print(
44
+ 'The organism is reclaimed: every relation to its brain ended, each lobe wired to it but the present ones switched off, and its anchor taken anew.',
45
+ );
46
+ return null;
47
+ };
@@ -0,0 +1,4 @@
1
+ export declare const NPM_DEFAULT = "https://registry.npmjs.org/";
2
+ export declare const REFUSED: RegExp;
3
+ export declare const tokenFor: (listed: string, registry: string) => boolean;
4
+ export declare const channelWhy: (spec: string, said: string, token?: boolean, registry?: string) => string;
@@ -0,0 +1,27 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+
3
+ export const NPM_DEFAULT = 'https://registry.npmjs.org/';
4
+
5
+ export const REFUSED = /E401|E403|ENEEDAUTH|EAUTH|Unauthorized|Forbidden/i;
6
+
7
+ export const tokenFor = (listed , registry ) => {
8
+ const host = new URL(registry).host;
9
+ return listed.split('\n').some((line) => line.includes(`//${host}/`) && line.includes(':_auth'));
10
+ };
11
+
12
+ export const channelWhy = (spec , said , token = true, registry = NPM_DEFAULT) => {
13
+ const { host, pathname } = new URL(registry);
14
+ const at = `//${host}${pathname.endsWith('/') ? pathname : `${pathname}/`}:_authToken`;
15
+ const naming = `NPM_TOKEN in the environment, or npm config set ${at} "$(cat <file of the token>)",`;
16
+ if (REFUSED.test(said))
17
+ return token
18
+ ? `the channel refuses the account's token, and holds nothing for it to read of ${spec}: ${naming} names another`
19
+ : `the channel ${registry} asks for a token to read ${spec}, and this account holds none for it: ${naming} names one`;
20
+ if (/E404|No match found|is not in this registry/i.test(said)) return `the channel holds no ${spec}`;
21
+ if (/ENOTCACHED|only-if-cached/i.test(said)) return `npm reached no registry for a package ${spec} stands on`;
22
+ if (/ENOTFOUND|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN|ECONNRESET|ENETUNREACH|network|fetch failed/i.test(said))
23
+ return `the channel does not answer for ${spec}`;
24
+ if (/EACCES|EPERM|EROFS/i.test(said))
25
+ return `npm may not write its global folder for ${spec}: name a prefix of this account's own in its config`;
26
+ return `the channel gave no answer for ${spec}`;
27
+ };
@@ -0,0 +1,27 @@
1
+ type Why = {
2
+ readonly why: string;
3
+ };
4
+ export declare const STAGED = ".nervur-taking";
5
+ export declare const commandIn: (prefix: string) => string;
6
+ export declare const releasePackage: (bin: string, version: string) => string | null;
7
+ export type Standing = {
8
+ readonly bin: string;
9
+ readonly held: string;
10
+ readonly root: string;
11
+ };
12
+ export declare const heldBy: (bin: string) => string | null;
13
+ export declare const madeToHold: (bin: string, held: string) => void;
14
+ export declare const stagedPackage: (staged: string) => string;
15
+ export declare const releaseLaid: (prefix: string, staged: string, hold?: boolean) => null | Why;
16
+ export declare const releaseHeld: (bin: string, version: string) => (() => void) | Why;
17
+ export declare const reachedBy: (bin: string, held: string) => string | null;
18
+ export declare const scriptOf: (bin: string) => string | Why;
19
+ export type Told = readonly [number, readonly string[] | string];
20
+ export declare const runFrom: (bin: string, releases: string, told: readonly Told[], skip: ReadonlySet<number>) => ReadonlySet<string> | null;
21
+ export type Processes = {
22
+ readonly told: () => readonly Told[] | null;
23
+ readonly own: ReadonlySet<number>;
24
+ };
25
+ export declare const releasesPruned: (bin: string, processes: Processes) => void;
26
+ export declare const leftGone: (prefix: string, processes: Processes) => void;
27
+ export {};
@@ -0,0 +1,153 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { existsSync, lstatSync, readdirSync, readFileSync, readlinkSync, realpathSync, rmSync } from 'node:fs';
3
+ import { dirname, join, relative, resolve, sep } from 'node:path';
4
+ import { isFields, readText } from '@nervur.org/genome/standard';
5
+ import { foldersLaid, laidWhole, linkedWhole, movedWhole, treeFlushed } from '../fills/flushed.js';
6
+
7
+
8
+
9
+ export const STAGED = '.nervur-taking';
10
+
11
+ const WINDOWS = process.platform === 'win32';
12
+
13
+ const modulesIn = (prefix ) =>
14
+ WINDOWS ? join(prefix, 'node_modules') : join(prefix, 'lib', 'node_modules');
15
+
16
+ export const commandIn = (prefix ) => join(prefix, WINDOWS ? 'nervur.cmd' : join('bin', 'nervur'));
17
+
18
+ const prefixOf = (bin ) => (WINDOWS ? dirname(bin) : dirname(dirname(bin)));
19
+
20
+ const releasesIn = (prefix ) => join(modulesIn(prefix), 'nervur', '.releases');
21
+
22
+ export const releasePackage = (bin , version ) => {
23
+ const release = join(releasesIn(prefixOf(bin)), version);
24
+ return existsSync(release) ? join(modulesIn(release), 'nervur') : null;
25
+ };
26
+
27
+
28
+
29
+ export const heldBy = (bin ) => {
30
+ try {
31
+ if (WINDOWS) return readFileSync(bin, 'utf8');
32
+ return lstatSync(bin).isSymbolicLink() ? readlinkSync(bin) : null;
33
+ } catch {
34
+ return null;
35
+ }
36
+ };
37
+
38
+ export const madeToHold = (bin , held ) => {
39
+ if (WINDOWS) laidWhole(bin, held, 0o755);
40
+ else linkedWhole(held, bin);
41
+ };
42
+
43
+ const heldFor = (bin , release ) => {
44
+ const inRelease = WINDOWS ? 'nervur.cmd' : join('lib', 'node_modules', 'nervur', 'bin', 'nervur.js');
45
+ const target = relative(dirname(bin), join(release, inRelease));
46
+ return WINDOWS ? `@"%~dp0\\${target.split(sep).join('\\')}" %*\r\n` : target;
47
+ };
48
+
49
+ export const stagedPackage = (staged ) => join(modulesIn(staged), 'nervur');
50
+
51
+ const versionOf = (staged ) => {
52
+ const read = readText(readFileSync(join(stagedPackage(staged), 'package.json'), 'utf8'));
53
+ const version = 'data' in read && isFields(read.data) ? read.data['version'] : undefined;
54
+ return typeof version === 'string' ? version : null;
55
+ };
56
+
57
+ export const releaseLaid = (prefix , staged , hold = true) => {
58
+ const version = versionOf(staged);
59
+ if (version === null) return { why: 'what npm laid names no version of nervur' };
60
+ const release = join(releasesIn(prefix), version);
61
+ const bin = commandIn(prefix);
62
+ const held = heldFor(bin, release);
63
+ if (heldBy(bin) === held) return null;
64
+ treeFlushed(staged);
65
+ foldersLaid(dirname(release), 0o777);
66
+ rmSync(release, { recursive: true, force: true });
67
+ movedWhole(staged, release);
68
+ if (hold) madeToHold(bin, held);
69
+ return null;
70
+ };
71
+
72
+ export const releaseHeld = (bin , version ) => {
73
+ const release = join(releasesIn(prefixOf(bin)), version);
74
+ if (!existsSync(release)) return { why: `the release ${version} is not laid beside the command` };
75
+ const before = heldBy(bin);
76
+ if (before === null) return { why: `the command's name at ${bin} holds no release` };
77
+ madeToHold(bin, heldFor(bin, release));
78
+ return () => madeToHold(bin, before);
79
+ };
80
+
81
+ export const reachedBy = (bin , held ) => {
82
+ if (!WINDOWS) return resolve(dirname(bin), held);
83
+ const named = /%~?dp0%?\\([^"]+)"/u.exec(held)?.[1];
84
+ return named === undefined ? null : resolve(dirname(bin), named);
85
+ };
86
+
87
+ export const scriptOf = (bin ) => {
88
+ const held = heldBy(bin);
89
+ const reached = held === null ? null : reachedBy(bin, held);
90
+ if (reached === null) return { why: `the command's name at ${bin} holds no release` };
91
+ return reached.endsWith('.cmd') ? join(dirname(reached), 'node_modules', 'nervur', 'bin', 'nervur.js') : reached;
92
+ };
93
+
94
+
95
+
96
+ const organismNamed = (words ) => {
97
+ if (typeof words !== 'string') {
98
+ const at = words.findIndex((word) => word === 'boot' || word === 'first-install');
99
+ return at > 0 ? (words[at - 1] ?? null) : null;
100
+ }
101
+ return /\s(\S+)\s(?:boot|first-install)(?=\s|$)/u.exec(words)?.[1] ?? null;
102
+ };
103
+
104
+ const versionIn = (home ) => {
105
+ try {
106
+ const version = readFileSync(join(home, 'organism.version'), 'utf8').trim();
107
+ return version === '' ? null : version;
108
+ } catch {
109
+ return null;
110
+ }
111
+ };
112
+
113
+ export const runFrom = (
114
+ bin ,
115
+ releases ,
116
+ told ,
117
+ skip ,
118
+ ) => {
119
+ if (!existsSync(releases)) return new Set();
120
+ const names = readdirSync(releases);
121
+ const folders = [...new Set([releases, realpathSync(releases)])];
122
+ const used = new Set ();
123
+ for (const [pid, words] of told) {
124
+ if (skip.has(pid)) continue;
125
+ const text = typeof words === 'string' ? words : words.join(' ');
126
+ for (const name of names) if (folders.some((folder) => text.includes(join(folder, name) + sep))) used.add(name);
127
+ if (!text.includes(`${bin} `) && !text.endsWith(bin)) continue;
128
+ const home = organismNamed(words);
129
+ const version = home === null ? null : versionIn(home);
130
+ if (version === null) return null;
131
+ used.add(version);
132
+ }
133
+ return used;
134
+ };
135
+
136
+
137
+
138
+ export const releasesPruned = (bin , processes ) => {
139
+ const releases = releasesIn(prefixOf(bin));
140
+ if (!existsSync(releases)) return;
141
+ const told = processes.told();
142
+ const used = told === null ? null : runFrom(bin, releases, told, processes.own);
143
+ if (used === null) return;
144
+ const held = heldBy(bin);
145
+ for (const name of readdirSync(releases))
146
+ if (heldFor(bin, join(releases, name)) !== held && !used.has(name))
147
+ rmSync(join(releases, name), { recursive: true, force: true });
148
+ };
149
+
150
+ export const leftGone = (prefix , processes ) => {
151
+ rmSync(join(prefix, STAGED), { recursive: true, force: true });
152
+ releasesPruned(commandIn(prefix), processes);
153
+ };
@@ -0,0 +1,31 @@
1
+ import { type Data } from '@nervur.org/genome/standard';
2
+ import { type Heard } from '../../organs/console/node/index.js';
3
+ import { type Following } from './follow.js';
4
+ import { type Given, type Outcome } from './given.js';
5
+ import { type Reaches, type Stand } from './jailer.js';
6
+ type Why = {
7
+ readonly why: string;
8
+ };
9
+ export type Hands = Reaches & {
10
+ readonly following: Following;
11
+ };
12
+ export type Making = {
13
+ readonly name: string;
14
+ readonly starter: boolean;
15
+ readonly stand: Stand;
16
+ readonly faculty: string;
17
+ };
18
+ export type Made = {
19
+ readonly folder: string;
20
+ readonly lobe: string;
21
+ readonly jailer: string;
22
+ readonly init: Heard | null;
23
+ };
24
+ export declare const repoMade: (print: Given['print'], home: string, making: Making, hands: Hands) => Promise<Made | Why>;
25
+ export declare const told: (made: Made, { name, starter }: Pick<Making, 'name' | 'starter'>, typed: (words: string) => string) => {
26
+ readonly lines: readonly string[];
27
+ readonly answer: Data;
28
+ readonly exit: number;
29
+ };
30
+ export declare const repo: ({ home, words, json, starter, print, answer }: Given) => Promise<Outcome>;
31
+ export {};
@@ -0,0 +1,133 @@
1
+ // SPDX-License-Identifier: FSL-1.1-ALv2
2
+ import { dataText, isFields, } from '@nervur.org/genome/standard';
3
+ import { socketOf, typeLine, watchConsole, } from '../../organs/console/node/index.js';
4
+ import { LONGEST_TIMEOUT } from '../door/longest.js';
5
+ import { readFolder, typedFor } from '../organism/folder.js';
6
+ import { shippedOf } from '../door/faculties.js';
7
+ import { exitOf, followed, } from './follow.js';
8
+ import { organismOf, } from './given.js';
9
+ import { jailerAt, standOf, reachesAt } from './jailer.js';
10
+ import { notRunningWhy, runningOf } from './spawn.js';
11
+
12
+
13
+
14
+
15
+
16
+
17
+
18
+
19
+
20
+
21
+
22
+
23
+
24
+
25
+
26
+
27
+
28
+
29
+
30
+ const heldOf = (folders , name ) => {
31
+ if (!Array.isArray(folders)) return { why: 'the jailer answered no list of folders' };
32
+ const held = folders.find((one) => isFields(one) && one['folder'] === name);
33
+ if (held === undefined || !isFields(held)) return null;
34
+ return { lobe: typeof held['lobe'] === 'string' ? held['lobe'] : null, made: held['made'] === true };
35
+ };
36
+
37
+ const grantedTo = async (home , jailer , making , ask ) => {
38
+ const wiring = { repos: jailer, ear: 'ear', mouth: 'mouth', scheduler: 'scheduler', library: 'library' };
39
+ const created = await ask(home, ['ask', 'brain', 'create', dataText({ faculty: making.faculty, wiring })]);
40
+ if ('why' in created) return { why: `the repo lobe is not made: ${created.why}` };
41
+ const lobe = isFields(created.data) ? created.data['id'] : undefined;
42
+ if (typeof lobe !== 'string') return { why: 'the brain named no repo lobe' };
43
+ const granted = await ask(home, ['lobe', jailer, 'grant', dataText({ folder: making.name, lobe })]);
44
+ if (!('why' in granted)) return lobe;
45
+ const torn = await ask(home, ['ask', 'brain', 'tearDown', dataText({ lobe })]);
46
+ const left = 'why' in torn ? `; the lobe ${lobe}, made for it, stands still, torn down by no one: ${torn.why}` : '';
47
+ return { why: `the folder ${making.name} is not granted: ${granted.why}${left}` };
48
+ };
49
+
50
+ const begun = async (lobe , making , hands ) => {
51
+ const words = ['lobe', lobe, 'init', dataText({ name: making.name, ...(making.starter ? { starter: true } : {}) })];
52
+ const typed = await hands.following.type(words);
53
+ if ('why' in typed) return typed;
54
+ const heard = await followed(hands.following, words, typed);
55
+ if ('why' in heard) return heard;
56
+ if ('error' in heard.answer)
57
+ return { why: `the init of ${making.name} was refused by ${lobe}: ${heard.answer.error.message}` };
58
+ return heard;
59
+ };
60
+
61
+ export const repoMade = async (
62
+ print ,
63
+ home ,
64
+ making ,
65
+ hands ,
66
+ ) => {
67
+ const jailer = await jailerAt(print, home, making.stand, hands);
68
+ if (typeof jailer !== 'string') return jailer;
69
+ const folders = await hands.ask(home, ['lobe', jailer, 'folders', '{}']);
70
+ if ('why' in folders) return folders;
71
+ const held = heldOf(folders.data, making.name);
72
+ if (held !== null && 'why' in held) return held;
73
+ if (held?.lobe === null)
74
+ return {
75
+ why: `the folder ${making.name} stands under repos, granted to no lobe: a repo lobe stands on what it holds by its init with standing, which this command does not take over`,
76
+ };
77
+ if (held?.made === true) return { folder: making.name, lobe: held.lobe, jailer, init: null };
78
+ const lobe = held === null ? await grantedTo(home, jailer, making, hands.ask) : (held?.lobe ?? '');
79
+ if (typeof lobe !== 'string') return lobe;
80
+ const init = await begun(lobe, making, hands);
81
+ if ('why' in init) return init;
82
+ return { folder: making.name, lobe, jailer, init };
83
+ };
84
+
85
+ export const told = (
86
+ made ,
87
+ { name, starter } ,
88
+ typed ,
89
+ ) => {
90
+ const job = made.init === null || !('result' in made.init.answer) ? null : made.init.answer.result;
91
+ const answer = { result: { folder: made.folder, jailer: made.jailer, lobe: made.lobe, init: job } };
92
+ const exit = made.init === null ? 0 : exitOf(made.init);
93
+ if (exit !== 0) {
94
+ const ended = isFields(job) && isFields(job['ended']) ? job['ended'] : {};
95
+ const err = typeof ended['err'] === 'string' ? ended['err'] : '';
96
+ const lost = `The repo lobe ${made.lobe} holds the folder ${name}, but its init ended on code ${String(exit)}`;
97
+ return {
98
+ lines: [`${lost}: ${err}`.trimEnd(), `${typed(`repo ${name}${starter ? ' --starter' : ''}`)} begins it again.`],
99
+ answer,
100
+ exit,
101
+ };
102
+ }
103
+ const said =
104
+ made.init === null
105
+ ? `The repo ${name} stands: its repo lobe is ${made.lobe}.`
106
+ : `The repo ${name} is made, ${starter ? 'with the starter' : 'empty'}: its repo lobe is ${made.lobe}.`;
107
+ return { lines: [said], answer, exit };
108
+ };
109
+
110
+ export const repo = async ({ home, words, json, starter, print, answer } ) => {
111
+ const organism = organismOf(home);
112
+ const name = words[1] ?? '';
113
+ if (name === '') return { why: 'repo takes the name of the repo, which is its folder' };
114
+ if (runningOf(organism) === null) return { why: notRunningWhy(organism) };
115
+ const folder = readFolder(organism);
116
+ if ('why' in folder) return folder;
117
+ const stand = standOf(organism, folder.laid);
118
+ if ('why' in stand) return stand;
119
+ const faculty = shippedOf(folder.laid.floor).find((one) => one.name === 'nervur.repo');
120
+ if (faculty === undefined) return { why: 'this installer ships no repo faculty' };
121
+ const type = (typing ) => typeLine(socketOf(organism), typing, LONGEST_TIMEOUT);
122
+ const hands = {
123
+ ...reachesAt,
124
+ following: { type, watch: (moved, ended) => watchConsole(socketOf(organism), LONGEST_TIMEOUT, moved, ended) },
125
+ };
126
+ const making = { name, starter: starter === true, stand, faculty: faculty.digest };
127
+ const made = await repoMade(print, organism, making, hands);
128
+ if ('why' in made) return made;
129
+ const said = told(made, making, typedFor(organism));
130
+ if (json) answer(dataText(said.answer));
131
+ for (const one of said.lines) print(one);
132
+ return said.exit === 0 ? null : { exit: said.exit };
133
+ };
@@ -0,0 +1,16 @@
1
+ import { type Files } from '../fills/boot-move.js';
2
+ import { type Laid } from '../organism/folder.js';
3
+ import { type Given, type Outcome } from './given.js';
4
+ type Why = {
5
+ readonly why: string;
6
+ };
7
+ export declare const keyAfter: (changed: Why | null, next: Uint8Array, old: Uint8Array) => Uint8Array;
8
+ export declare const rewrapEnded: (started: Why | null, changed: Why | null) => Outcome;
9
+ export declare const rewrapSaid: (bootMode: Laid['bootMode'], home: string) => string;
10
+ export declare const bootMoved: (given: Given, home: string, laid: Laid, mode: Laid['bootMode'], files?: Files) => Promise<{
11
+ readonly key: Uint8Array | null;
12
+ readonly laid: Laid;
13
+ } | Why>;
14
+ export declare const rewrap: (given: Given, files?: Files) => Promise<Outcome>;
15
+ export declare const rekey: (given: Given, files?: Files) => Promise<Outcome>;
16
+ export {};