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