@serfab/cadre-host 0.10.0 → 0.12.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 (158) hide show
  1. package/README.md +406 -296
  2. package/dist/bin/host.d.ts +11 -7
  3. package/dist/bin/host.js +40 -12
  4. package/dist/bin/host.js.map +1 -1
  5. package/dist/installer/config.d.ts +4 -4
  6. package/dist/installer/config.js +5 -39
  7. package/dist/installer/config.js.map +1 -1
  8. package/dist/installer/identity.d.ts +8 -1
  9. package/dist/installer/identity.js +8 -1
  10. package/dist/installer/identity.js.map +1 -1
  11. package/dist/orchestrator/host-process-orchestrator.d.ts +2 -2
  12. package/dist/orchestrator/host-process-orchestrator.js +9 -4
  13. package/dist/orchestrator/host-process-orchestrator.js.map +1 -1
  14. package/dist/server/settings-store.d.ts +1 -1
  15. package/dist/server/settings-store.js +5 -1
  16. package/dist/server/settings-store.js.map +1 -1
  17. package/dist/server/static.js +38 -38
  18. package/dist/ui/assets/index-C-iks41M.js.map +1 -1
  19. package/dist/ui/index.html +12 -12
  20. package/package.json +4 -4
  21. package/service/cadre-host.service.tmpl +16 -16
  22. package/service/com.serfab.cadre-host.plist.tmpl +35 -35
  23. package/service/install-service.ps1 +98 -98
  24. package/service/uninstall-service.ps1 +19 -19
  25. package/src/__tests__/build-targets.test.ts +26 -26
  26. package/src/__tests__/cli-invite.smoke.test.ts +192 -192
  27. package/src/__tests__/cli-nat.smoke.test.ts +212 -212
  28. package/src/__tests__/cli.smoke.test.ts +51 -46
  29. package/src/__tests__/global-setup.ts +56 -51
  30. package/src/__tests__/host-owner.smoke.test.ts +123 -123
  31. package/src/__tests__/orchestrator-env-scrub.test.ts +140 -140
  32. package/src/__tests__/orchestrator-node-identity.test.ts +5 -5
  33. package/src/__tests__/orchestrator-owner.test.ts +198 -198
  34. package/src/__tests__/orchestrator-pin-keys.test.ts +153 -153
  35. package/src/__tests__/orchestrator-push.test.ts +145 -145
  36. package/src/__tests__/orchestrator.test.ts +951 -951
  37. package/src/auth/__tests__/duration.test.ts +28 -28
  38. package/src/auth/__tests__/self-label.test.ts +85 -85
  39. package/src/auth/__tests__/trust-circle-store.test.ts +115 -115
  40. package/src/auth/__tests__/trust-circle.test.ts +445 -445
  41. package/src/auth/duration.ts +33 -33
  42. package/src/auth/index.ts +21 -21
  43. package/src/auth/self-label.ts +74 -74
  44. package/src/auth/trust-circle-store.ts +155 -155
  45. package/src/auth/types.ts +99 -99
  46. package/src/bin/__tests__/cli-reference.test.ts +167 -0
  47. package/src/bin/host.ts +1326 -1299
  48. package/src/donation/__tests__/donation-service.test.ts +1068 -1068
  49. package/src/donation/__tests__/donation-supervisor.test.ts +510 -510
  50. package/src/donation/__tests__/fake-orchestrator.test.ts +168 -168
  51. package/src/donation/__tests__/fake-orchestrator.ts +225 -225
  52. package/src/donation/__tests__/grant-service.test.ts +213 -213
  53. package/src/donation/__tests__/grant-store.test.ts +113 -113
  54. package/src/donation/donation-service.ts +962 -962
  55. package/src/donation/donation-store.ts +171 -171
  56. package/src/donation/donation-supervisor.ts +388 -388
  57. package/src/donation/grant-service.ts +200 -200
  58. package/src/donation/grant-store.ts +152 -152
  59. package/src/donation/index.ts +64 -64
  60. package/src/donation/types.ts +243 -243
  61. package/src/installer/__tests__/config.test.ts +134 -112
  62. package/src/installer/__tests__/identity.test.ts +34 -34
  63. package/src/installer/__tests__/paths.test.ts +47 -47
  64. package/src/installer/__tests__/service-host.test.ts +62 -62
  65. package/src/installer/__tests__/wizard.test.ts +64 -64
  66. package/src/installer/config.ts +5 -43
  67. package/src/installer/identity.ts +56 -49
  68. package/src/installer/paths.ts +109 -109
  69. package/src/installer/platform.ts +27 -27
  70. package/src/installer/service-host/index.ts +21 -21
  71. package/src/installer/service-host/template.ts +21 -21
  72. package/src/installer/wizard.ts +103 -103
  73. package/src/nat/__tests__/address-resolver.test.ts +82 -82
  74. package/src/nat/__tests__/ddns-duckdns.test.ts +83 -83
  75. package/src/nat/__tests__/ddns-updater.test.ts +253 -253
  76. package/src/nat/__tests__/external-ip.test.ts +124 -124
  77. package/src/nat/__tests__/nat-service.test.ts +18 -0
  78. package/src/nat/__tests__/nat-store.test.ts +93 -93
  79. package/src/nat/__tests__/port-mapper.test.ts +191 -191
  80. package/src/nat/__tests__/reachability.test.ts +24 -24
  81. package/src/nat/__tests__/secrets.test.ts +178 -178
  82. package/src/nat/address-resolver.ts +51 -51
  83. package/src/nat/ddns/duckdns.ts +76 -76
  84. package/src/nat/ddns/index.ts +55 -55
  85. package/src/nat/ddns/updater.ts +243 -243
  86. package/src/nat/external-ip.ts +154 -154
  87. package/src/nat/index.ts +71 -71
  88. package/src/nat/nat-service.ts +501 -501
  89. package/src/nat/nat-store.ts +154 -154
  90. package/src/nat/port-mapper.ts +329 -329
  91. package/src/nat/reachability.ts +34 -34
  92. package/src/nat/secrets/file-store.ts +130 -130
  93. package/src/nat/secrets/index.ts +112 -112
  94. package/src/nat/secrets/keytar-store.ts +67 -67
  95. package/src/nat/types.ts +159 -159
  96. package/src/orchestrator/__tests__/node-identity.test.ts +62 -62
  97. package/src/orchestrator/host-process-orchestrator.ts +9 -4
  98. package/src/orchestrator/index.ts +10 -10
  99. package/src/orchestrator/log-rotator.ts +53 -53
  100. package/src/orchestrator/node-identity.ts +40 -40
  101. package/src/orchestrator/pid-liveness.ts +24 -24
  102. package/src/orchestrator/port-allocator.ts +91 -91
  103. package/src/orchestrator/state-store.ts +90 -90
  104. package/src/orchestrator/types.ts +141 -141
  105. package/src/owner/__tests__/owner-node-client.test.ts +194 -194
  106. package/src/owner/index.ts +12 -12
  107. package/src/owner/owner-node-client.ts +259 -259
  108. package/src/push/__tests__/push.test.ts +90 -90
  109. package/src/push/index.ts +146 -146
  110. package/src/server/__tests__/bus.test.ts +38 -38
  111. package/src/server/__tests__/error-handler.test.ts +118 -118
  112. package/src/server/__tests__/grants-admin-route.test.ts +73 -73
  113. package/src/server/__tests__/grants-route.test.ts +263 -263
  114. package/src/server/__tests__/nodes-route.test.ts +259 -259
  115. package/src/server/__tests__/origin-guard.test.ts +72 -72
  116. package/src/server/__tests__/publishers.test.ts +216 -216
  117. package/src/server/__tests__/server.smoke.test.ts +253 -253
  118. package/src/server/__tests__/settings-route.test.ts +195 -194
  119. package/src/server/__tests__/sse-route.test.ts +119 -119
  120. package/src/server/__tests__/static.test.ts +145 -145
  121. package/src/server/__tests__/status-route.test.ts +134 -134
  122. package/src/server/__tests__/strands-route.test.ts +233 -233
  123. package/src/server/error-handler.ts +178 -178
  124. package/src/server/events/bus.ts +42 -42
  125. package/src/server/events/sse-route.ts +81 -81
  126. package/src/server/events/types.ts +23 -23
  127. package/src/server/index.ts +267 -267
  128. package/src/server/origin-guard.ts +84 -84
  129. package/src/server/routes/grants-admin.ts +41 -41
  130. package/src/server/routes/grants.ts +210 -210
  131. package/src/server/routes/nat.ts +63 -63
  132. package/src/server/routes/nodes.ts +170 -170
  133. package/src/server/routes/settings.ts +123 -123
  134. package/src/server/routes/status.ts +118 -118
  135. package/src/server/routes/strands.ts +54 -54
  136. package/src/server/routes/trust-circle.ts +49 -49
  137. package/src/server/routes/update.ts +43 -43
  138. package/src/server/server.ts +122 -122
  139. package/src/server/settings-store.ts +5 -1
  140. package/src/server/static.ts +207 -207
  141. package/src/strands/__tests__/strand-service.test.ts +165 -165
  142. package/src/strands/index.ts +14 -14
  143. package/src/strands/strand-service.ts +135 -135
  144. package/src/strands/types.ts +102 -102
  145. package/src/update/__tests__/apply.test.ts +158 -158
  146. package/src/update/__tests__/manifest.test.ts +128 -128
  147. package/src/update/__tests__/release-key.test.ts +42 -42
  148. package/src/update/__tests__/sign.test.ts +78 -78
  149. package/src/update/__tests__/store.test.ts +81 -81
  150. package/src/update/__tests__/update-service.integration.test.ts +256 -256
  151. package/src/update/__tests__/version.test.ts +31 -31
  152. package/src/update/apply.ts +190 -190
  153. package/src/update/index.ts +341 -341
  154. package/src/update/release-key.ts +71 -71
  155. package/src/update/sign.ts +74 -74
  156. package/src/update/store.ts +101 -101
  157. package/src/update/types.ts +109 -109
  158. package/src/update/version.ts +80 -80
@@ -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
+ });