pi-cursor-sdk 0.1.47 → 0.1.49
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.
- package/CHANGELOG.md +17 -0
- package/README.md +2 -2
- package/node_modules/@connectrpc/connect-node/README.md +141 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +15 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +89 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +42 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +61 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +100 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +25 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +96 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +25 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +96 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +25 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +146 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +536 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +15 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +36 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +45 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +154 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +1 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +29 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +89 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +58 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +54 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +326 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +41 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +234 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +19 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +97 -0
- package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +1 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +15 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +86 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +42 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +58 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +100 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +22 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +96 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +22 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +96 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +22 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +146 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +532 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +15 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/index.js +23 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +45 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +147 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +1 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +27 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +89 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +58 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +54 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +324 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +41 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +230 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +19 -0
- package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +93 -0
- package/node_modules/@connectrpc/connect-node/package.json +46 -0
- package/node_modules/undici/LICENSE +21 -0
- package/node_modules/undici/README.md +741 -0
- package/node_modules/undici/docs/docs/api/Agent.md +84 -0
- package/node_modules/undici/docs/docs/api/BalancedPool.md +99 -0
- package/node_modules/undici/docs/docs/api/CacheStorage.md +30 -0
- package/node_modules/undici/docs/docs/api/CacheStore.md +164 -0
- package/node_modules/undici/docs/docs/api/Client.md +288 -0
- package/node_modules/undici/docs/docs/api/ClientStats.md +27 -0
- package/node_modules/undici/docs/docs/api/Connector.md +115 -0
- package/node_modules/undici/docs/docs/api/ContentType.md +57 -0
- package/node_modules/undici/docs/docs/api/Cookies.md +128 -0
- package/node_modules/undici/docs/docs/api/Debug.md +62 -0
- package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +315 -0
- package/node_modules/undici/docs/docs/api/Dispatcher.md +1392 -0
- package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +159 -0
- package/node_modules/undici/docs/docs/api/Errors.md +49 -0
- package/node_modules/undici/docs/docs/api/EventSource.md +45 -0
- package/node_modules/undici/docs/docs/api/Fetch.md +60 -0
- package/node_modules/undici/docs/docs/api/GlobalInstallation.md +139 -0
- package/node_modules/undici/docs/docs/api/H2CClient.md +263 -0
- package/node_modules/undici/docs/docs/api/MockAgent.md +603 -0
- package/node_modules/undici/docs/docs/api/MockCallHistory.md +197 -0
- package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +43 -0
- package/node_modules/undici/docs/docs/api/MockClient.md +81 -0
- package/node_modules/undici/docs/docs/api/MockErrors.md +12 -0
- package/node_modules/undici/docs/docs/api/MockPool.md +555 -0
- package/node_modules/undici/docs/docs/api/Pool.md +84 -0
- package/node_modules/undici/docs/docs/api/PoolStats.md +35 -0
- package/node_modules/undici/docs/docs/api/ProxyAgent.md +229 -0
- package/node_modules/undici/docs/docs/api/RedirectHandler.md +93 -0
- package/node_modules/undici/docs/docs/api/RetryAgent.md +50 -0
- package/node_modules/undici/docs/docs/api/RetryHandler.md +118 -0
- package/node_modules/undici/docs/docs/api/RoundRobinPool.md +145 -0
- package/node_modules/undici/docs/docs/api/SnapshotAgent.md +616 -0
- package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +275 -0
- package/node_modules/undici/docs/docs/api/Util.md +25 -0
- package/node_modules/undici/docs/docs/api/WebSocket.md +141 -0
- package/node_modules/undici/docs/docs/api/api-lifecycle.md +91 -0
- package/node_modules/undici/docs/docs/best-practices/client-certificate.md +64 -0
- package/node_modules/undici/docs/docs/best-practices/crawling.md +58 -0
- package/node_modules/undici/docs/docs/best-practices/mocking-request.md +190 -0
- package/node_modules/undici/docs/docs/best-practices/proxy.md +127 -0
- package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +224 -0
- package/node_modules/undici/docs/docs/best-practices/writing-tests.md +63 -0
- package/node_modules/undici/index-fetch.js +65 -0
- package/node_modules/undici/index.d.ts +3 -0
- package/node_modules/undici/index.js +234 -0
- package/node_modules/undici/lib/api/abort-signal.js +59 -0
- package/node_modules/undici/lib/api/api-connect.js +110 -0
- package/node_modules/undici/lib/api/api-pipeline.js +252 -0
- package/node_modules/undici/lib/api/api-request.js +214 -0
- package/node_modules/undici/lib/api/api-stream.js +209 -0
- package/node_modules/undici/lib/api/api-upgrade.js +111 -0
- package/node_modules/undici/lib/api/index.js +7 -0
- package/node_modules/undici/lib/api/readable.js +580 -0
- package/node_modules/undici/lib/cache/memory-cache-store.js +234 -0
- package/node_modules/undici/lib/cache/sqlite-cache-store.js +461 -0
- package/node_modules/undici/lib/core/connect.js +153 -0
- package/node_modules/undici/lib/core/constants.js +143 -0
- package/node_modules/undici/lib/core/diagnostics.js +227 -0
- package/node_modules/undici/lib/core/errors.js +477 -0
- package/node_modules/undici/lib/core/request.js +453 -0
- package/node_modules/undici/lib/core/socks5-client.js +422 -0
- package/node_modules/undici/lib/core/socks5-utils.js +212 -0
- package/node_modules/undici/lib/core/symbols.js +75 -0
- package/node_modules/undici/lib/core/tree.js +160 -0
- package/node_modules/undici/lib/core/util.js +992 -0
- package/node_modules/undici/lib/dispatcher/agent.js +158 -0
- package/node_modules/undici/lib/dispatcher/balanced-pool.js +219 -0
- package/node_modules/undici/lib/dispatcher/client-h1.js +1722 -0
- package/node_modules/undici/lib/dispatcher/client-h2.js +995 -0
- package/node_modules/undici/lib/dispatcher/client.js +664 -0
- package/node_modules/undici/lib/dispatcher/dispatcher-base.js +184 -0
- package/node_modules/undici/lib/dispatcher/dispatcher.js +48 -0
- package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +146 -0
- package/node_modules/undici/lib/dispatcher/fixed-queue.js +135 -0
- package/node_modules/undici/lib/dispatcher/h2c-client.js +51 -0
- package/node_modules/undici/lib/dispatcher/pool-base.js +214 -0
- package/node_modules/undici/lib/dispatcher/pool.js +118 -0
- package/node_modules/undici/lib/dispatcher/proxy-agent.js +319 -0
- package/node_modules/undici/lib/dispatcher/retry-agent.js +35 -0
- package/node_modules/undici/lib/dispatcher/round-robin-pool.js +137 -0
- package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +260 -0
- package/node_modules/undici/lib/encoding/index.js +33 -0
- package/node_modules/undici/lib/global.js +59 -0
- package/node_modules/undici/lib/handler/cache-handler.js +578 -0
- package/node_modules/undici/lib/handler/cache-revalidation-handler.js +124 -0
- package/node_modules/undici/lib/handler/decorator-handler.js +67 -0
- package/node_modules/undici/lib/handler/deduplication-handler.js +460 -0
- package/node_modules/undici/lib/handler/redirect-handler.js +238 -0
- package/node_modules/undici/lib/handler/retry-handler.js +394 -0
- package/node_modules/undici/lib/handler/unwrap-handler.js +106 -0
- package/node_modules/undici/lib/handler/wrap-handler.js +105 -0
- package/node_modules/undici/lib/interceptor/cache.js +495 -0
- package/node_modules/undici/lib/interceptor/decompress.js +259 -0
- package/node_modules/undici/lib/interceptor/deduplicate.js +117 -0
- package/node_modules/undici/lib/interceptor/dns.js +571 -0
- package/node_modules/undici/lib/interceptor/dump.js +112 -0
- package/node_modules/undici/lib/interceptor/redirect.js +21 -0
- package/node_modules/undici/lib/interceptor/response-error.js +95 -0
- package/node_modules/undici/lib/interceptor/retry.js +19 -0
- package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
- package/node_modules/undici/lib/llhttp/constants.d.ts +195 -0
- package/node_modules/undici/lib/llhttp/constants.js +531 -0
- package/node_modules/undici/lib/llhttp/llhttp-wasm.js +15 -0
- package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +15 -0
- package/node_modules/undici/lib/llhttp/utils.d.ts +2 -0
- package/node_modules/undici/lib/llhttp/utils.js +12 -0
- package/node_modules/undici/lib/mock/mock-agent.js +232 -0
- package/node_modules/undici/lib/mock/mock-call-history.js +248 -0
- package/node_modules/undici/lib/mock/mock-client.js +68 -0
- package/node_modules/undici/lib/mock/mock-errors.js +29 -0
- package/node_modules/undici/lib/mock/mock-interceptor.js +209 -0
- package/node_modules/undici/lib/mock/mock-pool.js +68 -0
- package/node_modules/undici/lib/mock/mock-symbols.js +32 -0
- package/node_modules/undici/lib/mock/mock-utils.js +486 -0
- package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +43 -0
- package/node_modules/undici/lib/mock/snapshot-agent.js +353 -0
- package/node_modules/undici/lib/mock/snapshot-recorder.js +588 -0
- package/node_modules/undici/lib/mock/snapshot-utils.js +158 -0
- package/node_modules/undici/lib/util/cache.js +414 -0
- package/node_modules/undici/lib/util/date.js +653 -0
- package/node_modules/undici/lib/util/promise.js +28 -0
- package/node_modules/undici/lib/util/runtime-features.js +124 -0
- package/node_modules/undici/lib/util/stats.js +32 -0
- package/node_modules/undici/lib/util/timers.js +425 -0
- package/node_modules/undici/lib/web/cache/cache.js +864 -0
- package/node_modules/undici/lib/web/cache/cachestorage.js +152 -0
- package/node_modules/undici/lib/web/cache/util.js +45 -0
- package/node_modules/undici/lib/web/cookies/constants.js +12 -0
- package/node_modules/undici/lib/web/cookies/index.js +199 -0
- package/node_modules/undici/lib/web/cookies/parse.js +314 -0
- package/node_modules/undici/lib/web/cookies/util.js +282 -0
- package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +399 -0
- package/node_modules/undici/lib/web/eventsource/eventsource.js +501 -0
- package/node_modules/undici/lib/web/eventsource/util.js +29 -0
- package/node_modules/undici/lib/web/fetch/LICENSE +21 -0
- package/node_modules/undici/lib/web/fetch/body.js +509 -0
- package/node_modules/undici/lib/web/fetch/constants.js +131 -0
- package/node_modules/undici/lib/web/fetch/data-url.js +596 -0
- package/node_modules/undici/lib/web/fetch/formdata-parser.js +586 -0
- package/node_modules/undici/lib/web/fetch/formdata.js +259 -0
- package/node_modules/undici/lib/web/fetch/global.js +40 -0
- package/node_modules/undici/lib/web/fetch/headers.js +719 -0
- package/node_modules/undici/lib/web/fetch/index.js +2413 -0
- package/node_modules/undici/lib/web/fetch/request.js +1115 -0
- package/node_modules/undici/lib/web/fetch/response.js +641 -0
- package/node_modules/undici/lib/web/fetch/util.js +1522 -0
- package/node_modules/undici/lib/web/infra/index.js +229 -0
- package/node_modules/undici/lib/web/subresource-integrity/Readme.md +9 -0
- package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +307 -0
- package/node_modules/undici/lib/web/webidl/index.js +1006 -0
- package/node_modules/undici/lib/web/websocket/connection.js +329 -0
- package/node_modules/undici/lib/web/websocket/constants.js +126 -0
- package/node_modules/undici/lib/web/websocket/events.js +331 -0
- package/node_modules/undici/lib/web/websocket/frame.js +133 -0
- package/node_modules/undici/lib/web/websocket/permessage-deflate.js +100 -0
- package/node_modules/undici/lib/web/websocket/receiver.js +507 -0
- package/node_modules/undici/lib/web/websocket/sender.js +109 -0
- package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +104 -0
- package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +498 -0
- package/node_modules/undici/lib/web/websocket/util.js +347 -0
- package/node_modules/undici/lib/web/websocket/websocket.js +758 -0
- package/node_modules/undici/package.json +152 -0
- package/node_modules/undici/scripts/strip-comments.js +10 -0
- package/node_modules/undici/types/README.md +6 -0
- package/node_modules/undici/types/agent.d.ts +32 -0
- package/node_modules/undici/types/api.d.ts +43 -0
- package/node_modules/undici/types/balanced-pool.d.ts +30 -0
- package/node_modules/undici/types/cache-interceptor.d.ts +179 -0
- package/node_modules/undici/types/cache.d.ts +36 -0
- package/node_modules/undici/types/client-stats.d.ts +15 -0
- package/node_modules/undici/types/client.d.ts +139 -0
- package/node_modules/undici/types/connector.d.ts +36 -0
- package/node_modules/undici/types/content-type.d.ts +21 -0
- package/node_modules/undici/types/cookies.d.ts +30 -0
- package/node_modules/undici/types/diagnostics-channel.d.ts +74 -0
- package/node_modules/undici/types/dispatcher.d.ts +275 -0
- package/node_modules/undici/types/env-http-proxy-agent.d.ts +22 -0
- package/node_modules/undici/types/errors.d.ts +177 -0
- package/node_modules/undici/types/eventsource.d.ts +66 -0
- package/node_modules/undici/types/fetch.d.ts +231 -0
- package/node_modules/undici/types/formdata.d.ts +114 -0
- package/node_modules/undici/types/global-dispatcher.d.ts +9 -0
- package/node_modules/undici/types/global-origin.d.ts +7 -0
- package/node_modules/undici/types/h2c-client.d.ts +73 -0
- package/node_modules/undici/types/handlers.d.ts +14 -0
- package/node_modules/undici/types/header.d.ts +160 -0
- package/node_modules/undici/types/index.d.ts +91 -0
- package/node_modules/undici/types/interceptors.d.ts +80 -0
- package/node_modules/undici/types/mock-agent.d.ts +68 -0
- package/node_modules/undici/types/mock-call-history.d.ts +111 -0
- package/node_modules/undici/types/mock-client.d.ts +27 -0
- package/node_modules/undici/types/mock-errors.d.ts +12 -0
- package/node_modules/undici/types/mock-interceptor.d.ts +94 -0
- package/node_modules/undici/types/mock-pool.d.ts +27 -0
- package/node_modules/undici/types/patch.d.ts +29 -0
- package/node_modules/undici/types/pool-stats.d.ts +19 -0
- package/node_modules/undici/types/pool.d.ts +41 -0
- package/node_modules/undici/types/proxy-agent.d.ts +29 -0
- package/node_modules/undici/types/readable.d.ts +68 -0
- package/node_modules/undici/types/retry-agent.d.ts +8 -0
- package/node_modules/undici/types/retry-handler.d.ts +125 -0
- package/node_modules/undici/types/round-robin-pool.d.ts +41 -0
- package/node_modules/undici/types/snapshot-agent.d.ts +109 -0
- package/node_modules/undici/types/socks5-proxy-agent.d.ts +25 -0
- package/node_modules/undici/types/util.d.ts +18 -0
- package/node_modules/undici/types/utility.d.ts +7 -0
- package/node_modules/undici/types/webidl.d.ts +347 -0
- package/node_modules/undici/types/websocket.d.ts +188 -0
- package/package.json +161 -156
- package/src/context.ts +1 -1
- package/src/cursor-context-tools.ts +1 -1
- package/src/cursor-live-run-accounting.ts +1 -1
- package/src/cursor-live-run-coordinator.ts +1 -1
- package/src/cursor-native-replay-routing.ts +1 -1
- package/src/cursor-partial-content-emitter.ts +1 -1
- package/src/cursor-pi-tool-bridge-mcp.ts +1 -1
- package/src/cursor-pi-tool-bridge-run.ts +1 -1
- package/src/cursor-pi-tool-bridge-types.ts +1 -1
- package/src/cursor-provider-lazy.ts +1 -1
- package/src/cursor-provider-live-run-drain.ts +1 -1
- package/src/cursor-provider-run-finalizer.ts +1 -1
- package/src/cursor-provider-turn-coordinator.ts +1 -1
- package/src/cursor-provider-turn-lifecycle-emitter.ts +1 -1
- package/src/cursor-provider-turn-prepare.ts +1 -1
- package/src/cursor-provider-turn-types.ts +1 -1
- package/src/cursor-provider.ts +1 -1
- package/src/cursor-run-final-text.ts +1 -1
- package/src/cursor-sdk-event-debug.ts +1 -1
- package/src/cursor-session-agent.ts +1 -1
- package/src/cursor-session-send-policy.ts +1 -1
- package/src/cursor-usage-accounting.ts +1 -1
- package/src/model-discovery.ts +1 -1
|
@@ -0,0 +1,97 @@
|
|
|
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.nodeHeaderToWebHeader = nodeHeaderToWebHeader;
|
|
17
|
+
exports.webHeaderToNodeHeaders = webHeaderToNodeHeaders;
|
|
18
|
+
/**
|
|
19
|
+
* Convert a Node.js header object to a fetch API Headers object.
|
|
20
|
+
*
|
|
21
|
+
* This function works for Node.js incoming and outgoing headers, and for the
|
|
22
|
+
* http and the http2 package.
|
|
23
|
+
*
|
|
24
|
+
* HTTP/2 pseudo-headers (:method, :path, etc.) are stripped.
|
|
25
|
+
*/
|
|
26
|
+
function nodeHeaderToWebHeader(nodeHeaders) {
|
|
27
|
+
const header = new Headers();
|
|
28
|
+
for (const [k, v] of Object.entries(nodeHeaders)) {
|
|
29
|
+
if (k.startsWith(":")) {
|
|
30
|
+
continue;
|
|
31
|
+
}
|
|
32
|
+
if (v === undefined) {
|
|
33
|
+
continue;
|
|
34
|
+
}
|
|
35
|
+
if (typeof v == "string") {
|
|
36
|
+
header.append(k, v);
|
|
37
|
+
}
|
|
38
|
+
else if (typeof v == "number") {
|
|
39
|
+
header.append(k, String(v));
|
|
40
|
+
}
|
|
41
|
+
else {
|
|
42
|
+
for (const e of v) {
|
|
43
|
+
header.append(k, e);
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
return header;
|
|
48
|
+
}
|
|
49
|
+
function webHeaderToNodeHeaders(headersInit, defaultNodeHeaders) {
|
|
50
|
+
if (headersInit === undefined && defaultNodeHeaders === undefined) {
|
|
51
|
+
return undefined;
|
|
52
|
+
}
|
|
53
|
+
const o = Object.create(null);
|
|
54
|
+
if (defaultNodeHeaders !== undefined) {
|
|
55
|
+
for (const [key, value] of Object.entries(defaultNodeHeaders)) {
|
|
56
|
+
if (Array.isArray(value)) {
|
|
57
|
+
o[key] = value.concat();
|
|
58
|
+
}
|
|
59
|
+
else if (value !== undefined) {
|
|
60
|
+
o[key] = value;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
if (headersInit !== undefined) {
|
|
65
|
+
if (Array.isArray(headersInit)) {
|
|
66
|
+
for (const [key, value] of headersInit) {
|
|
67
|
+
appendWebHeader(o, key, value);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
else if ("forEach" in headersInit) {
|
|
71
|
+
if (typeof headersInit.forEach == "function") {
|
|
72
|
+
headersInit.forEach((value, key) => {
|
|
73
|
+
appendWebHeader(o, key, value);
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
else {
|
|
78
|
+
for (const [key, value] of Object.entries(headersInit)) {
|
|
79
|
+
appendWebHeader(o, key, value);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return o;
|
|
84
|
+
}
|
|
85
|
+
function appendWebHeader(o, key, value) {
|
|
86
|
+
key = key.toLowerCase();
|
|
87
|
+
const existing = o[key];
|
|
88
|
+
if (Array.isArray(existing)) {
|
|
89
|
+
existing.push(value);
|
|
90
|
+
}
|
|
91
|
+
else if (existing === undefined) {
|
|
92
|
+
o[key] = value;
|
|
93
|
+
}
|
|
94
|
+
else {
|
|
95
|
+
o[key] = [existing.toString(), value];
|
|
96
|
+
}
|
|
97
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"type":"commonjs"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { Compression } from "@connectrpc/connect/protocol";
|
|
2
|
+
/**
|
|
3
|
+
* The gzip compression algorithm, implemented with the Node.js built-in module
|
|
4
|
+
* zlib. This value can be used for the `sendCompression` and `acceptCompression`
|
|
5
|
+
* option of client transports, or for the `acceptCompression` option of server
|
|
6
|
+
* plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
|
|
7
|
+
*/
|
|
8
|
+
export declare const compressionGzip: Compression;
|
|
9
|
+
/**
|
|
10
|
+
* The brotli compression algorithm, implemented with the Node.js built-in module
|
|
11
|
+
* zlib. This value can be used for the `sendCompression` and `acceptCompression`
|
|
12
|
+
* option of client transports, or for the `acceptCompression` option of server
|
|
13
|
+
* plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
|
|
14
|
+
*/
|
|
15
|
+
export declare const compressionBrotli: Compression;
|
|
@@ -0,0 +1,86 @@
|
|
|
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 * as zlib from "zlib";
|
|
15
|
+
import { promisify } from "util";
|
|
16
|
+
import { Code, ConnectError } from "@connectrpc/connect";
|
|
17
|
+
import { getNodeErrorProps } from "./node-error.js";
|
|
18
|
+
const gzip = promisify(zlib.gzip);
|
|
19
|
+
const gunzip = promisify(zlib.gunzip);
|
|
20
|
+
const brotliCompress = promisify(zlib.brotliCompress);
|
|
21
|
+
const brotliDecompress = promisify(zlib.brotliDecompress);
|
|
22
|
+
/**
|
|
23
|
+
* The gzip compression algorithm, implemented with the Node.js built-in module
|
|
24
|
+
* zlib. This value can be used for the `sendCompression` and `acceptCompression`
|
|
25
|
+
* option of client transports, or for the `acceptCompression` option of server
|
|
26
|
+
* plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
|
|
27
|
+
*/
|
|
28
|
+
export const compressionGzip = {
|
|
29
|
+
name: "gzip",
|
|
30
|
+
compress(bytes) {
|
|
31
|
+
return gzip(bytes, {});
|
|
32
|
+
},
|
|
33
|
+
decompress(bytes, readMaxBytes) {
|
|
34
|
+
if (bytes.length == 0) {
|
|
35
|
+
return Promise.resolve(new Uint8Array(0));
|
|
36
|
+
}
|
|
37
|
+
return wrapZLibErrors(gunzip(bytes, {
|
|
38
|
+
maxOutputLength: readMaxBytes,
|
|
39
|
+
}), readMaxBytes);
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
/**
|
|
43
|
+
* The brotli compression algorithm, implemented with the Node.js built-in module
|
|
44
|
+
* zlib. This value can be used for the `sendCompression` and `acceptCompression`
|
|
45
|
+
* option of client transports, or for the `acceptCompression` option of server
|
|
46
|
+
* plugins like `fastifyConnectPlugin` from @connectrpc/connect-fastify.
|
|
47
|
+
*/
|
|
48
|
+
export const compressionBrotli = {
|
|
49
|
+
name: "br",
|
|
50
|
+
compress(bytes) {
|
|
51
|
+
return brotliCompress(bytes, {});
|
|
52
|
+
},
|
|
53
|
+
decompress(bytes, readMaxBytes) {
|
|
54
|
+
if (bytes.length == 0) {
|
|
55
|
+
return Promise.resolve(new Uint8Array(0));
|
|
56
|
+
}
|
|
57
|
+
return wrapZLibErrors(brotliDecompress(bytes, {
|
|
58
|
+
maxOutputLength: readMaxBytes,
|
|
59
|
+
}), readMaxBytes);
|
|
60
|
+
},
|
|
61
|
+
};
|
|
62
|
+
function wrapZLibErrors(promise, readMaxBytes) {
|
|
63
|
+
return promise.catch((e) => {
|
|
64
|
+
const props = getNodeErrorProps(e);
|
|
65
|
+
let code = Code.Internal;
|
|
66
|
+
let message = "decompression failed";
|
|
67
|
+
// eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check
|
|
68
|
+
switch (props.code) {
|
|
69
|
+
case "ERR_BUFFER_TOO_LARGE":
|
|
70
|
+
code = Code.ResourceExhausted;
|
|
71
|
+
message = `message is larger than configured readMaxBytes ${readMaxBytes} after decompression`;
|
|
72
|
+
break;
|
|
73
|
+
case "Z_DATA_ERROR":
|
|
74
|
+
case "ERR_PADDING_2":
|
|
75
|
+
code = Code.InvalidArgument;
|
|
76
|
+
break;
|
|
77
|
+
default:
|
|
78
|
+
if (props.code !== undefined &&
|
|
79
|
+
props.code.startsWith("ERR__ERROR_FORMAT_")) {
|
|
80
|
+
code = Code.InvalidArgument;
|
|
81
|
+
}
|
|
82
|
+
break;
|
|
83
|
+
}
|
|
84
|
+
return Promise.reject(new ConnectError(message, code, undefined, undefined, e));
|
|
85
|
+
});
|
|
86
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { ConnectRouter, ConnectRouterOptions, ContextValues } from "@connectrpc/connect";
|
|
2
|
+
import type { NodeHandlerFn, NodeServerRequest } from "./node-universal-handler.js";
|
|
3
|
+
export interface ConnectNodeAdapterOptions extends ConnectRouterOptions {
|
|
4
|
+
/**
|
|
5
|
+
* Route definitions. We recommend the following pattern:
|
|
6
|
+
*
|
|
7
|
+
* Create a file `connect.ts` with a default export such as this:
|
|
8
|
+
*
|
|
9
|
+
* ```ts
|
|
10
|
+
* import {ConnectRouter} from "@connectrpc/connect";
|
|
11
|
+
*
|
|
12
|
+
* export default (router: ConnectRouter) => {
|
|
13
|
+
* router.service(ElizaService, {});
|
|
14
|
+
* }
|
|
15
|
+
* ```
|
|
16
|
+
*
|
|
17
|
+
* Then pass this function here.
|
|
18
|
+
*/
|
|
19
|
+
routes: (router: ConnectRouter) => void;
|
|
20
|
+
/**
|
|
21
|
+
* If none of the handler request paths match, a 404 is served. This option
|
|
22
|
+
* can provide a custom fallback for this case.
|
|
23
|
+
*/
|
|
24
|
+
fallback?: NodeHandlerFn;
|
|
25
|
+
/**
|
|
26
|
+
* Serve all handlers under this prefix. For example, the prefix "/something"
|
|
27
|
+
* will serve the RPC foo.FooService/Bar under "/something/foo.FooService/Bar".
|
|
28
|
+
* Note that many gRPC client implementations do not allow for prefixes.
|
|
29
|
+
*/
|
|
30
|
+
requestPathPrefix?: string;
|
|
31
|
+
/**
|
|
32
|
+
* Context values to extract from the request. These values are passed to
|
|
33
|
+
* the handlers.
|
|
34
|
+
*/
|
|
35
|
+
contextValues?: (req: NodeServerRequest) => ContextValues;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Create a Node.js request handler from a ConnectRouter.
|
|
39
|
+
*
|
|
40
|
+
* The returned function is compatible with http.RequestListener and its equivalent for http2.
|
|
41
|
+
*/
|
|
42
|
+
export declare function connectNodeAdapter(options: ConnectNodeAdapterOptions): NodeHandlerFn;
|
|
@@ -0,0 +1,58 @@
|
|
|
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, createConnectRouter } from "@connectrpc/connect";
|
|
15
|
+
import { uResponseNotFound } from "@connectrpc/connect/protocol";
|
|
16
|
+
import { universalRequestFromNodeRequest, universalResponseToNodeResponse, } from "./node-universal-handler.js";
|
|
17
|
+
import { compressionBrotli, compressionGzip } from "./compression.js";
|
|
18
|
+
/**
|
|
19
|
+
* Create a Node.js request handler from a ConnectRouter.
|
|
20
|
+
*
|
|
21
|
+
* The returned function is compatible with http.RequestListener and its equivalent for http2.
|
|
22
|
+
*/
|
|
23
|
+
export function connectNodeAdapter(options) {
|
|
24
|
+
var _a;
|
|
25
|
+
if (options.acceptCompression === undefined) {
|
|
26
|
+
options.acceptCompression = [compressionGzip, compressionBrotli];
|
|
27
|
+
}
|
|
28
|
+
const router = createConnectRouter(options);
|
|
29
|
+
options.routes(router);
|
|
30
|
+
const prefix = (_a = options.requestPathPrefix) !== null && _a !== void 0 ? _a : "";
|
|
31
|
+
const paths = new Map();
|
|
32
|
+
for (const uHandler of router.handlers) {
|
|
33
|
+
paths.set(prefix + uHandler.requestPath, uHandler);
|
|
34
|
+
}
|
|
35
|
+
return function nodeRequestHandler(req, res) {
|
|
36
|
+
var _a, _b, _c, _d;
|
|
37
|
+
// Strip the query parameter when matching paths.
|
|
38
|
+
const uHandler = paths.get((_b = (_a = req.url) === null || _a === void 0 ? void 0 : _a.split("?", 2)[0]) !== null && _b !== void 0 ? _b : "");
|
|
39
|
+
if (!uHandler) {
|
|
40
|
+
((_c = options.fallback) !== null && _c !== void 0 ? _c : fallback)(req, res);
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
const uReq = universalRequestFromNodeRequest(req, res, undefined, (_d = options.contextValues) === null || _d === void 0 ? void 0 : _d.call(options, req));
|
|
44
|
+
uHandler(uReq)
|
|
45
|
+
.then((uRes) => universalResponseToNodeResponse(uRes, res))
|
|
46
|
+
.catch((reason) => {
|
|
47
|
+
if (ConnectError.from(reason).code == Code.Aborted) {
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
// eslint-disable-next-line no-console
|
|
51
|
+
console.error(`handler for rpc ${uHandler.method.name} of ${uHandler.service.typeName} failed`, reason);
|
|
52
|
+
});
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
const fallback = (request, response) => {
|
|
56
|
+
response.writeHead(uResponseNotFound.status);
|
|
57
|
+
response.end();
|
|
58
|
+
};
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import type { BinaryReadOptions, BinaryWriteOptions, JsonReadOptions, JsonWriteOptions } from "@bufbuild/protobuf";
|
|
2
|
+
import type { Interceptor, Transport } from "@connectrpc/connect";
|
|
3
|
+
import type { Compression } from "@connectrpc/connect/protocol";
|
|
4
|
+
import type { NodeTransportOptions } from "./node-transport-options.js";
|
|
5
|
+
/**
|
|
6
|
+
* Options used to configure the Connect transport.
|
|
7
|
+
*
|
|
8
|
+
* See createConnectTransport().
|
|
9
|
+
*/
|
|
10
|
+
export type ConnectTransportOptions = 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, connect-node clients use the binary format.
|
|
24
|
+
*/
|
|
25
|
+
useBinaryFormat?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* Interceptors that should be applied to all calls running through
|
|
28
|
+
* this transport. See the Interceptor type for details.
|
|
29
|
+
*/
|
|
30
|
+
interceptors?: Interceptor[];
|
|
31
|
+
/**
|
|
32
|
+
* Options for the JSON format.
|
|
33
|
+
* By default, unknown fields are ignored.
|
|
34
|
+
*/
|
|
35
|
+
jsonOptions?: Partial<JsonReadOptions & JsonWriteOptions>;
|
|
36
|
+
/**
|
|
37
|
+
* Options for the binary wire format.
|
|
38
|
+
*/
|
|
39
|
+
binaryOptions?: Partial<BinaryReadOptions & BinaryWriteOptions>;
|
|
40
|
+
/**
|
|
41
|
+
* Compression algorithms available to a client. Clients ask servers to
|
|
42
|
+
* compress responses using any of the registered algorithms. The first
|
|
43
|
+
* registered algorithm is the most preferred.
|
|
44
|
+
*
|
|
45
|
+
* It is safe to use this option liberally: servers will ignore any
|
|
46
|
+
* compression algorithms they don't support. To compress requests, pair this
|
|
47
|
+
* option with `sendCompression`.
|
|
48
|
+
*
|
|
49
|
+
* If this option is not provided, the compression algorithms "gzip" and "br"
|
|
50
|
+
* (Brotli) are accepted. To opt out of response compression, pass an
|
|
51
|
+
* empty array.
|
|
52
|
+
*/
|
|
53
|
+
acceptCompression?: Compression[];
|
|
54
|
+
/**
|
|
55
|
+
* Configures the client to use the specified algorithm to compress request
|
|
56
|
+
* messages.
|
|
57
|
+
*
|
|
58
|
+
* Because some servers don't support compression, clients default to sending
|
|
59
|
+
* uncompressed requests.
|
|
60
|
+
*/
|
|
61
|
+
sendCompression?: Compression;
|
|
62
|
+
/**
|
|
63
|
+
* Sets a minimum size threshold for compression: Messages that are smaller
|
|
64
|
+
* than the configured minimum are sent uncompressed.
|
|
65
|
+
*
|
|
66
|
+
* The default value is 1 kibibyte, because the CPU cost of compressing very
|
|
67
|
+
* small messages usually isn't worth the small reduction in network I/O.
|
|
68
|
+
*/
|
|
69
|
+
compressMinBytes?: number;
|
|
70
|
+
/**
|
|
71
|
+
* Limits the performance impact of pathologically large messages sent by the
|
|
72
|
+
* server. Limits apply to each individual message, not to the stream as a
|
|
73
|
+
* whole.
|
|
74
|
+
*
|
|
75
|
+
* The default limit is the maximum supported value of ~4GiB.
|
|
76
|
+
*/
|
|
77
|
+
readMaxBytes?: number;
|
|
78
|
+
/**
|
|
79
|
+
* Prevents sending messages too large for the server to handle.
|
|
80
|
+
*
|
|
81
|
+
* The default limit is the maximum supported value of ~4GiB.
|
|
82
|
+
*/
|
|
83
|
+
writeMaxBytes?: number;
|
|
84
|
+
/**
|
|
85
|
+
* Controls whether or not Connect GET requests should be used when
|
|
86
|
+
* available, on side-effect free methods. Defaults to false.
|
|
87
|
+
*/
|
|
88
|
+
useHttpGet?: boolean;
|
|
89
|
+
/**
|
|
90
|
+
* The timeout in milliseconds to apply to all requests.
|
|
91
|
+
*
|
|
92
|
+
* This can be overridden on a per-request basis by passing a timeoutMs.
|
|
93
|
+
*/
|
|
94
|
+
defaultTimeoutMs?: number;
|
|
95
|
+
};
|
|
96
|
+
/**
|
|
97
|
+
* Create a Transport for the Connect protocol using the Node.js `http`, `http2`,
|
|
98
|
+
* or `http2` module.
|
|
99
|
+
*/
|
|
100
|
+
export declare function createConnectTransport(options: ConnectTransportOptions): Transport;
|
|
@@ -0,0 +1,22 @@
|
|
|
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 { createTransport } from "@connectrpc/connect/protocol-connect";
|
|
15
|
+
import { validateNodeTransportOptions } from "./node-transport-options.js";
|
|
16
|
+
/**
|
|
17
|
+
* Create a Transport for the Connect protocol using the Node.js `http`, `http2`,
|
|
18
|
+
* or `http2` module.
|
|
19
|
+
*/
|
|
20
|
+
export function createConnectTransport(options) {
|
|
21
|
+
return createTransport(validateNodeTransportOptions(options));
|
|
22
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
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;
|
|
@@ -0,0 +1,22 @@
|
|
|
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 { createTransport } from "@connectrpc/connect/protocol-grpc";
|
|
15
|
+
import { validateNodeTransportOptions } from "./node-transport-options.js";
|
|
16
|
+
/**
|
|
17
|
+
* Create a Transport for the gRPC protocol using the Node.js `http`, `http2`,
|
|
18
|
+
* or `http2` module.
|
|
19
|
+
*/
|
|
20
|
+
export function createGrpcTransport(options) {
|
|
21
|
+
return createTransport(validateNodeTransportOptions(options));
|
|
22
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
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;
|
|
@@ -0,0 +1,22 @@
|
|
|
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 { createTransport } from "@connectrpc/connect/protocol-grpc-web";
|
|
15
|
+
import { validateNodeTransportOptions } from "./node-transport-options.js";
|
|
16
|
+
/**
|
|
17
|
+
* Create a Transport for the gRPC-web protocol using the Node.js `http`,
|
|
18
|
+
* `http2`, or `http2` module.
|
|
19
|
+
*/
|
|
20
|
+
export function createGrpcWebTransport(options) {
|
|
21
|
+
return createTransport(validateNodeTransportOptions(options));
|
|
22
|
+
}
|