@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,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
+ });