brass-runtime 1.15.0 → 1.16.1

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/CHANGELOG.md +17 -0
  2. package/README.md +673 -136
  3. package/dist/agent/cli/main.cjs +40 -35
  4. package/dist/agent/cli/main.js +9 -4
  5. package/dist/agent/cli/main.mjs +9 -4
  6. package/dist/agent/index.cjs +8 -4
  7. package/dist/agent/index.d.ts +1 -1
  8. package/dist/agent/index.js +7 -3
  9. package/dist/agent/index.mjs +7 -3
  10. package/dist/chunk-2HQTDLHF.mjs +683 -0
  11. package/dist/chunk-36I3M4UC.mjs +370 -0
  12. package/dist/chunk-3AYM6WPJ.js +1629 -0
  13. package/dist/chunk-3LOYJFRR.cjs +300 -0
  14. package/dist/chunk-3RG5ZIWI.js +10 -0
  15. package/dist/chunk-3Y2RIUMM.js +300 -0
  16. package/dist/{chunk-VEZNF5GZ.cjs → chunk-4ROBZFL6.cjs} +130 -126
  17. package/dist/{chunk-3QMOKAS5.js → chunk-52OB2ROS.js} +9 -5
  18. package/dist/chunk-52PPNNI4.cjs +416 -0
  19. package/dist/chunk-5EC274J5.cjs +2874 -0
  20. package/dist/chunk-5QC7LRZ3.js +229 -0
  21. package/dist/chunk-5VRJNBLZ.mjs +2874 -0
  22. package/dist/chunk-62AZW6UT.cjs +313 -0
  23. package/dist/chunk-6IXXWIUM.js +683 -0
  24. package/dist/chunk-74ZTY6CP.js +2871 -0
  25. package/dist/chunk-76YMRMH2.cjs +777 -0
  26. package/dist/chunk-7CMJS3QE.mjs +2871 -0
  27. package/dist/{chunk-4NHES7VK.mjs → chunk-7JIJOVCT.js} +27 -13
  28. package/dist/chunk-A2OM6NEH.mjs +194 -0
  29. package/dist/chunk-AGR5B2BC.cjs +683 -0
  30. package/dist/chunk-AVNQLJ5V.js +777 -0
  31. package/dist/chunk-B33ICAKP.js +313 -0
  32. package/dist/{chunk-ELOOF35R.mjs → chunk-B5JD23U7.mjs} +1 -1
  33. package/dist/chunk-BABBZK4Y.js +2024 -0
  34. package/dist/chunk-C3MDXTRZ.js +354 -0
  35. package/dist/chunk-CIZFIMK5.js +2193 -0
  36. package/dist/chunk-CZIVE6NT.cjs +354 -0
  37. package/dist/chunk-DNFJLJMW.mjs +354 -0
  38. package/dist/chunk-DNFO2EIZ.mjs +777 -0
  39. package/dist/chunk-EJ6BPYVR.mjs +416 -0
  40. package/dist/chunk-ENKODRU3.cjs +2193 -0
  41. package/dist/chunk-EOC4UHBS.mjs +229 -0
  42. package/dist/{chunk-BMH5AV44.js → chunk-FH2X7BVP.js} +756 -440
  43. package/dist/{chunk-PPUXIH5R.js → chunk-FHQGHPMO.mjs} +27 -13
  44. package/dist/{chunk-TGIFUAK4.cjs → chunk-GLE2WY7Z.cjs} +951 -635
  45. package/dist/{chunk-BDF4AMWX.mjs → chunk-GYM3LLGS.mjs} +756 -440
  46. package/dist/chunk-HLWLMW2F.mjs +2024 -0
  47. package/dist/chunk-JF5WGYJJ.cjs +194 -0
  48. package/dist/chunk-KH4SYAOS.mjs +1629 -0
  49. package/dist/chunk-KN32XNTH.mjs +313 -0
  50. package/dist/chunk-KQLYONSE.cjs +2871 -0
  51. package/dist/{chunk-STVLQ3XD.cjs → chunk-KZJQ723N.cjs} +92 -78
  52. package/dist/chunk-L2SYFEBS.js +194 -0
  53. package/dist/chunk-L6VB5N7Q.cjs +104 -0
  54. package/dist/{chunk-K6M7MDZ4.mjs → chunk-MBEJI5HF.mjs} +9 -5
  55. package/dist/chunk-MIIYDLGM.js +2874 -0
  56. package/dist/chunk-MOO4L7F4.mjs +104 -0
  57. package/dist/chunk-MT3OWDPC.mjs +2193 -0
  58. package/dist/chunk-MVGUEJ5Z.cjs +370 -0
  59. package/dist/chunk-OBGZSXTJ.cjs +10 -0
  60. package/dist/chunk-PD4EJTQC.cjs +229 -0
  61. package/dist/chunk-PWC3RBQE.mjs +300 -0
  62. package/dist/chunk-Q2I37RP3.cjs +1629 -0
  63. package/dist/chunk-RKGKFN2A.js +416 -0
  64. package/dist/{chunk-R3R2FVLG.cjs → chunk-SA6HUJVI.cjs} +5 -5
  65. package/dist/chunk-TRM4JUZQ.js +104 -0
  66. package/dist/chunk-UB4B6OFY.js +370 -0
  67. package/dist/{chunk-TO7IKXYT.js → chunk-UCUBNWM2.js} +1 -1
  68. package/dist/chunk-VN44DYYT.cjs +2024 -0
  69. package/dist/chunk-Y6FXYEAI.mjs +10 -0
  70. package/dist/client-CZHU674n.d.ts +820 -0
  71. package/dist/core/index.cjs +198 -4
  72. package/dist/core/index.d.ts +311 -212
  73. package/dist/core/index.js +237 -43
  74. package/dist/core/index.mjs +237 -43
  75. package/dist/{effect-CMOQKX8y.d.ts → effect-DIUHZ9IN.d.ts} +195 -1
  76. package/dist/effectRunner-CFLC32IK.cjs +8 -0
  77. package/dist/effectRunner-L4S7IPT3.js +8 -0
  78. package/dist/effectRunner-NNGG75QA.mjs +8 -0
  79. package/dist/http/index.cjs +1227 -2971
  80. package/dist/http/index.d.ts +826 -280
  81. package/dist/http/index.js +1089 -2833
  82. package/dist/http/index.mjs +1089 -2833
  83. package/dist/http/testing.cjs +161 -0
  84. package/dist/http/testing.d.ts +43 -0
  85. package/dist/http/testing.js +161 -0
  86. package/dist/http/testing.mjs +161 -0
  87. package/dist/index.cjs +486 -250
  88. package/dist/index.d.ts +87 -95
  89. package/dist/index.js +391 -155
  90. package/dist/index.mjs +391 -155
  91. package/dist/observability/index.cjs +162 -0
  92. package/dist/observability/index.d.ts +152 -0
  93. package/dist/observability/index.js +162 -0
  94. package/dist/observability/index.mjs +162 -0
  95. package/dist/perf/cli.cjs +401 -0
  96. package/dist/perf/cli.d.ts +1 -0
  97. package/dist/perf/cli.js +401 -0
  98. package/dist/perf/cli.mjs +401 -0
  99. package/dist/perf/index.cjs +141 -0
  100. package/dist/perf/index.d.ts +483 -0
  101. package/dist/perf/index.js +141 -0
  102. package/dist/perf/index.mjs +141 -0
  103. package/dist/schedule-CK3Ml_7p.d.ts +259 -0
  104. package/dist/schema/index.cjs +29 -0
  105. package/dist/schema/index.d.ts +179 -0
  106. package/dist/schema/index.js +29 -0
  107. package/dist/schema/index.mjs +29 -0
  108. package/dist/server-GJPg8ZSG.d.ts +675 -0
  109. package/dist/{stream-FQm9h4Mg.d.ts → stream-B4oK9JFP.d.ts} +1 -1
  110. package/dist/tracer-Hwt1cl7h.d.ts +189 -0
  111. package/dist/tracing-DqbTKGcf.d.ts +148 -0
  112. package/docs/ARCHITECTURE.md +292 -0
  113. package/docs/README.md +63 -0
  114. package/docs/adr/0001-ai-context-pack.md +32 -0
  115. package/docs/agent-apply-mode.md +104 -0
  116. package/docs/agent-approvals.md +110 -0
  117. package/docs/agent-batch.md +185 -0
  118. package/docs/agent-boundaries.md +112 -0
  119. package/docs/agent-chat-sessions.md +160 -0
  120. package/docs/agent-ci.md +17 -0
  121. package/docs/agent-cli.md +405 -0
  122. package/docs/agent-config.md +480 -0
  123. package/docs/agent-context-discovery.md +159 -0
  124. package/docs/agent-copilot-like-dx.md +126 -0
  125. package/docs/agent-declarative-optimized-planning.md +138 -0
  126. package/docs/agent-dx.md +224 -0
  127. package/docs/agent-env-files.md +126 -0
  128. package/docs/agent-follow-up-context.md +43 -0
  129. package/docs/agent-global-usage.md +180 -0
  130. package/docs/agent-init.md +109 -0
  131. package/docs/agent-install-and-configure.md +516 -0
  132. package/docs/agent-language-workspace-ux.md +99 -0
  133. package/docs/agent-llm-adapters.md +123 -0
  134. package/docs/agent-local-install.md +190 -0
  135. package/docs/agent-local-tests.md +51 -0
  136. package/docs/agent-observability.md +155 -0
  137. package/docs/agent-patch-quality-loop.md +162 -0
  138. package/docs/agent-presets.md +22 -0
  139. package/docs/agent-project-commands.md +237 -0
  140. package/docs/agent-project-intelligence.md +156 -0
  141. package/docs/agent-redaction.md +18 -0
  142. package/docs/agent-release-readiness.md +76 -0
  143. package/docs/agent-rollback-safety.md +162 -0
  144. package/docs/agent-rollback.md +23 -0
  145. package/docs/agent-run-artifacts.md +16 -0
  146. package/docs/agent-vscode-auto-discovery.md +137 -0
  147. package/docs/agent-vscode-batch-runner.md +100 -0
  148. package/docs/agent-vscode-chat-layout.md +90 -0
  149. package/docs/agent-vscode-clean-install.md +147 -0
  150. package/docs/agent-vscode-code-actions.md +70 -0
  151. package/docs/agent-vscode-diff-preview.md +45 -0
  152. package/docs/agent-vscode-inline-assist.md +56 -0
  153. package/docs/agent-vscode-install.md +186 -0
  154. package/docs/agent-vscode-model-setup.md +97 -0
  155. package/docs/agent-vscode-patch-preview.md +92 -0
  156. package/docs/agent-vscode-problems.md +79 -0
  157. package/docs/agent-vscode-project-dashboard.md +106 -0
  158. package/docs/agent-vscode-run-history.md +92 -0
  159. package/docs/agent-vscode-ux.md +73 -0
  160. package/docs/ai/INVARIANTS.md +84 -0
  161. package/docs/ai/PROJECT_MAP.md +338 -0
  162. package/docs/ai/PUBLIC_API.md +336 -0
  163. package/docs/ai/VALIDATION_MATRIX.md +67 -0
  164. package/docs/api-polish.md +37 -0
  165. package/docs/cancellation.md +162 -0
  166. package/docs/coverage.md +46 -0
  167. package/docs/getting-started.md +159 -0
  168. package/docs/guides/README.md +40 -0
  169. package/docs/guides/circuit-breaker.md +89 -0
  170. package/docs/guides/error-handling.md +91 -0
  171. package/docs/guides/getting-started.md +107 -0
  172. package/docs/guides/layers.md +189 -0
  173. package/docs/guides/metrics.md +101 -0
  174. package/docs/guides/resource-management.md +141 -0
  175. package/docs/guides/retry.md +215 -0
  176. package/docs/guides/semaphore.md +66 -0
  177. package/docs/guides/streams.md +117 -0
  178. package/docs/guides/supervisors.md +98 -0
  179. package/docs/guides/testing.md +162 -0
  180. package/docs/guides/tracing.md +71 -0
  181. package/docs/http-recipes.md +399 -0
  182. package/docs/http.md +749 -0
  183. package/docs/modules.md +285 -0
  184. package/docs/observability-collector-smoke.md +31 -0
  185. package/docs/observability-framework-examples.md +98 -0
  186. package/docs/observability.md +542 -0
  187. package/docs/otel-collector-smoke.yaml +27 -0
  188. package/docs/performance-profiler.md +199 -0
  189. package/docs/production-readiness.md +73 -0
  190. package/docs/recipes/README.md +12 -0
  191. package/docs/recipes/http-server.md +45 -0
  192. package/docs/recipes/layers.md +44 -0
  193. package/docs/recipes/performance.md +47 -0
  194. package/docs/recipes/runtime.md +41 -0
  195. package/docs/recipes/testing.md +41 -0
  196. package/docs/release.md +53 -0
  197. package/docs/wasm-bounded-queues.md +44 -0
  198. package/docs/wasm-engine-observability-benchmarks.md +85 -0
  199. package/docs/wasm-fiber-engine.md +117 -0
  200. package/docs/wasm-scheduler-state-machine.md +122 -0
  201. package/docs/wasm-stream-chunks.md +54 -0
  202. package/package.json +48 -2
  203. package/dist/chunk-AR22SXML.js +0 -1043
  204. package/dist/chunk-BDYEENHT.js +0 -224
  205. package/dist/chunk-JFPU5GQI.mjs +0 -1043
  206. package/dist/chunk-MS34J5LY.cjs +0 -224
  207. package/dist/chunk-UMAZLXAB.mjs +0 -224
  208. package/dist/chunk-XPZNXSVN.cjs +0 -1043
  209. package/dist/tracing-DNT9jEbr.d.ts +0 -106
