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,399 +0,0 @@
1
- 'use strict'
2
- const { Transform } = require('node:stream')
3
- const { isASCIINumber, isValidLastEventId } = require('./util')
4
-
5
- /**
6
- * @type {number[]} BOM
7
- */
8
- const BOM = [0xEF, 0xBB, 0xBF]
9
- /**
10
- * @type {10} LF
11
- */
12
- const LF = 0x0A
13
- /**
14
- * @type {13} CR
15
- */
16
- const CR = 0x0D
17
- /**
18
- * @type {58} COLON
19
- */
20
- const COLON = 0x3A
21
- /**
22
- * @type {32} SPACE
23
- */
24
- const SPACE = 0x20
25
-
26
- /**
27
- * @typedef {object} EventSourceStreamEvent
28
- * @type {object}
29
- * @property {string} [event] The event type.
30
- * @property {string} [data] The data of the message.
31
- * @property {string} [id] A unique ID for the event.
32
- * @property {string} [retry] The reconnection time, in milliseconds.
33
- */
34
-
35
- /**
36
- * @typedef eventSourceSettings
37
- * @type {object}
38
- * @property {string} [lastEventId] The last event ID received from the server.
39
- * @property {string} [origin] The origin of the event source.
40
- * @property {number} [reconnectionTime] The reconnection time, in milliseconds.
41
- */
42
-
43
- class EventSourceStream extends Transform {
44
- /**
45
- * @type {eventSourceSettings}
46
- */
47
- state
48
-
49
- /**
50
- * Leading byte-order-mark check.
51
- * @type {boolean}
52
- */
53
- checkBOM = true
54
-
55
- /**
56
- * @type {boolean}
57
- */
58
- crlfCheck = false
59
-
60
- /**
61
- * @type {boolean}
62
- */
63
- eventEndCheck = false
64
-
65
- /**
66
- * @type {Buffer|null}
67
- */
68
- buffer = null
69
-
70
- pos = 0
71
-
72
- event = {
73
- data: undefined,
74
- event: undefined,
75
- id: undefined,
76
- retry: undefined
77
- }
78
-
79
- /**
80
- * @param {object} options
81
- * @param {boolean} [options.readableObjectMode]
82
- * @param {eventSourceSettings} [options.eventSourceSettings]
83
- * @param {(chunk: any, encoding?: BufferEncoding | undefined) => boolean} [options.push]
84
- */
85
- constructor (options = {}) {
86
- // Enable object mode as EventSourceStream emits objects of shape
87
- // EventSourceStreamEvent
88
- options.readableObjectMode = true
89
-
90
- super(options)
91
-
92
- this.state = options.eventSourceSettings || {}
93
- if (options.push) {
94
- this.push = options.push
95
- }
96
- }
97
-
98
- /**
99
- * @param {Buffer} chunk
100
- * @param {string} _encoding
101
- * @param {Function} callback
102
- * @returns {void}
103
- */
104
- _transform (chunk, _encoding, callback) {
105
- if (chunk.length === 0) {
106
- callback()
107
- return
108
- }
109
-
110
- // Cache the chunk in the buffer, as the data might not be complete while
111
- // processing it
112
- // TODO: Investigate if there is a more performant way to handle
113
- // incoming chunks
114
- // see: https://github.com/nodejs/undici/issues/2630
115
- if (this.buffer) {
116
- this.buffer = Buffer.concat([this.buffer, chunk])
117
- } else {
118
- this.buffer = chunk
119
- }
120
-
121
- // Strip leading byte-order-mark if we opened the stream and started
122
- // the processing of the incoming data
123
- if (this.checkBOM) {
124
- switch (this.buffer.length) {
125
- case 1:
126
- // Check if the first byte is the same as the first byte of the BOM
127
- if (this.buffer[0] === BOM[0]) {
128
- // If it is, we need to wait for more data
129
- callback()
130
- return
131
- }
132
- // Set the checkBOM flag to false as we don't need to check for the
133
- // BOM anymore
134
- this.checkBOM = false
135
-
136
- // The buffer only contains one byte so we need to wait for more data
137
- callback()
138
- return
139
- case 2:
140
- // Check if the first two bytes are the same as the first two bytes
141
- // of the BOM
142
- if (
143
- this.buffer[0] === BOM[0] &&
144
- this.buffer[1] === BOM[1]
145
- ) {
146
- // If it is, we need to wait for more data, because the third byte
147
- // is needed to determine if it is the BOM or not
148
- callback()
149
- return
150
- }
151
-
152
- // Set the checkBOM flag to false as we don't need to check for the
153
- // BOM anymore
154
- this.checkBOM = false
155
- break
156
- case 3:
157
- // Check if the first three bytes are the same as the first three
158
- // bytes of the BOM
159
- if (
160
- this.buffer[0] === BOM[0] &&
161
- this.buffer[1] === BOM[1] &&
162
- this.buffer[2] === BOM[2]
163
- ) {
164
- // If it is, we can drop the buffered data, as it is only the BOM
165
- this.buffer = Buffer.alloc(0)
166
- // Set the checkBOM flag to false as we don't need to check for the
167
- // BOM anymore
168
- this.checkBOM = false
169
-
170
- // Await more data
171
- callback()
172
- return
173
- }
174
- // If it is not the BOM, we can start processing the data
175
- this.checkBOM = false
176
- break
177
- default:
178
- // The buffer is longer than 3 bytes, so we can drop the BOM if it is
179
- // present
180
- if (
181
- this.buffer[0] === BOM[0] &&
182
- this.buffer[1] === BOM[1] &&
183
- this.buffer[2] === BOM[2]
184
- ) {
185
- // Remove the BOM from the buffer
186
- this.buffer = this.buffer.subarray(3)
187
- }
188
-
189
- // Set the checkBOM flag to false as we don't need to check for the
190
- this.checkBOM = false
191
- break
192
- }
193
- }
194
-
195
- while (this.pos < this.buffer.length) {
196
- // If the previous line ended with an end-of-line, we need to check
197
- // if the next character is also an end-of-line.
198
- if (this.eventEndCheck) {
199
- // If the the current character is an end-of-line, then the event
200
- // is finished and we can process it
201
-
202
- // If the previous line ended with a carriage return, we need to
203
- // check if the current character is a line feed and remove it
204
- // from the buffer.
205
- if (this.crlfCheck) {
206
- // If the current character is a line feed, we can remove it
207
- // from the buffer and reset the crlfCheck flag
208
- if (this.buffer[this.pos] === LF) {
209
- this.buffer = this.buffer.subarray(this.pos + 1)
210
- this.pos = 0
211
- this.crlfCheck = false
212
-
213
- // It is possible that the line feed is not the end of the
214
- // event. We need to check if the next character is an
215
- // end-of-line character to determine if the event is
216
- // finished. We simply continue the loop to check the next
217
- // character.
218
-
219
- // As we removed the line feed from the buffer and set the
220
- // crlfCheck flag to false, we basically don't make any
221
- // distinction between a line feed and a carriage return.
222
- continue
223
- }
224
- this.crlfCheck = false
225
- }
226
-
227
- if (this.buffer[this.pos] === LF || this.buffer[this.pos] === CR) {
228
- // If the current character is a carriage return, we need to
229
- // set the crlfCheck flag to true, as we need to check if the
230
- // next character is a line feed so we can remove it from the
231
- // buffer
232
- if (this.buffer[this.pos] === CR) {
233
- this.crlfCheck = true
234
- }
235
-
236
- this.buffer = this.buffer.subarray(this.pos + 1)
237
- this.pos = 0
238
- if (
239
- this.event.data !== undefined || this.event.event || this.event.id !== undefined || this.event.retry) {
240
- this.processEvent(this.event)
241
- }
242
- this.clearEvent()
243
- continue
244
- }
245
- // If the current character is not an end-of-line, then the event
246
- // is not finished and we have to reset the eventEndCheck flag
247
- this.eventEndCheck = false
248
- continue
249
- }
250
-
251
- // If the current character is an end-of-line, we can process the
252
- // line
253
- if (this.buffer[this.pos] === LF || this.buffer[this.pos] === CR) {
254
- // If the current character is a carriage return, we need to
255
- // set the crlfCheck flag to true, as we need to check if the
256
- // next character is a line feed
257
- if (this.buffer[this.pos] === CR) {
258
- this.crlfCheck = true
259
- }
260
-
261
- // In any case, we can process the line as we reached an
262
- // end-of-line character
263
- this.parseLine(this.buffer.subarray(0, this.pos), this.event)
264
-
265
- // Remove the processed line from the buffer
266
- this.buffer = this.buffer.subarray(this.pos + 1)
267
- // Reset the position as we removed the processed line from the buffer
268
- this.pos = 0
269
- // A line was processed and this could be the end of the event. We need
270
- // to check if the next line is empty to determine if the event is
271
- // finished.
272
- this.eventEndCheck = true
273
- continue
274
- }
275
-
276
- this.pos++
277
- }
278
-
279
- callback()
280
- }
281
-
282
- /**
283
- * @param {Buffer} line
284
- * @param {EventSourceStreamEvent} event
285
- */
286
- parseLine (line, event) {
287
- // If the line is empty (a blank line)
288
- // Dispatch the event, as defined below.
289
- // This will be handled in the _transform method
290
- if (line.length === 0) {
291
- return
292
- }
293
-
294
- // If the line starts with a U+003A COLON character (:)
295
- // Ignore the line.
296
- const colonPosition = line.indexOf(COLON)
297
- if (colonPosition === 0) {
298
- return
299
- }
300
-
301
- let field = ''
302
- let value = ''
303
-
304
- // If the line contains a U+003A COLON character (:)
305
- if (colonPosition !== -1) {
306
- // Collect the characters on the line before the first U+003A COLON
307
- // character (:), and let field be that string.
308
- // TODO: Investigate if there is a more performant way to extract the
309
- // field
310
- // see: https://github.com/nodejs/undici/issues/2630
311
- field = line.subarray(0, colonPosition).toString('utf8')
312
-
313
- // Collect the characters on the line after the first U+003A COLON
314
- // character (:), and let value be that string.
315
- // If value starts with a U+0020 SPACE character, remove it from value.
316
- let valueStart = colonPosition + 1
317
- if (line[valueStart] === SPACE) {
318
- ++valueStart
319
- }
320
- // TODO: Investigate if there is a more performant way to extract the
321
- // value
322
- // see: https://github.com/nodejs/undici/issues/2630
323
- value = line.subarray(valueStart).toString('utf8')
324
-
325
- // Otherwise, the string is not empty but does not contain a U+003A COLON
326
- // character (:)
327
- } else {
328
- // Process the field using the steps described below, using the whole
329
- // line as the field name, and the empty string as the field value.
330
- field = line.toString('utf8')
331
- value = ''
332
- }
333
-
334
- // Modify the event with the field name and value. The value is also
335
- // decoded as UTF-8
336
- switch (field) {
337
- case 'data':
338
- if (event[field] === undefined) {
339
- event[field] = value
340
- } else {
341
- event[field] += `\n${value}`
342
- }
343
- break
344
- case 'retry':
345
- if (isASCIINumber(value)) {
346
- event[field] = value
347
- }
348
- break
349
- case 'id':
350
- if (isValidLastEventId(value)) {
351
- event[field] = value
352
- }
353
- break
354
- case 'event':
355
- if (value.length > 0) {
356
- event[field] = value
357
- }
358
- break
359
- }
360
- }
361
-
362
- /**
363
- * @param {EventSourceStreamEvent} event
364
- */
365
- processEvent (event) {
366
- if (event.retry && isASCIINumber(event.retry)) {
367
- this.state.reconnectionTime = parseInt(event.retry, 10)
368
- }
369
-
370
- if (event.id !== undefined && isValidLastEventId(event.id)) {
371
- this.state.lastEventId = event.id
372
- }
373
-
374
- // only dispatch event, when data is provided
375
- if (event.data !== undefined) {
376
- this.push({
377
- type: event.event || 'message',
378
- options: {
379
- data: event.data,
380
- lastEventId: this.state.lastEventId,
381
- origin: this.state.origin
382
- }
383
- })
384
- }
385
- }
386
-
387
- clearEvent () {
388
- this.event = {
389
- data: undefined,
390
- event: undefined,
391
- id: undefined,
392
- retry: undefined
393
- }
394
- }
395
- }
396
-
397
- module.exports = {
398
- EventSourceStream
399
- }