pi-cursor-sdk 0.1.50 → 0.1.52

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 (279) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +1 -1
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +3 -12
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-turn-runner.ts +1 -1
  12. package/src/cursor-provider.ts +9 -2
  13. package/src/cursor-session-turn-queue.ts +52 -0
  14. package/src/cursor-tool-manifest.ts +1 -1
  15. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  42. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  44. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  48. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  52. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  54. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  56. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  68. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  69. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  70. package/node_modules/undici/LICENSE +0 -21
  71. package/node_modules/undici/README.md +0 -741
  72. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  73. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  74. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  75. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  76. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  77. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  78. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  79. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  80. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  81. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  82. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  83. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  84. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  85. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  86. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  87. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  88. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  89. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  90. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  91. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  92. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  93. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  94. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  95. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  96. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  97. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  98. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  99. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  100. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  101. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  102. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  103. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  104. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  105. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  106. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  107. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  108. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  109. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  110. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  111. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  112. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  113. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  114. package/node_modules/undici/index-fetch.js +0 -65
  115. package/node_modules/undici/index.d.ts +0 -3
  116. package/node_modules/undici/index.js +0 -234
  117. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  118. package/node_modules/undici/lib/api/api-connect.js +0 -110
  119. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  120. package/node_modules/undici/lib/api/api-request.js +0 -214
  121. package/node_modules/undici/lib/api/api-stream.js +0 -209
  122. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  123. package/node_modules/undici/lib/api/index.js +0 -7
  124. package/node_modules/undici/lib/api/readable.js +0 -580
  125. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  126. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  127. package/node_modules/undici/lib/core/connect.js +0 -153
  128. package/node_modules/undici/lib/core/constants.js +0 -143
  129. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  130. package/node_modules/undici/lib/core/errors.js +0 -477
  131. package/node_modules/undici/lib/core/request.js +0 -453
  132. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  133. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  134. package/node_modules/undici/lib/core/symbols.js +0 -75
  135. package/node_modules/undici/lib/core/tree.js +0 -160
  136. package/node_modules/undici/lib/core/util.js +0 -992
  137. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  138. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  139. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  140. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  141. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  142. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  143. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  144. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  145. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  146. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  147. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  148. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  149. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  150. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  151. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  152. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  153. package/node_modules/undici/lib/encoding/index.js +0 -33
  154. package/node_modules/undici/lib/global.js +0 -59
  155. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  156. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  157. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  158. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  159. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  160. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  161. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  162. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  163. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  164. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  165. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  166. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  167. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  168. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  169. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  170. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  171. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  172. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  173. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  174. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  176. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  177. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  178. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  179. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  180. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  181. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  182. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  183. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  184. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  185. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  186. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  187. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  188. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  189. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  190. package/node_modules/undici/lib/util/cache.js +0 -414
  191. package/node_modules/undici/lib/util/date.js +0 -653
  192. package/node_modules/undici/lib/util/promise.js +0 -28
  193. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  194. package/node_modules/undici/lib/util/stats.js +0 -32
  195. package/node_modules/undici/lib/util/timers.js +0 -425
  196. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  197. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  198. package/node_modules/undici/lib/web/cache/util.js +0 -45
  199. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  200. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  201. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  202. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  203. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  204. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  205. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  206. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  207. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  208. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  209. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  210. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  211. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  212. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  213. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  214. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  215. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  216. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  217. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  218. package/node_modules/undici/lib/web/infra/index.js +0 -229
  219. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  220. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  221. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  222. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  223. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  224. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  225. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  226. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  227. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  228. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  229. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  230. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  231. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  232. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  233. package/node_modules/undici/package.json +0 -152
  234. package/node_modules/undici/scripts/strip-comments.js +0 -10
  235. package/node_modules/undici/types/README.md +0 -6
  236. package/node_modules/undici/types/agent.d.ts +0 -32
  237. package/node_modules/undici/types/api.d.ts +0 -43
  238. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  239. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  240. package/node_modules/undici/types/cache.d.ts +0 -36
  241. package/node_modules/undici/types/client-stats.d.ts +0 -15
  242. package/node_modules/undici/types/client.d.ts +0 -139
  243. package/node_modules/undici/types/connector.d.ts +0 -36
  244. package/node_modules/undici/types/content-type.d.ts +0 -21
  245. package/node_modules/undici/types/cookies.d.ts +0 -30
  246. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  247. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  248. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  249. package/node_modules/undici/types/errors.d.ts +0 -177
  250. package/node_modules/undici/types/eventsource.d.ts +0 -66
  251. package/node_modules/undici/types/fetch.d.ts +0 -231
  252. package/node_modules/undici/types/formdata.d.ts +0 -114
  253. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  254. package/node_modules/undici/types/global-origin.d.ts +0 -7
  255. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  256. package/node_modules/undici/types/handlers.d.ts +0 -14
  257. package/node_modules/undici/types/header.d.ts +0 -160
  258. package/node_modules/undici/types/index.d.ts +0 -91
  259. package/node_modules/undici/types/interceptors.d.ts +0 -80
  260. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  261. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  262. package/node_modules/undici/types/mock-client.d.ts +0 -27
  263. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  264. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  265. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  266. package/node_modules/undici/types/patch.d.ts +0 -29
  267. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  268. package/node_modules/undici/types/pool.d.ts +0 -41
  269. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  270. package/node_modules/undici/types/readable.d.ts +0 -68
  271. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  272. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  273. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  274. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  275. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  276. package/node_modules/undici/types/util.d.ts +0 -18
  277. package/node_modules/undici/types/utility.d.ts +0 -7
  278. package/node_modules/undici/types/webidl.d.ts +0 -347
  279. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -1,238 +0,0 @@
