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,96 +0,0 @@
1
- import type { Interceptor, Transport } from "@connectrpc/connect";
2
- import type { Compression } from "@connectrpc/connect/protocol";
3
- import type { BinaryReadOptions, BinaryWriteOptions, JsonReadOptions, JsonWriteOptions } from "@bufbuild/protobuf";
4
- import type { NodeTransportOptions } from "./node-transport-options.js";
5
- /**
6
- * Options used to configure the gRPC-web transport.
7
- *
8
- * See createGrpcTransport().
9
- */
10
- export type GrpcTransportOptions = NodeTransportOptions & {
11
- /**
12
- * Base URI for all HTTP requests.
13
- *
14
- * Requests will be made to <baseUrl>/<package>.<service>/method
15
- *
16
- * Example: `baseUrl: "https://example.com/my-api"`
17
- *
18
- * This will make a `POST /my-api/my_package.MyService/Foo` to
19
- * `example.com` via HTTPS.
20
- */
21
- baseUrl: string;
22
- /**
23
- * By default, clients use the binary format for gRPC-web, because
24
- * not all gRPC-web implementations support JSON.
25
- */
26
- useBinaryFormat?: boolean;
27
- /**
28
- * Interceptors that should be applied to all calls running through
29
- * this transport. See the Interceptor type for details.
30
- */
31
- interceptors?: Interceptor[];
32
- /**
33
- * Options for the JSON format.
34
- * By default, unknown fields are ignored.
35
- */
36
- jsonOptions?: Partial<JsonReadOptions & JsonWriteOptions>;
37
- /**
38
- * Options for the binary wire format.
39
- */
40
- binaryOptions?: Partial<BinaryReadOptions & BinaryWriteOptions>;
41
- /**
42
- * Compression algorithms available to a client. Clients ask servers to
43
- * compress responses using any of the registered algorithms. The first
44
- * registered algorithm is the most preferred.
45
- *
46
- * It is safe to use this option liberally: servers will ignore any
47
- * compression algorithms they don't support. To compress requests, pair this
48
- * option with `sendCompression`.
49
- *
50
- * If this option is not provided, the compression algorithms "gzip" and "br"
51
- * (Brotli) are accepted. To opt out of response compression, pass an
52
- * empty array.
53
- */
54
- acceptCompression?: Compression[];
55
- /**
56
- * Configures the client to use the specified algorithm to compress request
57
- * messages.
58
- *
59
- * Because some servers don't support compression, clients default to sending
60
- * uncompressed requests.
61
- */
62
- sendCompression?: Compression;
63
- /**
64
- * Sets a minimum size threshold for compression: Messages that are smaller
65
- * than the configured minimum are sent uncompressed.
66
- *
67
- * The default value is 1 kibibyte, because the CPU cost of compressing very
68
- * small messages usually isn't worth the small reduction in network I/O.
69
- */
70
- compressMinBytes?: number;
71
- /**
72
- * Limits the performance impact of pathologically large messages sent by the
73
- * server. Limits apply to each individual message, not to the stream as a
74
- * whole.
75
- *
76
- * The default limit is the maximum supported value of ~4GiB.
77
- */
78
- readMaxBytes?: number;
79
- /**
80
- * Prevents sending messages too large for the server to handle.
81
- *
82
- * The default limit is the maximum supported value of ~4GiB.
83
- */
84
- writeMaxBytes?: number;
85
- /**
86
- * The timeout in milliseconds to apply to all requests.
87
- *
88
- * This can be overridden on a per-request basis by passing a timeoutMs.
89
- */
90
- defaultTimeoutMs?: number;
91
- };
92
- /**
93
- * Create a Transport for the gRPC protocol using the Node.js `http`, `http2`,
94
- * or `http2` module.
95
- */
96
- export declare function createGrpcTransport(options: GrpcTransportOptions): Transport;
@@ -1,25 +0,0 @@
1
- "use strict";
2
- // Copyright 2021-2024 The Connect Authors
3
- //
4
- // Licensed under the Apache License, Version 2.0 (the "License");
5
- // you may not use this file except in compliance with the License.
6
- // You may obtain a copy of the License at
7
- //
8
- // http://www.apache.org/licenses/LICENSE-2.0
9
- //
10
- // Unless required by applicable law or agreed to in writing, software
11
- // distributed under the License is distributed on an "AS IS" BASIS,
12
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- // See the License for the specific language governing permissions and
14
- // limitations under the License.
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.createGrpcTransport = createGrpcTransport;
17
- const protocol_grpc_1 = require("@connectrpc/connect/protocol-grpc");
18
- const node_transport_options_js_1 = require("./node-transport-options.js");
19
- /**
20
- * Create a Transport for the gRPC protocol using the Node.js `http`, `http2`,
21
- * or `http2` module.
22
- */
23
- function createGrpcTransport(options) {
24
- return (0, protocol_grpc_1.createTransport)((0, node_transport_options_js_1.validateNodeTransportOptions)(options));
25
- }
@@ -1,96 +0,0 @@
1
- import type { Interceptor, Transport } from "@connectrpc/connect";
2
- import type { Compression } from "@connectrpc/connect/protocol";
3
- import type { BinaryReadOptions, BinaryWriteOptions, JsonReadOptions, JsonWriteOptions } from "@bufbuild/protobuf";
4
- import type { NodeTransportOptions } from "./node-transport-options.js";
5
- /**
6
- * Options used to configure the gRPC-web transport.
7
- *
8
- * See createGrpcWebTransport().
9
- */
10
- export type GrpcWebTransportOptions = NodeTransportOptions & {
11
- /**
12
- * Base URI for all HTTP requests.
13
- *
14
- * Requests will be made to <baseUrl>/<package>.<service>/method
15
- *
16
- * Example: `baseUrl: "https://example.com/my-api"`
17
- *
18
- * This will make a `POST /my-api/my_package.MyService/Foo` to
19
- * `example.com` via HTTPS.
20
- */
21
- baseUrl: string;
22
- /**
23
- * By default, clients use the binary format for gRPC-web, because
24
- * not all gRPC-web implementations support JSON.
25
- */
26
- useBinaryFormat?: boolean;
27
- /**
28
- * Interceptors that should be applied to all calls running through
29
- * this transport. See the Interceptor type for details.
30
- */
31
- interceptors?: Interceptor[];
32
- /**
33
- * Options for the JSON format.
34
- * By default, unknown fields are ignored.
35
- */
36
- jsonOptions?: Partial<JsonReadOptions & JsonWriteOptions>;
37
- /**
38
- * Options for the binary wire format.
39
- */
40
- binaryOptions?: Partial<BinaryReadOptions & BinaryWriteOptions>;
41
- /**
42
- * Compression algorithms available to a client. Clients ask servers to
43
- * compress responses using any of the registered algorithms. The first
44
- * registered algorithm is the most preferred.
45
- *
46
- * It is safe to use this option liberally: servers will ignore any
47
- * compression algorithms they don't support. To compress requests, pair this
48
- * option with `sendCompression`.
49
- *
50
- * If this option is not provided, the compression algorithms "gzip" and "br"
51
- * (Brotli) are accepted. To opt out of response compression, pass an
52
- * empty array.
53
- */
54
- acceptCompression?: Compression[];
55
- /**
56
- * Configures the client to use the specified algorithm to compress request
57
- * messages.
58
- *
59
- * Because some servers don't support compression, clients default to sending
60
- * uncompressed requests.
61
- */
62
- sendCompression?: Compression;
63
- /**
64
- * Sets a minimum size threshold for compression: Messages that are smaller
65
- * than the configured minimum are sent uncompressed.
66
- *
67
- * The default value is 1 kibibyte, because the CPU cost of compressing very
68
- * small messages usually isn't worth the small reduction in network I/O.
69
- */
70
- compressMinBytes?: number;
71
- /**
72
- * Limits the performance impact of pathologically large messages sent by the
73
- * server. Limits apply to each individual message, not to the stream as a
74
- * whole.
75
- *
76
- * The default limit is the maximum supported value of ~4GiB.
77
- */
78
- readMaxBytes?: number;
79
- /**
80
- * Prevents sending messages too large for the server to handle.
81
- *
82
- * The default limit is the maximum supported value of ~4GiB.
83
- */
84
- writeMaxBytes?: number;
85
- /**
86
- * The timeout in milliseconds to apply to all requests.
87
- *
88
- * This can be overridden on a per-request basis by passing a timeoutMs.
89
- */
90
- defaultTimeoutMs?: number;
91
- };
92
- /**
93
- * Create a Transport for the gRPC-web protocol using the Node.js `http`,
94
- * `http2`, or `http2` module.
95
- */
96
- export declare function createGrpcWebTransport(options: GrpcWebTransportOptions): Transport;
@@ -1,25 +0,0 @@
1
- "use strict";
2
- // Copyright 2021-2024 The Connect Authors
3
- //
4
- // Licensed under the Apache License, Version 2.0 (the "License");
5
- // you may not use this file except in compliance with the License.
6
- // You may obtain a copy of the License at
7
- //
8
- // http://www.apache.org/licenses/LICENSE-2.0
9
- //
10
- // Unless required by applicable law or agreed to in writing, software
11
- // distributed under the License is distributed on an "AS IS" BASIS,
12
- // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- // See the License for the specific language governing permissions and
14
- // limitations under the License.
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.createGrpcWebTransport = createGrpcWebTransport;
17
- const protocol_grpc_web_1 = require("@connectrpc/connect/protocol-grpc-web");
18
- const node_transport_options_js_1 = require("./node-transport-options.js");
19
- /**
20
- * Create a Transport for the gRPC-web protocol using the Node.js `http`,
21
- * `http2`, or `http2` module.
22
- */
23
- function createGrpcWebTransport(options) {
24
- return (0, protocol_grpc_web_1.createTransport)((0, node_transport_options_js_1.validateNodeTransportOptions)(options));
25
- }
@@ -1,146 +0,0 @@
1
- import * as http2 from "http2";
2
- export interface Http2SessionOptions {
3
- /**
4
- * The interval to send PING frames to keep a connection alive. The interval
5
- * is reset whenever a stream receives data. If a PING frame is not responded
6
- * to within pingTimeoutMs, the connection and all open streams close.
7
- *
8
- * By default, no PING frames are sent. If a value is provided, PING frames
9
- * are sent only for connections that have open streams, unless
10
- * pingIdleConnections is enabled.
11
- *
12
- * Sensible values can be between 10 seconds and 2 hours, depending on your
13
- * infrastructure.
14
- *
15
- * This option is equivalent to GRPC_ARG_KEEPALIVE_TIME_MS in gRPC Core.
16
- */
17
- pingIntervalMs?: number;
18
- /**
19
- * Enable PING frames for connections that are have no open streams.
20
- * This option is only effective if a value for pingIntervalMs is provided.
21
- *
22
- * Note that it may not be necessary to enable this option. If a request is
23
- * made on a connection that has not been used for longer than pingIntervalMs,
24
- * a PING frame is sent to verify that the connection is still alive, and a
25
- * new connection is opened transparently if necessary.
26
- *
27
- * Defaults to false.
28
- *
29
- * This option is equivalent to GRPC_ARG_KEEPALIVE_PERMIT_WITHOUT_CALLS in
30
- * gRPC Core.
31
- */
32
- pingIdleConnection?: boolean;
33
- /**
34
- * Timeout for PING frames. If a PING is not answered within this time, the
35
- * connection is considered dead.
36
- *
37
- * Defaults to 15 seconds. This option is only used if a value for
38
- * pingIntervalMs is provided.
39
- *
40
- * This option is equivalent to GRPC_ARG_KEEPALIVE_TIMEOUT_MS in gRPC Core.
41
- */
42
- pingTimeoutMs?: number;
43
- /**
44
- * Automatically close a connection if the time since the last request stream
45
- * exceeds this value.
46
- *
47
- * Defaults to 15 minutes.
48
- *
49
- * This option is equivalent to GRPC_ARG_CLIENT_IDLE_TIMEOUT_MS of gRPC core.
50
- */
51
- idleConnectionTimeoutMs?: number;
52
- }
53
- /**
54
- * Manage an HTTP/2 connection and keep it alive with PING frames.
55
- *
56
- * The logic is based on "Basic Keepalive" described in
57
- * https://github.com/grpc/proposal/blob/0ba0c1905050525f9b0aee46f3f23c8e1e515489/A8-client-side-keepalive.md#basic-keepalive
58
- * as well as the client channel arguments described in
59
- * https://github.com/grpc/grpc/blob/8e137e524a1b1da7bbf4603662876d5719563b57/doc/keepalive.md
60
- *
61
- * Usually, the managers tracks exactly one connection, but if a connection
62
- * receives a GOAWAY frame with NO_ERROR, the connection is maintained until
63
- * all streams have finished, and new requests will open a new connection.
64
- */
65
- export declare class Http2SessionManager {
66
- /**
67
- * The host this session manager connect to.
68
- */
69
- authority: string;
70
- /**
71
- * The current state of the connection:
72
- *
73
- * - "closed"
74
- * The connection is closed, or no connection has been opened yet.
75
- * - connecting
76
- * Currently establishing a connection.
77
- *
78
- * - "open"
79
- * A connection is open and has open streams. PING frames are sent every
80
- * pingIntervalMs, unless a stream received data.
81
- * If a PING frame is not responded to within pingTimeoutMs, the connection
82
- * and all open streams close.
83
- *
84
- * - "idle"
85
- * A connection is open, but it does not have any open streams.
86
- * If pingIdleConnection is enabled, PING frames are used to keep the
87
- * connection alive, similar to an "open" connection.
88
- * If a connection is idle for longer than idleConnectionTimeoutMs, it closes.
89
- * If a request is made on an idle connection that has not been used for
90
- * longer than pingIntervalMs, the connection is verified.
91
- *
92
- * - "verifying"
93
- * Verifying a connection after a long period of inactivity before issuing a
94
- * request. A PING frame is sent, and if it times out within pingTimeoutMs, a
95
- * new connection is opened.
96
- *
97
- * - "error"
98
- * The connection is closed because of a transient error. A connection
99
- * may have failed to reach the host, or the connection may have died,
100
- * or it may have been aborted.
101
- */
102
- state(): "closed" | "connecting" | "open" | "idle" | "verifying" | "error";
103
- /**
104
- * Returns the error object if the connection is in the "error" state,
105
- * `undefined` otherwise.
106
- */
107
- error(): unknown;
108
- private s;
109
- private shuttingDown;
110
- private readonly http2SessionOptions;
111
- private readonly options;
112
- private verifying;
113
- constructor(url: URL | string, pingOptions?: Http2SessionOptions, http2SessionOptions?: http2.ClientSessionOptions | http2.SecureClientSessionOptions);
114
- /**
115
- * Open a connection if none exists, verify an existing connection if
116
- * necessary.
117
- */
118
- connect(): Promise<"open" | "idle" | "error">;
119
- /**
120
- * Issue a request.
121
- *
122
- * This method automatically opens a connection if none exists, and verifies
123
- * an existing connection if necessary. It calls http2.ClientHttp2Session.request(),
124
- * and keeps track of all open http2.ClientHttp2Stream.
125
- *
126
- * Clients must call notifyResponseByteRead() whenever they successfully read
127
- * data from the http2.ClientHttp2Stream.
128
- */
129
- request(method: string, path: string, headers: http2.OutgoingHttpHeaders, options: Omit<http2.ClientSessionRequestOptions, "signal">): Promise<http2.ClientHttp2Stream>;
130
- /**
131
- * Notify the manager of a successful read from a http2.ClientHttp2Stream.
132
- *
133
- * Clients must call this function whenever they successfully read data from
134
- * a http2.ClientHttp2Stream obtained from request(). This informs the
135
- * keep-alive logic that the connection is alive, and prevents it from sending
136
- * unnecessary PING frames.
137
- */
138
- notifyResponseByteRead(stream: http2.ClientHttp2Stream): void;
139
- /**
140
- * If there is an open connection, close it. This also closes any open streams.
141
- */
142
- abort(reason?: Error): void;
143
- private gotoReady;
144
- private setState;
145
- private verify;
146
- }