@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,153 +1,153 @@
1
- /**
2
- * HostProcessOrchestrator pinned-owner-key tests — the load-bearing wiring for
3
- * the node-donation flow.
4
- *
5
- * A donated node joins a FOREIGN cadre and must accept a requester-signed seed,
6
- * so the orchestrator threads `request.pinnedOwnerKeys` into the child as the
7
- * comma-separated `CADRE_OWNER_KEYS` env var (which `cadre-cli start` turns into
8
- * a cold-start pinned-key trust policy). The same signal marks the node as
9
- * foreign-party, which suppresses the host's own push credentials (meaningless
10
- * to another cadre's app).
11
- *
12
- * A fake CLI records `CADRE_OWNER_KEYS` from its environment to a file so the
13
- * env threading is observable without a real cadre node.
14
- */
15
-
16
- import { afterEach, beforeEach, describe, expect, it } from 'vitest';
17
- import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
18
- import { tmpdir } from 'node:os';
19
- import { join } from 'node:path';
20
-
21
- import type { PushCredentials } from '@serfab/cadre-core';
22
- import { HostProcessOrchestrator } from '../orchestrator/host-process-orchestrator.js';
23
-
24
- // Writes CADRE_OWNER_KEYS (as seen in the child env) next to the startup token,
25
- // then behaves like a minimal long-lived node.
26
- const FAKE_CLI = `
27
- import fs from 'node:fs';
28
- import path from 'node:path';
29
- const args = process.argv.slice(2);
30
- const get = (flag) => { const i = args.indexOf(flag); return i >= 0 ? args[i + 1] : undefined; };
31
- const tokenPath = get('--startup-token-file');
32
- const token = process.env.CADRE_STARTUP_TOKEN ?? '';
33
- if (tokenPath) {
34
- const dir = path.dirname(tokenPath);
35
- try { fs.writeFileSync(path.join(dir, 'owner-keys.txt'), process.env.CADRE_OWNER_KEYS ?? '', 'utf8'); } catch (e) { console.error(e); }
36
- if (token) { try { fs.writeFileSync(tokenPath, token, 'utf8'); } catch (e) { console.error(e); } }
37
- }
38
- process.on('SIGTERM', () => process.exit(0));
39
- setInterval(() => {}, 1 << 30);
40
- `;
41
-
42
- const FCM = { projectId: 'proj', clientEmail: 'svc@proj.iam', privateKey: 'FCM-SECRET-PEM' };
43
-
44
- let tmpRoot: string;
45
- let scriptPath: string;
46
- const orchestrators: HostProcessOrchestrator[] = [];
47
-
48
- beforeEach(() => {
49
- tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-pin-'));
50
- scriptPath = join(tmpRoot, 'fake-cli.mjs');
51
- writeFileSync(scriptPath, FAKE_CLI, 'utf8');
52
- });
53
-
54
- afterEach(async () => {
55
- for (const orch of orchestrators) {
56
- for (const n of orch.listNodes()) {
57
- try { await orch.removeContainer(n.dockerId); } catch { /* ignore */ }
58
- }
59
- }
60
- orchestrators.length = 0;
61
- await sleep(50);
62
- try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
63
- });
64
-
65
- function makeOrchestrator(rootDir: string, pushResolver?: () => Promise<PushCredentials | undefined>): HostProcessOrchestrator {
66
- mkdirSync(rootDir, { recursive: true });
67
- const orch = new HostProcessOrchestrator({
68
- rootDir,
69
- portRange: { start: 18500, end: 18999 },
70
- stopTimeoutMs: 1500,
71
- spawn: { entrypoint: scriptPath },
72
- ...(pushResolver ? { pushResolver } : {}),
73
- });
74
- orchestrators.push(orch);
75
- return orch;
76
- }
77
-
78
- function readChildConfig(rootDir: string, containerId: string): Record<string, unknown> {
79
- return JSON.parse(readFileSync(join(rootDir, containerId, 'cadre.json'), 'utf8')) as Record<string, unknown>;
80
- }
81
-
82
- async function waitForFile(path: string, timeoutMs = 5000): Promise<string> {
83
- const deadline = Date.now() + timeoutMs;
84
- while (Date.now() < deadline) {
85
- if (existsSync(path)) return readFileSync(path, 'utf8');
86
- await sleep(50);
87
- }
88
- throw new Error(`file never appeared: ${path}`);
89
- }
90
-
91
- function sleep(ms: number): Promise<void> {
92
- return new Promise((res) => setTimeout(res, ms));
93
- }
94
-
95
- describe('HostProcessOrchestrator pinned owner keys', () => {
96
- it('threads pinnedOwnerKeys into the child as comma-separated CADRE_OWNER_KEYS', async () => {
97
- const rootDir = join(tmpRoot, 'a');
98
- const orch = makeOrchestrator(rootDir);
99
- await orch.init();
100
-
101
- await orch.createContainer({
102
- containerId: 'donated-1',
103
- partyId: 'foreign-P',
104
- bootstrapNodes: [],
105
- profile: 'storage',
106
- pinnedOwnerKeys: ['key-a', 'key-b'],
107
- });
108
-
109
- const keys = await waitForFile(join(rootDir, 'donated-1', 'owner-keys.txt'));
110
- expect(keys).toBe('key-a,key-b');
111
- });
112
-
113
- it('suppresses host push for a foreign-party (pinned-key) node even on storage profile', async () => {
114
- const rootDir = join(tmpRoot, 'b');
115
- const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM }));
116
- await orch.init();
117
-
118
- // Foreign-party donated node: pinned keys present → no host push injected.
119
- await orch.createContainer({
120
- containerId: 'donated-2',
121
- partyId: 'foreign-P',
122
- bootstrapNodes: [],
123
- profile: 'storage',
124
- pinnedOwnerKeys: ['key-a'],
125
- });
126
- expect(readChildConfig(rootDir, 'donated-2').push).toBeUndefined();
127
-
128
- // Control: a host-own storage node (no pinned keys) DOES get push.
129
- await orch.createContainer({
130
- containerId: 'own-1',
131
- partyId: 'host-P',
132
- bootstrapNodes: [],
133
- profile: 'storage',
134
- });
135
- expect(readChildConfig(rootDir, 'own-1').push).toEqual({ fcm: FCM });
136
- });
137
-
138
- it('omits CADRE_OWNER_KEYS when no pinned keys are supplied', async () => {
139
- const rootDir = join(tmpRoot, 'c');
140
- const orch = makeOrchestrator(rootDir);
141
- await orch.init();
142
-
143
- await orch.createContainer({
144
- containerId: 'own-2',
145
- partyId: 'host-P',
146
- bootstrapNodes: [],
147
- profile: 'storage',
148
- });
149
-
150
- const keys = await waitForFile(join(rootDir, 'own-2', 'owner-keys.txt'));
151
- expect(keys).toBe(''); // env var absent → child reads empty string
152
- });
153
- });
1
+ /**
2
+ * HostProcessOrchestrator pinned-owner-key tests — the load-bearing wiring for
3
+ * the node-donation flow.
4
+ *
5
+ * A donated node joins a FOREIGN cadre and must accept a requester-signed seed,
6
+ * so the orchestrator threads `request.pinnedOwnerKeys` into the child as the
7
+ * comma-separated `CADRE_OWNER_KEYS` env var (which `cadre-cli start` turns into
8
+ * a cold-start pinned-key trust policy). The same signal marks the node as
9
+ * foreign-party, which suppresses the host's own push credentials (meaningless
10
+ * to another cadre's app).
11
+ *
12
+ * A fake CLI records `CADRE_OWNER_KEYS` from its environment to a file so the
13
+ * env threading is observable without a real cadre node.
14
+ */
15
+
16
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
17
+ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
18
+ import { tmpdir } from 'node:os';
19
+ import { join } from 'node:path';
20
+
21
+ import type { PushCredentials } from '@serfab/cadre-core';
22
+ import { HostProcessOrchestrator } from '../orchestrator/host-process-orchestrator.js';
23
+
24
+ // Writes CADRE_OWNER_KEYS (as seen in the child env) next to the startup token,
25
+ // then behaves like a minimal long-lived node.
26
+ const FAKE_CLI = `
27
+ import fs from 'node:fs';
28
+ import path from 'node:path';
29
+ const args = process.argv.slice(2);
30
+ const get = (flag) => { const i = args.indexOf(flag); return i >= 0 ? args[i + 1] : undefined; };
31
+ const tokenPath = get('--startup-token-file');
32
+ const token = process.env.CADRE_STARTUP_TOKEN ?? '';
33
+ if (tokenPath) {
34
+ const dir = path.dirname(tokenPath);
35
+ try { fs.writeFileSync(path.join(dir, 'owner-keys.txt'), process.env.CADRE_OWNER_KEYS ?? '', 'utf8'); } catch (e) { console.error(e); }
36
+ if (token) { try { fs.writeFileSync(tokenPath, token, 'utf8'); } catch (e) { console.error(e); } }
37
+ }
38
+ process.on('SIGTERM', () => process.exit(0));
39
+ setInterval(() => {}, 1 << 30);
40
+ `;
41
+
42
+ const FCM = { projectId: 'proj', clientEmail: 'svc@proj.iam', privateKey: 'FCM-SECRET-PEM' };
43
+
44
+ let tmpRoot: string;
45
+ let scriptPath: string;
46
+ const orchestrators: HostProcessOrchestrator[] = [];
47
+
48
+ beforeEach(() => {
49
+ tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-pin-'));
50
+ scriptPath = join(tmpRoot, 'fake-cli.mjs');
51
+ writeFileSync(scriptPath, FAKE_CLI, 'utf8');
52
+ });
53
+
54
+ afterEach(async () => {
55
+ for (const orch of orchestrators) {
56
+ for (const n of orch.listNodes()) {
57
+ try { await orch.removeContainer(n.dockerId); } catch { /* ignore */ }
58
+ }
59
+ }
60
+ orchestrators.length = 0;
61
+ await sleep(50);
62
+ try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
63
+ });
64
+
65
+ function makeOrchestrator(rootDir: string, pushResolver?: () => Promise<PushCredentials | undefined>): HostProcessOrchestrator {
66
+ mkdirSync(rootDir, { recursive: true });
67
+ const orch = new HostProcessOrchestrator({
68
+ rootDir,
69
+ portRange: { start: 18500, end: 18999 },
70
+ stopTimeoutMs: 1500,
71
+ spawn: { entrypoint: scriptPath },
72
+ ...(pushResolver ? { pushResolver } : {}),
73
+ });
74
+ orchestrators.push(orch);
75
+ return orch;
76
+ }
77
+
78
+ function readChildConfig(rootDir: string, containerId: string): Record<string, unknown> {
79
+ return JSON.parse(readFileSync(join(rootDir, containerId, 'cadre.json'), 'utf8')) as Record<string, unknown>;
80
+ }
81
+
82
+ async function waitForFile(path: string, timeoutMs = 5000): Promise<string> {
83
+ const deadline = Date.now() + timeoutMs;
84
+ while (Date.now() < deadline) {
85
+ if (existsSync(path)) return readFileSync(path, 'utf8');
86
+ await sleep(50);
87
+ }
88
+ throw new Error(`file never appeared: ${path}`);
89
+ }
90
+
91
+ function sleep(ms: number): Promise<void> {
92
+ return new Promise((res) => setTimeout(res, ms));
93
+ }
94
+
95
+ describe('HostProcessOrchestrator pinned owner keys', () => {
96
+ it('threads pinnedOwnerKeys into the child as comma-separated CADRE_OWNER_KEYS', async () => {
97
+ const rootDir = join(tmpRoot, 'a');
98
+ const orch = makeOrchestrator(rootDir);
99
+ await orch.init();
100
+
101
+ await orch.createContainer({
102
+ containerId: 'donated-1',
103
+ partyId: 'foreign-P',
104
+ bootstrapNodes: [],
105
+ profile: 'storage',
106
+ pinnedOwnerKeys: ['key-a', 'key-b'],
107
+ });
108
+
109
+ const keys = await waitForFile(join(rootDir, 'donated-1', 'owner-keys.txt'));
110
+ expect(keys).toBe('key-a,key-b');
111
+ });
112
+
113
+ it('suppresses host push for a foreign-party (pinned-key) node even on storage profile', async () => {
114
+ const rootDir = join(tmpRoot, 'b');
115
+ const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM }));
116
+ await orch.init();
117
+
118
+ // Foreign-party donated node: pinned keys present → no host push injected.
119
+ await orch.createContainer({
120
+ containerId: 'donated-2',
121
+ partyId: 'foreign-P',
122
+ bootstrapNodes: [],
123
+ profile: 'storage',
124
+ pinnedOwnerKeys: ['key-a'],
125
+ });
126
+ expect(readChildConfig(rootDir, 'donated-2').push).toBeUndefined();
127
+
128
+ // Control: a host-own storage node (no pinned keys) DOES get push.
129
+ await orch.createContainer({
130
+ containerId: 'own-1',
131
+ partyId: 'host-P',
132
+ bootstrapNodes: [],
133
+ profile: 'storage',
134
+ });
135
+ expect(readChildConfig(rootDir, 'own-1').push).toEqual({ fcm: FCM });
136
+ });
137
+
138
+ it('omits CADRE_OWNER_KEYS when no pinned keys are supplied', async () => {
139
+ const rootDir = join(tmpRoot, 'c');
140
+ const orch = makeOrchestrator(rootDir);
141
+ await orch.init();
142
+
143
+ await orch.createContainer({
144
+ containerId: 'own-2',
145
+ partyId: 'host-P',
146
+ bootstrapNodes: [],
147
+ profile: 'storage',
148
+ });
149
+
150
+ const keys = await waitForFile(join(rootDir, 'own-2', 'owner-keys.txt'));
151
+ expect(keys).toBe(''); // env var absent → child reads empty string
152
+ });
153
+ });
@@ -1,145 +1,145 @@
1
- /**
2
- * HostProcessOrchestrator push-credential injection tests.
3
- *
4
- * Verifies the orchestrator writes `config.push` into the spawned node's
5
- * cadre.json when the pushResolver yields credentials, omits it otherwise,
6
- * re-resolves on every (re-)spawn, and never persists a raw private key in
7
- * state.json. Uses a fake CLI entrypoint that just writes its startup token.
8
- */
9
-
10
- import { afterEach, beforeEach, describe, expect, it } from 'vitest';
11
- import { mkdtempSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
12
- import { tmpdir } from 'node:os';
13
- import { join } from 'node:path';
14
-
15
- import type { PushCredentials } from '@serfab/cadre-core';
16
- import { HostProcessOrchestrator, OWNER_CONTAINER_ID } from '../orchestrator/host-process-orchestrator.js';
17
-
18
- const FAKE_CLI = `
19
- import fs from 'node:fs';
20
- const args = process.argv.slice(2);
21
- const get = (flag) => { const i = args.indexOf(flag); return i >= 0 ? args[i + 1] : undefined; };
22
- const tokenPath = get('--startup-token-file');
23
- const token = process.env.CADRE_STARTUP_TOKEN ?? '';
24
- if (tokenPath && token) { try { fs.writeFileSync(tokenPath, token, 'utf8'); } catch (e) { console.error(e); } }
25
- process.on('SIGTERM', () => process.exit(0));
26
- setInterval(() => {}, 1 << 30);
27
- `;
28
-
29
- const FCM = { projectId: 'proj', clientEmail: 'svc@proj.iam', privateKey: 'FCM-SECRET-PEM' };
30
- const APNS = { keyId: 'KID', teamId: 'TEAM', bundleId: 'com.example.app', privateKey: 'APNS-SECRET-P8', production: false };
31
- const CFG = { identityPath: 'C:/fake/identity.key', partyId: 'install-id-123', libp2pPort: 4655 };
32
-
33
- let tmpRoot: string;
34
- let scriptPath: string;
35
- const orchestrators: HostProcessOrchestrator[] = [];
36
-
37
- beforeEach(() => {
38
- tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-push-'));
39
- scriptPath = join(tmpRoot, 'fake-cli.mjs');
40
- writeFileSync(scriptPath, FAKE_CLI, 'utf8');
41
- });
42
-
43
- afterEach(async () => {
44
- for (const orch of orchestrators) {
45
- try { await orch.stopOwnerNode(); } catch { /* ignore */ }
46
- }
47
- orchestrators.length = 0;
48
- await sleep(50);
49
- try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
50
- });
51
-
52
- function makeOrchestrator(rootDir: string, pushResolver?: () => Promise<PushCredentials | undefined>): HostProcessOrchestrator {
53
- mkdirSync(rootDir, { recursive: true });
54
- const orch = new HostProcessOrchestrator({
55
- rootDir,
56
- portRange: { start: 18000, end: 18499 },
57
- stopTimeoutMs: 1500,
58
- spawn: { entrypoint: scriptPath },
59
- ...(pushResolver ? { pushResolver } : {}),
60
- });
61
- orchestrators.push(orch);
62
- return orch;
63
- }
64
-
65
- function readChildConfig(rootDir: string, containerId = OWNER_CONTAINER_ID): Record<string, unknown> {
66
- const raw = readFileSync(join(rootDir, containerId, 'cadre.json'), 'utf8');
67
- return JSON.parse(raw) as Record<string, unknown>;
68
- }
69
-
70
- function sleep(ms: number): Promise<void> {
71
- return new Promise((res) => setTimeout(res, ms));
72
- }
73
-
74
- describe('HostProcessOrchestrator push injection', () => {
75
- it('writes config.push into cadre.json when the resolver yields credentials', async () => {
76
- const rootDir = join(tmpRoot, 'a');
77
- const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM, apns: APNS, cooldownMs: 1000 }));
78
- await orch.init();
79
- await orch.ensureOwnerNode(CFG);
80
-
81
- const cfg = readChildConfig(rootDir);
82
- expect(cfg.push).toEqual({ fcm: FCM, apns: APNS, cooldownMs: 1000 });
83
- });
84
-
85
- it('omits config.push when no resolver is configured', async () => {
86
- const rootDir = join(tmpRoot, 'b');
87
- const orch = makeOrchestrator(rootDir);
88
- await orch.init();
89
- await orch.ensureOwnerNode(CFG);
90
-
91
- const cfg = readChildConfig(rootDir);
92
- expect(cfg.push).toBeUndefined();
93
- });
94
-
95
- it('omits config.push when the resolver returns undefined (push opt-in)', async () => {
96
- const rootDir = join(tmpRoot, 'c');
97
- const orch = makeOrchestrator(rootDir, async () => undefined);
98
- await orch.init();
99
- await orch.ensureOwnerNode(CFG);
100
-
101
- expect(readChildConfig(rootDir).push).toBeUndefined();
102
- });
103
-
104
- it('degrades to no push (does not fail the spawn) when the resolver throws', async () => {
105
- const rootDir = join(tmpRoot, 'd');
106
- const orch = makeOrchestrator(rootDir, async () => { throw new Error('partial creds'); });
107
- await orch.init();
108
- // Spawn still succeeds.
109
- const node = await orch.ensureOwnerNode(CFG);
110
- expect(node.id).toBe(OWNER_CONTAINER_ID);
111
- expect(readChildConfig(rootDir).push).toBeUndefined();
112
- });
113
-
114
- it('re-resolves on re-spawn and never persists a raw private key in state.json', async () => {
115
- const rootDir = join(tmpRoot, 'e');
116
- let current: PushCredentials | undefined = { fcm: FCM };
117
- const orch = makeOrchestrator(rootDir, async () => current);
118
- await orch.init();
119
- await orch.ensureOwnerNode(CFG);
120
- expect(readChildConfig(rootDir).push).toEqual({ fcm: FCM });
121
-
122
- // state.json must not carry the raw key — only re-resolvable references.
123
- const stateRaw = readFileSync(join(rootDir, 'state.json'), 'utf8');
124
- expect(stateRaw).not.toContain('FCM-SECRET-PEM');
125
-
126
- // Rotate the resolver's answer, then restart — the new spawn must pick it up.
127
- current = { apns: APNS };
128
- await orch.restartOwnerNode();
129
- const cfg2 = readChildConfig(rootDir);
130
- expect(cfg2.push).toEqual({ apns: APNS });
131
- expect((cfg2.push as PushCredentials).fcm).toBeUndefined();
132
- });
133
-
134
- it('injects push for a storage-profile managed node but not a transaction node', async () => {
135
- const rootDir = join(tmpRoot, 'f');
136
- const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM }));
137
- await orch.init();
138
-
139
- await orch.createContainer({ containerId: 'storage-1', partyId: 'p', bootstrapNodes: [], profile: 'storage' });
140
- expect(readChildConfig(rootDir, 'storage-1').push).toEqual({ fcm: FCM });
141
-
142
- await orch.createContainer({ containerId: 'txn-1', partyId: 'p', bootstrapNodes: [], profile: 'transaction' });
143
- expect(readChildConfig(rootDir, 'txn-1').push).toBeUndefined();
144
- });
145
- });
1
+ /**
2
+ * HostProcessOrchestrator push-credential injection tests.
3
+ *
4
+ * Verifies the orchestrator writes `config.push` into the spawned node's
5
+ * cadre.json when the pushResolver yields credentials, omits it otherwise,
6
+ * re-resolves on every (re-)spawn, and never persists a raw private key in
7
+ * state.json. Uses a fake CLI entrypoint that just writes its startup token.
8
+ */
9
+
10
+ import { afterEach, beforeEach, describe, expect, it } from 'vitest';
11
+ import { mkdtempSync, mkdirSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
12
+ import { tmpdir } from 'node:os';
13
+ import { join } from 'node:path';
14
+
15
+ import type { PushCredentials } from '@serfab/cadre-core';
16
+ import { HostProcessOrchestrator, OWNER_CONTAINER_ID } from '../orchestrator/host-process-orchestrator.js';
17
+
18
+ const FAKE_CLI = `
19
+ import fs from 'node:fs';
20
+ const args = process.argv.slice(2);
21
+ const get = (flag) => { const i = args.indexOf(flag); return i >= 0 ? args[i + 1] : undefined; };
22
+ const tokenPath = get('--startup-token-file');
23
+ const token = process.env.CADRE_STARTUP_TOKEN ?? '';
24
+ if (tokenPath && token) { try { fs.writeFileSync(tokenPath, token, 'utf8'); } catch (e) { console.error(e); } }
25
+ process.on('SIGTERM', () => process.exit(0));
26
+ setInterval(() => {}, 1 << 30);
27
+ `;
28
+
29
+ const FCM = { projectId: 'proj', clientEmail: 'svc@proj.iam', privateKey: 'FCM-SECRET-PEM' };
30
+ const APNS = { keyId: 'KID', teamId: 'TEAM', bundleId: 'com.example.app', privateKey: 'APNS-SECRET-P8', production: false };
31
+ const CFG = { identityPath: 'C:/fake/identity.key', partyId: 'install-id-123', libp2pPort: 4655 };
32
+
33
+ let tmpRoot: string;
34
+ let scriptPath: string;
35
+ const orchestrators: HostProcessOrchestrator[] = [];
36
+
37
+ beforeEach(() => {
38
+ tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-push-'));
39
+ scriptPath = join(tmpRoot, 'fake-cli.mjs');
40
+ writeFileSync(scriptPath, FAKE_CLI, 'utf8');
41
+ });
42
+
43
+ afterEach(async () => {
44
+ for (const orch of orchestrators) {
45
+ try { await orch.stopOwnerNode(); } catch { /* ignore */ }
46
+ }
47
+ orchestrators.length = 0;
48
+ await sleep(50);
49
+ try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
50
+ });
51
+
52
+ function makeOrchestrator(rootDir: string, pushResolver?: () => Promise<PushCredentials | undefined>): HostProcessOrchestrator {
53
+ mkdirSync(rootDir, { recursive: true });
54
+ const orch = new HostProcessOrchestrator({
55
+ rootDir,
56
+ portRange: { start: 18000, end: 18499 },
57
+ stopTimeoutMs: 1500,
58
+ spawn: { entrypoint: scriptPath },
59
+ ...(pushResolver ? { pushResolver } : {}),
60
+ });
61
+ orchestrators.push(orch);
62
+ return orch;
63
+ }
64
+
65
+ function readChildConfig(rootDir: string, containerId = OWNER_CONTAINER_ID): Record<string, unknown> {
66
+ const raw = readFileSync(join(rootDir, containerId, 'cadre.json'), 'utf8');
67
+ return JSON.parse(raw) as Record<string, unknown>;
68
+ }
69
+
70
+ function sleep(ms: number): Promise<void> {
71
+ return new Promise((res) => setTimeout(res, ms));
72
+ }
73
+
74
+ describe('HostProcessOrchestrator push injection', () => {
75
+ it('writes config.push into cadre.json when the resolver yields credentials', async () => {
76
+ const rootDir = join(tmpRoot, 'a');
77
+ const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM, apns: APNS, cooldownMs: 1000 }));
78
+ await orch.init();
79
+ await orch.ensureOwnerNode(CFG);
80
+
81
+ const cfg = readChildConfig(rootDir);
82
+ expect(cfg.push).toEqual({ fcm: FCM, apns: APNS, cooldownMs: 1000 });
83
+ });
84
+
85
+ it('omits config.push when no resolver is configured', async () => {
86
+ const rootDir = join(tmpRoot, 'b');
87
+ const orch = makeOrchestrator(rootDir);
88
+ await orch.init();
89
+ await orch.ensureOwnerNode(CFG);
90
+
91
+ const cfg = readChildConfig(rootDir);
92
+ expect(cfg.push).toBeUndefined();
93
+ });
94
+
95
+ it('omits config.push when the resolver returns undefined (push opt-in)', async () => {
96
+ const rootDir = join(tmpRoot, 'c');
97
+ const orch = makeOrchestrator(rootDir, async () => undefined);
98
+ await orch.init();
99
+ await orch.ensureOwnerNode(CFG);
100
+
101
+ expect(readChildConfig(rootDir).push).toBeUndefined();
102
+ });
103
+
104
+ it('degrades to no push (does not fail the spawn) when the resolver throws', async () => {
105
+ const rootDir = join(tmpRoot, 'd');
106
+ const orch = makeOrchestrator(rootDir, async () => { throw new Error('partial creds'); });
107
+ await orch.init();
108
+ // Spawn still succeeds.
109
+ const node = await orch.ensureOwnerNode(CFG);
110
+ expect(node.id).toBe(OWNER_CONTAINER_ID);
111
+ expect(readChildConfig(rootDir).push).toBeUndefined();
112
+ });
113
+
114
+ it('re-resolves on re-spawn and never persists a raw private key in state.json', async () => {
115
+ const rootDir = join(tmpRoot, 'e');
116
+ let current: PushCredentials | undefined = { fcm: FCM };
117
+ const orch = makeOrchestrator(rootDir, async () => current);
118
+ await orch.init();
119
+ await orch.ensureOwnerNode(CFG);
120
+ expect(readChildConfig(rootDir).push).toEqual({ fcm: FCM });
121
+
122
+ // state.json must not carry the raw key — only re-resolvable references.
123
+ const stateRaw = readFileSync(join(rootDir, 'state.json'), 'utf8');
124
+ expect(stateRaw).not.toContain('FCM-SECRET-PEM');
125
+
126
+ // Rotate the resolver's answer, then restart — the new spawn must pick it up.
127
+ current = { apns: APNS };
128
+ await orch.restartOwnerNode();
129
+ const cfg2 = readChildConfig(rootDir);
130
+ expect(cfg2.push).toEqual({ apns: APNS });
131
+ expect((cfg2.push as PushCredentials).fcm).toBeUndefined();
132
+ });
133
+
134
+ it('injects push for a storage-profile managed node but not a transaction node', async () => {
135
+ const rootDir = join(tmpRoot, 'f');
136
+ const orch = makeOrchestrator(rootDir, async () => ({ fcm: FCM }));
137
+ await orch.init();
138
+
139
+ await orch.createContainer({ containerId: 'storage-1', partyId: 'p', bootstrapNodes: [], profile: 'storage' });
140
+ expect(readChildConfig(rootDir, 'storage-1').push).toEqual({ fcm: FCM });
141
+
142
+ await orch.createContainer({ containerId: 'txn-1', partyId: 'p', bootstrapNodes: [], profile: 'transaction' });
143
+ expect(readChildConfig(rootDir, 'txn-1').push).toBeUndefined();
144
+ });
145
+ });