@chainlink/external-adapter-framework 2.7.2 → 2.9.0

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 (175) hide show
  1. package/README.md +1 -1
  2. package/adapter/basic.js +21 -4
  3. package/adapter/basic.js.map +1 -1
  4. package/adapter/endpoint.js +13 -0
  5. package/adapter/endpoint.js.map +1 -1
  6. package/adapter/por.js +6 -6
  7. package/adapter/por.js.map +1 -1
  8. package/adapter/price.js +1 -0
  9. package/adapter/price.js.map +1 -1
  10. package/cache/local.js +5 -1
  11. package/cache/local.js.map +1 -1
  12. package/cache/redis.js +3 -1
  13. package/cache/redis.js.map +1 -1
  14. package/cache/response.js +5 -0
  15. package/cache/response.js.map +1 -1
  16. package/config/index.js +9 -6
  17. package/config/index.js.map +1 -1
  18. package/generator-adapter/node_modules/.yarn-integrity +4 -4
  19. package/generator-adapter/node_modules/@types/node/README.md +3 -3
  20. package/generator-adapter/node_modules/@types/node/assert/strict.d.ts +105 -2
  21. package/generator-adapter/node_modules/@types/node/assert.d.ts +162 -101
  22. package/generator-adapter/node_modules/@types/node/async_hooks.d.ts +25 -5
  23. package/generator-adapter/node_modules/@types/node/buffer.buffer.d.ts +9 -0
  24. package/generator-adapter/node_modules/@types/node/buffer.d.ts +9 -5
  25. package/generator-adapter/node_modules/@types/node/child_process.d.ts +67 -44
  26. package/generator-adapter/node_modules/@types/node/cluster.d.ts +19 -20
  27. package/generator-adapter/node_modules/@types/node/compatibility/iterators.d.ts +1 -0
  28. package/generator-adapter/node_modules/@types/node/console.d.ts +19 -18
  29. package/generator-adapter/node_modules/@types/node/crypto.d.ts +1247 -355
  30. package/generator-adapter/node_modules/@types/node/dgram.d.ts +10 -9
  31. package/generator-adapter/node_modules/@types/node/diagnostics_channel.d.ts +1 -3
  32. package/generator-adapter/node_modules/@types/node/dns/promises.d.ts +1 -1
  33. package/generator-adapter/node_modules/@types/node/dns.d.ts +23 -18
  34. package/generator-adapter/node_modules/@types/node/domain.d.ts +1 -1
  35. package/generator-adapter/node_modules/@types/node/events.d.ts +81 -35
  36. package/generator-adapter/node_modules/@types/node/fs/promises.d.ts +62 -22
  37. package/generator-adapter/node_modules/@types/node/fs.d.ts +364 -98
  38. package/generator-adapter/node_modules/@types/node/globals.d.ts +4 -4
  39. package/generator-adapter/node_modules/@types/node/globals.typedarray.d.ts +20 -0
  40. package/generator-adapter/node_modules/@types/node/http.d.ts +120 -32
  41. package/generator-adapter/node_modules/@types/node/http2.d.ts +185 -65
  42. package/generator-adapter/node_modules/@types/node/https.d.ts +92 -63
  43. package/generator-adapter/node_modules/@types/node/index.d.ts +10 -5
  44. package/generator-adapter/node_modules/@types/node/inspector.d.ts +277 -0
  45. package/generator-adapter/node_modules/@types/node/inspector.generated.d.ts +908 -886
  46. package/generator-adapter/node_modules/@types/node/module.d.ts +21 -18
  47. package/generator-adapter/node_modules/@types/node/net.d.ts +35 -16
  48. package/generator-adapter/node_modules/@types/node/os.d.ts +22 -10
  49. package/generator-adapter/node_modules/@types/node/package.json +13 -3
  50. package/generator-adapter/node_modules/@types/node/path.d.ts +1 -1
  51. package/generator-adapter/node_modules/@types/node/perf_hooks.d.ts +28 -16
  52. package/generator-adapter/node_modules/@types/node/process.d.ts +30 -30
  53. package/generator-adapter/node_modules/@types/node/punycode.d.ts +1 -1
  54. package/generator-adapter/node_modules/@types/node/querystring.d.ts +1 -1
  55. package/generator-adapter/node_modules/@types/node/readline/promises.d.ts +1 -1
  56. package/generator-adapter/node_modules/@types/node/readline.d.ts +13 -13
  57. package/generator-adapter/node_modules/@types/node/repl.d.ts +23 -13
  58. package/generator-adapter/node_modules/@types/node/sea.d.ts +10 -1
  59. package/generator-adapter/node_modules/@types/node/sqlite.d.ts +245 -23
  60. package/generator-adapter/node_modules/@types/node/stream/consumers.d.ts +2 -2
  61. package/generator-adapter/node_modules/@types/node/stream/web.d.ts +6 -55
  62. package/generator-adapter/node_modules/@types/node/stream.d.ts +63 -37
  63. package/generator-adapter/node_modules/@types/node/string_decoder.d.ts +3 -3
  64. package/generator-adapter/node_modules/@types/node/test.d.ts +196 -40
  65. package/generator-adapter/node_modules/@types/node/timers/promises.d.ts +1 -1
  66. package/generator-adapter/node_modules/@types/node/timers.d.ts +1 -3
  67. package/generator-adapter/node_modules/@types/node/tls.d.ts +124 -114
  68. package/generator-adapter/node_modules/@types/node/trace_events.d.ts +6 -6
  69. package/generator-adapter/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +10 -2
  70. package/generator-adapter/node_modules/@types/node/ts5.6/compatibility/float16array.d.ts +71 -0
  71. package/generator-adapter/node_modules/@types/node/ts5.6/globals.typedarray.d.ts +17 -0
  72. package/generator-adapter/node_modules/@types/node/ts5.6/index.d.ts +12 -5
  73. package/generator-adapter/node_modules/@types/node/ts5.7/compatibility/float16array.d.ts +72 -0
  74. package/generator-adapter/node_modules/@types/node/ts5.7/index.d.ts +103 -0
  75. package/generator-adapter/node_modules/@types/node/tty.d.ts +1 -1
  76. package/generator-adapter/node_modules/@types/node/url.d.ts +109 -33
  77. package/generator-adapter/node_modules/@types/node/util.d.ts +31 -305
  78. package/generator-adapter/node_modules/@types/node/v8.d.ts +41 -8
  79. package/generator-adapter/node_modules/@types/node/vm.d.ts +258 -107
  80. package/generator-adapter/node_modules/@types/node/wasi.d.ts +23 -2
  81. package/generator-adapter/node_modules/@types/node/web-globals/crypto.d.ts +32 -0
  82. package/generator-adapter/node_modules/@types/node/web-globals/events.d.ts +3 -0
  83. package/generator-adapter/node_modules/@types/node/web-globals/fetch.d.ts +4 -0
  84. package/generator-adapter/node_modules/@types/node/web-globals/navigator.d.ts +3 -0
  85. package/generator-adapter/node_modules/@types/node/web-globals/streams.d.ts +22 -0
  86. package/generator-adapter/node_modules/@types/node/worker_threads.d.ts +142 -51
  87. package/generator-adapter/node_modules/@types/node/zlib.d.ts +36 -31
  88. package/generator-adapter/node_modules/undici-types/agent.d.ts +12 -11
  89. package/generator-adapter/node_modules/undici-types/api.d.ts +24 -24
  90. package/generator-adapter/node_modules/undici-types/balanced-pool.d.ts +11 -11
  91. package/generator-adapter/node_modules/undici-types/cache-interceptor.d.ts +172 -0
  92. package/generator-adapter/node_modules/undici-types/client-stats.d.ts +15 -0
  93. package/generator-adapter/node_modules/undici-types/client.d.ts +18 -18
  94. package/generator-adapter/node_modules/undici-types/cookies.d.ts +2 -0
  95. package/generator-adapter/node_modules/undici-types/diagnostics-channel.d.ts +18 -10
  96. package/generator-adapter/node_modules/undici-types/dispatcher.d.ts +119 -99
  97. package/generator-adapter/node_modules/undici-types/env-http-proxy-agent.d.ts +4 -3
  98. package/generator-adapter/node_modules/undici-types/errors.d.ts +66 -54
  99. package/generator-adapter/node_modules/undici-types/eventsource.d.ts +9 -4
  100. package/generator-adapter/node_modules/undici-types/fetch.d.ts +18 -16
  101. package/generator-adapter/node_modules/undici-types/formdata.d.ts +7 -7
  102. package/generator-adapter/node_modules/undici-types/global-dispatcher.d.ts +4 -4
  103. package/generator-adapter/node_modules/undici-types/global-origin.d.ts +5 -5
  104. package/generator-adapter/node_modules/undici-types/h2c-client.d.ts +73 -0
  105. package/generator-adapter/node_modules/undici-types/handlers.d.ts +8 -8
  106. package/generator-adapter/node_modules/undici-types/header.d.ts +157 -1
  107. package/generator-adapter/node_modules/undici-types/index.d.ts +56 -47
  108. package/generator-adapter/node_modules/undici-types/interceptors.d.ts +30 -8
  109. package/generator-adapter/node_modules/undici-types/mock-agent.d.ts +36 -18
  110. package/generator-adapter/node_modules/undici-types/mock-call-history.d.ts +111 -0
  111. package/generator-adapter/node_modules/undici-types/mock-client.d.ts +6 -4
  112. package/generator-adapter/node_modules/undici-types/mock-errors.d.ts +3 -3
  113. package/generator-adapter/node_modules/undici-types/mock-interceptor.d.ts +21 -20
  114. package/generator-adapter/node_modules/undici-types/mock-pool.d.ts +6 -4
  115. package/generator-adapter/node_modules/undici-types/package.json +1 -1
  116. package/generator-adapter/node_modules/undici-types/patch.d.ts +0 -4
  117. package/generator-adapter/node_modules/undici-types/pool-stats.d.ts +8 -8
  118. package/generator-adapter/node_modules/undici-types/pool.d.ts +14 -12
  119. package/generator-adapter/node_modules/undici-types/proxy-agent.d.ts +5 -4
  120. package/generator-adapter/node_modules/undici-types/readable.d.ts +18 -15
  121. package/generator-adapter/node_modules/undici-types/retry-agent.d.ts +1 -1
  122. package/generator-adapter/node_modules/undici-types/retry-handler.d.ts +19 -10
  123. package/generator-adapter/node_modules/undici-types/snapshot-agent.d.ts +109 -0
  124. package/generator-adapter/node_modules/undici-types/util.d.ts +3 -3
  125. package/generator-adapter/node_modules/undici-types/utility.d.ts +7 -0
  126. package/generator-adapter/node_modules/undici-types/webidl.d.ts +142 -29
  127. package/generator-adapter/node_modules/undici-types/websocket.d.ts +38 -2
  128. package/generator-adapter/package.json +1 -1
  129. package/metrics/index.js +3 -0
  130. package/metrics/index.js.map +1 -1
  131. package/package.json +9 -9
  132. package/rate-limiting/burst.js +6 -6
  133. package/rate-limiting/burst.js.map +1 -1
  134. package/rate-limiting/fixed-interval.js +2 -3
  135. package/rate-limiting/fixed-interval.js.map +1 -1
  136. package/transports/abstract/streaming.js +7 -10
  137. package/transports/abstract/streaming.js.map +1 -1
  138. package/transports/abstract/subscription.js +4 -0
  139. package/transports/abstract/subscription.js.map +1 -1
  140. package/transports/http.js +5 -3
  141. package/transports/http.js.map +1 -1
  142. package/transports/index.js +1 -3
  143. package/transports/index.js.map +1 -1
  144. package/transports/sse.js +6 -2
  145. package/transports/sse.js.map +1 -1
  146. package/transports/websocket.d.ts +9 -1
  147. package/transports/websocket.js +41 -65
  148. package/transports/websocket.js.map +1 -1
  149. package/util/censor/censor-list.js +1 -1
  150. package/util/censor/censor-list.js.map +1 -1
  151. package/util/group-runner.js +3 -2
  152. package/util/group-runner.js.map +1 -1
  153. package/util/index.js +8 -1
  154. package/util/index.js.map +1 -1
  155. package/util/logger.js +8 -1
  156. package/util/logger.js.map +1 -1
  157. package/util/requester.js +11 -3
  158. package/util/requester.js.map +1 -1
  159. package/util/subscription-set/expiring-sorted-set.js +3 -0
  160. package/util/subscription-set/expiring-sorted-set.js.map +1 -1
  161. package/util/subscription-set/redis-sorted-set.js +3 -0
  162. package/util/subscription-set/redis-sorted-set.js.map +1 -1
  163. package/util/subscription-set/subscription-set.js +5 -0
  164. package/util/subscription-set/subscription-set.js.map +1 -1
  165. package/util/testing-utils.js +13 -6
  166. package/util/testing-utils.js.map +1 -1
  167. package/validation/error.js +13 -0
  168. package/validation/error.js.map +1 -1
  169. package/validation/input-params.js +14 -0
  170. package/validation/input-params.js.map +1 -1
  171. package/generator-adapter/node_modules/@types/node/compatibility/disposable.d.ts +0 -14
  172. package/generator-adapter/node_modules/@types/node/compatibility/index.d.ts +0 -9
  173. package/generator-adapter/node_modules/@types/node/compatibility/indexable.d.ts +0 -20
  174. package/generator-adapter/node_modules/undici-types/file.d.ts +0 -39
  175. package/generator-adapter/node_modules/undici-types/filereader.d.ts +0 -54
