@types/node 18.19.8 → 18.19.10

node v18.19/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for node (https://nodejs.org/).
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v18.
 
 ### Additional Details
- * Last updated: Wed, 17 Jan 2024 06:36:16 GMT
+ * Last updated: Fri, 26 Jan 2024 04:36:02 GMT
  * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
 
 # Credits

node v18.19/fs.d.ts

@@ -334,31 +334,51 @@ declare module "fs" {
          * @since v0.5.8
          */
         close(): void;
+        /**
+         * When called, requests that the Node.js event loop _not_ exit so long as the `fs.FSWatcher` is active. Calling `watcher.ref()` multiple times will have
+         * no effect.
+         *
+         * By default, all `fs.FSWatcher` objects are "ref'ed", making it normally
+         * unnecessary to call `watcher.ref()` unless `watcher.unref()` had been
+         * called previously.
+         * @since v14.3.0, v12.20.0
+         */
+        ref(): this;
+        /**
+         * When called, the active `fs.FSWatcher` object will not require the Node.js
+         * event loop to remain active. If there is no other activity keeping the
+         * event loop running, the process may exit before the `fs.FSWatcher` object's
+         * callback is invoked. Calling `watcher.unref()` multiple times will have
+         * no effect.
+         * @since v14.3.0, v12.20.0
+         */
+        unref(): this;
         /**
          * events.EventEmitter
          *   1. change
-         *   2. error
+         *   2. close
+         *   3. error
          */
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        addListener(event: "error", listener: (error: Error) => void): this;
         addListener(event: "close", listener: () => void): this;
+        addListener(event: "error", listener: (error: Error) => void): this;
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        on(event: "error", listener: (error: Error) => void): this;
         on(event: "close", listener: () => void): this;
+        on(event: "error", listener: (error: Error) => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        once(event: "error", listener: (error: Error) => void): this;
         once(event: "close", listener: () => void): this;
+        once(event: "error", listener: (error: Error) => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        prependListener(event: "error", listener: (error: Error) => void): this;
         prependListener(event: "close", listener: () => void): this;
+        prependListener(event: "error", listener: (error: Error) => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        prependOnceListener(event: "error", listener: (error: Error) => void): this;
         prependOnceListener(event: "close", listener: () => void): this;
+        prependOnceListener(event: "error", listener: (error: Error) => void): this;
     }
     /**
      * Instances of `fs.ReadStream` are created and returned using the {@link createReadStream} function.

node v18.19/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/node",
-    "version": "18.19.8",
+    "version": "18.19.10",
     "description": "TypeScript definitions for node",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
     "license": "MIT",
@@ -229,7 +229,7 @@
     "dependencies": {
         "undici-types": "~5.26.4"
     },
-    "typesPublisherContentHash": "c6ffdf1446429345b2047cbbd1128ef89768281b14f4584d14b4b11b4af8d008",
+    "typesPublisherContentHash": "c06efc5f7d8fde93e7c6141f0d3ff1b40956eb034747f7d979d81fb03b95a37b",
     "typeScriptVersion": "4.6",
     "nonNpm": true
 }

node v18.19/string_decoder.d.ts

@@ -1,23 +1,23 @@
 /**
- * The `string_decoder` module provides an API for decoding `Buffer` objects into
- * strings in a manner that preserves encoded multi-byte UTF-8 and UTF-16
+ * The `node:string_decoder` module provides an API for decoding `Buffer` objects
+ * into strings in a manner that preserves encoded multi-byte UTF-8 and UTF-16
  * characters. It can be accessed using:
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * ```
  *
  * The following example shows the basic use of the `StringDecoder` class.
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * const decoder = new StringDecoder('utf8');
  *
  * const cent = Buffer.from([0xC2, 0xA2]);
- * console.log(decoder.write(cent));
+ * console.log(decoder.write(cent)); // Prints: ¢
  *
  * const euro = Buffer.from([0xE2, 0x82, 0xAC]);
- * console.log(decoder.write(euro));
+ * console.log(decoder.write(euro)); // Prints: €
  * ```
  *
  * When a `Buffer` instance is written to the `StringDecoder` instance, an
@@ -29,14 +29,14 @@
  * symbol (`€`) are written over three separate operations:
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * const decoder = new StringDecoder('utf8');
  *
  * decoder.write(Buffer.from([0xE2]));
  * decoder.write(Buffer.from([0x82]));
- * console.log(decoder.end(Buffer.from([0xAC])));
+ * console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/string_decoder.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.19.0/lib/string_decoder.js)
  */
 declare module "string_decoder" {
     class StringDecoder {
@@ -46,9 +46,9 @@ declare module "string_decoder" {
          * the end of the `Buffer`, or `TypedArray`, or `DataView` are omitted from the
          * returned string and stored in an internal buffer for the next call to`stringDecoder.write()` or `stringDecoder.end()`.
          * @since v0.1.99
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
-        write(buffer: Buffer): string;
+        write(buffer: string | Buffer | NodeJS.ArrayBufferView): string;
         /**
          * Returns any remaining input stored in the internal buffer as a string. Bytes
          * representing incomplete UTF-8 and UTF-16 characters will be replaced with
@@ -57,9 +57,9 @@ declare module "string_decoder" {
          * If the `buffer` argument is provided, one final call to `stringDecoder.write()`is performed before returning the remaining input.
          * After `end()` is called, the `stringDecoder` object can be reused for new input.
          * @since v0.9.3
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
-        end(buffer?: Buffer): string;
+        end(buffer?: string | Buffer | NodeJS.ArrayBufferView): string;
     }
 }
 declare module "node:string_decoder" {

node v18.19/ts4.8/fs.d.ts

@@ -334,31 +334,51 @@ declare module "fs" {
          * @since v0.5.8
          */
         close(): void;
+        /**
+         * When called, requests that the Node.js event loop _not_ exit so long as the `fs.FSWatcher` is active. Calling `watcher.ref()` multiple times will have
+         * no effect.
+         *
+         * By default, all `fs.FSWatcher` objects are "ref'ed", making it normally
+         * unnecessary to call `watcher.ref()` unless `watcher.unref()` had been
+         * called previously.
+         * @since v14.3.0, v12.20.0
+         */
+        ref(): this;
+        /**
+         * When called, the active `fs.FSWatcher` object will not require the Node.js
+         * event loop to remain active. If there is no other activity keeping the
+         * event loop running, the process may exit before the `fs.FSWatcher` object's
+         * callback is invoked. Calling `watcher.unref()` multiple times will have
+         * no effect.
+         * @since v14.3.0, v12.20.0
+         */
+        unref(): this;
         /**
          * events.EventEmitter
          *   1. change
-         *   2. error
+         *   2. close
+         *   3. error
          */
         addListener(event: string, listener: (...args: any[]) => void): this;
         addListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        addListener(event: "error", listener: (error: Error) => void): this;
         addListener(event: "close", listener: () => void): this;
+        addListener(event: "error", listener: (error: Error) => void): this;
         on(event: string, listener: (...args: any[]) => void): this;
         on(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        on(event: "error", listener: (error: Error) => void): this;
         on(event: "close", listener: () => void): this;
+        on(event: "error", listener: (error: Error) => void): this;
         once(event: string, listener: (...args: any[]) => void): this;
         once(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        once(event: "error", listener: (error: Error) => void): this;
         once(event: "close", listener: () => void): this;
+        once(event: "error", listener: (error: Error) => void): this;
         prependListener(event: string, listener: (...args: any[]) => void): this;
         prependListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        prependListener(event: "error", listener: (error: Error) => void): this;
         prependListener(event: "close", listener: () => void): this;
+        prependListener(event: "error", listener: (error: Error) => void): this;
         prependOnceListener(event: string, listener: (...args: any[]) => void): this;
         prependOnceListener(event: "change", listener: (eventType: string, filename: string | Buffer) => void): this;
-        prependOnceListener(event: "error", listener: (error: Error) => void): this;
         prependOnceListener(event: "close", listener: () => void): this;
+        prependOnceListener(event: "error", listener: (error: Error) => void): this;
     }
     /**
      * Instances of `fs.ReadStream` are created and returned using the {@link createReadStream} function.

node v18.19/ts4.8/string_decoder.d.ts

@@ -1,23 +1,23 @@
 /**
- * The `string_decoder` module provides an API for decoding `Buffer` objects into
- * strings in a manner that preserves encoded multi-byte UTF-8 and UTF-16
+ * The `node:string_decoder` module provides an API for decoding `Buffer` objects
+ * into strings in a manner that preserves encoded multi-byte UTF-8 and UTF-16
  * characters. It can be accessed using:
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * ```
  *
  * The following example shows the basic use of the `StringDecoder` class.
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * const decoder = new StringDecoder('utf8');
  *
  * const cent = Buffer.from([0xC2, 0xA2]);
- * console.log(decoder.write(cent));
+ * console.log(decoder.write(cent)); // Prints: ¢
  *
  * const euro = Buffer.from([0xE2, 0x82, 0xAC]);
- * console.log(decoder.write(euro));
+ * console.log(decoder.write(euro)); // Prints: €
  * ```
  *
  * When a `Buffer` instance is written to the `StringDecoder` instance, an
@@ -29,14 +29,14 @@
  * symbol (`€`) are written over three separate operations:
  *
  * ```js
- * const { StringDecoder } = require('string_decoder');
+ * const { StringDecoder } = require('node:string_decoder');
  * const decoder = new StringDecoder('utf8');
  *
  * decoder.write(Buffer.from([0xE2]));
  * decoder.write(Buffer.from([0x82]));
- * console.log(decoder.end(Buffer.from([0xAC])));
+ * console.log(decoder.end(Buffer.from([0xAC]))); // Prints: €
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v18.0.0/lib/string_decoder.js)
+ * @see [source](https://github.com/nodejs/node/blob/v18.19.0/lib/string_decoder.js)
  */
 declare module "string_decoder" {
     class StringDecoder {
@@ -46,9 +46,9 @@ declare module "string_decoder" {
          * the end of the `Buffer`, or `TypedArray`, or `DataView` are omitted from the
          * returned string and stored in an internal buffer for the next call to`stringDecoder.write()` or `stringDecoder.end()`.
          * @since v0.1.99
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
-        write(buffer: Buffer): string;
+        write(buffer: string | Buffer | NodeJS.ArrayBufferView): string;
         /**
          * Returns any remaining input stored in the internal buffer as a string. Bytes
          * representing incomplete UTF-8 and UTF-16 characters will be replaced with
@@ -57,9 +57,9 @@ declare module "string_decoder" {
          * If the `buffer` argument is provided, one final call to `stringDecoder.write()`is performed before returning the remaining input.
          * After `end()` is called, the `stringDecoder` object can be reused for new input.
          * @since v0.9.3
-         * @param buffer A `Buffer`, or `TypedArray`, or `DataView` containing the bytes to decode.
+         * @param buffer The bytes to decode.
          */
-        end(buffer?: Buffer): string;
+        end(buffer?: string | Buffer | NodeJS.ArrayBufferView): string;
     }
 }
 declare module "node:string_decoder" {