pi-cursor-sdk 0.1.50 → 0.1.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 (276) hide show
  1. package/CHANGELOG.md +19 -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-tool-manifest.ts +1 -1
  12. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  13. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  14. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  15. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  40. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  41. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  42. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  43. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  44. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  46. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  47. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  48. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  50. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  51. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  52. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  53. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  54. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  55. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  56. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  66. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  67. package/node_modules/undici/LICENSE +0 -21
  68. package/node_modules/undici/README.md +0 -741
  69. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  70. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  71. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  72. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  73. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  74. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  75. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  76. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  77. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  78. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  79. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  80. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  81. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  82. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  83. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  84. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  85. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  86. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  87. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  88. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  89. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  90. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  91. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  92. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  93. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  94. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  95. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  96. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  97. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  98. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  99. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  100. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  101. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  102. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  103. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  104. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  105. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  106. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  107. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  108. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  109. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  110. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  111. package/node_modules/undici/index-fetch.js +0 -65
  112. package/node_modules/undici/index.d.ts +0 -3
  113. package/node_modules/undici/index.js +0 -234
  114. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  115. package/node_modules/undici/lib/api/api-connect.js +0 -110
  116. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  117. package/node_modules/undici/lib/api/api-request.js +0 -214
  118. package/node_modules/undici/lib/api/api-stream.js +0 -209
  119. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  120. package/node_modules/undici/lib/api/index.js +0 -7
  121. package/node_modules/undici/lib/api/readable.js +0 -580
  122. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  123. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  124. package/node_modules/undici/lib/core/connect.js +0 -153
  125. package/node_modules/undici/lib/core/constants.js +0 -143
  126. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  127. package/node_modules/undici/lib/core/errors.js +0 -477
  128. package/node_modules/undici/lib/core/request.js +0 -453
  129. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  130. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  131. package/node_modules/undici/lib/core/symbols.js +0 -75
  132. package/node_modules/undici/lib/core/tree.js +0 -160
  133. package/node_modules/undici/lib/core/util.js +0 -992
  134. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  135. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  136. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  137. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  138. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  139. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  140. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  141. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  142. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  143. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  144. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  145. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  146. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  147. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  148. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  149. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  150. package/node_modules/undici/lib/encoding/index.js +0 -33
  151. package/node_modules/undici/lib/global.js +0 -59
  152. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  153. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  154. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  155. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  156. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  157. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  158. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  159. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  160. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  161. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  162. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  163. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  164. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  165. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  166. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  167. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  168. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  169. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  170. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  171. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  172. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  173. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  174. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  175. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  176. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  177. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  178. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  179. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  180. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  181. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  182. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  183. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  184. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  185. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  186. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  187. package/node_modules/undici/lib/util/cache.js +0 -414
  188. package/node_modules/undici/lib/util/date.js +0 -653
  189. package/node_modules/undici/lib/util/promise.js +0 -28
  190. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  191. package/node_modules/undici/lib/util/stats.js +0 -32
  192. package/node_modules/undici/lib/util/timers.js +0 -425
  193. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  194. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  195. package/node_modules/undici/lib/web/cache/util.js +0 -45
  196. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  197. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  198. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  199. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  200. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  201. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  202. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  203. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  204. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  205. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  206. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  207. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  208. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  209. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  210. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  211. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  212. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  213. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  214. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  215. package/node_modules/undici/lib/web/infra/index.js +0 -229
  216. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  217. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  218. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  219. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  220. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  221. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  222. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  223. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  224. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  225. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  226. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  227. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  228. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  229. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  230. package/node_modules/undici/package.json +0 -152
  231. package/node_modules/undici/scripts/strip-comments.js +0 -10
  232. package/node_modules/undici/types/README.md +0 -6
  233. package/node_modules/undici/types/agent.d.ts +0 -32
  234. package/node_modules/undici/types/api.d.ts +0 -43
  235. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  236. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  237. package/node_modules/undici/types/cache.d.ts +0 -36
  238. package/node_modules/undici/types/client-stats.d.ts +0 -15
  239. package/node_modules/undici/types/client.d.ts +0 -139
  240. package/node_modules/undici/types/connector.d.ts +0 -36
  241. package/node_modules/undici/types/content-type.d.ts +0 -21
  242. package/node_modules/undici/types/cookies.d.ts +0 -30
  243. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  244. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  245. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  246. package/node_modules/undici/types/errors.d.ts +0 -177
  247. package/node_modules/undici/types/eventsource.d.ts +0 -66
  248. package/node_modules/undici/types/fetch.d.ts +0 -231
  249. package/node_modules/undici/types/formdata.d.ts +0 -114
  250. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  251. package/node_modules/undici/types/global-origin.d.ts +0 -7
  252. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  253. package/node_modules/undici/types/handlers.d.ts +0 -14
  254. package/node_modules/undici/types/header.d.ts +0 -160
  255. package/node_modules/undici/types/index.d.ts +0 -91
  256. package/node_modules/undici/types/interceptors.d.ts +0 -80
  257. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  258. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  259. package/node_modules/undici/types/mock-client.d.ts +0 -27
  260. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  261. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  262. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  263. package/node_modules/undici/types/patch.d.ts +0 -29
  264. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  265. package/node_modules/undici/types/pool.d.ts +0 -41
  266. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  267. package/node_modules/undici/types/readable.d.ts +0 -68
  268. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  269. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  270. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  271. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  272. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  273. package/node_modules/undici/types/util.d.ts +0 -18
  274. package/node_modules/undici/types/utility.d.ts +0 -7
  275. package/node_modules/undici/types/webidl.d.ts +0 -347
  276. 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