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,104 +0,0 @@
1
- 'use strict'
2
-
3
- const { webidl } = require('../../webidl')
4
- const { validateCloseCodeAndReason } = require('../util')
5
- const { kConstruct } = require('../../../core/symbols')
6
- const { kEnumerableProperty } = require('../../../core/util')
7
-
8
- function createInheritableDOMException () {
9
- // https://github.com/nodejs/node/issues/59677
10
- class Test extends DOMException {
11
- get reason () {
12
- return ''
13
- }
14
- }
15
-
16
- if (new Test().reason !== undefined) {
17
- return DOMException
18
- }
19
-
20
- return new Proxy(DOMException, {
21
- construct (target, args, newTarget) {
22
- const instance = Reflect.construct(target, args, target)
23
- Object.setPrototypeOf(instance, newTarget.prototype)
24
- return instance
25
- }
26
- })
27
- }
28
-
29
- class WebSocketError extends createInheritableDOMException() {
30
- #closeCode
31
- #reason
32
-
33
- constructor (message = '', init = undefined) {
34
- message = webidl.converters.DOMString(message, 'WebSocketError', 'message')
35
-
36
- // 1. Set this 's name to " WebSocketError ".
37
- // 2. Set this 's message to message .
38
- super(message, 'WebSocketError')
39
-
40
- if (init === kConstruct) {
41
- return
42
- } else if (init !== null) {
43
- init = webidl.converters.WebSocketCloseInfo(init)
44
- }
45
-
46
- // 3. Let code be init [" closeCode "] if it exists , or null otherwise.
47
- let code = init.closeCode ?? null
48
-
49
- // 4. Let reason be init [" reason "] if it exists , or the empty string otherwise.
50
- const reason = init.reason ?? ''
51
-
52
- // 5. Validate close code and reason with code and reason .
53
- validateCloseCodeAndReason(code, reason)
54
-
55
- // 6. If reason is non-empty, but code is not set, then set code to 1000 ("Normal Closure").
56
- if (reason.length !== 0 && code === null) {
57
- code = 1000
58
- }
59
-
60
- // 7. Set this 's closeCode to code .
61
- this.#closeCode = code
62
-
63
- // 8. Set this 's reason to reason .
64
- this.#reason = reason
65
- }
66
-
67
- get closeCode () {
68
- return this.#closeCode
69
- }
70
-
71
- get reason () {
72
- return this.#reason
73
- }
74
-
75
- /**
76
- * @param {string} message
77
- * @param {number|null} code
78
- * @param {string} reason
79
- */
80
- static createUnvalidatedWebSocketError (message, code, reason) {
81
- const error = new WebSocketError(message, kConstruct)
82
- error.#closeCode = code
83
- error.#reason = reason
84
- return error
85
- }
86
- }
87
-
88
- const { createUnvalidatedWebSocketError } = WebSocketError
89
- delete WebSocketError.createUnvalidatedWebSocketError
90
-
91
- Object.defineProperties(WebSocketError.prototype, {
92
- closeCode: kEnumerableProperty,
93
- reason: kEnumerableProperty,
94
- [Symbol.toStringTag]: {
95
- value: 'WebSocketError',
96
- writable: false,
97
- enumerable: false,
98
- configurable: true
99
- }
100
- })
101
-
102
- webidl.is.WebSocketError = webidl.util.MakeTypeAssertion(WebSocketError)
103
-
104
- module.exports = { WebSocketError, createUnvalidatedWebSocketError }
@@ -1,498 +0,0 @@
1
- 'use strict'
2
-
3
- const { createDeferredPromise } = require('../../../util/promise')
4
- const { environmentSettingsObject } = require('../../fetch/util')
5
- const { states, opcodes, sentCloseFrameState } = require('../constants')
6
- const { webidl } = require('../../webidl')
7
- const { getURLRecord, isValidSubprotocol, isEstablished, utf8Decode } = require('../util')
8
- const { establishWebSocketConnection, failWebsocketConnection, closeWebSocketConnection } = require('../connection')
9
- const { channels } = require('../../../core/diagnostics')
10
- const { WebsocketFrameSend } = require('../frame')
11
- const { ByteParser } = require('../receiver')
12
- const { WebSocketError, createUnvalidatedWebSocketError } = require('./websocketerror')
13
- const { kEnumerableProperty } = require('../../../core/util')
14
- const { utf8DecodeBytes } = require('../../../encoding')
15
-
16
- let emittedExperimentalWarning = false
17
-
18
- class WebSocketStream {
19
- // Each WebSocketStream object has an associated url , which is a URL record .
20
- /** @type {URL} */
21
- #url
22
-
23
- // Each WebSocketStream object has an associated opened promise , which is a promise.
24
- /** @type {import('../../../util/promise').DeferredPromise} */
25
- #openedPromise
26
-
27
- // Each WebSocketStream object has an associated closed promise , which is a promise.
28
- /** @type {import('../../../util/promise').DeferredPromise} */
29
- #closedPromise
30
-
31
- // Each WebSocketStream object has an associated readable stream , which is a ReadableStream .
32
- /** @type {ReadableStream} */
33
- #readableStream
34
- /** @type {ReadableStreamDefaultController} */
35
- #readableStreamController
36
-
37
- // Each WebSocketStream object has an associated writable stream , which is a WritableStream .
38
- /** @type {WritableStream} */
39
- #writableStream
40
-
41
- // Each WebSocketStream object has an associated boolean handshake aborted , which is initially false.
42
- #handshakeAborted = false
43
-
44
- /** @type {import('../websocket').Handler} */
45
- #handler = {
46
- // https://whatpr.org/websockets/48/7b748d3...d5570f3.html#feedback-to-websocket-stream-from-the-protocol
47
- onConnectionEstablished: (response, extensions) => this.#onConnectionEstablished(response, extensions),
48
- onMessage: (opcode, data) => this.#onMessage(opcode, data),
49
- onParserError: (err) => failWebsocketConnection(this.#handler, null, err.message),
50
- onParserDrain: () => this.#handler.socket.resume(),
51
- onSocketData: (chunk) => {
52
- if (!this.#parser.write(chunk)) {
53
- this.#handler.socket.pause()
54
- }
55
- },
56
- onSocketError: (err) => {
57
- this.#handler.readyState = states.CLOSING
58
-
59
- if (channels.socketError.hasSubscribers) {
60
- channels.socketError.publish(err)
61
- }
62
-
63
- this.#handler.socket.destroy()
64
- },
65
- onSocketClose: () => this.#onSocketClose(),
66
- onPing: () => {},
67
- onPong: () => {},
68
-
69
- readyState: states.CONNECTING,
70
- socket: null,
71
- closeState: new Set(),
72
- controller: null,
73
- wasEverConnected: false
74
- }
75
-
76
- /** @type {import('../receiver').ByteParser} */
77
- #parser
78
-
79
- constructor (url, options = undefined) {
80
- if (!emittedExperimentalWarning) {
81
- process.emitWarning('WebSocketStream is experimental! Expect it to change at any time.', {
82
- code: 'UNDICI-WSS'
83
- })
84
- emittedExperimentalWarning = true
85
- }
86
-
87
- webidl.argumentLengthCheck(arguments, 1, 'WebSocket')
88
-
89
- url = webidl.converters.USVString(url)
90
- if (options !== null) {
91
- options = webidl.converters.WebSocketStreamOptions(options)
92
- }
93
-
94
- // 1. Let baseURL be this 's relevant settings object 's API base URL .
95
- const baseURL = environmentSettingsObject.settingsObject.baseUrl
96
-
97
- // 2. Let urlRecord be the result of getting a URL record given url and baseURL .
98
- const urlRecord = getURLRecord(url, baseURL)
99
-
100
- // 3. Let protocols be options [" protocols "] if it exists , otherwise an empty sequence.
101
- const protocols = options.protocols
102
-
103
- // 4. If any of the values in protocols occur more than once or otherwise fail to match the requirements for elements that comprise the value of ` Sec-WebSocket-Protocol ` fields as defined by The WebSocket Protocol , then throw a " SyntaxError " DOMException . [WSP]
104
- if (protocols.length !== new Set(protocols.map(p => p.toLowerCase())).size) {
105
- throw new DOMException('Invalid Sec-WebSocket-Protocol value', 'SyntaxError')
106
- }
107
-
108
- if (protocols.length > 0 && !protocols.every(p => isValidSubprotocol(p))) {
109
- throw new DOMException('Invalid Sec-WebSocket-Protocol value', 'SyntaxError')
110
- }
111
-
112
- // 5. Set this 's url to urlRecord .
113
- this.#url = urlRecord.toString()
114
-
115
- // 6. Set this 's opened promise and closed promise to new promises.
116
- this.#openedPromise = createDeferredPromise()
117
- this.#closedPromise = createDeferredPromise()
118
-
119
- // 7. Apply backpressure to the WebSocket.
120
- // TODO
121
-
122
- // 8. If options [" signal "] exists ,
123
- if (options.signal != null) {
124
- // 8.1. Let signal be options [" signal "].
125
- const signal = options.signal
126
-
127
- // 8.2. If signal is aborted , then reject this 's opened promise and closed promise with signal ’s abort reason
128
- // and return.
129
- if (signal.aborted) {
130
- this.#openedPromise.reject(signal.reason)
131
- this.#closedPromise.reject(signal.reason)
132
- return
133
- }
134
-
135
- // 8.3. Add the following abort steps to signal :
136
- signal.addEventListener('abort', () => {
137
- // 8.3.1. If the WebSocket connection is not yet established : [WSP]
138
- if (!isEstablished(this.#handler.readyState)) {
139
- // 8.3.1.1. Fail the WebSocket connection .
140
- failWebsocketConnection(this.#handler)
141
-
142
- // Set this 's ready state to CLOSING .
143
- this.#handler.readyState = states.CLOSING
144
-
145
- // Reject this 's opened promise and closed promise with signal ’s abort reason .
146
- this.#openedPromise.reject(signal.reason)
147
- this.#closedPromise.reject(signal.reason)
148
-
149
- // Set this 's handshake aborted to true.
150
- this.#handshakeAborted = true
151
- }
152
- }, { once: true })
153
- }
154
-
155
- // 9. Let client be this 's relevant settings object .
156
- const client = environmentSettingsObject.settingsObject
157
-
158
- // 10. Run this step in parallel :
159
- // 10.1. Establish a WebSocket connection given urlRecord , protocols , and client . [FETCH]
160
- this.#handler.controller = establishWebSocketConnection(
161
- urlRecord,
162
- protocols,
163
- client,
164
- this.#handler,
165
- options
166
- )
167
- }
168
-
169
- // The url getter steps are to return this 's url , serialized .
170
- get url () {
171
- return this.#url.toString()
172
- }
173
-
174
- // The opened getter steps are to return this 's opened promise .
175
- get opened () {
176
- return this.#openedPromise.promise
177
- }
178
-
179
- // The closed getter steps are to return this 's closed promise .
180
- get closed () {
181
- return this.#closedPromise.promise
182
- }
183
-
184
- // The close( closeInfo ) method steps are:
185
- close (closeInfo = undefined) {
186
- if (closeInfo !== null) {
187
- closeInfo = webidl.converters.WebSocketCloseInfo(closeInfo)
188
- }
189
-
190
- // 1. Let code be closeInfo [" closeCode "] if present, or null otherwise.
191
- const code = closeInfo.closeCode ?? null
192
-
193
- // 2. Let reason be closeInfo [" reason "].
194
- const reason = closeInfo.reason
195
-
196
- // 3. Close the WebSocket with this , code , and reason .
197
- closeWebSocketConnection(this.#handler, code, reason, true)
198
- }
199
-
200
- #write (chunk) {
201
- // See /websockets/stream/tentative/write.any.html
202
- chunk = webidl.converters.WebSocketStreamWrite(chunk)
203
-
204
- // 1. Let promise be a new promise created in stream ’s relevant realm .
205
- const promise = createDeferredPromise()
206
-
207
- // 2. Let data be null.
208
- let data = null
209
-
210
- // 3. Let opcode be null.
211
- let opcode = null
212
-
213
- // 4. If chunk is a BufferSource ,
214
- if (webidl.is.BufferSource(chunk)) {
215
- // 4.1. Set data to a copy of the bytes given chunk .
216
- data = new Uint8Array(ArrayBuffer.isView(chunk) ? new Uint8Array(chunk.buffer, chunk.byteOffset, chunk.byteLength) : chunk.slice())
217
-
218
- // 4.2. Set opcode to a binary frame opcode.
219
- opcode = opcodes.BINARY
220
- } else {
221
- // 5. Otherwise,
222
-
223
- // 5.1. Let string be the result of converting chunk to an IDL USVString .
224
- // If this throws an exception, return a promise rejected with the exception.
225
- let string
226
-
227
- try {
228
- string = webidl.converters.DOMString(chunk)
229
- } catch (e) {
230
- promise.reject(e)
231
- return promise.promise
232
- }
233
-
234
- // 5.2. Set data to the result of UTF-8 encoding string .
235
- data = new TextEncoder().encode(string)
236
-
237
- // 5.3. Set opcode to a text frame opcode.
238
- opcode = opcodes.TEXT
239
- }
240
-
241
- // 6. In parallel,
242
- // 6.1. Wait until there is sufficient buffer space in stream to send the message.
243
-
244
- // 6.2. If the closing handshake has not yet started , Send a WebSocket Message to stream comprised of data using opcode .
245
- if (!this.#handler.closeState.has(sentCloseFrameState.SENT) && !this.#handler.closeState.has(sentCloseFrameState.RECEIVED)) {
246
- const frame = new WebsocketFrameSend(data)
247
-
248
- this.#handler.socket.write(frame.createFrame(opcode), () => {
249
- promise.resolve(undefined)
250
- })
251
- }
252
-
253
- // 6.3. Queue a global task on the WebSocket task source given stream ’s relevant global object to resolve promise with undefined.
254
- return promise.promise
255
- }
256
-
257
- /** @type {import('../websocket').Handler['onConnectionEstablished']} */
258
- #onConnectionEstablished (response, parsedExtensions) {
259
- this.#handler.socket = response.socket
260
-
261
- // Get options from dispatcher options
262
- const maxFragments = this.#handler.controller.dispatcher?.webSocketOptions?.maxFragments
263
- const maxPayloadSize = this.#handler.controller.dispatcher?.webSocketOptions?.maxPayloadSize
264
-
265
- const parser = new ByteParser(this.#handler, parsedExtensions, {
266
- maxFragments,
267
- maxPayloadSize
268
- })
269
- parser.on('drain', () => this.#handler.onParserDrain())
270
- parser.on('error', (err) => this.#handler.onParserError(err))
271
-
272
- this.#parser = parser
273
-
274
- // 1. Change stream ’s ready state to OPEN (1).
275
- this.#handler.readyState = states.OPEN
276
-
277
- // 2. Set stream ’s was ever connected to true.
278
- // This is done in the opening handshake.
279
-
280
- // 3. Let extensions be the extensions in use .
281
- const extensions = parsedExtensions ?? ''
282
-
283
- // 4. Let protocol be the subprotocol in use .
284
- const protocol = response.headersList.get('sec-websocket-protocol') ?? ''
285
-
286
- // 5. Let pullAlgorithm be an action that pulls bytes from stream .
287
- // 6. Let cancelAlgorithm be an action that cancels stream with reason , given reason .
288
- // 7. Let readable be a new ReadableStream .
289
- // 8. Set up readable with pullAlgorithm and cancelAlgorithm .
290
- const readable = new ReadableStream({
291
- start: (controller) => {
292
- this.#readableStreamController = controller
293
- },
294
- cancel: (reason) => this.#cancel(reason)
295
- })
296
-
297
- // 9. Let writeAlgorithm be an action that writes chunk to stream , given chunk .
298
- // 10. Let closeAlgorithm be an action that closes stream .
299
- // 11. Let abortAlgorithm be an action that aborts stream with reason , given reason .
300
- // 12. Let writable be a new WritableStream .
301
- // 13. Set up writable with writeAlgorithm , closeAlgorithm , and abortAlgorithm .
302
- const writable = new WritableStream({
303
- write: (chunk) => this.#write(chunk),
304
- close: () => closeWebSocketConnection(this.#handler, null, null),
305
- abort: (reason) => this.#closeUsingReason(reason)
306
- })
307
-
308
- // Set stream ’s readable stream to readable .
309
- this.#readableStream = readable
310
-
311
- // Set stream ’s writable stream to writable .
312
- this.#writableStream = writable
313
-
314
- // Resolve stream ’s opened promise with WebSocketOpenInfo «[ " extensions " → extensions , " protocol " → protocol , " readable " → readable , " writable " → writable ]».
315
- this.#openedPromise.resolve({
316
- extensions,
317
- protocol,
318
- readable,
319
- writable
320
- })
321
- }
322
-
323
- /** @type {import('../websocket').Handler['onMessage']} */
324
- #onMessage (type, data) {
325
- // 1. If stream’s ready state is not OPEN (1), then return.
326
- if (this.#handler.readyState !== states.OPEN) {
327
- return
328
- }
329
-
330
- // 2. Let chunk be determined by switching on type:
331
- // - type indicates that the data is Text
332
- // a new DOMString containing data
333
- // - type indicates that the data is Binary
334
- // a new Uint8Array object, created in the relevant Realm of the
335
- // WebSocketStream object, whose contents are data
336
- let chunk
337
-
338
- if (type === opcodes.TEXT) {
339
- try {
340
- chunk = utf8Decode(data)
341
- } catch {
342
- failWebsocketConnection(this.#handler, 1007, 'Received invalid UTF-8 in text frame.')
343
- return
344
- }
345
- } else if (type === opcodes.BINARY) {
346
- chunk = new Uint8Array(data.buffer, data.byteOffset, data.byteLength)
347
- }
348
-
349
- // 3. Enqueue chunk into stream’s readable stream.
350
- this.#readableStreamController.enqueue(chunk)
351
-
352
- // 4. Apply backpressure to the WebSocket.
353
- }
354
-
355
- /** @type {import('../websocket').Handler['onSocketClose']} */
356
- #onSocketClose () {
357
- const wasClean =
358
- this.#handler.closeState.has(sentCloseFrameState.SENT) &&
359
- this.#handler.closeState.has(sentCloseFrameState.RECEIVED)
360
-
361
- // 1. Change the ready state to CLOSED (3).
362
- this.#handler.readyState = states.CLOSED
363
-
364
- // 2. If stream ’s handshake aborted is true, then return.
365
- if (this.#handshakeAborted) {
366
- return
367
- }
368
-
369
- // 3. If stream ’s was ever connected is false, then reject stream ’s opened promise with a new WebSocketError.
370
- if (!this.#handler.wasEverConnected) {
371
- this.#openedPromise.reject(new WebSocketError('Socket never opened'))
372
- }
373
-
374
- const result = this.#parser?.closingInfo
375
-
376
- // 4. Let code be the WebSocket connection close code .
377
- // https://datatracker.ietf.org/doc/html/rfc6455#section-7.1.5
378
- // If this Close control frame contains no status code, _The WebSocket
379
- // Connection Close Code_ is considered to be 1005. If _The WebSocket
380
- // Connection is Closed_ and no Close control frame was received by the
381
- // endpoint (such as could occur if the underlying transport connection
382
- // is lost), _The WebSocket Connection Close Code_ is considered to be
383
- // 1006.
384
- let code = result?.code ?? 1005
385
-
386
- if (!this.#handler.closeState.has(sentCloseFrameState.SENT) && !this.#handler.closeState.has(sentCloseFrameState.RECEIVED)) {
387
- code = 1006
388
- }
389
-
390
- // 5. Let reason be the result of applying UTF-8 decode without BOM to the WebSocket connection close reason .
391
- const reason = result?.reason == null ? '' : utf8DecodeBytes(Buffer.from(result.reason))
392
-
393
- // 6. If the connection was closed cleanly ,
394
- if (wasClean) {
395
- // 6.1. Close stream ’s readable stream .
396
- this.#readableStreamController.close()
397
-
398
- // 6.2. Error stream ’s writable stream with an " InvalidStateError " DOMException indicating that a closed WebSocketStream cannot be written to.
399
- if (!this.#writableStream.locked) {
400
- this.#writableStream.abort(new DOMException('A closed WebSocketStream cannot be written to', 'InvalidStateError'))
401
- }
402
-
403
- // 6.3. Resolve stream ’s closed promise with WebSocketCloseInfo «[ " closeCode " → code , " reason " → reason ]».
404
- this.#closedPromise.resolve({
405
- closeCode: code,
406
- reason
407
- })
408
- } else {
409
- // 7. Otherwise,
410
-
411
- // 7.1. Let error be a new WebSocketError whose closeCode is code and reason is reason .
412
- const error = createUnvalidatedWebSocketError('unclean close', code, reason)
413
-
414
- // 7.2. Error stream ’s readable stream with error .
415
- this.#readableStreamController?.error(error)
416
-
417
- // 7.3. Error stream ’s writable stream with error .
418
- this.#writableStream?.abort(error)
419
-
420
- // 7.4. Reject stream ’s closed promise with error .
421
- this.#closedPromise.reject(error)
422
- }
423
- }
424
-
425
- #closeUsingReason (reason) {
426
- // 1. Let code be null.
427
- let code = null
428
-
429
- // 2. Let reasonString be the empty string.
430
- let reasonString = ''
431
-
432
- // 3. If reason implements WebSocketError ,
433
- if (webidl.is.WebSocketError(reason)) {
434
- // 3.1. Set code to reason ’s closeCode .
435
- code = reason.closeCode
436
-
437
- // 3.2. Set reasonString to reason ’s reason .
438
- reasonString = reason.reason
439
- }
440
-
441
- // 4. Close the WebSocket with stream , code , and reasonString . If this throws an exception,
442
- // discard code and reasonString and close the WebSocket with stream .
443
- closeWebSocketConnection(this.#handler, code, reasonString)
444
- }
445
-
446
- // To cancel a WebSocketStream stream given reason , close using reason giving stream and reason .
447
- #cancel (reason) {
448
- this.#closeUsingReason(reason)
449
- }
450
- }
451
-
452
- Object.defineProperties(WebSocketStream.prototype, {
453
- url: kEnumerableProperty,
454
- opened: kEnumerableProperty,
455
- closed: kEnumerableProperty,
456
- close: kEnumerableProperty,
457
- [Symbol.toStringTag]: {
458
- value: 'WebSocketStream',
459
- writable: false,
460
- enumerable: false,
461
- configurable: true
462
- }
463
- })
464
-
465
- webidl.converters.WebSocketStreamOptions = webidl.dictionaryConverter([
466
- {
467
- key: 'protocols',
468
- converter: webidl.sequenceConverter(webidl.converters.USVString),
469
- defaultValue: () => []
470
- },
471
- {
472
- key: 'signal',
473
- converter: webidl.nullableConverter(webidl.converters.AbortSignal),
474
- defaultValue: () => null
475
- }
476
- ])
477
-
478
- webidl.converters.WebSocketCloseInfo = webidl.dictionaryConverter([
479
- {
480
- key: 'closeCode',
481
- converter: (V) => webidl.converters['unsigned short'](V, webidl.attributes.EnforceRange)
482
- },
483
- {
484
- key: 'reason',
485
- converter: webidl.converters.USVString,
486
- defaultValue: () => ''
487
- }
488
- ])
489
-
490
- webidl.converters.WebSocketStreamWrite = function (V) {
491
- if (typeof V === 'string') {
492
- return webidl.converters.USVString(V)
493
- }
494
-
495
- return webidl.converters.BufferSource(V)
496
- }
497
-
498
- module.exports = { WebSocketStream }