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,664 +0,0 @@
1
- 'use strict'
2
-
3
- const assert = require('node:assert')
4
- const net = require('node:net')
5
- const http = require('node:http')
6
- const util = require('../core/util.js')
7
- const { ClientStats } = require('../util/stats.js')
8
- const { channels } = require('../core/diagnostics.js')
9
- const Request = require('../core/request.js')
10
- const DispatcherBase = require('./dispatcher-base')
11
- const {
12
- InvalidArgumentError,
13
- InformationalError,
14
- ClientDestroyedError
15
- } = require('../core/errors.js')
16
- const buildConnector = require('../core/connect.js')
17
- const {
18
- kUrl,
19
- kServerName,
20
- kClient,
21
- kBusy,
22
- kConnect,
23
- kResuming,
24
- kRunning,
25
- kPending,
26
- kSize,
27
- kQueue,
28
- kConnected,
29
- kConnecting,
30
- kNeedDrain,
31
- kKeepAliveDefaultTimeout,
32
- kHostHeader,
33
- kPendingIdx,
34
- kRunningIdx,
35
- kError,
36
- kPipelining,
37
- kKeepAliveTimeoutValue,
38
- kMaxHeadersSize,
39
- kKeepAliveMaxTimeout,
40
- kKeepAliveTimeoutThreshold,
41
- kHeadersTimeout,
42
- kBodyTimeout,
43
- kStrictContentLength,
44
- kConnector,
45
- kMaxRequests,
46
- kCounter,
47
- kClose,
48
- kDestroy,
49
- kDispatch,
50
- kLocalAddress,
51
- kMaxResponseSize,
52
- kOnError,
53
- kHTTPContext,
54
- kMaxConcurrentStreams,
55
- kHTTP2InitialWindowSize,
56
- kHTTP2ConnectionWindowSize,
57
- kResume,
58
- kPingInterval
59
- } = require('../core/symbols.js')
60
- const connectH1 = require('./client-h1.js')
61
- const connectH2 = require('./client-h2.js')
62
-
63
- const kClosedResolve = Symbol('kClosedResolve')
64
-
65
- const getDefaultNodeMaxHeaderSize = http &&
66
- http.maxHeaderSize &&
67
- Number.isInteger(http.maxHeaderSize) &&
68
- http.maxHeaderSize > 0
69
- ? () => http.maxHeaderSize
70
- : () => { throw new InvalidArgumentError('http module not available or http.maxHeaderSize invalid') }
71
-
72
- const noop = () => { }
73
-
74
- function getPipelining (client) {
75
- return client[kPipelining] ?? client[kHTTPContext]?.defaultPipelining ?? 1
76
- }
77
-
78
- /**
79
- * @type {import('../../types/client.js').default}
80
- */
81
- class Client extends DispatcherBase {
82
- /**
83
- *
84
- * @param {string|URL} url
85
- * @param {import('../../types/client.js').Client.Options} options
86
- */
87
- constructor (url, {
88
- maxHeaderSize,
89
- headersTimeout,
90
- socketTimeout,
91
- requestTimeout,
92
- connectTimeout,
93
- bodyTimeout,
94
- idleTimeout,
95
- keepAlive,
96
- keepAliveTimeout,
97
- maxKeepAliveTimeout,
98
- keepAliveMaxTimeout,
99
- keepAliveTimeoutThreshold,
100
- socketPath,
101
- pipelining,
102
- tls,
103
- strictContentLength,
104
- maxCachedSessions,
105
- connect,
106
- maxRequestsPerClient,
107
- localAddress,
108
- maxResponseSize,
109
- autoSelectFamily,
110
- autoSelectFamilyAttemptTimeout,
111
- // h2
112
- maxConcurrentStreams,
113
- allowH2,
114
- useH2c,
115
- initialWindowSize,
116
- connectionWindowSize,
117
- pingInterval,
118
- webSocket
119
- } = {}) {
120
- if (keepAlive !== undefined) {
121
- throw new InvalidArgumentError('unsupported keepAlive, use pipelining=0 instead')
122
- }
123
-
124
- if (socketTimeout !== undefined) {
125
- throw new InvalidArgumentError('unsupported socketTimeout, use headersTimeout & bodyTimeout instead')
126
- }
127
-
128
- if (requestTimeout !== undefined) {
129
- throw new InvalidArgumentError('unsupported requestTimeout, use headersTimeout & bodyTimeout instead')
130
- }
131
-
132
- if (idleTimeout !== undefined) {
133
- throw new InvalidArgumentError('unsupported idleTimeout, use keepAliveTimeout instead')
134
- }
135
-
136
- if (maxKeepAliveTimeout !== undefined) {
137
- throw new InvalidArgumentError('unsupported maxKeepAliveTimeout, use keepAliveMaxTimeout instead')
138
- }
139
-
140
- if (maxHeaderSize != null) {
141
- if (!Number.isInteger(maxHeaderSize) || maxHeaderSize < 1) {
142
- throw new InvalidArgumentError('invalid maxHeaderSize')
143
- }
144
- } else {
145
- // If maxHeaderSize is not provided, use the default value from the http module
146
- // or if that is not available, throw an error.
147
- maxHeaderSize = getDefaultNodeMaxHeaderSize()
148
- }
149
-
150
- if (socketPath != null && typeof socketPath !== 'string') {
151
- throw new InvalidArgumentError('invalid socketPath')
152
- }
153
-
154
- if (connectTimeout != null && (!Number.isFinite(connectTimeout) || connectTimeout < 0)) {
155
- throw new InvalidArgumentError('invalid connectTimeout')
156
- }
157
-
158
- if (keepAliveTimeout != null && (!Number.isFinite(keepAliveTimeout) || keepAliveTimeout <= 0)) {
159
- throw new InvalidArgumentError('invalid keepAliveTimeout')
160
- }
161
-
162
- if (keepAliveMaxTimeout != null && (!Number.isFinite(keepAliveMaxTimeout) || keepAliveMaxTimeout <= 0)) {
163
- throw new InvalidArgumentError('invalid keepAliveMaxTimeout')
164
- }
165
-
166
- if (keepAliveTimeoutThreshold != null && !Number.isFinite(keepAliveTimeoutThreshold)) {
167
- throw new InvalidArgumentError('invalid keepAliveTimeoutThreshold')
168
- }
169
-
170
- if (headersTimeout != null && (!Number.isInteger(headersTimeout) || headersTimeout < 0)) {
171
- throw new InvalidArgumentError('headersTimeout must be a positive integer or zero')
172
- }
173
-
174
- if (bodyTimeout != null && (!Number.isInteger(bodyTimeout) || bodyTimeout < 0)) {
175
- throw new InvalidArgumentError('bodyTimeout must be a positive integer or zero')
176
- }
177
-
178
- if (connect != null && typeof connect !== 'function' && typeof connect !== 'object') {
179
- throw new InvalidArgumentError('connect must be a function or an object')
180
- }
181
-
182
- if (maxRequestsPerClient != null && (!Number.isInteger(maxRequestsPerClient) || maxRequestsPerClient < 0)) {
183
- throw new InvalidArgumentError('maxRequestsPerClient must be a positive number')
184
- }
185
-
186
- if (localAddress != null && (typeof localAddress !== 'string' || net.isIP(localAddress) === 0)) {
187
- throw new InvalidArgumentError('localAddress must be valid string IP address')
188
- }
189
-
190
- if (maxResponseSize != null && (!Number.isInteger(maxResponseSize) || maxResponseSize < -1)) {
191
- throw new InvalidArgumentError('maxResponseSize must be a positive number')
192
- }
193
-
194
- if (
195
- autoSelectFamilyAttemptTimeout != null &&
196
- (!Number.isInteger(autoSelectFamilyAttemptTimeout) || autoSelectFamilyAttemptTimeout < -1)
197
- ) {
198
- throw new InvalidArgumentError('autoSelectFamilyAttemptTimeout must be a positive number')
199
- }
200
-
201
- // h2
202
- if (allowH2 != null && typeof allowH2 !== 'boolean') {
203
- throw new InvalidArgumentError('allowH2 must be a valid boolean value')
204
- }
205
-
206
- if (maxConcurrentStreams != null && (typeof maxConcurrentStreams !== 'number' || maxConcurrentStreams < 1)) {
207
- throw new InvalidArgumentError('maxConcurrentStreams must be a positive integer, greater than 0')
208
- }
209
-
210
- if (useH2c != null && typeof useH2c !== 'boolean') {
211
- throw new InvalidArgumentError('useH2c must be a valid boolean value')
212
- }
213
-
214
- if (initialWindowSize != null && (!Number.isInteger(initialWindowSize) || initialWindowSize < 1)) {
215
- throw new InvalidArgumentError('initialWindowSize must be a positive integer, greater than 0')
216
- }
217
-
218
- if (connectionWindowSize != null && (!Number.isInteger(connectionWindowSize) || connectionWindowSize < 1)) {
219
- throw new InvalidArgumentError('connectionWindowSize must be a positive integer, greater than 0')
220
- }
221
-
222
- if (pingInterval != null && (typeof pingInterval !== 'number' || !Number.isInteger(pingInterval) || pingInterval < 0)) {
223
- throw new InvalidArgumentError('pingInterval must be a positive integer, greater or equal to 0')
224
- }
225
-
226
- super({ webSocket })
227
-
228
- if (typeof connect !== 'function') {
229
- connect = buildConnector({
230
- ...tls,
231
- maxCachedSessions,
232
- allowH2,
233
- useH2c,
234
- socketPath,
235
- timeout: connectTimeout,
236
- ...(typeof autoSelectFamily === 'boolean' ? { autoSelectFamily, autoSelectFamilyAttemptTimeout } : undefined),
237
- ...connect
238
- })
239
- } else {
240
- const customConnect = connect
241
- connect = (opts, callback) => customConnect({
242
- ...opts,
243
- ...(socketPath != null ? { socketPath } : null),
244
- ...(allowH2 != null ? { allowH2 } : null)
245
- }, callback)
246
- }
247
-
248
- this[kUrl] = util.parseOrigin(url)
249
- this[kConnector] = connect
250
- this[kPipelining] = pipelining != null ? pipelining : 1
251
- this[kMaxHeadersSize] = maxHeaderSize
252
- this[kKeepAliveDefaultTimeout] = keepAliveTimeout == null ? 4e3 : keepAliveTimeout
253
- this[kKeepAliveMaxTimeout] = keepAliveMaxTimeout == null ? 600e3 : keepAliveMaxTimeout
254
- this[kKeepAliveTimeoutThreshold] = keepAliveTimeoutThreshold == null ? 2e3 : keepAliveTimeoutThreshold
255
- this[kKeepAliveTimeoutValue] = this[kKeepAliveDefaultTimeout]
256
- this[kServerName] = null
257
- this[kLocalAddress] = localAddress != null ? localAddress : null
258
- this[kResuming] = 0 // 0, idle, 1, scheduled, 2 resuming
259
- this[kNeedDrain] = 0 // 0, idle, 1, scheduled, 2 resuming
260
- this[kHostHeader] = `host: ${this[kUrl].hostname}${this[kUrl].port ? `:${this[kUrl].port}` : ''}\r\n`
261
- this[kBodyTimeout] = bodyTimeout != null ? bodyTimeout : 300e3
262
- this[kHeadersTimeout] = headersTimeout != null ? headersTimeout : 300e3
263
- this[kStrictContentLength] = strictContentLength == null ? true : strictContentLength
264
- this[kMaxRequests] = maxRequestsPerClient
265
- this[kClosedResolve] = null
266
- this[kMaxResponseSize] = maxResponseSize > -1 ? maxResponseSize : -1
267
- this[kHTTPContext] = null
268
- // h2
269
- this[kMaxConcurrentStreams] = maxConcurrentStreams != null ? maxConcurrentStreams : 100 // Max peerConcurrentStreams for a Node h2 server
270
- // HTTP/2 window sizes are set to higher defaults than Node.js core for better performance:
271
- // - initialWindowSize: 262144 (256KB) vs Node.js default 65535 (64KB - 1)
272
- // Allows more data to be sent before requiring acknowledgment, improving throughput
273
- // especially on high-latency networks. This matches common production HTTP/2 servers.
274
- // - connectionWindowSize: 524288 (512KB) vs Node.js default (none set)
275
- // Provides better flow control for the entire connection across multiple streams.
276
- this[kHTTP2InitialWindowSize] = initialWindowSize != null ? initialWindowSize : 262144
277
- this[kHTTP2ConnectionWindowSize] = connectionWindowSize != null ? connectionWindowSize : 524288
278
- this[kPingInterval] = pingInterval != null ? pingInterval : 60e3 // Default ping interval for h2 - 1 minute
279
-
280
- // kQueue is built up of 3 sections separated by
281
- // the kRunningIdx and kPendingIdx indices.
282
- // | complete | running | pending |
283
- // ^ kRunningIdx ^ kPendingIdx ^ kQueue.length
284
- // kRunningIdx points to the first running element.
285
- // kPendingIdx points to the first pending element.
286
- // This implements a fast queue with an amortized
287
- // time of O(1).
288
-
289
- this[kQueue] = []
290
- this[kRunningIdx] = 0
291
- this[kPendingIdx] = 0
292
-
293
- this[kResume] = (sync) => resume(this, sync)
294
- this[kOnError] = (err) => onError(this, err)
295
- }
296
-
297
- get pipelining () {
298
- return this[kPipelining]
299
- }
300
-
301
- set pipelining (value) {
302
- this[kPipelining] = value
303
- this[kResume](true)
304
- }
305
-
306
- get stats () {
307
- return new ClientStats(this)
308
- }
309
-
310
- get [kPending] () {
311
- return this[kQueue].length - this[kPendingIdx]
312
- }
313
-
314
- get [kRunning] () {
315
- return this[kPendingIdx] - this[kRunningIdx]
316
- }
317
-
318
- get [kSize] () {
319
- return this[kQueue].length - this[kRunningIdx]
320
- }
321
-
322
- get [kConnected] () {
323
- return !!this[kHTTPContext] && !this[kConnecting] && !this[kHTTPContext].destroyed
324
- }
325
-
326
- get [kBusy] () {
327
- return Boolean(
328
- this[kHTTPContext]?.busy(null) ||
329
- (this[kSize] >= (getPipelining(this) || 1)) ||
330
- this[kPending] > 0
331
- )
332
- }
333
-
334
- [kConnect] (cb) {
335
- connect(this)
336
- this.once('connect', cb)
337
- }
338
-
339
- [kDispatch] (opts, handler) {
340
- const request = new Request(this[kUrl].origin, opts, handler)
341
-
342
- this[kQueue].push(request)
343
- if (this[kResuming]) {
344
- // Do nothing.
345
- } else if (util.bodyLength(request.body) == null && util.isIterable(request.body)) {
346
- // Wait a tick in case stream/iterator is ended in the same tick.
347
- this[kResuming] = 1
348
- queueMicrotask(() => resume(this))
349
- } else {
350
- this[kResume](true)
351
- }
352
-
353
- if (this[kResuming] && this[kNeedDrain] !== 2 && this[kBusy]) {
354
- this[kNeedDrain] = 2
355
- }
356
-
357
- return this[kNeedDrain] < 2
358
- }
359
-
360
- [kClose] () {
361
- // TODO: for H2 we need to gracefully flush the remaining enqueued
362
- // request and close each stream.
363
- return new Promise((resolve) => {
364
- if (this[kSize]) {
365
- this[kClosedResolve] = resolve
366
- } else {
367
- resolve(null)
368
- }
369
- })
370
- }
371
-
372
- [kDestroy] (err) {
373
- return new Promise((resolve) => {
374
- const requests = this[kQueue].splice(this[kPendingIdx])
375
- for (let i = 0; i < requests.length; i++) {
376
- const request = requests[i]
377
- util.errorRequest(this, request, err)
378
- }
379
-
380
- const callback = () => {
381
- if (this[kClosedResolve]) {
382
- // TODO (fix): Should we error here with ClientDestroyedError?
383
- this[kClosedResolve]()
384
- this[kClosedResolve] = null
385
- }
386
- resolve(null)
387
- }
388
-
389
- if (this[kHTTPContext]) {
390
- this[kHTTPContext].destroy(err, callback)
391
- this[kHTTPContext] = null
392
- } else {
393
- queueMicrotask(callback)
394
- }
395
-
396
- this[kResume]()
397
- })
398
- }
399
- }
400
-
401
- function onError (client, err) {
402
- if (
403
- client[kRunning] === 0 &&
404
- err.code !== 'UND_ERR_INFO' &&
405
- err.code !== 'UND_ERR_SOCKET'
406
- ) {
407
- // Error is not caused by running request and not a recoverable
408
- // socket error.
409
-
410
- assert(client[kPendingIdx] === client[kRunningIdx])
411
-
412
- const requests = client[kQueue].splice(client[kRunningIdx])
413
-
414
- for (let i = 0; i < requests.length; i++) {
415
- const request = requests[i]
416
- util.errorRequest(client, request, err)
417
- }
418
- assert(client[kSize] === 0)
419
- }
420
- }
421
-
422
- /**
423
- * @param {Client} client
424
- * @returns {void}
425
- */
426
- function connect (client) {
427
- assert(!client[kConnecting])
428
- assert(!client[kHTTPContext])
429
-
430
- let { host, hostname, protocol, port } = client[kUrl]
431
-
432
- // Resolve ipv6
433
- if (hostname[0] === '[') {
434
- const idx = hostname.indexOf(']')
435
-
436
- assert(idx !== -1)
437
- const ip = hostname.substring(1, idx)
438
-
439
- assert(net.isIPv6(ip))
440
- hostname = ip
441
- }
442
-
443
- client[kConnecting] = true
444
-
445
- if (channels.beforeConnect.hasSubscribers) {
446
- channels.beforeConnect.publish({
447
- connectParams: {
448
- host,
449
- hostname,
450
- protocol,
451
- port,
452
- version: client[kHTTPContext]?.version,
453
- servername: client[kServerName],
454
- localAddress: client[kLocalAddress]
455
- },
456
- connector: client[kConnector]
457
- })
458
- }
459
-
460
- try {
461
- client[kConnector]({
462
- host,
463
- hostname,
464
- protocol,
465
- port,
466
- servername: client[kServerName],
467
- localAddress: client[kLocalAddress]
468
- }, (err, socket) => {
469
- if (err) {
470
- handleConnectError(client, err, { host, hostname, protocol, port })
471
- client[kResume]()
472
- return
473
- }
474
-
475
- if (client.destroyed) {
476
- util.destroy(socket.on('error', noop), new ClientDestroyedError())
477
- client[kResume]()
478
- return
479
- }
480
-
481
- assert(socket)
482
-
483
- try {
484
- client[kHTTPContext] = socket.alpnProtocol === 'h2'
485
- ? connectH2(client, socket)
486
- : connectH1(client, socket)
487
- } catch (err) {
488
- socket.destroy().on('error', noop)
489
- handleConnectError(client, err, { host, hostname, protocol, port })
490
- client[kResume]()
491
- return
492
- }
493
-
494
- client[kConnecting] = false
495
-
496
- socket[kCounter] = 0
497
- socket[kMaxRequests] = client[kMaxRequests]
498
- socket[kClient] = client
499
- socket[kError] = null
500
-
501
- if (channels.connected.hasSubscribers) {
502
- channels.connected.publish({
503
- connectParams: {
504
- host,
505
- hostname,
506
- protocol,
507
- port,
508
- version: client[kHTTPContext]?.version,
509
- servername: client[kServerName],
510
- localAddress: client[kLocalAddress]
511
- },
512
- connector: client[kConnector],
513
- socket
514
- })
515
- }
516
-
517
- client.emit('connect', client[kUrl], [client])
518
- client[kResume]()
519
- })
520
- } catch (err) {
521
- handleConnectError(client, err, { host, hostname, protocol, port })
522
- client[kResume]()
523
- }
524
- }
525
-
526
- function handleConnectError (client, err, { host, hostname, protocol, port }) {
527
- if (client.destroyed) {
528
- return
529
- }
530
-
531
- client[kConnecting] = false
532
-
533
- if (channels.connectError.hasSubscribers) {
534
- channels.connectError.publish({
535
- connectParams: {
536
- host,
537
- hostname,
538
- protocol,
539
- port,
540
- version: client[kHTTPContext]?.version,
541
- servername: client[kServerName],
542
- localAddress: client[kLocalAddress]
543
- },
544
- connector: client[kConnector],
545
- error: err
546
- })
547
- }
548
-
549
- if (err.code === 'ERR_TLS_CERT_ALTNAME_INVALID') {
550
- assert(client[kRunning] === 0)
551
- while (client[kPending] > 0 && client[kQueue][client[kPendingIdx]].servername === client[kServerName]) {
552
- const request = client[kQueue][client[kPendingIdx]++]
553
- util.errorRequest(client, request, err)
554
- }
555
- } else {
556
- onError(client, err)
557
- }
558
-
559
- client.emit('connectionError', client[kUrl], [client], err)
560
- }
561
-
562
- function emitDrain (client) {
563
- client[kNeedDrain] = 0
564
- client.emit('drain', client[kUrl], [client])
565
- }
566
-
567
- function resume (client, sync) {
568
- if (client[kResuming] === 2) {
569
- return
570
- }
571
-
572
- client[kResuming] = 2
573
-
574
- _resume(client, sync)
575
- client[kResuming] = 0
576
-
577
- if (client[kRunningIdx] > 256) {
578
- client[kQueue].splice(0, client[kRunningIdx])
579
- client[kPendingIdx] -= client[kRunningIdx]
580
- client[kRunningIdx] = 0
581
- }
582
- }
583
-
584
- function _resume (client, sync) {
585
- while (true) {
586
- if (client.destroyed) {
587
- assert(client[kPending] === 0)
588
- return
589
- }
590
-
591
- if (client[kClosedResolve] && !client[kSize]) {
592
- client[kClosedResolve]()
593
- client[kClosedResolve] = null
594
- return
595
- }
596
-
597
- if (client[kHTTPContext]) {
598
- client[kHTTPContext].resume()
599
- }
600
-
601
- if (client[kBusy]) {
602
- client[kNeedDrain] = 2
603
- } else if (client[kNeedDrain] === 2) {
604
- if (sync) {
605
- client[kNeedDrain] = 1
606
- queueMicrotask(() => emitDrain(client))
607
- } else {
608
- emitDrain(client)
609
- }
610
- continue
611
- }
612
-
613
- if (client[kPending] === 0) {
614
- return
615
- }
616
-
617
- if (client[kRunning] >= (getPipelining(client) || 1)) {
618
- return
619
- }
620
-
621
- const request = client[kQueue][client[kPendingIdx]]
622
-
623
- if (request === null) {
624
- return
625
- }
626
-
627
- if (client[kUrl].protocol === 'https:' && client[kServerName] !== request.servername) {
628
- if (client[kRunning] > 0) {
629
- return
630
- }
631
-
632
- client[kServerName] = request.servername
633
- client[kHTTPContext]?.destroy(new InformationalError('servername changed'), () => {
634
- client[kHTTPContext] = null
635
- resume(client)
636
- })
637
- }
638
-
639
- if (client[kConnecting]) {
640
- return
641
- }
642
-
643
- if (!client[kHTTPContext]) {
644
- connect(client)
645
- return
646
- }
647
-
648
- if (client[kHTTPContext].destroyed) {
649
- return
650
- }
651
-
652
- if (client[kHTTPContext].busy(request)) {
653
- return
654
- }
655
-
656
- if (!request.aborted && client[kHTTPContext].write(request)) {
657
- client[kPendingIdx]++
658
- } else {
659
- client[kQueue].splice(client[kPendingIdx], 1)
660
- }
661
- }
662
- }
663
-
664
- module.exports = Client