@serfab/cadre-host 1.12.0 → 1.14.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 (337) hide show
  1. package/README.md +332 -423
  2. package/dist/bin/host.d.ts +6 -3
  3. package/dist/bin/host.js +301 -505
  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 +49 -0
  9. package/dist/bin/nat-output.js +127 -0
  10. package/dist/bin/nat-output.js.map +1 -0
  11. package/dist/hosted/claim-details.d.ts +44 -0
  12. package/dist/hosted/claim-details.js +66 -0
  13. package/dist/hosted/claim-details.js.map +1 -0
  14. package/dist/hosted/hosted-node-service.d.ts +318 -0
  15. package/dist/hosted/hosted-node-service.js +666 -0
  16. package/dist/hosted/hosted-node-service.js.map +1 -0
  17. package/dist/hosted/hosted-node-store.d.ts +40 -0
  18. package/dist/hosted/hosted-node-store.js +126 -0
  19. package/dist/hosted/hosted-node-store.js.map +1 -0
  20. package/dist/{donation/donation-supervisor.d.ts → hosted/hosted-node-supervisor.d.ts} +70 -53
  21. package/dist/hosted/hosted-node-supervisor.js +396 -0
  22. package/dist/hosted/hosted-node-supervisor.js.map +1 -0
  23. package/dist/hosted/hosted-node-watcher.d.ts +83 -0
  24. package/dist/hosted/hosted-node-watcher.js +224 -0
  25. package/dist/hosted/hosted-node-watcher.js.map +1 -0
  26. package/dist/hosted/index.d.ts +16 -0
  27. package/dist/hosted/index.js +13 -0
  28. package/dist/hosted/index.js.map +1 -0
  29. package/dist/hosted/node-status.d.ts +35 -0
  30. package/dist/hosted/node-status.js +61 -0
  31. package/dist/hosted/node-status.js.map +1 -0
  32. package/dist/hosted/types.d.ts +134 -0
  33. package/dist/hosted/types.js +22 -0
  34. package/dist/hosted/types.js.map +1 -0
  35. package/dist/index.d.ts +12 -24
  36. package/dist/index.js +9 -19
  37. package/dist/index.js.map +1 -1
  38. package/dist/installer/config.d.ts +4 -34
  39. package/dist/installer/config.js +3 -18
  40. package/dist/installer/config.js.map +1 -1
  41. package/dist/installer/index.d.ts +7 -19
  42. package/dist/installer/index.js +14 -69
  43. package/dist/installer/index.js.map +1 -1
  44. package/dist/installer/paths.d.ts +0 -2
  45. package/dist/installer/paths.js +0 -4
  46. package/dist/installer/paths.js.map +1 -1
  47. package/dist/installer/wizard.d.ts +0 -7
  48. package/dist/installer/wizard.js +1 -8
  49. package/dist/installer/wizard.js.map +1 -1
  50. package/dist/nat/address-resolver.d.ts +18 -17
  51. package/dist/nat/address-resolver.js +79 -25
  52. package/dist/nat/address-resolver.js.map +1 -1
  53. package/dist/nat/address-watch.d.ts +37 -0
  54. package/dist/nat/address-watch.js +84 -0
  55. package/dist/nat/address-watch.js.map +1 -0
  56. package/dist/nat/ddns/duckdns.d.ts +2 -1
  57. package/dist/nat/ddns/duckdns.js +5 -1
  58. package/dist/nat/ddns/duckdns.js.map +1 -1
  59. package/dist/nat/ddns/index.d.ts +6 -0
  60. package/dist/nat/ddns/index.js.map +1 -1
  61. package/dist/nat/index.d.ts +12 -9
  62. package/dist/nat/index.js +6 -5
  63. package/dist/nat/index.js.map +1 -1
  64. package/dist/nat/nat-service.d.ts +203 -77
  65. package/dist/nat/nat-service.js +602 -237
  66. package/dist/nat/nat-service.js.map +1 -1
  67. package/dist/nat/nat-store.d.ts +12 -5
  68. package/dist/nat/nat-store.js +114 -30
  69. package/dist/nat/nat-store.js.map +1 -1
  70. package/dist/nat/port-mapper.d.ts +83 -79
  71. package/dist/nat/port-mapper.js +148 -189
  72. package/dist/nat/port-mapper.js.map +1 -1
  73. package/dist/nat/reachability.d.ts +31 -15
  74. package/dist/nat/reachability.js +97 -22
  75. package/dist/nat/reachability.js.map +1 -1
  76. package/dist/nat/types.d.ts +78 -27
  77. package/dist/nat/types.js +8 -5
  78. package/dist/nat/types.js.map +1 -1
  79. package/dist/orchestrator/host-process-orchestrator.d.ts +29 -71
  80. package/dist/orchestrator/host-process-orchestrator.js +78 -218
  81. package/dist/orchestrator/host-process-orchestrator.js.map +1 -1
  82. package/dist/{installer/identity.d.ts → orchestrator/identity-file.d.ts} +5 -5
  83. package/dist/{installer/identity.js → orchestrator/identity-file.js} +6 -6
  84. package/dist/orchestrator/identity-file.js.map +1 -0
  85. package/dist/orchestrator/index.d.ts +2 -3
  86. package/dist/orchestrator/index.js +1 -1
  87. package/dist/orchestrator/index.js.map +1 -1
  88. package/dist/orchestrator/node-identity.d.ts +6 -6
  89. package/dist/orchestrator/node-identity.js +7 -7
  90. package/dist/orchestrator/node-identity.js.map +1 -1
  91. package/dist/orchestrator/port-allocator.d.ts +5 -6
  92. package/dist/orchestrator/port-allocator.js +9 -11
  93. package/dist/orchestrator/port-allocator.js.map +1 -1
  94. package/dist/orchestrator/state-store.d.ts +3 -5
  95. package/dist/orchestrator/state-store.js +2 -10
  96. package/dist/orchestrator/state-store.js.map +1 -1
  97. package/dist/orchestrator/types.d.ts +33 -22
  98. package/dist/orchestrator/types.js.map +1 -1
  99. package/dist/server/error-handler.d.ts +5 -25
  100. package/dist/server/error-handler.js +11 -74
  101. package/dist/server/error-handler.js.map +1 -1
  102. package/dist/server/events/types.d.ts +7 -11
  103. package/dist/server/events/types.js +2 -1
  104. package/dist/server/events/types.js.map +1 -1
  105. package/dist/server/index.d.ts +11 -37
  106. package/dist/server/index.js +30 -48
  107. package/dist/server/index.js.map +1 -1
  108. package/dist/server/routes/hosted-nodes.d.ts +28 -0
  109. package/dist/server/routes/hosted-nodes.js +68 -0
  110. package/dist/server/routes/hosted-nodes.js.map +1 -0
  111. package/dist/server/routes/nat.d.ts +4 -1
  112. package/dist/server/routes/nat.js +13 -2
  113. package/dist/server/routes/nat.js.map +1 -1
  114. package/dist/server/routes/nodes.d.ts +6 -20
  115. package/dist/server/routes/nodes.js +7 -86
  116. package/dist/server/routes/nodes.js.map +1 -1
  117. package/dist/server/routes/settings.d.ts +2 -7
  118. package/dist/server/routes/settings.js +3 -7
  119. package/dist/server/routes/settings.js.map +1 -1
  120. package/dist/server/routes/status.d.ts +2 -25
  121. package/dist/server/routes/status.js +1 -11
  122. package/dist/server/routes/status.js.map +1 -1
  123. package/dist/server/server.js +8 -8
  124. package/dist/server/settings-store.d.ts +2 -2
  125. package/dist/server/settings-store.js +2 -2
  126. package/dist/server/static.js +1 -2
  127. package/dist/server/static.js.map +1 -1
  128. package/dist/ui/assets/index-4FWuU8ye.js +19 -0
  129. package/dist/ui/assets/index-4FWuU8ye.js.map +1 -0
  130. package/dist/ui/assets/index-Di9Q4d01.css +1 -0
  131. package/dist/ui/index.html +2 -2
  132. package/dist/update/index.d.ts +2 -2
  133. package/dist/update/index.js +2 -2
  134. package/dist/update/store.d.ts +1 -1
  135. package/dist/update/store.js +1 -1
  136. package/dist/update/types.d.ts +1 -1
  137. package/dist/update/types.js +1 -1
  138. package/package.json +5 -6
  139. package/src/__tests__/cli-nat.smoke.test.ts +219 -212
  140. package/src/__tests__/cli.smoke.test.ts +1 -1
  141. package/src/__tests__/global-setup.ts +2 -3
  142. package/src/__tests__/orchestrator-claim-secret.test.ts +112 -0
  143. package/src/__tests__/orchestrator-handle-contract.ts +134 -134
  144. package/src/__tests__/orchestrator-node-identity.test.ts +182 -203
  145. package/src/__tests__/orchestrator-ports.test.ts +124 -143
  146. package/src/__tests__/orchestrator-push.test.ts +138 -146
  147. package/src/__tests__/orchestrator.test.ts +1019 -1063
  148. package/src/bin/host.ts +368 -553
  149. package/src/bin/join-output.ts +120 -0
  150. package/src/bin/nat-output.ts +177 -0
  151. package/src/{donation → hosted}/__tests__/fake-orchestrator.test.ts +173 -173
  152. package/src/{donation → hosted}/__tests__/fake-orchestrator.ts +265 -243
  153. package/src/hosted/__tests__/hosted-node-service.test.ts +609 -0
  154. package/src/hosted/__tests__/hosted-node-supervisor.test.ts +474 -0
  155. package/src/hosted/__tests__/test-invitation.ts +33 -0
  156. package/src/hosted/claim-details.ts +96 -0
  157. package/src/hosted/hosted-node-service.ts +795 -0
  158. package/src/hosted/hosted-node-store.ts +144 -0
  159. package/src/hosted/hosted-node-supervisor.ts +439 -0
  160. package/src/hosted/hosted-node-watcher.ts +250 -0
  161. package/src/hosted/index.ts +53 -0
  162. package/src/hosted/node-status.ts +71 -0
  163. package/src/hosted/types.ts +153 -0
  164. package/src/index.ts +72 -91
  165. package/src/installer/__tests__/config.test.ts +15 -40
  166. package/src/installer/__tests__/installer.smoke.test.ts +5 -86
  167. package/src/installer/__tests__/wizard.test.ts +56 -64
  168. package/src/installer/config.ts +135 -175
  169. package/src/installer/index.ts +15 -83
  170. package/src/installer/paths.ts +104 -109
  171. package/src/installer/wizard.ts +87 -103
  172. package/src/nat/__tests__/address-resolver.test.ts +107 -82
  173. package/src/nat/__tests__/nat-service.test.ts +433 -408
  174. package/src/nat/__tests__/nat-store.test.ts +127 -93
  175. package/src/nat/__tests__/port-mapper.test.ts +30 -191
  176. package/src/nat/__tests__/reachability.test.ts +96 -13
  177. package/src/nat/address-resolver.ts +94 -52
  178. package/src/nat/address-watch.ts +92 -0
  179. package/src/nat/ddns/duckdns.ts +5 -1
  180. package/src/nat/ddns/index.ts +6 -0
  181. package/src/nat/index.ts +87 -71
  182. package/src/nat/nat-service.ts +889 -501
  183. package/src/nat/nat-store.ts +237 -154
  184. package/src/nat/port-mapper.ts +241 -329
  185. package/src/nat/reachability.ts +134 -25
  186. package/src/nat/types.ts +209 -159
  187. package/src/{installer/__tests__/identity.test.ts → orchestrator/__tests__/identity-file.test.ts} +34 -34
  188. package/src/orchestrator/__tests__/node-identity.test.ts +62 -62
  189. package/src/orchestrator/host-process-orchestrator.ts +81 -243
  190. package/src/{installer/identity.ts → orchestrator/identity-file.ts} +56 -56
  191. package/src/orchestrator/index.ts +9 -10
  192. package/src/orchestrator/node-identity.ts +41 -41
  193. package/src/orchestrator/port-allocator.ts +71 -73
  194. package/src/orchestrator/state-store.ts +76 -90
  195. package/src/orchestrator/types.ts +34 -23
  196. package/src/server/__tests__/bus.test.ts +38 -38
  197. package/src/server/__tests__/error-handler.test.ts +81 -118
  198. package/src/server/__tests__/fakes.ts +40 -44
  199. package/src/server/__tests__/hosted-nodes-route.test.ts +160 -0
  200. package/src/server/__tests__/nodes-route.test.ts +114 -283
  201. package/src/server/__tests__/publishers.test.ts +193 -180
  202. package/src/server/__tests__/server.smoke.test.ts +134 -223
  203. package/src/server/__tests__/settings-route.test.ts +179 -195
  204. package/src/server/__tests__/sse-route.test.ts +119 -119
  205. package/src/server/__tests__/status-route.test.ts +82 -121
  206. package/src/server/error-handler.ts +112 -178
  207. package/src/server/events/types.ts +20 -24
  208. package/src/server/index.ts +223 -267
  209. package/src/server/routes/hosted-nodes.ts +83 -0
  210. package/src/server/routes/nat.ts +75 -63
  211. package/src/server/routes/nodes.ts +96 -188
  212. package/src/server/routes/settings.ts +115 -123
  213. package/src/server/routes/status.ts +102 -134
  214. package/src/server/server.ts +8 -8
  215. package/src/server/settings-store.ts +2 -2
  216. package/src/server/static.ts +1 -2
  217. package/src/update/index.ts +2 -2
  218. package/src/update/store.ts +1 -1
  219. package/src/update/types.ts +1 -1
  220. package/dist/auth/duration.d.ts +0 -1
  221. package/dist/auth/duration.js +0 -32
  222. package/dist/auth/duration.js.map +0 -1
  223. package/dist/auth/index.d.ts +0 -11
  224. package/dist/auth/index.js +0 -9
  225. package/dist/auth/index.js.map +0 -1
  226. package/dist/auth/self-label.d.ts +0 -36
  227. package/dist/auth/self-label.js +0 -57
  228. package/dist/auth/self-label.js.map +0 -1
  229. package/dist/auth/trust-circle-store.d.ts +0 -26
  230. package/dist/auth/trust-circle-store.js +0 -129
  231. package/dist/auth/trust-circle-store.js.map +0 -1
  232. package/dist/auth/trust-circle.d.ts +0 -156
  233. package/dist/auth/trust-circle.js +0 -307
  234. package/dist/auth/trust-circle.js.map +0 -1
  235. package/dist/auth/types.d.ts +0 -84
  236. package/dist/auth/types.js +0 -24
  237. package/dist/auth/types.js.map +0 -1
  238. package/dist/donation/donation-service.d.ts +0 -389
  239. package/dist/donation/donation-service.js +0 -828
  240. package/dist/donation/donation-service.js.map +0 -1
  241. package/dist/donation/donation-store.d.ts +0 -51
  242. package/dist/donation/donation-store.js +0 -152
  243. package/dist/donation/donation-store.js.map +0 -1
  244. package/dist/donation/donation-supervisor.js +0 -364
  245. package/dist/donation/donation-supervisor.js.map +0 -1
  246. package/dist/donation/grant-service.d.ts +0 -80
  247. package/dist/donation/grant-service.js +0 -210
  248. package/dist/donation/grant-service.js.map +0 -1
  249. package/dist/donation/grant-store.d.ts +0 -38
  250. package/dist/donation/grant-store.js +0 -135
  251. package/dist/donation/grant-store.js.map +0 -1
  252. package/dist/donation/index.d.ts +0 -20
  253. package/dist/donation/index.js +0 -17
  254. package/dist/donation/index.js.map +0 -1
  255. package/dist/donation/types.d.ts +0 -224
  256. package/dist/donation/types.js +0 -40
  257. package/dist/donation/types.js.map +0 -1
  258. package/dist/installer/identity.js.map +0 -1
  259. package/dist/owner/index.d.ts +0 -11
  260. package/dist/owner/index.js +0 -11
  261. package/dist/owner/index.js.map +0 -1
  262. package/dist/owner/owner-node-client.d.ts +0 -110
  263. package/dist/owner/owner-node-client.js +0 -184
  264. package/dist/owner/owner-node-client.js.map +0 -1
  265. package/dist/server/routes/bootstrap-node-validation.d.ts +0 -115
  266. package/dist/server/routes/bootstrap-node-validation.js +0 -197
  267. package/dist/server/routes/bootstrap-node-validation.js.map +0 -1
  268. package/dist/server/routes/grants-admin.d.ts +0 -29
  269. package/dist/server/routes/grants-admin.js +0 -58
  270. package/dist/server/routes/grants-admin.js.map +0 -1
  271. package/dist/server/routes/grants.d.ts +0 -28
  272. package/dist/server/routes/grants.js +0 -165
  273. package/dist/server/routes/grants.js.map +0 -1
  274. package/dist/server/routes/provision-request-validation.d.ts +0 -45
  275. package/dist/server/routes/provision-request-validation.js +0 -97
  276. package/dist/server/routes/provision-request-validation.js.map +0 -1
  277. package/dist/server/routes/strands.d.ts +0 -20
  278. package/dist/server/routes/strands.js +0 -38
  279. package/dist/server/routes/strands.js.map +0 -1
  280. package/dist/server/routes/trust-circle.d.ts +0 -17
  281. package/dist/server/routes/trust-circle.js +0 -35
  282. package/dist/server/routes/trust-circle.js.map +0 -1
  283. package/dist/strands/index.d.ts +0 -7
  284. package/dist/strands/index.js +0 -6
  285. package/dist/strands/index.js.map +0 -1
  286. package/dist/strands/strand-service.d.ts +0 -50
  287. package/dist/strands/strand-service.js +0 -103
  288. package/dist/strands/strand-service.js.map +0 -1
  289. package/dist/strands/types.d.ts +0 -93
  290. package/dist/strands/types.js +0 -23
  291. package/dist/strands/types.js.map +0 -1
  292. package/dist/ui/assets/index-C6nELNfC.js +0 -23
  293. package/dist/ui/assets/index-C6nELNfC.js.map +0 -1
  294. package/dist/ui/assets/index-TtIYSeZO.css +0 -1
  295. package/src/__tests__/cli-invite.smoke.test.ts +0 -192
  296. package/src/__tests__/host-owner.smoke.test.ts +0 -123
  297. package/src/__tests__/orchestrator-owner.test.ts +0 -234
  298. package/src/__tests__/orchestrator-pin-keys.test.ts +0 -152
  299. package/src/auth/__tests__/duration.test.ts +0 -28
  300. package/src/auth/__tests__/self-label.test.ts +0 -85
  301. package/src/auth/__tests__/trust-circle-integration.test.ts +0 -152
  302. package/src/auth/__tests__/trust-circle-store.test.ts +0 -115
  303. package/src/auth/__tests__/trust-circle.test.ts +0 -445
  304. package/src/auth/duration.ts +0 -33
  305. package/src/auth/index.ts +0 -21
  306. package/src/auth/self-label.ts +0 -74
  307. package/src/auth/trust-circle-store.ts +0 -155
  308. package/src/auth/trust-circle.ts +0 -395
  309. package/src/auth/types.ts +0 -99
  310. package/src/donation/__tests__/donation-service.test.ts +0 -1193
  311. package/src/donation/__tests__/donation-supervisor.test.ts +0 -548
  312. package/src/donation/__tests__/grant-service.test.ts +0 -213
  313. package/src/donation/__tests__/grant-store.test.ts +0 -113
  314. package/src/donation/donation-service.ts +0 -1033
  315. package/src/donation/donation-store.ts +0 -176
  316. package/src/donation/donation-supervisor.ts +0 -411
  317. package/src/donation/grant-service.ts +0 -252
  318. package/src/donation/grant-store.ts +0 -152
  319. package/src/donation/index.ts +0 -65
  320. package/src/donation/types.ts +0 -260
  321. package/src/owner/__tests__/owner-node-client.test.ts +0 -194
  322. package/src/owner/index.ts +0 -12
  323. package/src/owner/owner-node-client.ts +0 -259
  324. package/src/server/__tests__/bootstrap-node-validation.test.ts +0 -138
  325. package/src/server/__tests__/grants-admin-route.test.ts +0 -171
  326. package/src/server/__tests__/grants-route.test.ts +0 -394
  327. package/src/server/__tests__/strands-route.test.ts +0 -234
  328. package/src/server/routes/bootstrap-node-validation.ts +0 -206
  329. package/src/server/routes/grants-admin.ts +0 -74
  330. package/src/server/routes/grants.ts +0 -193
  331. package/src/server/routes/provision-request-validation.ts +0 -105
  332. package/src/server/routes/strands.ts +0 -54
  333. package/src/server/routes/trust-circle.ts +0 -49
  334. package/src/strands/__tests__/strand-service.test.ts +0 -165
  335. package/src/strands/index.ts +0 -14
  336. package/src/strands/strand-service.ts +0 -135
  337. 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
+ });