@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.
- package/README.md +406 -296
- package/dist/bin/host.d.ts +11 -7
- package/dist/bin/host.js +40 -12
- package/dist/bin/host.js.map +1 -1
- package/dist/installer/config.d.ts +4 -4
- package/dist/installer/config.js +5 -39
- package/dist/installer/config.js.map +1 -1
- package/dist/installer/identity.d.ts +8 -1
- package/dist/installer/identity.js +8 -1
- package/dist/installer/identity.js.map +1 -1
- package/dist/orchestrator/host-process-orchestrator.d.ts +2 -2
- package/dist/orchestrator/host-process-orchestrator.js +9 -4
- package/dist/orchestrator/host-process-orchestrator.js.map +1 -1
- package/dist/server/settings-store.d.ts +1 -1
- package/dist/server/settings-store.js +5 -1
- package/dist/server/settings-store.js.map +1 -1
- package/dist/server/static.js +38 -38
- package/dist/ui/assets/index-C-iks41M.js.map +1 -1
- package/dist/ui/index.html +12 -12
- package/package.json +4 -4
- package/service/cadre-host.service.tmpl +16 -16
- package/service/com.serfab.cadre-host.plist.tmpl +35 -35
- package/service/install-service.ps1 +98 -98
- package/service/uninstall-service.ps1 +19 -19
- package/src/__tests__/build-targets.test.ts +26 -26
- package/src/__tests__/cli-invite.smoke.test.ts +192 -192
- package/src/__tests__/cli-nat.smoke.test.ts +212 -212
- package/src/__tests__/cli.smoke.test.ts +51 -46
- package/src/__tests__/global-setup.ts +56 -51
- package/src/__tests__/host-owner.smoke.test.ts +123 -123
- package/src/__tests__/orchestrator-env-scrub.test.ts +140 -140
- package/src/__tests__/orchestrator-node-identity.test.ts +5 -5
- package/src/__tests__/orchestrator-owner.test.ts +198 -198
- package/src/__tests__/orchestrator-pin-keys.test.ts +153 -153
- package/src/__tests__/orchestrator-push.test.ts +145 -145
- package/src/__tests__/orchestrator.test.ts +951 -951
- package/src/auth/__tests__/duration.test.ts +28 -28
- package/src/auth/__tests__/self-label.test.ts +85 -85
- package/src/auth/__tests__/trust-circle-store.test.ts +115 -115
- package/src/auth/__tests__/trust-circle.test.ts +445 -445
- package/src/auth/duration.ts +33 -33
- package/src/auth/index.ts +21 -21
- package/src/auth/self-label.ts +74 -74
- package/src/auth/trust-circle-store.ts +155 -155
- package/src/auth/types.ts +99 -99
- package/src/bin/__tests__/cli-reference.test.ts +167 -0
- package/src/bin/host.ts +1326 -1299
- package/src/donation/__tests__/donation-service.test.ts +1068 -1068
- package/src/donation/__tests__/donation-supervisor.test.ts +510 -510
- package/src/donation/__tests__/fake-orchestrator.test.ts +168 -168
- package/src/donation/__tests__/fake-orchestrator.ts +225 -225
- package/src/donation/__tests__/grant-service.test.ts +213 -213
- package/src/donation/__tests__/grant-store.test.ts +113 -113
- package/src/donation/donation-service.ts +962 -962
- package/src/donation/donation-store.ts +171 -171
- package/src/donation/donation-supervisor.ts +388 -388
- package/src/donation/grant-service.ts +200 -200
- package/src/donation/grant-store.ts +152 -152
- package/src/donation/index.ts +64 -64
- package/src/donation/types.ts +243 -243
- package/src/installer/__tests__/config.test.ts +134 -112
- package/src/installer/__tests__/identity.test.ts +34 -34
- package/src/installer/__tests__/paths.test.ts +47 -47
- package/src/installer/__tests__/service-host.test.ts +62 -62
- package/src/installer/__tests__/wizard.test.ts +64 -64
- package/src/installer/config.ts +5 -43
- package/src/installer/identity.ts +56 -49
- package/src/installer/paths.ts +109 -109
- package/src/installer/platform.ts +27 -27
- package/src/installer/service-host/index.ts +21 -21
- package/src/installer/service-host/template.ts +21 -21
- package/src/installer/wizard.ts +103 -103
- package/src/nat/__tests__/address-resolver.test.ts +82 -82
- package/src/nat/__tests__/ddns-duckdns.test.ts +83 -83
- package/src/nat/__tests__/ddns-updater.test.ts +253 -253
- package/src/nat/__tests__/external-ip.test.ts +124 -124
- package/src/nat/__tests__/nat-service.test.ts +18 -0
- package/src/nat/__tests__/nat-store.test.ts +93 -93
- package/src/nat/__tests__/port-mapper.test.ts +191 -191
- package/src/nat/__tests__/reachability.test.ts +24 -24
- package/src/nat/__tests__/secrets.test.ts +178 -178
- package/src/nat/address-resolver.ts +51 -51
- package/src/nat/ddns/duckdns.ts +76 -76
- package/src/nat/ddns/index.ts +55 -55
- package/src/nat/ddns/updater.ts +243 -243
- package/src/nat/external-ip.ts +154 -154
- package/src/nat/index.ts +71 -71
- package/src/nat/nat-service.ts +501 -501
- package/src/nat/nat-store.ts +154 -154
- package/src/nat/port-mapper.ts +329 -329
- package/src/nat/reachability.ts +34 -34
- package/src/nat/secrets/file-store.ts +130 -130
- package/src/nat/secrets/index.ts +112 -112
- package/src/nat/secrets/keytar-store.ts +67 -67
- package/src/nat/types.ts +159 -159
- package/src/orchestrator/__tests__/node-identity.test.ts +62 -62
- package/src/orchestrator/host-process-orchestrator.ts +9 -4
- package/src/orchestrator/index.ts +10 -10
- package/src/orchestrator/log-rotator.ts +53 -53
- package/src/orchestrator/node-identity.ts +40 -40
- package/src/orchestrator/pid-liveness.ts +24 -24
- package/src/orchestrator/port-allocator.ts +91 -91
- package/src/orchestrator/state-store.ts +90 -90
- package/src/orchestrator/types.ts +141 -141
- package/src/owner/__tests__/owner-node-client.test.ts +194 -194
- package/src/owner/index.ts +12 -12
- package/src/owner/owner-node-client.ts +259 -259
- package/src/push/__tests__/push.test.ts +90 -90
- package/src/push/index.ts +146 -146
- package/src/server/__tests__/bus.test.ts +38 -38
- package/src/server/__tests__/error-handler.test.ts +118 -118
- package/src/server/__tests__/grants-admin-route.test.ts +73 -73
- package/src/server/__tests__/grants-route.test.ts +263 -263
- package/src/server/__tests__/nodes-route.test.ts +259 -259
- package/src/server/__tests__/origin-guard.test.ts +72 -72
- package/src/server/__tests__/publishers.test.ts +216 -216
- package/src/server/__tests__/server.smoke.test.ts +253 -253
- package/src/server/__tests__/settings-route.test.ts +195 -194
- package/src/server/__tests__/sse-route.test.ts +119 -119
- package/src/server/__tests__/static.test.ts +145 -145
- package/src/server/__tests__/status-route.test.ts +134 -134
- package/src/server/__tests__/strands-route.test.ts +233 -233
- package/src/server/error-handler.ts +178 -178
- package/src/server/events/bus.ts +42 -42
- package/src/server/events/sse-route.ts +81 -81
- package/src/server/events/types.ts +23 -23
- package/src/server/index.ts +267 -267
- package/src/server/origin-guard.ts +84 -84
- package/src/server/routes/grants-admin.ts +41 -41
- package/src/server/routes/grants.ts +210 -210
- package/src/server/routes/nat.ts +63 -63
- package/src/server/routes/nodes.ts +170 -170
- package/src/server/routes/settings.ts +123 -123
- package/src/server/routes/status.ts +118 -118
- package/src/server/routes/strands.ts +54 -54
- package/src/server/routes/trust-circle.ts +49 -49
- package/src/server/routes/update.ts +43 -43
- package/src/server/server.ts +122 -122
- package/src/server/settings-store.ts +5 -1
- package/src/server/static.ts +207 -207
- package/src/strands/__tests__/strand-service.test.ts +165 -165
- package/src/strands/index.ts +14 -14
- package/src/strands/strand-service.ts +135 -135
- package/src/strands/types.ts +102 -102
- package/src/update/__tests__/apply.test.ts +158 -158
- package/src/update/__tests__/manifest.test.ts +128 -128
- package/src/update/__tests__/release-key.test.ts +42 -42
- package/src/update/__tests__/sign.test.ts +78 -78
- package/src/update/__tests__/store.test.ts +81 -81
- package/src/update/__tests__/update-service.integration.test.ts +256 -256
- package/src/update/__tests__/version.test.ts +31 -31
- package/src/update/apply.ts +190 -190
- package/src/update/index.ts +341 -341
- package/src/update/release-key.ts +71 -71
- package/src/update/sign.ts +74 -74
- package/src/update/store.ts +101 -101
- package/src/update/types.ts +109 -109
- 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
|
+
});
|