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,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
- }