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