@serfab/cadre-host 0.9.0 → 0.11.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 (213) hide show
  1. package/dist/auth/index.d.ts +2 -0
  2. package/dist/auth/index.js +1 -0
  3. package/dist/auth/index.js.map +1 -1
  4. package/dist/auth/self-label.d.ts +36 -0
  5. package/dist/auth/self-label.js +57 -0
  6. package/dist/auth/self-label.js.map +1 -0
  7. package/dist/auth/trust-circle.d.ts +32 -5
  8. package/dist/auth/trust-circle.js +31 -11
  9. package/dist/auth/trust-circle.js.map +1 -1
  10. package/dist/bin/host.js +41 -5
  11. package/dist/bin/host.js.map +1 -1
  12. package/dist/donation/__tests__/fake-orchestrator.d.ts +103 -0
  13. package/dist/donation/__tests__/fake-orchestrator.js +180 -0
  14. package/dist/donation/__tests__/fake-orchestrator.js.map +1 -0
  15. package/dist/donation/donation-service.d.ts +237 -12
  16. package/dist/donation/donation-service.js +491 -34
  17. package/dist/donation/donation-service.js.map +1 -1
  18. package/dist/donation/donation-store.d.ts +7 -0
  19. package/dist/donation/donation-store.js +7 -0
  20. package/dist/donation/donation-store.js.map +1 -1
  21. package/dist/donation/donation-supervisor.d.ts +167 -0
  22. package/dist/donation/donation-supervisor.js +341 -0
  23. package/dist/donation/donation-supervisor.js.map +1 -0
  24. package/dist/donation/index.d.ts +4 -2
  25. package/dist/donation/index.js +2 -1
  26. package/dist/donation/index.js.map +1 -1
  27. package/dist/donation/types.d.ts +26 -0
  28. package/dist/donation/types.js.map +1 -1
  29. package/dist/index.d.ts +3 -1
  30. package/dist/index.js +3 -1
  31. package/dist/index.js.map +1 -1
  32. package/dist/orchestrator/host-process-orchestrator.d.ts +109 -5
  33. package/dist/orchestrator/host-process-orchestrator.js +341 -98
  34. package/dist/orchestrator/host-process-orchestrator.js.map +1 -1
  35. package/dist/orchestrator/node-identity.d.ts +26 -0
  36. package/dist/orchestrator/node-identity.js +36 -0
  37. package/dist/orchestrator/node-identity.js.map +1 -0
  38. package/dist/orchestrator/port-allocator.d.ts +14 -0
  39. package/dist/orchestrator/port-allocator.js +45 -0
  40. package/dist/orchestrator/port-allocator.js.map +1 -1
  41. package/dist/owner/owner-node-client.d.ts +20 -5
  42. package/dist/owner/owner-node-client.js +21 -4
  43. package/dist/owner/owner-node-client.js.map +1 -1
  44. package/dist/server/error-handler.d.ts +7 -1
  45. package/dist/server/error-handler.js +23 -1
  46. package/dist/server/error-handler.js.map +1 -1
  47. package/dist/server/events/types.d.ts +3 -0
  48. package/dist/server/index.d.ts +7 -0
  49. package/dist/server/index.js +9 -3
  50. package/dist/server/index.js.map +1 -1
  51. package/dist/server/routes/grants.js +22 -3
  52. package/dist/server/routes/grants.js.map +1 -1
  53. package/dist/server/routes/strands.d.ts +20 -0
  54. package/dist/server/routes/strands.js +38 -0
  55. package/dist/server/routes/strands.js.map +1 -0
  56. package/dist/server/static.js +38 -38
  57. package/dist/strands/index.d.ts +7 -0
  58. package/dist/strands/index.js +6 -0
  59. package/dist/strands/index.js.map +1 -0
  60. package/dist/strands/strand-service.d.ts +50 -0
  61. package/dist/strands/strand-service.js +103 -0
  62. package/dist/strands/strand-service.js.map +1 -0
  63. package/dist/strands/types.d.ts +93 -0
  64. package/dist/strands/types.js +23 -0
  65. package/dist/strands/types.js.map +1 -0
  66. package/dist/ui/assets/index-BVoqLjyX.css +1 -0
  67. package/dist/ui/assets/index-C-iks41M.js +17 -0
  68. package/dist/ui/assets/index-C-iks41M.js.map +1 -0
  69. package/dist/ui/index.html +14 -14
  70. package/dist/update/release-key.d.ts +1 -1
  71. package/dist/update/release-key.js +1 -1
  72. package/package.json +5 -5
  73. package/service/cadre-host.service.tmpl +16 -16
  74. package/service/com.serfab.cadre-host.plist.tmpl +35 -35
  75. package/service/install-service.ps1 +98 -98
  76. package/service/uninstall-service.ps1 +19 -19
  77. package/src/__tests__/build-targets.test.ts +26 -0
  78. package/src/__tests__/cli-invite.smoke.test.ts +192 -192
  79. package/src/__tests__/cli-nat.smoke.test.ts +212 -212
  80. package/src/__tests__/cli.smoke.test.ts +46 -46
  81. package/src/__tests__/global-setup.ts +51 -0
  82. package/src/__tests__/host-owner.smoke.test.ts +123 -123
  83. package/src/__tests__/orchestrator-env-scrub.test.ts +140 -0
  84. package/src/__tests__/orchestrator-node-identity.test.ts +204 -0
  85. package/src/__tests__/orchestrator-owner.test.ts +198 -198
  86. package/src/__tests__/orchestrator-pin-keys.test.ts +153 -153
  87. package/src/__tests__/orchestrator-push.test.ts +145 -145
  88. package/src/__tests__/orchestrator.test.ts +951 -570
  89. package/src/auth/__tests__/duration.test.ts +28 -28
  90. package/src/auth/__tests__/self-label.test.ts +85 -0
  91. package/src/auth/__tests__/trust-circle-integration.test.ts +152 -147
  92. package/src/auth/__tests__/trust-circle-store.test.ts +115 -115
  93. package/src/auth/__tests__/trust-circle.test.ts +445 -401
  94. package/src/auth/duration.ts +33 -33
  95. package/src/auth/index.ts +21 -19
  96. package/src/auth/self-label.ts +74 -0
  97. package/src/auth/trust-circle-store.ts +155 -155
  98. package/src/auth/trust-circle.ts +45 -13
  99. package/src/auth/types.ts +99 -99
  100. package/src/bin/host.ts +1299 -1258
  101. package/src/donation/__tests__/donation-service.test.ts +1068 -290
  102. package/src/donation/__tests__/donation-supervisor.test.ts +510 -0
  103. package/src/donation/__tests__/fake-orchestrator.test.ts +168 -0
  104. package/src/donation/__tests__/fake-orchestrator.ts +225 -0
  105. package/src/donation/__tests__/grant-service.test.ts +213 -213
  106. package/src/donation/__tests__/grant-store.test.ts +113 -113
  107. package/src/donation/donation-service.ts +962 -392
  108. package/src/donation/donation-store.ts +171 -164
  109. package/src/donation/donation-supervisor.ts +388 -0
  110. package/src/donation/grant-service.ts +200 -200
  111. package/src/donation/grant-store.ts +152 -152
  112. package/src/donation/index.ts +64 -49
  113. package/src/donation/types.ts +243 -220
  114. package/src/index.ts +14 -0
  115. package/src/installer/__tests__/identity.test.ts +34 -34
  116. package/src/installer/__tests__/paths.test.ts +47 -47
  117. package/src/installer/__tests__/service-host.test.ts +62 -62
  118. package/src/installer/__tests__/wizard.test.ts +64 -64
  119. package/src/installer/identity.ts +49 -49
  120. package/src/installer/paths.ts +109 -109
  121. package/src/installer/platform.ts +27 -27
  122. package/src/installer/service-host/index.ts +21 -21
  123. package/src/installer/service-host/template.ts +21 -21
  124. package/src/installer/wizard.ts +103 -103
  125. package/src/nat/__tests__/address-resolver.test.ts +82 -82
  126. package/src/nat/__tests__/ddns-duckdns.test.ts +83 -83
  127. package/src/nat/__tests__/ddns-updater.test.ts +253 -253
  128. package/src/nat/__tests__/external-ip.test.ts +124 -124
  129. package/src/nat/__tests__/nat-service.test.ts +497 -497
  130. package/src/nat/__tests__/nat-store.test.ts +93 -93
  131. package/src/nat/__tests__/port-mapper.test.ts +191 -191
  132. package/src/nat/__tests__/reachability.test.ts +24 -24
  133. package/src/nat/__tests__/secrets.test.ts +178 -178
  134. package/src/nat/address-resolver.ts +51 -51
  135. package/src/nat/ddns/duckdns.ts +76 -76
  136. package/src/nat/ddns/index.ts +55 -55
  137. package/src/nat/ddns/updater.ts +243 -243
  138. package/src/nat/external-ip.ts +154 -154
  139. package/src/nat/index.ts +71 -71
  140. package/src/nat/nat-service.ts +501 -501
  141. package/src/nat/nat-store.ts +154 -154
  142. package/src/nat/port-mapper.ts +329 -329
  143. package/src/nat/reachability.ts +34 -34
  144. package/src/nat/secrets/file-store.ts +130 -130
  145. package/src/nat/secrets/index.ts +112 -112
  146. package/src/nat/secrets/keytar-store.ts +67 -67
  147. package/src/nat/types.ts +159 -159
  148. package/src/orchestrator/__tests__/node-identity.test.ts +62 -0
  149. package/src/orchestrator/host-process-orchestrator.ts +1133 -894
  150. package/src/orchestrator/index.ts +10 -10
  151. package/src/orchestrator/log-rotator.ts +53 -53
  152. package/src/orchestrator/node-identity.ts +40 -0
  153. package/src/orchestrator/pid-liveness.ts +24 -24
  154. package/src/orchestrator/port-allocator.ts +91 -43
  155. package/src/orchestrator/state-store.ts +90 -90
  156. package/src/orchestrator/types.ts +141 -141
  157. package/src/owner/__tests__/owner-node-client.test.ts +194 -194
  158. package/src/owner/index.ts +12 -12
  159. package/src/owner/owner-node-client.ts +259 -233
  160. package/src/push/__tests__/push.test.ts +90 -90
  161. package/src/push/index.ts +146 -146
  162. package/src/server/__tests__/bus.test.ts +38 -38
  163. package/src/server/__tests__/error-handler.test.ts +118 -118
  164. package/src/server/__tests__/grants-admin-route.test.ts +73 -73
  165. package/src/server/__tests__/grants-route.test.ts +263 -189
  166. package/src/server/__tests__/nodes-route.test.ts +259 -259
  167. package/src/server/__tests__/origin-guard.test.ts +72 -72
  168. package/src/server/__tests__/publishers.test.ts +216 -216
  169. package/src/server/__tests__/server.smoke.test.ts +253 -253
  170. package/src/server/__tests__/settings-route.test.ts +194 -194
  171. package/src/server/__tests__/sse-route.test.ts +119 -119
  172. package/src/server/__tests__/static.test.ts +145 -145
  173. package/src/server/__tests__/status-route.test.ts +134 -134
  174. package/src/server/__tests__/strands-route.test.ts +233 -0
  175. package/src/server/error-handler.ts +178 -155
  176. package/src/server/events/bus.ts +42 -42
  177. package/src/server/events/sse-route.ts +81 -81
  178. package/src/server/events/types.ts +23 -22
  179. package/src/server/index.ts +267 -254
  180. package/src/server/origin-guard.ts +84 -84
  181. package/src/server/routes/grants-admin.ts +41 -41
  182. package/src/server/routes/grants.ts +210 -186
  183. package/src/server/routes/nat.ts +63 -63
  184. package/src/server/routes/nodes.ts +170 -170
  185. package/src/server/routes/settings.ts +123 -123
  186. package/src/server/routes/status.ts +118 -118
  187. package/src/server/routes/strands.ts +54 -0
  188. package/src/server/routes/trust-circle.ts +49 -49
  189. package/src/server/routes/update.ts +43 -43
  190. package/src/server/server.ts +122 -122
  191. package/src/server/settings-store.ts +37 -37
  192. package/src/server/static.ts +207 -207
  193. package/src/strands/__tests__/strand-service.test.ts +165 -0
  194. package/src/strands/index.ts +14 -0
  195. package/src/strands/strand-service.ts +135 -0
  196. package/src/strands/types.ts +102 -0
  197. package/src/update/__tests__/apply.test.ts +158 -158
  198. package/src/update/__tests__/manifest.test.ts +128 -128
  199. package/src/update/__tests__/release-key.test.ts +42 -42
  200. package/src/update/__tests__/sign.test.ts +78 -78
  201. package/src/update/__tests__/store.test.ts +81 -81
  202. package/src/update/__tests__/update-service.integration.test.ts +256 -256
  203. package/src/update/__tests__/version.test.ts +31 -31
  204. package/src/update/apply.ts +190 -190
  205. package/src/update/index.ts +341 -341
  206. package/src/update/release-key.ts +71 -71
  207. package/src/update/sign.ts +74 -74
  208. package/src/update/store.ts +101 -101
  209. package/src/update/types.ts +109 -109
  210. package/src/update/version.ts +80 -80
  211. package/dist/ui/assets/index-BlMXQPSw.js +0 -14
  212. package/dist/ui/assets/index-BlMXQPSw.js.map +0 -1
  213. package/dist/ui/assets/index-BwU5mJGF.css +0 -1
