cloudstructs 0.9.37 → 0.9.38

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 (231) hide show
  1. package/.jsii +3 -3
  2. package/assets/slack-app/provider.lambda/index.js +26 -26
  3. package/assets/slack-textract/detect.lambda/index.js +140 -122
  4. package/assets/ssl-server-test/analyze.lambda/index.js +26 -26
  5. package/lib/codecommit-mirror/index.js +2 -2
  6. package/lib/dmarc/index.js +1 -1
  7. package/lib/ecs-service-roller/index.js +2 -2
  8. package/lib/email-receiver/receiver.js +1 -1
  9. package/lib/mjml-template/index.js +1 -1
  10. package/lib/saml-identity-provider/index.js +2 -2
  11. package/lib/slack-app/manifest.js +1 -1
  12. package/lib/slack-app/slack-app.js +2 -2
  13. package/lib/slack-events/index.js +1 -1
  14. package/lib/slack-textract/index.js +1 -1
  15. package/lib/ssl-server-test/index.js +1 -1
  16. package/lib/state-machine-cr-provider/index.js +1 -1
  17. package/lib/static-website/index.js +1 -1
  18. package/lib/toolkit-cleaner/index.js +1 -1
  19. package/lib/url-shortener/index.js +1 -1
  20. package/node_modules/@babel/runtime/helpers/esm/regeneratorDefine.js +7 -9
  21. package/node_modules/@babel/runtime/helpers/regeneratorDefine.js +7 -9
  22. package/node_modules/@babel/runtime/package.json +1 -1
  23. package/node_modules/@slack/logger/node_modules/@types/node/README.md +2 -2
  24. package/node_modules/@slack/logger/node_modules/@types/node/buffer.d.ts +3 -0
  25. package/node_modules/@slack/logger/node_modules/@types/node/child_process.d.ts +25 -121
  26. package/node_modules/@slack/logger/node_modules/@types/node/crypto.d.ts +17 -1
  27. package/node_modules/@slack/logger/node_modules/@types/node/dns/promises.d.ts +11 -10
  28. package/node_modules/@slack/logger/node_modules/@types/node/dns.d.ts +18 -19
  29. package/node_modules/@slack/logger/node_modules/@types/node/fs/promises.d.ts +26 -29
  30. package/node_modules/@slack/logger/node_modules/@types/node/fs.d.ts +26 -32
  31. package/node_modules/@slack/logger/node_modules/@types/node/http.d.ts +4 -19
  32. package/node_modules/@slack/logger/node_modules/@types/node/http2.d.ts +13 -11
  33. package/node_modules/@slack/logger/node_modules/@types/node/inspector.d.ts +219 -6
  34. package/node_modules/@slack/logger/node_modules/@types/node/module.d.ts +24 -0
  35. package/node_modules/@slack/logger/node_modules/@types/node/package.json +4 -89
  36. package/node_modules/@slack/logger/node_modules/@types/node/perf_hooks.d.ts +14 -0
  37. package/node_modules/@slack/logger/node_modules/@types/node/repl.d.ts +11 -1
  38. package/node_modules/@slack/logger/node_modules/@types/node/sqlite.d.ts +0 -1
  39. package/node_modules/@slack/logger/node_modules/@types/node/stream/web.d.ts +4 -0
  40. package/node_modules/@slack/logger/node_modules/@types/node/stream.d.ts +17 -6
  41. package/node_modules/@slack/logger/node_modules/@types/node/test.d.ts +120 -1
  42. package/node_modules/@slack/logger/node_modules/@types/node/timers.d.ts +0 -2
  43. package/node_modules/@slack/logger/node_modules/@types/node/url.d.ts +12 -1
  44. package/node_modules/@slack/logger/node_modules/@types/node/util.d.ts +6 -2
  45. package/node_modules/@slack/logger/node_modules/@types/node/worker_threads.d.ts +12 -0
  46. package/node_modules/@slack/logger/node_modules/@types/node/zlib.d.ts +8 -2
  47. package/node_modules/@slack/logger/node_modules/undici-types/agent.d.ts +4 -0
  48. package/node_modules/@slack/logger/node_modules/undici-types/client-stats.d.ts +15 -0
  49. package/node_modules/@slack/logger/node_modules/undici-types/client.d.ts +6 -3
  50. package/node_modules/@slack/logger/node_modules/undici-types/mock-agent.d.ts +3 -0
  51. package/node_modules/@slack/logger/node_modules/undici-types/package.json +1 -1
  52. package/node_modules/@slack/logger/node_modules/undici-types/pool.d.ts +2 -0
  53. package/node_modules/@slack/logger/node_modules/undici-types/proxy-agent.d.ts +1 -0
  54. package/node_modules/@slack/types/dist/block-kit/blocks.d.ts +5 -1
  55. package/node_modules/@slack/types/dist/block-kit/blocks.d.ts.map +1 -1
  56. package/node_modules/@slack/types/dist/events/index.d.ts +3 -3
  57. package/node_modules/@slack/types/dist/events/index.d.ts.map +1 -1
  58. package/node_modules/@slack/types/dist/events/index.js +1 -1
  59. package/node_modules/@slack/types/dist/events/index.js.map +1 -1
  60. package/node_modules/@slack/types/dist/events/message.d.ts +1 -0
  61. package/node_modules/@slack/types/dist/events/message.d.ts.map +1 -1
  62. package/node_modules/@slack/types/dist/events/team.d.ts +2 -2
  63. package/node_modules/@slack/types/dist/events/team.d.ts.map +1 -1
  64. package/node_modules/@slack/types/dist/index.d.ts +5 -5
  65. package/node_modules/@slack/types/dist/index.d.ts.map +1 -1
  66. package/node_modules/@slack/types/dist/index.js +5 -5
  67. package/node_modules/@slack/types/dist/index.js.map +1 -1
  68. package/node_modules/@slack/types/package.json +16 -8
  69. package/node_modules/@slack/web-api/node_modules/@types/node/README.md +2 -2
  70. package/node_modules/@slack/web-api/node_modules/@types/node/buffer.d.ts +3 -0
  71. package/node_modules/@slack/web-api/node_modules/@types/node/child_process.d.ts +25 -121
  72. package/node_modules/@slack/web-api/node_modules/@types/node/crypto.d.ts +17 -1
  73. package/node_modules/@slack/web-api/node_modules/@types/node/dns/promises.d.ts +11 -10
  74. package/node_modules/@slack/web-api/node_modules/@types/node/dns.d.ts +18 -19
  75. package/node_modules/@slack/web-api/node_modules/@types/node/fs/promises.d.ts +26 -29
  76. package/node_modules/@slack/web-api/node_modules/@types/node/fs.d.ts +26 -32
  77. package/node_modules/@slack/web-api/node_modules/@types/node/http.d.ts +4 -19
  78. package/node_modules/@slack/web-api/node_modules/@types/node/http2.d.ts +13 -11
  79. package/node_modules/@slack/web-api/node_modules/@types/node/inspector.d.ts +219 -6
  80. package/node_modules/@slack/web-api/node_modules/@types/node/module.d.ts +24 -0
  81. package/node_modules/@slack/web-api/node_modules/@types/node/package.json +4 -89
  82. package/node_modules/@slack/web-api/node_modules/@types/node/perf_hooks.d.ts +14 -0
  83. package/node_modules/@slack/web-api/node_modules/@types/node/repl.d.ts +11 -1
  84. package/node_modules/@slack/web-api/node_modules/@types/node/sqlite.d.ts +0 -1
  85. package/node_modules/@slack/web-api/node_modules/@types/node/stream/web.d.ts +4 -0
  86. package/node_modules/@slack/web-api/node_modules/@types/node/stream.d.ts +17 -6
  87. package/node_modules/@slack/web-api/node_modules/@types/node/test.d.ts +120 -1
  88. package/node_modules/@slack/web-api/node_modules/@types/node/timers.d.ts +0 -2
  89. package/node_modules/@slack/web-api/node_modules/@types/node/url.d.ts +12 -1
  90. package/node_modules/@slack/web-api/node_modules/@types/node/util.d.ts +6 -2
  91. package/node_modules/@slack/web-api/node_modules/@types/node/worker_threads.d.ts +12 -0
  92. package/node_modules/@slack/web-api/node_modules/@types/node/zlib.d.ts +8 -2
  93. package/node_modules/@slack/web-api/node_modules/undici-types/agent.d.ts +4 -0
  94. package/node_modules/@slack/web-api/node_modules/undici-types/client-stats.d.ts +15 -0
  95. package/node_modules/@slack/web-api/node_modules/undici-types/client.d.ts +6 -3
  96. package/node_modules/@slack/web-api/node_modules/undici-types/mock-agent.d.ts +3 -0
  97. package/node_modules/@slack/web-api/node_modules/undici-types/package.json +1 -1
  98. package/node_modules/@slack/web-api/node_modules/undici-types/pool.d.ts +2 -0
  99. package/node_modules/@slack/web-api/node_modules/undici-types/proxy-agent.d.ts +1 -0
  100. package/node_modules/@types/cacheable-request/node_modules/@types/node/README.md +2 -2
  101. package/node_modules/@types/cacheable-request/node_modules/@types/node/buffer.d.ts +3 -0
  102. package/node_modules/@types/cacheable-request/node_modules/@types/node/child_process.d.ts +25 -121
  103. package/node_modules/@types/cacheable-request/node_modules/@types/node/crypto.d.ts +17 -1
  104. package/node_modules/@types/cacheable-request/node_modules/@types/node/dns/promises.d.ts +11 -10
  105. package/node_modules/@types/cacheable-request/node_modules/@types/node/dns.d.ts +18 -19
  106. package/node_modules/@types/cacheable-request/node_modules/@types/node/fs/promises.d.ts +26 -29
  107. package/node_modules/@types/cacheable-request/node_modules/@types/node/fs.d.ts +26 -32
  108. package/node_modules/@types/cacheable-request/node_modules/@types/node/http.d.ts +4 -19
  109. package/node_modules/@types/cacheable-request/node_modules/@types/node/http2.d.ts +13 -11
  110. package/node_modules/@types/cacheable-request/node_modules/@types/node/inspector.d.ts +219 -6
  111. package/node_modules/@types/cacheable-request/node_modules/@types/node/module.d.ts +24 -0
  112. package/node_modules/@types/cacheable-request/node_modules/@types/node/package.json +4 -89
  113. package/node_modules/@types/cacheable-request/node_modules/@types/node/perf_hooks.d.ts +14 -0
  114. package/node_modules/@types/cacheable-request/node_modules/@types/node/repl.d.ts +11 -1
  115. package/node_modules/@types/cacheable-request/node_modules/@types/node/sqlite.d.ts +0 -1
  116. package/node_modules/@types/cacheable-request/node_modules/@types/node/stream/web.d.ts +4 -0
  117. package/node_modules/@types/cacheable-request/node_modules/@types/node/stream.d.ts +17 -6
  118. package/node_modules/@types/cacheable-request/node_modules/@types/node/test.d.ts +120 -1
  119. package/node_modules/@types/cacheable-request/node_modules/@types/node/timers.d.ts +0 -2
  120. package/node_modules/@types/cacheable-request/node_modules/@types/node/url.d.ts +12 -1
  121. package/node_modules/@types/cacheable-request/node_modules/@types/node/util.d.ts +6 -2
  122. package/node_modules/@types/cacheable-request/node_modules/@types/node/worker_threads.d.ts +12 -0
  123. package/node_modules/@types/cacheable-request/node_modules/@types/node/zlib.d.ts +8 -2
  124. package/node_modules/@types/cacheable-request/node_modules/undici-types/agent.d.ts +4 -0
  125. package/node_modules/@types/cacheable-request/node_modules/undici-types/client-stats.d.ts +15 -0
  126. package/node_modules/@types/cacheable-request/node_modules/undici-types/client.d.ts +6 -3
  127. package/node_modules/@types/cacheable-request/node_modules/undici-types/mock-agent.d.ts +3 -0
  128. package/node_modules/@types/cacheable-request/node_modules/undici-types/package.json +1 -1
  129. package/node_modules/@types/cacheable-request/node_modules/undici-types/pool.d.ts +2 -0
  130. package/node_modules/@types/cacheable-request/node_modules/undici-types/proxy-agent.d.ts +1 -0
  131. package/node_modules/@types/keyv/node_modules/@types/node/README.md +2 -2
  132. package/node_modules/@types/keyv/node_modules/@types/node/buffer.d.ts +3 -0
  133. package/node_modules/@types/keyv/node_modules/@types/node/child_process.d.ts +25 -121
  134. package/node_modules/@types/keyv/node_modules/@types/node/crypto.d.ts +17 -1
  135. package/node_modules/@types/keyv/node_modules/@types/node/dns/promises.d.ts +11 -10
  136. package/node_modules/@types/keyv/node_modules/@types/node/dns.d.ts +18 -19
  137. package/node_modules/@types/keyv/node_modules/@types/node/fs/promises.d.ts +26 -29
  138. package/node_modules/@types/keyv/node_modules/@types/node/fs.d.ts +26 -32
  139. package/node_modules/@types/keyv/node_modules/@types/node/http.d.ts +4 -19
  140. package/node_modules/@types/keyv/node_modules/@types/node/http2.d.ts +13 -11
  141. package/node_modules/@types/keyv/node_modules/@types/node/inspector.d.ts +219 -6
  142. package/node_modules/@types/keyv/node_modules/@types/node/module.d.ts +24 -0
  143. package/node_modules/@types/keyv/node_modules/@types/node/package.json +4 -89
  144. package/node_modules/@types/keyv/node_modules/@types/node/perf_hooks.d.ts +14 -0
  145. package/node_modules/@types/keyv/node_modules/@types/node/repl.d.ts +11 -1
  146. package/node_modules/@types/keyv/node_modules/@types/node/sqlite.d.ts +0 -1
  147. package/node_modules/@types/keyv/node_modules/@types/node/stream/web.d.ts +4 -0
  148. package/node_modules/@types/keyv/node_modules/@types/node/stream.d.ts +17 -6
  149. package/node_modules/@types/keyv/node_modules/@types/node/test.d.ts +120 -1
  150. package/node_modules/@types/keyv/node_modules/@types/node/timers.d.ts +0 -2
  151. package/node_modules/@types/keyv/node_modules/@types/node/url.d.ts +12 -1
  152. package/node_modules/@types/keyv/node_modules/@types/node/util.d.ts +6 -2
  153. package/node_modules/@types/keyv/node_modules/@types/node/worker_threads.d.ts +12 -0
  154. package/node_modules/@types/keyv/node_modules/@types/node/zlib.d.ts +8 -2
  155. package/node_modules/@types/keyv/node_modules/undici-types/agent.d.ts +4 -0
  156. package/node_modules/@types/keyv/node_modules/undici-types/client-stats.d.ts +15 -0
  157. package/node_modules/@types/keyv/node_modules/undici-types/client.d.ts +6 -3
  158. package/node_modules/@types/keyv/node_modules/undici-types/mock-agent.d.ts +3 -0
  159. package/node_modules/@types/keyv/node_modules/undici-types/package.json +1 -1
  160. package/node_modules/@types/keyv/node_modules/undici-types/pool.d.ts +2 -0
  161. package/node_modules/@types/keyv/node_modules/undici-types/proxy-agent.d.ts +1 -0
  162. package/node_modules/@types/responselike/node_modules/@types/node/README.md +2 -2
  163. package/node_modules/@types/responselike/node_modules/@types/node/buffer.d.ts +3 -0
  164. package/node_modules/@types/responselike/node_modules/@types/node/child_process.d.ts +25 -121
  165. package/node_modules/@types/responselike/node_modules/@types/node/crypto.d.ts +17 -1
  166. package/node_modules/@types/responselike/node_modules/@types/node/dns/promises.d.ts +11 -10
  167. package/node_modules/@types/responselike/node_modules/@types/node/dns.d.ts +18 -19
  168. package/node_modules/@types/responselike/node_modules/@types/node/fs/promises.d.ts +26 -29
  169. package/node_modules/@types/responselike/node_modules/@types/node/fs.d.ts +26 -32
  170. package/node_modules/@types/responselike/node_modules/@types/node/http.d.ts +4 -19
  171. package/node_modules/@types/responselike/node_modules/@types/node/http2.d.ts +13 -11
  172. package/node_modules/@types/responselike/node_modules/@types/node/inspector.d.ts +219 -6
  173. package/node_modules/@types/responselike/node_modules/@types/node/module.d.ts +24 -0
  174. package/node_modules/@types/responselike/node_modules/@types/node/package.json +4 -89
  175. package/node_modules/@types/responselike/node_modules/@types/node/perf_hooks.d.ts +14 -0
  176. package/node_modules/@types/responselike/node_modules/@types/node/repl.d.ts +11 -1
  177. package/node_modules/@types/responselike/node_modules/@types/node/sqlite.d.ts +0 -1
  178. package/node_modules/@types/responselike/node_modules/@types/node/stream/web.d.ts +4 -0
  179. package/node_modules/@types/responselike/node_modules/@types/node/stream.d.ts +17 -6
  180. package/node_modules/@types/responselike/node_modules/@types/node/test.d.ts +120 -1
  181. package/node_modules/@types/responselike/node_modules/@types/node/timers.d.ts +0 -2
  182. package/node_modules/@types/responselike/node_modules/@types/node/url.d.ts +12 -1
  183. package/node_modules/@types/responselike/node_modules/@types/node/util.d.ts +6 -2
  184. package/node_modules/@types/responselike/node_modules/@types/node/worker_threads.d.ts +12 -0
  185. package/node_modules/@types/responselike/node_modules/@types/node/zlib.d.ts +8 -2
  186. package/node_modules/@types/responselike/node_modules/undici-types/agent.d.ts +4 -0
  187. package/node_modules/@types/responselike/node_modules/undici-types/client-stats.d.ts +15 -0
  188. package/node_modules/@types/responselike/node_modules/undici-types/client.d.ts +6 -3
  189. package/node_modules/@types/responselike/node_modules/undici-types/mock-agent.d.ts +3 -0
  190. package/node_modules/@types/responselike/node_modules/undici-types/package.json +1 -1
  191. package/node_modules/@types/responselike/node_modules/undici-types/pool.d.ts +2 -0
  192. package/node_modules/@types/responselike/node_modules/undici-types/proxy-agent.d.ts +1 -0
  193. package/node_modules/axios/CHANGELOG.md +17 -0
  194. package/node_modules/axios/README.md +1 -4
  195. package/node_modules/axios/dist/axios.js +39 -5
  196. package/node_modules/axios/dist/axios.js.map +1 -1
  197. package/node_modules/axios/dist/axios.min.js +2 -2
  198. package/node_modules/axios/dist/axios.min.js.map +1 -1
  199. package/node_modules/axios/dist/browser/axios.cjs +46 -9
  200. package/node_modules/axios/dist/browser/axios.cjs.map +1 -1
  201. package/node_modules/axios/dist/esm/axios.js +46 -9
  202. package/node_modules/axios/dist/esm/axios.js.map +1 -1
  203. package/node_modules/axios/dist/esm/axios.min.js +2 -2
  204. package/node_modules/axios/dist/esm/axios.min.js.map +1 -1
  205. package/node_modules/axios/dist/node/axios.cjs +46 -9
  206. package/node_modules/axios/dist/node/axios.cjs.map +1 -1
  207. package/node_modules/axios/index.d.cts +13 -2
  208. package/node_modules/axios/lib/core/Axios.js +2 -2
  209. package/node_modules/axios/lib/core/mergeConfig.js +1 -1
  210. package/node_modules/axios/lib/env/data.js +1 -1
  211. package/node_modules/axios/lib/helpers/throttle.js +1 -1
  212. package/node_modules/axios/lib/helpers/toURLEncodedForm.js +4 -3
  213. package/node_modules/axios/lib/utils.js +36 -0
  214. package/node_modules/axios/package.json +5 -5
  215. package/node_modules/follow-redirects/package.json +1 -1
  216. package/node_modules/form-data/CHANGELOG.md +601 -0
  217. package/node_modules/form-data/{README.md.bak → README.md} +4 -4
  218. package/node_modules/form-data/lib/form_data.js +2 -6
  219. package/node_modules/form-data/package.json +22 -6
  220. package/package.json +18 -18
  221. package/node_modules/@slack/logger/node_modules/@types/node/ts5.1/compatibility/disposable.d.ts +0 -12
  222. package/node_modules/@slack/logger/node_modules/@types/node/ts5.1/index.d.ts +0 -98
  223. package/node_modules/@slack/web-api/node_modules/@types/node/ts5.1/compatibility/disposable.d.ts +0 -12
  224. package/node_modules/@slack/web-api/node_modules/@types/node/ts5.1/index.d.ts +0 -98
  225. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts5.1/compatibility/disposable.d.ts +0 -12
  226. package/node_modules/@types/cacheable-request/node_modules/@types/node/ts5.1/index.d.ts +0 -98
  227. package/node_modules/@types/keyv/node_modules/@types/node/ts5.1/compatibility/disposable.d.ts +0 -12
  228. package/node_modules/@types/keyv/node_modules/@types/node/ts5.1/index.d.ts +0 -98
  229. package/node_modules/@types/responselike/node_modules/@types/node/ts5.1/compatibility/disposable.d.ts +0 -12
  230. package/node_modules/@types/responselike/node_modules/@types/node/ts5.1/index.d.ts +0 -98
  231. package/node_modules/form-data/Readme.md +0 -355
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "undici-types",
3
- "version": "7.8.0",
3
+ "version": "7.10.0",
4
4
  "description": "A stand-alone types package for Undici",
