@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,263 +1,263 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Grantee-facing `/grants` route tests — the bearer-gated provisioning surface.
|
|
3
|
-
*
|
|
4
|
-
* Uses a fake orchestrator (no real children) so the focus is the HTTP contract:
|
|
5
|
-
* bearer auth, request validation, per-grant ownership isolation, the quota gate,
|
|
6
|
-
* and seedToken redaction. The live-node round-trips (peer/seed) are covered by
|
|
7
|
-
* the cross-package integration scenario.
|
|
8
|
-
*/
|
|
9
|
-
|
|
10
|
-
import Fastify from 'fastify';
|
|
11
|
-
import { afterEach, beforeEach, describe, expect, it } from 'vitest';
|
|
12
|
-
import { mkdtempSync, rmSync } from 'node:fs';
|
|
13
|
-
import { tmpdir } from 'node:os';
|
|
14
|
-
import { join } from 'node:path';
|
|
15
|
-
|
|
16
|
-
import type {
|
|
17
|
-
Orchestrator,
|
|
18
|
-
OrchestratorCreateRequest,
|
|
19
|
-
OrchestratorCreateResult,
|
|
20
|
-
OrchestratorStats,
|
|
21
|
-
} from '@serfab/cadre-provider';
|
|
22
|
-
|
|
23
|
-
import { registerErrorHandler } from '../error-handler.js';
|
|
24
|
-
import { registerGrantsRoutes } from '../routes/grants.js';
|
|
25
|
-
import { DonationService } from '../../donation/donation-service.js';
|
|
26
|
-
import { DonationStore } from '../../donation/donation-store.js';
|
|
27
|
-
import { GrantService } from '../../donation/grant-service.js';
|
|
28
|
-
import { GrantStore } from '../../donation/grant-store.js';
|
|
29
|
-
|
|
30
|
-
class FakeOrchestrator implements Orchestrator {
|
|
31
|
-
stopped: string[] = [];
|
|
32
|
-
removed: string[] = [];
|
|
33
|
-
private counter = 0;
|
|
34
|
-
async createContainer(_request: OrchestratorCreateRequest): Promise<OrchestratorCreateResult> {
|
|
35
|
-
const n = ++this.counter;
|
|
36
|
-
return {
|
|
37
|
-
dockerId: `dock_${n}`,
|
|
38
|
-
healthEndpoint: `http://127.0.0.1:${9000 + n}/health`,
|
|
39
|
-
metricsEndpoint: `http://127.0.0.1:${9000 + n}/metrics`,
|
|
40
|
-
seedEndpoint: `http://127.0.0.1:${9000 + n}/seed`,
|
|
41
|
-
seedToken: `seed-token-${n}`,
|
|
42
|
-
p2pPort: 4000 + n,
|
|
43
|
-
};
|
|
44
|
-
}
|
|
45
|
-
async stopContainer(id: string): Promise<void> { this.stopped.push(id); }
|
|
46
|
-
async removeContainer(id: string): Promise<void> { this.removed.push(id); }
|
|
47
|
-
async getStats(): Promise<OrchestratorStats> {
|
|
48
|
-
return { cpuPercent: 0, memoryBytes: 0, networkRxBytes: 0, networkTxBytes: 0 };
|
|
49
|
-
}
|
|
50
|
-
async isRunning(): Promise<boolean> { return true; }
|
|
51
|
-
async getLogs(): Promise<string> { return ''; }
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
let tmpRoot: string;
|
|
55
|
-
let app: ReturnType<typeof Fastify>;
|
|
56
|
-
let grants: GrantService;
|
|
57
|
-
let store: DonationStore;
|
|
58
|
-
let token: string;
|
|
59
|
-
const originalFetch = globalThis.fetch;
|
|
60
|
-
|
|
61
|
-
/**
|
|
62
|
-
* A well-formed 32-byte base64url owner key. `DonationService.provision`
|
|
63
|
-
* shape-checks the pins, so a placeholder string is a 400 rather than a fixture.
|
|
64
|
-
*/
|
|
65
|
-
const OWNER_KEY = Buffer.alloc(32, 7).toString('base64url');
|
|
66
|
-
|
|
67
|
-
const body = {
|
|
68
|
-
partyId: 'party-P',
|
|
69
|
-
bootstrapNodes: ['/ip4/127.0.0.1/tcp/4001/p2p/12D3KooReq'],
|
|
70
|
-
ownerKeys: [OWNER_KEY],
|
|
71
|
-
};
|
|
72
|
-
|
|
73
|
-
const bearer = (t: string) => ({ authorization: `Bearer ${t}` });
|
|
74
|
-
|
|
75
|
-
beforeEach(() => {
|
|
76
|
-
tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-grants-svc-route-'));
|
|
77
|
-
grants = new GrantService({ store: new GrantStore(join(tmpRoot, 'grants')) });
|
|
78
|
-
token = grants.issue({ label: 'Alice', maxNodes: 2 }).token;
|
|
79
|
-
store = new DonationStore(join(tmpRoot, 'donations'));
|
|
80
|
-
const donations = new DonationService({ orchestrator: new FakeOrchestrator(), grants, store });
|
|
81
|
-
app = Fastify();
|
|
82
|
-
registerErrorHandler(app);
|
|
83
|
-
registerGrantsRoutes(app, { donations, grants });
|
|
84
|
-
});
|
|
85
|
-
|
|
86
|
-
afterEach(async () => {
|
|
87
|
-
globalThis.fetch = originalFetch;
|
|
88
|
-
await app.close();
|
|
89
|
-
try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
|
|
90
|
-
});
|
|
91
|
-
|
|
92
|
-
describe('POST /grants', () => {
|
|
93
|
-
it('provisions a donated node → 201, awaiting_seed, seedToken redacted', async () => {
|
|
94
|
-
const res = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
95
|
-
expect(res.statusCode).toBe(201);
|
|
96
|
-
const donation = (res.json() as { data: { donation: Record<string, unknown> } }).data.donation;
|
|
97
|
-
expect(donation.status).toBe('awaiting_seed');
|
|
98
|
-
expect(donation.partyId).toBe('party-P');
|
|
99
|
-
expect(donation.seedToken).toBeUndefined();
|
|
100
|
-
expect(donation.seedEndpoint).toBeUndefined();
|
|
101
|
-
});
|
|
102
|
-
|
|
103
|
-
it('rejects a missing bearer → 401', async () => {
|
|
104
|
-
const res = await app.inject({ method: 'POST', url: '/grants', payload: body });
|
|
105
|
-
expect(res.statusCode).toBe(401);
|
|
106
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('unauthorized');
|
|
107
|
-
});
|
|
108
|
-
|
|
109
|
-
it('rejects an unknown bearer → 401', async () => {
|
|
110
|
-
const res = await app.inject({ method: 'POST', url: '/grants', headers: bearer('nope'), payload: body });
|
|
111
|
-
expect(res.statusCode).toBe(401);
|
|
112
|
-
});
|
|
113
|
-
|
|
114
|
-
it('rejects a missing partyId → 400 invalid_request', async () => {
|
|
115
|
-
const res = await app.inject({
|
|
116
|
-
method: 'POST', url: '/grants', headers: bearer(token),
|
|
117
|
-
payload: { bootstrapNodes: body.bootstrapNodes, ownerKeys: body.ownerKeys },
|
|
118
|
-
});
|
|
119
|
-
expect(res.statusCode).toBe(400);
|
|
120
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_request');
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
it('rejects empty ownerKeys → 400 invalid_request', async () => {
|
|
124
|
-
const res = await app.inject({
|
|
125
|
-
method: 'POST', url: '/grants', headers: bearer(token),
|
|
126
|
-
payload: { ...body, ownerKeys: [] },
|
|
127
|
-
});
|
|
128
|
-
expect(res.statusCode).toBe(400);
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
// A typo'd pin used to be answered 201 and only fail when the spawned child
|
|
132
|
-
// tried to decode it at boot — by which point the caller had no way to act on it.
|
|
133
|
-
it('rejects a malformed ownerKeys entry → 400 invalid_request, naming the bad key', async () => {
|
|
134
|
-
const res = await app.inject({
|
|
135
|
-
method: 'POST', url: '/grants', headers: bearer(token),
|
|
136
|
-
payload: { ...body, ownerKeys: [OWNER_KEY, 'this-is-not-a-key'] },
|
|
137
|
-
});
|
|
138
|
-
expect(res.statusCode).toBe(400);
|
|
139
|
-
const error = (res.json() as { error: { code: string; message: string } }).error;
|
|
140
|
-
expect(error.code).toBe('invalid_request');
|
|
141
|
-
expect(error.message).toContain('this-is-not-a-key');
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
// Element types are the route's job: the service's shape check assumes strings,
|
|
145
|
-
// so a number here would come back as an internal `.trim is not a function`.
|
|
146
|
-
it('rejects a non-string ownerKeys entry → 400 naming the field, not a decoder error', async () => {
|
|
147
|
-
const res = await app.inject({
|
|
148
|
-
method: 'POST', url: '/grants', headers: bearer(token),
|
|
149
|
-
payload: { ...body, ownerKeys: [42] },
|
|
150
|
-
});
|
|
151
|
-
expect(res.statusCode).toBe(400);
|
|
152
|
-
const error = (res.json() as { error: { code: string; message: string } }).error;
|
|
153
|
-
expect(error.code).toBe('invalid_request');
|
|
154
|
-
expect(error.message).toBe('ownerKeys must be an array of strings');
|
|
155
|
-
});
|
|
156
|
-
|
|
157
|
-
it('enforces the grant quota → 429 quota_exceeded once maxNodes is reached', async () => {
|
|
158
|
-
const g = grants.issue({ label: 'Bob', maxNodes: 1 }).token;
|
|
159
|
-
const first = await app.inject({ method: 'POST', url: '/grants', headers: bearer(g), payload: body });
|
|
160
|
-
expect(first.statusCode).toBe(201);
|
|
161
|
-
const second = await app.inject({ method: 'POST', url: '/grants', headers: bearer(g), payload: body });
|
|
162
|
-
expect(second.statusCode).toBe(429);
|
|
163
|
-
expect((second.json() as { error: { code: string } }).error.code).toBe('quota_exceeded');
|
|
164
|
-
});
|
|
165
|
-
});
|
|
166
|
-
|
|
167
|
-
describe('GET /grants auth', () => {
|
|
168
|
-
it('rejects an unknown bearer → 401 unauthorized (code matches the status)', async () => {
|
|
169
|
-
const res = await app.inject({ method: 'GET', url: '/grants', headers: bearer('nope') });
|
|
170
|
-
expect(res.statusCode).toBe(401);
|
|
171
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('unauthorized');
|
|
172
|
-
});
|
|
173
|
-
});
|
|
174
|
-
|
|
175
|
-
describe('GET /grants (ownership isolation)', () => {
|
|
176
|
-
it('lists only the donations the presented grant authorized', async () => {
|
|
177
|
-
const other = grants.issue({ label: 'Carol' }).token;
|
|
178
|
-
await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
179
|
-
await app.inject({ method: 'POST', url: '/grants', headers: bearer(other), payload: body });
|
|
180
|
-
|
|
181
|
-
const mine = await app.inject({ method: 'GET', url: '/grants', headers: bearer(token) });
|
|
182
|
-
const donations = (mine.json() as { data: { donations: Array<{ grantToken: string }> } }).data.donations;
|
|
183
|
-
expect(donations).toHaveLength(1);
|
|
184
|
-
expect(donations[0].grantToken).toBe(token);
|
|
185
|
-
});
|
|
186
|
-
|
|
187
|
-
it('a foreign grant cannot read another grant’s donation → 404', async () => {
|
|
188
|
-
const other = grants.issue({ label: 'Carol' }).token;
|
|
189
|
-
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
190
|
-
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
191
|
-
|
|
192
|
-
const mine = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
193
|
-
expect(mine.statusCode).toBe(200);
|
|
194
|
-
|
|
195
|
-
const foreign = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(other) });
|
|
196
|
-
expect(foreign.statusCode).toBe(404);
|
|
197
|
-
});
|
|
198
|
-
});
|
|
199
|
-
|
|
200
|
-
describe('PUT /grants/:id/seed validation', () => {
|
|
201
|
-
it('rejects a missing seed body → 400 invalid_request', async () => {
|
|
202
|
-
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
203
|
-
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
204
|
-
const res = await app.inject({ method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: {} });
|
|
205
|
-
expect(res.statusCode).toBe(400);
|
|
206
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_request');
|
|
207
|
-
});
|
|
208
|
-
|
|
209
|
-
it('answers 409 invalid_state when the loan ends while the seed is in flight', async () => {
|
|
210
|
-
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
211
|
-
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
212
|
-
|
|
213
|
-
// The borrower's DELETE lands inside the seed window: the node accepts the
|
|
214
|
-
// seed, but by the time it answers the loan is over. The ending wins, so the
|
|
215
|
-
// route must NOT report a 200 that implies a live, freshly seeded node.
|
|
216
|
-
globalThis.fetch = (async () => {
|
|
217
|
-
await app.inject({ method: 'DELETE', url: `/grants/${id}`, headers: bearer(token) });
|
|
218
|
-
return { ok: true, json: async () => ({ success: true, peersAdded: 2 }) } as unknown as Response;
|
|
219
|
-
}) as typeof globalThis.fetch;
|
|
220
|
-
|
|
221
|
-
const res = await app.inject({
|
|
222
|
-
method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: { seed: 'encoded-seed' },
|
|
223
|
-
});
|
|
224
|
-
|
|
225
|
-
expect(res.statusCode).toBe(409);
|
|
226
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_state');
|
|
227
|
-
const after = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
228
|
-
expect((after.json() as { data: { donation: { status: string } } }).data.donation.status)
|
|
229
|
-
.toBe('terminated');
|
|
230
|
-
});
|
|
231
|
-
|
|
232
|
-
it('answers 404 not_found when the record vanishes while the seed is in flight', async () => {
|
|
233
|
-
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
234
|
-
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
235
|
-
|
|
236
|
-
// The row is gone by the time the node answers — the other half of the
|
|
237
|
-
// abandon mapping, which has no status to report.
|
|
238
|
-
globalThis.fetch = (async () => {
|
|
239
|
-
store.remove(id);
|
|
240
|
-
return { ok: true, json: async () => ({ success: true, peersAdded: 2 }) } as unknown as Response;
|
|
241
|
-
}) as typeof globalThis.fetch;
|
|
242
|
-
|
|
243
|
-
const res = await app.inject({
|
|
244
|
-
method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: { seed: 'encoded-seed' },
|
|
245
|
-
});
|
|
246
|
-
|
|
247
|
-
expect(res.statusCode).toBe(404);
|
|
248
|
-
expect((res.json() as { error: { code: string } }).error.code).toBe('not_found');
|
|
249
|
-
});
|
|
250
|
-
});
|
|
251
|
-
|
|
252
|
-
describe('DELETE /grants/:id', () => {
|
|
253
|
-
it('terminates a donation and drops it from the live tally', async () => {
|
|
254
|
-
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
255
|
-
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
256
|
-
|
|
257
|
-
const del = await app.inject({ method: 'DELETE', url: `/grants/${id}`, headers: bearer(token) });
|
|
258
|
-
expect(del.statusCode).toBe(200);
|
|
259
|
-
|
|
260
|
-
const one = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
261
|
-
expect((one.json() as { data: { donation: { status: string } } }).data.donation.status).toBe('terminated');
|
|
262
|
-
});
|
|
263
|
-
});
|
|
1
|
+
/**
|
|
2
|
+
* Grantee-facing `/grants` route tests — the bearer-gated provisioning surface.
|
|
3
|
+
*
|
|
4
|
+
* Uses a fake orchestrator (no real children) so the focus is the HTTP contract:
|
|
5
|
+
* bearer auth, request validation, per-grant ownership isolation, the quota gate,
|
|
6
|
+
* and seedToken redaction. The live-node round-trips (peer/seed) are covered by
|
|
7
|
+
* the cross-package integration scenario.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import Fastify from 'fastify';
|
|
11
|
+
import { afterEach, beforeEach, describe, expect, it } from 'vitest';
|
|
12
|
+
import { mkdtempSync, rmSync } from 'node:fs';
|
|
13
|
+
import { tmpdir } from 'node:os';
|
|
14
|
+
import { join } from 'node:path';
|
|
15
|
+
|
|
16
|
+
import type {
|
|
17
|
+
Orchestrator,
|
|
18
|
+
OrchestratorCreateRequest,
|
|
19
|
+
OrchestratorCreateResult,
|
|
20
|
+
OrchestratorStats,
|
|
21
|
+
} from '@serfab/cadre-provider';
|
|
22
|
+
|
|
23
|
+
import { registerErrorHandler } from '../error-handler.js';
|
|
24
|
+
import { registerGrantsRoutes } from '../routes/grants.js';
|
|
25
|
+
import { DonationService } from '../../donation/donation-service.js';
|
|
26
|
+
import { DonationStore } from '../../donation/donation-store.js';
|
|
27
|
+
import { GrantService } from '../../donation/grant-service.js';
|
|
28
|
+
import { GrantStore } from '../../donation/grant-store.js';
|
|
29
|
+
|
|
30
|
+
class FakeOrchestrator implements Orchestrator {
|
|
31
|
+
stopped: string[] = [];
|
|
32
|
+
removed: string[] = [];
|
|
33
|
+
private counter = 0;
|
|
34
|
+
async createContainer(_request: OrchestratorCreateRequest): Promise<OrchestratorCreateResult> {
|
|
35
|
+
const n = ++this.counter;
|
|
36
|
+
return {
|
|
37
|
+
dockerId: `dock_${n}`,
|
|
38
|
+
healthEndpoint: `http://127.0.0.1:${9000 + n}/health`,
|
|
39
|
+
metricsEndpoint: `http://127.0.0.1:${9000 + n}/metrics`,
|
|
40
|
+
seedEndpoint: `http://127.0.0.1:${9000 + n}/seed`,
|
|
41
|
+
seedToken: `seed-token-${n}`,
|
|
42
|
+
p2pPort: 4000 + n,
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
async stopContainer(id: string): Promise<void> { this.stopped.push(id); }
|
|
46
|
+
async removeContainer(id: string): Promise<void> { this.removed.push(id); }
|
|
47
|
+
async getStats(): Promise<OrchestratorStats> {
|
|
48
|
+
return { cpuPercent: 0, memoryBytes: 0, networkRxBytes: 0, networkTxBytes: 0 };
|
|
49
|
+
}
|
|
50
|
+
async isRunning(): Promise<boolean> { return true; }
|
|
51
|
+
async getLogs(): Promise<string> { return ''; }
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
let tmpRoot: string;
|
|
55
|
+
let app: ReturnType<typeof Fastify>;
|
|
56
|
+
let grants: GrantService;
|
|
57
|
+
let store: DonationStore;
|
|
58
|
+
let token: string;
|
|
59
|
+
const originalFetch = globalThis.fetch;
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* A well-formed 32-byte base64url owner key. `DonationService.provision`
|
|
63
|
+
* shape-checks the pins, so a placeholder string is a 400 rather than a fixture.
|
|
64
|
+
*/
|
|
65
|
+
const OWNER_KEY = Buffer.alloc(32, 7).toString('base64url');
|
|
66
|
+
|
|
67
|
+
const body = {
|
|
68
|
+
partyId: 'party-P',
|
|
69
|
+
bootstrapNodes: ['/ip4/127.0.0.1/tcp/4001/p2p/12D3KooReq'],
|
|
70
|
+
ownerKeys: [OWNER_KEY],
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
const bearer = (t: string) => ({ authorization: `Bearer ${t}` });
|
|
74
|
+
|
|
75
|
+
beforeEach(() => {
|
|
76
|
+
tmpRoot = mkdtempSync(join(tmpdir(), 'cadre-host-grants-svc-route-'));
|
|
77
|
+
grants = new GrantService({ store: new GrantStore(join(tmpRoot, 'grants')) });
|
|
78
|
+
token = grants.issue({ label: 'Alice', maxNodes: 2 }).token;
|
|
79
|
+
store = new DonationStore(join(tmpRoot, 'donations'));
|
|
80
|
+
const donations = new DonationService({ orchestrator: new FakeOrchestrator(), grants, store });
|
|
81
|
+
app = Fastify();
|
|
82
|
+
registerErrorHandler(app);
|
|
83
|
+
registerGrantsRoutes(app, { donations, grants });
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
afterEach(async () => {
|
|
87
|
+
globalThis.fetch = originalFetch;
|
|
88
|
+
await app.close();
|
|
89
|
+
try { rmSync(tmpRoot, { recursive: true, force: true }); } catch { /* ignore */ }
|
|
90
|
+
});
|
|
91
|
+
|
|
92
|
+
describe('POST /grants', () => {
|
|
93
|
+
it('provisions a donated node → 201, awaiting_seed, seedToken redacted', async () => {
|
|
94
|
+
const res = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
95
|
+
expect(res.statusCode).toBe(201);
|
|
96
|
+
const donation = (res.json() as { data: { donation: Record<string, unknown> } }).data.donation;
|
|
97
|
+
expect(donation.status).toBe('awaiting_seed');
|
|
98
|
+
expect(donation.partyId).toBe('party-P');
|
|
99
|
+
expect(donation.seedToken).toBeUndefined();
|
|
100
|
+
expect(donation.seedEndpoint).toBeUndefined();
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
it('rejects a missing bearer → 401', async () => {
|
|
104
|
+
const res = await app.inject({ method: 'POST', url: '/grants', payload: body });
|
|
105
|
+
expect(res.statusCode).toBe(401);
|
|
106
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('unauthorized');
|
|
107
|
+
});
|
|
108
|
+
|
|
109
|
+
it('rejects an unknown bearer → 401', async () => {
|
|
110
|
+
const res = await app.inject({ method: 'POST', url: '/grants', headers: bearer('nope'), payload: body });
|
|
111
|
+
expect(res.statusCode).toBe(401);
|
|
112
|
+
});
|
|
113
|
+
|
|
114
|
+
it('rejects a missing partyId → 400 invalid_request', async () => {
|
|
115
|
+
const res = await app.inject({
|
|
116
|
+
method: 'POST', url: '/grants', headers: bearer(token),
|
|
117
|
+
payload: { bootstrapNodes: body.bootstrapNodes, ownerKeys: body.ownerKeys },
|
|
118
|
+
});
|
|
119
|
+
expect(res.statusCode).toBe(400);
|
|
120
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_request');
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
it('rejects empty ownerKeys → 400 invalid_request', async () => {
|
|
124
|
+
const res = await app.inject({
|
|
125
|
+
method: 'POST', url: '/grants', headers: bearer(token),
|
|
126
|
+
payload: { ...body, ownerKeys: [] },
|
|
127
|
+
});
|
|
128
|
+
expect(res.statusCode).toBe(400);
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
// A typo'd pin used to be answered 201 and only fail when the spawned child
|
|
132
|
+
// tried to decode it at boot — by which point the caller had no way to act on it.
|
|
133
|
+
it('rejects a malformed ownerKeys entry → 400 invalid_request, naming the bad key', async () => {
|
|
134
|
+
const res = await app.inject({
|
|
135
|
+
method: 'POST', url: '/grants', headers: bearer(token),
|
|
136
|
+
payload: { ...body, ownerKeys: [OWNER_KEY, 'this-is-not-a-key'] },
|
|
137
|
+
});
|
|
138
|
+
expect(res.statusCode).toBe(400);
|
|
139
|
+
const error = (res.json() as { error: { code: string; message: string } }).error;
|
|
140
|
+
expect(error.code).toBe('invalid_request');
|
|
141
|
+
expect(error.message).toContain('this-is-not-a-key');
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
// Element types are the route's job: the service's shape check assumes strings,
|
|
145
|
+
// so a number here would come back as an internal `.trim is not a function`.
|
|
146
|
+
it('rejects a non-string ownerKeys entry → 400 naming the field, not a decoder error', async () => {
|
|
147
|
+
const res = await app.inject({
|
|
148
|
+
method: 'POST', url: '/grants', headers: bearer(token),
|
|
149
|
+
payload: { ...body, ownerKeys: [42] },
|
|
150
|
+
});
|
|
151
|
+
expect(res.statusCode).toBe(400);
|
|
152
|
+
const error = (res.json() as { error: { code: string; message: string } }).error;
|
|
153
|
+
expect(error.code).toBe('invalid_request');
|
|
154
|
+
expect(error.message).toBe('ownerKeys must be an array of strings');
|
|
155
|
+
});
|
|
156
|
+
|
|
157
|
+
it('enforces the grant quota → 429 quota_exceeded once maxNodes is reached', async () => {
|
|
158
|
+
const g = grants.issue({ label: 'Bob', maxNodes: 1 }).token;
|
|
159
|
+
const first = await app.inject({ method: 'POST', url: '/grants', headers: bearer(g), payload: body });
|
|
160
|
+
expect(first.statusCode).toBe(201);
|
|
161
|
+
const second = await app.inject({ method: 'POST', url: '/grants', headers: bearer(g), payload: body });
|
|
162
|
+
expect(second.statusCode).toBe(429);
|
|
163
|
+
expect((second.json() as { error: { code: string } }).error.code).toBe('quota_exceeded');
|
|
164
|
+
});
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
describe('GET /grants auth', () => {
|
|
168
|
+
it('rejects an unknown bearer → 401 unauthorized (code matches the status)', async () => {
|
|
169
|
+
const res = await app.inject({ method: 'GET', url: '/grants', headers: bearer('nope') });
|
|
170
|
+
expect(res.statusCode).toBe(401);
|
|
171
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('unauthorized');
|
|
172
|
+
});
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
describe('GET /grants (ownership isolation)', () => {
|
|
176
|
+
it('lists only the donations the presented grant authorized', async () => {
|
|
177
|
+
const other = grants.issue({ label: 'Carol' }).token;
|
|
178
|
+
await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
179
|
+
await app.inject({ method: 'POST', url: '/grants', headers: bearer(other), payload: body });
|
|
180
|
+
|
|
181
|
+
const mine = await app.inject({ method: 'GET', url: '/grants', headers: bearer(token) });
|
|
182
|
+
const donations = (mine.json() as { data: { donations: Array<{ grantToken: string }> } }).data.donations;
|
|
183
|
+
expect(donations).toHaveLength(1);
|
|
184
|
+
expect(donations[0].grantToken).toBe(token);
|
|
185
|
+
});
|
|
186
|
+
|
|
187
|
+
it('a foreign grant cannot read another grant’s donation → 404', async () => {
|
|
188
|
+
const other = grants.issue({ label: 'Carol' }).token;
|
|
189
|
+
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
190
|
+
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
191
|
+
|
|
192
|
+
const mine = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
193
|
+
expect(mine.statusCode).toBe(200);
|
|
194
|
+
|
|
195
|
+
const foreign = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(other) });
|
|
196
|
+
expect(foreign.statusCode).toBe(404);
|
|
197
|
+
});
|
|
198
|
+
});
|
|
199
|
+
|
|
200
|
+
describe('PUT /grants/:id/seed validation', () => {
|
|
201
|
+
it('rejects a missing seed body → 400 invalid_request', async () => {
|
|
202
|
+
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
203
|
+
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
204
|
+
const res = await app.inject({ method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: {} });
|
|
205
|
+
expect(res.statusCode).toBe(400);
|
|
206
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_request');
|
|
207
|
+
});
|
|
208
|
+
|
|
209
|
+
it('answers 409 invalid_state when the loan ends while the seed is in flight', async () => {
|
|
210
|
+
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
211
|
+
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
212
|
+
|
|
213
|
+
// The borrower's DELETE lands inside the seed window: the node accepts the
|
|
214
|
+
// seed, but by the time it answers the loan is over. The ending wins, so the
|
|
215
|
+
// route must NOT report a 200 that implies a live, freshly seeded node.
|
|
216
|
+
globalThis.fetch = (async () => {
|
|
217
|
+
await app.inject({ method: 'DELETE', url: `/grants/${id}`, headers: bearer(token) });
|
|
218
|
+
return { ok: true, json: async () => ({ success: true, peersAdded: 2 }) } as unknown as Response;
|
|
219
|
+
}) as typeof globalThis.fetch;
|
|
220
|
+
|
|
221
|
+
const res = await app.inject({
|
|
222
|
+
method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: { seed: 'encoded-seed' },
|
|
223
|
+
});
|
|
224
|
+
|
|
225
|
+
expect(res.statusCode).toBe(409);
|
|
226
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('invalid_state');
|
|
227
|
+
const after = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
228
|
+
expect((after.json() as { data: { donation: { status: string } } }).data.donation.status)
|
|
229
|
+
.toBe('terminated');
|
|
230
|
+
});
|
|
231
|
+
|
|
232
|
+
it('answers 404 not_found when the record vanishes while the seed is in flight', async () => {
|
|
233
|
+
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
234
|
+
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
235
|
+
|
|
236
|
+
// The row is gone by the time the node answers — the other half of the
|
|
237
|
+
// abandon mapping, which has no status to report.
|
|
238
|
+
globalThis.fetch = (async () => {
|
|
239
|
+
store.remove(id);
|
|
240
|
+
return { ok: true, json: async () => ({ success: true, peersAdded: 2 }) } as unknown as Response;
|
|
241
|
+
}) as typeof globalThis.fetch;
|
|
242
|
+
|
|
243
|
+
const res = await app.inject({
|
|
244
|
+
method: 'PUT', url: `/grants/${id}/seed`, headers: bearer(token), payload: { seed: 'encoded-seed' },
|
|
245
|
+
});
|
|
246
|
+
|
|
247
|
+
expect(res.statusCode).toBe(404);
|
|
248
|
+
expect((res.json() as { error: { code: string } }).error.code).toBe('not_found');
|
|
249
|
+
});
|
|
250
|
+
});
|
|
251
|
+
|
|
252
|
+
describe('DELETE /grants/:id', () => {
|
|
253
|
+
it('terminates a donation and drops it from the live tally', async () => {
|
|
254
|
+
const created = await app.inject({ method: 'POST', url: '/grants', headers: bearer(token), payload: body });
|
|
255
|
+
const id = (created.json() as { data: { donation: { id: string } } }).data.donation.id;
|
|
256
|
+
|
|
257
|
+
const del = await app.inject({ method: 'DELETE', url: `/grants/${id}`, headers: bearer(token) });
|
|
258
|
+
expect(del.statusCode).toBe(200);
|
|
259
|
+
|
|
260
|
+
const one = await app.inject({ method: 'GET', url: `/grants/${id}`, headers: bearer(token) });
|
|
261
|
+
expect((one.json() as { data: { donation: { status: string } } }).data.donation.status).toBe('terminated');
|
|
262
|
+
});
|
|
263
|
+
});
|