@serfab/cadre-host 0.10.0 → 0.12.0

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