@serfab/cadre-host 1.13.0 → 1.15.0

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 (352) hide show
  1. package/README.md +347 -423
  2. package/dist/bin/host.d.ts +6 -3
  3. package/dist/bin/host.js +332 -524
  4. package/dist/bin/host.js.map +1 -1
  5. package/dist/bin/join-output.d.ts +56 -0
  6. package/dist/bin/join-output.js +92 -0
  7. package/dist/bin/join-output.js.map +1 -0
  8. package/dist/bin/nat-output.d.ts +54 -0
  9. package/dist/bin/nat-output.js +138 -0
  10. package/dist/bin/nat-output.js.map +1 -0
  11. package/dist/bin/ui-access.d.ts +22 -0
  12. package/dist/bin/ui-access.js +44 -0
  13. package/dist/bin/ui-access.js.map +1 -0
  14. package/dist/hosted/claim-details.d.ts +66 -0
  15. package/dist/hosted/claim-details.js +60 -0
  16. package/dist/hosted/claim-details.js.map +1 -0
  17. package/dist/hosted/hosted-node-service.d.ts +325 -0
  18. package/dist/hosted/hosted-node-service.js +678 -0
  19. package/dist/hosted/hosted-node-service.js.map +1 -0
  20. package/dist/hosted/hosted-node-store.d.ts +40 -0
  21. package/dist/hosted/hosted-node-store.js +126 -0
  22. package/dist/hosted/hosted-node-store.js.map +1 -0
  23. package/dist/{donation/donation-supervisor.d.ts → hosted/hosted-node-supervisor.d.ts} +70 -53
  24. package/dist/hosted/hosted-node-supervisor.js +396 -0
  25. package/dist/hosted/hosted-node-supervisor.js.map +1 -0
  26. package/dist/hosted/hosted-node-watcher.d.ts +95 -0
  27. package/dist/hosted/hosted-node-watcher.js +260 -0
  28. package/dist/hosted/hosted-node-watcher.js.map +1 -0
  29. package/dist/hosted/index.d.ts +16 -0
  30. package/dist/hosted/index.js +13 -0
  31. package/dist/hosted/index.js.map +1 -0
  32. package/dist/hosted/node-status.d.ts +51 -0
  33. package/dist/hosted/node-status.js +77 -0
  34. package/dist/hosted/node-status.js.map +1 -0
  35. package/dist/hosted/types.d.ts +141 -0
  36. package/dist/hosted/types.js +22 -0
  37. package/dist/hosted/types.js.map +1 -0
  38. package/dist/index.d.ts +12 -24
  39. package/dist/index.js +9 -19
  40. package/dist/index.js.map +1 -1
  41. package/dist/installer/config.d.ts +27 -34
  42. package/dist/installer/config.js +46 -15
  43. package/dist/installer/config.js.map +1 -1
  44. package/dist/installer/index.d.ts +9 -19
  45. package/dist/installer/index.js +21 -85
  46. package/dist/installer/index.js.map +1 -1
  47. package/dist/installer/paths.d.ts +0 -2
  48. package/dist/installer/paths.js +0 -4
  49. package/dist/installer/paths.js.map +1 -1
  50. package/dist/installer/wizard.d.ts +12 -9
  51. package/dist/installer/wizard.js +15 -14
  52. package/dist/installer/wizard.js.map +1 -1
  53. package/dist/nat/address-resolver.d.ts +18 -17
  54. package/dist/nat/address-resolver.js +79 -25
  55. package/dist/nat/address-resolver.js.map +1 -1
  56. package/dist/nat/address-watch.d.ts +37 -0
  57. package/dist/nat/address-watch.js +84 -0
  58. package/dist/nat/address-watch.js.map +1 -0
  59. package/dist/nat/ddns/duckdns.d.ts +2 -1
  60. package/dist/nat/ddns/duckdns.js +5 -1
  61. package/dist/nat/ddns/duckdns.js.map +1 -1
  62. package/dist/nat/ddns/index.d.ts +6 -0
  63. package/dist/nat/ddns/index.js.map +1 -1
  64. package/dist/nat/index.d.ts +13 -9
  65. package/dist/nat/index.js +7 -5
  66. package/dist/nat/index.js.map +1 -1
  67. package/dist/nat/nat-service.d.ts +220 -77
  68. package/dist/nat/nat-service.js +653 -239
  69. package/dist/nat/nat-service.js.map +1 -1
  70. package/dist/nat/nat-store.d.ts +12 -5
  71. package/dist/nat/nat-store.js +124 -29
  72. package/dist/nat/nat-store.js.map +1 -1
  73. package/dist/nat/network-mode.d.ts +19 -0
  74. package/dist/nat/network-mode.js +32 -0
  75. package/dist/nat/network-mode.js.map +1 -0
  76. package/dist/nat/port-mapper.d.ts +83 -79
  77. package/dist/nat/port-mapper.js +148 -189
  78. package/dist/nat/port-mapper.js.map +1 -1
  79. package/dist/nat/reachability.d.ts +32 -15
  80. package/dist/nat/reachability.js +110 -22
  81. package/dist/nat/reachability.js.map +1 -1
  82. package/dist/nat/types.d.ts +98 -27
  83. package/dist/nat/types.js +8 -5
  84. package/dist/nat/types.js.map +1 -1
  85. package/dist/orchestrator/host-process-orchestrator.d.ts +32 -74
  86. package/dist/orchestrator/host-process-orchestrator.js +84 -233
  87. package/dist/orchestrator/host-process-orchestrator.js.map +1 -1
  88. package/dist/{installer/identity.d.ts → orchestrator/identity-file.d.ts} +5 -5
  89. package/dist/{installer/identity.js → orchestrator/identity-file.js} +6 -6
  90. package/dist/orchestrator/identity-file.js.map +1 -0
  91. package/dist/orchestrator/index.d.ts +2 -3
  92. package/dist/orchestrator/index.js +1 -1
  93. package/dist/orchestrator/index.js.map +1 -1
  94. package/dist/orchestrator/node-identity.d.ts +6 -6
  95. package/dist/orchestrator/node-identity.js +7 -7
  96. package/dist/orchestrator/node-identity.js.map +1 -1
  97. package/dist/orchestrator/port-allocator.d.ts +5 -6
  98. package/dist/orchestrator/port-allocator.js +9 -11
  99. package/dist/orchestrator/port-allocator.js.map +1 -1
  100. package/dist/orchestrator/state-store.d.ts +3 -5
  101. package/dist/orchestrator/state-store.js +2 -10
  102. package/dist/orchestrator/state-store.js.map +1 -1
  103. package/dist/orchestrator/types.d.ts +33 -22
  104. package/dist/orchestrator/types.js.map +1 -1
  105. package/dist/package-version.d.ts +1 -0
  106. package/dist/package-version.js +4 -0
  107. package/dist/package-version.js.map +1 -0
  108. package/dist/server/error-handler.d.ts +5 -25
  109. package/dist/server/error-handler.js +11 -74
  110. package/dist/server/error-handler.js.map +1 -1
  111. package/dist/server/events/types.d.ts +7 -11
  112. package/dist/server/events/types.js +2 -1
  113. package/dist/server/events/types.js.map +1 -1
  114. package/dist/server/index.d.ts +11 -37
  115. package/dist/server/index.js +30 -48
  116. package/dist/server/index.js.map +1 -1
  117. package/dist/server/routes/hosted-nodes.d.ts +28 -0
  118. package/dist/server/routes/hosted-nodes.js +68 -0
  119. package/dist/server/routes/hosted-nodes.js.map +1 -0
  120. package/dist/server/routes/nat.d.ts +4 -1
  121. package/dist/server/routes/nat.js +13 -2
  122. package/dist/server/routes/nat.js.map +1 -1
  123. package/dist/server/routes/nodes.d.ts +6 -20
  124. package/dist/server/routes/nodes.js +7 -86
  125. package/dist/server/routes/nodes.js.map +1 -1
  126. package/dist/server/routes/settings.d.ts +3 -7
  127. package/dist/server/routes/settings.js +18 -8
  128. package/dist/server/routes/settings.js.map +1 -1
  129. package/dist/server/routes/status.d.ts +2 -25
  130. package/dist/server/routes/status.js +3 -43
  131. package/dist/server/routes/status.js.map +1 -1
  132. package/dist/server/server.js +8 -8
  133. package/dist/server/settings-store.d.ts +2 -2
  134. package/dist/server/settings-store.js +2 -2
  135. package/dist/server/static.js +1 -2
  136. package/dist/server/static.js.map +1 -1
  137. package/dist/ui/assets/index-BHd8CWZA.css +1 -0
  138. package/dist/ui/assets/index-Ccr2GjPT.js +23 -0
  139. package/dist/ui/assets/index-Ccr2GjPT.js.map +1 -0
  140. package/dist/ui/index.html +2 -2
  141. package/dist/update/index.d.ts +2 -2
  142. package/dist/update/index.js +2 -2
  143. package/dist/update/store.d.ts +1 -1
  144. package/dist/update/store.js +1 -1
  145. package/dist/update/types.d.ts +1 -1
  146. package/dist/update/types.js +1 -1
  147. package/package.json +5 -7
  148. package/src/__tests__/cli-nat.smoke.test.ts +219 -212
  149. package/src/__tests__/cli.smoke.test.ts +2 -2
  150. package/src/__tests__/global-setup.ts +2 -3
  151. package/src/__tests__/orchestrator-claim-secret.test.ts +111 -0
  152. package/src/__tests__/orchestrator-env-scrub.test.ts +160 -163
  153. package/src/__tests__/orchestrator-handle-contract.ts +134 -134
  154. package/src/__tests__/orchestrator-node-identity.test.ts +177 -203
  155. package/src/__tests__/orchestrator-ports.test.ts +124 -143
  156. package/src/__tests__/orchestrator-push.test.ts +138 -146
  157. package/src/__tests__/orchestrator.test.ts +1017 -1063
  158. package/src/__tests__/ui-access.test.ts +30 -0
  159. package/src/bin/host.ts +397 -572
  160. package/src/bin/join-output.ts +120 -0
  161. package/src/bin/nat-output.ts +188 -0
  162. package/src/bin/ui-access.ts +50 -0
  163. package/src/{donation → hosted}/__tests__/fake-orchestrator.test.ts +172 -173
  164. package/src/{donation → hosted}/__tests__/fake-orchestrator.ts +43 -23
  165. package/src/hosted/__tests__/hosted-node-service.test.ts +708 -0
  166. package/src/hosted/__tests__/hosted-node-supervisor.test.ts +475 -0
  167. package/src/hosted/__tests__/test-invitation.ts +33 -0
  168. package/src/hosted/claim-details.ts +103 -0
  169. package/src/hosted/hosted-node-service.ts +814 -0
  170. package/src/hosted/hosted-node-store.ts +144 -0
  171. package/src/hosted/hosted-node-supervisor.ts +439 -0
  172. package/src/hosted/hosted-node-watcher.ts +288 -0
  173. package/src/hosted/index.ts +53 -0
  174. package/src/hosted/node-status.ts +97 -0
  175. package/src/hosted/types.ts +160 -0
  176. package/src/index.ts +72 -91
  177. package/src/installer/__tests__/config.test.ts +15 -40
  178. package/src/installer/__tests__/installer.smoke.test.ts +184 -263
  179. package/src/installer/__tests__/wizard.test.ts +25 -13
  180. package/src/installer/config.ts +201 -175
  181. package/src/installer/index.ts +252 -327
  182. package/src/installer/paths.ts +104 -109
  183. package/src/installer/wizard.ts +24 -26
  184. package/src/nat/__tests__/address-resolver.test.ts +107 -82
  185. package/src/nat/__tests__/nat-service.test.ts +608 -515
  186. package/src/nat/__tests__/nat-store.test.ts +49 -12
  187. package/src/nat/__tests__/network-mode.test.ts +38 -0
  188. package/src/nat/__tests__/port-mapper.test.ts +30 -191
  189. package/src/nat/__tests__/reachability.test.ts +96 -13
  190. package/src/nat/address-resolver.ts +94 -52
  191. package/src/nat/address-watch.ts +92 -0
  192. package/src/nat/ddns/duckdns.ts +5 -1
  193. package/src/nat/ddns/index.ts +6 -0
  194. package/src/nat/index.ts +33 -13
  195. package/src/nat/nat-service.ts +942 -501
  196. package/src/nat/nat-store.ts +126 -31
  197. package/src/nat/network-mode.ts +36 -0
  198. package/src/nat/port-mapper.ts +241 -329
  199. package/src/nat/reachability.ts +155 -34
  200. package/src/nat/types.ts +110 -37
  201. package/src/{installer/__tests__/identity.test.ts → orchestrator/__tests__/identity-file.test.ts} +34 -34
  202. package/src/orchestrator/__tests__/node-identity.test.ts +62 -62
  203. package/src/orchestrator/host-process-orchestrator.ts +1089 -1260
  204. package/src/{installer/identity.ts → orchestrator/identity-file.ts} +56 -56
  205. package/src/orchestrator/index.ts +9 -10
  206. package/src/orchestrator/node-identity.ts +41 -41
  207. package/src/orchestrator/port-allocator.ts +71 -73
  208. package/src/orchestrator/state-store.ts +76 -90
  209. package/src/orchestrator/types.ts +34 -23
  210. package/src/package-version.ts +4 -0
  211. package/src/server/__tests__/bus.test.ts +38 -38
  212. package/src/server/__tests__/error-handler.test.ts +81 -118
  213. package/src/server/__tests__/fakes.ts +15 -18
  214. package/src/server/__tests__/hosted-nodes-route.test.ts +161 -0
  215. package/src/server/__tests__/nodes-route.test.ts +114 -283
  216. package/src/server/__tests__/publishers.test.ts +193 -180
  217. package/src/server/__tests__/server.smoke.test.ts +134 -223
  218. package/src/server/__tests__/settings-route.test.ts +210 -195
  219. package/src/server/__tests__/sse-route.test.ts +119 -119
  220. package/src/server/__tests__/status-route.test.ts +82 -121
  221. package/src/server/error-handler.ts +112 -178
  222. package/src/server/events/types.ts +20 -24
  223. package/src/server/index.ts +223 -267
  224. package/src/server/routes/hosted-nodes.ts +83 -0
  225. package/src/server/routes/nat.ts +75 -63
  226. package/src/server/routes/nodes.ts +96 -188
  227. package/src/server/routes/settings.ts +20 -15
  228. package/src/server/routes/status.ts +5 -67
  229. package/src/server/server.ts +8 -8
  230. package/src/server/settings-store.ts +2 -2
  231. package/src/server/static.ts +1 -2
  232. package/src/update/index.ts +2 -2
  233. package/src/update/store.ts +1 -1
  234. package/src/update/types.ts +1 -1
  235. package/dist/auth/duration.d.ts +0 -1
  236. package/dist/auth/duration.js +0 -32
  237. package/dist/auth/duration.js.map +0 -1
  238. package/dist/auth/index.d.ts +0 -11
  239. package/dist/auth/index.js +0 -9
  240. package/dist/auth/index.js.map +0 -1
  241. package/dist/auth/self-label.d.ts +0 -36
  242. package/dist/auth/self-label.js +0 -57
  243. package/dist/auth/self-label.js.map +0 -1
  244. package/dist/auth/trust-circle-store.d.ts +0 -26
  245. package/dist/auth/trust-circle-store.js +0 -129
  246. package/dist/auth/trust-circle-store.js.map +0 -1
  247. package/dist/auth/trust-circle.d.ts +0 -156
  248. package/dist/auth/trust-circle.js +0 -307
  249. package/dist/auth/trust-circle.js.map +0 -1
  250. package/dist/auth/types.d.ts +0 -84
  251. package/dist/auth/types.js +0 -24
  252. package/dist/auth/types.js.map +0 -1
  253. package/dist/donation/donation-service.d.ts +0 -389
  254. package/dist/donation/donation-service.js +0 -828
  255. package/dist/donation/donation-service.js.map +0 -1
  256. package/dist/donation/donation-store.d.ts +0 -51
  257. package/dist/donation/donation-store.js +0 -152
  258. package/dist/donation/donation-store.js.map +0 -1
  259. package/dist/donation/donation-supervisor.js +0 -364
  260. package/dist/donation/donation-supervisor.js.map +0 -1
  261. package/dist/donation/grant-service.d.ts +0 -80
  262. package/dist/donation/grant-service.js +0 -210
  263. package/dist/donation/grant-service.js.map +0 -1
  264. package/dist/donation/grant-store.d.ts +0 -38
  265. package/dist/donation/grant-store.js +0 -135
  266. package/dist/donation/grant-store.js.map +0 -1
  267. package/dist/donation/index.d.ts +0 -20
  268. package/dist/donation/index.js +0 -17
  269. package/dist/donation/index.js.map +0 -1
  270. package/dist/donation/types.d.ts +0 -224
  271. package/dist/donation/types.js +0 -40
  272. package/dist/donation/types.js.map +0 -1
  273. package/dist/installer/identity.js.map +0 -1
  274. package/dist/owner/index.d.ts +0 -11
  275. package/dist/owner/index.js +0 -11
  276. package/dist/owner/index.js.map +0 -1
  277. package/dist/owner/owner-node-client.d.ts +0 -110
  278. package/dist/owner/owner-node-client.js +0 -184
  279. package/dist/owner/owner-node-client.js.map +0 -1
  280. package/dist/server/routes/bootstrap-node-validation.d.ts +0 -115
  281. package/dist/server/routes/bootstrap-node-validation.js +0 -197
  282. package/dist/server/routes/bootstrap-node-validation.js.map +0 -1
  283. package/dist/server/routes/grants-admin.d.ts +0 -29
  284. package/dist/server/routes/grants-admin.js +0 -58
  285. package/dist/server/routes/grants-admin.js.map +0 -1
  286. package/dist/server/routes/grants.d.ts +0 -28
  287. package/dist/server/routes/grants.js +0 -165
  288. package/dist/server/routes/grants.js.map +0 -1
  289. package/dist/server/routes/provision-request-validation.d.ts +0 -45
  290. package/dist/server/routes/provision-request-validation.js +0 -97
  291. package/dist/server/routes/provision-request-validation.js.map +0 -1
  292. package/dist/server/routes/strands.d.ts +0 -20
  293. package/dist/server/routes/strands.js +0 -38
  294. package/dist/server/routes/strands.js.map +0 -1
  295. package/dist/server/routes/trust-circle.d.ts +0 -17
  296. package/dist/server/routes/trust-circle.js +0 -35
  297. package/dist/server/routes/trust-circle.js.map +0 -1
  298. package/dist/strands/index.d.ts +0 -7
  299. package/dist/strands/index.js +0 -6
  300. package/dist/strands/index.js.map +0 -1
  301. package/dist/strands/strand-service.d.ts +0 -50
  302. package/dist/strands/strand-service.js +0 -103
  303. package/dist/strands/strand-service.js.map +0 -1
  304. package/dist/strands/types.d.ts +0 -93
  305. package/dist/strands/types.js +0 -23
  306. package/dist/strands/types.js.map +0 -1
  307. package/dist/ui/assets/index-C6nELNfC.js +0 -23
  308. package/dist/ui/assets/index-C6nELNfC.js.map +0 -1
  309. package/dist/ui/assets/index-TtIYSeZO.css +0 -1
  310. package/src/__tests__/cli-invite.smoke.test.ts +0 -192
  311. package/src/__tests__/host-owner.smoke.test.ts +0 -123
  312. package/src/__tests__/orchestrator-owner.test.ts +0 -234
  313. package/src/__tests__/orchestrator-pin-keys.test.ts +0 -152
  314. package/src/auth/__tests__/duration.test.ts +0 -28
  315. package/src/auth/__tests__/self-label.test.ts +0 -85
  316. package/src/auth/__tests__/trust-circle-integration.test.ts +0 -152
  317. package/src/auth/__tests__/trust-circle-store.test.ts +0 -115
  318. package/src/auth/__tests__/trust-circle.test.ts +0 -445
  319. package/src/auth/duration.ts +0 -33
  320. package/src/auth/index.ts +0 -21
  321. package/src/auth/self-label.ts +0 -74
  322. package/src/auth/trust-circle-store.ts +0 -155
  323. package/src/auth/trust-circle.ts +0 -395
  324. package/src/auth/types.ts +0 -99
  325. package/src/donation/__tests__/donation-service.test.ts +0 -1193
  326. package/src/donation/__tests__/donation-supervisor.test.ts +0 -548
  327. package/src/donation/__tests__/grant-service.test.ts +0 -213
  328. package/src/donation/__tests__/grant-store.test.ts +0 -113
  329. package/src/donation/donation-service.ts +0 -1033
  330. package/src/donation/donation-store.ts +0 -176
  331. package/src/donation/donation-supervisor.ts +0 -411
  332. package/src/donation/grant-service.ts +0 -252
  333. package/src/donation/grant-store.ts +0 -152
  334. package/src/donation/index.ts +0 -65
  335. package/src/donation/types.ts +0 -260
  336. package/src/owner/__tests__/owner-node-client.test.ts +0 -194
  337. package/src/owner/index.ts +0 -12
  338. package/src/owner/owner-node-client.ts +0 -259
  339. package/src/server/__tests__/bootstrap-node-validation.test.ts +0 -138
  340. package/src/server/__tests__/grants-admin-route.test.ts +0 -171
  341. package/src/server/__tests__/grants-route.test.ts +0 -394
  342. package/src/server/__tests__/strands-route.test.ts +0 -234
  343. package/src/server/routes/bootstrap-node-validation.ts +0 -206
  344. package/src/server/routes/grants-admin.ts +0 -74
  345. package/src/server/routes/grants.ts +0 -193
  346. package/src/server/routes/provision-request-validation.ts +0 -105
  347. package/src/server/routes/strands.ts +0 -54
  348. package/src/server/routes/trust-circle.ts +0 -49
  349. package/src/strands/__tests__/strand-service.test.ts +0 -165
  350. package/src/strands/index.ts +0 -14
  351. package/src/strands/strand-service.ts +0 -135
  352. package/src/strands/types.ts +0 -102
