@apifuse/provider-sdk 2.2.0-beta.5 → 2.2.0-beta.51

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 (368) hide show
  1. package/AUTHORING.md +537 -33
  2. package/CHANGELOG.md +205 -1
  3. package/README.md +83 -22
  4. package/SUBMISSION.md +2 -2
  5. package/bin/apifuse-check.ts +165 -11
  6. package/bin/apifuse-dev.ts +57 -13
  7. package/bin/apifuse-migrate-operation-declaration.ts +55 -0
  8. package/bin/apifuse-migrate-shape.ts +202 -0
  9. package/bin/apifuse-pack-check.ts +22 -2
  10. package/bin/apifuse-pack-smoke.ts +57 -2
  11. package/bin/apifuse-pack-types.ts +357 -38
  12. package/bin/apifuse-perf.ts +14 -13
  13. package/bin/apifuse-record.ts +709 -72
  14. package/bin/apifuse-submit-check.ts +2344 -324
  15. package/bin/apifuse-sync-assets.ts +117 -0
  16. package/bin/submit-check-delimited-text.ts +50 -0
  17. package/dist/auth-turn/index.d.ts +3 -3
  18. package/dist/auth-turn/index.js +1 -1
  19. package/dist/auth.d.ts +14 -0
  20. package/dist/auth.js +67 -0
  21. package/dist/ceremonies/index.d.ts +16 -0
  22. package/dist/ceremonies/index.js +141 -36
  23. package/dist/cli/commands.d.ts +1 -1
  24. package/dist/cli/commands.js +27 -0
  25. package/dist/cli/create.d.ts +4 -1
  26. package/dist/cli/create.js +42 -37
  27. package/dist/cli/migrate-operation-declaration.d.ts +59 -0
  28. package/dist/cli/migrate-operation-declaration.js +1249 -0
  29. package/dist/cli/migrate-operation-shape.d.ts +44 -0
  30. package/dist/cli/migrate-operation-shape.js +113 -0
  31. package/dist/cli/migrate-provider-shape.d.ts +52 -0
  32. package/dist/cli/migrate-provider-shape.js +578 -0
  33. package/dist/cli/prompt-assets.d.ts +80 -0
  34. package/dist/cli/prompt-assets.js +743 -0
  35. package/dist/cli/templates/provider/AGENTS.md.tpl +17 -8
  36. package/dist/cli/templates/provider/Dockerfile.tpl +1 -1
  37. package/dist/cli/templates/provider/README.md.tpl +5 -5
  38. package/dist/cli/templates/provider/index.ts.tpl +6 -3
  39. package/dist/cli/templates/provider/operations/ping.ts.tpl +4 -1
  40. package/dist/cli/templates/provider/provider.json.tpl +6 -0
  41. package/dist/config/loader.d.ts +179 -16
  42. package/dist/config/loader.js +435 -127
  43. package/dist/contract-serialization.js +4 -8
  44. package/dist/contract-types.d.ts +12 -5
  45. package/dist/contract.js +24 -10
  46. package/dist/declaration-validation.d.ts +33 -0
  47. package/dist/declaration-validation.js +266 -0
  48. package/dist/define.d.ts +66 -29
  49. package/dist/define.js +778 -69
  50. package/dist/dev.d.ts +3 -0
  51. package/dist/dev.js +1 -1
  52. package/dist/engine.d.ts +78 -0
  53. package/dist/engine.js +133 -0
  54. package/dist/error-observability.d.ts +7 -0
  55. package/dist/error-observability.js +61 -0
  56. package/dist/error-resolution.d.ts +4 -0
  57. package/dist/error-resolution.js +122 -0
  58. package/dist/errors.d.ts +33 -0
  59. package/dist/errors.js +40 -0
  60. package/dist/fixture-sanitization.d.ts +28 -0
  61. package/dist/fixture-sanitization.js +227 -0
  62. package/dist/health-scenario.d.ts +1842 -0
  63. package/dist/health-scenario.js +624 -0
  64. package/dist/index.d.ts +21 -10
  65. package/dist/index.js +12 -7
  66. package/dist/lint.d.ts +23 -11
  67. package/dist/lint.js +572 -69
  68. package/dist/native-address.d.ts +43 -0
  69. package/dist/native-address.js +281 -0
  70. package/dist/native-egress-policy.d.ts +31 -0
  71. package/dist/native-egress-policy.js +288 -0
  72. package/dist/observability.d.ts +5 -2
  73. package/dist/observability.js +48 -1
  74. package/dist/provider.d.ts +10 -2
  75. package/dist/provider.js +4 -1
  76. package/dist/runtime/auth-flow.d.ts +5 -1
  77. package/dist/runtime/auth-flow.js +6 -0
  78. package/dist/runtime/browser.d.ts +1 -0
  79. package/dist/runtime/browser.js +492 -49
  80. package/dist/runtime/cache.d.ts +1 -0
  81. package/dist/runtime/cache.js +169 -15
  82. package/dist/runtime/choice-wordlist.d.ts +9 -0
  83. package/dist/runtime/choice-wordlist.js +138 -0
  84. package/dist/runtime/choice.d.ts +13 -1
  85. package/dist/runtime/choice.js +490 -102
  86. package/dist/runtime/chrome149-header-order.d.ts +58 -0
  87. package/dist/runtime/chrome149-header-order.js +289 -0
  88. package/dist/runtime/env.js +12 -0
  89. package/dist/runtime/executor.d.ts +3 -2
  90. package/dist/runtime/executor.js +26 -25
  91. package/dist/runtime/http.d.ts +1 -0
  92. package/dist/runtime/http.js +515 -53
  93. package/dist/runtime/insights.js +2 -2
  94. package/dist/runtime/instrumentation.d.ts +2 -2
  95. package/dist/runtime/instrumentation.js +366 -8
  96. package/dist/runtime/native-network-errors.d.ts +33 -0
  97. package/dist/runtime/native-network-errors.js +69 -0
  98. package/dist/runtime/native-network.d.ts +96 -0
  99. package/dist/runtime/native-network.js +1232 -0
  100. package/dist/runtime/ocr.d.ts +29 -0
  101. package/dist/runtime/ocr.js +440 -0
  102. package/dist/runtime/otlp.d.ts +71 -2
  103. package/dist/runtime/otlp.js +397 -16
  104. package/dist/runtime/proxy-errors.js +6 -2
  105. package/dist/runtime/proxy-nodemaven.d.ts +56 -0
  106. package/dist/runtime/proxy-nodemaven.js +146 -0
  107. package/dist/runtime/proxy-telemetry.d.ts +80 -1
  108. package/dist/runtime/proxy-telemetry.js +154 -47
  109. package/dist/runtime/redirects.d.ts +29 -0
  110. package/dist/runtime/redirects.js +36 -0
  111. package/dist/runtime/redis.d.ts +1 -1
  112. package/dist/runtime/redis.js +4 -2
  113. package/dist/runtime/request-options.d.ts +68 -1
  114. package/dist/runtime/request-options.js +548 -0
  115. package/dist/runtime/resolver-config.d.ts +6 -0
  116. package/dist/runtime/resolver-config.js +6 -0
  117. package/dist/runtime/resolver-public.d.ts +1 -0
  118. package/dist/runtime/resolver-public.js +1 -0
  119. package/dist/runtime/resolver-shared.d.ts +14 -0
  120. package/dist/runtime/resolver-shared.js +12 -0
  121. package/dist/runtime/resolver-vendors/bindings.d.ts +48 -0
  122. package/dist/runtime/resolver-vendors/bindings.js +40 -0
  123. package/dist/runtime/resolver-vendors/browser.d.ts +22 -0
  124. package/dist/runtime/resolver-vendors/browser.js +377 -0
  125. package/dist/runtime/resolver-vendors/capsolver.d.ts +22 -0
  126. package/dist/runtime/resolver-vendors/capsolver.js +531 -0
  127. package/dist/runtime/resolver-vendors/hosts.d.ts +2 -0
  128. package/dist/runtime/resolver-vendors/hosts.js +33 -0
  129. package/dist/runtime/resolver-vendors/twocaptcha.d.ts +24 -0
  130. package/dist/runtime/resolver-vendors/twocaptcha.js +408 -0
  131. package/dist/runtime/resolver-vendors/types.d.ts +94 -0
  132. package/dist/runtime/resolver-vendors/types.js +96 -0
  133. package/dist/runtime/resolver.d.ts +72 -0
  134. package/dist/runtime/resolver.js +771 -0
  135. package/dist/runtime/secrets.d.ts +27 -0
  136. package/dist/runtime/secrets.js +51 -0
  137. package/dist/runtime/state.d.ts +3 -0
  138. package/dist/runtime/state.js +277 -71
  139. package/dist/runtime/stealth-cookies.d.ts +20 -0
  140. package/dist/runtime/stealth-cookies.js +111 -0
  141. package/dist/runtime/stealth.d.ts +41 -5
  142. package/dist/runtime/stealth.js +997 -291
  143. package/dist/runtime/stt.js +1 -12
  144. package/dist/runtime/timeout.d.ts +5 -0
  145. package/dist/runtime/timeout.js +12 -0
  146. package/dist/runtime/trace-config.d.ts +12 -0
  147. package/dist/runtime/trace-config.js +62 -0
  148. package/dist/runtime/trace.d.ts +5 -0
  149. package/dist/runtime/trace.js +43 -10
  150. package/dist/serve.d.ts +1 -1
  151. package/dist/serve.js +1 -1
  152. package/dist/server/error-observability.d.ts +1 -0
  153. package/dist/server/error-observability.js +1 -0
  154. package/dist/server/index.d.ts +5 -2
  155. package/dist/server/index.js +2 -2
  156. package/dist/server/self-test-input-tokens.d.ts +2 -1
  157. package/dist/server/self-test-input-tokens.js +18 -14
  158. package/dist/server/self-test.d.ts +14 -3
  159. package/dist/server/self-test.js +129 -58
  160. package/dist/server/serve-implementation.d.ts +230 -0
  161. package/dist/server/serve-implementation.js +2265 -0
  162. package/dist/server/serve.d.ts +1 -70
  163. package/dist/server/serve.js +1 -1131
  164. package/dist/server/trace-output.d.ts +6 -0
  165. package/dist/server/trace-output.js +79 -0
  166. package/dist/server/types.d.ts +30 -5
  167. package/dist/server/types.js +13 -1
  168. package/dist/stateful/errors.d.ts +19 -0
  169. package/dist/stateful/errors.js +24 -0
  170. package/dist/stateful/http-provider-event-emitter.d.ts +40 -0
  171. package/dist/stateful/http-provider-event-emitter.js +237 -0
  172. package/dist/stateful/http-session-owner-registry.d.ts +44 -0
  173. package/dist/stateful/http-session-owner-registry.js +210 -0
  174. package/dist/stateful/index.d.ts +18 -0
  175. package/dist/stateful/index.js +18 -0
  176. package/dist/stateful/provider-event-delivery-failures.d.ts +32 -0
  177. package/dist/stateful/provider-event-delivery-failures.js +43 -0
  178. package/dist/stateful/provider-event-pipeline-metrics.d.ts +46 -0
  179. package/dist/stateful/provider-event-pipeline-metrics.js +48 -0
  180. package/dist/stateful/provider-event-pipeline.d.ts +50 -0
  181. package/dist/stateful/provider-event-pipeline.js +1 -0
  182. package/dist/stateful/provider-events.d.ts +101 -0
  183. package/dist/stateful/provider-events.js +289 -0
  184. package/dist/stateful/session-key.d.ts +15 -0
  185. package/dist/stateful/session-key.js +86 -0
  186. package/dist/stateful/stateful-provider-adapter-context.d.ts +5 -0
  187. package/dist/stateful/stateful-provider-adapter-context.js +42 -0
  188. package/dist/stateful/stateful-provider-adapter-metrics.d.ts +15 -0
  189. package/dist/stateful/stateful-provider-adapter-metrics.js +21 -0
  190. package/dist/stateful/stateful-provider-adapter.d.ts +98 -0
  191. package/dist/stateful/stateful-provider-adapter.js +287 -0
  192. package/dist/stateful/stateful-provider-observability.d.ts +62 -0
  193. package/dist/stateful/stateful-provider-observability.js +161 -0
  194. package/dist/stateful/stateful-provider-owner-forwarder.d.ts +41 -0
  195. package/dist/stateful/stateful-provider-owner-forwarder.js +215 -0
  196. package/dist/stateful/stateful-provider-runtime-context.d.ts +32 -0
  197. package/dist/stateful/stateful-provider-runtime-context.js +60 -0
  198. package/dist/stateful/stateful-provider-runtime-executor.d.ts +34 -0
  199. package/dist/stateful/stateful-provider-runtime-executor.js +52 -0
  200. package/dist/stateful/stateful-provider-session-routing.d.ts +67 -0
  201. package/dist/stateful/stateful-provider-session-routing.js +345 -0
  202. package/dist/stateful/stateful-provider-session-runtime.d.ts +98 -0
  203. package/dist/stateful/stateful-provider-session-runtime.js +245 -0
  204. package/dist/stateful-signing.d.ts +18 -0
  205. package/dist/stateful-signing.js +27 -0
  206. package/dist/stealth/profiles.d.ts +9 -4
  207. package/dist/stealth/profiles.js +160 -211
  208. package/dist/stream-evidence.d.ts +74 -0
  209. package/dist/stream-evidence.js +785 -0
  210. package/dist/stream.js +7 -1
  211. package/dist/testing/index.d.ts +2 -1
  212. package/dist/testing/index.js +2 -1
  213. package/dist/testing/run.d.ts +32 -2
  214. package/dist/testing/run.js +489 -21
  215. package/dist/trace-sanitization.d.ts +5 -0
  216. package/dist/trace-sanitization.js +45 -0
  217. package/dist/types.d.ts +673 -131
  218. package/dist/types.js +1 -0
  219. package/package.json +45 -5
  220. package/src/auth-turn/index.ts +1 -1
  221. package/src/auth.ts +118 -0
  222. package/src/ceremonies/index.ts +189 -46
  223. package/src/cli/__tests__/fixtures/migrate-operation-declaration/approval-override.ts.txt +6 -0
  224. package/src/cli/__tests__/fixtures/migrate-operation-declaration/codemod-syntax.ts.txt +3 -0
  225. package/src/cli/__tests__/fixtures/migrate-operation-declaration/connection-precedence.ts.txt +10 -0
  226. package/src/cli/__tests__/fixtures/migrate-operation-declaration/docs-conflict.ts.txt +8 -0
  227. package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-hoisted-array-spread.ts.txt +15 -0
  228. package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-imported-array-spread.ts.txt +9 -0
  229. package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-map.ts.txt +5 -0
  230. package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-mixed-array-spread.ts.txt +24 -0
  231. package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-operation.ts.txt +16 -0
  232. package/src/cli/__tests__/fixtures/migrate-operation-declaration/factory-map.ts.txt +3 -0
  233. package/src/cli/__tests__/fixtures/migrate-operation-declaration/hoist-all.ts.txt +31 -0
  234. package/src/cli/__tests__/fixtures/migrate-operation-declaration/hoisted-const.ts.txt +11 -0
  235. package/src/cli/__tests__/fixtures/migrate-operation-declaration/imported-spread.ts.txt +11 -0
  236. package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-map.ts.txt +11 -0
  237. package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-cast-tail.ts.txt +21 -0
  238. package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-ekitan.ts.txt +11 -0
  239. package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-override.ts.txt +14 -0
  240. package/src/cli/__tests__/fixtures/migrate-operation-declaration/missing-english-locale.ts.txt +7 -0
  241. package/src/cli/__tests__/fixtures/migrate-operation-declaration/no-safety.ts.txt +6 -0
  242. package/src/cli/__tests__/fixtures/migrate-operation-declaration/non-literal.ts.txt +7 -0
  243. package/src/cli/__tests__/fixtures/migrate-operation-declaration/redundant-approval.ts.txt +6 -0
  244. package/src/cli/__tests__/fixtures/migrate-operation-declaration/safety-conflict.ts.txt +7 -0
  245. package/src/cli/__tests__/fixtures/migrate-operation-declaration/stream.ts.txt +7 -0
  246. package/src/cli/__tests__/fixtures/migrate-operation-declaration/tool-router-spread.ts.txt +15 -0
  247. package/src/cli/__tests__/fixtures/migrate-operation-declaration/unparseable.ts.txt +4 -0
  248. package/src/cli/__tests__/fixtures/migrate-operation-declaration/verbatim-template.ts.txt +12 -0
  249. package/src/cli/commands.ts +33 -0
  250. package/src/cli/create.ts +50 -37
  251. package/src/cli/migrate-operation-declaration.ts +1751 -0
  252. package/src/cli/migrate-operation-shape.ts +184 -0
  253. package/src/cli/migrate-provider-shape.ts +772 -0
  254. package/src/cli/prompt-assets.ts +865 -0
  255. package/src/cli/templates/provider/AGENTS.md.tpl +17 -8
  256. package/src/cli/templates/provider/Dockerfile.tpl +1 -1
  257. package/src/cli/templates/provider/README.md.tpl +5 -5
  258. package/src/cli/templates/provider/index.ts.tpl +6 -3
  259. package/src/cli/templates/provider/operations/ping.ts.tpl +4 -1
  260. package/src/cli/templates/provider/provider.json.tpl +6 -0
  261. package/src/config/loader.ts +690 -163
  262. package/src/contract-serialization.ts +5 -7
  263. package/src/contract-types.ts +12 -5
  264. package/src/contract.ts +24 -10
  265. package/src/declaration-validation.ts +330 -0
  266. package/src/define.ts +1048 -131
  267. package/src/dev.ts +4 -1
  268. package/src/engine.ts +279 -0
  269. package/src/error-observability.ts +64 -0
  270. package/src/error-resolution.ts +127 -0
  271. package/src/errors.ts +68 -0
  272. package/src/fixture-sanitization.ts +264 -0
  273. package/src/health-scenario.ts +875 -0
  274. package/src/index.ts +220 -13
  275. package/src/lint.ts +698 -90
  276. package/src/native-address.ts +340 -0
  277. package/src/native-egress-policy.ts +358 -0
  278. package/src/observability.ts +51 -1
  279. package/src/provider.ts +161 -3
  280. package/src/runtime/auth-flow.ts +12 -0
  281. package/src/runtime/browser.ts +661 -63
  282. package/src/runtime/cache.ts +189 -14
  283. package/src/runtime/choice-wordlist.ts +145 -0
  284. package/src/runtime/choice.ts +631 -120
  285. package/src/runtime/chrome149-header-order.ts +330 -0
  286. package/src/runtime/env.ts +13 -0
  287. package/src/runtime/executor.ts +43 -31
  288. package/src/runtime/http.ts +641 -61
  289. package/src/runtime/insights.ts +2 -2
  290. package/src/runtime/instrumentation.ts +520 -15
  291. package/src/runtime/native-network-errors.ts +99 -0
  292. package/src/runtime/native-network.ts +1605 -0
  293. package/src/runtime/ocr.ts +523 -0
  294. package/src/runtime/otlp.ts +467 -21
  295. package/src/runtime/proxy-errors.ts +12 -4
  296. package/src/runtime/proxy-nodemaven.ts +221 -0
  297. package/src/runtime/proxy-telemetry.ts +244 -75
  298. package/src/runtime/redirects.ts +66 -0
  299. package/src/runtime/redis.ts +7 -2
  300. package/src/runtime/request-options.ts +680 -1
  301. package/src/runtime/resolver-config.ts +6 -0
  302. package/src/runtime/resolver-public.ts +23 -0
  303. package/src/runtime/resolver-shared.ts +33 -0
  304. package/src/runtime/resolver-vendors/bindings.ts +56 -0
  305. package/src/runtime/resolver-vendors/browser.ts +533 -0
  306. package/src/runtime/resolver-vendors/capsolver.ts +707 -0
  307. package/src/runtime/resolver-vendors/hosts.ts +38 -0
  308. package/src/runtime/resolver-vendors/twocaptcha.ts +540 -0
  309. package/src/runtime/resolver-vendors/types.ts +212 -0
  310. package/src/runtime/resolver.ts +1157 -0
  311. package/src/runtime/secrets.ts +64 -0
  312. package/src/runtime/state.ts +394 -77
  313. package/src/runtime/stealth-cookies.ts +132 -0
  314. package/src/runtime/stealth.ts +1280 -336
  315. package/src/runtime/stt.ts +1 -19
  316. package/src/runtime/timeout.ts +18 -0
  317. package/src/runtime/trace-config.ts +78 -0
  318. package/src/runtime/trace.ts +57 -17
  319. package/src/serve.ts +6 -1
  320. package/src/server/error-observability.ts +1 -0
  321. package/src/server/index.ts +34 -2
  322. package/src/server/self-test-input-tokens.ts +29 -14
  323. package/src/server/self-test.ts +191 -68
  324. package/src/server/serve-implementation.ts +3378 -0
  325. package/src/server/serve.ts +1 -1632
  326. package/src/server/trace-output.ts +129 -0
  327. package/src/server/types.ts +13 -1
  328. package/src/stateful/README.md +146 -0
  329. package/src/stateful/errors.ts +35 -0
  330. package/src/stateful/http-provider-event-emitter.ts +314 -0
  331. package/src/stateful/http-session-owner-registry.ts +306 -0
  332. package/src/stateful/index.ts +18 -0
  333. package/src/stateful/provider-event-delivery-failures.ts +80 -0
  334. package/src/stateful/provider-event-pipeline-metrics.ts +95 -0
  335. package/src/stateful/provider-event-pipeline.ts +61 -0
  336. package/src/stateful/provider-events.ts +462 -0
  337. package/src/stateful/session-key.ts +111 -0
  338. package/src/stateful/stateful-provider-adapter-context.ts +59 -0
  339. package/src/stateful/stateful-provider-adapter-metrics.ts +48 -0
  340. package/src/stateful/stateful-provider-adapter.ts +562 -0
  341. package/src/stateful/stateful-provider-observability.ts +261 -0
  342. package/src/stateful/stateful-provider-owner-forwarder.ts +287 -0
  343. package/src/stateful/stateful-provider-runtime-context.ts +92 -0
  344. package/src/stateful/stateful-provider-runtime-executor.ts +96 -0
  345. package/src/stateful/stateful-provider-session-routing.ts +546 -0
  346. package/src/stateful/stateful-provider-session-runtime.ts +403 -0
  347. package/src/stateful-signing.ts +46 -0
  348. package/src/stealth/profiles.ts +202 -231
  349. package/src/stream-evidence.ts +988 -0
  350. package/src/stream.ts +8 -1
  351. package/src/testing/index.ts +10 -1
  352. package/src/testing/run.ts +658 -15
  353. package/src/trace-sanitization.ts +63 -0
  354. package/src/types.ts +788 -174
  355. package/dist/cli/templates/provider/CLAUDE.md.tpl +0 -1
  356. package/src/cli/templates/provider/CLAUDE.md.tpl +0 -1
  357. /package/dist/cli/templates/provider/{skills → .agents/skills}/fixtures-and-recording/SKILL.md.tpl +0 -0
  358. /package/dist/cli/templates/provider/{skills → .agents/skills}/health-checks-and-fail-closed/SKILL.md.tpl +0 -0
  359. /package/dist/cli/templates/provider/{skills → .agents/skills}/normalization-standards/SKILL.md.tpl +0 -0
  360. /package/dist/cli/templates/provider/{skills → .agents/skills}/pagination-and-counts/SKILL.md.tpl +0 -0
  361. /package/dist/cli/templates/provider/{skills → .agents/skills}/upstream-contract-verification/SKILL.md.tpl +0 -0
  362. /package/dist/cli/templates/provider/{skills → .agents/skills}/upstream-notes/README.md.tpl +0 -0
  363. /package/src/cli/templates/provider/{skills → .agents/skills}/fixtures-and-recording/SKILL.md.tpl +0 -0
  364. /package/src/cli/templates/provider/{skills → .agents/skills}/health-checks-and-fail-closed/SKILL.md.tpl +0 -0
  365. /package/src/cli/templates/provider/{skills → .agents/skills}/normalization-standards/SKILL.md.tpl +0 -0
  366. /package/src/cli/templates/provider/{skills → .agents/skills}/pagination-and-counts/SKILL.md.tpl +0 -0
  367. /package/src/cli/templates/provider/{skills → .agents/skills}/upstream-contract-verification/SKILL.md.tpl +0 -0
  368. /package/src/cli/templates/provider/{skills → .agents/skills}/upstream-notes/README.md.tpl +0 -0