@@ -1,192 +1,192 @@
1
- /**
2
- * CLI smoke test for the `invite` subcommand. Spawns a stub HTTP server
3
- * playing the role of cadre-host's management API and asserts the CLI:
4
- * - POSTs the expected body to /auth/invites
5
- * - Prints the encodedInvite on stdout
6
- * - Exits 0 on success / non-zero on connect failure
7
- *
8
- * Relies on `yarn build` having produced dist/bin/host.js.
9
- */
10
-
11
- import { spawn } from 'node:child_process';
12
- import { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';
13
- import { existsSync } from 'node:fs';
14
- import { fileURLToPath } from 'node:url';
15
- import { dirname, resolve } from 'node:path';
16
- import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
17
-
18
- const here = dirname(fileURLToPath(import.meta.url));
19
- const binPath = resolve(here, '../../dist/bin/host.js');
20
-
21
- // These smoke tests cold-start the built CLI as a child process (Node boot +,
22
- // for some, an HTTP server). That comfortably exceeds vitest's 5s default under
23
- // heavy parallel load, so give the subprocess generous headroom.
24
- vi.setConfig({ testTimeout: 30000 });
25
-
26
- interface StubServer {
27
- server: Server;
28
- port: number;
29
- requests: Array<{ method: string; url: string; body: string }>;
30
- setResponse(handler: (req: IncomingMessage, res: ServerResponse) => void): void;
31
- }
32
-
33
- async function startStub(): Promise<StubServer> {
34
- const requests: StubServer['requests'] = [];
35
- let handler: (req: IncomingMessage, res: ServerResponse) => void = (_req, res) => {
36
- res.statusCode = 200;
37
- res.setHeader('content-type', 'application/json');
38
- res.end(JSON.stringify({
39
- encodedInvite: 'fake-encoded-invite',
40
- token: 'fake-token',
41
- expiresAt: new Date(Date.now() + 60_000).toISOString(),
42
- }));
43
- };
44
-
45
- const server = createServer((req, res) => {
46
- const chunks: Buffer[] = [];
47
- req.on('data', (chunk: Buffer) => chunks.push(chunk));
48
- req.on('end', () => {
49
- requests.push({ method: req.method ?? '', url: req.url ?? '', body: Buffer.concat(chunks).toString('utf8') });
50
- handler(req, res);
51
- });
52
- });
53
-
54
- await new Promise<void>((resolveStart) => server.listen(0, '127.0.0.1', () => resolveStart()));
55
- const addr = server.address();
56
- const port = typeof addr === 'object' && addr ? addr.port : 0;
57
- return {
58
- server,
59
- port,
60
- requests,
61
- setResponse: (h) => { handler = h; },
62
- };
63
- }
64
-
65
- function runCli(args: string[]): Promise<{ code: number; stdout: string; stderr: string }> {
66
- return new Promise((resolveRun) => {
67
- const child = spawn(process.execPath, [binPath, ...args], { stdio: ['ignore', 'pipe', 'pipe'] });
68
- let stdout = '';
69
- let stderr = '';
70
- child.stdout.on('data', (chunk: Buffer) => { stdout += chunk.toString('utf8'); });
71
- child.stderr.on('data', (chunk: Buffer) => { stderr += chunk.toString('utf8'); });
72
- child.on('close', (code) => resolveRun({ code: code ?? -1, stdout, stderr }));
73
- });
74
- }
75
-
76
- let stub: StubServer;
77
-
78
- beforeEach(async () => {
79
- if (!existsSync(binPath)) {
80
- throw new Error(`cadre-host bin not built at ${binPath}; run \`yarn build\` first`);
81
- }
82
- stub = await startStub();
83
- });
84
-
85
- afterEach(async () => {
86
- await new Promise<void>((resolveClose) => stub.server.close(() => resolveClose()));
87
- });
88
-
89
- describe('cadre-host invite CLI', () => {
90
- it('POSTs to /auth/invites with label + ttlMs and prints encoded invite', async () => {
91
- const result = await runCli(['invite', "Mom's phone", '--ttl', '12h', '--port', String(stub.port)]);
92
-
93
- expect(result.code).toBe(0);
94
- expect(result.stdout.trim()).toBe('fake-encoded-invite');
95
- expect(stub.requests).toHaveLength(1);
96
- expect(stub.requests[0]!.method).toBe('POST');
97
- expect(stub.requests[0]!.url).toBe('/auth/invites');
98
- const body = JSON.parse(stub.requests[0]!.body);
99
- expect(body.label).toBe("Mom's phone");
100
- expect(body.ttlMs).toBe(12 * 60 * 60 * 1000);
101
- });
102
-
103
- it('exits non-zero when cadre-host returns an error', async () => {
104
- stub.setResponse((_req, res) => {
105
- res.statusCode = 500;
106
- res.end('boom');
107
- });
108
- const result = await runCli(['invite', 'Test', '--port', String(stub.port)]);
109
- expect(result.code).not.toBe(0);
110
- expect(result.stderr).toContain('500');
111
- });
112
-
113
- it('exits 2 (no service) when cadre-host is not reachable', async () => {
114
- // Use a port the stub server occupied; close it first so connections fail.
115
- const port = stub.port;
116
- await new Promise<void>((resolveClose) => stub.server.close(() => resolveClose()));
117
- const result = await runCli(['invite', 'Test', '--port', String(port)]);
118
- expect(result.code).toBe(2);
119
- expect(result.stderr).toMatch(/cadre-host start|Failed to reach/);
120
- });
121
-
122
- it('rejects invalid --ttl', async () => {
123
- const result = await runCli(['invite', 'Test', '--ttl', 'eternity', '--port', String(stub.port)]);
124
- expect(result.code).toBe(1);
125
- expect(result.stderr).toMatch(/Invalid --ttl/);
126
- });
127
- });
128
-
129
- describe('cadre-host trust list CLI', () => {
130
- it('renders members and pending invites', async () => {
131
- stub.setResponse((_req, res) => {
132
- res.statusCode = 200;
133
- res.setHeader('content-type', 'application/json');
134
- res.end(JSON.stringify({
135
- members: [
136
- { peerId: '12D3KooWAlice', label: 'Alice', addedAt: 't1' },
137
- { peerId: '12D3KooWHost', label: 'Host', addedAt: 't2', self: true },
138
- ],
139
- pending: [
140
- { token: 'tok1', label: 'Mom', createdAt: 't3', expiresAt: 't4' },
141
- ],
142
- }));
143
- });
144
-
145
- const result = await runCli(['trust', 'list', '--port', String(stub.port)]);
146
- expect(result.code).toBe(0);
147
- expect(result.stdout).toContain('12D3KooWAlice');
148
- expect(result.stdout).toContain('Alice');
149
- expect(result.stdout).toContain('[self]');
150
- expect(result.stdout).toContain('tok1');
151
- expect(result.stdout).toContain('Mom');
152
- });
153
- });
154
-
155
- describe('cadre-host trust revoke CLI', () => {
156
- it('DELETEs /auth/invites/<token> by default', async () => {
157
- stub.setResponse((_req, res) => {
158
- res.statusCode = 204;
159
- res.end();
160
- });
161
- const result = await runCli(['trust', 'revoke', 'some-token', '--port', String(stub.port)]);
162
- expect(result.code).toBe(0);
163
- expect(stub.requests[0]!.method).toBe('DELETE');
164
- expect(stub.requests[0]!.url).toBe('/auth/invites/some-token');
165
- });
166
-
167
- it('DELETEs /auth/members/<peerId> when id looks like a peerId', async () => {
168
- stub.setResponse((_req, res) => {
169
- res.statusCode = 204;
170
- res.end();
171
- });
172
- const result = await runCli(['trust', 'revoke', '12D3KooWAlice', '--port', String(stub.port)]);
173
- expect(result.code).toBe(0);
174
- expect(stub.requests[0]!.url).toBe('/auth/members/12D3KooWAlice');
175
- });
176
-
177
- it('treats secp256k1 peer IDs (16Uiu2HAm…) as members', async () => {
178
- stub.setResponse((_req, res) => {
179
- res.statusCode = 204;
180
- res.end();
181
- });
182
- const result = await runCli(['trust', 'revoke', '16Uiu2HAmExample', '--port', String(stub.port)]);
183
- expect(result.code).toBe(0);
184
- expect(stub.requests[0]!.url).toBe('/auth/members/16Uiu2HAmExample');
185
- });
186
-
187
- it('rejects invalid --port', async () => {
188
- const result = await runCli(['trust', 'revoke', 'some-token', '--port', 'garbage']);
189
- expect(result.code).toBe(1);
190
- expect(result.stderr).toMatch(/Invalid --port/);
191
- });
192
- });
1
+ /**
2
+ * CLI smoke test for the `invite` subcommand. Spawns a stub HTTP server
3
+ * playing the role of cadre-host's management API and asserts the CLI:
4
+ * - POSTs the expected body to /auth/invites
5
+ * - Prints the encodedInvite on stdout
6
+ * - Exits 0 on success / non-zero on connect failure
7
+ *
8
+ * Relies on `yarn build` having produced dist/bin/host.js.
9
+ */
10
+
11
+ import { spawn } from 'node:child_process';
12
+ import { createServer, type IncomingMessage, type Server, type ServerResponse } from 'node:http';
13
+ import { existsSync } from 'node:fs';
14
+ import { fileURLToPath } from 'node:url';
15
+ import { dirname, resolve } from 'node:path';
16
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
17
+
18
+ const here = dirname(fileURLToPath(import.meta.url));
19
+ const binPath = resolve(here, '../../dist/bin/host.js');
20
+
21
+ // These smoke tests cold-start the built CLI as a child process (Node boot +,
22
+ // for some, an HTTP server). That comfortably exceeds vitest's 5s default under
23
+ // heavy parallel load, so give the subprocess generous headroom.
24
+ vi.setConfig({ testTimeout: 30000 });
25
+
26
+ interface StubServer {
27
+ server: Server;
28
+ port: number;
29
+ requests: Array<{ method: string; url: string; body: string }>;
30
+ setResponse(handler: (req: IncomingMessage, res: ServerResponse) => void): void;
31
+ }
32
+
33
+ async function startStub(): Promise<StubServer> {
34
+ const requests: StubServer['requests'] = [];
35
+ let handler: (req: IncomingMessage, res: ServerResponse) => void = (_req, res) => {
36
+ res.statusCode = 200;
37
+ res.setHeader('content-type', 'application/json');
38
+ res.end(JSON.stringify({
39
+ encodedInvite: 'fake-encoded-invite',
40
+ token: 'fake-token',
41
+ expiresAt: new Date(Date.now() + 60_000).toISOString(),
42
+ }));
43
+ };
44
+
45
+ const server = createServer((req, res) => {
46
+ const chunks: Buffer[] = [];
47
+ req.on('data', (chunk: Buffer) => chunks.push(chunk));
48
+ req.on('end', () => {
49
+ requests.push({ method: req.method ?? '', url: req.url ?? '', body: Buffer.concat(chunks).toString('utf8') });
50
+ handler(req, res);
51
+ });
52
+ });
53
+
54
+ await new Promise<void>((resolveStart) => server.listen(0, '127.0.0.1', () => resolveStart()));
55
+ const addr = server.address();
56
+ const port = typeof addr === 'object' && addr ? addr.port : 0;
57
+ return {
58
+ server,
59
+ port,
60
+ requests,
61
+ setResponse: (h) => { handler = h; },
62
+ };
63
+ }
64
+
65
+ function runCli(args: string[]): Promise<{ code: number; stdout: string; stderr: string }> {
66
+ return new Promise((resolveRun) => {
67
+ const child = spawn(process.execPath, [binPath, ...args], { stdio: ['ignore', 'pipe', 'pipe'] });
68
+ let stdout = '';
69
+ let stderr = '';
70
+ child.stdout.on('data', (chunk: Buffer) => { stdout += chunk.toString('utf8'); });
71
+ child.stderr.on('data', (chunk: Buffer) => { stderr += chunk.toString('utf8'); });
72
+ child.on('close', (code) => resolveRun({ code: code ?? -1, stdout, stderr }));
73
+ });
74
+ }
75
+
76
+ let stub: StubServer;
77
+
78
+ beforeEach(async () => {
79
+ if (!existsSync(binPath)) {
80
+ throw new Error(`cadre-host bin not built at ${binPath}; run \`yarn build\` first`);
81
+ }
82
+ stub = await startStub();
83
+ });
84
+
85
+ afterEach(async () => {
86
+ await new Promise<void>((resolveClose) => stub.server.close(() => resolveClose()));
87
+ });
88
+
89
+ describe('cadre-host invite CLI', () => {
90
+ it('POSTs to /auth/invites with label + ttlMs and prints encoded invite', async () => {
91
+ const result = await runCli(['invite', "Mom's phone", '--ttl', '12h', '--port', String(stub.port)]);
92
+
93
+ expect(result.code).toBe(0);
94
+ expect(result.stdout.trim()).toBe('fake-encoded-invite');
95
+ expect(stub.requests).toHaveLength(1);
96
+ expect(stub.requests[0]!.method).toBe('POST');
97
+ expect(stub.requests[0]!.url).toBe('/auth/invites');
98
+ const body = JSON.parse(stub.requests[0]!.body);
99
+ expect(body.label).toBe("Mom's phone");
100
+ expect(body.ttlMs).toBe(12 * 60 * 60 * 1000);
101
+ });
102
+
103
+ it('exits non-zero when cadre-host returns an error', async () => {
104
+ stub.setResponse((_req, res) => {
105
+ res.statusCode = 500;
106
+ res.end('boom');
107
+ });
108
+ const result = await runCli(['invite', 'Test', '--port', String(stub.port)]);
109
+ expect(result.code).not.toBe(0);
110
+ expect(result.stderr).toContain('500');
111
+ });
112
+
113
+ it('exits 2 (no service) when cadre-host is not reachable', async () => {
114
+ // Use a port the stub server occupied; close it first so connections fail.
115
+ const port = stub.port;
116
+ await new Promise<void>((resolveClose) => stub.server.close(() => resolveClose()));
117
+ const result = await runCli(['invite', 'Test', '--port', String(port)]);
118
+ expect(result.code).toBe(2);
119
+ expect(result.stderr).toMatch(/cadre-host start|Failed to reach/);
120
+ });
121
+
122
+ it('rejects invalid --ttl', async () => {
123
+ const result = await runCli(['invite', 'Test', '--ttl', 'eternity', '--port', String(stub.port)]);
124
+ expect(result.code).toBe(1);
125
+ expect(result.stderr).toMatch(/Invalid --ttl/);
126
+ });
127
+ });
128
+
129
+ describe('cadre-host trust list CLI', () => {
130
+ it('renders members and pending invites', async () => {
131
+ stub.setResponse((_req, res) => {
132
+ res.statusCode = 200;
133
+ res.setHeader('content-type', 'application/json');
134
+ res.end(JSON.stringify({
135
+ members: [
136
+ { peerId: '12D3KooWAlice', label: 'Alice', addedAt: 't1' },
137
+ { peerId: '12D3KooWHost', label: 'Host', addedAt: 't2', self: true },
138
+ ],
139
+ pending: [
140
+ { token: 'tok1', label: 'Mom', createdAt: 't3', expiresAt: 't4' },
141
+ ],
142
+ }));
143
+ });
144
+
145
+ const result = await runCli(['trust', 'list', '--port', String(stub.port)]);
146
+ expect(result.code).toBe(0);
147
+ expect(result.stdout).toContain('12D3KooWAlice');
148
+ expect(result.stdout).toContain('Alice');
149
+ expect(result.stdout).toContain('[self]');
150
+ expect(result.stdout).toContain('tok1');
151
+ expect(result.stdout).toContain('Mom');
152
+ });
153
+ });
154
+
155
+ describe('cadre-host trust revoke CLI', () => {
156
+ it('DELETEs /auth/invites/<token> by default', async () => {
157
+ stub.setResponse((_req, res) => {
158
+ res.statusCode = 204;
159
+ res.end();
160
+ });
161
+ const result = await runCli(['trust', 'revoke', 'some-token', '--port', String(stub.port)]);
162
+ expect(result.code).toBe(0);
163
+ expect(stub.requests[0]!.method).toBe('DELETE');
164
+ expect(stub.requests[0]!.url).toBe('/auth/invites/some-token');
165
+ });
166
+
167
+ it('DELETEs /auth/members/<peerId> when id looks like a peerId', async () => {
168
+ stub.setResponse((_req, res) => {
169
+ res.statusCode = 204;
170
+ res.end();
171
+ });
172
+ const result = await runCli(['trust', 'revoke', '12D3KooWAlice', '--port', String(stub.port)]);
173
+ expect(result.code).toBe(0);
174
+ expect(stub.requests[0]!.url).toBe('/auth/members/12D3KooWAlice');
175
+ });
176
+
177
+ it('treats secp256k1 peer IDs (16Uiu2HAm…) as members', async () => {
178
+ stub.setResponse((_req, res) => {
179
+ res.statusCode = 204;
180
+ res.end();
181
+ });
182
+ const result = await runCli(['trust', 'revoke', '16Uiu2HAmExample', '--port', String(stub.port)]);
183
+ expect(result.code).toBe(0);
184
+ expect(stub.requests[0]!.url).toBe('/auth/members/16Uiu2HAmExample');
185
+ });
186
+
187
+ it('rejects invalid --port', async () => {
188
+ const result = await runCli(['trust', 'revoke', 'some-token', '--port', 'garbage']);
189
+ expect(result.code).toBe(1);
190
+ expect(result.stderr).toMatch(/Invalid --port/);
191
+ });
192
+ });