pi-cursor-sdk 0.1.50 → 0.1.52

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