@bsv/overlay-express 2.7.4 → 2.8.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 (209) hide show
  1. package/README.md +146 -0
  2. package/dist/cjs/mod.d.ts +2 -1
  3. package/dist/cjs/mod.d.ts.map +1 -1
  4. package/dist/cjs/mod.js.map +1 -1
  5. package/dist/cjs/package.json +34 -8
  6. package/dist/cjs/src/OutputLookupHTTPPolicy.d.ts +10 -0
  7. package/dist/cjs/src/OutputLookupHTTPPolicy.d.ts.map +1 -0
  8. package/dist/cjs/src/OutputLookupHTTPPolicy.js +125 -0
  9. package/dist/cjs/src/OutputLookupHTTPPolicy.js.map +1 -0
  10. package/dist/cjs/src/OutputLookupResponseGuard.d.ts +31 -0
  11. package/dist/cjs/src/OutputLookupResponseGuard.d.ts.map +1 -0
  12. package/dist/cjs/src/OutputLookupResponseGuard.js +91 -0
  13. package/dist/cjs/src/OutputLookupResponseGuard.js.map +1 -0
  14. package/dist/cjs/src/OutputLookupRoutes.d.ts +53 -0
  15. package/dist/cjs/src/OutputLookupRoutes.d.ts.map +1 -0
  16. package/dist/cjs/src/OutputLookupRoutes.js +274 -0
  17. package/dist/cjs/src/OutputLookupRoutes.js.map +1 -0
  18. package/dist/cjs/src/OverlayExpress.d.ts +63 -0
  19. package/dist/cjs/src/OverlayExpress.d.ts.map +1 -1
  20. package/dist/cjs/src/OverlayExpress.js +263 -6
  21. package/dist/cjs/src/OverlayExpress.js.map +1 -1
  22. package/dist/cjs/src/PrivateAcquisitionHTTPPolicy.d.ts +19 -0
  23. package/dist/cjs/src/PrivateAcquisitionHTTPPolicy.d.ts.map +1 -0
  24. package/dist/cjs/src/PrivateAcquisitionHTTPPolicy.js +90 -0
  25. package/dist/cjs/src/PrivateAcquisitionHTTPPolicy.js.map +1 -0
  26. package/dist/cjs/src/PrivateAcquisitionHTTPPorts.d.ts +43 -0
  27. package/dist/cjs/src/PrivateAcquisitionHTTPPorts.d.ts.map +1 -0
  28. package/dist/cjs/src/PrivateAcquisitionHTTPPorts.js +3 -0
  29. package/dist/cjs/src/PrivateAcquisitionHTTPPorts.js.map +1 -0
  30. package/dist/cjs/src/PrivateAcquisitionResponseGuard.d.ts +14 -0
  31. package/dist/cjs/src/PrivateAcquisitionResponseGuard.d.ts.map +1 -0
  32. package/dist/cjs/src/PrivateAcquisitionResponseGuard.js +108 -0
  33. package/dist/cjs/src/PrivateAcquisitionResponseGuard.js.map +1 -0
  34. package/dist/cjs/src/PrivateAcquisitionRoutes.d.ts +7 -0
  35. package/dist/cjs/src/PrivateAcquisitionRoutes.d.ts.map +1 -0
  36. package/dist/cjs/src/PrivateAcquisitionRoutes.js +269 -0
  37. package/dist/cjs/src/PrivateAcquisitionRoutes.js.map +1 -0
  38. package/dist/cjs/src/PrivateOverlayHost.d.ts +31 -0
  39. package/dist/cjs/src/PrivateOverlayHost.d.ts.map +1 -0
  40. package/dist/cjs/src/PrivateOverlayHost.js +64 -0
  41. package/dist/cjs/src/PrivateOverlayHost.js.map +1 -0
  42. package/dist/cjs/src/PrivatePublicationHTTPPolicy.d.ts +17 -0
  43. package/dist/cjs/src/PrivatePublicationHTTPPolicy.d.ts.map +1 -0
  44. package/dist/cjs/src/PrivatePublicationHTTPPolicy.js +38 -0
  45. package/dist/cjs/src/PrivatePublicationHTTPPolicy.js.map +1 -0
  46. package/dist/cjs/src/PrivatePublicationHTTPPorts.d.ts +40 -0
  47. package/dist/cjs/src/PrivatePublicationHTTPPorts.d.ts.map +1 -0
  48. package/dist/cjs/src/PrivatePublicationHTTPPorts.js +3 -0
  49. package/dist/cjs/src/PrivatePublicationHTTPPorts.js.map +1 -0
  50. package/dist/cjs/src/PrivatePublicationResponseGuard.d.ts +14 -0
  51. package/dist/cjs/src/PrivatePublicationResponseGuard.d.ts.map +1 -0
  52. package/dist/cjs/src/PrivatePublicationResponseGuard.js +82 -0
  53. package/dist/cjs/src/PrivatePublicationResponseGuard.js.map +1 -0
  54. package/dist/cjs/src/PrivatePublicationRoutes.d.ts +6 -0
  55. package/dist/cjs/src/PrivatePublicationRoutes.d.ts.map +1 -0
  56. package/dist/cjs/src/PrivatePublicationRoutes.js +249 -0
  57. package/dist/cjs/src/PrivatePublicationRoutes.js.map +1 -0
  58. package/dist/cjs/src/PrivatePurchaseHTTPPolicy.d.ts +19 -0
  59. package/dist/cjs/src/PrivatePurchaseHTTPPolicy.d.ts.map +1 -0
  60. package/dist/cjs/src/PrivatePurchaseHTTPPolicy.js +82 -0
  61. package/dist/cjs/src/PrivatePurchaseHTTPPolicy.js.map +1 -0
  62. package/dist/cjs/src/PrivatePurchaseHTTPPorts.d.ts +48 -0
  63. package/dist/cjs/src/PrivatePurchaseHTTPPorts.d.ts.map +1 -0
  64. package/dist/cjs/src/PrivatePurchaseHTTPPorts.js +3 -0
  65. package/dist/cjs/src/PrivatePurchaseHTTPPorts.js.map +1 -0
  66. package/dist/cjs/src/PrivatePurchaseResponseGuard.d.ts +15 -0
  67. package/dist/cjs/src/PrivatePurchaseResponseGuard.d.ts.map +1 -0
  68. package/dist/cjs/src/PrivatePurchaseResponseGuard.js +85 -0
  69. package/dist/cjs/src/PrivatePurchaseResponseGuard.js.map +1 -0
  70. package/dist/cjs/src/PrivatePurchaseRoutes.d.ts +7 -0
  71. package/dist/cjs/src/PrivatePurchaseRoutes.d.ts.map +1 -0
  72. package/dist/cjs/src/PrivatePurchaseRoutes.js +276 -0
  73. package/dist/cjs/src/PrivatePurchaseRoutes.js.map +1 -0
  74. package/dist/cjs/src/ProposalHTTPPolicy.d.ts +11 -0
  75. package/dist/cjs/src/ProposalHTTPPolicy.d.ts.map +1 -0
  76. package/dist/cjs/src/ProposalHTTPPolicy.js +38 -0
  77. package/dist/cjs/src/ProposalHTTPPolicy.js.map +1 -0
  78. package/dist/cjs/src/ProposalHTTPPorts.d.ts +59 -0
  79. package/dist/cjs/src/ProposalHTTPPorts.d.ts.map +1 -0
  80. package/dist/cjs/src/ProposalHTTPPorts.js +3 -0
  81. package/dist/cjs/src/ProposalHTTPPorts.js.map +1 -0
  82. package/dist/cjs/src/ProposalResponseGuard.d.ts +18 -0
  83. package/dist/cjs/src/ProposalResponseGuard.d.ts.map +1 -0
  84. package/dist/cjs/src/ProposalResponseGuard.js +61 -0
  85. package/dist/cjs/src/ProposalResponseGuard.js.map +1 -0
  86. package/dist/cjs/src/ProposalRoutes.d.ts +10 -0
  87. package/dist/cjs/src/ProposalRoutes.d.ts.map +1 -0
  88. package/dist/cjs/src/ProposalRoutes.js +239 -0
  89. package/dist/cjs/src/ProposalRoutes.js.map +1 -0
  90. package/dist/cjs/src/RootEvictionHTTPPolicy.d.ts +8 -0
  91. package/dist/cjs/src/RootEvictionHTTPPolicy.d.ts.map +1 -0
  92. package/dist/cjs/src/RootEvictionHTTPPolicy.js +77 -0
  93. package/dist/cjs/src/RootEvictionHTTPPolicy.js.map +1 -0
  94. package/dist/cjs/src/RootEvictionHTTPPorts.d.ts +73 -0
  95. package/dist/cjs/src/RootEvictionHTTPPorts.d.ts.map +1 -0
  96. package/dist/cjs/src/RootEvictionHTTPPorts.js +3 -0
  97. package/dist/cjs/src/RootEvictionHTTPPorts.js.map +1 -0
  98. package/dist/cjs/src/RootEvictionResponseGuard.d.ts +38 -0
  99. package/dist/cjs/src/RootEvictionResponseGuard.d.ts.map +1 -0
  100. package/dist/cjs/src/RootEvictionResponseGuard.js +83 -0
  101. package/dist/cjs/src/RootEvictionResponseGuard.js.map +1 -0
  102. package/dist/cjs/src/RootEvictionRoutes.d.ts +11 -0
  103. package/dist/cjs/src/RootEvictionRoutes.d.ts.map +1 -0
  104. package/dist/cjs/src/RootEvictionRoutes.js +198 -0
  105. package/dist/cjs/src/RootEvictionRoutes.js.map +1 -0
  106. package/dist/esm/mod.js.map +1 -1
  107. package/dist/esm/src/OutputLookupHTTPPolicy.js +117 -0
  108. package/dist/esm/src/OutputLookupHTTPPolicy.js.map +1 -0
  109. package/dist/esm/src/OutputLookupResponseGuard.js +85 -0
  110. package/dist/esm/src/OutputLookupResponseGuard.js.map +1 -0
  111. package/dist/esm/src/OutputLookupRoutes.js +275 -0
  112. package/dist/esm/src/OutputLookupRoutes.js.map +1 -0
  113. package/dist/esm/src/OverlayExpress.js +239 -11
  114. package/dist/esm/src/OverlayExpress.js.map +1 -1
  115. package/dist/esm/src/PrivateAcquisitionHTTPPolicy.js +82 -0
  116. package/dist/esm/src/PrivateAcquisitionHTTPPolicy.js.map +1 -0
  117. package/dist/esm/src/PrivateAcquisitionHTTPPorts.js +2 -0
  118. package/dist/esm/src/PrivateAcquisitionHTTPPorts.js.map +1 -0
  119. package/dist/esm/src/PrivateAcquisitionResponseGuard.js +105 -0
  120. package/dist/esm/src/PrivateAcquisitionResponseGuard.js.map +1 -0
  121. package/dist/esm/src/PrivateAcquisitionRoutes.js +267 -0
  122. package/dist/esm/src/PrivateAcquisitionRoutes.js.map +1 -0
  123. package/dist/esm/src/PrivateOverlayHost.js +62 -0
  124. package/dist/esm/src/PrivateOverlayHost.js.map +1 -0
  125. package/dist/esm/src/PrivatePublicationHTTPPolicy.js +30 -0
  126. package/dist/esm/src/PrivatePublicationHTTPPolicy.js.map +1 -0
  127. package/dist/esm/src/PrivatePublicationHTTPPorts.js +2 -0
  128. package/dist/esm/src/PrivatePublicationHTTPPorts.js.map +1 -0
  129. package/dist/esm/src/PrivatePublicationResponseGuard.js +79 -0
  130. package/dist/esm/src/PrivatePublicationResponseGuard.js.map +1 -0
  131. package/dist/esm/src/PrivatePublicationRoutes.js +247 -0
  132. package/dist/esm/src/PrivatePublicationRoutes.js.map +1 -0
  133. package/dist/esm/src/PrivatePurchaseHTTPPolicy.js +74 -0
  134. package/dist/esm/src/PrivatePurchaseHTTPPolicy.js.map +1 -0
  135. package/dist/esm/src/PrivatePurchaseHTTPPorts.js +2 -0
  136. package/dist/esm/src/PrivatePurchaseHTTPPorts.js.map +1 -0
  137. package/dist/esm/src/PrivatePurchaseResponseGuard.js +82 -0
  138. package/dist/esm/src/PrivatePurchaseResponseGuard.js.map +1 -0
  139. package/dist/esm/src/PrivatePurchaseRoutes.js +275 -0
  140. package/dist/esm/src/PrivatePurchaseRoutes.js.map +1 -0
  141. package/dist/esm/src/ProposalHTTPPolicy.js +30 -0
  142. package/dist/esm/src/ProposalHTTPPolicy.js.map +1 -0
  143. package/dist/esm/src/ProposalHTTPPorts.js +2 -0
  144. package/dist/esm/src/ProposalHTTPPorts.js.map +1 -0
  145. package/dist/esm/src/ProposalResponseGuard.js +58 -0
  146. package/dist/esm/src/ProposalResponseGuard.js.map +1 -0
  147. package/dist/esm/src/ProposalRoutes.js +237 -0
  148. package/dist/esm/src/ProposalRoutes.js.map +1 -0
  149. package/dist/esm/src/RootEvictionHTTPPolicy.js +71 -0
  150. package/dist/esm/src/RootEvictionHTTPPolicy.js.map +1 -0
  151. package/dist/esm/src/RootEvictionHTTPPorts.js +2 -0
  152. package/dist/esm/src/RootEvictionHTTPPorts.js.map +1 -0
  153. package/dist/esm/src/RootEvictionResponseGuard.js +80 -0
  154. package/dist/esm/src/RootEvictionResponseGuard.js.map +1 -0
  155. package/dist/esm/src/RootEvictionRoutes.js +196 -0
  156. package/dist/esm/src/RootEvictionRoutes.js.map +1 -0
  157. package/dist/types/mod.d.ts +2 -1
  158. package/dist/types/mod.d.ts.map +1 -1
  159. package/dist/types/src/OutputLookupHTTPPolicy.d.ts +10 -0
  160. package/dist/types/src/OutputLookupHTTPPolicy.d.ts.map +1 -0
  161. package/dist/types/src/OutputLookupResponseGuard.d.ts +31 -0
  162. package/dist/types/src/OutputLookupResponseGuard.d.ts.map +1 -0
  163. package/dist/types/src/OutputLookupRoutes.d.ts +53 -0
  164. package/dist/types/src/OutputLookupRoutes.d.ts.map +1 -0
  165. package/dist/types/src/OverlayExpress.d.ts +63 -0
  166. package/dist/types/src/OverlayExpress.d.ts.map +1 -1
  167. package/dist/types/src/PrivateAcquisitionHTTPPolicy.d.ts +19 -0
  168. package/dist/types/src/PrivateAcquisitionHTTPPolicy.d.ts.map +1 -0
  169. package/dist/types/src/PrivateAcquisitionHTTPPorts.d.ts +43 -0
  170. package/dist/types/src/PrivateAcquisitionHTTPPorts.d.ts.map +1 -0
  171. package/dist/types/src/PrivateAcquisitionResponseGuard.d.ts +14 -0
  172. package/dist/types/src/PrivateAcquisitionResponseGuard.d.ts.map +1 -0
  173. package/dist/types/src/PrivateAcquisitionRoutes.d.ts +7 -0
  174. package/dist/types/src/PrivateAcquisitionRoutes.d.ts.map +1 -0
  175. package/dist/types/src/PrivateOverlayHost.d.ts +31 -0
  176. package/dist/types/src/PrivateOverlayHost.d.ts.map +1 -0
  177. package/dist/types/src/PrivatePublicationHTTPPolicy.d.ts +17 -0
  178. package/dist/types/src/PrivatePublicationHTTPPolicy.d.ts.map +1 -0
  179. package/dist/types/src/PrivatePublicationHTTPPorts.d.ts +40 -0
  180. package/dist/types/src/PrivatePublicationHTTPPorts.d.ts.map +1 -0
  181. package/dist/types/src/PrivatePublicationResponseGuard.d.ts +14 -0
  182. package/dist/types/src/PrivatePublicationResponseGuard.d.ts.map +1 -0
  183. package/dist/types/src/PrivatePublicationRoutes.d.ts +6 -0
  184. package/dist/types/src/PrivatePublicationRoutes.d.ts.map +1 -0
  185. package/dist/types/src/PrivatePurchaseHTTPPolicy.d.ts +19 -0
  186. package/dist/types/src/PrivatePurchaseHTTPPolicy.d.ts.map +1 -0
  187. package/dist/types/src/PrivatePurchaseHTTPPorts.d.ts +48 -0
  188. package/dist/types/src/PrivatePurchaseHTTPPorts.d.ts.map +1 -0
  189. package/dist/types/src/PrivatePurchaseResponseGuard.d.ts +15 -0
  190. package/dist/types/src/PrivatePurchaseResponseGuard.d.ts.map +1 -0
  191. package/dist/types/src/PrivatePurchaseRoutes.d.ts +7 -0
  192. package/dist/types/src/PrivatePurchaseRoutes.d.ts.map +1 -0
  193. package/dist/types/src/ProposalHTTPPolicy.d.ts +11 -0
  194. package/dist/types/src/ProposalHTTPPolicy.d.ts.map +1 -0
  195. package/dist/types/src/ProposalHTTPPorts.d.ts +59 -0
  196. package/dist/types/src/ProposalHTTPPorts.d.ts.map +1 -0
  197. package/dist/types/src/ProposalResponseGuard.d.ts +18 -0
  198. package/dist/types/src/ProposalResponseGuard.d.ts.map +1 -0
  199. package/dist/types/src/ProposalRoutes.d.ts +10 -0
  200. package/dist/types/src/ProposalRoutes.d.ts.map +1 -0
  201. package/dist/types/src/RootEvictionHTTPPolicy.d.ts +8 -0
  202. package/dist/types/src/RootEvictionHTTPPolicy.d.ts.map +1 -0
  203. package/dist/types/src/RootEvictionHTTPPorts.d.ts +73 -0
  204. package/dist/types/src/RootEvictionHTTPPorts.d.ts.map +1 -0
  205. package/dist/types/src/RootEvictionResponseGuard.d.ts +38 -0
  206. package/dist/types/src/RootEvictionResponseGuard.d.ts.map +1 -0
  207. package/dist/types/src/RootEvictionRoutes.d.ts +11 -0
  208. package/dist/types/src/RootEvictionRoutes.d.ts.map +1 -0
  209. package/package.json +109 -13