1
- 'use strict'
2
-
3
- const util = require('../core/util')
4
- const { kBodyUsed } = require('../core/symbols')
5
- const assert = require('node:assert')
6
- const { InvalidArgumentError } = require('../core/errors')
7
- const EE = require('node:events')
8
-
9
- const redirectableStatusCodes = [300, 301, 302, 303, 307, 308]
10
-
11
- const kBody = Symbol('body')
12
-
13
- const noop = () => {}
14
-
15
- class BodyAsyncIterable {
16
- constructor (body) {
17
- this[kBody] = body
18
- this[kBodyUsed] = false
19
- }
20
-
21
- async * [Symbol.asyncIterator] () {
22
- assert(!this[kBodyUsed], 'disturbed')
23
- this[kBodyUsed] = true
24
- yield * this[kBody]
25
- }
26
- }
27
-
28
- class RedirectHandler {
29
- static buildDispatch (dispatcher, maxRedirections) {
30
- if (maxRedirections != null && (!Number.isInteger(maxRedirections) || maxRedirections < 0)) {
31
- throw new InvalidArgumentError('maxRedirections must be a positive number')
32
- }
33
-
34
- const dispatch = dispatcher.dispatch.bind(dispatcher)
35
- return (opts, originalHandler) => dispatch(opts, new RedirectHandler(dispatch, maxRedirections, opts, originalHandler))
36
- }
37
-
38
- constructor (dispatch, maxRedirections, opts, handler) {
39
- if (maxRedirections != null && (!Number.isInteger(maxRedirections) || maxRedirections < 0)) {
40
- throw new InvalidArgumentError('maxRedirections must be a positive number')
41
- }
42
-
43
- this.dispatch = dispatch
44
- this.location = null
45
- const { maxRedirections: _, ...cleanOpts } = opts
46
- this.opts = cleanOpts // opts must be a copy, exclude maxRedirections
47
- this.maxRedirections = maxRedirections
48
- this.handler = handler
49
- this.history = []
50
-
51
- if (util.isStream(this.opts.body)) {
52
- // TODO (fix): Provide some way for the user to cache the file to e.g. /tmp
53
- // so that it can be dispatched again?
54
- // TODO (fix): Do we need 100-expect support to provide a way to do this properly?
55
- if (util.bodyLength(this.opts.body) === 0) {
56
- this.opts.body
57
- .on('data', function () {
58
- assert(false)
59
- })
60
- }
61
-
62
- if (typeof this.opts.body.readableDidRead !== 'boolean') {
63
- this.opts.body[kBodyUsed] = false
64
- EE.prototype.on.call(this.opts.body, 'data', function () {
65
- this[kBodyUsed] = true
66
- })
67
- }
68
- } else if (this.opts.body && typeof this.opts.body.pipeTo === 'function') {
69
- // TODO (fix): We can't access ReadableStream internal state
70
- // to determine whether or not it has been disturbed. This is just
71
- // a workaround.
72
- this.opts.body = new BodyAsyncIterable(this.opts.body)
73
- } else if (
74
- this.opts.body &&
75
- typeof this.opts.body !== 'string' &&
76
- !ArrayBuffer.isView(this.opts.body) &&
77
- util.isIterable(this.opts.body) &&
78
- !util.isFormDataLike(this.opts.body)
79
- ) {
80
- // TODO: Should we allow re-using iterable if !this.opts.idempotent
81
- // or through some other flag?
82
- this.opts.body = new BodyAsyncIterable(this.opts.body)
83
- }
84
- }
85
-
86
- onRequestStart (controller, context) {
87
- this.handler.onRequestStart?.(controller, { ...context, history: this.history })
88
- }
89
-
90
- onRequestUpgrade (controller, statusCode, headers, socket) {
91
- this.handler.onRequestUpgrade?.(controller, statusCode, headers, socket)
92
- }
93
-
94
- onResponseStart (controller, statusCode, headers, statusMessage) {
95
- if (this.opts.throwOnMaxRedirect && this.history.length >= this.maxRedirections) {
96
- throw new Error('max redirects')
97
- }
98
-
99
- // https://tools.ietf.org/html/rfc7231#section-6.4.2
100
- // https://fetch.spec.whatwg.org/#http-redirect-fetch
101
- // In case of HTTP 301 or 302 with POST, change the method to GET
102
- if ((statusCode === 301 || statusCode === 302) && this.opts.method === 'POST') {
103
- this.opts.method = 'GET'
104
- if (util.isStream(this.opts.body)) {
105
- util.destroy(this.opts.body.on('error', noop))
106
- }
107
- this.opts.body = null
108
- }
109
-
110
- // https://tools.ietf.org/html/rfc7231#section-6.4.4
111
- // In case of HTTP 303, always replace method to be either HEAD or GET
112
- if (statusCode === 303 && this.opts.method !== 'HEAD') {
113
- this.opts.method = 'GET'
114
- if (util.isStream(this.opts.body)) {
115
- util.destroy(this.opts.body.on('error', noop))
116
- }
117
- this.opts.body = null
118
- }
119
-
120
- this.location = this.history.length >= this.maxRedirections || util.isDisturbed(this.opts.body) || redirectableStatusCodes.indexOf(statusCode) === -1
121
- ? null
122
- : headers.location
123
-
124
- if (this.opts.origin) {
125
- this.history.push(new URL(this.opts.path, this.opts.origin))
126
- }
127
-
128
- if (!this.location) {
129
- this.handler.onResponseStart?.(controller, statusCode, headers, statusMessage)
130
- return
131
- }
132
-
133
- const { origin, pathname, search } = util.parseURL(new URL(this.location, this.opts.origin && new URL(this.opts.path, this.opts.origin)))
134
- const path = search ? `${pathname}${search}` : pathname
135
-
136
- // Check for redirect loops by seeing if we've already visited this URL in our history
137
- // This catches the case where Client/Pool try to handle cross-origin redirects but fail
138
- // and keep redirecting to the same URL in an infinite loop
139
- const redirectUrlString = `${origin}${path}`
140
- for (const historyUrl of this.history) {
141
- if (historyUrl.toString() === redirectUrlString) {
142
- throw new InvalidArgumentError(`Redirect loop detected. Cannot redirect to ${origin}. This typically happens when using a Client or Pool with cross-origin redirects. Use an Agent for cross-origin redirects.`)
143
- }
144
- }
145
-
146
- // Remove headers referring to the original URL.
147
- // By default it is Host only, unless it's a 303 (see below), which removes also all Content-* headers.
148
- // https://tools.ietf.org/html/rfc7231#section-6.4
149
- this.opts.headers = cleanRequestHeaders(this.opts.headers, statusCode === 303, this.opts.origin !== origin)
150
- this.opts.path = path
151
- this.opts.origin = origin
152
- this.opts.query = null
153
- }
154
-
155
- onResponseData (controller, chunk) {
156
- if (this.location) {
157
- /*
158
- https://tools.ietf.org/html/rfc7231#section-6.4
159
-
160
- TLDR: undici always ignores 3xx response bodies.
161
-
162
- Redirection is used to serve the requested resource from another URL, so it assumes that
163
- no body is generated (and thus can be ignored). Even though generating a body is not prohibited.
164
-
165
- For status 301, 302, 303, 307 and 308 (the latter from RFC 7238), the specs mention that the body usually
166
- (which means it's optional and not mandated) contain just an hyperlink to the value of
167
- the Location response header, so the body can be ignored safely.
168
-
169
- For status 300, which is "Multiple Choices", the spec mentions both generating a Location
170
- response header AND a response body with the other possible location to follow.
171
- Since the spec explicitly chooses not to specify a format for such body and leave it to
172
- servers and browsers implementors, we ignore the body as there is no specified way to eventually parse it.
173
- */
174
- } else {
175
- this.handler.onResponseData?.(controller, chunk)
176
- }
177
- }
178
-
179
- onResponseEnd (controller, trailers) {
180
- if (this.location) {
181
- /*
182
- https://tools.ietf.org/html/rfc7231#section-6.4
183
-
184
- TLDR: undici always ignores 3xx response trailers as they are not expected in case of redirections
185
- and neither are useful if present.
186
-
187
- See comment on onData method above for more detailed information.
188
- */
189
- this.dispatch(this.opts, this)
190
- } else {
191
- this.handler.onResponseEnd(controller, trailers)
192
- }
193
- }
194
-
195
- onResponseError (controller, error) {
196
- this.handler.onResponseError?.(controller, error)
197
- }
198
- }
199
-
200
- // https://tools.ietf.org/html/rfc7231#section-6.4.4
201
- function shouldRemoveHeader (header, removeContent, unknownOrigin) {
202
- if (header.length === 4) {
203
- return util.headerNameToString(header) === 'host'
204
- }
205
- if (removeContent && util.headerNameToString(header).startsWith('content-')) {
206
- return true
207
- }
208
- if (unknownOrigin && (header.length === 13 || header.length === 6 || header.length === 19)) {
209
- const name = util.headerNameToString(header)
210
- return name === 'authorization' || name === 'cookie' || name === 'proxy-authorization'
211
- }
212
- return false
213
- }
214
-
215
- // https://tools.ietf.org/html/rfc7231#section-6.4
216
- function cleanRequestHeaders (headers, removeContent, unknownOrigin) {
217
- const ret = []
218
- if (Array.isArray(headers)) {
219
- for (let i = 0; i < headers.length; i += 2) {
220
- if (!shouldRemoveHeader(headers[i], removeContent, unknownOrigin)) {
221
- ret.push(headers[i], headers[i + 1])
222
- }
223
- }
224
- } else if (headers && typeof headers === 'object') {
225
- const entries = util.hasSafeIterator(headers) ? headers : Object.entries(headers)
226
-
227
- for (const [key, value] of entries) {
228
- if (!shouldRemoveHeader(key, removeContent, unknownOrigin)) {
229
- ret.push(key, value)
230
- }
231
- }
232
- } else {
233
- assert(headers == null, 'headers must be an object or an array')
234
- }
235
- return ret
236
- }
237
-
238
- module.exports = RedirectHandler
@@ -1,394 +0,0 @@
1
- 'use strict'
2
- const assert = require('node:assert')
3
-
4
- const { kRetryHandlerDefaultRetry } = require('../core/symbols')
5
- const { RequestRetryError } = require('../core/errors')
6
- const WrapHandler = require('./wrap-handler')
7
- const {
8
- isDisturbed,
9
- parseRangeHeader,
10
- wrapRequestBody
11
- } = require('../core/util')
12
-
13
- function calculateRetryAfterHeader (retryAfter) {
14
- const retryTime = new Date(retryAfter).getTime()
15
- return isNaN(retryTime) ? 0 : retryTime - Date.now()
16
- }
17
-
18
- class RetryHandler {
19
- constructor (opts, { dispatch, handler }) {
20
- const { retryOptions, ...dispatchOpts } = opts
21
- const {
22
- // Retry scoped
23
- retry: retryFn,
24
- maxRetries,
25
- maxTimeout,
26
- minTimeout,
27
- timeoutFactor,
28
- // Response scoped
29
- methods,
30
- errorCodes,
31
- retryAfter,
32
- statusCodes,
33
- throwOnError
34
- } = retryOptions ?? {}
35
-
36
- this.error = null
37
- this.dispatch = dispatch
38
- this.handler = WrapHandler.wrap(handler)
39
- this.opts = { ...dispatchOpts, body: wrapRequestBody(opts.body) }
40
- this.retryOpts = {
41
- throwOnError: throwOnError ?? true,
42
- retry: retryFn ?? RetryHandler[kRetryHandlerDefaultRetry],
43
- retryAfter: retryAfter ?? true,
44
- maxTimeout: maxTimeout ?? 30 * 1000, // 30s,
45
- minTimeout: minTimeout ?? 500, // .5s
46
- timeoutFactor: timeoutFactor ?? 2,
47
- maxRetries: maxRetries ?? 5,
48
- // What errors we should retry
49
- methods: methods ?? ['GET', 'HEAD', 'OPTIONS', 'PUT', 'DELETE', 'TRACE'],
50
- // Indicates which errors to retry
51
- statusCodes: statusCodes ?? [500, 502, 503, 504, 429],
52
- // List of errors to retry
53
- errorCodes: errorCodes ?? [
54
- 'ECONNRESET',
55
- 'ECONNREFUSED',
56
- 'ENOTFOUND',
57
- 'ENETDOWN',
58
- 'ENETUNREACH',
59
- 'EHOSTDOWN',
60
- 'EHOSTUNREACH',
61
- 'EPIPE',
62
- 'UND_ERR_SOCKET'
63
- ]
64
- }
65
-
66
- this.retryCount = 0
67
- this.retryCountCheckpoint = 0
68
- this.headersSent = false
69
- this.start = 0
70
- this.end = null
71
- this.etag = null
72
- }
73
-
74
- onResponseStartWithRetry (controller, statusCode, headers, statusMessage, err) {
75
- if (this.retryOpts.throwOnError) {
76
- // Preserve old behavior for status codes that are not eligible for retry
77
- if (this.retryOpts.statusCodes.includes(statusCode) === false) {
78
- this.headersSent = true
79
- this.handler.onResponseStart?.(controller, statusCode, headers, statusMessage)
80
- } else {
81
- this.error = err
82
- }
83
-
84
- return
85
- }
86
-
87
- if (isDisturbed(this.opts.body)) {
88
- this.headersSent = true
89
- this.handler.onResponseStart?.(controller, statusCode, headers, statusMessage)
90
- return
91
- }
92
-
93
- function shouldRetry (passedErr) {
94
- if (passedErr) {
95
- this.headersSent = true
96
- this.handler.onResponseStart?.(controller, statusCode, headers, statusMessage)
97
- controller.resume()
98
- return
99
- }
100
-
101
- this.error = err
102
- controller.resume()
103
- }
104
-
105
- controller.pause()
106
- this.retryOpts.retry(
107
- err,
108
- {
109
- state: { counter: this.retryCount },
110
- opts: { retryOptions: this.retryOpts, ...this.opts }
111
- },
112
- shouldRetry.bind(this)
113
- )
114
- }
115
-
116
- onRequestStart (controller, context) {
117
- if (!this.headersSent) {
118
- this.handler.onRequestStart?.(controller, context)
119
- }
120
- }
121
-
122
- onRequestUpgrade (controller, statusCode, headers, socket) {
123
- this.handler.onRequestUpgrade?.(controller, statusCode, headers, socket)
124
- }
125
-
126
- static [kRetryHandlerDefaultRetry] (err, { state, opts }, cb) {
127
- const { statusCode, code, headers } = err
128
- const { method, retryOptions } = opts
129
- const {
130
- maxRetries,
131
- minTimeout,
132
- maxTimeout,
133
- timeoutFactor,
134
- statusCodes,
135
- errorCodes,
136
- methods
137
- } = retryOptions
138
- const { counter } = state
139
-
140
- // Any code that is not a Undici's originated and allowed to retry
141
- if (code && code !== 'UND_ERR_REQ_RETRY' && !errorCodes.includes(code)) {
142
- cb(err)
143
- return
144
- }
145
-
146
- // If a set of method are provided and the current method is not in the list
147
- if (Array.isArray(methods) && !methods.includes(method)) {
148
- cb(err)
149
- return
150
- }
151
-
152
- // If a set of status code are provided and the current status code is not in the list
153
- if (
154
- statusCode != null &&
155
- Array.isArray(statusCodes) &&
156
- !statusCodes.includes(statusCode)
157
- ) {
158
- cb(err)
159
- return
160
- }
161
-
162
- // If we reached the max number of retries
163
- if (counter > maxRetries) {
164
- cb(err)
165
- return
166
- }
167
-
168
- let retryAfterHeader = headers?.['retry-after']
169
- if (retryAfterHeader) {
170
- retryAfterHeader = Number(retryAfterHeader)
171
- retryAfterHeader = Number.isNaN(retryAfterHeader)
172
- ? calculateRetryAfterHeader(headers['retry-after'])
173
- : retryAfterHeader * 1e3 // Retry-After is in seconds
174
- }
175
-
176
- const retryTimeout =
177
- retryAfterHeader > 0
178
- ? Math.min(retryAfterHeader, maxTimeout)
179
- : Math.min(minTimeout * timeoutFactor ** (counter - 1), maxTimeout)
180
-
181
- setTimeout(() => cb(null), retryTimeout)
182
- }
183
-
184
- onResponseStart (controller, statusCode, headers, statusMessage) {
185
- this.error = null
186
- this.retryCount += 1
187
-
188
- if (statusCode >= 300) {
189
- const err = new RequestRetryError('Request failed', statusCode, {
190
- headers,
191
- data: {
192
- count: this.retryCount
193
- }
194
- })
195
-
196
- this.onResponseStartWithRetry(controller, statusCode, headers, statusMessage, err)
197
- return
198
- }
199
-
200
- // Checkpoint for resume from where we left it
201
- if (this.headersSent) {
202
- // Only Partial Content 206 supposed to provide Content-Range,
203
- // any other status code that partially consumed the payload
204
- // should not be retried because it would result in downstream
205
- // wrongly concatenate multiple responses.
206
- if (statusCode !== 206 && (this.start > 0 || statusCode !== 200)) {
207
- throw new RequestRetryError('server does not support the range header and the payload was partially consumed', statusCode, {
208
- headers,
209
- data: { count: this.retryCount }
210
- })
211
- }
212
-
213
- const contentRange = parseRangeHeader(headers['content-range'])
214
- // If no content range
215
- if (!contentRange) {
216
- // We always throw here as we want to indicate that we entred unexpected path
217
- throw new RequestRetryError('Content-Range mismatch', statusCode, {
218
- headers,
219
- data: { count: this.retryCount }
220
- })
221
- }
222
-
223
- // Let's start with a weak etag check
224
- if (this.etag != null && this.etag !== headers.etag) {
225
- // We always throw here as we want to indicate that we entred unexpected path
226
- throw new RequestRetryError('ETag mismatch', statusCode, {
227
- headers,
228
- data: { count: this.retryCount }
229
- })
230
- }
231
-
232
- const { start, size, end = size ? size - 1 : null } = contentRange
233
-
234
- assert(this.start === start, 'content-range mismatch')
235
- assert(this.end == null || this.end === end, 'content-range mismatch')
236
-
237
- return
238
- }
239
-
240
- if (this.end == null) {
241
- if (statusCode === 206) {
242
- // First time we receive 206
243
- const range = parseRangeHeader(headers['content-range'])
244
-
245
- if (range == null) {
246
- this.headersSent = true
247
- this.handler.onResponseStart?.(
248
- controller,
249
- statusCode,
250
- headers,
251
- statusMessage
252
- )
253
- return
254
- }
255
-
256
- const { start, size, end = size ? size - 1 : null } = range
257
- assert(
258
- start != null && Number.isFinite(start),
259
- 'content-range mismatch'
260
- )
261
- assert(end != null && Number.isFinite(end), 'invalid content-length')
262
-
263
- this.start = start
264
- this.end = end
265
- }
266
-
267
- // We make our best to checkpoint the body for further range headers
268
- if (this.end == null) {
269
- const contentLength = headers['content-length']
270
- this.end = contentLength != null ? Number(contentLength) - 1 : null
271
- }
272
-
273
- assert(Number.isFinite(this.start))
274
- assert(
275
- this.end == null || Number.isFinite(this.end),
276
- 'invalid content-length'
277
- )
278
-
279
- this.resume = true
280
- this.etag = headers.etag != null ? headers.etag : null
281
-
282
- // Weak etags are not useful for comparison nor cache
283
- // for instance not safe to assume if the response is byte-per-byte
284
- // equal
285
- if (
286
- this.etag != null &&
287
- this.etag[0] === 'W' &&
288
- this.etag[1] === '/'
289
- ) {
290
- this.etag = null
291
- }
292
-
293
- this.headersSent = true
294
- this.handler.onResponseStart?.(
295
- controller,
296
- statusCode,
297
- headers,
298
- statusMessage
299
- )
300
- } else {
301
- throw new RequestRetryError('Request failed', statusCode, {
302
- headers,
303
- data: { count: this.retryCount }
304
- })
305
- }
306
- }
307
-
308
- onResponseData (controller, chunk) {
309
- if (this.error) {
310
- return
311
- }
312
-
313
- this.start += chunk.length
314
-
315
- this.handler.onResponseData?.(controller, chunk)
316
- }
317
-
318
- onResponseEnd (controller, trailers) {
319
- if (this.error && this.retryOpts.throwOnError) {
320
- throw this.error
321
- }
322
-
323
- if (!this.error) {
324
- this.retryCount = 0
325
- return this.handler.onResponseEnd?.(controller, trailers)
326
- }
327
-
328
- this.retry(controller)
329
- }
330
-
331
- retry (controller) {
332
- if (this.start !== 0) {
333
- const headers = { range: `bytes=${this.start}-${this.end ?? ''}` }
334
-
335
- // Weak etag check - weak etags will make comparison algorithms never match
336
- if (this.etag != null) {
337
- headers['if-match'] = this.etag
338
- }
339
-
340
- this.opts = {
341
- ...this.opts,
342
- headers: {
343
- ...this.opts.headers,
344
- ...headers
345
- }
346
- }
347
- }
348
-
349
- try {
350
- this.retryCountCheckpoint = this.retryCount
351
- this.dispatch(this.opts, this)
352
- } catch (err) {
353
- this.handler.onResponseError?.(controller, err)
354
- }
355
- }
356
-
357
- onResponseError (controller, err) {
358
- if (controller?.aborted || isDisturbed(this.opts.body)) {
359
- this.handler.onResponseError?.(controller, err)
360
- return
361
- }
362
-
363
- function shouldRetry (returnedErr) {
364
- if (!returnedErr) {
365
- this.retry(controller)
366
- return
367
- }
368
-
369
- this.handler?.onResponseError?.(controller, returnedErr)
370
- }
371
-
372
- // We reconcile in case of a mix between network errors
373
- // and server error response
374
- if (this.retryCount - this.retryCountCheckpoint > 0) {
375
- // We count the difference between the last checkpoint and the current retry count
376
- this.retryCount =
377
- this.retryCountCheckpoint +
378
- (this.retryCount - this.retryCountCheckpoint)
379
- } else {
380
- this.retryCount += 1
381
- }
382
-
383
- this.retryOpts.retry(
384
- err,
385
- {
386
- state: { counter: this.retryCount },
387
- opts: { retryOptions: this.retryOpts, ...this.opts }
388
- },
389
- shouldRetry.bind(this)
390
- )
391
- }
392
- }
393
-
394
- module.exports = RetryHandler