@@ -1,223 +1,134 @@
1
- import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
2
- import { tmpdir } from 'node:os';
3
- import { join } from 'node:path';
4
-
5
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
6
-
7
- import { createLocalUiServer } from '../index.js';
8
- import { fakeFounder } from './fakes.js';
9
- import type { HostProcessOrchestrator } from '../../orchestrator/index.js';
10
- import type { TrustCircleService } from '../../auth/index.js';
11
- import { GrantService, GrantStore } from '../../donation/index.js';
12
-
13
- function fakeOrchestrator(): HostProcessOrchestrator {
14
- return {
15
- listNodes: () => [],
16
- getNode: () => undefined,
17
- resolveDockerId: () => undefined,
18
- onStateChange: () => () => undefined,
19
- } as unknown as HostProcessOrchestrator;
20
- }
21
-
22
- function fakeTrustCircle(): TrustCircleService {
23
- const pending = new Map<string, { token: string; label: string; createdAt: string }>();
24
- return {
25
- list: async () => ({
26
- members: [],
27
- pending: [...pending.values()],
28
- }),
29
- issueInvite: async (opts: { label: string }) => {
30
- const token = `tok-${pending.size + 1}`;
31
- pending.set(token, { token, label: opts.label, createdAt: new Date().toISOString() });
32
- return {
33
- encodedInvite: `invite:${token}`,
34
- invite: {} as never,
35
- token,
36
- expiresAt: new Date(Date.now() + 3600_000),
37
- };
38
- },
39
- redeemInvite: async () => ({ peerId: 'p', label: 'l' }),
40
- revokePending: async () => undefined,
41
- removeMember: async () => undefined,
42
- } as unknown as TrustCircleService;
43
- }
44
-
45
- function writeConfig(dir: string): void {
46
- const cfg = {
47
- version: 2,
48
- installId: 'inst-x',
49
- uiPort: 8765,
50
- libp2pPort: 4001,
51
- dataDir: dir,
52
- identityPath: join(dir, 'identity.key'),
53
- upnpEnabled: true,
54
- installedAt: '2025-01-01T00:00:00Z',
55
- installerVersion: '0.6.0',
56
- updates: { autoApply: false },
57
- };
58
- writeFileSync(join(dir, 'host.config.json'), JSON.stringify(cfg, null, 2) + '\n', 'utf8');
59
- }
60
-
61
- describe('createLocalUiServer smoke', () => {
62
- let dataDir: string;
63
- let server: ReturnType<typeof createLocalUiServer>;
64
- let baseUrl: string;
65
-
66
- beforeEach(async () => {
67
- dataDir = mkdtempSync(join(tmpdir(), 'cadre-host-smoke-'));
68
- writeConfig(dataDir);
69
- server = createLocalUiServer({
70
- uiPort: 8765,
71
- dataDir,
72
- orchestrator: fakeOrchestrator(),
73
- founder: fakeFounder({ trustCircle: fakeTrustCircle() }),
74
- forcePort: 0,
75
- });
76
- const { url } = await server.start();
77
- baseUrl = url;
78
- });
79
-
80
- afterEach(async () => {
81
- await server.stop();
82
- rmSync(dataDir, { recursive: true, force: true });
83
- });
84
-
85
- it('serves /api/status and respects the origin guard', async () => {
86
- // Without host header: undici's fetch sets it; this is the happy path.
87
- const res = await fetch(`${baseUrl}/api/status`);
88
- expect(res.status).toBe(200);
89
- const body = await res.json() as { service: { name: string }; role: string };
90
- expect(body.service.name).toBe('cadre-host');
91
- expect(body.role).toBe('founder');
92
- });
93
-
94
- it('rejects requests with a foreign Host header', async () => {
95
- // fetch() forbids overriding the Host header — use node:http directly.
96
- const { request: httpRequest } = await import('node:http');
97
- const u = new URL(`${baseUrl}/api/status`);
98
- const status = await new Promise<number>((resolve, reject) => {
99
- const req = httpRequest(
100
- {
101
- hostname: u.hostname,
102
- port: u.port,
103
- path: u.pathname,
104
- method: 'GET',
105
- headers: { host: 'evil.example.com' },
106
- },
107
- (res) => {
108
- res.resume();
109
- res.on('end', () => resolve(res.statusCode ?? 0));
110
- },
111
- );
112
- req.on('error', reject);
113
- req.end();
114
- });
115
- expect(status).toBe(403);
116
- });
117
-
118
- it('round-trips an invite through /auth/* and reflects it in /auth/trust-circle', async () => {
119
- const post = await fetch(`${baseUrl}/auth/invites`, {
120
- method: 'POST',
121
- headers: { 'content-type': 'application/json' },
122
- body: JSON.stringify({ label: 'Mom\'s phone' }),
123
- });
124
- expect(post.status).toBe(200);
125
-
126
- const listRes = await fetch(`${baseUrl}/auth/trust-circle`);
127
- expect(listRes.status).toBe(200);
128
- const body = await listRes.json() as { pending: Array<{ label: string }> };
129
- expect(body.pending.length).toBe(1);
130
- expect(body.pending[0]?.label).toBe('Mom\'s phone');
131
- });
132
-
133
- it('serves a placeholder index.html when dist/ui is missing', async () => {
134
- const res = await fetch(`${baseUrl}/`);
135
- expect(res.status).toBe(200);
136
- expect(res.headers.get('content-type') ?? '').toContain('text/html');
137
- const text = await res.text();
138
- expect(text).toContain('cadre-host is running');
139
- });
140
-
141
- it('an unknown /api path returns 404 (not the static SPA)', async () => {
142
- const res = await fetch(`${baseUrl}/api/this-does-not-exist`);
143
- expect(res.status).toBe(404);
144
- const body = await res.json() as { error: { code: string } };
145
- expect(body.error.code).toBe('not_found');
146
- });
147
- });
148
-
149
- // Donor-only mode: the common case (ownCadre.enabled=false). No owner node, so
150
- // no trustCircle / NAT are wired. The donor surface (/grants-admin) is up, and
151
- // the founder-only surfaces (/auth, /nat) 404 to keep the surface honest.
152
- describe('createLocalUiServer smoke — donor-only (no owner node)', () => {
153
- let dataDir: string;
154
- let server: ReturnType<typeof createLocalUiServer>;
155
- let baseUrl: string;
156
-
157
- beforeEach(async () => {
158
- dataDir = mkdtempSync(join(tmpdir(), 'cadre-host-donor-'));
159
- writeConfig(dataDir);
160
- server = createLocalUiServer({
161
- uiPort: 8765,
162
- dataDir,
163
- orchestrator: fakeOrchestrator(),
164
- grants: new GrantService({ store: new GrantStore(dataDir) }),
165
- forcePort: 0,
166
- });
167
- const { url } = await server.start();
168
- baseUrl = url;
169
- });
170
-
171
- afterEach(async () => {
172
- await server.stop();
173
- rmSync(dataDir, { recursive: true, force: true });
174
- });
175
-
176
- it('serves /api/status as role donor, with no trustCircle / connectivity and no nodes', async () => {
177
- const res = await fetch(`${baseUrl}/api/status`);
178
- expect(res.status).toBe(200);
179
- const body = await res.json() as {
180
- service: { name: string };
181
- role: string;
182
- nodes: unknown[];
183
- trustCircle?: unknown;
184
- connectivity?: unknown;
185
- };
186
- expect(body.service.name).toBe('cadre-host');
187
- expect(body.role).toBe('donor');
188
- expect(body.nodes).toEqual([]);
189
- expect(body.trustCircle).toBeUndefined();
190
- expect(body.connectivity).toBeUndefined();
191
- });
192
-
193
- it('serves the donor surface: POST /grants-admin issues a grant', async () => {
194
- const res = await fetch(`${baseUrl}/grants-admin`, {
195
- method: 'POST',
196
- headers: { 'content-type': 'application/json' },
197
- body: JSON.stringify({ label: "Alice's cadre", maxNodes: 2 }),
198
- });
199
- expect(res.status).toBe(200);
200
- const body = await res.json() as { grant: { token: string; maxNodes: number } };
201
- expect(body.grant.token).toBeTruthy();
202
- expect(body.grant.maxNodes).toBe(2);
203
- });
204
-
205
- it('404s the founder-only NAT surface (GET /nat/status)', async () => {
206
- const res = await fetch(`${baseUrl}/nat/status`);
207
- expect(res.status).toBe(404);
208
- const body = await res.json() as { error: { code: string } };
209
- expect(body.error.code).toBe('not_found');
210
- });
211
-
212
- it('404s the founder-only trust-circle surface (/auth/*)', async () => {
213
- const list = await fetch(`${baseUrl}/auth/trust-circle`);
214
- expect(list.status).toBe(404);
215
-
216
- const invite = await fetch(`${baseUrl}/auth/invites`, {
217
- method: 'POST',
218
- headers: { 'content-type': 'application/json' },
219
- body: JSON.stringify({ label: 'Mom' }),
220
- });
221
- expect(invite.status).toBe(404);
222
- });
223
- });
1
+ import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
6
+
7
+ import { createLocalUiServer } from '../index.js';
8
+ import { fakeNat } from './fakes.js';
9
+ import type { HostProcessOrchestrator } from '../../orchestrator/index.js';
10
+ import type { HostedNodeService } from '../../hosted/index.js';
11
+
12
+ function fakeOrchestrator(): HostProcessOrchestrator {
13
+ return {
14
+ listNodes: () => [],
15
+ getNode: () => undefined,
16
+ resolveDockerId: () => undefined,
17
+ onStateChange: () => () => undefined,
18
+ } as unknown as HostProcessOrchestrator;
19
+ }
20
+
21
+ /** A hosted-node service with nothing in it; its listener is what the server wires to the bus. */
22
+ function fakeHostedNodes(): HostedNodeService {
23
+ return {
24
+ list: () => [],
25
+ get: () => undefined,
26
+ onChange: () => () => undefined,
27
+ } as unknown as HostedNodeService;
28
+ }
29
+
30
+ function writeConfig(dir: string): void {
31
+ const cfg = {
32
+ version: 3,
33
+ installId: 'inst-x',
34
+ uiPort: 8765,
35
+ dataDir: dir,
36
+ upnpEnabled: true,
37
+ installedAt: '2025-01-01T00:00:00Z',
38
+ installerVersion: '0.6.0',
39
+ updates: { autoApply: false },
40
+ };
41
+ writeFileSync(join(dir, 'host.config.json'), JSON.stringify(cfg, null, 2) + '\n', 'utf8');
42
+ }
43
+
44
+ describe('createLocalUiServer smoke', () => {
45
+ let dataDir: string;
46
+ let server: ReturnType<typeof createLocalUiServer>;
47
+ let baseUrl: string;
48
+
49
+ beforeEach(async () => {
50
+ dataDir = mkdtempSync(join(tmpdir(), 'cadre-host-smoke-'));
51
+ writeConfig(dataDir);
52
+ server = createLocalUiServer({
53
+ uiPort: 8765,
54
+ dataDir,
55
+ orchestrator: fakeOrchestrator(),
56
+ nat: fakeNat(),
57
+ hostedNodes: fakeHostedNodes(),
58
+ forcePort: 0,
59
+ });
60
+ const { url } = await server.start();
61
+ baseUrl = url;
62
+ });
63
+
64
+ afterEach(async () => {
65
+ await server.stop();
66
+ rmSync(dataDir, { recursive: true, force: true });
67
+ });
68
+
69
+ it('serves /api/status, with connectivity and no nodes', async () => {
70
+ // Without host header: undici's fetch sets it; this is the happy path.
71
+ const res = await fetch(`${baseUrl}/api/status`);
72
+ expect(res.status).toBe(200);
73
+ const body = await res.json() as {
74
+ service: { name: string };
75
+ nodes: unknown[];
76
+ connectivity: { directReachability: string };
77
+ };
78
+ expect(body.service.name).toBe('cadre-host');
79
+ expect(body.nodes).toEqual([]);
80
+ expect(body.connectivity.directReachability).toBe('reachable');
81
+ });
82
+
83
+ it('rejects requests with a foreign Host header', async () => {
84
+ // fetch() forbids overriding the Host header — use node:http directly.
85
+ const { request: httpRequest } = await import('node:http');
86
+ const u = new URL(`${baseUrl}/api/status`);
87
+ const status = await new Promise<number>((resolve, reject) => {
88
+ const req = httpRequest(
89
+ {
90
+ hostname: u.hostname,
91
+ port: u.port,
92
+ path: u.pathname,
93
+ method: 'GET',
94
+ headers: { host: 'evil.example.com' },
95
+ },
96
+ (res) => {
97
+ res.resume();
98
+ res.on('end', () => resolve(res.statusCode ?? 0));
99
+ },
100
+ );
101
+ req.on('error', reject);
102
+ req.end();
103
+ });
104
+ expect(status).toBe(403);
105
+ });
106
+
107
+ it('serves a placeholder index.html when dist/ui is missing', async () => {
108
+ const res = await fetch(`${baseUrl}/`);
109
+ expect(res.status).toBe(200);
110
+ expect(res.headers.get('content-type') ?? '').toContain('text/html');
111
+ const text = await res.text();
112
+ expect(text).toContain('cadre-host is running');
113
+ });
114
+
115
+ it('an unknown /api path returns 404 (not the static SPA)', async () => {
116
+ const res = await fetch(`${baseUrl}/api/this-does-not-exist`);
117
+ expect(res.status).toBe(404);
118
+ const body = await res.json() as { error: { code: string } };
119
+ expect(body.error.code).toBe('not_found');
120
+ });
121
+
122
+ it('serves the hosted-node surface (GET /api/hosted-nodes)', async () => {
123
+ const res = await fetch(`${baseUrl}/api/hosted-nodes`);
124
+ expect(res.status).toBe(200);
125
+ expect(await res.json()).toEqual({ ok: true, data: { nodes: [] } });
126
+ });
127
+
128
+ it('serves the NAT surface (GET /nat/status)', async () => {
129
+ const res = await fetch(`${baseUrl}/nat/status`);
130
+ expect(res.status).toBe(200);
131
+ const body = await res.json() as { directReachability: string };
132
+ expect(body.directReachability).toBe('reachable');
133
+ });
134
+ });