monitor-transfer-dsh 0.0.0-stage → 0.1.2
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 +25 -0
- package/README.md +51 -2
- package/cordis.patch.yml +4 -0
- package/lib/client.js +381 -0
- package/lib/index.js +267 -0
- package/package.json +67 -3
- package/skill/SKILL.md +48 -0
- package/skill/tools/node_modules/.package-lock.json +163 -0
- package/skill/tools/node_modules/pg/LICENSE +21 -0
- package/skill/tools/node_modules/pg/README.md +96 -0
- package/skill/tools/node_modules/pg/esm/index.mjs +20 -0
- package/skill/tools/node_modules/pg/lib/client.js +846 -0
- package/skill/tools/node_modules/pg/lib/connection-parameters.js +184 -0
- package/skill/tools/node_modules/pg/lib/connection.js +250 -0
- package/skill/tools/node_modules/pg/lib/crypto/cert-signatures.js +122 -0
- package/skill/tools/node_modules/pg/lib/crypto/sasl.js +262 -0
- package/skill/tools/node_modules/pg/lib/crypto/utils.js +89 -0
- package/skill/tools/node_modules/pg/lib/defaults.js +94 -0
- package/skill/tools/node_modules/pg/lib/index.js +73 -0
- package/skill/tools/node_modules/pg/lib/native/client.js +428 -0
- package/skill/tools/node_modules/pg/lib/native/index.js +2 -0
- package/skill/tools/node_modules/pg/lib/native/query.js +167 -0
- package/skill/tools/node_modules/pg/lib/query.js +263 -0
- package/skill/tools/node_modules/pg/lib/result.js +109 -0
- package/skill/tools/node_modules/pg/lib/stream.js +83 -0
- package/skill/tools/node_modules/pg/lib/type-overrides.js +35 -0
- package/skill/tools/node_modules/pg/lib/utils.js +225 -0
- package/skill/tools/node_modules/pg/package.json +76 -0
- package/skill/tools/node_modules/pg-cloudflare/LICENSE +21 -0
- package/skill/tools/node_modules/pg-cloudflare/README.md +112 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/empty.d.ts +2 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/empty.js +6 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/empty.js.map +1 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/index.d.ts +29 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/index.js +171 -0
- package/skill/tools/node_modules/pg-cloudflare/dist/index.js.map +1 -0
- package/skill/tools/node_modules/pg-cloudflare/esm/index.mjs +3 -0
- package/skill/tools/node_modules/pg-cloudflare/package.json +39 -0
- package/skill/tools/node_modules/pg-cloudflare/src/empty.ts +3 -0
- package/skill/tools/node_modules/pg-cloudflare/src/index.ts +187 -0
- package/skill/tools/node_modules/pg-cloudflare/src/types.d.ts +25 -0
- package/skill/tools/node_modules/pg-connection-string/LICENSE +21 -0
- package/skill/tools/node_modules/pg-connection-string/README.md +105 -0
- package/skill/tools/node_modules/pg-connection-string/esm/index.mjs +8 -0
- package/skill/tools/node_modules/pg-connection-string/index.d.ts +37 -0
- package/skill/tools/node_modules/pg-connection-string/index.js +237 -0
- package/skill/tools/node_modules/pg-connection-string/package.json +51 -0
- package/skill/tools/node_modules/pg-int8/LICENSE +13 -0
- package/skill/tools/node_modules/pg-int8/README.md +16 -0
- package/skill/tools/node_modules/pg-int8/index.js +100 -0
- package/skill/tools/node_modules/pg-int8/package.json +24 -0
- package/skill/tools/node_modules/pg-pool/LICENSE +21 -0
- package/skill/tools/node_modules/pg-pool/README.md +357 -0
- package/skill/tools/node_modules/pg-pool/esm/index.mjs +5 -0
- package/skill/tools/node_modules/pg-pool/index.js +517 -0
- package/skill/tools/node_modules/pg-pool/package.json +51 -0
- package/skill/tools/node_modules/pg-protocol/LICENSE +21 -0
- package/skill/tools/node_modules/pg-protocol/README.md +3 -0
- package/skill/tools/node_modules/pg-protocol/dist/b.d.ts +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/b.js +23 -0
- package/skill/tools/node_modules/pg-protocol/dist/b.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.d.ts +14 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.js +55 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.d.ts +21 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.js +113 -0
- package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.d.ts +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.js +538 -0
- package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/index.d.ts +5 -0
- package/skill/tools/node_modules/pg-protocol/dist/index.js +15 -0
- package/skill/tools/node_modules/pg-protocol/dist/index.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/messages.d.ts +161 -0
- package/skill/tools/node_modules/pg-protocol/dist/messages.js +160 -0
- package/skill/tools/node_modules/pg-protocol/dist/messages.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.d.ts +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.js +325 -0
- package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/parser.d.ts +22 -0
- package/skill/tools/node_modules/pg-protocol/dist/parser.js +325 -0
- package/skill/tools/node_modules/pg-protocol/dist/parser.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/dist/serializer.d.ts +42 -0
- package/skill/tools/node_modules/pg-protocol/dist/serializer.js +198 -0
- package/skill/tools/node_modules/pg-protocol/dist/serializer.js.map +1 -0
- package/skill/tools/node_modules/pg-protocol/esm/index.js +11 -0
- package/skill/tools/node_modules/pg-protocol/package.json +44 -0
- package/skill/tools/node_modules/pg-protocol/src/b.ts +25 -0
- package/skill/tools/node_modules/pg-protocol/src/buffer-reader.ts +58 -0
- package/skill/tools/node_modules/pg-protocol/src/buffer-writer.ts +120 -0
- package/skill/tools/node_modules/pg-protocol/src/inbound-parser.test.ts +585 -0
- package/skill/tools/node_modules/pg-protocol/src/index.ts +11 -0
- package/skill/tools/node_modules/pg-protocol/src/messages.ts +262 -0
- package/skill/tools/node_modules/pg-protocol/src/outbound-serializer.test.ts +356 -0
- package/skill/tools/node_modules/pg-protocol/src/parser.ts +414 -0
- package/skill/tools/node_modules/pg-protocol/src/serializer.ts +286 -0
- package/skill/tools/node_modules/pg-protocol/src/testing/buffer-list.ts +67 -0
- package/skill/tools/node_modules/pg-protocol/src/testing/test-buffers.ts +166 -0
- package/skill/tools/node_modules/pg-types/.travis.yml +7 -0
- package/skill/tools/node_modules/pg-types/Makefile +14 -0
- package/skill/tools/node_modules/pg-types/README.md +75 -0
- package/skill/tools/node_modules/pg-types/index.d.ts +137 -0
- package/skill/tools/node_modules/pg-types/index.js +47 -0
- package/skill/tools/node_modules/pg-types/index.test-d.ts +21 -0
- package/skill/tools/node_modules/pg-types/lib/arrayParser.js +11 -0
- package/skill/tools/node_modules/pg-types/lib/binaryParsers.js +257 -0
- package/skill/tools/node_modules/pg-types/lib/builtins.js +73 -0
- package/skill/tools/node_modules/pg-types/lib/textParsers.js +215 -0
- package/skill/tools/node_modules/pg-types/package.json +42 -0
- package/skill/tools/node_modules/pg-types/test/index.js +24 -0
- package/skill/tools/node_modules/pg-types/test/types.js +597 -0
- package/skill/tools/node_modules/pgpass/README.md +74 -0
- package/skill/tools/node_modules/pgpass/lib/helper.js +233 -0
- package/skill/tools/node_modules/pgpass/lib/index.js +23 -0
- package/skill/tools/node_modules/pgpass/package.json +41 -0
- package/skill/tools/node_modules/postgres-array/index.d.ts +4 -0
- package/skill/tools/node_modules/postgres-array/index.js +97 -0
- package/skill/tools/node_modules/postgres-array/license +21 -0
- package/skill/tools/node_modules/postgres-array/package.json +35 -0
- package/skill/tools/node_modules/postgres-array/readme.md +43 -0
- package/skill/tools/node_modules/postgres-bytea/index.js +33 -0
- package/skill/tools/node_modules/postgres-bytea/license +21 -0
- package/skill/tools/node_modules/postgres-bytea/package.json +34 -0
- package/skill/tools/node_modules/postgres-bytea/readme.md +34 -0
- package/skill/tools/node_modules/postgres-date/index.js +116 -0
- package/skill/tools/node_modules/postgres-date/license +21 -0
- package/skill/tools/node_modules/postgres-date/package.json +33 -0
- package/skill/tools/node_modules/postgres-date/readme.md +49 -0
- package/skill/tools/node_modules/postgres-interval/index.d.ts +20 -0
- package/skill/tools/node_modules/postgres-interval/index.js +125 -0
- package/skill/tools/node_modules/postgres-interval/license +21 -0
- package/skill/tools/node_modules/postgres-interval/package.json +36 -0
- package/skill/tools/node_modules/postgres-interval/readme.md +48 -0
- package/skill/tools/node_modules/split2/LICENSE +13 -0
- package/skill/tools/node_modules/split2/README.md +85 -0
- package/skill/tools/node_modules/split2/bench.js +27 -0
- package/skill/tools/node_modules/split2/index.js +141 -0
- package/skill/tools/node_modules/split2/package.json +39 -0
- package/skill/tools/node_modules/split2/test.js +409 -0
- package/skill/tools/node_modules/undici/LICENSE +21 -0
- package/skill/tools/node_modules/undici/README.md +828 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Agent.md +291 -0
- package/skill/tools/node_modules/undici/docs/docs/api/BalancedPool.md +297 -0
- package/skill/tools/node_modules/undici/docs/docs/api/CacheStorage.md +188 -0
- package/skill/tools/node_modules/undici/docs/docs/api/CacheStore.md +375 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Client.md +538 -0
- package/skill/tools/node_modules/undici/docs/docs/api/ClientStats.md +93 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Connector.md +198 -0
- package/skill/tools/node_modules/undici/docs/docs/api/ContentType.md +97 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Cookies.md +179 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Debug.md +78 -0
- package/skill/tools/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +518 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Dispatcher.md +842 -0
- package/skill/tools/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +171 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Errors.md +624 -0
- package/skill/tools/node_modules/undici/docs/docs/api/EventSource.md +358 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Fetch.md +721 -0
- package/skill/tools/node_modules/undici/docs/docs/api/GlobalInstallation.md +121 -0
- package/skill/tools/node_modules/undici/docs/docs/api/H2CClient.md +386 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Interceptors.md +439 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockAgent.md +622 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockCallHistory.md +371 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +206 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockClient.md +199 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockErrors.md +63 -0
- package/skill/tools/node_modules/undici/docs/docs/api/MockPool.md +618 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Pool.md +278 -0
- package/skill/tools/node_modules/undici/docs/docs/api/PoolStats.md +141 -0
- package/skill/tools/node_modules/undici/docs/docs/api/ProxyAgent.md +248 -0
- package/skill/tools/node_modules/undici/docs/docs/api/RedirectHandler.md +279 -0
- package/skill/tools/node_modules/undici/docs/docs/api/RetryAgent.md +136 -0
- package/skill/tools/node_modules/undici/docs/docs/api/RetryHandler.md +200 -0
- package/skill/tools/node_modules/undici/docs/docs/api/RoundRobinPool.md +239 -0
- package/skill/tools/node_modules/undici/docs/docs/api/SnapshotAgent.md +361 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +256 -0
- package/skill/tools/node_modules/undici/docs/docs/api/Util.md +82 -0
- package/skill/tools/node_modules/undici/docs/docs/api/WebSocket.md +536 -0
- package/skill/tools/node_modules/undici/docs/docs/api/api-lifecycle.md +159 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/client-certificate.md +66 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/crawling.md +60 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/migrating-from-v7-to-v8.md +233 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/mocking-request.md +192 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/proxy.md +129 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +226 -0
- package/skill/tools/node_modules/undici/docs/docs/best-practices/writing-tests.md +65 -0
- package/skill/tools/node_modules/undici/docs/docs/getting-started.md +281 -0
- package/skill/tools/node_modules/undici/docs/docs/index.md +793 -0
- package/skill/tools/node_modules/undici/docs/docs/site.json +125 -0
- package/skill/tools/node_modules/undici/docs/docs/type-map.json +79 -0
- package/skill/tools/node_modules/undici/index-fetch.js +65 -0
- package/skill/tools/node_modules/undici/index.d.ts +3 -0
- package/skill/tools/node_modules/undici/index.js +236 -0
- package/skill/tools/node_modules/undici/lib/api/abort-signal.js +59 -0
- package/skill/tools/node_modules/undici/lib/api/api-connect.js +112 -0
- package/skill/tools/node_modules/undici/lib/api/api-pipeline.js +265 -0
- package/skill/tools/node_modules/undici/lib/api/api-request.js +244 -0
- package/skill/tools/node_modules/undici/lib/api/api-stream.js +270 -0
- package/skill/tools/node_modules/undici/lib/api/api-upgrade.js +121 -0
- package/skill/tools/node_modules/undici/lib/api/index.js +7 -0
- package/skill/tools/node_modules/undici/lib/api/readable.js +615 -0
- package/skill/tools/node_modules/undici/lib/cache/memory-cache-store.js +314 -0
- package/skill/tools/node_modules/undici/lib/cache/sqlite-cache-store.js +593 -0
- package/skill/tools/node_modules/undici/lib/core/connect.js +198 -0
- package/skill/tools/node_modules/undici/lib/core/constants.js +131 -0
- package/skill/tools/node_modules/undici/lib/core/diagnostics.js +227 -0
- package/skill/tools/node_modules/undici/lib/core/errors.js +534 -0
- package/skill/tools/node_modules/undici/lib/core/request.js +582 -0
- package/skill/tools/node_modules/undici/lib/core/socks5-client.js +422 -0
- package/skill/tools/node_modules/undici/lib/core/socks5-utils.js +212 -0
- package/skill/tools/node_modules/undici/lib/core/symbols.js +81 -0
- package/skill/tools/node_modules/undici/lib/core/tree.js +160 -0
- package/skill/tools/node_modules/undici/lib/core/util.js +1035 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/agent.js +181 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/balanced-pool.js +217 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/client-h1.js +1846 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/client-h2.js +1989 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/client.js +749 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher-base.js +198 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher.js +58 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher1-wrapper.js +127 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +190 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/fixed-queue.js +135 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/h2c-client.js +51 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/parser-h1.js +1065 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/pool-base.js +347 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/pool.js +229 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/proxy-agent.js +418 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/retry-agent.js +48 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/round-robin-pool.js +169 -0
- package/skill/tools/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +350 -0
- package/skill/tools/node_modules/undici/lib/encoding/index.js +33 -0
- package/skill/tools/node_modules/undici/lib/global.js +82 -0
- package/skill/tools/node_modules/undici/lib/handler/cache-handler.js +1222 -0
- package/skill/tools/node_modules/undici/lib/handler/cache-revalidation-handler.js +134 -0
- package/skill/tools/node_modules/undici/lib/handler/decorator-handler.js +76 -0
- package/skill/tools/node_modules/undici/lib/handler/deduplication-handler.js +540 -0
- package/skill/tools/node_modules/undici/lib/handler/redirect-handler.js +284 -0
- package/skill/tools/node_modules/undici/lib/handler/retry-handler.js +686 -0
- package/skill/tools/node_modules/undici/lib/interceptor/cache.js +771 -0
- package/skill/tools/node_modules/undici/lib/interceptor/decompress.js +574 -0
- package/skill/tools/node_modules/undici/lib/interceptor/deduplicate.js +118 -0
- package/skill/tools/node_modules/undici/lib/interceptor/dns.js +593 -0
- package/skill/tools/node_modules/undici/lib/interceptor/dump.js +99 -0
- package/skill/tools/node_modules/undici/lib/interceptor/redirect.js +21 -0
- package/skill/tools/node_modules/undici/lib/interceptor/response-error.js +139 -0
- package/skill/tools/node_modules/undici/lib/interceptor/retry.js +19 -0
- package/skill/tools/node_modules/undici/lib/llhttp/constants.d.ts +195 -0
- package/skill/tools/node_modules/undici/lib/llhttp/constants.js +531 -0
- package/skill/tools/node_modules/undici/lib/llhttp/llhttp-wasm.js +15 -0
- package/skill/tools/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +15 -0
- package/skill/tools/node_modules/undici/lib/llhttp/utils.d.ts +2 -0
- package/skill/tools/node_modules/undici/lib/llhttp/utils.js +12 -0
- package/skill/tools/node_modules/undici/lib/milo/LICENSE.md +7 -0
- package/skill/tools/node_modules/undici/lib/milo/no-simd.js +1002 -0
- package/skill/tools/node_modules/undici/lib/milo/simd.js +1002 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-agent.js +255 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-call-history.js +248 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-client.js +68 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-errors.js +29 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-interceptor.js +227 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-pool.js +68 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-symbols.js +32 -0
- package/skill/tools/node_modules/undici/lib/mock/mock-utils.js +730 -0
- package/skill/tools/node_modules/undici/lib/mock/pending-interceptors-formatter.js +43 -0
- package/skill/tools/node_modules/undici/lib/mock/snapshot-agent.js +371 -0
- package/skill/tools/node_modules/undici/lib/mock/snapshot-recorder.js +624 -0
- package/skill/tools/node_modules/undici/lib/mock/snapshot-utils.js +159 -0
- package/skill/tools/node_modules/undici/lib/util/cache.js +764 -0
- package/skill/tools/node_modules/undici/lib/util/date.js +670 -0
- package/skill/tools/node_modules/undici/lib/util/runtime-features.js +93 -0
- package/skill/tools/node_modules/undici/lib/util/stats.js +32 -0
- package/skill/tools/node_modules/undici/lib/util/timers.js +425 -0
- package/skill/tools/node_modules/undici/lib/web/cache/cache.js +871 -0
- package/skill/tools/node_modules/undici/lib/web/cache/cachestorage.js +158 -0
- package/skill/tools/node_modules/undici/lib/web/cache/util.js +45 -0
- package/skill/tools/node_modules/undici/lib/web/cookies/constants.js +12 -0
- package/skill/tools/node_modules/undici/lib/web/cookies/index.js +211 -0
- package/skill/tools/node_modules/undici/lib/web/cookies/parse.js +318 -0
- package/skill/tools/node_modules/undici/lib/web/cookies/util.js +371 -0
- package/skill/tools/node_modules/undici/lib/web/eventsource/eventsource-stream.js +575 -0
- package/skill/tools/node_modules/undici/lib/web/eventsource/eventsource.js +547 -0
- package/skill/tools/node_modules/undici/lib/web/eventsource/util.js +60 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/LICENSE +21 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/body.js +583 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/constants.js +131 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/data-url.js +596 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/formdata-parser.js +594 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/formdata.js +272 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/global.js +40 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/headers.js +722 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/index.js +2451 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/request.js +1117 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/response.js +638 -0
- package/skill/tools/node_modules/undici/lib/web/fetch/util.js +1530 -0
- package/skill/tools/node_modules/undici/lib/web/infra/index.js +244 -0
- package/skill/tools/node_modules/undici/lib/web/subresource-integrity/Readme.md +9 -0
- package/skill/tools/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +307 -0
- package/skill/tools/node_modules/undici/lib/web/webidl/index.js +992 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/connection.js +350 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/constants.js +126 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/events.js +348 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/frame.js +127 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/permessage-deflate.js +105 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/receiver.js +530 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/sender.js +109 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/stream/websocketerror.js +107 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/stream/websocketstream.js +511 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/util.js +347 -0
- package/skill/tools/node_modules/undici/lib/web/websocket/websocket.js +783 -0
- package/skill/tools/node_modules/undici/package.json +154 -0
- package/skill/tools/node_modules/undici/scripts/strip-comments.js +10 -0
- package/skill/tools/node_modules/undici/types/README.md +6 -0
- package/skill/tools/node_modules/undici/types/agent.d.ts +30 -0
- package/skill/tools/node_modules/undici/types/api.d.ts +43 -0
- package/skill/tools/node_modules/undici/types/balanced-pool.d.ts +30 -0
- package/skill/tools/node_modules/undici/types/cache-interceptor.d.ts +189 -0
- package/skill/tools/node_modules/undici/types/cache.d.ts +36 -0
- package/skill/tools/node_modules/undici/types/client-stats.d.ts +15 -0
- package/skill/tools/node_modules/undici/types/client.d.ts +190 -0
- package/skill/tools/node_modules/undici/types/connector.d.ts +37 -0
- package/skill/tools/node_modules/undici/types/content-type.d.ts +21 -0
- package/skill/tools/node_modules/undici/types/cookies.d.ts +30 -0
- package/skill/tools/node_modules/undici/types/diagnostics-channel.d.ts +75 -0
- package/skill/tools/node_modules/undici/types/dispatcher.d.ts +253 -0
- package/skill/tools/node_modules/undici/types/dispatcher1-wrapper.d.ts +7 -0
- package/skill/tools/node_modules/undici/types/env-http-proxy-agent.d.ts +22 -0
- package/skill/tools/node_modules/undici/types/errors.d.ts +202 -0
- package/skill/tools/node_modules/undici/types/eventsource.d.ts +66 -0
- package/skill/tools/node_modules/undici/types/fetch.d.ts +235 -0
- package/skill/tools/node_modules/undici/types/formdata.d.ts +108 -0
- package/skill/tools/node_modules/undici/types/global-dispatcher.d.ts +9 -0
- package/skill/tools/node_modules/undici/types/global-origin.d.ts +7 -0
- package/skill/tools/node_modules/undici/types/h2c-client.d.ts +73 -0
- package/skill/tools/node_modules/undici/types/handlers.d.ts +16 -0
- package/skill/tools/node_modules/undici/types/header.d.ts +165 -0
- package/skill/tools/node_modules/undici/types/index.d.ts +93 -0
- package/skill/tools/node_modules/undici/types/interceptors.d.ts +87 -0
- package/skill/tools/node_modules/undici/types/mock-agent.d.ts +69 -0
- package/skill/tools/node_modules/undici/types/mock-call-history.d.ts +111 -0
- package/skill/tools/node_modules/undici/types/mock-client.d.ts +27 -0
- package/skill/tools/node_modules/undici/types/mock-errors.d.ts +12 -0
- package/skill/tools/node_modules/undici/types/mock-interceptor.d.ts +98 -0
- package/skill/tools/node_modules/undici/types/mock-pool.d.ts +27 -0
- package/skill/tools/node_modules/undici/types/patch.d.ts +29 -0
- package/skill/tools/node_modules/undici/types/pool-stats.d.ts +19 -0
- package/skill/tools/node_modules/undici/types/pool.d.ts +39 -0
- package/skill/tools/node_modules/undici/types/proxy-agent.d.ts +36 -0
- package/skill/tools/node_modules/undici/types/readable.d.ts +68 -0
- package/skill/tools/node_modules/undici/types/retry-agent.d.ts +8 -0
- package/skill/tools/node_modules/undici/types/retry-handler.d.ts +125 -0
- package/skill/tools/node_modules/undici/types/round-robin-pool.d.ts +39 -0
- package/skill/tools/node_modules/undici/types/snapshot-agent.d.ts +113 -0
- package/skill/tools/node_modules/undici/types/socks5-proxy-agent.d.ts +27 -0
- package/skill/tools/node_modules/undici/types/util.d.ts +18 -0
- package/skill/tools/node_modules/undici/types/utility.d.ts +7 -0
- package/skill/tools/node_modules/undici/types/webidl.d.ts +352 -0
- package/skill/tools/node_modules/undici/types/websocket.d.ts +188 -0
- package/skill/tools/node_modules/xtend/.jshintrc +30 -0
- package/skill/tools/node_modules/xtend/LICENSE +20 -0
- package/skill/tools/node_modules/xtend/README.md +32 -0
- package/skill/tools/node_modules/xtend/immutable.js +19 -0
- package/skill/tools/node_modules/xtend/mutable.js +17 -0
- package/skill/tools/node_modules/xtend/package.json +55 -0
- package/skill/tools/node_modules/xtend/test.js +103 -0
- package/skill/tools/package-lock.json +172 -0
- package/skill/tools/package.json +9 -0
- package/skill/tools/transfer_core.js +414 -0
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Client certificate
|
|
2
|
+
|
|
3
|
+
<!--type=misc-->
|
|
4
|
+
|
|
5
|
+
Client certificate authentication can be configured with the `Client`, the required options are passed along through the `connect` option.
|
|
6
|
+
|
|
7
|
+
The client certificates must be signed by a trusted CA. The Node.js default is to trust the well-known CAs curated by Mozilla.
|
|
8
|
+
|
|
9
|
+
Setting the server option `requestCert: true` tells the server to request the client certificate.
|
|
10
|
+
|
|
11
|
+
The server option `rejectUnauthorized: false` allows us to handle any invalid certificate errors in client code. The `authorized` property on the socket of the incoming request will show if the client certificate was valid. The `authorizationError` property will give the reason if the certificate was not valid.
|
|
12
|
+
|
|
13
|
+
### Client Certificate Authentication
|
|
14
|
+
|
|
15
|
+
```js
|
|
16
|
+
const { readFileSync } = require('node:fs')
|
|
17
|
+
const { join } = require('node:path')
|
|
18
|
+
const { createServer } = require('node:https')
|
|
19
|
+
const { Client } = require('undici')
|
|
20
|
+
|
|
21
|
+
const serverOptions = {
|
|
22
|
+
ca: [
|
|
23
|
+
readFileSync(join(__dirname, 'client-ca-crt.pem'), 'utf8')
|
|
24
|
+
],
|
|
25
|
+
key: readFileSync(join(__dirname, 'server-key.pem'), 'utf8'),
|
|
26
|
+
cert: readFileSync(join(__dirname, 'server-crt.pem'), 'utf8'),
|
|
27
|
+
requestCert: true,
|
|
28
|
+
rejectUnauthorized: false
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const server = createServer(serverOptions, (req, res) => {
|
|
32
|
+
// true if client cert is valid
|
|
33
|
+
if(req.client.authorized === true) {
|
|
34
|
+
console.log('valid')
|
|
35
|
+
} else {
|
|
36
|
+
console.error(req.client.authorizationError)
|
|
37
|
+
}
|
|
38
|
+
res.end()
|
|
39
|
+
})
|
|
40
|
+
|
|
41
|
+
server.listen(0, function () {
|
|
42
|
+
const tls = {
|
|
43
|
+
ca: [
|
|
44
|
+
readFileSync(join(__dirname, 'server-ca-crt.pem'), 'utf8')
|
|
45
|
+
],
|
|
46
|
+
key: readFileSync(join(__dirname, 'client-key.pem'), 'utf8'),
|
|
47
|
+
cert: readFileSync(join(__dirname, 'client-crt.pem'), 'utf8'),
|
|
48
|
+
rejectUnauthorized: false,
|
|
49
|
+
servername: 'agent1'
|
|
50
|
+
}
|
|
51
|
+
const client = new Client(`https://localhost:${server.address().port}`, {
|
|
52
|
+
connect: tls
|
|
53
|
+
})
|
|
54
|
+
|
|
55
|
+
client.request({
|
|
56
|
+
path: '/',
|
|
57
|
+
method: 'GET'
|
|
58
|
+
}, (err, { body }) => {
|
|
59
|
+
body.on('data', (buf) => {})
|
|
60
|
+
body.on('end', () => {
|
|
61
|
+
client.close()
|
|
62
|
+
server.close()
|
|
63
|
+
})
|
|
64
|
+
})
|
|
65
|
+
})
|
|
66
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Crawling
|
|
2
|
+
|
|
3
|
+
<!--type=misc-->
|
|
4
|
+
|
|
5
|
+
[RFC 9309](https://datatracker.ietf.org/doc/html/rfc9309) defines crawlers as automated clients.
|
|
6
|
+
|
|
7
|
+
Some web servers may reject requests that omit the `User-Agent` header or that use common defaults such as `'curl/7.79.1'`.
|
|
8
|
+
|
|
9
|
+
In **undici**, the default user agent is `'undici'`. Since undici is integrated into Node.js core as the implementation of `fetch()`, requests made via `fetch()` use `'node'` as the default user agent.
|
|
10
|
+
|
|
11
|
+
It is recommended to specify a **custom `User-Agent` header** when implementing crawlers. Providing a descriptive user agent allows servers to correctly identify the client and reduces the likelihood of requests being denied.
|
|
12
|
+
|
|
13
|
+
A user agent string should include sufficient detail to identify the crawler and provide contact information. For example:
|
|
14
|
+
|
|
15
|
+
```text
|
|
16
|
+
AcmeCo Crawler - acme.co - contact@acme.co
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
When adding contact details, avoid using personal identifiers such as your own name or a private email address—especially in a professional or employment context. Instead, use a role-based or organizational contact (e.g., crawler-team@company.com) to protect individual privacy while still enabling communication.
|
|
20
|
+
|
|
21
|
+
If a crawler behaves unexpectedly—for example, due to misconfiguration or implementation errors—server administrators can use the information in the user agent to contact the operator and coordinate an appropriate resolution.
|
|
22
|
+
|
|
23
|
+
The `User-Agent` header can be set on individual requests or applied globally by configuring a custom dispatcher.
|
|
24
|
+
|
|
25
|
+
**Example: setting a `User-Agent` per request**
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
import { fetch } from 'undici'
|
|
29
|
+
|
|
30
|
+
const headers = {
|
|
31
|
+
'User-Agent': 'AcmeCo Crawler - acme.co - contact@acme.co'
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const res = await fetch('https://example.com', { headers })
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## Best Practices for Crawlers
|
|
38
|
+
|
|
39
|
+
When developing a crawler, the following practices are recommended in addition to setting a descriptive `User-Agent` header:
|
|
40
|
+
|
|
41
|
+
* **Respect `robots.txt`**
|
|
42
|
+
Follow the directives defined in the target site’s `robots.txt` file, including disallowed paths and optional crawl-delay settings (see [W3C guidelines](https://www.w3.org/wiki/Write_Web_Crawler)).
|
|
43
|
+
|
|
44
|
+
* **Rate limiting**
|
|
45
|
+
Regulate request frequency to avoid imposing excessive load on servers. Introduce delays between requests or limit the number of concurrent requests. The W3C suggests at least one second between requests.
|
|
46
|
+
|
|
47
|
+
* **Error handling**
|
|
48
|
+
Implement retry logic with exponential backoff for transient failures, and stop requests when persistent errors occur (e.g., HTTP 403 or 429).
|
|
49
|
+
|
|
50
|
+
* **Monitoring and logging**
|
|
51
|
+
Track request volume, response codes, and error rates to detect misbehavior and address issues proactively.
|
|
52
|
+
|
|
53
|
+
* **Contact information**
|
|
54
|
+
Always include valid and current contact details in the `User-Agent` string so that administrators can reach the crawler operator if necessary.
|
|
55
|
+
|
|
56
|
+
## References and Further Reading
|
|
57
|
+
|
|
58
|
+
* [RFC 9309: The Robots Exclusion Protocol](https://datatracker.ietf.org/doc/html/rfc9309)
|
|
59
|
+
* [W3C Wiki: Write Web Crawler](https://www.w3.org/wiki/Write_Web_Crawler)
|
|
60
|
+
* [Ethical Web Crawling (WWW 2010 Conference Paper)](https://archives.iw3c2.org/www2010/proceedings/www/p1101.pdf)
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
# Migrating from Undici 7 to 8
|
|
2
|
+
|
|
3
|
+
<!--type=misc-->
|
|
4
|
+
|
|
5
|
+
This guide covers the changes you are most likely to hit when upgrading an
|
|
6
|
+
application or library from Undici v7 to v8.
|
|
7
|
+
|
|
8
|
+
## Before you upgrade
|
|
9
|
+
|
|
10
|
+
- Make sure your runtime is Node.js `>= 22.19.0`.
|
|
11
|
+
- If you have custom dispatchers, interceptors, or handlers, review the
|
|
12
|
+
handler API changes before updating.
|
|
13
|
+
- If you rely on HTTP/1.1-only behavior, plan to set `allowH2: false`
|
|
14
|
+
explicitly.
|
|
15
|
+
|
|
16
|
+
## 1. Update your Node.js version
|
|
17
|
+
|
|
18
|
+
Undici v8 requires Node.js `>= 22.19.0`.
|
|
19
|
+
|
|
20
|
+
If you are still on Node.js 20 or an older Node.js 22 release, upgrade Node.js
|
|
21
|
+
first:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
node -v
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
If that command prints a version lower than `v22.19.0`, upgrade Node.js before
|
|
28
|
+
installing Undici v8.
|
|
29
|
+
|
|
30
|
+
## 2. Migrate custom dispatcher handlers to the v2 API
|
|
31
|
+
|
|
32
|
+
Undici v8 uses the newer dispatcher handler API consistently.
|
|
33
|
+
|
|
34
|
+
If you implemented custom dispatchers, interceptors, or wrappers around
|
|
35
|
+
`dispatch()`, update legacy callbacks such as `onConnect`, `onHeaders`, and
|
|
36
|
+
`onComplete` to the newer callback names.
|
|
37
|
+
|
|
38
|
+
### Old handler callbacks vs. v8 callbacks
|
|
39
|
+
|
|
40
|
+
| Undici 7 style | Undici 8 style |
|
|
41
|
+
|---|---|
|
|
42
|
+
| `onConnect(abort, context)` | `onRequestStart(controller, context)` |
|
|
43
|
+
| `onHeaders(statusCode, rawHeaders, resume, statusText)` | `onResponseStart(controller, statusCode, headers, statusText)` |
|
|
44
|
+
| `onData(chunk)` | `onResponseData(controller, chunk)` |
|
|
45
|
+
| `onComplete(trailers)` | `onResponseEnd(controller, trailers)` |
|
|
46
|
+
| `onError(err)` | `onResponseError(controller, err)` |
|
|
47
|
+
| `onUpgrade(statusCode, rawHeaders, socket)` | `onRequestUpgrade(controller, statusCode, headers, socket)` |
|
|
48
|
+
|
|
49
|
+
### Example
|
|
50
|
+
|
|
51
|
+
Before:
|
|
52
|
+
|
|
53
|
+
```js
|
|
54
|
+
client.dispatch(options, {
|
|
55
|
+
onConnect (abort) {
|
|
56
|
+
this.abort = abort
|
|
57
|
+
},
|
|
58
|
+
onHeaders (statusCode, headers, resume) {
|
|
59
|
+
this.resume = resume
|
|
60
|
+
return true
|
|
61
|
+
},
|
|
62
|
+
onData (chunk) {
|
|
63
|
+
chunks.push(chunk)
|
|
64
|
+
return true
|
|
65
|
+
},
|
|
66
|
+
onComplete (trailers) {
|
|
67
|
+
console.log(trailers)
|
|
68
|
+
},
|
|
69
|
+
onError (err) {
|
|
70
|
+
console.error(err)
|
|
71
|
+
}
|
|
72
|
+
})
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
After:
|
|
76
|
+
|
|
77
|
+
```js
|
|
78
|
+
client.dispatch(options, {
|
|
79
|
+
onRequestStart (controller) {
|
|
80
|
+
this.controller = controller
|
|
81
|
+
},
|
|
82
|
+
onResponseStart (controller, statusCode, headers, statusText) {
|
|
83
|
+
console.log(statusCode, statusText, headers)
|
|
84
|
+
},
|
|
85
|
+
onResponseData (controller, chunk) {
|
|
86
|
+
chunks.push(chunk)
|
|
87
|
+
},
|
|
88
|
+
onResponseEnd (controller, trailers) {
|
|
89
|
+
console.log(trailers)
|
|
90
|
+
},
|
|
91
|
+
onResponseError (controller, err) {
|
|
92
|
+
console.error(err)
|
|
93
|
+
}
|
|
94
|
+
})
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Pause, resume, and abort now go through the controller
|
|
98
|
+
|
|
99
|
+
In Undici v7, legacy handlers could return `false` or keep references to
|
|
100
|
+
`abort()` and `resume()` callbacks. In Undici v8, use the controller instead:
|
|
101
|
+
|
|
102
|
+
```js
|
|
103
|
+
onRequestStart (controller) {
|
|
104
|
+
this.controller = controller
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
onResponseData (controller, chunk) {
|
|
108
|
+
controller.pause()
|
|
109
|
+
setImmediate(() => controller.resume())
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
onResponseError (controller, err) {
|
|
113
|
+
controller.abort(err)
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### Raw headers and trailers moved to the controller
|
|
118
|
+
|
|
119
|
+
If you need the raw header arrays, read them from the controller:
|
|
120
|
+
|
|
121
|
+
- `controller.rawHeaders`
|
|
122
|
+
- `controller.rawTrailers`
|
|
123
|
+
|
|
124
|
+
## 3. Update `onBodySent()` handlers
|
|
125
|
+
|
|
126
|
+
If you implemented `onBodySent()`, note that its signature changed.
|
|
127
|
+
|
|
128
|
+
Before, handlers received counters:
|
|
129
|
+
|
|
130
|
+
```js
|
|
131
|
+
onBodySent (chunkSize, totalBytesSent) {}
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
In Undici v8, handlers receive the actual chunk:
|
|
135
|
+
|
|
136
|
+
```js
|
|
137
|
+
onBodySent (chunk) {}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
If you need a notification that the whole body has been sent, use
|
|
141
|
+
`onRequestSent()`:
|
|
142
|
+
|
|
143
|
+
```js
|
|
144
|
+
onRequestSent () {
|
|
145
|
+
console.log('request body fully sent')
|
|
146
|
+
}
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## 4. If you need HTTP/1.1 only, disable HTTP/2 explicitly
|
|
150
|
+
|
|
151
|
+
Undici v8 enables HTTP/2 by default when a TLS server negotiates it via ALPN.
|
|
152
|
+
|
|
153
|
+
If your application depends on HTTP/1.1-specific behavior, set `allowH2: false`
|
|
154
|
+
explicitly.
|
|
155
|
+
|
|
156
|
+
Before:
|
|
157
|
+
|
|
158
|
+
```js
|
|
159
|
+
const client = new Client('https://example.com')
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
After, to keep HTTP/1.1 only:
|
|
163
|
+
|
|
164
|
+
```js
|
|
165
|
+
const client = new Client('https://example.com', {
|
|
166
|
+
allowH2: false
|
|
167
|
+
})
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
The same applies when you configure an `Agent`:
|
|
171
|
+
|
|
172
|
+
```js
|
|
173
|
+
const agent = new Agent({
|
|
174
|
+
allowH2: false
|
|
175
|
+
})
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
## 5. Use real `Blob` and `File` instances
|
|
179
|
+
|
|
180
|
+
Undici v8 no longer accepts fake Blob-like values that only imitate `Blob` or
|
|
181
|
+
`File` via properties such as `Symbol.toStringTag`.
|
|
182
|
+
|
|
183
|
+
If you were passing custom objects that looked like `Blob`s, replace them with
|
|
184
|
+
actual `Blob` or `File` instances:
|
|
185
|
+
|
|
186
|
+
```js
|
|
187
|
+
const body = new Blob(['hello'])
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
## 6. Avoid depending on the internal global dispatcher symbol
|
|
191
|
+
|
|
192
|
+
`setGlobalDispatcher()` and `getGlobalDispatcher()` remain the public APIs and
|
|
193
|
+
should continue to be used.
|
|
194
|
+
|
|
195
|
+
Internally, Undici v8 stores its dispatcher under
|
|
196
|
+
`Symbol.for('undici.globalDispatcher.2')` and mirrors a v1-compatible wrapper
|
|
197
|
+
for legacy consumers such as Node.js built-in `fetch`.
|
|
198
|
+
|
|
199
|
+
If your code was reading or writing `Symbol.for('undici.globalDispatcher.1')`
|
|
200
|
+
directly, migrate to the public APIs instead:
|
|
201
|
+
|
|
202
|
+
```js
|
|
203
|
+
import { setGlobalDispatcher, getGlobalDispatcher, Agent } from 'undici'
|
|
204
|
+
|
|
205
|
+
setGlobalDispatcher(new Agent())
|
|
206
|
+
const dispatcher = getGlobalDispatcher()
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
If you must expose a dispatcher to legacy v1 handler consumers, wrap it with
|
|
210
|
+
`Dispatcher1Wrapper`:
|
|
211
|
+
|
|
212
|
+
```js
|
|
213
|
+
import { Agent, Dispatcher1Wrapper } from 'undici'
|
|
214
|
+
|
|
215
|
+
const legacyCompatibleDispatcher = new Dispatcher1Wrapper(new Agent())
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
## 7. Verify the upgrade
|
|
219
|
+
|
|
220
|
+
After moving to Undici v8, it is worth checking these paths in your test suite:
|
|
221
|
+
|
|
222
|
+
- requests that use a custom `dispatcher`
|
|
223
|
+
- `setGlobalDispatcher()` behavior
|
|
224
|
+
- any custom interceptor or retry handler
|
|
225
|
+
- uploads that use `Blob`, `File`, or `FormData`
|
|
226
|
+
- integrations that depend on HTTP/1.1-only behavior
|
|
227
|
+
|
|
228
|
+
## Related documentation
|
|
229
|
+
|
|
230
|
+
- [Dispatcher](../api/Dispatcher.md)
|
|
231
|
+
- [Client](../api/Client.md)
|
|
232
|
+
- [Global Installation](../api/GlobalInstallation.md)
|
|
233
|
+
- [Undici Module vs. Node.js Built-in Fetch](./undici-vs-builtin-fetch.md)
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
# Mocking Request
|
|
2
|
+
|
|
3
|
+
<!--type=misc-->
|
|
4
|
+
|
|
5
|
+
Undici has its own mocking [utility](../api/MockAgent.md). It allow us to intercept undici HTTP requests and return mocked values instead. It can be useful for testing purposes.
|
|
6
|
+
|
|
7
|
+
Example:
|
|
8
|
+
|
|
9
|
+
```js
|
|
10
|
+
// bank.mjs
|
|
11
|
+
import { request } from 'undici'
|
|
12
|
+
|
|
13
|
+
export async function bankTransfer(recipient, amount) {
|
|
14
|
+
const { body } = await request('http://localhost:3000/bank-transfer',
|
|
15
|
+
{
|
|
16
|
+
method: 'POST',
|
|
17
|
+
headers: {
|
|
18
|
+
'X-TOKEN-SECRET': 'SuperSecretToken',
|
|
19
|
+
},
|
|
20
|
+
body: JSON.stringify({
|
|
21
|
+
recipient,
|
|
22
|
+
amount
|
|
23
|
+
})
|
|
24
|
+
}
|
|
25
|
+
)
|
|
26
|
+
return await body.json()
|
|
27
|
+
}
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
And this is what the test file looks like:
|
|
31
|
+
|
|
32
|
+
```js
|
|
33
|
+
// index.test.mjs
|
|
34
|
+
import { strict as assert } from 'node:assert'
|
|
35
|
+
import { MockAgent, setGlobalDispatcher, } from 'undici'
|
|
36
|
+
import { bankTransfer } from './bank.mjs'
|
|
37
|
+
|
|
38
|
+
const mockAgent = new MockAgent();
|
|
39
|
+
|
|
40
|
+
setGlobalDispatcher(mockAgent);
|
|
41
|
+
|
|
42
|
+
// Provide the base url to the request
|
|
43
|
+
const mockPool = mockAgent.get('http://localhost:3000');
|
|
44
|
+
|
|
45
|
+
// intercept the request
|
|
46
|
+
mockPool.intercept({
|
|
47
|
+
path: '/bank-transfer',
|
|
48
|
+
method: 'POST',
|
|
49
|
+
headers: {
|
|
50
|
+
'X-TOKEN-SECRET': 'SuperSecretToken',
|
|
51
|
+
},
|
|
52
|
+
body: JSON.stringify({
|
|
53
|
+
recipient: '1234567890',
|
|
54
|
+
amount: '100'
|
|
55
|
+
})
|
|
56
|
+
}).reply(200, {
|
|
57
|
+
message: 'transaction processed'
|
|
58
|
+
})
|
|
59
|
+
|
|
60
|
+
const success = await bankTransfer('1234567890', '100')
|
|
61
|
+
|
|
62
|
+
assert.deepEqual(success, { message: 'transaction processed' })
|
|
63
|
+
|
|
64
|
+
// if you dont want to check whether the body or the headers contain the same value
|
|
65
|
+
// just remove it from interceptor
|
|
66
|
+
mockPool.intercept({
|
|
67
|
+
path: '/bank-transfer',
|
|
68
|
+
method: 'POST',
|
|
69
|
+
}).reply(400, {
|
|
70
|
+
message: 'bank account not found'
|
|
71
|
+
})
|
|
72
|
+
|
|
73
|
+
const badRequest = await bankTransfer('1234567890', '100')
|
|
74
|
+
|
|
75
|
+
assert.deepEqual(badRequest, { message: 'bank account not found' })
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Explore other MockAgent functionality [here](../api/MockAgent.md)
|
|
79
|
+
|
|
80
|
+
## Access agent call history
|
|
81
|
+
|
|
82
|
+
Using a MockAgent also allows you to make assertions on the configuration used to make your request in your application.
|
|
83
|
+
|
|
84
|
+
Here is an example :
|
|
85
|
+
|
|
86
|
+
```js
|
|
87
|
+
// index.test.mjs
|
|
88
|
+
import { strict as assert } from 'node:assert'
|
|
89
|
+
import { MockAgent, setGlobalDispatcher, fetch } from 'undici'
|
|
90
|
+
import { app } from './app.mjs'
|
|
91
|
+
|
|
92
|
+
// given an application server running on http://localhost:3000
|
|
93
|
+
await app.start()
|
|
94
|
+
|
|
95
|
+
// enable call history at instantiation
|
|
96
|
+
const mockAgent = new MockAgent({ enableCallHistory: true })
|
|
97
|
+
// or after instantiation
|
|
98
|
+
mockAgent.enableCallHistory()
|
|
99
|
+
|
|
100
|
+
setGlobalDispatcher(mockAgent)
|
|
101
|
+
|
|
102
|
+
// this call is made (not intercepted)
|
|
103
|
+
await fetch(`http://localhost:3000/endpoint?query='hello'`, {
|
|
104
|
+
method: 'POST',
|
|
105
|
+
headers: { 'content-type': 'application/json' },
|
|
106
|
+
body: JSON.stringify({ data: '' })
|
|
107
|
+
})
|
|
108
|
+
|
|
109
|
+
// access to the call history of the MockAgent (which register every call made intercepted or not)
|
|
110
|
+
assert.ok(mockAgent.getCallHistory()?.calls().length === 1)
|
|
111
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.fullUrl, `http://localhost:3000/endpoint?query='hello'`)
|
|
112
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.body, JSON.stringify({ data: '' }))
|
|
113
|
+
assert.deepStrictEqual(mockAgent.getCallHistory()?.firstCall()?.searchParams, { query: 'hello' })
|
|
114
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.port, '3000')
|
|
115
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.host, 'localhost:3000')
|
|
116
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.method, 'POST')
|
|
117
|
+
assert.strictEqual(mockAgent.getCallHistory()?.firstCall()?.path, '/endpoint')
|
|
118
|
+
assert.deepStrictEqual(mockAgent.getCallHistory()?.firstCall()?.headers, { 'content-type': 'application/json' })
|
|
119
|
+
|
|
120
|
+
// clear all call history logs
|
|
121
|
+
mockAgent.clearCallHistory()
|
|
122
|
+
|
|
123
|
+
assert.ok(mockAgent.getCallHistory()?.calls().length === 0)
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Calling `mockAgent.close()` will automatically clear and delete every call history for you.
|
|
127
|
+
|
|
128
|
+
Explore other MockAgent functionality [here](../api/MockAgent.md)
|
|
129
|
+
|
|
130
|
+
Explore other MockCallHistory functionality [here](../api/MockCallHistory.md)
|
|
131
|
+
|
|
132
|
+
Explore other MockCallHistoryLog functionality [here](../api/MockCallHistoryLog.md)
|
|
133
|
+
|
|
134
|
+
## Debug Mock Value
|
|
135
|
+
|
|
136
|
+
When the interceptor and the request options are not the same, undici will automatically make a real HTTP request. To prevent real requests from being made, use `mockAgent.disableNetConnect()`:
|
|
137
|
+
|
|
138
|
+
```js
|
|
139
|
+
const mockAgent = new MockAgent();
|
|
140
|
+
|
|
141
|
+
setGlobalDispatcher(mockAgent);
|
|
142
|
+
mockAgent.disableNetConnect()
|
|
143
|
+
|
|
144
|
+
// Provide the base url to the request
|
|
145
|
+
const mockPool = mockAgent.get('http://localhost:3000');
|
|
146
|
+
|
|
147
|
+
mockPool.intercept({
|
|
148
|
+
path: '/bank-transfer',
|
|
149
|
+
method: 'POST',
|
|
150
|
+
}).reply(200, {
|
|
151
|
+
message: 'transaction processed'
|
|
152
|
+
})
|
|
153
|
+
|
|
154
|
+
const badRequest = await bankTransfer('1234567890', '100')
|
|
155
|
+
// Will throw an error
|
|
156
|
+
// MockNotMatchedError: Mock dispatch not matched for path '/bank-transfer':
|
|
157
|
+
// subsequent request to origin http://localhost:3000 was not allowed (net.connect disabled)
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
## Reply with data based on request
|
|
161
|
+
|
|
162
|
+
If the mocked response needs to be dynamically derived from the request parameters, you can provide a function instead of an object to `reply`:
|
|
163
|
+
|
|
164
|
+
```js
|
|
165
|
+
mockPool.intercept({
|
|
166
|
+
path: '/bank-transfer',
|
|
167
|
+
method: 'POST',
|
|
168
|
+
headers: {
|
|
169
|
+
'X-TOKEN-SECRET': 'SuperSecretToken',
|
|
170
|
+
},
|
|
171
|
+
body: JSON.stringify({
|
|
172
|
+
recipient: '1234567890',
|
|
173
|
+
amount: '100'
|
|
174
|
+
})
|
|
175
|
+
}).reply(200, (opts) => {
|
|
176
|
+
// do something with opts
|
|
177
|
+
|
|
178
|
+
return { message: 'transaction processed' }
|
|
179
|
+
})
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
in this case opts will be
|
|
183
|
+
|
|
184
|
+
```js
|
|
185
|
+
{
|
|
186
|
+
method: 'POST',
|
|
187
|
+
headers: { 'X-TOKEN-SECRET': 'SuperSecretToken' },
|
|
188
|
+
body: '{"recipient":"1234567890","amount":"100"}',
|
|
189
|
+
origin: 'http://localhost:3000',
|
|
190
|
+
path: '/bank-transfer'
|
|
191
|
+
}
|
|
192
|
+
```
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
# Connecting through a proxy
|
|
2
|
+
|
|
3
|
+
<!--type=misc-->
|
|
4
|
+
|
|
5
|
+
Connecting through a proxy is possible by:
|
|
6
|
+
|
|
7
|
+
- Using {ProxyAgent}.
|
|
8
|
+
- Configuring `Client` or `Pool` constructor.
|
|
9
|
+
|
|
10
|
+
The proxy url should be passed to the `Client` or `Pool` constructor, while the upstream server url
|
|
11
|
+
should be added to every request call in the `path`.
|
|
12
|
+
For instance, if you need to send a request to the `/hello` route of your upstream server,
|
|
13
|
+
the `path` should be `path: 'http://upstream.server:port/hello?foo=bar'`.
|
|
14
|
+
|
|
15
|
+
If you proxy requires basic authentication, you can send it via the `proxy-authorization` header.
|
|
16
|
+
|
|
17
|
+
### Connect without authentication
|
|
18
|
+
|
|
19
|
+
```js
|
|
20
|
+
import { Client } from 'undici'
|
|
21
|
+
import { createServer } from 'http'
|
|
22
|
+
import { createProxy } from 'proxy'
|
|
23
|
+
|
|
24
|
+
const server = await buildServer()
|
|
25
|
+
const proxyServer = await buildProxy()
|
|
26
|
+
|
|
27
|
+
const serverUrl = `http://localhost:${server.address().port}`
|
|
28
|
+
const proxyUrl = `http://localhost:${proxyServer.address().port}`
|
|
29
|
+
|
|
30
|
+
server.on('request', (req, res) => {
|
|
31
|
+
console.log(req.url) // '/hello?foo=bar'
|
|
32
|
+
res.setHeader('content-type', 'application/json')
|
|
33
|
+
res.end(JSON.stringify({ hello: 'world' }))
|
|
34
|
+
})
|
|
35
|
+
|
|
36
|
+
const client = new Client(proxyUrl)
|
|
37
|
+
|
|
38
|
+
const response = await client.request({
|
|
39
|
+
method: 'GET',
|
|
40
|
+
path: serverUrl + '/hello?foo=bar'
|
|
41
|
+
})
|
|
42
|
+
|
|
43
|
+
response.body.setEncoding('utf8')
|
|
44
|
+
let data = ''
|
|
45
|
+
for await (const chunk of response.body) {
|
|
46
|
+
data += chunk
|
|
47
|
+
}
|
|
48
|
+
console.log(response.statusCode) // 200
|
|
49
|
+
console.log(JSON.parse(data)) // { hello: 'world' }
|
|
50
|
+
|
|
51
|
+
server.close()
|
|
52
|
+
proxyServer.close()
|
|
53
|
+
client.close()
|
|
54
|
+
|
|
55
|
+
function buildServer () {
|
|
56
|
+
return new Promise((resolve, reject) => {
|
|
57
|
+
const server = createServer()
|
|
58
|
+
server.listen(0, () => resolve(server))
|
|
59
|
+
})
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function buildProxy () {
|
|
63
|
+
return new Promise((resolve, reject) => {
|
|
64
|
+
const server = createProxy(createServer())
|
|
65
|
+
server.listen(0, () => resolve(server))
|
|
66
|
+
})
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Connect with authentication
|
|
71
|
+
|
|
72
|
+
```js
|
|
73
|
+
import { Client } from 'undici'
|
|
74
|
+
import { createServer } from 'http'
|
|
75
|
+
import { createProxy } from 'proxy'
|
|
76
|
+
|
|
77
|
+
const server = await buildServer()
|
|
78
|
+
const proxyServer = await buildProxy()
|
|
79
|
+
|
|
80
|
+
const serverUrl = `http://localhost:${server.address().port}`
|
|
81
|
+
const proxyUrl = `http://localhost:${proxyServer.address().port}`
|
|
82
|
+
|
|
83
|
+
proxyServer.authenticate = function (req) {
|
|
84
|
+
return req.headers['proxy-authorization'] === `Basic ${Buffer.from('user:pass').toString('base64')}`
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
server.on('request', (req, res) => {
|
|
88
|
+
console.log(req.url) // '/hello?foo=bar'
|
|
89
|
+
res.setHeader('content-type', 'application/json')
|
|
90
|
+
res.end(JSON.stringify({ hello: 'world' }))
|
|
91
|
+
})
|
|
92
|
+
|
|
93
|
+
const client = new Client(proxyUrl)
|
|
94
|
+
|
|
95
|
+
const response = await client.request({
|
|
96
|
+
method: 'GET',
|
|
97
|
+
path: serverUrl + '/hello?foo=bar',
|
|
98
|
+
headers: {
|
|
99
|
+
'proxy-authorization': `Basic ${Buffer.from('user:pass').toString('base64')}`
|
|
100
|
+
}
|
|
101
|
+
})
|
|
102
|
+
|
|
103
|
+
response.body.setEncoding('utf8')
|
|
104
|
+
let data = ''
|
|
105
|
+
for await (const chunk of response.body) {
|
|
106
|
+
data += chunk
|
|
107
|
+
}
|
|
108
|
+
console.log(response.statusCode) // 200
|
|
109
|
+
console.log(JSON.parse(data)) // { hello: 'world' }
|
|
110
|
+
|
|
111
|
+
server.close()
|
|
112
|
+
proxyServer.close()
|
|
113
|
+
client.close()
|
|
114
|
+
|
|
115
|
+
function buildServer () {
|
|
116
|
+
return new Promise((resolve, reject) => {
|
|
117
|
+
const server = createServer()
|
|
118
|
+
server.listen(0, () => resolve(server))
|
|
119
|
+
})
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
function buildProxy () {
|
|
123
|
+
return new Promise((resolve, reject) => {
|
|
124
|
+
const server = createProxy(createServer())
|
|
125
|
+
server.listen(0, () => resolve(server))
|
|
126
|
+
})
|
|
127
|
+
}
|
|
128
|
+
```
|
|
129
|
+
|