@@ -0,0 +1,300 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
2
+
3
+
4
+ var _chunkMVGUEJ5Zcjs = require('./chunk-MVGUEJ5Z.cjs');
5
+
6
+ // src/http/requestPolicy.ts
7
+ var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
8
+ var isPolicyObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
9
+ var defineHttpPolicyPresets = (presets) => presets;
10
+ var httpPolicy = Object.freeze({
11
+ preset: (preset, overrides = {}) => ({
12
+ preset,
13
+ ...overrides
14
+ }),
15
+ lane: (lane, overrides = {}) => ({
16
+ preset: lane,
17
+ lane,
18
+ ...overrides
19
+ }),
20
+ define: defineHttpPolicyPresets
21
+ });
22
+ var getHttpRequestPolicy = (req, options = {}) => {
23
+ const legacy = req;
24
+ const source = req.policy;
25
+ const sourcePolicy = resolvePolicySource(req, source, options.presets);
26
+ const policy = {
27
+ ...legacy.lane !== void 0 ? { lane: legacy.lane } : {},
28
+ ...legacy.dedupKey !== void 0 ? { dedupKey: legacy.dedupKey } : {},
29
+ ...legacy.priority !== void 0 ? { priority: legacy.priority } : {},
30
+ ...legacy.retry !== void 0 ? { retry: legacy.retry } : {},
31
+ ...req.poolKey !== void 0 ? { poolKey: req.poolKey } : {},
32
+ ...sourcePolicy
33
+ };
34
+ return policy;
35
+ };
36
+ var withHttpRequestPolicy = (req, patch) => {
37
+ const current = getHttpRequestPolicy(req);
38
+ const next = {
39
+ ...req,
40
+ policy: {
41
+ ...current,
42
+ ...patch
43
+ }
44
+ };
45
+ if (hasOwn(patch, "poolKey")) {
46
+ next.poolKey = patch.poolKey;
47
+ }
48
+ if (hasOwn(patch, "lane")) {
49
+ next.lane = patch.lane;
50
+ }
51
+ if (hasOwn(patch, "dedupKey")) {
52
+ next.dedupKey = patch.dedupKey;
53
+ }
54
+ if (hasOwn(patch, "priority")) {
55
+ next.priority = patch.priority;
56
+ }
57
+ if (hasOwn(patch, "retry")) {
58
+ next.retry = patch.retry;
59
+ }
60
+ return next;
61
+ };
62
+ var resolveHttpRequestPolicyPresets = (req, presets) => {
63
+ const policy = getHttpRequestPolicy(req, { presets });
64
+ return withHttpRequestPolicy({ ...req, policy }, policy);
65
+ };
66
+ var withHttpPolicyPresets = (presets) => {
67
+ return (next) => (req) => _chunkMVGUEJ5Zcjs.asyncFlatMap.call(void 0,
68
+ _chunkMVGUEJ5Zcjs.asyncSync.call(void 0, () => resolveHttpRequestPolicyPresets(req, presets)),
69
+ (resolved) => next(resolved)
70
+ );
71
+ };
72
+ function resolvePolicySource(req, source, presets) {
73
+ if (typeof source === "string") {
74
+ return resolveNamedPolicy(req, source, {}, presets);
75
+ }
76
+ if (!isPolicyObject(source)) return {};
77
+ if (!source.preset) return source;
78
+ return resolveNamedPolicy(req, source.preset, source, presets);
79
+ }
80
+ function resolveNamedPolicy(req, presetName, overrides, presets) {
81
+ const named = _optionalChain([presets, 'optionalAccess', _ => _[presetName]]);
82
+ const resolved = typeof named === "function" ? named(req, presetName) : named;
83
+ return {
84
+ lane: presetName,
85
+ ...isPolicyObject(resolved) ? resolved : {},
86
+ ...overrides,
87
+ preset: presetName
88
+ };
89
+ }
90
+
91
+ // src/http/errors.ts
92
+ var HTTP_ERROR_TAGS = /* @__PURE__ */ new Set([
93
+ "Abort",
94
+ "BadUrl",
95
+ "FetchError",
96
+ "Timeout",
97
+ "PoolRejected",
98
+ "PoolTimeout",
99
+ "PoolClosed",
100
+ "BatchSplitError"
101
+ ]);
102
+ var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
103
+ var TIMEOUT_CODES = /* @__PURE__ */ new Set([
104
+ "ECONNABORTED",
105
+ "ETIMEDOUT",
106
+ "ESOCKETTIMEDOUT",
107
+ "UND_ERR_CONNECT_TIMEOUT",
108
+ "UND_ERR_HEADERS_TIMEOUT",
109
+ "UND_ERR_BODY_TIMEOUT"
110
+ ]);
111
+ var ABORT_CODES = /* @__PURE__ */ new Set(["ERR_CANCELED", "ABORT_ERR"]);
112
+ function isHttpError(error) {
113
+ return hasTag(error) && HTTP_ERROR_TAGS.has(error._tag);
114
+ }
115
+ function isValidationError(error) {
116
+ return hasTag(error) && error._tag === "ValidationError";
117
+ }
118
+ function isCircuitBreakerOpen(error) {
119
+ return hasTag(error) && error._tag === "CircuitBreakerOpen";
120
+ }
121
+ function isKnownHttpError(error) {
122
+ return isHttpError(error) || isValidationError(error) || isCircuitBreakerOpen(error);
123
+ }
124
+ function isAbortHttpError(error) {
125
+ return isHttpError(error) && error._tag === "Abort";
126
+ }
127
+ function isTimeoutHttpError(error) {
128
+ return isHttpError(error) && (error._tag === "Timeout" || error._tag === "PoolTimeout");
129
+ }
130
+ function isFetchHttpError(error) {
131
+ return isHttpError(error) && error._tag === "FetchError";
132
+ }
133
+ function httpErrorStatus(error) {
134
+ if (!isFetchHttpError(error)) return void 0;
135
+ return typeof error.status === "number" && Number.isFinite(error.status) ? error.status : void 0;
136
+ }
137
+ function isRetryableHttpStatus(status) {
138
+ return RETRYABLE_STATUS.has(status);
139
+ }
140
+ function isRetryableHttpError(error, options = {}) {
141
+ if (!isHttpError(error)) return false;
142
+ switch (error._tag) {
143
+ case "Timeout":
144
+ case "PoolTimeout":
145
+ return true;
146
+ case "FetchError": {
147
+ const status = httpErrorStatus(error);
148
+ if (status !== void 0) return (_nullishCoalesce(options.retryOnStatus, () => ( isRetryableHttpStatus)))(status);
149
+ return true;
150
+ }
151
+ default:
152
+ return false;
153
+ }
154
+ }
155
+ function isExternalAbortError(error) {
156
+ if (typeof error !== "object" || error === null) return false;
157
+ const record = error;
158
+ return record.name === "AbortError" || ABORT_CODES.has(String(_nullishCoalesce(record.code, () => ( ""))));
159
+ }
160
+ function isExternalTimeoutError(error) {
161
+ if (typeof error !== "object" || error === null) return false;
162
+ const record = error;
163
+ return record.name === "TimeoutError" || TIMEOUT_CODES.has(String(_nullishCoalesce(record.code, () => ( ""))));
164
+ }
165
+ function toHttpError(error, options = {}) {
166
+ if (isHttpError(error)) return error;
167
+ if (_optionalChain([options, 'access', _2 => _2.signal, 'optionalAccess', _3 => _3.aborted]) || isExternalAbortError(error)) {
168
+ return { _tag: "Abort" };
169
+ }
170
+ const status = externalStatus(error);
171
+ const statusText = externalStatusText(error);
172
+ const code = externalCode(error);
173
+ const message = resolveMessage(error, options.message);
174
+ if (isExternalTimeoutError(error)) {
175
+ return {
176
+ _tag: "Timeout",
177
+ timeoutMs: _nullishCoalesce(options.timeoutMs, () => ( 0)),
178
+ phase: _nullishCoalesce(options.phase, () => ( "request")),
179
+ message
180
+ };
181
+ }
182
+ return {
183
+ _tag: "FetchError",
184
+ message,
185
+ ...code !== void 0 ? { code } : {},
186
+ ...status !== void 0 ? { status } : {},
187
+ ...statusText !== void 0 ? { statusText } : {},
188
+ ...retryAfterMsFromExternal(error) !== void 0 ? { retryAfterMs: retryAfterMsFromExternal(error) } : {},
189
+ cause: error
190
+ };
191
+ }
192
+ function matchHttpError(error, handlers) {
193
+ if (isKnownHttpError(error)) {
194
+ const handler = handlers[error._tag];
195
+ if (handler) return handler(error);
196
+ }
197
+ return _optionalChain([handlers, 'access', _4 => _4.default, 'optionalCall', _5 => _5(error)]);
198
+ }
199
+ function formatHttpError(error) {
200
+ if (isValidationError(error)) {
201
+ const phase = error.phase ? `${error.phase} ` : "";
202
+ return `${phase}validation failed: ${error.message}`;
203
+ }
204
+ if (isCircuitBreakerOpen(error)) {
205
+ return `Circuit breaker is open after ${error.failures} failure(s)`;
206
+ }
207
+ if (!isHttpError(error)) {
208
+ return error instanceof Error ? error.message : String(error);
209
+ }
210
+ switch (error._tag) {
211
+ case "Abort":
212
+ return "HTTP request aborted";
213
+ case "BadUrl":
214
+ case "PoolRejected":
215
+ case "PoolTimeout":
216
+ case "PoolClosed":
217
+ case "BatchSplitError":
218
+ return error.message;
219
+ case "FetchError":
220
+ return formatFetchError(error);
221
+ case "Timeout":
222
+ return error.message;
223
+ }
224
+ }
225
+ function hasTag(error) {
226
+ return typeof error === "object" && error !== null && typeof error._tag === "string";
227
+ }
228
+ function externalCode(error) {
229
+ if (typeof error !== "object" || error === null) return void 0;
230
+ const code = error.code;
231
+ return typeof code === "string" && code.length > 0 ? code : void 0;
232
+ }
233
+ function externalStatus(error) {
234
+ if (typeof error !== "object" || error === null) return void 0;
235
+ const record = error;
236
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
237
+ const status = _nullishCoalesce(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _6 => _6.status]), () => ( record.status)), () => ( record.statusCode));
238
+ return typeof status === "number" && Number.isFinite(status) ? status : void 0;
239
+ }
240
+ function externalStatusText(error) {
241
+ if (typeof error !== "object" || error === null) return void 0;
242
+ const record = error;
243
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
244
+ const statusText = _nullishCoalesce(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _7 => _7.statusText]), () => ( record.statusText)), () => ( record.statusMessage));
245
+ return typeof statusText === "string" && statusText.length > 0 ? statusText : void 0;
246
+ }
247
+ function retryAfterMsFromExternal(error) {
248
+ if (typeof error !== "object" || error === null) return void 0;
249
+ const record = error;
250
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
251
+ const headers = _nullishCoalesce(_optionalChain([response, 'optionalAccess', _8 => _8.headers]), () => ( record.headers));
252
+ if (typeof headers !== "object" || headers === null) return void 0;
253
+ const headerRecord = headers;
254
+ const raw = _nullishCoalesce(headerRecord["retry-after"], () => ( headerRecord["Retry-After"]));
255
+ if (raw === void 0 || raw === null) return void 0;
256
+ const seconds = Number(raw);
257
+ if (Number.isFinite(seconds)) return Math.max(0, Math.floor(seconds * 1e3));
258
+ const dateMs = Date.parse(String(raw));
259
+ return Number.isFinite(dateMs) ? Math.max(0, dateMs - Date.now()) : void 0;
260
+ }
261
+ function resolveMessage(error, message) {
262
+ if (typeof message === "function") return message(error);
263
+ if (typeof message === "string") return message;
264
+ if (error instanceof Error && error.message) return error.message;
265
+ if (typeof error === "object" && error !== null) {
266
+ const value = error.message;
267
+ if (typeof value === "string" && value.length > 0) return value;
268
+ }
269
+ return String(error);
270
+ }
271
+ function formatFetchError(error) {
272
+ const status = httpErrorStatus(error);
273
+ if (status === void 0) return error.message;
274
+ const statusText = error.statusText ? ` ${error.statusText}` : "";
275
+ return `HTTP ${status}${statusText}: ${error.message}`;
276
+ }
277
+
278
+
279
+
280
+
281
+
282
+
283
+
284
+
285
+
286
+
287
+
288
+
289
+
290
+
291
+
292
+
293
+
294
+
295
+
296
+
297
+
298
+
299
+
300
+ exports.defineHttpPolicyPresets = defineHttpPolicyPresets; exports.httpPolicy = httpPolicy; exports.getHttpRequestPolicy = getHttpRequestPolicy; exports.withHttpRequestPolicy = withHttpRequestPolicy; exports.resolveHttpRequestPolicyPresets = resolveHttpRequestPolicyPresets; exports.withHttpPolicyPresets = withHttpPolicyPresets; exports.isHttpError = isHttpError; exports.isValidationError = isValidationError; exports.isCircuitBreakerOpen = isCircuitBreakerOpen; exports.isKnownHttpError = isKnownHttpError; exports.isAbortHttpError = isAbortHttpError; exports.isTimeoutHttpError = isTimeoutHttpError; exports.isFetchHttpError = isFetchHttpError; exports.httpErrorStatus = httpErrorStatus; exports.isRetryableHttpStatus = isRetryableHttpStatus; exports.isRetryableHttpError = isRetryableHttpError; exports.isExternalAbortError = isExternalAbortError; exports.isExternalTimeoutError = isExternalTimeoutError; exports.toHttpError = toHttpError; exports.matchHttpError = matchHttpError; exports.formatHttpError = formatHttpError;
@@ -0,0 +1,10 @@
1
+ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
2
+ get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
3
+ }) : x)(function(x) {
4
+ if (typeof require !== "undefined") return require.apply(this, arguments);
5
+ throw Error('Dynamic require of "' + x + '" is not supported');
6
+ });
7
+
8
+ export {
9
+ __require
10
+ };
@@ -0,0 +1,300 @@
1
+ import {
2
+ asyncFlatMap,
3
+ asyncSync
4
+ } from "./chunk-UB4B6OFY.js";
5
+
6
+ // src/http/requestPolicy.ts
7
+ var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
8
+ var isPolicyObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
9
+ var defineHttpPolicyPresets = (presets) => presets;
10
+ var httpPolicy = Object.freeze({
11
+ preset: (preset, overrides = {}) => ({
12
+ preset,
13
+ ...overrides
14
+ }),
15
+ lane: (lane, overrides = {}) => ({
16
+ preset: lane,
17
+ lane,
18
+ ...overrides
19
+ }),
20
+ define: defineHttpPolicyPresets
21
+ });
22
+ var getHttpRequestPolicy = (req, options = {}) => {
23
+ const legacy = req;
24
+ const source = req.policy;
25
+ const sourcePolicy = resolvePolicySource(req, source, options.presets);
26
+ const policy = {
27
+ ...legacy.lane !== void 0 ? { lane: legacy.lane } : {},
28
+ ...legacy.dedupKey !== void 0 ? { dedupKey: legacy.dedupKey } : {},
29
+ ...legacy.priority !== void 0 ? { priority: legacy.priority } : {},
30
+ ...legacy.retry !== void 0 ? { retry: legacy.retry } : {},
31
+ ...req.poolKey !== void 0 ? { poolKey: req.poolKey } : {},
32
+ ...sourcePolicy
33
+ };
34
+ return policy;
35
+ };
36
+ var withHttpRequestPolicy = (req, patch) => {
37
+ const current = getHttpRequestPolicy(req);
38
+ const next = {
39
+ ...req,
40
+ policy: {
41
+ ...current,
42
+ ...patch
43
+ }
44
+ };
45
+ if (hasOwn(patch, "poolKey")) {
46
+ next.poolKey = patch.poolKey;
47
+ }
48
+ if (hasOwn(patch, "lane")) {
49
+ next.lane = patch.lane;
50
+ }
51
+ if (hasOwn(patch, "dedupKey")) {
52
+ next.dedupKey = patch.dedupKey;
53
+ }
54
+ if (hasOwn(patch, "priority")) {
55
+ next.priority = patch.priority;
56
+ }
57
+ if (hasOwn(patch, "retry")) {
58
+ next.retry = patch.retry;
59
+ }
60
+ return next;
61
+ };
62
+ var resolveHttpRequestPolicyPresets = (req, presets) => {
63
+ const policy = getHttpRequestPolicy(req, { presets });
64
+ return withHttpRequestPolicy({ ...req, policy }, policy);
65
+ };
66
+ var withHttpPolicyPresets = (presets) => {
67
+ return (next) => (req) => asyncFlatMap(
68
+ asyncSync(() => resolveHttpRequestPolicyPresets(req, presets)),
69
+ (resolved) => next(resolved)
70
+ );
71
+ };
72
+ function resolvePolicySource(req, source, presets) {
73
+ if (typeof source === "string") {
74
+ return resolveNamedPolicy(req, source, {}, presets);
75
+ }
76
+ if (!isPolicyObject(source)) return {};
77
+ if (!source.preset) return source;
78
+ return resolveNamedPolicy(req, source.preset, source, presets);
79
+ }
80
+ function resolveNamedPolicy(req, presetName, overrides, presets) {
81
+ const named = presets?.[presetName];
82
+ const resolved = typeof named === "function" ? named(req, presetName) : named;
83
+ return {
84
+ lane: presetName,
85
+ ...isPolicyObject(resolved) ? resolved : {},
86
+ ...overrides,
87
+ preset: presetName
88
+ };
89
+ }
90
+
91
+ // src/http/errors.ts
92
+ var HTTP_ERROR_TAGS = /* @__PURE__ */ new Set([
93
+ "Abort",
94
+ "BadUrl",
95
+ "FetchError",
96
+ "Timeout",
97
+ "PoolRejected",
98
+ "PoolTimeout",
99
+ "PoolClosed",
100
+ "BatchSplitError"
101
+ ]);
102
+ var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
103
+ var TIMEOUT_CODES = /* @__PURE__ */ new Set([
104
+ "ECONNABORTED",
105
+ "ETIMEDOUT",
106
+ "ESOCKETTIMEDOUT",
107
+ "UND_ERR_CONNECT_TIMEOUT",
108
+ "UND_ERR_HEADERS_TIMEOUT",
109
+ "UND_ERR_BODY_TIMEOUT"
110
+ ]);
111
+ var ABORT_CODES = /* @__PURE__ */ new Set(["ERR_CANCELED", "ABORT_ERR"]);
112
+ function isHttpError(error) {
113
+ return hasTag(error) && HTTP_ERROR_TAGS.has(error._tag);
114
+ }
115
+ function isValidationError(error) {
116
+ return hasTag(error) && error._tag === "ValidationError";
117
+ }
118
+ function isCircuitBreakerOpen(error) {
119
+ return hasTag(error) && error._tag === "CircuitBreakerOpen";
120
+ }
121
+ function isKnownHttpError(error) {
122
+ return isHttpError(error) || isValidationError(error) || isCircuitBreakerOpen(error);
123
+ }
124
+ function isAbortHttpError(error) {
125
+ return isHttpError(error) && error._tag === "Abort";
126
+ }
127
+ function isTimeoutHttpError(error) {
128
+ return isHttpError(error) && (error._tag === "Timeout" || error._tag === "PoolTimeout");
129
+ }
130
+ function isFetchHttpError(error) {
131
+ return isHttpError(error) && error._tag === "FetchError";
132
+ }
133
+ function httpErrorStatus(error) {
134
+ if (!isFetchHttpError(error)) return void 0;
135
+ return typeof error.status === "number" && Number.isFinite(error.status) ? error.status : void 0;
136
+ }
137
+ function isRetryableHttpStatus(status) {
138
+ return RETRYABLE_STATUS.has(status);
139
+ }
140
+ function isRetryableHttpError(error, options = {}) {
141
+ if (!isHttpError(error)) return false;
142
+ switch (error._tag) {
143
+ case "Timeout":
144
+ case "PoolTimeout":
145
+ return true;
146
+ case "FetchError": {
147
+ const status = httpErrorStatus(error);
148
+ if (status !== void 0) return (options.retryOnStatus ?? isRetryableHttpStatus)(status);
149
+ return true;
150
+ }
151
+ default:
152
+ return false;
153
+ }
154
+ }
155
+ function isExternalAbortError(error) {
156
+ if (typeof error !== "object" || error === null) return false;
157
+ const record = error;
158
+ return record.name === "AbortError" || ABORT_CODES.has(String(record.code ?? ""));
159
+ }
160
+ function isExternalTimeoutError(error) {
161
+ if (typeof error !== "object" || error === null) return false;
162
+ const record = error;
163
+ return record.name === "TimeoutError" || TIMEOUT_CODES.has(String(record.code ?? ""));
164
+ }
165
+ function toHttpError(error, options = {}) {
166
+ if (isHttpError(error)) return error;
167
+ if (options.signal?.aborted || isExternalAbortError(error)) {
168
+ return { _tag: "Abort" };
169
+ }
170
+ const status = externalStatus(error);
171
+ const statusText = externalStatusText(error);
172
+ const code = externalCode(error);
173
+ const message = resolveMessage(error, options.message);
174
+ if (isExternalTimeoutError(error)) {
175
+ return {
176
+ _tag: "Timeout",
177
+ timeoutMs: options.timeoutMs ?? 0,
178
+ phase: options.phase ?? "request",
179
+ message
180
+ };
181
+ }
182
+ return {
183
+ _tag: "FetchError",
184
+ message,
185
+ ...code !== void 0 ? { code } : {},
186
+ ...status !== void 0 ? { status } : {},
187
+ ...statusText !== void 0 ? { statusText } : {},
188
+ ...retryAfterMsFromExternal(error) !== void 0 ? { retryAfterMs: retryAfterMsFromExternal(error) } : {},
189
+ cause: error
190
+ };
191
+ }
192
+ function matchHttpError(error, handlers) {
193
+ if (isKnownHttpError(error)) {
194
+ const handler = handlers[error._tag];
195
+ if (handler) return handler(error);
196
+ }
197
+ return handlers.default?.(error);
198
+ }
199
+ function formatHttpError(error) {
200
+ if (isValidationError(error)) {
201
+ const phase = error.phase ? `${error.phase} ` : "";
202
+ return `${phase}validation failed: ${error.message}`;
203
+ }
204
+ if (isCircuitBreakerOpen(error)) {
205
+ return `Circuit breaker is open after ${error.failures} failure(s)`;
206
+ }
207
+ if (!isHttpError(error)) {
208
+ return error instanceof Error ? error.message : String(error);
209
+ }
210
+ switch (error._tag) {
211
+ case "Abort":
212
+ return "HTTP request aborted";
213
+ case "BadUrl":
214
+ case "PoolRejected":
215
+ case "PoolTimeout":
216
+ case "PoolClosed":
217
+ case "BatchSplitError":
218
+ return error.message;
219
+ case "FetchError":
220
+ return formatFetchError(error);
221
+ case "Timeout":
222
+ return error.message;
223
+ }
224
+ }
225
+ function hasTag(error) {
226
+ return typeof error === "object" && error !== null && typeof error._tag === "string";
227
+ }
228
+ function externalCode(error) {
229
+ if (typeof error !== "object" || error === null) return void 0;
230
+ const code = error.code;
231
+ return typeof code === "string" && code.length > 0 ? code : void 0;
232
+ }
233
+ function externalStatus(error) {
234
+ if (typeof error !== "object" || error === null) return void 0;
235
+ const record = error;
236
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
237
+ const status = response?.status ?? record.status ?? record.statusCode;
238
+ return typeof status === "number" && Number.isFinite(status) ? status : void 0;
239
+ }
240
+ function externalStatusText(error) {
241
+ if (typeof error !== "object" || error === null) return void 0;
242
+ const record = error;
243
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
244
+ const statusText = response?.statusText ?? record.statusText ?? record.statusMessage;
245
+ return typeof statusText === "string" && statusText.length > 0 ? statusText : void 0;
246
+ }
247
+ function retryAfterMsFromExternal(error) {
248
+ if (typeof error !== "object" || error === null) return void 0;
249
+ const record = error;
250
+ const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
251
+ const headers = response?.headers ?? record.headers;
252
+ if (typeof headers !== "object" || headers === null) return void 0;
253
+ const headerRecord = headers;
254
+ const raw = headerRecord["retry-after"] ?? headerRecord["Retry-After"];
255
+ if (raw === void 0 || raw === null) return void 0;
256
+ const seconds = Number(raw);
257
+ if (Number.isFinite(seconds)) return Math.max(0, Math.floor(seconds * 1e3));
258
+ const dateMs = Date.parse(String(raw));
259
+ return Number.isFinite(dateMs) ? Math.max(0, dateMs - Date.now()) : void 0;
260
+ }
261
+ function resolveMessage(error, message) {
262
+ if (typeof message === "function") return message(error);
263
+ if (typeof message === "string") return message;
264
+ if (error instanceof Error && error.message) return error.message;
265
+ if (typeof error === "object" && error !== null) {
266
+ const value = error.message;
267
+ if (typeof value === "string" && value.length > 0) return value;
268
+ }
269
+ return String(error);
270
+ }
271
+ function formatFetchError(error) {
272
+ const status = httpErrorStatus(error);
273
+ if (status === void 0) return error.message;
274
+ const statusText = error.statusText ? ` ${error.statusText}` : "";
275
+ return `HTTP ${status}${statusText}: ${error.message}`;
276
+ }
277
+
278
+ export {
279
+ defineHttpPolicyPresets,
280
+ httpPolicy,
281
+ getHttpRequestPolicy,
282
+ withHttpRequestPolicy,
283
+ resolveHttpRequestPolicyPresets,
284
+ withHttpPolicyPresets,
285
+ isHttpError,
286
+ isValidationError,
287
+ isCircuitBreakerOpen,
288
+ isKnownHttpError,
289
+ isAbortHttpError,
290
+ isTimeoutHttpError,
291
+ isFetchHttpError,
292
+ httpErrorStatus,
293
+ isRetryableHttpStatus,
294
+ isRetryableHttpError,
295
+ isExternalAbortError,
296
+ isExternalTimeoutError,
297
+ toHttpError,
298
+ matchHttpError,
299
+ formatHttpError
300
+ };