pi-cursor-sdk 0.1.50 → 0.1.52

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/CHANGELOG.md +31 -0
  2. package/README.md +1 -1
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +3 -12
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-turn-runner.ts +1 -1
  12. package/src/cursor-provider.ts +9 -2
  13. package/src/cursor-session-turn-queue.ts +52 -0
  14. package/src/cursor-tool-manifest.ts +1 -1
  15. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  42. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  44. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  48. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  52. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  54. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  56. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  68. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  69. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  70. package/node_modules/undici/LICENSE +0 -21
  71. package/node_modules/undici/README.md +0 -741
  72. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  73. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  74. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  75. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  76. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  77. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  78. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  79. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  80. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  81. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  82. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  83. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  84. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  85. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  86. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  87. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  88. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  89. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  90. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  91. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  92. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  93. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  94. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  95. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  96. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  97. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  98. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  99. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  100. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  101. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  102. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  103. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  104. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  105. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  106. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  107. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  108. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  109. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  110. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  111. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  112. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  113. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  114. package/node_modules/undici/index-fetch.js +0 -65
  115. package/node_modules/undici/index.d.ts +0 -3
  116. package/node_modules/undici/index.js +0 -234
  117. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  118. package/node_modules/undici/lib/api/api-connect.js +0 -110
  119. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  120. package/node_modules/undici/lib/api/api-request.js +0 -214
  121. package/node_modules/undici/lib/api/api-stream.js +0 -209
  122. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  123. package/node_modules/undici/lib/api/index.js +0 -7
  124. package/node_modules/undici/lib/api/readable.js +0 -580
  125. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  126. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  127. package/node_modules/undici/lib/core/connect.js +0 -153
  128. package/node_modules/undici/lib/core/constants.js +0 -143
  129. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  130. package/node_modules/undici/lib/core/errors.js +0 -477
  131. package/node_modules/undici/lib/core/request.js +0 -453
  132. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  133. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  134. package/node_modules/undici/lib/core/symbols.js +0 -75
  135. package/node_modules/undici/lib/core/tree.js +0 -160
  136. package/node_modules/undici/lib/core/util.js +0 -992
  137. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  138. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  139. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  140. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  141. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  142. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  143. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  144. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  145. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  146. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  147. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  148. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  149. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  150. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  151. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  152. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  153. package/node_modules/undici/lib/encoding/index.js +0 -33
  154. package/node_modules/undici/lib/global.js +0 -59
  155. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  156. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  157. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  158. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  159. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  160. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  161. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  162. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  163. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  164. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  165. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  166. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  167. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  168. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  169. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  170. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  171. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  172. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  173. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  174. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  176. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  177. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  178. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  179. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  180. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  181. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  182. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  183. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  184. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  185. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  186. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  187. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  188. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  189. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  190. package/node_modules/undici/lib/util/cache.js +0 -414
  191. package/node_modules/undici/lib/util/date.js +0 -653
  192. package/node_modules/undici/lib/util/promise.js +0 -28
  193. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  194. package/node_modules/undici/lib/util/stats.js +0 -32
  195. package/node_modules/undici/lib/util/timers.js +0 -425
  196. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  197. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  198. package/node_modules/undici/lib/web/cache/util.js +0 -45
  199. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  200. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  201. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  202. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  203. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  204. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  205. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  206. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  207. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  208. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  209. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  210. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  211. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  212. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  213. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  214. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  215. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  216. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  217. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  218. package/node_modules/undici/lib/web/infra/index.js +0 -229
  219. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  220. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  221. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  222. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  223. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  224. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  225. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  226. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  227. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  228. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  229. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  230. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  231. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  232. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  233. package/node_modules/undici/package.json +0 -152
  234. package/node_modules/undici/scripts/strip-comments.js +0 -10
  235. package/node_modules/undici/types/README.md +0 -6
  236. package/node_modules/undici/types/agent.d.ts +0 -32
  237. package/node_modules/undici/types/api.d.ts +0 -43
  238. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  239. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  240. package/node_modules/undici/types/cache.d.ts +0 -36
  241. package/node_modules/undici/types/client-stats.d.ts +0 -15
  242. package/node_modules/undici/types/client.d.ts +0 -139
  243. package/node_modules/undici/types/connector.d.ts +0 -36
  244. package/node_modules/undici/types/content-type.d.ts +0 -21
  245. package/node_modules/undici/types/cookies.d.ts +0 -30
  246. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  247. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  248. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  249. package/node_modules/undici/types/errors.d.ts +0 -177
  250. package/node_modules/undici/types/eventsource.d.ts +0 -66
  251. package/node_modules/undici/types/fetch.d.ts +0 -231
  252. package/node_modules/undici/types/formdata.d.ts +0 -114
  253. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  254. package/node_modules/undici/types/global-origin.d.ts +0 -7
  255. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  256. package/node_modules/undici/types/handlers.d.ts +0 -14
  257. package/node_modules/undici/types/header.d.ts +0 -160
  258. package/node_modules/undici/types/index.d.ts +0 -91
  259. package/node_modules/undici/types/interceptors.d.ts +0 -80
  260. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  261. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  262. package/node_modules/undici/types/mock-client.d.ts +0 -27
  263. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  264. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  265. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  266. package/node_modules/undici/types/patch.d.ts +0 -29
  267. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  268. package/node_modules/undici/types/pool.d.ts +0 -41
  269. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  270. package/node_modules/undici/types/readable.d.ts +0 -68
  271. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  272. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  273. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  274. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  275. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  276. package/node_modules/undici/types/util.d.ts +0 -18
  277. package/node_modules/undici/types/utility.d.ts +0 -7
  278. package/node_modules/undici/types/webidl.d.ts +0 -347
  279. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -1,23 +0,0 @@