@@ -6,7 +6,7 @@
6
6
  * ```js
7
7
  * import util from 'node:util';
8
8
  * ```
9
- * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/util.js)
9
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/util.js)
10
10
  */
11
11
  declare module "util" {
12
12
  import * as types from "node:util/types";
@@ -338,6 +338,11 @@ declare module "util" {
338
338
  * @since v9.7.0
339
339
  */
340
340
  export function getSystemErrorName(err: number): string;
341
+ /**
342
+ * Enable or disable printing a stack trace on `SIGINT`. The API is only available on the main thread.
343
+ * @since 24.6.0
344
+ */
345
+ export function setTraceSigInt(enable: boolean): void;
341
346
  /**
342
347
  * Returns a Map of all system error codes available from the Node.js API.
343
348
  * The mapping between error codes and error names is platform-dependent.
@@ -367,19 +372,6 @@ declare module "util" {
367
372
  * @since v22.12.0
368
373
  */
369
374
  export function getSystemErrorMessage(err: number): string;
370
- /**
371
- * The `util.log()` method prints the given `string` to `stdout` with an included
372
- * timestamp.
373
- *
374
- * ```js
375
- * import util from 'node:util';
376
- *
377
- * util.log('Timestamped message.');
378
- * ```
379
- * @since v0.3.0
380
- * @deprecated Since v6.0.0 - Use a third party module instead.
381
- */
382
- export function log(string: string): void;
383
375
  /**
384
376
  * Returns the `string` after replacing any surrogate code points
385
377
  * (or equivalently, any unpaired surrogate code units) with the
@@ -650,71 +642,6 @@ declare module "util" {
650
642
  * @deprecated Since v4.0.0 - Use `isArray` instead.
651
643
  */
652
644
  export function isArray(object: unknown): object is unknown[];
653
- /**
654
- * Returns `true` if the given `object` is a `RegExp`. Otherwise, returns `false`.
655
- *
656
- * ```js
657
- * import util from 'node:util';
658
- *
659
- * util.isRegExp(/some regexp/);
660
- * // Returns: true
661
- * util.isRegExp(new RegExp('another regexp'));
662
- * // Returns: true
663
- * util.isRegExp({});
664
- * // Returns: false
665
- * ```
666
- * @since v0.6.0
667
- * @deprecated Since v4.0.0 - Deprecated
668
- */
669
- export function isRegExp(object: unknown): object is RegExp;
670
- /**
671
- * Returns `true` if the given `object` is a `Date`. Otherwise, returns `false`.
672
- *
673
- * ```js
674
- * import util from 'node:util';
675
- *
676
- * util.isDate(new Date());
677
- * // Returns: true
678
- * util.isDate(Date());
679
- * // false (without 'new' returns a String)
680
- * util.isDate({});
681
- * // Returns: false
682
- * ```
683
- * @since v0.6.0
684
- * @deprecated Since v4.0.0 - Use {@link types.isDate} instead.
685
- */
686
- export function isDate(object: unknown): object is Date;
687
- /**
688
- * Returns `true` if the given `object` is an `Error`. Otherwise, returns `false`.
689
- *
690
- * ```js
691
- * import util from 'node:util';
692
- *
693
- * util.isError(new Error());
694
- * // Returns: true
695
- * util.isError(new TypeError());
696
- * // Returns: true
697
- * util.isError({ name: 'Error', message: 'an error occurred' });
698
- * // Returns: false
699
- * ```
700
- *
701
- * This method relies on `Object.prototype.toString()` behavior. It is
702
- * possible to obtain an incorrect result when the `object` argument manipulates `@@toStringTag`.
703
- *
704
- * ```js
705
- * import util from 'node:util';
706
- * const obj = { name: 'Error', message: 'an error occurred' };
707
- *
708
- * util.isError(obj);
709
- * // Returns: false
710
- * obj[Symbol.toStringTag] = 'Error';
711
- * util.isError(obj);
712
- * // Returns: true
713
- * ```
714
- * @since v0.6.0
715
- * @deprecated Since v4.0.0 - Use {@link types.isNativeError} instead.
716
- */
717
- export function isError(object: unknown): object is Error;
718
645
  /**
719
646
  * Usage of `util.inherits()` is discouraged. Please use the ES6 `class` and
720
647
  * `extends` keywords to get language level inheritance support. Also note
@@ -865,217 +792,6 @@ declare module "util" {
865
792
  */
866
793
  export function debuglog(section: string, callback?: (fn: DebugLoggerFunction) => void): DebugLogger;
867
794
  export { debuglog as debug };
868
- /**
869
- * Returns `true` if the given `object` is a `Boolean`. Otherwise, returns `false`.
870
- *
871
- * ```js
872
- * import util from 'node:util';
873
- *
874
- * util.isBoolean(1);
875
- * // Returns: false
876
- * util.isBoolean(0);
877
- * // Returns: false
878
- * util.isBoolean(false);
879
- * // Returns: true
880
- * ```
881
- * @since v0.11.5
882
- * @deprecated Since v4.0.0 - Use `typeof value === 'boolean'` instead.
883
- */
884
- export function isBoolean(object: unknown): object is boolean;
885
- /**
886
- * Returns `true` if the given `object` is a `Buffer`. Otherwise, returns `false`.
887
- *
888
- * ```js
889
- * import util from 'node:util';
890
- *
891
- * util.isBuffer({ length: 0 });
892
- * // Returns: false
893
- * util.isBuffer([]);
894
- * // Returns: false
895
- * util.isBuffer(Buffer.from('hello world'));
896
- * // Returns: true
897
- * ```
898
- * @since v0.11.5
899
- * @deprecated Since v4.0.0 - Use `isBuffer` instead.
900
- */
901
- export function isBuffer(object: unknown): object is Buffer;
902
- /**
903
- * Returns `true` if the given `object` is a `Function`. Otherwise, returns `false`.
904
- *
905
- * ```js
906
- * import util from 'node:util';
907
- *
908
- * function Foo() {}
909
- * const Bar = () => {};
910
- *
911
- * util.isFunction({});
912
- * // Returns: false
913
- * util.isFunction(Foo);
914
- * // Returns: true
915
- * util.isFunction(Bar);
916
- * // Returns: true
917
- * ```
918
- * @since v0.11.5
919
- * @deprecated Since v4.0.0 - Use `typeof value === 'function'` instead.
920
- */
921
- export function isFunction(object: unknown): boolean;
922
- /**
923
- * Returns `true` if the given `object` is strictly `null`. Otherwise, returns`false`.
924
- *
925
- * ```js
926
- * import util from 'node:util';
927
- *
928
- * util.isNull(0);
929
- * // Returns: false
930
- * util.isNull(undefined);
931
- * // Returns: false
932
- * util.isNull(null);
933
- * // Returns: true
934
- * ```
935
- * @since v0.11.5
936
- * @deprecated Since v4.0.0 - Use `value === null` instead.
937
- */
938
- export function isNull(object: unknown): object is null;
939
- /**
940
- * Returns `true` if the given `object` is `null` or `undefined`. Otherwise,
941
- * returns `false`.
942
- *
943
- * ```js
944
- * import util from 'node:util';
945
- *
946
- * util.isNullOrUndefined(0);
947
- * // Returns: false
948
- * util.isNullOrUndefined(undefined);
949
- * // Returns: true
950
- * util.isNullOrUndefined(null);
951
- * // Returns: true
952
- * ```
953
- * @since v0.11.5
954
- * @deprecated Since v4.0.0 - Use `value === undefined || value === null` instead.
955
- */
956
- export function isNullOrUndefined(object: unknown): object is null | undefined;
957
- /**
958
- * Returns `true` if the given `object` is a `Number`. Otherwise, returns `false`.
959
- *
960
- * ```js
961
- * import util from 'node:util';
962
- *
963
- * util.isNumber(false);
964
- * // Returns: false
965
- * util.isNumber(Infinity);
966
- * // Returns: true
967
- * util.isNumber(0);
968
- * // Returns: true
969
- * util.isNumber(NaN);
970
- * // Returns: true
971
- * ```
972
- * @since v0.11.5
973
- * @deprecated Since v4.0.0 - Use `typeof value === 'number'` instead.
974
- */
975
- export function isNumber(object: unknown): object is number;
976
- /**
977
- * Returns `true` if the given `object` is strictly an `Object`**and** not a`Function` (even though functions are objects in JavaScript).
978
- * Otherwise, returns `false`.
979
- *
980
- * ```js
981
- * import util from 'node:util';
982
- *
983
- * util.isObject(5);
984
- * // Returns: false
985
- * util.isObject(null);
986
- * // Returns: false
987
- * util.isObject({});
988
- * // Returns: true
989
- * util.isObject(() => {});
990
- * // Returns: false
991
- * ```
992
- * @since v0.11.5
993
- * @deprecated Since v4.0.0 - Use `value !== null && typeof value === 'object'` instead.
994
- */
995
- export function isObject(object: unknown): boolean;
996
- /**
997
- * Returns `true` if the given `object` is a primitive type. Otherwise, returns`false`.
998
- *
999
- * ```js
1000
- * import util from 'node:util';
1001
- *
1002
- * util.isPrimitive(5);
1003
- * // Returns: true
1004
- * util.isPrimitive('foo');
1005
- * // Returns: true
1006
- * util.isPrimitive(false);
1007
- * // Returns: true
1008
- * util.isPrimitive(null);
1009
- * // Returns: true
1010
- * util.isPrimitive(undefined);
1011
- * // Returns: true
1012
- * util.isPrimitive({});
1013
- * // Returns: false
1014
- * util.isPrimitive(() => {});
1015
- * // Returns: false
1016
- * util.isPrimitive(/^$/);
1017
- * // Returns: false
1018
- * util.isPrimitive(new Date());
1019
- * // Returns: false
1020
- * ```
1021
- * @since v0.11.5
1022
- * @deprecated Since v4.0.0 - Use `(typeof value !== 'object' && typeof value !== 'function') || value === null` instead.
1023
- */
1024
- export function isPrimitive(object: unknown): boolean;
1025
- /**
1026
- * Returns `true` if the given `object` is a `string`. Otherwise, returns `false`.
1027
- *
1028
- * ```js
1029
- * import util from 'node:util';
1030
- *
1031
- * util.isString('');
1032
- * // Returns: true
1033
- * util.isString('foo');
1034
- * // Returns: true
1035
- * util.isString(String('foo'));
1036
- * // Returns: true
1037
- * util.isString(5);
1038
- * // Returns: false
1039
- * ```
1040
- * @since v0.11.5
1041
- * @deprecated Since v4.0.0 - Use `typeof value === 'string'` instead.
1042
- */
1043
- export function isString(object: unknown): object is string;
1044
- /**
1045
- * Returns `true` if the given `object` is a `Symbol`. Otherwise, returns `false`.
1046
- *
1047
- * ```js
1048
- * import util from 'node:util';
1049
- *
1050
- * util.isSymbol(5);
1051
- * // Returns: false
1052
- * util.isSymbol('foo');
1053
- * // Returns: false
1054
- * util.isSymbol(Symbol('foo'));
1055
- * // Returns: true
1056
- * ```
1057
- * @since v0.11.5
1058
- * @deprecated Since v4.0.0 - Use `typeof value === 'symbol'` instead.
1059
- */
1060
- export function isSymbol(object: unknown): object is symbol;
1061
- /**
1062
- * Returns `true` if the given `object` is `undefined`. Otherwise, returns `false`.
1063
- *
1064
- * ```js
1065
- * import util from 'node:util';
1066
- *
1067
- * const foo = undefined;
1068
- * util.isUndefined(5);
1069
- * // Returns: false
1070
- * util.isUndefined(foo);
1071
- * // Returns: true
1072
- * util.isUndefined(null);
1073
- * // Returns: false
1074
- * ```
1075
- * @since v0.11.5
1076
- * @deprecated Since v4.0.0 - Use `value === undefined` instead.
1077
- */
1078
- export function isUndefined(object: unknown): object is undefined;
1079
795
  /**
1080
796
  * The `util.deprecate()` method wraps `fn` (which may be a function or class) in
1081
797
  * such a way that it is marked as deprecated.
@@ -1137,6 +853,15 @@ declare module "util" {
1137
853
  * @return The deprecated function wrapped to emit a warning.
1138
854
  */
1139
855
  export function deprecate<T extends Function>(fn: T, msg: string, code?: string): T;
856
+ export interface IsDeepStrictEqualOptions {
857
+ /**
858
+ * If `true`, prototype and constructor
859
+ * comparison is skipped during deep strict equality check.
860
+ * @since v24.9.0
861
+ * @default false
862
+ */
863
+ skipPrototype?: boolean | undefined;
864
+ }
1140
865
  /**
1141
866
  * Returns `true` if there is deep strict equality between `val1` and `val2`.
1142
867
  * Otherwise, returns `false`.
@@ -1145,7 +870,7 @@ declare module "util" {
1145
870
  * equality.
1146
871
  * @since v9.0.0
1147
872
  */
1148
- export function isDeepStrictEqual(val1: unknown, val2: unknown): boolean;
873
+ export function isDeepStrictEqual(val1: unknown, val2: unknown, options?: IsDeepStrictEqualOptions): boolean;
1149
874
  /**
1150
875
  * Returns `str` with any ANSI escape codes removed.
1151
876
  *
@@ -1320,7 +1045,7 @@ declare module "util" {
1320
1045
  * ```
1321
1046
  *
1322
1047
  * If there is an `original[util.promisify.custom]` property present, `promisify`
1323
- * will return its value, see [Custom promisified functions](https://nodejs.org/docs/latest-v22.x/api/util.html#custom-promisified-functions).
1048
+ * will return its value, see [Custom promisified functions](https://nodejs.org/docs/latest-v24.x/api/util.html#custom-promisified-functions).
1324
1049
  *
1325
1050
  * `promisify()` assumes that `original` is a function taking a callback as its
1326
1051
  * final argument in all cases. If `original` is not a function, `promisify()`
@@ -1520,7 +1245,7 @@ declare module "util" {
1520
1245
  *
1521
1246
  * The special format value `none` applies no additional styling to the text.
1522
1247
  *
1523
- * The full list of formats can be found in [modifiers](https://nodejs.org/docs/latest-v22.x/api/util.html#modifiers).
1248
+ * The full list of formats can be found in [modifiers](https://nodejs.org/docs/latest-v24.x/api/util.html#modifiers).
1524
1249
  * @param format A text format or an Array of text formats defined in `util.inspect.colors`.
1525
1250
  * @param text The text to to be formatted.
1526
1251
  * @since v20.12.0
@@ -1616,7 +1341,7 @@ declare module "util" {
1616
1341
  * encoded bytes.
1617
1342
  * @param [input='an empty string'] The text to encode.
1618
1343
  */
1619
- encode(input?: string): Uint8Array;
1344
+ encode(input?: string): NodeJS.NonSharedUint8Array;
1620
1345
  /**
1621
1346
  * UTF-8 encodes the `src` string to the `dest` Uint8Array and returns an object
1622
1347
  * containing the read Unicode code units and written UTF-8 bytes.
@@ -1709,10 +1434,12 @@ declare module "util" {
1709
1434
  */
1710
1435
  short?: string | undefined;
1711
1436
  /**
1712
- * The default value to
1713
- * be used if (and only if) the option does not appear in the arguments to be
1714
- * parsed. It must be of the same type as the `type` property. When `multiple`
1715
- * is `true`, it must be an array.
1437
+ * The value to assign to
1438
+ * the option if it does not appear in the arguments to be parsed. The value
1439
+ * must match the type specified by the `type` property. If `multiple` is
1440
+ * `true`, it must be an array. No default value is applied when the option
1441
+ * does appear in the arguments to be parsed, even if the provided value
1442
+ * is falsy.
1716
1443
  * @since v18.11.0
1717
1444
  */
1718
1445
  default?: string | boolean | string[] | boolean[] | undefined;
@@ -1724,7 +1451,7 @@ declare module "util" {
1724
1451
  /**
1725
1452
  * Array of argument strings.
1726
1453
  */
1727
- args?: string[] | undefined;
1454
+ args?: readonly string[] | undefined;
1728
1455
  /**
1729
1456
  * Used to describe arguments known to the parser.
1730
1457
  */
@@ -2224,23 +1951,21 @@ declare module "util/types" {
2224
1951
  * ```
2225
1952
  *
2226
1953
  * For further information on `napi_create_external`, refer to
2227
- * [`napi_create_external()`](https://nodejs.org/docs/latest-v22.x/api/n-api.html#napi_create_external).
1954
+ * [`napi_create_external()`](https://nodejs.org/docs/latest-v24.x/api/n-api.html#napi_create_external).
2228
1955
  * @since v10.0.0
2229
1956
  */
2230
1957
  function isExternal(object: unknown): boolean;
2231
1958
  /**
2232
- * Returns `true` if the value is a built-in `Float16Array` instance.
1959
+ * Returns `true` if the value is a built-in [`Float16Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float16Array) instance.
2233
1960
  *
2234
1961
  * ```js
2235
1962
  * util.types.isFloat16Array(new ArrayBuffer()); // Returns false
2236
1963
  * util.types.isFloat16Array(new Float16Array()); // Returns true
2237
1964
  * util.types.isFloat16Array(new Float32Array()); // Returns false
2238
1965
  * ```
2239
- * @since v22.16.0
1966
+ * @since v24.0.0
2240
1967
  */
2241
- // This does NOT return a type predicate in v22.x.
2242
- // The Float16Array feature does not yet exist in this version of Node.js.
2243
- function isFloat16Array(object: unknown): boolean;
1968
+ function isFloat16Array(object: unknown): object is Float16Array;
2244
1969
  /**
2245
1970
  * Returns `true` if the value is a built-in [`Float32Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Float32Array) instance.
2246
1971
  *
@@ -2402,6 +2127,7 @@ declare module "util/types" {
2402
2127
  * console.log(myError instanceof Error); // true
2403
2128
  * ```
2404
2129
  * @since v10.0.0
2130
+ * @deprecated The `util.types.isNativeError` API is deprecated. Please use `Error.isError` instead.
2405
2131
  */
2406
2132
  function isNativeError(object: unknown): object is Error;
2407
2133
  /**
@@ -4,9 +4,10 @@
4
4
  * ```js
5
5
  * import v8 from 'node:v8';
6
6
  * ```
7
- * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/v8.js)
7
+ * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/v8.js)
8
8
  */
9
9
  declare module "v8" {
10
+ import { NonSharedBuffer } from "node:buffer";
10
11
  import { Readable } from "node:stream";
11
12
  interface HeapSpaceInfo {
12
13
  space_name: string;
@@ -43,12 +44,12 @@ declare module "v8" {
43
44
  * If true, expose internals in the heap snapshot.
44
45
  * @default false
45
46
  */
46
- exposeInternals?: boolean;
47
+ exposeInternals?: boolean | undefined;
47
48
  /**
48
49
  * If true, expose numeric values in artificial fields.
49
50
  * @default false
50
51
  */
51
- exposeNumericValues?: boolean;
52
+ exposeNumericValues?: boolean | undefined;
52
53
  }
53
54
  /**
54
55
  * Returns an integer representing a version tag derived from the V8 version,
@@ -400,6 +401,38 @@ declare module "v8" {
400
401
  * @since v12.8.0
401
402
  */
402
403
  function getHeapCodeStatistics(): HeapCodeStatistics;
404
+ /**
405
+ * @since v24.8.0
406
+ */
407
+ interface CPUProfileHandle {
408
+ /**
409
+ * Stopping collecting the profile, then return a Promise that fulfills with an error or the
410
+ * profile data.
411
+ * @since v24.8.0
412
+ */
413
+ stop(): Promise<string>;
414
+ /**
415
+ * Stopping collecting the profile and the profile will be discarded.
416
+ * @since v24.8.0
417
+ */
418
+ [Symbol.asyncDispose](): Promise<void>;
419
+ }
420
+ /**
421
+ * @since v24.9.0
422
+ */
423
+ interface HeapProfileHandle {
424
+ /**
425
+ * Stopping collecting the profile, then return a Promise that fulfills with an error or the
426
+ * profile data.
427
+ * @since v24.9.0
428
+ */
429
+ stop(): Promise<string>;
430
+ /**
431
+ * Stopping collecting the profile and the profile will be discarded.
432
+ * @since v24.9.0
433
+ */
434
+ [Symbol.asyncDispose](): Promise<void>;
435
+ }
403
436
  /**
404
437
  * V8 only supports `Latin-1/ISO-8859-1` and `UTF16` as the underlying representation of a string.
405
438
  * If the `content` uses `Latin-1/ISO-8859-1` as the underlying representation, this function will return true;
@@ -430,7 +463,7 @@ declare module "v8" {
430
463
  * writeString('hello');
431
464
  * writeString('你好');
432
465
  * ```
433
- * @since v22.15.0
466
+ * @since v23.10.0, v22.15.0
434
467
  */
435
468
  function isStringOneByteRepresentation(content: string): boolean;
436
469
  /**
@@ -453,7 +486,7 @@ declare module "v8" {
453
486
  * the buffer is released. Calling this method results in undefined behavior
454
487
  * if a previous write has failed.
455
488
  */
456
- releaseBuffer(): Buffer;
489
+ releaseBuffer(): NonSharedBuffer;
457
490
  /**
458
491
  * Marks an `ArrayBuffer` as having its contents transferred out of band.
459
492
  * Pass the corresponding `ArrayBuffer` in the deserializing context to `deserializer.transferArrayBuffer()`.
@@ -481,7 +514,7 @@ declare module "v8" {
481
514
  * will require a way to compute the length of the buffer.
482
515
  * For use inside of a custom `serializer._writeHostObject()`.
483
516
  */
484
- writeRawBytes(buffer: NodeJS.TypedArray): void;
517
+ writeRawBytes(buffer: NodeJS.ArrayBufferView): void;
485
518
  }
486
519
  /**
487
520
  * A subclass of `Serializer` that serializes `TypedArray`(in particular `Buffer`) and `DataView` objects as host objects, and only
@@ -552,7 +585,7 @@ declare module "v8" {
552
585
  * larger than `buffer.constants.MAX_LENGTH`.
553
586
  * @since v8.0.0
554
587
  */
555
- function serialize(value: any): Buffer;
588
+ function serialize(value: any): NonSharedBuffer;
556
589
  /**
557
590
  * Uses a `DefaultDeserializer` with default options to read a JS value
558
591
  * from a buffer.
@@ -580,7 +613,7 @@ declare module "v8" {
580
613
  function stopCoverage(): void;
581
614
  /**
582
615
  * The API is a no-op if `--heapsnapshot-near-heap-limit` is already set from the command line or the API is called more than once.
583
- * `limit` must be a positive integer. See [`--heapsnapshot-near-heap-limit`](https://nodejs.org/docs/latest-v22.x/api/cli.html#--heapsnapshot-near-heap-limitmax_count) for more information.
616
+ * `limit` must be a positive integer. See [`--heapsnapshot-near-heap-limit`](https://nodejs.org/docs/latest-v24.x/api/cli.html#--heapsnapshot-near-heap-limitmax_count) for more information.
584
617
  * @since v18.10.0, v16.18.0
585
618
  */
586
619
  function setHeapSnapshotNearHeapLimit(limit: number): void;