@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
@@ -0,0 +1,23 @@
1
+ export {
2
+ APIFUSE__CDP_POOL__URL,
3
+ APIFUSE__RESOLVER__2CAPTCHA__API_KEY,
4
+ APIFUSE__RESOLVER__CAPMONSTER__API_KEY,
5
+ APIFUSE__RESOLVER__CAPSOLVER__API_KEY,
6
+ APIFUSE__RESOLVER__TIMEOUT_MS,
7
+ bindResolverSignal,
8
+ createResolverClient,
9
+ createResolverClientFromEnv,
10
+ createUnsupportedResolverClient,
11
+ DEFAULT_RESOLVER_VENDOR_PREFERENCE,
12
+ DEFAULT_RESOLVER_TIMEOUT_MS,
13
+ getResolverSolutionSource,
14
+ invalidateCachedResolverSolution,
15
+ invalidateResolverSolution,
16
+ RESOLVER_ADAPTER_REGISTRY,
17
+ RESOLVER_INSTRUMENTATION_METADATA,
18
+ resolveProviderResolverVendors,
19
+ type ResolverAdapterFactory,
20
+ type ResolverInstrumentationMetadata,
21
+ type ResolverRuntimeOptions,
22
+ type ResolverSolutionSource,
23
+ } from "./resolver.js";
@@ -0,0 +1,33 @@
1
+ import { ProviderError } from "../errors.js";
2
+ import type { ChallengeSolution, ProviderChallenge, ResolverContext } from "../types.js";
3
+ import type { TraceRecorder } from "./trace.js";
4
+
5
+ export const RESOLVER_INSTRUMENTATION_METADATA = Symbol.for(
6
+ "@apifuse/provider-sdk/runtime/resolver-instrumentation-metadata",
7
+ );
8
+
9
+ /**
10
+ * Internal solve surface. The instrumentation layer threads its recorder as a
11
+ * third argument so vendor-level spans (`resolver.vendor.*`) attach to the
12
+ * active trace. Every wrapper that re-exposes `solve` must forward the extra
13
+ * arguments; a wrapper typed against the public two-argument `ResolverContext`
14
+ * silently drops the recorder and vendor spans vanish.
15
+ */
16
+ export type ResolverSolveWithRecorder = {
17
+ solve(
18
+ challenge: ProviderChallenge,
19
+ signal?: AbortSignal,
20
+ traceRecorder?: TraceRecorder,
21
+ ): Promise<ChallengeSolution>;
22
+ };
23
+
24
+ export function createUnsupportedResolverClient(reason?: string): ResolverContext {
25
+ return {
26
+ async solve() {
27
+ throw new ProviderError(reason ?? "Resolver runtime is not configured", {
28
+ code: "RESOLVER_UNAVAILABLE",
29
+ fix: "Declare resolver on the provider definition and configure vendor credentials.",
30
+ });
31
+ },
32
+ };
33
+ }
@@ -0,0 +1,56 @@
1
+ import type { ProviderChallenge, ProviderChallengeKind } from "../../types.js";
2
+ import type { ResolverIssuingIdentity } from "./types.js";
3
+
4
+ type ResolverChallengeBinding = {
5
+ readonly cacheable: boolean;
6
+ readonly identityBinding: "none" | "identity_scoped" | "portable";
7
+ readonly directCacheable: boolean;
8
+ };
9
+
10
+ // An IP-bound artifact minted without any recorded egress identity is unsafe to
11
+ // share. The Akamai kinds therefore reject direct caching, while Cloudflare
12
+ // keeps its pre-existing direct-cache behavior pending measurement.
13
+ export const RESOLVER_CHALLENGE_BINDINGS = {
14
+ turnstile: { cacheable: false, identityBinding: "none", directCacheable: false },
15
+ recaptcha_v2: { cacheable: false, identityBinding: "none", directCacheable: false },
16
+ recaptcha_v3: { cacheable: false, identityBinding: "none", directCacheable: false },
17
+ hcaptcha: { cacheable: false, identityBinding: "none", directCacheable: false },
18
+ cloudflare_interstitial: {
19
+ cacheable: true,
20
+ identityBinding: "identity_scoped",
21
+ directCacheable: true,
22
+ },
23
+ aws_waf: { cacheable: true, identityBinding: "portable", directCacheable: true },
24
+ akamai_sec_cpt: {
25
+ cacheable: true,
26
+ identityBinding: "identity_scoped",
27
+ directCacheable: false,
28
+ },
29
+ akamai_sensor: {
30
+ cacheable: true,
31
+ identityBinding: "identity_scoped",
32
+ directCacheable: false,
33
+ },
34
+ } as const satisfies Readonly<Record<ProviderChallengeKind, ResolverChallengeBinding>>;
35
+
36
+ export function resolverChallengeIsCacheable(challenge: ProviderChallenge): boolean {
37
+ return RESOLVER_CHALLENGE_BINDINGS[challenge.kind].cacheable;
38
+ }
39
+
40
+ export function resolverChallengeAllowsDirectCache(challenge: ProviderChallenge): boolean {
41
+ return RESOLVER_CHALLENGE_BINDINGS[challenge.kind].directCacheable;
42
+ }
43
+
44
+ export function resolverChallengeIsIdentityScoped(challenge: ProviderChallenge): boolean {
45
+ return RESOLVER_CHALLENGE_BINDINGS[challenge.kind].identityBinding === "identity_scoped";
46
+ }
47
+
48
+ export function resolverChallengeIssuingIdentity(
49
+ challenge: ProviderChallenge,
50
+ identity: ResolverIssuingIdentity,
51
+ ): ResolverIssuingIdentity {
52
+ if (RESOLVER_CHALLENGE_BINDINGS[challenge.kind].identityBinding === "portable") {
53
+ return { userAgent: identity.userAgent };
54
+ }
55
+ return identity;
56
+ }
@@ -0,0 +1,533 @@
1
+ import { isProviderError } from "../../errors.js";
2
+ import type {
3
+ BrowserClient,
4
+ BrowserCookie,
5
+ BrowserPage,
6
+ ChallengeSolution,
7
+ ProviderChallenge,
8
+ } from "../../types.js";
9
+ import { type BrowserClientOptions, createBrowserClient } from "../browser.js";
10
+ import type { TraceRecorder } from "../trace.js";
11
+ import { resolverChallengeIssuingIdentity } from "./bindings.js";
12
+ import { assertResolverHostAllowed, normalizedResolverHostname } from "./hosts.js";
13
+ import {
14
+ type ResolverIdentity,
15
+ type ResolverVendorAdapter,
16
+ ResolverVendorUnavailableError,
17
+ } from "./types.js";
18
+
19
+ const BROWSER_VENDOR_ID = "browser" as const;
20
+ const DEFAULT_COOKIE_POLL_INTERVAL_MS = 100;
21
+ const NAVIGATION_BLOCKED_ERROR_TEXT = "net::ERR_BLOCKED_BY_CLIENT";
22
+ const AWS_WAF_CHALLENGE_INFRASTRUCTURE_HOST_SUFFIX = ".awswaf.com";
23
+ const RESOLVER_DOCUMENT_CONTENT_SECURITY_POLICY = "connect-src http: https:; worker-src 'none'";
24
+
25
+ const SUCCESS_COOKIE_NAMES = {
26
+ aws_waf: "aws-waf-token",
27
+ cloudflare_interstitial: "cf_clearance",
28
+ } as const;
29
+
30
+ type SupportedBrowserChallengeKind = keyof typeof SUCCESS_COOKIE_NAMES;
31
+
32
+ type BrowserClientFactory = (options: BrowserClientOptions) => BrowserClient;
33
+
34
+ let createResolverBrowserClient: BrowserClientFactory = createBrowserClient;
35
+
36
+ /** Internal test seam; deliberately not re-exported from the package root. */
37
+ export function swapBrowserResolverClientFactoryForTests(
38
+ factory: BrowserClientFactory | undefined,
39
+ ): () => void {
40
+ const original = createResolverBrowserClient;
41
+ createResolverBrowserClient = factory ?? createBrowserClient;
42
+ let restored = false;
43
+ return () => {
44
+ if (restored) return;
45
+ restored = true;
46
+ createResolverBrowserClient = original;
47
+ };
48
+ }
49
+
50
+ export interface BrowserResolverVendorOptions {
51
+ readonly cdpUrl?: string;
52
+ readonly timeoutMs: number;
53
+ readonly pollIntervalMs?: number;
54
+ readonly allowedHosts: readonly string[];
55
+ readonly createClient?: BrowserClientFactory;
56
+ }
57
+
58
+ export interface BrowserResolverVendorAdapter extends ResolverVendorAdapter {
59
+ readonly id: "browser";
60
+ solve(
61
+ challenge: ProviderChallenge,
62
+ identity: ResolverIdentity | undefined,
63
+ signal: AbortSignal,
64
+ traceRecorder?: TraceRecorder,
65
+ ): Promise<Extract<ChallengeSolution, { readonly form: "cookies" }>>;
66
+ }
67
+
68
+ class BrowserSolveTimeoutError extends Error {
69
+ constructor(blockedRequests: readonly string[]) {
70
+ super(
71
+ `Browser resolver solve budget elapsed${formatBlockedRequests(blockedRequests)}`,
72
+ );
73
+ this.name = "BrowserSolveTimeoutError";
74
+ }
75
+ }
76
+
77
+ class BrowserNavigationBlockedError extends Error {
78
+ readonly code = "RESOLVER_BROWSER_NAVIGATION_BLOCKED";
79
+
80
+ constructor(
81
+ readonly navigationUrl: string,
82
+ readonly blockedUrls: readonly string[],
83
+ options: ErrorOptions,
84
+ ) {
85
+ super(
86
+ `Browser resolver navigation was blocked for ${navigationUrl}${formatBlockedRequests(blockedUrls)}`,
87
+ options,
88
+ );
89
+ this.name = "BrowserNavigationBlockedError";
90
+ }
91
+ }
92
+
93
+ function formatBlockedRequests(blockedRequests: readonly string[]): string {
94
+ if (blockedRequests.length === 0) return "";
95
+ const displayed = blockedRequests.slice(0, 5);
96
+ const remainder = blockedRequests.length - displayed.length;
97
+ return `; blocked ${blockedRequests.length} requests: [${displayed.join(", ")}]${remainder > 0 ? ` (+${remainder} more)` : ""}`;
98
+ }
99
+
100
+ function isNavigationBlockedError(error: unknown): error is Error {
101
+ return error instanceof Error && error.message.includes(NAVIGATION_BLOCKED_ERROR_TEXT);
102
+ }
103
+
104
+ class BrowserCleanupTimeoutError extends Error {
105
+ constructor(timeoutMs: number) {
106
+ super(`Browser resolver cleanup exceeded ${timeoutMs}ms`);
107
+ this.name = "BrowserCleanupTimeoutError";
108
+ }
109
+ }
110
+
111
+ function abortReason(signal: AbortSignal): unknown {
112
+ return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
113
+ }
114
+
115
+ function raceWithAbort<T>(operation: () => Promise<T>, signal: AbortSignal): Promise<T> {
116
+ if (signal.aborted) {
117
+ return Promise.reject(abortReason(signal));
118
+ }
119
+
120
+ return new Promise<T>((resolve, reject) => {
121
+ const cleanup = () => signal.removeEventListener("abort", onAbort);
122
+ const onAbort = () => {
123
+ cleanup();
124
+ reject(abortReason(signal));
125
+ };
126
+ signal.addEventListener("abort", onAbort, { once: true });
127
+ operation().then(
128
+ (value) => {
129
+ cleanup();
130
+ resolve(value);
131
+ },
132
+ (error: unknown) => {
133
+ cleanup();
134
+ reject(error);
135
+ },
136
+ );
137
+ });
138
+ }
139
+
140
+ async function runBoundedCleanup(
141
+ cleanup: () => Promise<unknown>,
142
+ timeoutMs: number,
143
+ challengeKind: ProviderChallenge["kind"],
144
+ operation: "client.close" | "context.close",
145
+ traceRecorder: TraceRecorder | undefined,
146
+ ): Promise<void> {
147
+ let timeout: ReturnType<typeof setTimeout> | undefined;
148
+ const boundedCleanup = async () => {
149
+ try {
150
+ await Promise.race([
151
+ cleanup(),
152
+ new Promise<never>((_resolve, reject) => {
153
+ timeout = setTimeout(() => reject(new BrowserCleanupTimeoutError(timeoutMs)), timeoutMs);
154
+ }),
155
+ ]);
156
+ } finally {
157
+ if (timeout !== undefined) clearTimeout(timeout);
158
+ }
159
+ };
160
+
161
+ if (!traceRecorder) {
162
+ await boundedCleanup().catch(() => undefined);
163
+ return;
164
+ }
165
+
166
+ await traceRecorder
167
+ .runSpan("resolver.vendor.cleanup", boundedCleanup, {
168
+ attributes: {
169
+ vendor: BROWSER_VENDOR_ID,
170
+ challenge_kind: challengeKind,
171
+ operation,
172
+ },
173
+ onError(error) {
174
+ return {
175
+ error_message: error instanceof Error ? error.message : String(error),
176
+ ...(error instanceof Error && error.stack ? { error_stack: error.stack } : {}),
177
+ };
178
+ },
179
+ })
180
+ .catch(() => undefined);
181
+ }
182
+
183
+ async function abortableDelay(ms: number, signal: AbortSignal): Promise<void> {
184
+ let timer: ReturnType<typeof setTimeout> | undefined;
185
+ try {
186
+ await raceWithAbort(
187
+ () =>
188
+ new Promise<void>((resolve) => {
189
+ timer = setTimeout(resolve, ms);
190
+ }),
191
+ signal,
192
+ );
193
+ } finally {
194
+ if (timer !== undefined) clearTimeout(timer);
195
+ }
196
+ }
197
+
198
+ function isSupportedKind(kind: string): kind is SupportedBrowserChallengeKind {
199
+ return Object.hasOwn(SUCCESS_COOKIE_NAMES, kind);
200
+ }
201
+
202
+ function cookieDomainSpecificity(cookie: BrowserCookie): number {
203
+ return normalizedResolverHostname(cookie.domain.replace(/^\./, "")).length;
204
+ }
205
+
206
+ function isHostOnlyCookieFor(cookie: BrowserCookie, hostname: string): boolean {
207
+ return (
208
+ !cookie.domain.startsWith(".") &&
209
+ normalizedResolverHostname(cookie.domain) === normalizedResolverHostname(hostname)
210
+ );
211
+ }
212
+
213
+ function cookieAppliesToUrl(cookie: BrowserCookie, url: URL): boolean {
214
+ const cookieDomain = normalizedResolverHostname(cookie.domain.replace(/^\./, ""));
215
+ const requestHostname = normalizedResolverHostname(url.hostname);
216
+ const domainMatches =
217
+ cookieDomain.length > 0 &&
218
+ (requestHostname === cookieDomain ||
219
+ (cookie.domain.startsWith(".") && requestHostname.endsWith(`.${cookieDomain}`)));
220
+ if (!domainMatches || (cookie.secure && url.protocol !== "https:")) return false;
221
+
222
+ const requestPath = url.pathname || "/";
223
+ const cookiePath = cookie.path;
224
+ return (
225
+ cookiePath.startsWith("/") &&
226
+ (requestPath === cookiePath ||
227
+ (requestPath.startsWith(cookiePath) &&
228
+ (cookiePath.endsWith("/") || requestPath[cookiePath.length] === "/")))
229
+ );
230
+ }
231
+
232
+ function selectSuccessCookie(
233
+ cookies: readonly BrowserCookie[],
234
+ successCookieName: string,
235
+ pageUrl: string,
236
+ ): BrowserCookie | undefined {
237
+ const url = new URL(pageUrl);
238
+ return cookies
239
+ .filter((cookie) => cookie.name === successCookieName && cookieAppliesToUrl(cookie, url))
240
+ .sort(
241
+ (left, right) =>
242
+ Number(isHostOnlyCookieFor(right, url.hostname)) -
243
+ Number(isHostOnlyCookieFor(left, url.hostname)) ||
244
+ cookieDomainSpecificity(right) - cookieDomainSpecificity(left) ||
245
+ right.path.length - left.path.length,
246
+ )[0];
247
+ }
248
+
249
+ async function solveInPage(
250
+ page: BrowserPage,
251
+ challengeKind: SupportedBrowserChallengeKind,
252
+ pageUrl: string,
253
+ allowedHosts: readonly string[],
254
+ successCookieName: string,
255
+ pollIntervalMs: number,
256
+ gotoTimeoutMs: number,
257
+ blockedRequests: Set<string>,
258
+ signal: AbortSignal,
259
+ ): Promise<Extract<ChallengeSolution, { readonly form: "cookies" }>> {
260
+ return await page.withResourcePolicy(
261
+ {
262
+ allowedMethods: ["GET", "HEAD", "POST"],
263
+ documentContentSecurityPolicy: RESOLVER_DOCUMENT_CONTENT_SECURITY_POLICY,
264
+ routes: [
265
+ {
266
+ match: () => true,
267
+ handle: (request) => {
268
+ if (isResolverBrowserRequestAllowed(request.url, challengeKind, allowedHosts)) {
269
+ return { action: "continue" };
270
+ }
271
+ blockedRequests.add(request.url);
272
+ return { action: "block" };
273
+ },
274
+ },
275
+ ],
276
+ },
277
+ async () => {
278
+ const userAgent = await raceWithAbort(
279
+ () => page.userAgent(),
280
+ signal,
281
+ );
282
+ try {
283
+ await raceWithAbort(
284
+ () =>
285
+ page.goto(pageUrl, {
286
+ timeout: gotoTimeoutMs,
287
+ waitUntil: "domcontentloaded",
288
+ }),
289
+ signal,
290
+ );
291
+ } catch (error) {
292
+ if (!isNavigationBlockedError(error)) throw error;
293
+ throw new BrowserNavigationBlockedError(pageUrl, [...blockedRequests], { cause: error });
294
+ }
295
+
296
+ while (true) {
297
+ const cookies = await raceWithAbort(() => page.cookies(), signal);
298
+ const successCookie = selectSuccessCookie(cookies, successCookieName, pageUrl);
299
+ if (successCookie) {
300
+ return {
301
+ form: "cookies",
302
+ cookies: { [successCookieName]: successCookie.value },
303
+ userAgent,
304
+ ...(successCookie.expires === undefined ? {} : { expires: successCookie.expires }),
305
+ };
306
+ }
307
+
308
+ await abortableDelay(pollIntervalMs, signal);
309
+ }
310
+ },
311
+ );
312
+ }
313
+
314
+ function isResolverBrowserRequestAllowed(
315
+ targetUrl: string,
316
+ challengeKind: SupportedBrowserChallengeKind,
317
+ allowedHosts: readonly string[],
318
+ ): boolean {
319
+ try {
320
+ assertResolverHostAllowed(targetUrl, allowedHosts);
321
+ return true;
322
+ } catch {
323
+ if (challengeKind !== "aws_waf") return false;
324
+ }
325
+
326
+ let target: URL;
327
+ try {
328
+ target = new URL(targetUrl);
329
+ } catch {
330
+ return false;
331
+ }
332
+ const hostname = normalizedResolverHostname(target.hostname);
333
+ return (
334
+ target.protocol === "https:" &&
335
+ hostname.length > AWS_WAF_CHALLENGE_INFRASTRUCTURE_HOST_SUFFIX.length &&
336
+ hostname.endsWith(AWS_WAF_CHALLENGE_INFRASTRUCTURE_HOST_SUFFIX)
337
+ );
338
+ }
339
+
340
+ const POOL_ALLOCATION_EXHAUSTED_CODES = new Set([
341
+ -32_001, // queue full
342
+ -32_002, // acquire timed out
343
+ -32_003, // shutting down
344
+ ]);
345
+
346
+ function poolErrorCode(error: Error): number | undefined {
347
+ const code = (error as Error & { readonly code?: unknown }).code;
348
+ return typeof code === "number" ? code : undefined;
349
+ }
350
+
351
+ function knownUnavailableReason(
352
+ error: unknown,
353
+ beforePageSolve = false,
354
+ ): "allocation_exhausted" | "missing_credentials" | "transport_failure" | undefined {
355
+ // Source-grounded mappings:
356
+ // - apps/cdp-pool/src/index.ts: the JSON-RPC codes and messages below.
357
+ // - src/runtime/browser.ts: BROWSER_CDP_POOL_REQUIRED and the two WebSocket messages.
358
+ // The pool's numeric JSON-RPC code is authoritative and is preferred whenever present.
359
+ // The message substrings remain as a fallback for pool builds predating code
360
+ // propagation; they are exact strings verified against the pool source. -32004 (unknown
361
+ // lease) and -32006 (missing allowedHosts) are deliberately unmapped: both are caller
362
+ // bugs, and the next vendor would fail identically, so they propagate unchanged.
363
+ if (isProviderError(error)) {
364
+ return error.code === "BROWSER_CDP_POOL_REQUIRED" ? "missing_credentials" : undefined;
365
+ }
366
+ if (!(error instanceof Error)) return undefined;
367
+
368
+ const code = poolErrorCode(error);
369
+ if (code !== undefined) {
370
+ return POOL_ALLOCATION_EXHAUSTED_CODES.has(code) ? "allocation_exhausted" : undefined;
371
+ }
372
+
373
+ if (
374
+ error.message.includes("CDP pool acquire queue is full") ||
375
+ error.message.includes("CDP pool acquire timed out") ||
376
+ error.message.includes("CDP pool is shutting down")
377
+ ) {
378
+ return "allocation_exhausted";
379
+ }
380
+
381
+ if (
382
+ error.message.includes("Unable to connect to WebSocket endpoint") ||
383
+ error.message.includes("WebSocket closed")
384
+ ) {
385
+ return "transport_failure";
386
+ }
387
+
388
+ // Browser creation, Playwright launch, and CDP connection all happen before the
389
+ // isolated-page handler is entered. Errors after that boundary belong to the
390
+ // challenge solve and must retain their existing classification.
391
+ return beforePageSolve ? "transport_failure" : undefined;
392
+ }
393
+
394
+ async function closeBrowserClient(
395
+ client: BrowserClient | undefined,
396
+ timeoutMs: number,
397
+ challengeKind: ProviderChallenge["kind"],
398
+ traceRecorder: TraceRecorder | undefined,
399
+ ): Promise<void> {
400
+ const close = client?.close;
401
+ if (!close) return;
402
+ await runBoundedCleanup(
403
+ () => close.call(client),
404
+ timeoutMs,
405
+ challengeKind,
406
+ "client.close",
407
+ traceRecorder,
408
+ );
409
+ }
410
+
411
+ export function createBrowserResolverVendorAdapter(
412
+ options: BrowserResolverVendorOptions,
413
+ ): BrowserResolverVendorAdapter {
414
+ const createClient = options.createClient ?? createResolverBrowserClient;
415
+ const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_COOKIE_POLL_INTERVAL_MS;
416
+
417
+ return {
418
+ id: BROWSER_VENDOR_ID,
419
+
420
+ supports(kind) {
421
+ return isSupportedKind(kind);
422
+ },
423
+
424
+ getIssuingIdentity(solution, requestedIdentity, challenge) {
425
+ if (solution.form !== "cookies" || !isSupportedKind(challenge.kind)) return undefined;
426
+ return resolverChallengeIssuingIdentity(challenge, {
427
+ ...(requestedIdentity ? { proxyUrl: requestedIdentity.proxyUrl } : {}),
428
+ userAgent: solution.userAgent,
429
+ });
430
+ },
431
+
432
+ async solve(challenge, identity, callerSignal, traceRecorder) {
433
+ const cdpUrl = options.cdpUrl?.trim();
434
+ const proxyUrl = identity?.proxyUrl;
435
+ if (!cdpUrl && proxyUrl === undefined) {
436
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, "missing_credentials");
437
+ }
438
+ if (!isSupportedKind(challenge.kind)) {
439
+ throw new TypeError(`Browser resolver does not support ${challenge.kind}`);
440
+ }
441
+ assertResolverHostAllowed(challenge.pageUrl, options.allowedHosts);
442
+ const challengeKind = challenge.kind;
443
+ callerSignal.throwIfAborted();
444
+ if (proxyUrl !== undefined && proxyUrl.length === 0) {
445
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, "missing_proxy_identity");
446
+ }
447
+ if (cdpUrl && proxyUrl !== undefined) {
448
+ // The current pool acquire protocol cannot bind a proxy to its browser context.
449
+ // Refuse so the chain can choose a vendor that can honor the resolved identity.
450
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, "not_implemented");
451
+ }
452
+
453
+ const blockedRequests = new Set<string>();
454
+ const solveController = new AbortController();
455
+ const onCallerAbort = () => solveController.abort(abortReason(callerSignal));
456
+ callerSignal.addEventListener("abort", onCallerAbort, { once: true });
457
+ const timeout = setTimeout(
458
+ () => solveController.abort(new BrowserSolveTimeoutError([...blockedRequests])),
459
+ options.timeoutMs,
460
+ );
461
+
462
+ let client: BrowserClient | undefined;
463
+ let handlerEntered = false;
464
+ try {
465
+ client = createClient({
466
+ allowedHosts: [...options.allowedHosts],
467
+ cdpUrl: cdpUrl ?? "",
468
+ ...(proxyUrl === undefined ? {} : { proxy: proxyUrl }),
469
+ requireCdpPool: cdpUrl !== undefined,
470
+ serviceWorkers: "block",
471
+ });
472
+ const contextOperation = client.withIsolatedContext(async (page) => {
473
+ handlerEntered = true;
474
+ return await solveInPage(
475
+ page,
476
+ challengeKind,
477
+ challenge.pageUrl,
478
+ options.allowedHosts,
479
+ SUCCESS_COOKIE_NAMES[challengeKind],
480
+ pollIntervalMs,
481
+ options.timeoutMs,
482
+ blockedRequests,
483
+ solveController.signal,
484
+ );
485
+ });
486
+
487
+ try {
488
+ return await raceWithAbort(() => contextOperation, solveController.signal);
489
+ } catch (error) {
490
+ if (solveController.signal.aborted) {
491
+ if (handlerEntered) {
492
+ await runBoundedCleanup(
493
+ () => contextOperation,
494
+ options.timeoutMs,
495
+ challengeKind,
496
+ "context.close",
497
+ traceRecorder,
498
+ );
499
+ throw error;
500
+ }
501
+ await closeBrowserClient(client, options.timeoutMs, challengeKind, traceRecorder);
502
+ void contextOperation.catch(() => undefined);
503
+ }
504
+ throw error;
505
+ }
506
+ } catch (error) {
507
+ if (callerSignal.aborted) throw abortReason(callerSignal);
508
+ if (error instanceof BrowserSolveTimeoutError) {
509
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, "timeout", {
510
+ cause: error,
511
+ });
512
+ }
513
+ if (error instanceof BrowserNavigationBlockedError) {
514
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, "transport_failure", {
515
+ cause: error,
516
+ });
517
+ }
518
+ if (error instanceof ResolverVendorUnavailableError) {
519
+ throw error;
520
+ }
521
+ const reason = knownUnavailableReason(error, !handlerEntered);
522
+ if (reason) {
523
+ throw new ResolverVendorUnavailableError(BROWSER_VENDOR_ID, reason, { cause: error });
524
+ }
525
+ throw error;
526
+ } finally {
527
+ clearTimeout(timeout);
528
+ callerSignal.removeEventListener("abort", onCallerAbort);
529
+ await closeBrowserClient(client, options.timeoutMs, challengeKind, traceRecorder);
530
+ }
531
+ },
532
+ };
533
+ }