1
- // Copyright 2021-2024 The Connect Authors
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
- // Polyfill the Headers API for Node versions < 18
15
- import "./node-headers-polyfill.js";
16
- export { createGrpcWebTransport } from "./grpc-web-transport.js";
17
- export { createGrpcTransport } from "./grpc-transport.js";
18
- export { createConnectTransport } from "./connect-transport.js";
19
- export { compressionBrotli, compressionGzip } from "./compression.js";
20
- export { connectNodeAdapter } from "./connect-node-adapter.js";
21
- export { universalRequestFromNodeRequest, universalResponseToNodeResponse, } from "./node-universal-handler.js";
22
- export { createNodeHttpClient } from "./node-universal-client.js";
23
- export { Http2SessionManager } from "./http2-session-manager.js";
@@ -1,45 +0,0 @@
1
- import { ConnectError } from "@connectrpc/connect";
2
- /**
3
- * Similar to ConnectError.from(), this function turns any value into
4
- * a ConnectError, but special cases some Node.js specific error codes and
5
- * sets an appropriate Connect error code.
6
- */
7
- export declare function connectErrorFromNodeReason(reason: unknown): ConnectError;
8
- /**
9
- * Unwraps a chain of errors, by walking through all "cause" properties
10
- * recursively.
11
- * This function is useful to find the root cause of an error.
12
- */
13
- export declare function unwrapNodeErrorChain(reason: unknown): Error[];
14
- /**
15
- * Returns standard Node.js error properties from the given reason, if present.
16
- *
17
- * For context: Every error raised by Node.js APIs should expose a `code`
18
- * property - a string that permanently identifies the error. Some errors may
19
- * have an additional `syscall` property - a string that identifies native
20
- * components, for example "getaddrinfo" of libuv.
21
- * For more information, see https://github.com/nodejs/node/blob/f6052c68c1f9a4400a723e9c0b79da14197ab754/lib/internal/errors.js
22
- */
23
- export declare function getNodeErrorProps(reason: unknown): {
24
- code?: string;
25
- syscall?: string;
26
- };
27
- /**
28
- * Returns a ConnectError for an HTTP/2 error code.
29
- */
30
- export declare function connectErrorFromH2ResetCode(rstCode: number): ConnectError | undefined;
31
- export declare enum H2Code {
32
- PROTOCOL_ERROR = 1,
33
- INTERNAL_ERROR = 2,
34
- FLOW_CONTROL_ERROR = 3,
35
- SETTINGS_TIMEOUT = 4,
36
- STREAM_CLOSED = 5,
37
- FRAME_SIZE_ERROR = 6,
38
- REFUSED_STREAM = 7,
39
- CANCEL = 8,
40
- COMPRESSION_ERROR = 9,
41
- CONNECT_ERROR = 10,
42
- ENHANCE_YOUR_CALM = 11,
43
- INADEQUATE_SECURITY = 12,
44
- HTTP_1_1_REQUIRED = 13
45
- }
@@ -1,147 +0,0 @@
1
- // Copyright 2021-2024 The Connect Authors
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
- import { Code, ConnectError } from "@connectrpc/connect";
15
- /**
16
- * Similar to ConnectError.from(), this function turns any value into
17
- * a ConnectError, but special cases some Node.js specific error codes and
18
- * sets an appropriate Connect error code.
19
- */
20
- export function connectErrorFromNodeReason(reason) {
21
- let code = Code.Internal;
22
- const chain = unwrapNodeErrorChain(reason).map(getNodeErrorProps);
23
- if (chain.some((p) => p.code == "ERR_STREAM_WRITE_AFTER_END")) {
24
- // We do not want intentional errors from the server to be shadowed
25
- // by client-side errors.
26
- // This can occur if the server has written a response with an error
27
- // and has ended the connection. This response may already sit in a
28
- // buffer on the client, while it is still writing to the request
29
- // body.
30
- // To avoid this problem, we wrap ERR_STREAM_WRITE_AFTER_END as a
31
- // ConnectError with Code.Aborted. The special meaning of this code
32
- // in this situation is documented in StreamingConn.send() and in
33
- // createServerStreamingFn().
34
- code = Code.Aborted;
35
- }
36
- else if (chain.some((p) => p.code == "ERR_STREAM_DESTROYED" ||
37
- p.code == "ERR_HTTP2_INVALID_STREAM" ||
38
- p.code == "ECONNRESET")) {
39
- // A handler whose stream is suddenly destroyed usually means the client
40
- // hung up. This behavior is triggered by the conformance test "cancel_after_begin".
41
- code = Code.Aborted;
42
- }
43
- else if (chain.some((p) => p.code == "ETIMEDOUT" ||
44
- p.code == "ENOTFOUND" ||
45
- p.code == "EAI_AGAIN" ||
46
- p.code == "ECONNREFUSED")) {
47
- // Calling an unresolvable host should raise a ConnectError with
48
- // Code.Aborted.
49
- // This behavior is covered by the conformance test "unresolvable_host".
50
- code = Code.Unavailable;
51
- }
52
- const ce = ConnectError.from(reason, code);
53
- if (ce !== reason) {
54
- ce.cause = reason;
55
- }
56
- return ce;
57
- }
58
- /**
59
- * Unwraps a chain of errors, by walking through all "cause" properties
60
- * recursively.
61
- * This function is useful to find the root cause of an error.
62
- */
63
- export function unwrapNodeErrorChain(reason) {
64
- const chain = [];
65
- for (;;) {
66
- if (!(reason instanceof Error)) {
67
- break;
68
- }
69
- if (chain.includes(reason)) {
70
- // safeguard against infinite loop when "cause" points to an ancestor
71
- break;
72
- }
73
- chain.push(reason);
74
- if (!("cause" in reason)) {
75
- break;
76
- }
77
- reason = reason.cause;
78
- }
79
- return chain;
80
- }
81
- /**
82
- * Returns standard Node.js error properties from the given reason, if present.
83
- *
84
- * For context: Every error raised by Node.js APIs should expose a `code`
85
- * property - a string that permanently identifies the error. Some errors may
86
- * have an additional `syscall` property - a string that identifies native
87
- * components, for example "getaddrinfo" of libuv.
88
- * For more information, see https://github.com/nodejs/node/blob/f6052c68c1f9a4400a723e9c0b79da14197ab754/lib/internal/errors.js
89
- */
90
- export function getNodeErrorProps(reason) {
91
- const props = {};
92
- if (reason instanceof Error) {
93
- if ("code" in reason && typeof reason.code == "string") {
94
- props.code = reason.code;
95
- }
96
- if ("syscall" in reason && typeof reason.syscall == "string") {
97
- props.syscall = reason.syscall;
98
- }
99
- }
100
- return props;
101
- }
102
- /**
103
- * Returns a ConnectError for an HTTP/2 error code.
104
- */
105
- export function connectErrorFromH2ResetCode(rstCode) {
106
- switch (rstCode) {
107
- case H2Code.PROTOCOL_ERROR:
108
- case H2Code.INTERNAL_ERROR:
109
- case H2Code.FLOW_CONTROL_ERROR:
110
- case H2Code.SETTINGS_TIMEOUT:
111
- case H2Code.FRAME_SIZE_ERROR:
112
- case H2Code.COMPRESSION_ERROR:
113
- case H2Code.CONNECT_ERROR:
114
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.Internal);
115
- case H2Code.REFUSED_STREAM:
116
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.Unavailable);
117
- case H2Code.CANCEL:
118
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.Canceled);
119
- case H2Code.ENHANCE_YOUR_CALM:
120
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.ResourceExhausted);
121
- case H2Code.INADEQUATE_SECURITY:
122
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.PermissionDenied);
123
- case H2Code.HTTP_1_1_REQUIRED:
124
- return new ConnectError(`http/2 stream closed with error code ${H2Code[rstCode]} (0x${rstCode.toString(16)})`, Code.PermissionDenied);
125
- case H2Code.STREAM_CLOSED:
126
- default:
127
- // Intentionally not mapping STREAM_CLOSED (0x5), see https://github.com/grpc/grpc/blob/master/doc/PROTOCOL-HTTP2.md#errors
128
- break;
129
- }
130
- return undefined;
131
- }
132
- export var H2Code;
133
- (function (H2Code) {
134
- H2Code[H2Code["PROTOCOL_ERROR"] = 1] = "PROTOCOL_ERROR";
135
- H2Code[H2Code["INTERNAL_ERROR"] = 2] = "INTERNAL_ERROR";
136
- H2Code[H2Code["FLOW_CONTROL_ERROR"] = 3] = "FLOW_CONTROL_ERROR";
137
- H2Code[H2Code["SETTINGS_TIMEOUT"] = 4] = "SETTINGS_TIMEOUT";
138
- H2Code[H2Code["STREAM_CLOSED"] = 5] = "STREAM_CLOSED";
139
- H2Code[H2Code["FRAME_SIZE_ERROR"] = 6] = "FRAME_SIZE_ERROR";
140
- H2Code[H2Code["REFUSED_STREAM"] = 7] = "REFUSED_STREAM";
141
- H2Code[H2Code["CANCEL"] = 8] = "CANCEL";
142
- H2Code[H2Code["COMPRESSION_ERROR"] = 9] = "COMPRESSION_ERROR";
143
- H2Code[H2Code["CONNECT_ERROR"] = 10] = "CONNECT_ERROR";
144
- H2Code[H2Code["ENHANCE_YOUR_CALM"] = 11] = "ENHANCE_YOUR_CALM";
145
- H2Code[H2Code["INADEQUATE_SECURITY"] = 12] = "INADEQUATE_SECURITY";
146
- H2Code[H2Code["HTTP_1_1_REQUIRED"] = 13] = "HTTP_1_1_REQUIRED";
147
- })(H2Code || (H2Code = {}));
@@ -1,27 +0,0 @@
1
- // Copyright 2021-2024 The Connect Authors
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
- import { Headers as HeadersPolyfill } from "undici";
15
- // The global Headers class was introduced in Node v16.15.0, behind the
16
- // --experimental-fetch flag. It became available by default with Node
17
- // v18.0.0.
18
- // If this code runs in Node < 18, it installs an alternative
19
- // implementation if one has not already been polyfilled.
20
- const [major] = process.versions.node
21
- .split(".")
22
- .map((value) => parseInt(value, 10));
23
- if (major < 18) {
24
- if (typeof globalThis.Headers === "undefined") {
25
- globalThis.Headers = HeadersPolyfill;
26
- }
27
- }
@@ -1,89 +0,0 @@
1
- import type { CommonTransportOptions, UniversalClientFn } from "@connectrpc/connect/protocol";
2
- import type { NodeHttp2ClientSessionManager } from "./node-universal-client.js";
3
- import type { Http2SessionOptions } from "./http2-session-manager.js";
4
- import * as http2 from "http2";
5
- import * as http from "http";
6
- import * as https from "https";
7
- /**
8
- * Options specific to Node.js client transports.
9
- */
10
- export type NodeTransportOptions = {
11
- httpVersion: "1.1";
12
- /**
13
- * Options passed to the request() call of the Node.js built-in
14
- * http or https module.
15
- */
16
- nodeOptions?: Omit<http.RequestOptions, "signal"> | Omit<https.RequestOptions, "signal">;
17
- } | ({
18
- httpVersion: "2";
19
- /**
20
- * A manager for the HTTP/2 connection of the transport.
21
- *
22
- * Providing this option makes nodeOptions as well as the HTTP/2 session
23
- * options (pingIntervalMs et cetera) ineffective.
24
- */
25
- sessionManager?: NodeHttp2ClientSessionManager;
26
- /**
27
- * Options passed to the connect() call of the Node.js built-in
28
- * http2 module.
29
- */
30
- nodeOptions?: http2.ClientSessionOptions | http2.SecureClientSessionOptions;
31
- } & Http2SessionOptions);
32
- /**
33
- * Asserts that the options are within sane limits, and returns default values
34
- * where no value is provided.
35
- *
36
- * @private Internal code, does not follow semantic versioning.
37
- */
38
- export declare function validateNodeTransportOptions(options: NodeTransportOptions & Partial<Omit<CommonTransportOptions, "baseUrl">> & Pick<CommonTransportOptions, "baseUrl">): {
39
- readMaxBytes: number;
40
- writeMaxBytes: number;
41
- compressMinBytes: number;
42
- httpClient: UniversalClientFn;
43
- useBinaryFormat: boolean;
44
- interceptors: import("@connectrpc/connect").Interceptor[];
45
- sendCompression: import("@connectrpc/connect/protocol").Compression | null;
46
- acceptCompression: import("@connectrpc/connect/protocol").Compression[];
47
- httpVersion: "1.1";
48
- /**
49
- * Options passed to the request() call of the Node.js built-in
50
- * http or https module.
51
- */
52
- nodeOptions?: Omit<http.RequestOptions, "signal"> | Omit<https.RequestOptions, "signal">;
53
- jsonOptions?: Partial<import("@bufbuild/protobuf").JsonReadOptions & import("@bufbuild/protobuf").JsonWriteOptions> | undefined;
54
- binaryOptions?: Partial<import("@bufbuild/protobuf").BinaryReadOptions & import("@bufbuild/protobuf").BinaryWriteOptions> | undefined;
55
- useHttpGet?: boolean | undefined;
56
- defaultTimeoutMs?: number | undefined;
57
- baseUrl: string;
58
- } | {
59
- readMaxBytes: number;
60
- writeMaxBytes: number;
61
- compressMinBytes: number;
62
- httpClient: UniversalClientFn;
63
- useBinaryFormat: boolean;
64
- interceptors: import("@connectrpc/connect").Interceptor[];
65
- sendCompression: import("@connectrpc/connect/protocol").Compression | null;
66
- acceptCompression: import("@connectrpc/connect/protocol").Compression[];
67
- httpVersion: "2";
68
- /**
69
- * A manager for the HTTP/2 connection of the transport.
70
- *
71
- * Providing this option makes nodeOptions as well as the HTTP/2 session
72
- * options (pingIntervalMs et cetera) ineffective.
73
- */
74
- sessionManager?: NodeHttp2ClientSessionManager;
75
- /**
76
- * Options passed to the connect() call of the Node.js built-in
77
- * http2 module.
78
- */
79
- nodeOptions?: http2.ClientSessionOptions | http2.SecureClientSessionOptions;
80
- pingIntervalMs?: number;
81
- pingIdleConnection?: boolean;
82
- pingTimeoutMs?: number;
83
- idleConnectionTimeoutMs?: number;
84
- jsonOptions?: Partial<import("@bufbuild/protobuf").JsonReadOptions & import("@bufbuild/protobuf").JsonWriteOptions> | undefined;
85
- binaryOptions?: Partial<import("@bufbuild/protobuf").BinaryReadOptions & import("@bufbuild/protobuf").BinaryWriteOptions> | undefined;
86
- useHttpGet?: boolean | undefined;
87
- defaultTimeoutMs?: number | undefined;
88
- baseUrl: string;
89
- };
@@ -1,58 +0,0 @@
1
- // Copyright 2021-2024 The Connect Authors
2
- //
3
- // Licensed under the Apache License, Version 2.0 (the "License");
4
- // you may not use this file except in compliance with the License.
5
- // You may obtain a copy of the License at
6
- //
7
- // http://www.apache.org/licenses/LICENSE-2.0
8
- //
9
- // Unless required by applicable law or agreed to in writing, software
10
- // distributed under the License is distributed on an "AS IS" BASIS,
11
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
- // See the License for the specific language governing permissions and
13
- // limitations under the License.
14
- import { validateReadWriteMaxBytes } from "@connectrpc/connect/protocol";
15
- import { compressionBrotli, compressionGzip } from "./compression.js";
16
- import { createNodeHttpClient } from "./node-universal-client.js";
17
- import { Http2SessionManager } from "./http2-session-manager.js";
18
- import * as http2 from "http2";
19
- import * as http from "http";
20
- import * as https from "https";
21
- /**
22
- * Asserts that the options are within sane limits, and returns default values
23
- * where no value is provided.
24
- *
25
- * @private Internal code, does not follow semantic versioning.
26
- */
27
- export function validateNodeTransportOptions(options) {
28
- var _a, _b, _c, _d;
29
- let httpClient;
30
- if (options.httpVersion == "2") {
31
- let sessionManager;
32
- if (options.sessionManager) {
33
- sessionManager = options.sessionManager;
34
- }
35
- else {
36
- sessionManager = new Http2SessionManager(options.baseUrl, {
37
- pingIntervalMs: options.pingIntervalMs,
38
- pingIdleConnection: options.pingIdleConnection,
39
- pingTimeoutMs: options.pingTimeoutMs,
40
- idleConnectionTimeoutMs: options.idleConnectionTimeoutMs,
41
- }, options.nodeOptions);
42
- }
43
- httpClient = createNodeHttpClient({
44
- httpVersion: "2",
45
- sessionProvider: () => sessionManager,
46
- });
47
- }
48
- else {
49
- httpClient = createNodeHttpClient({
50
- httpVersion: "1.1",
51
- nodeOptions: options.nodeOptions,
52
- });
53
- }
54
- return Object.assign(Object.assign(Object.assign({}, options), { httpClient, useBinaryFormat: (_a = options.useBinaryFormat) !== null && _a !== void 0 ? _a : true, interceptors: (_b = options.interceptors) !== null && _b !== void 0 ? _b : [], sendCompression: (_c = options.sendCompression) !== null && _c !== void 0 ? _c : null, acceptCompression: (_d = options.acceptCompression) !== null && _d !== void 0 ? _d : [
55
- compressionGzip,
56
- compressionBrotli,
57
- ] }), validateReadWriteMaxBytes(options.readMaxBytes, options.writeMaxBytes, options.compressMinBytes));
58
- }
@@ -1,54 +0,0 @@
1
- import * as http2 from "http2";
2
- import * as http from "http";
3
- import * as https from "https";
4
- import type { UniversalClientFn } from "@connectrpc/connect/protocol";
5
- /**
6
- * Options for creating an UniversalClientFn using the Node.js `http`, `https`,
7
- * or `http2` module.
8
- */
9
- export type NodeHttpClientOptions = {
10
- /**
11
- * Use the Node.js `http` or `https` module.
12
- */
13
- httpVersion: "1.1";
14
- /**
15
- * Options passed to the request() call of the Node.js built-in
16
- * http or https module.
17
- */
18
- nodeOptions?: Omit<http.RequestOptions, "signal"> | Omit<https.RequestOptions, "signal">;
19
- } | {
20
- /**
21
- * Use the Node.js `http2` module.
22
- */
23
- httpVersion: "2";
24
- /**
25
- * A function that must return a session manager for the given URL.
26
- * The session manager may be taken from a pool.
27
- * By default, a new Http2SessionManager is created for every request.
28
- */
29
- sessionProvider?: (url: string) => NodeHttp2ClientSessionManager;
30
- };
31
- /**
32
- * Create a universal client function, a minimal abstraction of an HTTP client,
33
- * using the Node.js `http`, `https`, or `http2` module.
34
- *
35
- * @private Internal code, does not follow semantic versioning.
36
- */
37
- export declare function createNodeHttpClient(options: NodeHttpClientOptions): UniversalClientFn;
38
- /**
39
- * Manager for a HTTP/2 session.
40
- */
41
- export interface NodeHttp2ClientSessionManager {
42
- /**
43
- * The host this session manager connects to.
44
- */
45
- authority: string;
46
- /**
47
- * Issue a request.
48
- */
49
- request(method: string, path: string, headers: http2.OutgoingHttpHeaders, options: Omit<http2.ClientSessionRequestOptions, "signal">): Promise<http2.ClientHttp2Stream>;
50
- /**
51
- * Notify the manager of a successful read from a http2.ClientHttp2Stream.
52
- */
53
- notifyResponseByteRead(stream: http2.ClientHttp2Stream): void;
54
- }