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.
Files changed (367) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +51 -2
  3. package/cordis.patch.yml +4 -0
  4. package/lib/client.js +381 -0
  5. package/lib/index.js +267 -0
  6. package/package.json +67 -3
  7. package/skill/SKILL.md +48 -0
  8. package/skill/tools/node_modules/.package-lock.json +163 -0
  9. package/skill/tools/node_modules/pg/LICENSE +21 -0
  10. package/skill/tools/node_modules/pg/README.md +96 -0
  11. package/skill/tools/node_modules/pg/esm/index.mjs +20 -0
  12. package/skill/tools/node_modules/pg/lib/client.js +846 -0
  13. package/skill/tools/node_modules/pg/lib/connection-parameters.js +184 -0
  14. package/skill/tools/node_modules/pg/lib/connection.js +250 -0
  15. package/skill/tools/node_modules/pg/lib/crypto/cert-signatures.js +122 -0
  16. package/skill/tools/node_modules/pg/lib/crypto/sasl.js +262 -0
  17. package/skill/tools/node_modules/pg/lib/crypto/utils.js +89 -0
  18. package/skill/tools/node_modules/pg/lib/defaults.js +94 -0
  19. package/skill/tools/node_modules/pg/lib/index.js +73 -0
  20. package/skill/tools/node_modules/pg/lib/native/client.js +428 -0
  21. package/skill/tools/node_modules/pg/lib/native/index.js +2 -0
  22. package/skill/tools/node_modules/pg/lib/native/query.js +167 -0
  23. package/skill/tools/node_modules/pg/lib/query.js +263 -0
  24. package/skill/tools/node_modules/pg/lib/result.js +109 -0
  25. package/skill/tools/node_modules/pg/lib/stream.js +83 -0
  26. package/skill/tools/node_modules/pg/lib/type-overrides.js +35 -0
  27. package/skill/tools/node_modules/pg/lib/utils.js +225 -0
  28. package/skill/tools/node_modules/pg/package.json +76 -0
  29. package/skill/tools/node_modules/pg-cloudflare/LICENSE +21 -0
  30. package/skill/tools/node_modules/pg-cloudflare/README.md +112 -0
  31. package/skill/tools/node_modules/pg-cloudflare/dist/empty.d.ts +2 -0
  32. package/skill/tools/node_modules/pg-cloudflare/dist/empty.js +6 -0
  33. package/skill/tools/node_modules/pg-cloudflare/dist/empty.js.map +1 -0
  34. package/skill/tools/node_modules/pg-cloudflare/dist/index.d.ts +29 -0
  35. package/skill/tools/node_modules/pg-cloudflare/dist/index.js +171 -0
  36. package/skill/tools/node_modules/pg-cloudflare/dist/index.js.map +1 -0
  37. package/skill/tools/node_modules/pg-cloudflare/esm/index.mjs +3 -0
  38. package/skill/tools/node_modules/pg-cloudflare/package.json +39 -0
  39. package/skill/tools/node_modules/pg-cloudflare/src/empty.ts +3 -0
  40. package/skill/tools/node_modules/pg-cloudflare/src/index.ts +187 -0
  41. package/skill/tools/node_modules/pg-cloudflare/src/types.d.ts +25 -0
  42. package/skill/tools/node_modules/pg-connection-string/LICENSE +21 -0
  43. package/skill/tools/node_modules/pg-connection-string/README.md +105 -0
  44. package/skill/tools/node_modules/pg-connection-string/esm/index.mjs +8 -0
  45. package/skill/tools/node_modules/pg-connection-string/index.d.ts +37 -0
  46. package/skill/tools/node_modules/pg-connection-string/index.js +237 -0
  47. package/skill/tools/node_modules/pg-connection-string/package.json +51 -0
  48. package/skill/tools/node_modules/pg-int8/LICENSE +13 -0
  49. package/skill/tools/node_modules/pg-int8/README.md +16 -0
  50. package/skill/tools/node_modules/pg-int8/index.js +100 -0
  51. package/skill/tools/node_modules/pg-int8/package.json +24 -0
  52. package/skill/tools/node_modules/pg-pool/LICENSE +21 -0
  53. package/skill/tools/node_modules/pg-pool/README.md +357 -0
  54. package/skill/tools/node_modules/pg-pool/esm/index.mjs +5 -0
  55. package/skill/tools/node_modules/pg-pool/index.js +517 -0
  56. package/skill/tools/node_modules/pg-pool/package.json +51 -0
  57. package/skill/tools/node_modules/pg-protocol/LICENSE +21 -0
  58. package/skill/tools/node_modules/pg-protocol/README.md +3 -0
  59. package/skill/tools/node_modules/pg-protocol/dist/b.d.ts +1 -0
  60. package/skill/tools/node_modules/pg-protocol/dist/b.js +23 -0
  61. package/skill/tools/node_modules/pg-protocol/dist/b.js.map +1 -0
  62. package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.d.ts +14 -0
  63. package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.js +55 -0
  64. package/skill/tools/node_modules/pg-protocol/dist/buffer-reader.js.map +1 -0
  65. package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.d.ts +21 -0
  66. package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.js +113 -0
  67. package/skill/tools/node_modules/pg-protocol/dist/buffer-writer.js.map +1 -0
  68. package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.d.ts +1 -0
  69. package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.js +538 -0
  70. package/skill/tools/node_modules/pg-protocol/dist/inbound-parser.test.js.map +1 -0
  71. package/skill/tools/node_modules/pg-protocol/dist/index.d.ts +5 -0
  72. package/skill/tools/node_modules/pg-protocol/dist/index.js +15 -0
  73. package/skill/tools/node_modules/pg-protocol/dist/index.js.map +1 -0
  74. package/skill/tools/node_modules/pg-protocol/dist/messages.d.ts +161 -0
  75. package/skill/tools/node_modules/pg-protocol/dist/messages.js +160 -0
  76. package/skill/tools/node_modules/pg-protocol/dist/messages.js.map +1 -0
  77. package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.d.ts +1 -0
  78. package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.js +325 -0
  79. package/skill/tools/node_modules/pg-protocol/dist/outbound-serializer.test.js.map +1 -0
  80. package/skill/tools/node_modules/pg-protocol/dist/parser.d.ts +22 -0
  81. package/skill/tools/node_modules/pg-protocol/dist/parser.js +325 -0
  82. package/skill/tools/node_modules/pg-protocol/dist/parser.js.map +1 -0
  83. package/skill/tools/node_modules/pg-protocol/dist/serializer.d.ts +42 -0
  84. package/skill/tools/node_modules/pg-protocol/dist/serializer.js +198 -0
  85. package/skill/tools/node_modules/pg-protocol/dist/serializer.js.map +1 -0
  86. package/skill/tools/node_modules/pg-protocol/esm/index.js +11 -0
  87. package/skill/tools/node_modules/pg-protocol/package.json +44 -0
  88. package/skill/tools/node_modules/pg-protocol/src/b.ts +25 -0
  89. package/skill/tools/node_modules/pg-protocol/src/buffer-reader.ts +58 -0
  90. package/skill/tools/node_modules/pg-protocol/src/buffer-writer.ts +120 -0
  91. package/skill/tools/node_modules/pg-protocol/src/inbound-parser.test.ts +585 -0
  92. package/skill/tools/node_modules/pg-protocol/src/index.ts +11 -0
  93. package/skill/tools/node_modules/pg-protocol/src/messages.ts +262 -0
  94. package/skill/tools/node_modules/pg-protocol/src/outbound-serializer.test.ts +356 -0
  95. package/skill/tools/node_modules/pg-protocol/src/parser.ts +414 -0
  96. package/skill/tools/node_modules/pg-protocol/src/serializer.ts +286 -0
  97. package/skill/tools/node_modules/pg-protocol/src/testing/buffer-list.ts +67 -0
  98. package/skill/tools/node_modules/pg-protocol/src/testing/test-buffers.ts +166 -0
  99. package/skill/tools/node_modules/pg-types/.travis.yml +7 -0
  100. package/skill/tools/node_modules/pg-types/Makefile +14 -0
  101. package/skill/tools/node_modules/pg-types/README.md +75 -0
  102. package/skill/tools/node_modules/pg-types/index.d.ts +137 -0
  103. package/skill/tools/node_modules/pg-types/index.js +47 -0
  104. package/skill/tools/node_modules/pg-types/index.test-d.ts +21 -0
  105. package/skill/tools/node_modules/pg-types/lib/arrayParser.js +11 -0
  106. package/skill/tools/node_modules/pg-types/lib/binaryParsers.js +257 -0
  107. package/skill/tools/node_modules/pg-types/lib/builtins.js +73 -0
  108. package/skill/tools/node_modules/pg-types/lib/textParsers.js +215 -0
  109. package/skill/tools/node_modules/pg-types/package.json +42 -0
  110. package/skill/tools/node_modules/pg-types/test/index.js +24 -0
  111. package/skill/tools/node_modules/pg-types/test/types.js +597 -0
  112. package/skill/tools/node_modules/pgpass/README.md +74 -0
  113. package/skill/tools/node_modules/pgpass/lib/helper.js +233 -0
  114. package/skill/tools/node_modules/pgpass/lib/index.js +23 -0
  115. package/skill/tools/node_modules/pgpass/package.json +41 -0
  116. package/skill/tools/node_modules/postgres-array/index.d.ts +4 -0
  117. package/skill/tools/node_modules/postgres-array/index.js +97 -0
  118. package/skill/tools/node_modules/postgres-array/license +21 -0
  119. package/skill/tools/node_modules/postgres-array/package.json +35 -0
  120. package/skill/tools/node_modules/postgres-array/readme.md +43 -0
  121. package/skill/tools/node_modules/postgres-bytea/index.js +33 -0
  122. package/skill/tools/node_modules/postgres-bytea/license +21 -0
  123. package/skill/tools/node_modules/postgres-bytea/package.json +34 -0
  124. package/skill/tools/node_modules/postgres-bytea/readme.md +34 -0
  125. package/skill/tools/node_modules/postgres-date/index.js +116 -0
  126. package/skill/tools/node_modules/postgres-date/license +21 -0
  127. package/skill/tools/node_modules/postgres-date/package.json +33 -0
  128. package/skill/tools/node_modules/postgres-date/readme.md +49 -0
  129. package/skill/tools/node_modules/postgres-interval/index.d.ts +20 -0
  130. package/skill/tools/node_modules/postgres-interval/index.js +125 -0
  131. package/skill/tools/node_modules/postgres-interval/license +21 -0
  132. package/skill/tools/node_modules/postgres-interval/package.json +36 -0
  133. package/skill/tools/node_modules/postgres-interval/readme.md +48 -0
  134. package/skill/tools/node_modules/split2/LICENSE +13 -0
  135. package/skill/tools/node_modules/split2/README.md +85 -0
  136. package/skill/tools/node_modules/split2/bench.js +27 -0
  137. package/skill/tools/node_modules/split2/index.js +141 -0
  138. package/skill/tools/node_modules/split2/package.json +39 -0
  139. package/skill/tools/node_modules/split2/test.js +409 -0
  140. package/skill/tools/node_modules/undici/LICENSE +21 -0
  141. package/skill/tools/node_modules/undici/README.md +828 -0
  142. package/skill/tools/node_modules/undici/docs/docs/api/Agent.md +291 -0
  143. package/skill/tools/node_modules/undici/docs/docs/api/BalancedPool.md +297 -0
  144. package/skill/tools/node_modules/undici/docs/docs/api/CacheStorage.md +188 -0
  145. package/skill/tools/node_modules/undici/docs/docs/api/CacheStore.md +375 -0
  146. package/skill/tools/node_modules/undici/docs/docs/api/Client.md +538 -0
  147. package/skill/tools/node_modules/undici/docs/docs/api/ClientStats.md +93 -0
  148. package/skill/tools/node_modules/undici/docs/docs/api/Connector.md +198 -0
  149. package/skill/tools/node_modules/undici/docs/docs/api/ContentType.md +97 -0
  150. package/skill/tools/node_modules/undici/docs/docs/api/Cookies.md +179 -0
  151. package/skill/tools/node_modules/undici/docs/docs/api/Debug.md +78 -0
  152. package/skill/tools/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +518 -0
  153. package/skill/tools/node_modules/undici/docs/docs/api/Dispatcher.md +842 -0
  154. package/skill/tools/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +171 -0
  155. package/skill/tools/node_modules/undici/docs/docs/api/Errors.md +624 -0
  156. package/skill/tools/node_modules/undici/docs/docs/api/EventSource.md +358 -0
  157. package/skill/tools/node_modules/undici/docs/docs/api/Fetch.md +721 -0
  158. package/skill/tools/node_modules/undici/docs/docs/api/GlobalInstallation.md +121 -0
  159. package/skill/tools/node_modules/undici/docs/docs/api/H2CClient.md +386 -0
  160. package/skill/tools/node_modules/undici/docs/docs/api/Interceptors.md +439 -0
  161. package/skill/tools/node_modules/undici/docs/docs/api/MockAgent.md +622 -0
  162. package/skill/tools/node_modules/undici/docs/docs/api/MockCallHistory.md +371 -0
  163. package/skill/tools/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +206 -0
  164. package/skill/tools/node_modules/undici/docs/docs/api/MockClient.md +199 -0
  165. package/skill/tools/node_modules/undici/docs/docs/api/MockErrors.md +63 -0
  166. package/skill/tools/node_modules/undici/docs/docs/api/MockPool.md +618 -0
  167. package/skill/tools/node_modules/undici/docs/docs/api/Pool.md +278 -0
  168. package/skill/tools/node_modules/undici/docs/docs/api/PoolStats.md +141 -0
  169. package/skill/tools/node_modules/undici/docs/docs/api/ProxyAgent.md +248 -0
  170. package/skill/tools/node_modules/undici/docs/docs/api/RedirectHandler.md +279 -0
  171. package/skill/tools/node_modules/undici/docs/docs/api/RetryAgent.md +136 -0
  172. package/skill/tools/node_modules/undici/docs/docs/api/RetryHandler.md +200 -0
  173. package/skill/tools/node_modules/undici/docs/docs/api/RoundRobinPool.md +239 -0
  174. package/skill/tools/node_modules/undici/docs/docs/api/SnapshotAgent.md +361 -0
  175. package/skill/tools/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +256 -0
  176. package/skill/tools/node_modules/undici/docs/docs/api/Util.md +82 -0
  177. package/skill/tools/node_modules/undici/docs/docs/api/WebSocket.md +536 -0
  178. package/skill/tools/node_modules/undici/docs/docs/api/api-lifecycle.md +159 -0
  179. package/skill/tools/node_modules/undici/docs/docs/best-practices/client-certificate.md +66 -0
  180. package/skill/tools/node_modules/undici/docs/docs/best-practices/crawling.md +60 -0
  181. package/skill/tools/node_modules/undici/docs/docs/best-practices/migrating-from-v7-to-v8.md +233 -0
  182. package/skill/tools/node_modules/undici/docs/docs/best-practices/mocking-request.md +192 -0
  183. package/skill/tools/node_modules/undici/docs/docs/best-practices/proxy.md +129 -0
  184. package/skill/tools/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +226 -0
  185. package/skill/tools/node_modules/undici/docs/docs/best-practices/writing-tests.md +65 -0
  186. package/skill/tools/node_modules/undici/docs/docs/getting-started.md +281 -0
  187. package/skill/tools/node_modules/undici/docs/docs/index.md +793 -0
  188. package/skill/tools/node_modules/undici/docs/docs/site.json +125 -0
  189. package/skill/tools/node_modules/undici/docs/docs/type-map.json +79 -0
  190. package/skill/tools/node_modules/undici/index-fetch.js +65 -0
  191. package/skill/tools/node_modules/undici/index.d.ts +3 -0
  192. package/skill/tools/node_modules/undici/index.js +236 -0
  193. package/skill/tools/node_modules/undici/lib/api/abort-signal.js +59 -0
  194. package/skill/tools/node_modules/undici/lib/api/api-connect.js +112 -0
  195. package/skill/tools/node_modules/undici/lib/api/api-pipeline.js +265 -0
  196. package/skill/tools/node_modules/undici/lib/api/api-request.js +244 -0
  197. package/skill/tools/node_modules/undici/lib/api/api-stream.js +270 -0
  198. package/skill/tools/node_modules/undici/lib/api/api-upgrade.js +121 -0
  199. package/skill/tools/node_modules/undici/lib/api/index.js +7 -0
  200. package/skill/tools/node_modules/undici/lib/api/readable.js +615 -0
  201. package/skill/tools/node_modules/undici/lib/cache/memory-cache-store.js +314 -0
  202. package/skill/tools/node_modules/undici/lib/cache/sqlite-cache-store.js +593 -0
  203. package/skill/tools/node_modules/undici/lib/core/connect.js +198 -0
  204. package/skill/tools/node_modules/undici/lib/core/constants.js +131 -0
  205. package/skill/tools/node_modules/undici/lib/core/diagnostics.js +227 -0
  206. package/skill/tools/node_modules/undici/lib/core/errors.js +534 -0
  207. package/skill/tools/node_modules/undici/lib/core/request.js +582 -0
  208. package/skill/tools/node_modules/undici/lib/core/socks5-client.js +422 -0
  209. package/skill/tools/node_modules/undici/lib/core/socks5-utils.js +212 -0
  210. package/skill/tools/node_modules/undici/lib/core/symbols.js +81 -0
  211. package/skill/tools/node_modules/undici/lib/core/tree.js +160 -0
  212. package/skill/tools/node_modules/undici/lib/core/util.js +1035 -0
  213. package/skill/tools/node_modules/undici/lib/dispatcher/agent.js +181 -0
  214. package/skill/tools/node_modules/undici/lib/dispatcher/balanced-pool.js +217 -0
  215. package/skill/tools/node_modules/undici/lib/dispatcher/client-h1.js +1846 -0
  216. package/skill/tools/node_modules/undici/lib/dispatcher/client-h2.js +1989 -0
  217. package/skill/tools/node_modules/undici/lib/dispatcher/client.js +749 -0
  218. package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher-base.js +198 -0
  219. package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher.js +58 -0
  220. package/skill/tools/node_modules/undici/lib/dispatcher/dispatcher1-wrapper.js +127 -0
  221. package/skill/tools/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +190 -0
  222. package/skill/tools/node_modules/undici/lib/dispatcher/fixed-queue.js +135 -0
  223. package/skill/tools/node_modules/undici/lib/dispatcher/h2c-client.js +51 -0
  224. package/skill/tools/node_modules/undici/lib/dispatcher/parser-h1.js +1065 -0
  225. package/skill/tools/node_modules/undici/lib/dispatcher/pool-base.js +347 -0
  226. package/skill/tools/node_modules/undici/lib/dispatcher/pool.js +229 -0
  227. package/skill/tools/node_modules/undici/lib/dispatcher/proxy-agent.js +418 -0
  228. package/skill/tools/node_modules/undici/lib/dispatcher/retry-agent.js +48 -0
  229. package/skill/tools/node_modules/undici/lib/dispatcher/round-robin-pool.js +169 -0
  230. package/skill/tools/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +350 -0
  231. package/skill/tools/node_modules/undici/lib/encoding/index.js +33 -0
  232. package/skill/tools/node_modules/undici/lib/global.js +82 -0
  233. package/skill/tools/node_modules/undici/lib/handler/cache-handler.js +1222 -0
  234. package/skill/tools/node_modules/undici/lib/handler/cache-revalidation-handler.js +134 -0
  235. package/skill/tools/node_modules/undici/lib/handler/decorator-handler.js +76 -0
  236. package/skill/tools/node_modules/undici/lib/handler/deduplication-handler.js +540 -0
  237. package/skill/tools/node_modules/undici/lib/handler/redirect-handler.js +284 -0
  238. package/skill/tools/node_modules/undici/lib/handler/retry-handler.js +686 -0
  239. package/skill/tools/node_modules/undici/lib/interceptor/cache.js +771 -0
  240. package/skill/tools/node_modules/undici/lib/interceptor/decompress.js +574 -0
  241. package/skill/tools/node_modules/undici/lib/interceptor/deduplicate.js +118 -0
  242. package/skill/tools/node_modules/undici/lib/interceptor/dns.js +593 -0
  243. package/skill/tools/node_modules/undici/lib/interceptor/dump.js +99 -0
  244. package/skill/tools/node_modules/undici/lib/interceptor/redirect.js +21 -0
  245. package/skill/tools/node_modules/undici/lib/interceptor/response-error.js +139 -0
  246. package/skill/tools/node_modules/undici/lib/interceptor/retry.js +19 -0
  247. package/skill/tools/node_modules/undici/lib/llhttp/constants.d.ts +195 -0
  248. package/skill/tools/node_modules/undici/lib/llhttp/constants.js +531 -0
  249. package/skill/tools/node_modules/undici/lib/llhttp/llhttp-wasm.js +15 -0
  250. package/skill/tools/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +15 -0
  251. package/skill/tools/node_modules/undici/lib/llhttp/utils.d.ts +2 -0
  252. package/skill/tools/node_modules/undici/lib/llhttp/utils.js +12 -0
  253. package/skill/tools/node_modules/undici/lib/milo/LICENSE.md +7 -0
  254. package/skill/tools/node_modules/undici/lib/milo/no-simd.js +1002 -0
  255. package/skill/tools/node_modules/undici/lib/milo/simd.js +1002 -0
  256. package/skill/tools/node_modules/undici/lib/mock/mock-agent.js +255 -0
  257. package/skill/tools/node_modules/undici/lib/mock/mock-call-history.js +248 -0
  258. package/skill/tools/node_modules/undici/lib/mock/mock-client.js +68 -0
  259. package/skill/tools/node_modules/undici/lib/mock/mock-errors.js +29 -0
  260. package/skill/tools/node_modules/undici/lib/mock/mock-interceptor.js +227 -0
  261. package/skill/tools/node_modules/undici/lib/mock/mock-pool.js +68 -0
  262. package/skill/tools/node_modules/undici/lib/mock/mock-symbols.js +32 -0
  263. package/skill/tools/node_modules/undici/lib/mock/mock-utils.js +730 -0
  264. package/skill/tools/node_modules/undici/lib/mock/pending-interceptors-formatter.js +43 -0
  265. package/skill/tools/node_modules/undici/lib/mock/snapshot-agent.js +371 -0
  266. package/skill/tools/node_modules/undici/lib/mock/snapshot-recorder.js +624 -0
  267. package/skill/tools/node_modules/undici/lib/mock/snapshot-utils.js +159 -0
  268. package/skill/tools/node_modules/undici/lib/util/cache.js +764 -0
  269. package/skill/tools/node_modules/undici/lib/util/date.js +670 -0
  270. package/skill/tools/node_modules/undici/lib/util/runtime-features.js +93 -0
  271. package/skill/tools/node_modules/undici/lib/util/stats.js +32 -0
  272. package/skill/tools/node_modules/undici/lib/util/timers.js +425 -0
  273. package/skill/tools/node_modules/undici/lib/web/cache/cache.js +871 -0
  274. package/skill/tools/node_modules/undici/lib/web/cache/cachestorage.js +158 -0
  275. package/skill/tools/node_modules/undici/lib/web/cache/util.js +45 -0
  276. package/skill/tools/node_modules/undici/lib/web/cookies/constants.js +12 -0
  277. package/skill/tools/node_modules/undici/lib/web/cookies/index.js +211 -0
  278. package/skill/tools/node_modules/undici/lib/web/cookies/parse.js +318 -0
  279. package/skill/tools/node_modules/undici/lib/web/cookies/util.js +371 -0
  280. package/skill/tools/node_modules/undici/lib/web/eventsource/eventsource-stream.js +575 -0
  281. package/skill/tools/node_modules/undici/lib/web/eventsource/eventsource.js +547 -0
  282. package/skill/tools/node_modules/undici/lib/web/eventsource/util.js +60 -0
  283. package/skill/tools/node_modules/undici/lib/web/fetch/LICENSE +21 -0
  284. package/skill/tools/node_modules/undici/lib/web/fetch/body.js +583 -0
  285. package/skill/tools/node_modules/undici/lib/web/fetch/constants.js +131 -0
  286. package/skill/tools/node_modules/undici/lib/web/fetch/data-url.js +596 -0
  287. package/skill/tools/node_modules/undici/lib/web/fetch/formdata-parser.js +594 -0
  288. package/skill/tools/node_modules/undici/lib/web/fetch/formdata.js +272 -0
  289. package/skill/tools/node_modules/undici/lib/web/fetch/global.js +40 -0
  290. package/skill/tools/node_modules/undici/lib/web/fetch/headers.js +722 -0
  291. package/skill/tools/node_modules/undici/lib/web/fetch/index.js +2451 -0
  292. package/skill/tools/node_modules/undici/lib/web/fetch/request.js +1117 -0
  293. package/skill/tools/node_modules/undici/lib/web/fetch/response.js +638 -0
  294. package/skill/tools/node_modules/undici/lib/web/fetch/util.js +1530 -0
  295. package/skill/tools/node_modules/undici/lib/web/infra/index.js +244 -0
  296. package/skill/tools/node_modules/undici/lib/web/subresource-integrity/Readme.md +9 -0
  297. package/skill/tools/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +307 -0
  298. package/skill/tools/node_modules/undici/lib/web/webidl/index.js +992 -0
  299. package/skill/tools/node_modules/undici/lib/web/websocket/connection.js +350 -0
  300. package/skill/tools/node_modules/undici/lib/web/websocket/constants.js +126 -0
  301. package/skill/tools/node_modules/undici/lib/web/websocket/events.js +348 -0
  302. package/skill/tools/node_modules/undici/lib/web/websocket/frame.js +127 -0
  303. package/skill/tools/node_modules/undici/lib/web/websocket/permessage-deflate.js +105 -0
  304. package/skill/tools/node_modules/undici/lib/web/websocket/receiver.js +530 -0
  305. package/skill/tools/node_modules/undici/lib/web/websocket/sender.js +109 -0
  306. package/skill/tools/node_modules/undici/lib/web/websocket/stream/websocketerror.js +107 -0
  307. package/skill/tools/node_modules/undici/lib/web/websocket/stream/websocketstream.js +511 -0
  308. package/skill/tools/node_modules/undici/lib/web/websocket/util.js +347 -0
  309. package/skill/tools/node_modules/undici/lib/web/websocket/websocket.js +783 -0
  310. package/skill/tools/node_modules/undici/package.json +154 -0
  311. package/skill/tools/node_modules/undici/scripts/strip-comments.js +10 -0
  312. package/skill/tools/node_modules/undici/types/README.md +6 -0
  313. package/skill/tools/node_modules/undici/types/agent.d.ts +30 -0
  314. package/skill/tools/node_modules/undici/types/api.d.ts +43 -0
  315. package/skill/tools/node_modules/undici/types/balanced-pool.d.ts +30 -0
  316. package/skill/tools/node_modules/undici/types/cache-interceptor.d.ts +189 -0
  317. package/skill/tools/node_modules/undici/types/cache.d.ts +36 -0
  318. package/skill/tools/node_modules/undici/types/client-stats.d.ts +15 -0
  319. package/skill/tools/node_modules/undici/types/client.d.ts +190 -0
  320. package/skill/tools/node_modules/undici/types/connector.d.ts +37 -0
  321. package/skill/tools/node_modules/undici/types/content-type.d.ts +21 -0
  322. package/skill/tools/node_modules/undici/types/cookies.d.ts +30 -0
  323. package/skill/tools/node_modules/undici/types/diagnostics-channel.d.ts +75 -0
  324. package/skill/tools/node_modules/undici/types/dispatcher.d.ts +253 -0
  325. package/skill/tools/node_modules/undici/types/dispatcher1-wrapper.d.ts +7 -0
  326. package/skill/tools/node_modules/undici/types/env-http-proxy-agent.d.ts +22 -0
  327. package/skill/tools/node_modules/undici/types/errors.d.ts +202 -0
  328. package/skill/tools/node_modules/undici/types/eventsource.d.ts +66 -0
  329. package/skill/tools/node_modules/undici/types/fetch.d.ts +235 -0
  330. package/skill/tools/node_modules/undici/types/formdata.d.ts +108 -0
  331. package/skill/tools/node_modules/undici/types/global-dispatcher.d.ts +9 -0
  332. package/skill/tools/node_modules/undici/types/global-origin.d.ts +7 -0
  333. package/skill/tools/node_modules/undici/types/h2c-client.d.ts +73 -0
  334. package/skill/tools/node_modules/undici/types/handlers.d.ts +16 -0
  335. package/skill/tools/node_modules/undici/types/header.d.ts +165 -0
  336. package/skill/tools/node_modules/undici/types/index.d.ts +93 -0
  337. package/skill/tools/node_modules/undici/types/interceptors.d.ts +87 -0
  338. package/skill/tools/node_modules/undici/types/mock-agent.d.ts +69 -0
  339. package/skill/tools/node_modules/undici/types/mock-call-history.d.ts +111 -0
  340. package/skill/tools/node_modules/undici/types/mock-client.d.ts +27 -0
  341. package/skill/tools/node_modules/undici/types/mock-errors.d.ts +12 -0
  342. package/skill/tools/node_modules/undici/types/mock-interceptor.d.ts +98 -0
  343. package/skill/tools/node_modules/undici/types/mock-pool.d.ts +27 -0
  344. package/skill/tools/node_modules/undici/types/patch.d.ts +29 -0
  345. package/skill/tools/node_modules/undici/types/pool-stats.d.ts +19 -0
  346. package/skill/tools/node_modules/undici/types/pool.d.ts +39 -0
  347. package/skill/tools/node_modules/undici/types/proxy-agent.d.ts +36 -0
  348. package/skill/tools/node_modules/undici/types/readable.d.ts +68 -0
  349. package/skill/tools/node_modules/undici/types/retry-agent.d.ts +8 -0
  350. package/skill/tools/node_modules/undici/types/retry-handler.d.ts +125 -0
  351. package/skill/tools/node_modules/undici/types/round-robin-pool.d.ts +39 -0
  352. package/skill/tools/node_modules/undici/types/snapshot-agent.d.ts +113 -0
  353. package/skill/tools/node_modules/undici/types/socks5-proxy-agent.d.ts +27 -0
  354. package/skill/tools/node_modules/undici/types/util.d.ts +18 -0
  355. package/skill/tools/node_modules/undici/types/utility.d.ts +7 -0
  356. package/skill/tools/node_modules/undici/types/webidl.d.ts +352 -0
  357. package/skill/tools/node_modules/undici/types/websocket.d.ts +188 -0
  358. package/skill/tools/node_modules/xtend/.jshintrc +30 -0
  359. package/skill/tools/node_modules/xtend/LICENSE +20 -0
  360. package/skill/tools/node_modules/xtend/README.md +32 -0
  361. package/skill/tools/node_modules/xtend/immutable.js +19 -0
  362. package/skill/tools/node_modules/xtend/mutable.js +17 -0
  363. package/skill/tools/node_modules/xtend/package.json +55 -0
  364. package/skill/tools/node_modules/xtend/test.js +103 -0
  365. package/skill/tools/package-lock.json +172 -0
  366. package/skill/tools/package.json +9 -0
  367. 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
+