@@ -1,3 +1,5 @@
1
+ import { AsyncResource } from "node:async_hooks";
2
+
1
3
  import type { TraceSpan } from "../types.js";
2
4
 
3
5
  export interface OTLPExportOptions {
@@ -6,6 +8,221 @@ export interface OTLPExportOptions {
6
8
  timeout?: number;
7
9
  }
8
10
 
11
+ export const OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT";
12
+ export const OTEL_EXPORTER_OTLP_ENDPOINT = "OTEL_EXPORTER_OTLP_ENDPOINT";
13
+ export const OTEL_EXPORTER_OTLP_TRACES_HEADERS = "OTEL_EXPORTER_OTLP_TRACES_HEADERS";
14
+ export const OTEL_EXPORTER_OTLP_HEADERS = "OTEL_EXPORTER_OTLP_HEADERS";
15
+ export const OTEL_SERVICE_NAME = "OTEL_SERVICE_NAME";
16
+ export const OTEL_RESOURCE_ATTRIBUTES = "OTEL_RESOURCE_ATTRIBUTES";
17
+
18
+ type EnvLike = Record<string, string | undefined>;
19
+
20
+ /**
21
+ * `invalid` carries a fixed-vocabulary `reason` and the name of the offending
22
+ * source so callers can warn without ever echoing the configured value.
23
+ */
24
+ export type OTLPExportResolution =
25
+ | { status: "resolved"; options: OTLPExportOptions }
26
+ | { status: "unconfigured" }
27
+ | { status: "invalid"; source: string; reason: string };
28
+
29
+ export type OTLPResourceResolution = {
30
+ attributes: Record<string, string>;
31
+ /** Environment variables whose whole value was discarded because it could not be parsed. */
32
+ discarded: string[];
33
+ };
34
+
35
+ const OTLP_HTTP_PROTOCOLS = new Set(["http:", "https:"]);
36
+ const INVALID_ENDPOINT_URL = "is not an absolute http(s) URL";
37
+ const INVALID_ENDPOINT_CREDENTIALS = `embeds credentials in the URL; send them through ${OTEL_EXPORTER_OTLP_HEADERS} instead`;
38
+ const INVALID_HEADERS = "contains an HTTP header name or value that cannot be sent";
39
+ const EXPLICIT_ENDPOINT_SOURCE = "the configured OTLP endpoint";
40
+ const EXPLICIT_HEADERS_SOURCE = "the configured OTLP headers";
41
+
42
+ /** Only an unset or empty variable is absent (OTel env rules); whitespace is a value and is validated as one. */
43
+ function presentValue(value: string | undefined): string | undefined {
44
+ return value === undefined || value === "" ? undefined : value;
45
+ }
46
+
47
+ function parseHttpUrl(value: string): { url: URL } | { reason: string } {
48
+ let url: URL;
49
+ try {
50
+ url = new URL(value);
51
+ } catch {
52
+ return { reason: INVALID_ENDPOINT_URL };
53
+ }
54
+ if (!OTLP_HTTP_PROTOCOLS.has(url.protocol)) return { reason: INVALID_ENDPOINT_URL };
55
+ if (url.username || url.password) return { reason: INVALID_ENDPOINT_CREDENTIALS };
56
+ return { url };
57
+ }
58
+
59
+ /** fetch() rejects malformed header names/values per request; catch that once at resolve time instead. */
60
+ function headersAreSendable(headers: Record<string, string>): boolean {
61
+ try {
62
+ new Headers(headers);
63
+ return true;
64
+ } catch {
65
+ return false;
66
+ }
67
+ }
68
+
69
+ /** Appends the traces signal path to a base URL, keeping every configured path byte and adding only the separator. */
70
+ function appendTracesPath(base: URL): string {
71
+ const endpoint = new URL(base.toString());
72
+ const separator = endpoint.pathname.endsWith("/") ? "" : "/";
73
+ endpoint.pathname = `${endpoint.pathname}${separator}v1/traces`;
74
+ return endpoint.toString();
75
+ }
76
+
77
+ /** HTTP header names are case-insensitive: a later source replaces an earlier one whatever its casing. */
78
+ function mergeHeaders(
79
+ ...sources: Array<Record<string, string> | undefined>
80
+ ): Record<string, string> {
81
+ const merged = new Map<string, [string, string]>();
82
+ for (const source of sources) {
83
+ for (const [key, value] of Object.entries(source ?? {})) {
84
+ merged.set(key.toLowerCase(), [key, value]);
85
+ }
86
+ }
87
+ return Object.fromEntries(merged.values());
88
+ }
89
+
90
+ function decodeHeaderMember(value: string): string {
91
+ try {
92
+ return decodeURIComponent(value);
93
+ } catch {
94
+ // A literal "%" that is not a valid escape is passed through rather than dropping the header.
95
+ return value;
96
+ }
97
+ }
98
+
99
+ /** Baggage-style header list: malformed members are skipped and an invalid percent-escape keeps the raw text. */
100
+ function parseHeaderList(value: string | undefined): Record<string, string> {
101
+ const entries: Array<[string, string]> = [];
102
+ for (const member of value?.split(",") ?? []) {
103
+ const separator = member.indexOf("=");
104
+ if (separator <= 0) continue;
105
+ const key = decodeHeaderMember(member.slice(0, separator).trim());
106
+ if (!key) continue;
107
+ entries.push([key, decodeHeaderMember(member.slice(separator + 1).trim())]);
108
+ }
109
+ return mergeHeaders(Object.fromEntries(entries));
110
+ }
111
+
112
+ /**
113
+ * OTel resource list: a member without `key=value` or with an invalid
114
+ * percent-escape discards the whole value, as the Resource SDK spec requires,
115
+ * so a partially malformed variable can never export a wrong identity.
116
+ */
117
+ function parseResourceAttributeList(value: string): Record<string, string> | undefined {
118
+ const entries: Array<[string, string]> = [];
119
+ for (const member of value.split(",")) {
120
+ // Every member must be `key=value`; an empty member (`a=b,,c=d`, a trailing comma, a
121
+ // whitespace-only value) is a parse error and discards the whole variable.
122
+ const separator = member.indexOf("=");
123
+ if (separator <= 0) return undefined;
124
+ try {
125
+ const key = decodeURIComponent(member.slice(0, separator).trim());
126
+ if (!key) return undefined;
127
+ entries.push([key, decodeURIComponent(member.slice(separator + 1).trim())]);
128
+ } catch {
129
+ return undefined;
130
+ }
131
+ }
132
+ return Object.fromEntries(entries);
133
+ }
134
+
135
+ /**
136
+ * Resolves the OTLP/HTTP export target from explicit configuration and the
137
+ * standard OpenTelemetry environment contract. Endpoint precedence is explicit
138
+ * config, then OTEL_EXPORTER_OTLP_TRACES_ENDPOINT verbatim, then
139
+ * OTEL_EXPORTER_OTLP_ENDPOINT with `/v1/traces` appended. The winning candidate
140
+ * must be an absolute http(s) URL; an invalid one fails closed instead of
141
+ * falling through to a lower-precedence destination. Header values are never
142
+ * surfaced in the result beyond the request options themselves.
143
+ */
144
+ export function resolveOTLPExportOptions(
145
+ explicit: {
146
+ endpoint?: string;
147
+ headers?: Record<string, string>;
148
+ timeout?: number;
149
+ },
150
+ env: EnvLike = process.env,
151
+ ): OTLPExportResolution {
152
+ const candidates = [
153
+ { source: EXPLICIT_ENDPOINT_SOURCE, value: explicit.endpoint, appendPath: false },
154
+ {
155
+ source: OTEL_EXPORTER_OTLP_TRACES_ENDPOINT,
156
+ value: env[OTEL_EXPORTER_OTLP_TRACES_ENDPOINT],
157
+ appendPath: false,
158
+ },
159
+ {
160
+ source: OTEL_EXPORTER_OTLP_ENDPOINT,
161
+ value: env[OTEL_EXPORTER_OTLP_ENDPOINT],
162
+ appendPath: true,
163
+ },
164
+ ];
165
+ const candidate = candidates
166
+ .map((entry) => ({ ...entry, value: presentValue(entry.value) }))
167
+ .find((entry): entry is typeof entry & { value: string } => entry.value !== undefined);
168
+ if (!candidate) return { status: "unconfigured" };
169
+
170
+ const parsed = parseHttpUrl(candidate.value);
171
+ if ("reason" in parsed) {
172
+ return { status: "invalid", source: candidate.source, reason: parsed.reason };
173
+ }
174
+ const endpoint = candidate.appendPath ? appendTracesPath(parsed.url) : candidate.value;
175
+
176
+ const tracesHeaders = presentValue(env[OTEL_EXPORTER_OTLP_TRACES_HEADERS]);
177
+ const headersSource =
178
+ tracesHeaders !== undefined ? OTEL_EXPORTER_OTLP_TRACES_HEADERS : OTEL_EXPORTER_OTLP_HEADERS;
179
+ const envHeaders = parseHeaderList(
180
+ tracesHeaders ?? presentValue(env[OTEL_EXPORTER_OTLP_HEADERS]),
181
+ );
182
+ if (!headersAreSendable(envHeaders)) {
183
+ return { status: "invalid", source: headersSource, reason: INVALID_HEADERS };
184
+ }
185
+ const headers = mergeHeaders(envHeaders, explicit.headers);
186
+ if (!headersAreSendable(headers)) {
187
+ return { status: "invalid", source: EXPLICIT_HEADERS_SOURCE, reason: INVALID_HEADERS };
188
+ }
189
+
190
+ return {
191
+ status: "resolved",
192
+ options: {
193
+ endpoint,
194
+ ...(Object.keys(headers).length > 0 ? { headers } : {}),
195
+ ...(explicit.timeout !== undefined ? { timeout: explicit.timeout } : {}),
196
+ },
197
+ };
198
+ }
199
+
200
+ /**
201
+ * Merges OTEL_RESOURCE_ATTRIBUTES and OTEL_SERVICE_NAME under the caller's
202
+ * explicit resource attributes: explicit wins per key, OTEL_SERVICE_NAME wins
203
+ * over a `service.name` inside OTEL_RESOURCE_ATTRIBUTES. An unparseable
204
+ * OTEL_RESOURCE_ATTRIBUTES value is discarded as a unit and reported in `discarded`.
205
+ */
206
+ export function resolveOTLPResourceAttributes(
207
+ explicit: Record<string, string>,
208
+ env: EnvLike = process.env,
209
+ ): OTLPResourceResolution {
210
+ const discarded: string[] = [];
211
+ const resourceList = presentValue(env[OTEL_RESOURCE_ATTRIBUTES]);
212
+ const resourceAttributes =
213
+ resourceList === undefined ? {} : parseResourceAttributeList(resourceList);
214
+ if (resourceAttributes === undefined) discarded.push(OTEL_RESOURCE_ATTRIBUTES);
215
+ const serviceName = presentValue(env[OTEL_SERVICE_NAME]);
216
+ return {
217
+ attributes: {
218
+ ...resourceAttributes,
219
+ ...(serviceName ? { "service.name": serviceName } : {}),
220
+ ...explicit,
221
+ },
222
+ discarded,
223
+ };
224
+ }
225
+
9
226
  let nextTraceId = 1n;
10
227
  let replayableTraceId: { signature: string; traceId: string } | null = null;
11
228
 
@@ -60,6 +277,7 @@ function toAttributeValue(value: unknown): Record<string, string | number | bool
60
277
  export function spansToOTLP(
61
278
  spans: TraceSpan[],
62
279
  resourceAttributes?: Record<string, string>,
280
+ traceId?: string,
63
281
  ): {
64
282
  resourceSpans: Array<{
65
283
  resource: {
@@ -87,7 +305,7 @@ export function spansToOTLP(
87
305
  }>;
88
306
  }>;
89
307
  } {
90
- const traceId = createTraceId(createBatchSignature(spans, resourceAttributes));
308
+ const batchTraceId = traceId ?? createTraceId(createBatchSignature(spans, resourceAttributes));
91
309
 
92
310
  return {
93
311
  resourceSpans: [
@@ -105,7 +323,7 @@ export function spansToOTLP(
105
323
  version: "0.1.0",
106
324
  },
107
325
  spans: spans.map((span) => ({
108
- traceId,
326
+ traceId: batchTraceId,
109
327
  spanId: normalizeHexId(span.id, 16) ?? "0000000000000001",
110
328
  parentSpanId: normalizeHexId(span.parentId, 16),
111
329
  name: span.name,
@@ -125,36 +343,264 @@ export function spansToOTLP(
125
343
  };
126
344
  }
127
345
 
128
- export async function exportSpansOTLP(
129
- spans: TraceSpan[],
130
- options: OTLPExportOptions,
131
- resourceAttributes?: Record<string, string>,
132
- ): Promise<void> {
133
- if (spans.length === 0) {
346
+ type ExportTransport = typeof fetch;
347
+
348
+ /**
349
+ * Binds the transport that carries collector credentials.
350
+ *
351
+ * Trust model: in production the provider's own entry file is the process entry, so
352
+ * provider-controlled code (its earlier imports, a `bun --preload`, or a bunfig preload) can run
353
+ * before any SDK module evaluates; capture timing alone therefore cannot establish trust. On Bun
354
+ * the native fetch is also exposed as `Bun.fetch`, and both the `Bun` global and its `fetch`
355
+ * property are read-only and non-configurable, so no JavaScript in the process can replace that
356
+ * reference at any point. The engine binds it here and never consults `globalThis.fetch`.
357
+ *
358
+ * Residual assumptions: on a runtime without `Bun.fetch` the fallback is `globalThis.fetch` as
359
+ * seen when this module first evaluates, which code that runs earlier in the same process can
360
+ * have replaced (or can have forged a `Bun` global). Code with process authority can also patch
361
+ * other builtins on this path (Map, Object.fromEntries, Headers, AbortController, setTimeout),
362
+ * install module loader plugins, or reach the internal test seam below by importing this module
363
+ * by path; an in-process boundary cannot defend against any of that. The CLI flows load provider
364
+ * modules only after the engine has loaded.
365
+ */
366
+ function bindEngineTransport(): ExportTransport {
367
+ const bunFetch: unknown = typeof Bun !== "undefined" ? Bun.fetch : undefined;
368
+ return typeof bunFetch === "function" ? (bunFetch as ExportTransport) : globalThis.fetch;
369
+ }
370
+
371
+ const engineTransport: ExportTransport = bindEngineTransport();
372
+ let transport: ExportTransport = engineTransport;
373
+
374
+ // Deliveries run inside this engine-owned async scope, created while the module evaluates, so a
375
+ // batch admitted from another batch's completion never inherits that request's async context.
376
+ // (The scope snapshots the async context active at module load: empty under the static imports
377
+ // the engine uses.)
378
+ const exportScope = new AsyncResource("apifuse.otlp.export");
379
+
380
+ /** Process-wide bounds so a collector outage can never turn into unbounded sockets, memory, or log volume. */
381
+ export const OTLP_EXPORT_LIMITS = {
382
+ maxInFlight: 4,
383
+ maxQueued: 64,
384
+ maxAttempts: 3,
385
+ retryBaseDelayMs: 200,
386
+ retryMaxDelayMs: 2_000,
387
+ warningCooldownMs: 10_000,
388
+ } as const;
389
+
390
+ const RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);
391
+ const TIMEOUT_ERROR_NAMES = new Set(["AbortError", "TimeoutError"]);
392
+ /** Certificate failures do not clear up on retry; they are reported once and the batch dropped. */
393
+ const CERTIFICATE_ERROR_CODES = new Set([
394
+ "CERT_HAS_EXPIRED",
395
+ "DEPTH_ZERO_SELF_SIGNED_CERT",
396
+ "SELF_SIGNED_CERT_IN_CHAIN",
397
+ "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
398
+ "ERR_TLS_CERT_ALTNAME_INVALID",
399
+ ]);
400
+ /** Only these system codes are ever echoed; anything else is reported as a plain network error. */
401
+ const NETWORK_ERROR_CODES = new Set([
402
+ "ECONNREFUSED",
403
+ "ECONNRESET",
404
+ "ECONNABORTED",
405
+ "ENOTFOUND",
406
+ "EAI_AGAIN",
407
+ "ETIMEDOUT",
408
+ "EHOSTUNREACH",
409
+ "ENETUNREACH",
410
+ "EPIPE",
411
+ "CERT_HAS_EXPIRED",
412
+ "DEPTH_ZERO_SELF_SIGNED_CERT",
413
+ "SELF_SIGNED_CERT_IN_CHAIN",
414
+ "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
415
+ "ERR_TLS_CERT_ALTNAME_INVALID",
416
+ "ConnectionRefused",
417
+ "ConnectionClosed",
418
+ "FailedToOpenSocket",
419
+ ]);
420
+
421
+ type ExportOutcome = { ok: true } | { ok: false; reason: string; retryable: boolean };
422
+
423
+ type ExportBatch = {
424
+ body: string;
425
+ options: OTLPExportOptions;
426
+ settle: () => void;
427
+ };
428
+
429
+ const queue: ExportBatch[] = [];
430
+ let inFlight = 0;
431
+ let lastWarningAt = Number.NEGATIVE_INFINITY;
432
+ let suppressedDrops = 0;
433
+ let suppressedFlush: ReturnType<typeof setTimeout> | undefined;
434
+
435
+ function errorCode(error: unknown): string | undefined {
436
+ const own = (error as { code?: unknown } | null)?.code;
437
+ if (typeof own === "string") return own;
438
+ const cause = (error as { cause?: { code?: unknown } } | null)?.cause?.code;
439
+ return typeof cause === "string" ? cause : undefined;
440
+ }
441
+
442
+ /** Maps a transport failure onto a fixed vocabulary; nothing from the error object is interpolated. */
443
+ function describeExportFailure(error: unknown): { reason: string; retryable: boolean } {
444
+ if (error instanceof Error && TIMEOUT_ERROR_NAMES.has(error.name)) {
445
+ return { reason: "timeout", retryable: true };
446
+ }
447
+ const code = errorCode(error);
448
+ if (code !== undefined && CERTIFICATE_ERROR_CODES.has(code)) {
449
+ return { reason: `certificate error: ${code}`, retryable: false };
450
+ }
451
+ return {
452
+ reason:
453
+ code !== undefined && NETWORK_ERROR_CODES.has(code)
454
+ ? `network error: ${code}`
455
+ : "network error",
456
+ retryable: true,
457
+ };
458
+ }
459
+
460
+ function batchesLabel(count: number): string {
461
+ return `${count} ${count === 1 ? "batch" : "batches"}`;
462
+ }
463
+
464
+ /** Emits the count of drops suppressed during a cooldown once it ends, so a burst is never under-reported. */
465
+ function flushSuppressedDrops(): void {
466
+ suppressedFlush = undefined;
467
+ if (suppressedDrops === 0) return;
468
+ const dropped = suppressedDrops;
469
+ suppressedDrops = 0;
470
+ lastWarningAt = Date.now();
471
+ console.warn(
472
+ `[apifuse] OTLP export: ${batchesLabel(dropped)} more dropped since the last warning.`,
473
+ );
474
+ }
475
+
476
+ function noteDroppedBatch(reason: string): void {
477
+ const now = Date.now();
478
+ const sinceLastWarning = now - lastWarningAt;
479
+ if (sinceLastWarning < OTLP_EXPORT_LIMITS.warningCooldownMs) {
480
+ suppressedDrops += 1;
481
+ if (suppressedFlush === undefined) {
482
+ suppressedFlush = setTimeout(
483
+ flushSuppressedDrops,
484
+ OTLP_EXPORT_LIMITS.warningCooldownMs - sinceLastWarning,
485
+ );
486
+ suppressedFlush.unref?.();
487
+ }
134
488
  return;
135
489
  }
490
+ lastWarningAt = now;
491
+ console.warn(`[apifuse] OTLP export failed (${reason}); ${batchesLabel(1)} dropped.`);
492
+ }
136
493
 
494
+ async function sendBatch(batch: ExportBatch): Promise<ExportOutcome> {
137
495
  const controller = new AbortController();
138
- const timer = setTimeout(() => controller.abort(), options.timeout ?? 5_000);
139
-
496
+ const timer = setTimeout(() => controller.abort(), batch.options.timeout ?? 5_000);
140
497
  try {
141
- const response = await fetch(options.endpoint, {
498
+ const response = await transport(batch.options.endpoint, {
142
499
  method: "POST",
143
- headers: {
144
- "Content-Type": "application/json",
145
- ...options.headers,
146
- },
147
- body: JSON.stringify(spansToOTLP(spans, resourceAttributes)),
500
+ headers: mergeHeaders(batch.options.headers, { "Content-Type": "application/json" }),
501
+ body: batch.body,
148
502
  signal: controller.signal,
149
503
  });
150
-
151
- if (!response.ok) {
152
- throw new Error(`HTTP ${response.status}`);
504
+ // The reply body is not needed; cancel it while the abort timer still bounds the socket.
505
+ try {
506
+ await response.body?.cancel();
507
+ } catch {
508
+ // A body that cannot be cancelled does not change the outcome of the export.
153
509
  }
510
+ if (response.ok) return { ok: true };
511
+ return {
512
+ ok: false,
513
+ reason: `HTTP ${response.status}`,
514
+ retryable: RETRYABLE_STATUSES.has(response.status),
515
+ };
154
516
  } catch (error) {
155
- const message = error instanceof Error ? error.message : String(error);
156
- console.warn("[apifuse] OTLP export failed:", message);
517
+ return { ok: false, ...describeExportFailure(error) };
157
518
  } finally {
158
519
  clearTimeout(timer);
159
520
  }
160
521
  }
522
+
523
+ /** Exponential backoff between attempts: base * 2^(attempt-1), capped at the maximum delay. */
524
+ export function retryDelayMs(attempt: number): number {
525
+ return Math.min(
526
+ OTLP_EXPORT_LIMITS.retryBaseDelayMs * 2 ** (attempt - 1),
527
+ OTLP_EXPORT_LIMITS.retryMaxDelayMs,
528
+ );
529
+ }
530
+
531
+ async function deliverBatch(batch: ExportBatch): Promise<void> {
532
+ for (let attempt = 1; ; attempt += 1) {
533
+ const outcome = await sendBatch(batch);
534
+ if (outcome.ok) return;
535
+ if (!outcome.retryable || attempt >= OTLP_EXPORT_LIMITS.maxAttempts) {
536
+ noteDroppedBatch(
537
+ attempt > 1 ? `${outcome.reason} after ${attempt} attempts` : outcome.reason,
538
+ );
539
+ return;
540
+ }
541
+ await new Promise<void>((resolve) => {
542
+ setTimeout(resolve, retryDelayMs(attempt)).unref?.();
543
+ });
544
+ }
545
+ }
546
+
547
+ function pumpQueue(): void {
548
+ while (inFlight < OTLP_EXPORT_LIMITS.maxInFlight && queue.length > 0) {
549
+ const batch = queue.shift();
550
+ if (!batch) return;
551
+ inFlight += 1;
552
+ void exportScope
553
+ .runInAsyncScope(() => deliverBatch(batch))
554
+ .finally(() => {
555
+ inFlight -= 1;
556
+ batch.settle();
557
+ pumpQueue();
558
+ });
559
+ }
560
+ }
561
+
562
+ /**
563
+ * Queues one export batch behind the process-wide concurrency and queue bounds.
564
+ * Resolves once the batch has been delivered or dropped; it never rejects, so
565
+ * callers can fire and forget.
566
+ */
567
+ export function exportSpansOTLP(
568
+ spans: TraceSpan[],
569
+ options: OTLPExportOptions,
570
+ resourceAttributes?: Record<string, string>,
571
+ traceId?: string,
572
+ ): Promise<void> {
573
+ if (spans.length === 0) {
574
+ return Promise.resolve();
575
+ }
576
+ if (queue.length >= OTLP_EXPORT_LIMITS.maxQueued) {
577
+ noteDroppedBatch("export queue is full");
578
+ return Promise.resolve();
579
+ }
580
+ let body: string;
581
+ try {
582
+ body = JSON.stringify(spansToOTLP(spans, resourceAttributes, traceId));
583
+ } catch {
584
+ noteDroppedBatch("span serialization failed");
585
+ return Promise.resolve();
586
+ }
587
+ return new Promise<void>((settle) => {
588
+ queue.push({ body, options, settle });
589
+ pumpQueue();
590
+ });
591
+ }
592
+
593
+ /** Test seam (not re-exported from any package entry point): substitute the engine transport. */
594
+ export function swapOTLPTransportForTests(next?: ExportTransport): void {
595
+ transport = next ?? engineTransport;
596
+ }
597
+
598
+ /** Test seam: drop queued batches, clear the warning throttle, and restore the engine transport. */
599
+ export function resetOTLPExportForTests(): void {
600
+ for (const batch of queue.splice(0)) batch.settle();
601
+ if (suppressedFlush !== undefined) clearTimeout(suppressedFlush);
602
+ suppressedFlush = undefined;
603
+ lastWarningAt = Number.NEGATIVE_INFINITY;
604
+ suppressedDrops = 0;
605
+ transport = engineTransport;
606
+ }
@@ -19,10 +19,18 @@ const PROXY_AUTH_IP_DENIED_PATTERN =
19
19
  /\b(?:source|egress|client)\s+ip\b.{0,120}\b(?:deny|denied|unauthori[sz]ed|not\s+authori[sz]ed|white\s*list|allow\s*list)\b|\b(?:white\s*list|allow\s*list)\b.{0,120}\b(?:source|egress|client)\s+ip\b/i;
20
20
  const PROXY_EDGE_AUTH_REJECTED_PATTERN =
21
21
  /\bauth\s+ip\s+err\b|\bproxy\b.{0,120}\bauth(?:entication)?\b.{0,120}\b(?:reject(?:ed)?|fail(?:ed)?|invalid|den(?:y|ied)|unauthori[sz]ed)\b|\bauth(?:entication)?\b.{0,120}\b(?:reject(?:ed)?|fail(?:ed)?|invalid|den(?:y|ied)|unauthori[sz]ed)\b.{0,120}\bproxy\b/i;
22
- const PROXY_POOL_STALE_MESSAGE_PATTERN =
23
- /\bproxy\b.{0,120}\b(?:pool|lease|expired|unavailable|exhausted|non[\s-]?200\s+code:\s*(?:509|512))\b|\bnon[\s-]?200\s+code:\s*(?:509|512)\b.{0,120}\bproxy\b|\bsmartproxy\b.{0,120}\b(?:509|512)\b/i;
24
- const PROXY_EDGE_TLS_REJECTED_MESSAGE_PATTERN =
25
- /\b(?:smartproxy|proxy)\b.{0,160}\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\s-]?200)\b|\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\s-]?200)\b.{0,160}\b(?:smartproxy|proxy)\b/i;
22
+ // Vendor host tokens that can appear in upstream error strings. Adding a proxy
23
+ // vendor updates every classifier below in one place. `proxy` is the generic
24
+ // fallback so vendor-agnostic messages still classify.
25
+ const PROXY_VENDOR_ALTERNATION = "smartproxy|nodemaven|proxy";
26
+ const PROXY_POOL_STALE_MESSAGE_PATTERN = new RegExp(
27
+ `\\bproxy\\b.{0,120}\\b(?:pool|lease|expired|unavailable|exhausted|non[\\s-]?200\\s+code:\\s*(?:509|512))\\b|\\bnon[\\s-]?200\\s+code:\\s*(?:509|512)\\b.{0,120}\\bproxy\\b|\\b(?:${PROXY_VENDOR_ALTERNATION})\\b.{0,120}\\b(?:509|512)\\b`,
28
+ "i",
29
+ );
30
+ const PROXY_EDGE_TLS_REJECTED_MESSAGE_PATTERN = new RegExp(
31
+ `\\b(?:${PROXY_VENDOR_ALTERNATION})\\b.{0,160}\\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\\s-]?200)\\b|\\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\\s-]?200)\\b.{0,160}\\b(?:${PROXY_VENDOR_ALTERNATION})\\b`,
32
+ "i",
33
+ );
26
34
 
27
35
  export function isProxyAuthIpDeniedMessage(message: string): boolean {
28
36
  return PROXY_AUTH_IP_DENIED_PATTERN.test(message);