5
5
  "homepage": "https://undici.nodejs.org",
6
6
  "bugs": {
@@ -33,6 +33,8 @@ declare namespace Pool {
33
33
  factory?(origin: URL, opts: object): Dispatcher;
34
34
  /** The max number of clients to create. `null` if no limit. Default `null`. */
35
35
  connections?: number | null;
36
+ /** The amount of time before a client is removed from the pool and closed. `null` if no time limit. Default `null` */
37
+ clientTtl?: number | null;
36
38
 
37
39
  interceptors?: { Pool?: readonly Dispatcher.DispatchInterceptor[] } & Client.Options['interceptors']
38
40
  }
@@ -24,5 +24,6 @@ declare namespace ProxyAgent {
24
24
  requestTls?: buildConnector.BuildOptions;
25
25
  proxyTls?: buildConnector.BuildOptions;
26
26
  clientFactory?(origin: URL, opts: object): Dispatcher;
27
+ proxyTunnel?: boolean;
27
28
  }
28
29
  }
@@ -8,8 +8,8 @@ This package contains type definitions for node (https://nodejs.org/).
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Tue, 01 Jul 2025 20:02:28 GMT
11
+ * Last updated: Fri, 15 Aug 2025 08:39:32 GMT
12
12
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
13
13
 
14
14
  # Credits
15
- These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Alvis HT Tang](https://github.com/alvis), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [Chigozirim C.](https://github.com/smac89), [David Junger](https://github.com/touffy), [Deividas Bakanas](https://github.com/DeividasBakanas), [Eugene Y. Q. Shen](https://github.com/eyqs), [Hannes Magnusson](https://github.com/Hannes-Magnusson-CK), [Huw](https://github.com/hoo29), [Kelvin Jin](https://github.com/kjin), [Klaus Meinhardt](https://github.com/ajafff), [Lishude](https://github.com/islishude), [Mariusz Wiktorczyk](https://github.com/mwiktorczyk), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Parambir Singh](https://github.com/parambirs), [Sebastian Silbermann](https://github.com/eps1lon), [Thomas den Hollander](https://github.com/ThomasdenH), [Wilco Bakker](https://github.com/WilcoBakker), [wwwy3y3](https://github.com/wwwy3y3), [Samuel Ainsworth](https://github.com/samuela), [Kyle Uehlein](https://github.com/kuehlein), [Thanik Bhongbhibhat](https://github.com/bhongy), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), [Dmitry Semigradsky](https://github.com/Semigradsky), [René](https://github.com/Renegade334), and [Yagiz Nizipli](https://github.com/anonrig).
15
+ These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), [Dmitry Semigradsky](https://github.com/Semigradsky), [René](https://github.com/Renegade334), and [Yagiz Nizipli](https://github.com/anonrig).
@@ -1772,6 +1772,7 @@ declare module "buffer" {
1772
1772
  * @return The index of the first occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
1773
1773
  */
1774
1774
  indexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
1775
+ indexOf(value: string | number | Uint8Array, encoding: BufferEncoding): number;
1775
1776
  /**
1776
1777
  * Identical to `buf.indexOf()`, except the last occurrence of `value` is found
1777
1778
  * rather than the first occurrence.
@@ -1840,6 +1841,7 @@ declare module "buffer" {
1840
1841
  * @return The index of the last occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
1841
1842
  */
1842
1843
  lastIndexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
1844
+ lastIndexOf(value: string | number | Uint8Array, encoding: BufferEncoding): number;
1843
1845
  /**
1844
1846
  * Equivalent to `buf.indexOf() !== -1`.
1845
1847
  *
@@ -1870,6 +1872,7 @@ declare module "buffer" {
1870
1872
  * @return `true` if `value` was found in `buf`, `false` otherwise.
1871
1873
  */
1872
1874
  includes(value: string | number | Buffer, byteOffset?: number, encoding?: BufferEncoding): boolean;
1875
+ includes(value: string | number | Buffer, encoding: BufferEncoding): boolean;
1873
1876
  }
1874
1877
  var Buffer: BufferConstructor;
1875
1878
  /**
@@ -66,7 +66,6 @@
66
66
  * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/child_process.js)
67
67
  */
68
68
  declare module "child_process" {
69
- import { ObjectEncodingOptions } from "node:fs";
70
69
  import { Abortable, EventEmitter } from "node:events";
71
70
  import * as dgram from "node:dgram";
72
71
  import * as net from "node:net";
@@ -887,12 +886,13 @@ declare module "child_process" {
887
886
  signal?: AbortSignal | undefined;
888
887
  maxBuffer?: number | undefined;
889
888
  killSignal?: NodeJS.Signals | number | undefined;
889
+ encoding?: string | null | undefined;
890
890
  }
891
891
  interface ExecOptionsWithStringEncoding extends ExecOptions {
892
- encoding: BufferEncoding;
892
+ encoding?: BufferEncoding | undefined;
893
893
  }
894
894
  interface ExecOptionsWithBufferEncoding extends ExecOptions {
895
- encoding: BufferEncoding | null; // specify `null`.
895
+ encoding: "buffer" | null; // specify `null`.
896
896
  }
897
897
  interface ExecException extends Error {
898
898
  cmd?: string | undefined;
@@ -995,38 +995,19 @@ declare module "child_process" {
995
995
  // `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
996
996
  function exec(
997
997
  command: string,
998
- options: {
999
- encoding: "buffer" | null;
1000
- } & ExecOptions,
998
+ options: ExecOptionsWithBufferEncoding,
1001
999
  callback?: (error: ExecException | null, stdout: Buffer, stderr: Buffer) => void,
1002
1000
  ): ChildProcess;
1003
- // `options` with well known `encoding` means stdout/stderr are definitely `string`.
1004
- function exec(
1005
- command: string,
1006
- options: {
1007
- encoding: BufferEncoding;
1008
- } & ExecOptions,
1009
- callback?: (error: ExecException | null, stdout: string, stderr: string) => void,
1010
- ): ChildProcess;
1011
- // `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
1012
- // There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
1013
- function exec(
1014
- command: string,
1015
- options: {
1016
- encoding: BufferEncoding;
1017
- } & ExecOptions,
1018
- callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
1019
- ): ChildProcess;
1020
- // `options` without an `encoding` means stdout/stderr are definitely `string`.
1001
+ // `options` with well-known or absent `encoding` means stdout/stderr are definitely `string`.
1021
1002
  function exec(
1022
1003
  command: string,
1023
- options: ExecOptions,
1004
+ options: ExecOptionsWithStringEncoding,
1024
1005
  callback?: (error: ExecException | null, stdout: string, stderr: string) => void,
1025
1006
  ): ChildProcess;
1026
1007
  // fallback if nothing else matches. Worst case is always `string | Buffer`.
1027
1008
  function exec(
1028
1009
  command: string,
1029
- options: (ObjectEncodingOptions & ExecOptions) | undefined | null,
1010
+ options: ExecOptions | undefined | null,
1030
1011
  callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
1031
1012
  ): ChildProcess;
1032
1013
  interface PromiseWithChild<T> extends Promise<T> {
@@ -1039,32 +1020,21 @@ declare module "child_process" {
1039
1020
  }>;
1040
1021
  function __promisify__(
1041
1022
  command: string,
1042
- options: {
1043
- encoding: "buffer" | null;
1044
- } & ExecOptions,
1023
+ options: ExecOptionsWithBufferEncoding,
1045
1024
  ): PromiseWithChild<{
1046
1025
  stdout: Buffer;
1047
1026
  stderr: Buffer;
1048
1027
  }>;
1049
1028
  function __promisify__(
1050
1029
  command: string,
1051
- options: {
1052
- encoding: BufferEncoding;
1053
- } & ExecOptions,
1030
+ options: ExecOptionsWithStringEncoding,
1054
1031
  ): PromiseWithChild<{
1055
1032
  stdout: string;
1056
1033
  stderr: string;
1057
1034
  }>;
1058
1035
  function __promisify__(
1059
1036
  command: string,
1060
- options: ExecOptions,
1061
- ): PromiseWithChild<{
1062
- stdout: string;
1063
- stderr: string;
1064
- }>;
1065
- function __promisify__(
1066
- command: string,
1067
- options?: (ObjectEncodingOptions & ExecOptions) | null,
1037
+ options: ExecOptions | undefined | null,
1068
1038
  ): PromiseWithChild<{
1069
1039
  stdout: string | Buffer;
1070
1040
  stderr: string | Buffer;
@@ -1076,16 +1046,16 @@ declare module "child_process" {
1076
1046
  windowsVerbatimArguments?: boolean | undefined;
1077
1047
  shell?: boolean | string | undefined;
1078
1048
  signal?: AbortSignal | undefined;
1049
+ encoding?: string | null | undefined;
1079
1050
  }
1080
1051
  interface ExecFileOptionsWithStringEncoding extends ExecFileOptions {
1081
- encoding: BufferEncoding;
1052
+ encoding?: BufferEncoding | undefined;
1082
1053
  }
1083
1054
  interface ExecFileOptionsWithBufferEncoding extends ExecFileOptions {
1084
1055
  encoding: "buffer" | null;
1085
1056
  }
1086
- interface ExecFileOptionsWithOtherEncoding extends ExecFileOptions {
1087
- encoding: BufferEncoding;
1088
- }
1057
+ /** @deprecated Use `ExecFileOptions` instead. */
1058
+ interface ExecFileOptionsWithOtherEncoding extends ExecFileOptions {}
1089
1059
  type ExecFileException =
1090
1060
  & Omit<ExecException, "code">
1091
1061
  & Omit<NodeJS.ErrnoException, "code">
@@ -1154,80 +1124,44 @@ declare module "child_process" {
1154
1124
  * @param args List of string arguments.
1155
1125
  * @param callback Called with the output when process terminates.
1156
1126
  */
1157
- function execFile(file: string): ChildProcess;
1158
- function execFile(
1159
- file: string,
1160
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1161
- ): ChildProcess;
1162
- function execFile(file: string, args?: readonly string[] | null): ChildProcess;
1163
- function execFile(
1164
- file: string,
1165
- args: readonly string[] | undefined | null,
1166
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1167
- ): ChildProcess;
1168
1127
  // no `options` definitely means stdout/stderr are `string`.
1169
1128
  function execFile(
1170
1129
  file: string,
1171
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1130
+ callback?: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1172
1131
  ): ChildProcess;
1173
1132
  function execFile(
1174
1133
  file: string,
1175
1134
  args: readonly string[] | undefined | null,
1176
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1135
+ callback?: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1177
1136
  ): ChildProcess;
1178
1137
  // `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
1179
1138
  function execFile(
1180
1139
  file: string,
1181
1140
  options: ExecFileOptionsWithBufferEncoding,
1182
- callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
1141
+ callback?: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
1183
1142
  ): ChildProcess;
1184
1143
  function execFile(
1185
1144
  file: string,
1186
1145
  args: readonly string[] | undefined | null,
1187
1146
  options: ExecFileOptionsWithBufferEncoding,
1188
- callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
1147
+ callback?: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
1189
1148
  ): ChildProcess;
1190
- // `options` with well known `encoding` means stdout/stderr are definitely `string`.
1149
+ // `options` with well-known or absent `encoding` means stdout/stderr are definitely `string`.
1191
1150
  function execFile(
1192
1151
  file: string,
1193
1152
  options: ExecFileOptionsWithStringEncoding,
1194
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1153
+ callback?: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1195
1154
  ): ChildProcess;
1196
1155
  function execFile(
1197
1156
  file: string,
1198
1157
  args: readonly string[] | undefined | null,
1199
1158
  options: ExecFileOptionsWithStringEncoding,
1200
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1201
- ): ChildProcess;
1202
- // `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
1203
- // There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
1204
- function execFile(
1205
- file: string,
1206
- options: ExecFileOptionsWithOtherEncoding,
1207
- callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
1208
- ): ChildProcess;
1209
- function execFile(
1210
- file: string,
1211
- args: readonly string[] | undefined | null,
1212
- options: ExecFileOptionsWithOtherEncoding,
1213
- callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
1214
- ): ChildProcess;
1215
- // `options` without an `encoding` means stdout/stderr are definitely `string`.
1216
- function execFile(
1217
- file: string,
1218
- options: ExecFileOptions,
1219
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1220
- ): ChildProcess;
1221
- function execFile(
1222
- file: string,
1223
- args: readonly string[] | undefined | null,
1224
- options: ExecFileOptions,
1225
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1159
+ callback?: (error: ExecFileException | null, stdout: string, stderr: string) => void,
1226
1160
  ): ChildProcess;
1227
1161
  // fallback if nothing else matches. Worst case is always `string | Buffer`.
1228
1162
  function execFile(
1229
1163
  file: string,
1230
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1164
+ options: ExecFileOptions | undefined | null,
1231
1165
  callback:
1232
1166
  | ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void)
1233
1167
  | undefined
@@ -1236,7 +1170,7 @@ declare module "child_process" {
1236
1170
  function execFile(
1237
1171
  file: string,
1238
1172
  args: readonly string[] | undefined | null,
1239
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1173
+ options: ExecFileOptions | undefined | null,
1240
1174
  callback:
1241
1175
  | ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void)
1242
1176
  | undefined
@@ -1286,37 +1220,7 @@ declare module "child_process" {
1286
1220
  }>;
1287
1221
  function __promisify__(
1288
1222
  file: string,
1289
- options: ExecFileOptionsWithOtherEncoding,
1290
- ): PromiseWithChild<{
1291
- stdout: string | Buffer;
1292
- stderr: string | Buffer;
1293
- }>;
1294
- function __promisify__(
1295
- file: string,
1296
- args: readonly string[] | undefined | null,
1297
- options: ExecFileOptionsWithOtherEncoding,
1298
- ): PromiseWithChild<{
1299
- stdout: string | Buffer;
1300
- stderr: string | Buffer;
1301
- }>;
1302
- function __promisify__(
1303
- file: string,
1304
- options: ExecFileOptions,
1305
- ): PromiseWithChild<{
1306
- stdout: string;
1307
- stderr: string;
1308
- }>;
1309
- function __promisify__(
1310
- file: string,
1311
- args: readonly string[] | undefined | null,
1312
- options: ExecFileOptions,
1313
- ): PromiseWithChild<{
1314
- stdout: string;
1315
- stderr: string;
1316
- }>;
1317
- function __promisify__(
1318
- file: string,
1319
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1223
+ options: ExecFileOptions | undefined | null,
1320
1224
  ): PromiseWithChild<{
1321
1225
  stdout: string | Buffer;
1322
1226
  stderr: string | Buffer;
@@ -1324,7 +1228,7 @@ declare module "child_process" {
1324
1228
  function __promisify__(
1325
1229
  file: string,
1326
1230
  args: readonly string[] | undefined | null,
1327
- options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
1231
+ options: ExecFileOptions | undefined | null,
1328
1232
  ): PromiseWithChild<{
1329
1233
  stdout: string | Buffer;
1330
1234
  stderr: string | Buffer;
@@ -3771,7 +3771,23 @@ declare module "crypto" {
3771
3771
  */
3772
3772
  checkIP(ip: string): string | undefined;
3773
3773
  /**
3774
- * Checks whether this certificate was issued by the given `otherCert`.
3774
+ * Checks whether this certificate was potentially issued by the given `otherCert`
3775
+ * by comparing the certificate metadata.
3776
+ *
3777
+ * This is useful for pruning a list of possible issuer certificates which have been
3778
+ * selected using a more rudimentary filtering routine, i.e. just based on subject
3779
+ * and issuer names.
3780
+ *
3781
+ * Finally, to verify that this certificate's signature was produced by a private key
3782
+ * corresponding to `otherCert`'s public key use `x509.verify(publicKey)`
3783
+ * with `otherCert`'s public key represented as a `KeyObject`
3784
+ * like so
3785
+ *
3786
+ * ```js
3787
+ * if (!x509.verify(otherCert.publicKey)) {
3788
+ * throw new Error('otherCert did not issue x509');
3789
+ * }
3790
+ * ```
3775
3791
  * @since v15.6.0
3776
3792
  */
3777
3793
  checkIssued(otherCert: X509Certificate): boolean;
@@ -127,24 +127,25 @@ declare module "dns/promises" {
127
127
  * @param [rrtype='A'] Resource record type.
128
128
  */
129
129
  function resolve(hostname: string): Promise<string[]>;
130
- function resolve(hostname: string, rrtype: "A"): Promise<string[]>;
131
- function resolve(hostname: string, rrtype: "AAAA"): Promise<string[]>;
130
+ function resolve(hostname: string, rrtype: "A" | "AAAA" | "CNAME" | "NS" | "PTR"): Promise<string[]>;
132
131
  function resolve(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>;
133
132
  function resolve(hostname: string, rrtype: "CAA"): Promise<CaaRecord[]>;
134
- function resolve(hostname: string, rrtype: "CNAME"): Promise<string[]>;
135
133
  function resolve(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
136
134
  function resolve(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
137
- function resolve(hostname: string, rrtype: "NS"): Promise<string[]>;
138
- function resolve(hostname: string, rrtype: "PTR"): Promise<string[]>;
139
135
  function resolve(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
140
136
  function resolve(hostname: string, rrtype: "SRV"): Promise<SrvRecord[]>;
141
137
  function resolve(hostname: string, rrtype: "TLSA"): Promise<TlsaRecord[]>;
142
138
  function resolve(hostname: string, rrtype: "TXT"): Promise<string[][]>;
143
- function resolve(
144
- hostname: string,
145
- rrtype: string,
146
- ): Promise<
147
- string[] | MxRecord[] | NaptrRecord[] | SoaRecord | SrvRecord[] | TlsaRecord[] | string[][] | AnyRecord[]
139
+ function resolve(hostname: string, rrtype: string): Promise<
140
+ | string[]
141
+ | CaaRecord[]
142
+ | MxRecord[]
143
+ | NaptrRecord[]
144
+ | SoaRecord
145
+ | SrvRecord[]
146
+ | TlsaRecord[]
147
+ | string[][]
148
+ | AnyRecord[]
148
149
  >;
149
150
  /**
150
151
  * Uses the DNS protocol to resolve IPv4 addresses (`A` records) for the `hostname`. On success, the `Promise` is resolved with an array of IPv4
@@ -250,6 +250,9 @@ declare module "dns" {
250
250
  contactemail?: string | undefined;
251
251
  contactphone?: string | undefined;
252
252
  }
253
+ export interface AnyCaaRecord extends CaaRecord {
254
+ type: "CAA";
255
+ }
253
256
  export interface MxRecord {
254
257
  priority: number;
255
258
  exchange: string;
@@ -317,6 +320,7 @@ declare module "dns" {
317
320
  export type AnyRecord =
318
321
  | AnyARecord
319
322
  | AnyAaaaRecord
323
+ | AnyCaaRecord
320
324
  | AnyCnameRecord
321
325
  | AnyMxRecord
322
326
  | AnyNaptrRecord
@@ -345,12 +349,7 @@ declare module "dns" {
345
349
  ): void;
346
350
  export function resolve(
347
351
  hostname: string,
348
- rrtype: "A",
349
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
350
- ): void;
351
- export function resolve(
352
- hostname: string,
353
- rrtype: "AAAA",
352
+ rrtype: "A" | "AAAA" | "CNAME" | "NS" | "PTR",
354
353
  callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
355
354
  ): void;
356
355
  export function resolve(
@@ -360,8 +359,8 @@ declare module "dns" {
360
359
  ): void;
361
360
  export function resolve(
362
361
  hostname: string,
363
- rrtype: "CNAME",
364
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
362
+ rrtype: "CAA",
363
+ callback: (err: NodeJS.ErrnoException | null, address: CaaRecord[]) => void,
365
364
  ): void;
366
365
  export function resolve(
367
366
  hostname: string,
@@ -373,16 +372,6 @@ declare module "dns" {
373
372
  rrtype: "NAPTR",
374
373
  callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void,
375
374
  ): void;
376
- export function resolve(
377
- hostname: string,
378
- rrtype: "NS",
379
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
380
- ): void;
381
- export function resolve(
382
- hostname: string,
383
- rrtype: "PTR",
384
- callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void,
385
- ): void;
386
375
  export function resolve(
387
376
  hostname: string,
388
377
  rrtype: "SOA",
@@ -410,6 +399,7 @@ declare module "dns" {
410
399
  err: NodeJS.ErrnoException | null,
411
400
  addresses:
412
401
  | string[]
402
+ | CaaRecord[]
413
403
  | MxRecord[]
414
404
  | NaptrRecord[]
415
405
  | SoaRecord
@@ -422,6 +412,7 @@ declare module "dns" {
422
412
  export namespace resolve {
423
413
  function __promisify__(hostname: string, rrtype?: "A" | "AAAA" | "CNAME" | "NS" | "PTR"): Promise<string[]>;
424
414
  function __promisify__(hostname: string, rrtype: "ANY"): Promise<AnyRecord[]>;
415
+ function __promisify__(hostname: string, rrtype: "CAA"): Promise<CaaRecord[]>;
425
416
  function __promisify__(hostname: string, rrtype: "MX"): Promise<MxRecord[]>;
426
417
  function __promisify__(hostname: string, rrtype: "NAPTR"): Promise<NaptrRecord[]>;
427
418
  function __promisify__(hostname: string, rrtype: "SOA"): Promise<SoaRecord>;
@@ -432,7 +423,15 @@ declare module "dns" {
432
423
  hostname: string,
433
424
  rrtype: string,
434
425
  ): Promise<
435
- string[] | MxRecord[] | NaptrRecord[] | SoaRecord | SrvRecord[] | TlsaRecord[] | string[][] | AnyRecord[]
426
+ | string[]
427
+ | CaaRecord[]
428
+ | MxRecord[]
429
+ | NaptrRecord[]
430
+ | SoaRecord
431
+ | SrvRecord[]
432
+ | TlsaRecord[]
433
+ | string[][]
434
+ | AnyRecord[]
436
435
  >;
437
436
  }
438
437
  /**
@@ -40,7 +40,7 @@ declare module "fs/promises" {
40
40
  StatsFs,
41
41
  TimeLike,
42
42
  WatchEventType,
43
- WatchOptions,
43
+ WatchOptions as _WatchOptions,
44
44
  WriteStream,
45
45
  WriteVResult,
46
46
  } from "node:fs";
@@ -88,6 +88,9 @@ declare module "fs/promises" {
88
88
  highWaterMark?: number | undefined;
89
89
  flush?: boolean | undefined;
90
90
  }
91
+ interface ReadableWebStreamOptions {
92
+ autoClose?: boolean | undefined;
93
+ }
91
94
  // TODO: Add `EventEmitter` close
92
95
  interface FileHandle {
93
96
  /**
@@ -261,7 +264,7 @@ declare module "fs/promises" {
261
264
  * close the `FileHandle` automatically. User code must still call the`fileHandle.close()` method.
262
265
  * @since v17.0.0
263
266
  */
264
- readableWebStream(): ReadableStream;
267
+ readableWebStream(options?: ReadableWebStreamOptions): ReadableStream;
265
268
  /**
266
269
  * Asynchronously reads the entire contents of a file.
267
270
  *
@@ -474,8 +477,9 @@ declare module "fs/promises" {
474
477
  */
475
478
  close(): Promise<void>;
476
479
  /**
477
- * An alias for {@link FileHandle.close()}.
478
- * @since v20.4.0
480
+ * Calls `filehandle.close()` and returns a promise that fulfills when the
481
+ * filehandle is closed.
482
+ * @since v20.4.0, v18.8.0
479
483
  */
480
484
  [Symbol.asyncDispose](): Promise<void>;
481
485
  }
@@ -1178,6 +1182,16 @@ declare module "fs/promises" {
1178
1182
  * @return Fulfills with an {fs.Dir}.
1179
1183
  */
1180
1184
  function opendir(path: PathLike, options?: OpenDirOptions): Promise<Dir>;
1185
+ interface WatchOptions extends _WatchOptions {
1186
+ maxQueue?: number | undefined;
1187
+ overflow?: "ignore" | "throw" | undefined;
1188
+ }
1189
+ interface WatchOptionsWithBufferEncoding extends WatchOptions {
1190
+ encoding: "buffer";
1191
+ }
1192
+ interface WatchOptionsWithStringEncoding extends WatchOptions {
1193
+ encoding?: BufferEncoding | undefined;
1194
+ }
1181
1195
  /**
1182
1196
  * Returns an async iterator that watches for changes on `filename`, where `filename`is either a file or a directory.
1183
1197
  *
@@ -1210,33 +1224,16 @@ declare module "fs/promises" {
1210
1224
  */
1211
1225
  function watch(
1212
1226
  filename: PathLike,
1213
- options:
1214
- | (WatchOptions & {
1215
- encoding: "buffer";
1216
- })
1217
- | "buffer",
1218
- ): AsyncIterable<FileChangeInfo<Buffer>>;
1219
- /**
1220
- * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
1221
- * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
1222
- * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
1223
- * If `encoding` is not supplied, the default of `'utf8'` is used.
1224
- * If `persistent` is not supplied, the default of `true` is used.
1225
- * If `recursive` is not supplied, the default of `false` is used.
1226
- */
1227
- function watch(filename: PathLike, options?: WatchOptions | BufferEncoding): AsyncIterable<FileChangeInfo<string>>;
1228
- /**
1229
- * Watch for changes on `filename`, where `filename` is either a file or a directory, returning an `FSWatcher`.
1230
- * @param filename A path to a file or directory. If a URL is provided, it must use the `file:` protocol.
1231
- * @param options Either the encoding for the filename provided to the listener, or an object optionally specifying encoding, persistent, and recursive options.
1232
- * If `encoding` is not supplied, the default of `'utf8'` is used.
1233
- * If `persistent` is not supplied, the default of `true` is used.
1234
- * If `recursive` is not supplied, the default of `false` is used.
1235
- */
1227
+ options?: WatchOptionsWithStringEncoding | BufferEncoding,
1228
+ ): NodeJS.AsyncIterator<FileChangeInfo<string>>;
1229
+ function watch(
1230
+ filename: PathLike,
1231
+ options: WatchOptionsWithBufferEncoding | "buffer",
1232
+ ): NodeJS.AsyncIterator<FileChangeInfo<Buffer>>;
1236
1233
  function watch(
1237
1234
  filename: PathLike,
1238
- options: WatchOptions | string,
1239
- ): AsyncIterable<FileChangeInfo<string>> | AsyncIterable<FileChangeInfo<Buffer>>;
1235
+ options: WatchOptions | BufferEncoding | "buffer",
1236
+ ): NodeJS.AsyncIterator<FileChangeInfo<string | Buffer>>;
1240
1237
  /**
1241
1238
  * Asynchronously copies the entire directory structure from `src` to `dest`,
1242
1239
  * including subdirectories and files.