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,67 +0,0 @@
1
- 'use strict'
2
-
3
- const assert = require('node:assert')
4
- const WrapHandler = require('./wrap-handler')
5
-
6
- /**
7
- * @deprecated
8
- */
9
- module.exports = class DecoratorHandler {
10
- #handler
11
- #onCompleteCalled = false
12
- #onErrorCalled = false
13
- #onResponseStartCalled = false
14
-
15
- constructor (handler) {
16
- if (typeof handler !== 'object' || handler === null) {
17
- throw new TypeError('handler must be an object')
18
- }
19
- this.#handler = WrapHandler.wrap(handler)
20
- }
21
-
22
- onRequestStart (...args) {
23
- this.#handler.onRequestStart?.(...args)
24
- }
25
-
26
- onRequestUpgrade (...args) {
27
- assert(!this.#onCompleteCalled)
28
- assert(!this.#onErrorCalled)
29
-
30
- return this.#handler.onRequestUpgrade?.(...args)
31
- }
32
-
33
- onResponseStart (...args) {
34
- assert(!this.#onCompleteCalled)
35
- assert(!this.#onErrorCalled)
36
- assert(!this.#onResponseStartCalled)
37
-
38
- this.#onResponseStartCalled = true
39
-
40
- return this.#handler.onResponseStart?.(...args)
41
- }
42
-
43
- onResponseData (...args) {
44
- assert(!this.#onCompleteCalled)
45
- assert(!this.#onErrorCalled)
46
-
47
- return this.#handler.onResponseData?.(...args)
48
- }
49
-
50
- onResponseEnd (...args) {
51
- assert(!this.#onCompleteCalled)
52
- assert(!this.#onErrorCalled)
53
-
54
- this.#onCompleteCalled = true
55
- return this.#handler.onResponseEnd?.(...args)
56
- }
57
-
58
- onResponseError (...args) {
59
- this.#onErrorCalled = true
60
- return this.#handler.onResponseError?.(...args)
61
- }
62
-
63
- /**
64
- * @deprecated
65
- */
66
- onBodySent () {}
67
- }
@@ -1,460 +0,0 @@
1
- 'use strict'
2
-
3
- const { RequestAbortedError } = require('../core/errors')
4
-
5
- /**
6
- * @typedef {import('../../types/dispatcher.d.ts').default.DispatchHandler} DispatchHandler
7
- */
8
-
9
- const DEFAULT_MAX_BUFFER_SIZE = 5 * 1024 * 1024
10
-
11
- /**
12
- * @typedef {Object} WaitingHandler
13
- * @property {DispatchHandler} handler
14
- * @property {import('../../types/dispatcher.d.ts').default.DispatchController} controller
15
- * @property {Buffer[]} bufferedChunks
16
- * @property {number} bufferedBytes
17
- * @property {object | null} pendingTrailers
18
- * @property {boolean} done
19
- */
20
-
21
- /**
22
- * Handler that forwards response events to multiple waiting handlers.
23
- * Used for request deduplication.
24
- *
25
- * @implements {DispatchHandler}
26
- */
27
- class DeduplicationHandler {
28
- /**
29
- * @type {DispatchHandler}
30
- */
31
- #primaryHandler
32
-
33
- /**
34
- * @type {WaitingHandler[]}
35
- */
36
- #waitingHandlers = []
37
-
38
- /**
39
- * @type {number}
40
- */
41
- #maxBufferSize = DEFAULT_MAX_BUFFER_SIZE
42
-
43
- /**
44
- * @type {number}
45
- */
46
- #statusCode = 0
47
-
48
- /**
49
- * @type {Record<string, string | string[]>}
50
- */
51
- #headers = {}
52
-
53
- /**
54
- * @type {string}
55
- */
56
- #statusMessage = ''
57
-
58
- /**
59
- * @type {boolean}
60
- */
61
- #aborted = false
62
-
63
- /**
64
- * @type {boolean}
65
- */
66
- #responseStarted = false
67
-
68
- /**
69
- * @type {boolean}
70
- */
71
- #responseDataStarted = false
72
-
73
- /**
74
- * @type {boolean}
75
- */
76
- #completed = false
77
-
78
- /**
79
- * @type {import('../../types/dispatcher.d.ts').default.DispatchController | null}
80
- */
81
- #controller = null
82
-
83
- /**
84
- * @type {(() => void) | null}
85
- */
86
- #onComplete = null
87
-
88
- /**
89
- * @param {DispatchHandler} primaryHandler The primary handler
90
- * @param {() => void} onComplete Callback when request completes
91
- * @param {number} [maxBufferSize] Maximum paused buffer size per waiting handler
92
- */
93
- constructor (primaryHandler, onComplete, maxBufferSize = DEFAULT_MAX_BUFFER_SIZE) {
94
- this.#primaryHandler = primaryHandler
95
- this.#onComplete = onComplete
96
- this.#maxBufferSize = maxBufferSize
97
- }
98
-
99
- /**
100
- * Add a waiting handler that will receive response events.
101
- * Returns false if deduplication can no longer safely attach this handler.
102
- *
103
- * @param {DispatchHandler} handler
104
- * @returns {boolean}
105
- */
106
- addWaitingHandler (handler) {
107
- if (this.#completed || this.#responseDataStarted) {
108
- return false
109
- }
110
-
111
- const waitingHandler = this.#createWaitingHandler(handler)
112
- const waitingController = waitingHandler.controller
113
-
114
- try {
115
- handler.onRequestStart?.(waitingController, null)
116
-
117
- if (waitingController.aborted) {
118
- waitingHandler.done = true
119
- return true
120
- }
121
-
122
- if (this.#responseStarted) {
123
- handler.onResponseStart?.(
124
- waitingController,
125
- this.#statusCode,
126
- this.#headers,
127
- this.#statusMessage
128
- )
129
- }
130
- } catch {
131
- // Ignore errors from waiting handlers
132
- waitingHandler.done = true
133
- return true
134
- }
135
-
136
- if (!waitingController.aborted) {
137
- this.#waitingHandlers.push(waitingHandler)
138
- }
139
-
140
- return true
141
- }
142
-
143
- /**
144
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
145
- * @param {any} context
146
- */
147
- onRequestStart (controller, context) {
148
- this.#controller = controller
149
- this.#primaryHandler.onRequestStart?.(controller, context)
150
- }
151
-
152
- /**
153
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
154
- * @param {number} statusCode
155
- * @param {import('../../types/header.d.ts').IncomingHttpHeaders} headers
156
- * @param {Socket} socket
157
- */
158
- onRequestUpgrade (controller, statusCode, headers, socket) {
159
- this.#primaryHandler.onRequestUpgrade?.(controller, statusCode, headers, socket)
160
- }
161
-
162
- /**
163
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
164
- * @param {number} statusCode
165
- * @param {Record<string, string | string[]>} headers
166
- * @param {string} statusMessage
167
- */
168
- onResponseStart (controller, statusCode, headers, statusMessage) {
169
- this.#responseStarted = true
170
- this.#statusCode = statusCode
171
- this.#headers = headers
172
- this.#statusMessage = statusMessage
173
-
174
- this.#primaryHandler.onResponseStart?.(controller, statusCode, headers, statusMessage)
175
-
176
- for (const waitingHandler of this.#waitingHandlers) {
177
- const { handler, controller: waitingController } = waitingHandler
178
-
179
- if (waitingHandler.done || waitingController.aborted) {
180
- waitingHandler.done = true
181
- continue
182
- }
183
-
184
- try {
185
- handler.onResponseStart?.(
186
- waitingController,
187
- statusCode,
188
- headers,
189
- statusMessage
190
- )
191
- } catch {
192
- // Ignore errors from waiting handlers
193
- }
194
-
195
- if (waitingController.aborted) {
196
- waitingHandler.done = true
197
- }
198
- }
199
-
200
- this.#pruneDoneWaitingHandlers()
201
- }
202
-
203
- /**
204
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
205
- * @param {Buffer} chunk
206
- */
207
- onResponseData (controller, chunk) {
208
- if (this.#aborted || this.#completed) {
209
- return
210
- }
211
-
212
- this.#responseDataStarted = true
213
-
214
- this.#primaryHandler.onResponseData?.(controller, chunk)
215
-
216
- for (const waitingHandler of this.#waitingHandlers) {
217
- const { handler, controller: waitingController } = waitingHandler
218
-
219
- if (waitingHandler.done || waitingController.aborted) {
220
- waitingHandler.done = true
221
- continue
222
- }
223
-
224
- if (waitingController.paused) {
225
- this.#bufferWaitingChunk(waitingHandler, chunk)
226
- continue
227
- }
228
-
229
- try {
230
- handler.onResponseData?.(waitingController, chunk)
231
- } catch {
232
- // Ignore errors from waiting handlers
233
- }
234
-
235
- if (waitingController.aborted) {
236
- waitingHandler.done = true
237
- waitingHandler.bufferedChunks = []
238
- waitingHandler.bufferedBytes = 0
239
- }
240
- }
241
-
242
- this.#pruneDoneWaitingHandlers()
243
- }
244
-
245
- /**
246
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
247
- * @param {object} trailers
248
- */
249
- onResponseEnd (controller, trailers) {
250
- if (this.#aborted || this.#completed) {
251
- return
252
- }
253
-
254
- this.#completed = true
255
- this.#primaryHandler.onResponseEnd?.(controller, trailers)
256
-
257
- for (const waitingHandler of this.#waitingHandlers) {
258
- if (waitingHandler.done || waitingHandler.controller.aborted) {
259
- waitingHandler.done = true
260
- continue
261
- }
262
-
263
- this.#flushWaitingHandler(waitingHandler)
264
-
265
- if (waitingHandler.done || waitingHandler.controller.aborted) {
266
- waitingHandler.done = true
267
- continue
268
- }
269
-
270
- if (waitingHandler.controller.paused && waitingHandler.bufferedChunks.length > 0) {
271
- waitingHandler.pendingTrailers = trailers
272
- continue
273
- }
274
-
275
- try {
276
- waitingHandler.handler.onResponseEnd?.(waitingHandler.controller, trailers)
277
- } catch {
278
- // Ignore errors from waiting handlers
279
- }
280
-
281
- waitingHandler.done = true
282
- }
283
-
284
- this.#pruneDoneWaitingHandlers()
285
- this.#onComplete?.()
286
- }
287
-
288
- /**
289
- * @param {import('../../types/dispatcher.d.ts').default.DispatchController} controller
290
- * @param {Error} err
291
- */
292
- onResponseError (controller, err) {
293
- if (this.#completed) {
294
- return
295
- }
296
-
297
- this.#aborted = true
298
- this.#completed = true
299
-
300
- this.#primaryHandler.onResponseError?.(controller, err)
301
-
302
- for (const waitingHandler of this.#waitingHandlers) {
303
- this.#errorWaitingHandler(waitingHandler, err)
304
- }
305
-
306
- this.#waitingHandlers = []
307
- this.#onComplete?.()
308
- }
309
-
310
- /**
311
- * @param {DispatchHandler} handler
312
- * @returns {WaitingHandler}
313
- */
314
- #createWaitingHandler (handler) {
315
- /** @type {WaitingHandler} */
316
- const waitingHandler = {
317
- handler,
318
- controller: null,
319
- bufferedChunks: [],
320
- bufferedBytes: 0,
321
- pendingTrailers: null,
322
- done: false
323
- }
324
-
325
- const state = {
326
- aborted: false,
327
- paused: false,
328
- reason: null
329
- }
330
-
331
- waitingHandler.controller = {
332
- resume: () => {
333
- if (state.aborted) {
334
- return
335
- }
336
-
337
- state.paused = false
338
- this.#flushWaitingHandler(waitingHandler)
339
-
340
- if (
341
- this.#completed &&
342
- waitingHandler.pendingTrailers &&
343
- waitingHandler.bufferedChunks.length === 0 &&
344
- !state.paused &&
345
- !state.aborted
346
- ) {
347
- try {
348
- waitingHandler.handler.onResponseEnd?.(waitingHandler.controller, waitingHandler.pendingTrailers)
349
- } catch {
350
- // Ignore errors from waiting handlers
351
- }
352
-
353
- waitingHandler.pendingTrailers = null
354
- waitingHandler.done = true
355
- }
356
-
357
- this.#pruneDoneWaitingHandlers()
358
- },
359
- pause: () => {
360
- if (!state.aborted) {
361
- state.paused = true
362
- }
363
- },
364
- get paused () { return state.paused },
365
- get aborted () { return state.aborted },
366
- get reason () { return state.reason },
367
- abort: (reason) => {
368
- state.aborted = true
369
- state.reason = reason ?? null
370
- waitingHandler.done = true
371
- waitingHandler.pendingTrailers = null
372
- waitingHandler.bufferedChunks = []
373
- waitingHandler.bufferedBytes = 0
374
- }
375
- }
376
-
377
- return waitingHandler
378
- }
379
-
380
- /**
381
- * @param {WaitingHandler} waitingHandler
382
- * @param {Buffer} chunk
383
- */
384
- #bufferWaitingChunk (waitingHandler, chunk) {
385
- if (waitingHandler.done || waitingHandler.controller.aborted) {
386
- waitingHandler.done = true
387
- waitingHandler.bufferedChunks = []
388
- waitingHandler.bufferedBytes = 0
389
- return
390
- }
391
-
392
- const bufferedChunk = Buffer.from(chunk)
393
- waitingHandler.bufferedChunks.push(bufferedChunk)
394
- waitingHandler.bufferedBytes += bufferedChunk.length
395
-
396
- if (waitingHandler.bufferedBytes > this.#maxBufferSize) {
397
- const err = new RequestAbortedError(`Deduplicated waiting handler exceeded maxBufferSize (${this.#maxBufferSize} bytes) while paused`)
398
- this.#errorWaitingHandler(waitingHandler, err)
399
- }
400
- }
401
-
402
- /**
403
- * @param {WaitingHandler} waitingHandler
404
- */
405
- #flushWaitingHandler (waitingHandler) {
406
- const { handler, controller } = waitingHandler
407
-
408
- while (
409
- !waitingHandler.done &&
410
- !controller.aborted &&
411
- !controller.paused &&
412
- waitingHandler.bufferedChunks.length > 0
413
- ) {
414
- const bufferedChunk = waitingHandler.bufferedChunks.shift()
415
- waitingHandler.bufferedBytes -= bufferedChunk.length
416
-
417
- try {
418
- handler.onResponseData?.(controller, bufferedChunk)
419
- } catch {
420
- // Ignore errors from waiting handlers
421
- }
422
-
423
- if (controller.aborted) {
424
- waitingHandler.done = true
425
- waitingHandler.pendingTrailers = null
426
- waitingHandler.bufferedChunks = []
427
- waitingHandler.bufferedBytes = 0
428
- break
429
- }
430
- }
431
- }
432
-
433
- /**
434
- * @param {WaitingHandler} waitingHandler
435
- * @param {Error} err
436
- */
437
- #errorWaitingHandler (waitingHandler, err) {
438
- if (waitingHandler.done) {
439
- return
440
- }
441
-
442
- waitingHandler.done = true
443
- waitingHandler.pendingTrailers = null
444
- waitingHandler.bufferedChunks = []
445
- waitingHandler.bufferedBytes = 0
446
-
447
- try {
448
- waitingHandler.controller.abort(err)
449
- waitingHandler.handler.onResponseError?.(waitingHandler.controller, err)
450
- } catch {
451
- // Ignore errors from waiting handlers
452
- }
453
- }
454
-
455
- #pruneDoneWaitingHandlers () {
456
- this.#waitingHandlers = this.#waitingHandlers.filter(waitingHandler => waitingHandler.done === false)
457
- }
458
- }
459
-
460
- module.exports = DeduplicationHandler