@@ -0,0 +1,275 @@
1
+ import express from 'express';
2
+ import { canonicalOutputBase, OUTPUT_PROFILES, outputHex32, outputIdentity, OutputProtocolError, parseOutputJSON, parseOutputPurchaseRecover, parseOutputPurchasePrepare, parseOutputPurchaseSubmit } from '@bsv/sdk';
3
+ import { privatePurchaseHTTPCORS, privatePurchaseHTTPOrigins, privatePurchaseHTTPControlHeaders, privatePurchaseHTTPError, sendPrivatePurchaseHTTPError } from './PrivatePurchaseHTTPPolicy.js';
4
+ import { guardPrivatePurchaseResponse } from './PrivatePurchaseResponseGuard.js';
5
+ function bounded(value, maximum) {
6
+ if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
7
+ throw new TypeError('Invalid private purchase HTTP capacity');
8
+ return value;
9
+ }
10
+ function headers(req) {
11
+ let bytes = 0;
12
+ const names = new Set();
13
+ for (let i = 0; i < req.rawHeaders.length; i += 2) {
14
+ const name = req.rawHeaders[i].toLowerCase();
15
+ bytes += Buffer.byteLength(name) + Buffer.byteLength(req.rawHeaders[i + 1]);
16
+ if (bytes > 131072)
17
+ throw new OutputProtocolError('limited', 'Private purchase HTTP header bound');
18
+ if (names.has(name))
19
+ throw new OutputProtocolError('invalid', 'Duplicate private purchase HTTP header');
20
+ names.add(name);
21
+ if (name.startsWith('x-bsv-payment'))
22
+ throw new OutputProtocolError('invalid', 'Covenant purchase accepts no HTTP payment');
23
+ }
24
+ if (req.headers['content-encoding'] !== undefined &&
25
+ req.headers['content-encoding'] !== 'identity')
26
+ throw new OutputProtocolError('unsupported', 'Private purchase requests require identity encoding');
27
+ }
28
+ class PrivatePurchaseHTTPHandler {
29
+ options;
30
+ prefix;
31
+ origins;
32
+ raw;
33
+ maximum;
34
+ maximumWork;
35
+ perPrincipal;
36
+ timeoutMs;
37
+ requestBytes;
38
+ responseBytes;
39
+ prepareAsync;
40
+ activeRequests = 0;
41
+ activeWork = 0;
42
+ principals = new Map();
43
+ constructor(input) {
44
+ this.options = { ...input, identity: outputIdentity(input.identity) };
45
+ this.prefix =
46
+ new URL(canonicalOutputBase(input.baseURL)).pathname.replace(/\/$/, '') +
47
+ '/overlay/v1/purchases';
48
+ this.origins = privatePurchaseHTTPOrigins(input.allowedOrigins);
49
+ this.maximum = bounded(input.maximumRequests ?? 64, 4096);
50
+ this.maximumWork = bounded(input.maximumWork ?? 64, 4096);
51
+ this.perPrincipal = bounded(input.maximumWorkPerPrincipal ?? Math.min(4, this.maximumWork), this.maximumWork);
52
+ this.timeoutMs = bounded(input.requestTimeoutMs ?? 30000, 30000);
53
+ this.requestBytes = bounded(input.maximumRequestBytes ?? 4194304, 4194304);
54
+ this.responseBytes = bounded(input.maximumResponseBytes ?? 4194304, 4194304);
55
+ if (typeof input.authenticate !== 'function' ||
56
+ typeof input.disclosure.prepare !== 'function' ||
57
+ typeof input.disclosure.enqueueControl !== 'function')
58
+ throw new TypeError('Private purchase routes require authentication and a native disclosure owner');
59
+ if (input.disclosure.prepareAsync !== undefined &&
60
+ typeof input.disclosure.prepareAsync !== 'function')
61
+ throw new TypeError('Private purchase async disclosure must be an installed function');
62
+ this.prepareAsync = input.disclosure.prepareAsync;
63
+ this.raw = express.raw({ type: () => true, limit: this.requestBytes, inflate: false });
64
+ }
65
+ route(path) {
66
+ for (const operation of ['prepare', 'submit', 'recover'])
67
+ if (path === this.prefix + '/' + operation)
68
+ return operation;
69
+ if (this.options.handleHandshake !== false && path === '/.well-known/auth')
70
+ return 'handshake';
71
+ if (['prepare', 'submit', 'recover'].some(operation => path.toLowerCase().startsWith((this.prefix + '/' + operation).toLowerCase())))
72
+ return 'unknown';
73
+ return undefined;
74
+ }
75
+ handle = (req, res, next) => {
76
+ const route = this.route(req.path);
77
+ if (route === undefined) {
78
+ next();
79
+ return;
80
+ }
81
+ try {
82
+ if (!privatePurchaseHTTPCORS(req, res, this.origins))
83
+ return;
84
+ headers(req);
85
+ if (route === 'unknown')
86
+ throw new OutputProtocolError('not-found', 'Unknown private purchase endpoint');
87
+ if (req.method !== 'POST' || req.url.includes('?'))
88
+ throw new OutputProtocolError('invalid', 'Invalid private purchase method or query');
89
+ if (req.headers['content-type']?.split(';', 1)[0].trim().toLowerCase() !== 'application/json')
90
+ throw new OutputProtocolError('invalid', 'Private purchase requests require JSON');
91
+ if (req.body !== undefined)
92
+ throw new OutputProtocolError('unsupported', 'Private purchase routes must precede body parsers');
93
+ if (this.activeRequests >= this.maximum)
94
+ throw new OutputProtocolError('limited', 'Private purchase HTTP capacity is full', true);
95
+ this.track(res);
96
+ this.raw(req, res, error => this.parsed(req, res, route, error));
97
+ }
98
+ catch (error) {
99
+ sendPrivatePurchaseHTTPError(res, error);
100
+ }
101
+ };
102
+ track(res) {
103
+ this.activeRequests++;
104
+ let released = false;
105
+ const timer = setTimeout(() => res.destroy(), this.timeoutMs);
106
+ timer.unref?.();
107
+ const release = () => {
108
+ if (released)
109
+ return;
110
+ released = true;
111
+ clearTimeout(timer);
112
+ this.activeRequests--;
113
+ res.removeListener('finish', release);
114
+ res.removeListener('close', release);
115
+ };
116
+ res.once('finish', release);
117
+ res.once('close', release);
118
+ }
119
+ parsed(req, res, route, error) {
120
+ try {
121
+ if (res.destroyed || req.aborted)
122
+ return;
123
+ if (error) {
124
+ const large = error instanceof Error &&
125
+ Object.getOwnPropertyDescriptor(error, 'type')?.value === 'entity.too.large';
126
+ throw new OutputProtocolError(large ? 'limited' : 'invalid', 'Invalid bounded private purchase body');
127
+ }
128
+ if (!Buffer.isBuffer(req.body) || req.body.length === 0)
129
+ throw new OutputProtocolError('invalid', 'Missing private purchase body bytes');
130
+ let text;
131
+ try {
132
+ text = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(req.body);
133
+ }
134
+ catch {
135
+ throw new OutputProtocolError('invalid', 'Invalid private purchase UTF-8');
136
+ }
137
+ if (route === 'handshake')
138
+ req.body = parseOutputJSON(text, { bytes: this.requestBytes });
139
+ this.options.authenticate(req, res, error => {
140
+ if (res.destroyed || req.aborted || res.writableEnded)
141
+ return;
142
+ if (error || route === 'handshake') {
143
+ sendPrivatePurchaseHTTPError(res, error ?? new OutputProtocolError('unsupported', 'Handshake was not handled'));
144
+ return;
145
+ }
146
+ void this.execute(req, res, route, text).catch(error => sendPrivatePurchaseHTTPError(res, error));
147
+ });
148
+ }
149
+ catch (error) {
150
+ sendPrivatePurchaseHTTPError(res, error);
151
+ }
152
+ }
153
+ acquire(identity) {
154
+ const count = this.principals.get(identity) ?? 0;
155
+ if (this.activeWork >= this.maximumWork || count >= this.perPrincipal)
156
+ throw new OutputProtocolError('limited', 'Private purchase service work capacity is full', true);
157
+ this.activeWork++;
158
+ this.principals.set(identity, count + 1);
159
+ return () => {
160
+ this.activeWork--;
161
+ const remaining = this.principals.get(identity) - 1;
162
+ if (remaining === 0)
163
+ this.principals.delete(identity);
164
+ else
165
+ this.principals.set(identity, remaining);
166
+ };
167
+ }
168
+ async execute(req, res, operation, text) {
169
+ const capabilityDigest = outputHex32(req.headers['x-bsv-overlay-capability']);
170
+ if (req.headers['x-bsv-overlay-profile'] !== OUTPUT_PROFILES.purchase)
171
+ throw new OutputProtocolError('unsupported', 'Private purchase profile was not selected');
172
+ if (req.headers['cache-control'] !== 'no-store')
173
+ throw new OutputProtocolError('invalid', 'Private purchase requests require no-store');
174
+ const controller = new AbortController(), caller = authenticatedCaller(req, res, capabilityDigest, controller), cancel = () => controller.abort();
175
+ res.once('close', cancel);
176
+ req.once('aborted', cancel);
177
+ res.set({
178
+ 'x-bsv-overlay-capability': capabilityDigest,
179
+ 'x-bsv-overlay-profile': OUTPUT_PROFILES.purchase
180
+ });
181
+ let release;
182
+ let installed = false;
183
+ try {
184
+ if (req.aborted || res.destroyed)
185
+ return;
186
+ release = this.acquire(caller.buyer);
187
+ const input = parseOutputJSON(text, { bytes: this.requestBytes });
188
+ const id = await this.runOperation(operation, input, caller);
189
+ if (req.aborted || res.destroyed || res.writableEnded)
190
+ return;
191
+ if (this.options.disclosure.prepareAsync !== this.prepareAsync)
192
+ throw new OutputProtocolError('context-changed', 'Private purchase disclosure owner changed');
193
+ const preparation = { terms: operation === 'prepare' };
194
+ const prepared = this.prepareAsync === undefined
195
+ ? this.options.disclosure.prepare(outputHex32(id), caller, preparation)
196
+ : await this.prepareAsync.call(this.options.disclosure, outputHex32(id), caller, preparation);
197
+ if (req.aborted || res.destroyed || res.writableEnded)
198
+ return;
199
+ if (typeof prepared.body !== 'string' ||
200
+ Buffer.byteLength(prepared.body) > this.responseBytes)
201
+ throw new OutputProtocolError('limited', 'Private purchase response exceeds HTTP capacity');
202
+ guardPrivatePurchaseResponse(res, {
203
+ disclosure: this.options.disclosure,
204
+ caller,
205
+ seller: this.options.identity,
206
+ initial: { prepared },
207
+ controlHeaders: privatePurchaseHTTPControlHeaders(res)
208
+ });
209
+ installed = true;
210
+ res
211
+ .status(prepared.statusCode)
212
+ .set(prepared.headers)
213
+ .set('content-type', 'application/json')
214
+ .end(prepared.body);
215
+ }
216
+ catch (error) {
217
+ if (res.destroyed || res.writableEnded || req.aborted)
218
+ return;
219
+ if (installed) {
220
+ res.destroy();
221
+ return;
222
+ }
223
+ guardPrivatePurchaseResponse(res, {
224
+ disclosure: this.options.disclosure,
225
+ caller,
226
+ seller: this.options.identity,
227
+ initial: { error },
228
+ controlHeaders: privatePurchaseHTTPControlHeaders(res)
229
+ });
230
+ const control = privatePurchaseHTTPError(error);
231
+ res
232
+ .status(control.statusCode)
233
+ .set('content-type', 'application/json')
234
+ .end(Buffer.from(control.body));
235
+ }
236
+ finally {
237
+ // Disconnects/deadlines do not release capacity while service work still runs.
238
+ // A committed operation is recovered by its original identity, never undone here.
239
+ release?.();
240
+ res.removeListener('close', cancel);
241
+ req.removeListener('aborted', cancel);
242
+ }
243
+ }
244
+ runOperation(operation, input, caller) {
245
+ if (operation === 'prepare')
246
+ return this.options.service.prepare(parseOutputPurchasePrepare(input), caller);
247
+ if (operation === 'submit')
248
+ return this.options.service.submit(parseOutputPurchaseSubmit(input), caller);
249
+ return this.options.service.recover(parseOutputPurchaseRecover(input).acquisitionId, caller);
250
+ }
251
+ }
252
+ /** Opt-in authenticated BRC-196 preparation/submission/recovery routes. Mount before body parsers. */
253
+ export function createPrivatePurchaseRouter(options) {
254
+ const router = express.Router(), handler = new PrivatePurchaseHTTPHandler(options);
255
+ router.use(handler.handle);
256
+ return router;
257
+ }
258
+ function authenticatedCaller(req, res, capabilityDigest, controller) {
259
+ const identity = req.auth?.identityKey;
260
+ if (identity === undefined || identity === 'unknown')
261
+ throw new OutputProtocolError('unauthorized', 'Private purchase requires authenticated identity');
262
+ const authenticated = req.auth;
263
+ return Object.freeze({
264
+ buyer: outputIdentity(identity),
265
+ capability: capabilityDigest,
266
+ profile: OUTPUT_PROFILES.purchase,
267
+ signal: controller.signal,
268
+ current: () => !req.aborted &&
269
+ !res.destroyed &&
270
+ !controller.signal.aborted &&
271
+ req.auth === authenticated &&
272
+ authenticated?.identityKey === identity
273
+ });
274
+ }
275
+ //# sourceMappingURL=PrivatePurchaseRoutes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PrivatePurchaseRoutes.js","sourceRoot":"","sources":["../../../src/PrivatePurchaseRoutes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import { canonicalOutputJSON, outputServiceErrorHTTPStatus } from '@bsv/sdk';
2
+ import { lookupHTTPError } from './OutputLookupHTTPPolicy.js';
3
+ export { rootHTTPOrigins as proposalHTTPOrigins, rootHTTPCORS as proposalHTTPCORS, rootHTTPControlHeaders as proposalHTTPControlHeaders } from './RootEvictionHTTPPolicy.js';
4
+ /** Only fixed public diagnostics leave the transport; no private reason, row or path. */
5
+ export function proposalHTTPError(error) {
6
+ const value = lookupHTTPError(error);
7
+ const packet = {
8
+ version: 1,
9
+ error: {
10
+ code: value.error.code,
11
+ message: `Proposal request ${value.error.code}`,
12
+ retryable: value.error.retryable
13
+ }
14
+ };
15
+ return {
16
+ statusCode: outputServiceErrorHTTPStatus(packet.error.code),
17
+ body: new TextEncoder().encode(canonicalOutputJSON(packet, { bytes: 4096 }))
18
+ };
19
+ }
20
+ /** Pre-authentication/selection errors are transport failures, not trusted proposal observations. */
21
+ export function sendProposalHTTPError(res, error) {
22
+ if (res.destroyed || res.writableEnded || res.headersSent)
23
+ return;
24
+ const control = proposalHTTPError(error);
25
+ res
26
+ .status(control.statusCode)
27
+ .set('content-type', 'application/json')
28
+ .end(Buffer.from(control.body));
29
+ }
30
+ //# sourceMappingURL=ProposalHTTPPolicy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProposalHTTPPolicy.js","sourceRoot":"","sources":["../../../src/ProposalHTTPPolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EACL,eAAe,IAAI,mBAAmB,EACtC,YAAY,IAAI,gBAAgB,EAChC,sBAAsB,IAAI,0BAA0B,EACrD,MAAM,6BAA6B,CAAA;AAMpC,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC;QACV,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YACtB,OAAO,EAAE,oBAAoB,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;YAC/C,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;SACjC;KACF,CAAA;IACD,OAAO;QACL,UAAU,EAAE,4BAA4B,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAC3D,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;KAC7E,CAAA;AACH,CAAC;AACD,qGAAqG;AACrG,MAAM,UAAU,qBAAqB,CAAC,GAAa,EAAE,KAAc;IACjE,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,WAAW;QAAE,OAAM;IACjE,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IACxC,GAAG;SACA,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SAC1B,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC;SACvC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AACnC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ProposalHTTPPorts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProposalHTTPPorts.js","sourceRoot":"","sources":["../../../src/ProposalHTTPPorts.ts"],"names":[],"mappings":""}
@@ -0,0 +1,58 @@
1
+ import { guardAuthenticatedResponse } from '@bsv/auth-express-middleware';
2
+ import { OUTPUT_PROFILES, OutputProtocolError } from '@bsv/sdk';
3
+ import { proposalHTTPError } from './ProposalHTTPPolicy.js';
4
+ /** Current record/access and native enqueue share one gate after BRC-104 signing. */
5
+ export function guardProposalResponse(res, options) {
6
+ const { journal, authorizeControl } = options;
7
+ const caller = { ...options.caller };
8
+ const binding = 'binding' in options.initial ? options.initial.binding : undefined;
9
+ let control = 'error' in options.initial ? proposalHTTPError(options.initial.error) : undefined;
10
+ const controlHeaders = {
11
+ ...options.controlHeaders,
12
+ 'content-type': 'application/json',
13
+ 'cache-control': 'private, no-store',
14
+ 'x-content-type-options': 'nosniff',
15
+ 'x-bsv-overlay-capability': caller.capabilityDigest,
16
+ 'x-bsv-overlay-profile': OUTPUT_PROFILES.proposal
17
+ };
18
+ guardAuthenticatedResponse(res, async (candidate, enqueue, signal) => {
19
+ const data = candidate.attempt === 0 && binding !== undefined;
20
+ let attempted = false;
21
+ try {
22
+ await journal.enqueueResponse({ reference: data ? binding.reference : { kind: 'control' }, bytes: candidate.body }, (entry, bytes) => {
23
+ if (signal.aborted)
24
+ return false;
25
+ if (candidate.identityKey !== caller.caller ||
26
+ candidate.headers['x-bsv-overlay-capability'] !== caller.capabilityDigest ||
27
+ candidate.headers['x-bsv-overlay-profile'] !== OUTPUT_PROFILES.proposal)
28
+ throw new OutputProtocolError('unauthorized', 'Proposal response identity or selection changed');
29
+ if (data) {
30
+ if (candidate.statusCode !== 200)
31
+ throw new OutputProtocolError('invalid', 'Invalid proposal success status');
32
+ return binding.validate(entry, bytes, candidate.identityKey);
33
+ }
34
+ return (control !== undefined &&
35
+ candidate.statusCode === control.statusCode &&
36
+ bytes.length === control.body.length &&
37
+ bytes.every((byte, index) => byte === control.body[index]) &&
38
+ authorizeControl(candidate.identityKey) === true);
39
+ }, () => {
40
+ // An exception after native enqueue starts cannot establish non-delivery.
41
+ attempted = true;
42
+ enqueue();
43
+ return undefined;
44
+ });
45
+ if (!attempted)
46
+ throw new Error('Proposal journal did not enqueue the response.');
47
+ }
48
+ catch (error) {
49
+ if (attempted || signal.aborted || !data)
50
+ throw error;
51
+ control = proposalHTTPError(error);
52
+ // The signer receives a copy; its candidate must not mutate the bytes
53
+ // retained as the control authorization oracle for the second attempt.
54
+ return { ...control, body: control.body.slice(), headers: controlHeaders };
55
+ }
56
+ });
57
+ }
58
+ //# sourceMappingURL=ProposalResponseGuard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProposalResponseGuard.js","sourceRoot":"","sources":["../../../src/ProposalResponseGuard.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,237 @@
1
+ import express from 'express';
2
+ import { canonicalOutputBase, OUTPUT_PROFILES, outputHex32, outputIdentity, OutputProtocolError, parseOutputJSON } from '@bsv/sdk';
3
+ import { proposalHTTPCORS, proposalHTTPOrigins, proposalHTTPControlHeaders, proposalHTTPError, sendProposalHTTPError } from './ProposalHTTPPolicy.js';
4
+ import { guardProposalResponse } from './ProposalResponseGuard.js';
5
+ function bounded(value, maximum) {
6
+ if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
7
+ throw new TypeError('Invalid proposal HTTP capacity');
8
+ return value;
9
+ }
10
+ function headers(req) {
11
+ let bytes = 0;
12
+ const names = new Set();
13
+ for (let i = 0; i < req.rawHeaders.length; i += 2) {
14
+ const name = req.rawHeaders[i].toLowerCase();
15
+ bytes += Buffer.byteLength(name) + Buffer.byteLength(req.rawHeaders[i + 1]);
16
+ if (bytes > 16384)
17
+ throw new OutputProtocolError('limited', 'Proposal HTTP header bound');
18
+ if (names.has(name))
19
+ throw new OutputProtocolError('invalid', 'Duplicate proposal HTTP header');
20
+ names.add(name);
21
+ }
22
+ if (req.headers['content-encoding'] !== undefined &&
23
+ req.headers['content-encoding'] !== 'identity')
24
+ throw new OutputProtocolError('unsupported', 'Proposal requests require identity encoding');
25
+ }
26
+ class ProposalHTTPHandler {
27
+ options;
28
+ prefix;
29
+ origins;
30
+ raw;
31
+ maximum;
32
+ maximumWork;
33
+ perPrincipal;
34
+ timeoutMs;
35
+ requestBytes;
36
+ responseBytes;
37
+ activeRequests = 0;
38
+ activeWork = 0;
39
+ principals = new Map();
40
+ constructor(input) {
41
+ this.options = { ...input };
42
+ this.prefix =
43
+ new URL(canonicalOutputBase(input.baseURL)).pathname.replace(/\/$/, '') +
44
+ '/overlay/v1/proposals';
45
+ this.origins = proposalHTTPOrigins(input.allowedOrigins);
46
+ this.maximum = bounded(input.maximumRequests ?? 64, 4096);
47
+ this.maximumWork = bounded(input.maximumWork ?? 64, 4096);
48
+ this.perPrincipal = bounded(input.maximumWorkPerPrincipal ?? Math.min(4, this.maximumWork), this.maximumWork);
49
+ this.timeoutMs = bounded(input.requestTimeoutMs ?? 30000, 30000);
50
+ this.requestBytes = bounded(input.maximumRequestBytes ?? 1048576, 1048576);
51
+ this.responseBytes = bounded(input.maximumResponseBytes ?? 4194304, 4194304);
52
+ if (typeof input.authenticate !== 'function' ||
53
+ typeof input.authorizeControl !== 'function' ||
54
+ input.authorizeControl.constructor.name === 'AsyncFunction')
55
+ throw new TypeError('Proposal routes require authentication and synchronous control authorization');
56
+ if (input.journal.responseEnqueue !== 'proposal-journal-send/1')
57
+ throw new TypeError('Proposal routes require a durable native-enqueue journal');
58
+ this.raw = express.raw({ type: () => true, limit: this.requestBytes, inflate: false });
59
+ }
60
+ route(path) {
61
+ for (const operation of ['put', 'get', 'finalize'])
62
+ if (path === this.prefix + '/' + operation)
63
+ return operation;
64
+ if (this.options.handleHandshake !== false && path === '/.well-known/auth')
65
+ return 'handshake';
66
+ if (path.toLowerCase().startsWith(this.prefix.toLowerCase()))
67
+ return 'unknown';
68
+ return undefined;
69
+ }
70
+ handle = (req, res, next) => {
71
+ const route = this.route(req.path);
72
+ if (route === undefined) {
73
+ next();
74
+ return;
75
+ }
76
+ try {
77
+ if (!proposalHTTPCORS(req, res, this.origins))
78
+ return;
79
+ headers(req);
80
+ if (route === 'unknown')
81
+ throw new OutputProtocolError('not-found', 'Unknown proposal endpoint');
82
+ if (req.method !== 'POST' || req.url.includes('?'))
83
+ throw new OutputProtocolError('invalid', 'Invalid proposal method or query');
84
+ if (req.headers['content-type']?.split(';', 1)[0].trim().toLowerCase() !== 'application/json')
85
+ throw new OutputProtocolError('invalid', 'Proposal requests require JSON');
86
+ if (req.body !== undefined)
87
+ throw new OutputProtocolError('unsupported', 'Proposal routes must precede body parsers');
88
+ if (this.activeRequests >= this.maximum)
89
+ throw new OutputProtocolError('limited', 'Proposal HTTP capacity is full', true);
90
+ this.track(res);
91
+ this.raw(req, res, error => this.parsed(req, res, route, error));
92
+ }
93
+ catch (error) {
94
+ sendProposalHTTPError(res, error);
95
+ }
96
+ };
97
+ track(res) {
98
+ this.activeRequests++;
99
+ let released = false;
100
+ const timer = setTimeout(() => res.destroy(), this.timeoutMs);
101
+ timer.unref?.();
102
+ const release = () => {
103
+ if (released)
104
+ return;
105
+ released = true;
106
+ clearTimeout(timer);
107
+ this.activeRequests--;
108
+ res.removeListener('finish', release);
109
+ res.removeListener('close', release);
110
+ };
111
+ res.once('finish', release);
112
+ res.once('close', release);
113
+ }
114
+ parsed(req, res, route, error) {
115
+ try {
116
+ if (res.destroyed || req.aborted)
117
+ return;
118
+ if (error) {
119
+ const large = error instanceof Error &&
120
+ Object.getOwnPropertyDescriptor(error, 'type')?.value === 'entity.too.large';
121
+ throw new OutputProtocolError(large ? 'limited' : 'invalid', 'Invalid bounded proposal body');
122
+ }
123
+ if (!Buffer.isBuffer(req.body) || req.body.length === 0)
124
+ throw new OutputProtocolError('invalid', 'Missing proposal body bytes');
125
+ let text;
126
+ try {
127
+ text = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(req.body);
128
+ }
129
+ catch {
130
+ throw new OutputProtocolError('invalid', 'Invalid proposal UTF-8');
131
+ }
132
+ if (route === 'handshake')
133
+ req.body = parseOutputJSON(text, { bytes: this.requestBytes });
134
+ this.options.authenticate(req, res, error => {
135
+ if (res.destroyed || req.aborted || res.writableEnded)
136
+ return;
137
+ if (error || route === 'handshake') {
138
+ sendProposalHTTPError(res, error ?? new OutputProtocolError('unsupported', 'Handshake was not handled'));
139
+ return;
140
+ }
141
+ void this.execute(req, res, route, text).catch(error => sendProposalHTTPError(res, error));
142
+ });
143
+ }
144
+ catch (error) {
145
+ sendProposalHTTPError(res, error);
146
+ }
147
+ }
148
+ acquire(identity) {
149
+ const count = this.principals.get(identity) ?? 0;
150
+ if (this.activeWork >= this.maximumWork || count >= this.perPrincipal)
151
+ throw new OutputProtocolError('limited', 'Proposal service work capacity is full', true);
152
+ this.activeWork++;
153
+ this.principals.set(identity, count + 1);
154
+ return () => {
155
+ this.activeWork--;
156
+ const remaining = this.principals.get(identity) - 1;
157
+ if (remaining === 0)
158
+ this.principals.delete(identity);
159
+ else
160
+ this.principals.set(identity, remaining);
161
+ };
162
+ }
163
+ async execute(req, res, operation, text) {
164
+ const capabilityDigest = outputHex32(req.headers['x-bsv-overlay-capability']);
165
+ if (req.headers['x-bsv-overlay-profile'] !== OUTPUT_PROFILES.proposal)
166
+ throw new OutputProtocolError('unsupported', 'Proposal profile was not selected');
167
+ if (req.headers['cache-control'] !== 'no-store')
168
+ throw new OutputProtocolError('invalid', 'Proposal requests require no-store');
169
+ const identity = req.auth?.identityKey;
170
+ if (identity === undefined || identity === 'unknown')
171
+ throw new OutputProtocolError('unauthorized', 'Proposal requires authenticated identity');
172
+ const caller = Object.freeze({
173
+ caller: outputIdentity(identity),
174
+ capabilityDigest
175
+ });
176
+ res.set({
177
+ 'x-bsv-overlay-capability': capabilityDigest,
178
+ 'x-bsv-overlay-profile': OUTPUT_PROFILES.proposal
179
+ });
180
+ let release;
181
+ let installed = false;
182
+ try {
183
+ if (req.aborted || res.destroyed)
184
+ return;
185
+ release = this.acquire(caller.caller);
186
+ const value = await this.options.service[operation](text, caller);
187
+ if (req.aborted || res.destroyed || res.writableEnded)
188
+ return;
189
+ const binding = this.options.disclosure.bind(operation, text, value, caller);
190
+ if (typeof binding.body !== 'string' || Buffer.byteLength(binding.body) > this.responseBytes)
191
+ throw new OutputProtocolError('limited', 'Proposal response exceeds HTTP capacity');
192
+ guardProposalResponse(res, {
193
+ journal: this.options.journal,
194
+ caller,
195
+ initial: { binding },
196
+ authorizeControl: this.options.authorizeControl,
197
+ controlHeaders: proposalHTTPControlHeaders(res)
198
+ });
199
+ installed = true;
200
+ res.status(200).set('content-type', 'application/json').end(binding.body);
201
+ }
202
+ catch (error) {
203
+ if (res.destroyed || res.writableEnded || req.aborted)
204
+ return;
205
+ if (installed) {
206
+ res.destroy();
207
+ return;
208
+ }
209
+ guardProposalResponse(res, {
210
+ journal: this.options.journal,
211
+ caller,
212
+ initial: { error },
213
+ authorizeControl: this.options.authorizeControl,
214
+ controlHeaders: proposalHTTPControlHeaders(res)
215
+ });
216
+ const control = proposalHTTPError(error);
217
+ res
218
+ .status(control.statusCode)
219
+ .set('content-type', 'application/json')
220
+ .end(Buffer.from(control.body));
221
+ }
222
+ finally {
223
+ // Disconnects/deadlines do not release capacity while service work still runs.
224
+ // A committed operation is recovered by its original identity, never undone here.
225
+ release?.();
226
+ }
227
+ }
228
+ }
229
+ /**
230
+ * Optional BRC-194 endpoints; mount before parsers, compression, caches or body logs.
231
+ * Hosts own TLS, pre-authentication rate limits, bounded authentication/signing,
232
+ * capability publication and expiry workers. Recording never invokes a wallet.
233
+ */
234
+ export function createProposalRouter(options) {
235
+ return express.Router().use(new ProposalHTTPHandler(options).handle);
236
+ }
237
+ //# sourceMappingURL=ProposalRoutes.js.map