@idlebox/stripe-node-types 24.0.14-patch.0 → 24.0.15

package/url.d.ts

@@ -1,3 +1,18 @@
+// biome-ignore-all lint: generated file
+// biome-ignore-all assist: generated file
+/* eslint-disable */
+// @ts-ignore
+
+/******************************************************************************
+ *  GENERATED FILE, DO NOT MODIFY
+ *  这是生成的文件，千万不要修改
+ * 
+ * @build-script/codegen - The Simple Code Generater
+ * https://github.com/GongT/baobao
+ * 
+ ******************************************************************************/
+
+
 /**
  * The `node:url` module provides utilities for URL resolution and parsing. It can
  * be accessed using:
@@ -5,11 +20,11 @@
  * ```js
  * import url from 'node:url';
  * ```
- * @see [source](https://github.com/nodejs/node/blob/v24.x/lib/url.js)
+ * @see [source](https://github.com/nodejs/node/blob/v25.x/lib/url.js)
  */
 
 declare module "node:url" {
-    import { Blob as NodeBlob } from 'node:buffer';
+    import { Blob, NonSharedBuffer } from 'node:buffer';
     import { ClientRequestArgs } from 'node:http';
     import { ParsedUrlQuery, ParsedUrlQueryInput } from 'node:querystring';
     // Input to `url.format`
@@ -72,20 +87,44 @@ declare module "node:url" {
      * A `URIError` is thrown if the `auth` property is present but cannot be decoded.
      *
      * `url.parse()` uses a lenient, non-standard algorithm for parsing URL
-     * strings. It is prone to security issues such as [host name spoofing](https://hackerone.com/reports/678487) and incorrect handling of usernames and passwords. Do not use with untrusted
-     * input. CVEs are not issued for `url.parse()` vulnerabilities. Use the `WHATWG URL` API instead.
+     * strings. It is prone to security issues such as [host name spoofing](https://hackerone.com/reports/678487)
+     * and incorrect handling of usernames and passwords. Do not use with untrusted
+     * input. CVEs are not issued for `url.parse()` vulnerabilities. Use the
+     * [WHATWG URL](https://nodejs.org/docs/latest-v25.x/api/url.html#the-whatwg-url-api) API instead, for example:
+     *
+     * ```js
+     * function getURL(req) {
+     *   const proto = req.headers['x-forwarded-proto'] || 'https';
+     *   const host = req.headers['x-forwarded-host'] || req.headers.host || 'example.com';
+     *   return new URL(req.url || '/', `${proto}://${host}`);
+     * }
+     * ```
+     *
+     * The example above assumes well-formed headers are forwarded from a reverse
+     * proxy to your Node.js server. If you are not using a reverse proxy, you should
+     * use the example below:
+     *
+     * ```js
+     * function getURL(req) {
+     *   return new URL(req.url || '/', 'https://example.com');
+     * }
+     * ```
      * @since v0.1.25
      * @deprecated Use the WHATWG URL API instead.
      * @param urlString The URL string to parse.
-     * @param [parseQueryString=false] If `true`, the `query` property will always be set to an object returned by the {@link querystring} module's `parse()` method. If `false`, the `query` property
-     * on the returned URL object will be an unparsed, undecoded string.
-     * @param [slashesDenoteHost=false] If `true`, the first token after the literal string `//` and preceding the next `/` will be interpreted as the `host`. For instance, given `//foo/bar`, the
-     * result would be `{host: 'foo', pathname: '/bar'}` rather than `{pathname: '//foo/bar'}`.
+     * @param parseQueryString If `true`, the `query` property will always
+     * be set to an object returned by the [`querystring`](https://nodejs.org/docs/latest-v25.x/api/querystring.html) module's `parse()`
+     * method. If `false`, the `query` property on the returned URL object will be an
+     * unparsed, undecoded string. **Default:** `false`.
+     * @param slashesDenoteHost If `true`, the first token after the literal
+     * string `//` and preceding the next `/` will be interpreted as the `host`.
+     * For instance, given `//foo/bar`, the result would be
+     * `{host: 'foo', pathname: '/bar'}` rather than `{pathname: '//foo/bar'}`.
+     * **Default:** `false`.
      */
-    function parse(urlString: string): UrlWithStringQuery;
     function parse(
         urlString: string,
-        parseQueryString: false | undefined,
+        parseQueryString?: false,
         slashesDenoteHost?: boolean,
     ): UrlWithStringQuery;
     function parse(urlString: string, parseQueryString: true, slashesDenoteHost?: boolean): UrlWithParsedQuery;
@@ -316,6 +355,17 @@ declare module "node:url" {
      * @return The fully-resolved platform-specific Node.js file path.
      */
     function fileURLToPath(url: string | URL, options?: FileUrlToPathOptions): string;
+    /**
+     * Like `url.fileURLToPath(...)` except that instead of returning a string
+     * representation of the path, a `Buffer` is returned. This conversion is
+     * helpful when the input URL contains percent-encoded segments that are
+     * not valid UTF-8 / Unicode sequences.
+     * @since v24.3.0
+     * @param url The file URL string or URL object to convert to a path.
+     * @returns The fully-resolved platform-specific Node.js file path
+     * as a `Buffer`.
+     */
+    function fileURLToPathBuffer(url: string | URL, options?: FileUrlToPathOptions): NonSharedBuffer;
     /**
      * This function ensures that `path` is resolved absolutely, and that the URL
      * control characters are correctly encoded when converting into a File URL.
@@ -384,378 +434,8 @@ declare module "node:url" {
          */
         unicode?: boolean | undefined;
     }
-    /**
-     * Browser-compatible `URL` class, implemented by following the WHATWG URL
-     * Standard. [Examples of parsed URLs](https://url.spec.whatwg.org/#example-url-parsing) may be found in the Standard itself.
-     * The `URL` class is also available on the global object.
-     *
-     * In accordance with browser conventions, all properties of `URL` objects
-     * are implemented as getters and setters on the class prototype, rather than as
-     * data properties on the object itself. Thus, unlike `legacy urlObject`s,
-     * using the `delete` keyword on any properties of `URL` objects (e.g. `delete myURL.protocol`, `delete myURL.pathname`, etc) has no effect but will still
-     * return `true`.
-     * @since v7.0.0, v6.13.0
-     */
-    class URL {
-        /**
-         * Creates a `'blob:nodedata:...'` URL string that represents the given `Blob` object and can be used to retrieve the `Blob` later.
-         *
-         * ```js
-         * import {
-         *   Blob,
-         *   resolveObjectURL,
-         * } from 'node:buffer';
-         *
-         * const blob = new Blob(['hello']);
-         * const id = URL.createObjectURL(blob);
-         *
-         * // later...
-         *
-         * const otherBlob = resolveObjectURL(id);
-         * console.log(otherBlob.size);
-         * ```
-         *
-         * The data stored by the registered `Blob` will be retained in memory until `URL.revokeObjectURL()` is called to remove it.
-         *
-         * `Blob` objects are registered within the current thread. If using Worker
-         * Threads, `Blob` objects registered within one Worker will not be available
-         * to other workers or the main thread.
-         * @since v16.7.0
-         */
-        static createObjectURL(blob: NodeBlob): string;
-        /**
-         * Removes the stored `Blob` identified by the given ID. Attempting to revoke a
-         * ID that isn't registered will silently fail.
-         * @since v16.7.0
-         * @param id A `'blob:nodedata:...` URL string returned by a prior call to `URL.createObjectURL()`.
-         */
-        static revokeObjectURL(id: string): void;
-        /**
-         * Checks if an `input` relative to the `base` can be parsed to a `URL`.
-         *
-         * ```js
-         * const isValid = URL.canParse('/foo', 'https://example.org/'); // true
-         *
-         * const isNotValid = URL.canParse('/foo'); // false
-         * ```
-         * @since v19.9.0
-         * @param input The absolute or relative input URL to parse. If `input` is relative, then `base` is required. If `input` is absolute, the `base` is ignored. If `input` is not a string, it is
-         * `converted to a string` first.
-         * @param base The base URL to resolve against if the `input` is not absolute. If `base` is not a string, it is `converted to a string` first.
-         */
-        static canParse(input: string, base?: string): boolean;
-        /**
-         * Parses a string as a URL. If `base` is provided, it will be used as the base URL for the purpose of resolving non-absolute `input` URLs.
-         * Returns `null` if `input` is not a valid.
-         * @param input The absolute or relative input URL to parse. If `input` is relative, then `base` is required. If `input` is absolute, the `base` is ignored. If `input` is not a string, it is
-         * `converted to a string` first.
-         * @param base The base URL to resolve against if the `input` is not absolute. If `base` is not a string, it is `converted to a string` first.
-         * @since v22.1.0
-         */
-        static parse(input: string, base?: string): URL | null;
-        constructor(input: string | { toString: () => string }, base?: string | URL);
-        /**
-         * Gets and sets the fragment portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/foo#bar');
-         * console.log(myURL.hash);
-         * // Prints #bar
-         *
-         * myURL.hash = 'baz';
-         * console.log(myURL.href);
-         * // Prints https://example.org/foo#baz
-         * ```
-         *
-         * Invalid URL characters included in the value assigned to the `hash` property
-         * are `percent-encoded`. The selection of which characters to
-         * percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
-         */
-        hash: string;
-        /**
-         * Gets and sets the host portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org:81/foo');
-         * console.log(myURL.host);
-         * // Prints example.org:81
-         *
-         * myURL.host = 'example.com:82';
-         * console.log(myURL.href);
-         * // Prints https://example.com:82/foo
-         * ```
-         *
-         * Invalid host values assigned to the `host` property are ignored.
-         */
-        host: string;
-        /**
-         * Gets and sets the host name portion of the URL. The key difference between`url.host` and `url.hostname` is that `url.hostname` does _not_ include the
-         * port.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org:81/foo');
-         * console.log(myURL.hostname);
-         * // Prints example.org
-         *
-         * // Setting the hostname does not change the port
-         * myURL.hostname = 'example.com';
-         * console.log(myURL.href);
-         * // Prints https://example.com:81/foo
-         *
-         * // Use myURL.host to change the hostname and port
-         * myURL.host = 'example.org:82';
-         * console.log(myURL.href);
-         * // Prints https://example.org:82/foo
-         * ```
-         *
-         * Invalid host name values assigned to the `hostname` property are ignored.
-         */
-        hostname: string;
-        /**
-         * Gets and sets the serialized URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/foo');
-         * console.log(myURL.href);
-         * // Prints https://example.org/foo
-         *
-         * myURL.href = 'https://example.com/bar';
-         * console.log(myURL.href);
-         * // Prints https://example.com/bar
-         * ```
-         *
-         * Getting the value of the `href` property is equivalent to calling {@link toString}.
-         *
-         * Setting the value of this property to a new value is equivalent to creating a
-         * new `URL` object using `new URL(value)`. Each of the `URL` object's properties will be modified.
-         *
-         * If the value assigned to the `href` property is not a valid URL, a `TypeError` will be thrown.
-         */
-        href: string;
-        /**
-         * Gets the read-only serialization of the URL's origin.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/foo/bar?baz');
-         * console.log(myURL.origin);
-         * // Prints https://example.org
-         * ```
-         *
-         * ```js
-         * const idnURL = new URL('https://測試');
-         * console.log(idnURL.origin);
-         * // Prints https://xn--g6w251d
-         *
-         * console.log(idnURL.hostname);
-         * // Prints xn--g6w251d
-         * ```
-         */
-        readonly origin: string;
-        /**
-         * Gets and sets the password portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://abc:xyz@example.com');
-         * console.log(myURL.password);
-         * // Prints xyz
-         *
-         * myURL.password = '123';
-         * console.log(myURL.href);
-         * // Prints https://abc:123@example.com/
-         * ```
-         *
-         * Invalid URL characters included in the value assigned to the `password` property
-         * are `percent-encoded`. The selection of which characters to
-         * percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
-         */
-        password: string;
-        /**
-         * Gets and sets the path portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/abc/xyz?123');
-         * console.log(myURL.pathname);
-         * // Prints /abc/xyz
-         *
-         * myURL.pathname = '/abcdef';
-         * console.log(myURL.href);
-         * // Prints https://example.org/abcdef?123
-         * ```
-         *
-         * Invalid URL characters included in the value assigned to the `pathname` property are `percent-encoded`. The selection of which characters
-         * to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
-         */
-        pathname: string;
-        /**
-         * Gets and sets the port portion of the URL.
-         *
-         * The port value may be a number or a string containing a number in the range `0` to `65535` (inclusive). Setting the value to the default port of the `URL` objects given `protocol` will
-         * result in the `port` value becoming
-         * the empty string (`''`).
-         *
-         * The port value can be an empty string in which case the port depends on
-         * the protocol/scheme:
-         *
-         * <omitted>
-         *
-         * Upon assigning a value to the port, the value will first be converted to a
-         * string using `.toString()`.
-         *
-         * If that string is invalid but it begins with a number, the leading number is
-         * assigned to `port`.
-         * If the number lies outside the range denoted above, it is ignored.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org:8888');
-         * console.log(myURL.port);
-         * // Prints 8888
-         *
-         * // Default ports are automatically transformed to the empty string
-         * // (HTTPS protocol's default port is 443)
-         * myURL.port = '443';
-         * console.log(myURL.port);
-         * // Prints the empty string
-         * console.log(myURL.href);
-         * // Prints https://example.org/
-         *
-         * myURL.port = 1234;
-         * console.log(myURL.port);
-         * // Prints 1234
-         * console.log(myURL.href);
-         * // Prints https://example.org:1234/
-         *
-         * // Completely invalid port strings are ignored
-         * myURL.port = 'abcd';
-         * console.log(myURL.port);
-         * // Prints 1234
-         *
-         * // Leading numbers are treated as a port number
-         * myURL.port = '5678abcd';
-         * console.log(myURL.port);
-         * // Prints 5678
-         *
-         * // Non-integers are truncated
-         * myURL.port = 1234.5678;
-         * console.log(myURL.port);
-         * // Prints 1234
-         *
-         * // Out-of-range numbers which are not represented in scientific notation
-         * // will be ignored.
-         * myURL.port = 1e10; // 10000000000, will be range-checked as described below
-         * console.log(myURL.port);
-         * // Prints 1234
-         * ```
-         *
-         * Numbers which contain a decimal point,
-         * such as floating-point numbers or numbers in scientific notation,
-         * are not an exception to this rule.
-         * Leading numbers up to the decimal point will be set as the URL's port,
-         * assuming they are valid:
-         *
-         * ```js
-         * myURL.port = 4.567e21;
-         * console.log(myURL.port);
-         * // Prints 4 (because it is the leading number in the string '4.567e21')
-         * ```
-         */
-        port: string;
-        /**
-         * Gets and sets the protocol portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org');
-         * console.log(myURL.protocol);
-         * // Prints https:
-         *
-         * myURL.protocol = 'ftp';
-         * console.log(myURL.href);
-         * // Prints ftp://example.org/
-         * ```
-         *
-         * Invalid URL protocol values assigned to the `protocol` property are ignored.
-         */
-        protocol: string;
-        /**
-         * Gets and sets the serialized query portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/abc?123');
-         * console.log(myURL.search);
-         * // Prints ?123
-         *
-         * myURL.search = 'abc=xyz';
-         * console.log(myURL.href);
-         * // Prints https://example.org/abc?abc=xyz
-         * ```
-         *
-         * Any invalid URL characters appearing in the value assigned the `search` property will be `percent-encoded`. The selection of which
-         * characters to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
-         */
-        search: string;
-        /**
-         * Gets the `URLSearchParams` object representing the query parameters of the
-         * URL. This property is read-only but the `URLSearchParams` object it provides
-         * can be used to mutate the URL instance; to replace the entirety of query
-         * parameters of the URL, use the {@link search} setter. See `URLSearchParams` documentation for details.
-         *
-         * Use care when using `.searchParams` to modify the `URL` because,
-         * per the WHATWG specification, the `URLSearchParams` object uses
-         * different rules to determine which characters to percent-encode. For
-         * instance, the `URL` object will not percent encode the ASCII tilde (`~`)
-         * character, while `URLSearchParams` will always encode it:
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/abc?foo=~bar');
-         *
-         * console.log(myURL.search);  // prints ?foo=~bar
-         *
-         * // Modify the URL via searchParams...
-         * myURL.searchParams.sort();
-         *
-         * console.log(myURL.search);  // prints ?foo=%7Ebar
-         * ```
-         */
-        readonly searchParams: URLSearchParams;
-        /**
-         * Gets and sets the username portion of the URL.
-         *
-         * ```js
-         * const myURL = new URL('https://abc:xyz@example.com');
-         * console.log(myURL.username);
-         * // Prints abc
-         *
-         * myURL.username = '123';
-         * console.log(myURL.href);
-         * // Prints https://123:xyz@example.com/
-         * ```
-         *
-         * Any invalid URL characters appearing in the value assigned the `username` property will be `percent-encoded`. The selection of which
-         * characters to percent-encode may vary somewhat from what the {@link parse} and {@link format} methods would produce.
-         */
-        username: string;
-        /**
-         * The `toString()` method on the `URL` object returns the serialized URL. The
-         * value returned is equivalent to that of {@link href} and {@link toJSON}.
-         */
-        toString(): string;
-        /**
-         * The `toJSON()` method on the `URL` object returns the serialized URL. The
-         * value returned is equivalent to that of {@link href} and {@link toString}.
-         *
-         * This method is automatically called when an `URL` object is serialized
-         * with [`JSON.stringify()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify).
-         *
-         * ```js
-         * const myURLs = [
-         *   new URL('https://www.example.com'),
-         *   new URL('https://test.example.org'),
-         * ];
-         * console.log(JSON.stringify(myURLs));
-         * // Prints ["https://www.example.com/","https://test.example.org/"]
-         * ```
-         */
-        toJSON(): string;
-    }
+    // #region web types
+    type URLPatternInput = string | URLPatternInit;
     interface URLPatternComponentResult {
         input: string;
         groups: Record<string, string | undefined>;
@@ -775,7 +455,7 @@ declare module "node:url" {
         ignoreCase?: boolean;
     }
     interface URLPatternResult {
-        inputs: (string | URLPatternInit)[];
+        inputs: URLPatternInput[];
         protocol: URLPatternComponentResult;
         username: URLPatternComponentResult;
         password: URLPatternComponentResult;
@@ -785,14 +465,30 @@ declare module "node:url" {
         search: URLPatternComponentResult;
         hash: URLPatternComponentResult;
     }
-    /**
-     * @since v23.8.0
-     * @experimental
-     */
-    class URLPattern {
-        constructor(input: string | URLPatternInit, baseURL: string, options?: URLPatternOptions);
-        constructor(input?: string | URLPatternInit, options?: URLPatternOptions);
-        exec(input?: string | URLPatternInit, baseURL?: string): URLPatternResult | null;
+    interface URL {
+        hash: string;
+        host: string;
+        hostname: string;
+        href: string;
+        readonly origin: string;
+        password: string;
+        pathname: string;
+        port: string;
+        protocol: string;
+        search: string;
+        readonly searchParams: URLSearchParams;
+        username: string;
+        toJSON(): string;
+    }
+    var URL: {
+        prototype: URL;
+        new(url: string | URL, base?: string | URL): URL;
+        canParse(input: string | URL, base?: string | URL): boolean;
+        createObjectURL(blob: Blob): string;
+        parse(input: string | URL, base?: string | URL): URL | null;
+        revokeObjectURL(id: string): void;
+    };
+    interface URLPattern {
         readonly hasRegExpGroups: boolean;
         readonly hash: string;
         readonly hostname: string;
@@ -801,212 +497,36 @@ declare module "node:url" {
         readonly port: string;
         readonly protocol: string;
         readonly search: string;
-        test(input?: string | URLPatternInit, baseURL?: string): boolean;
         readonly username: string;
+        exec(input?: URLPatternInput, baseURL?: string | URL): URLPatternResult | null;
+        test(input?: URLPatternInput, baseURL?: string | URL): boolean;
     }
-    interface URLSearchParamsIterator<T> extends NodeJS.Iterator<T, NodeJS.BuiltinIteratorReturn, unknown> {
-        [Symbol.iterator](): URLSearchParamsIterator<T>;
-    }
-    /**
-     * The `URLSearchParams` API provides read and write access to the query of a `URL`. The `URLSearchParams` class can also be used standalone with one of the
-     * four following constructors.
-     * The `URLSearchParams` class is also available on the global object.
-     *
-     * The WHATWG `URLSearchParams` interface and the `querystring` module have
-     * similar purpose, but the purpose of the `querystring` module is more
-     * general, as it allows the customization of delimiter characters (`&#x26;` and `=`).
-     * On the other hand, this API is designed purely for URL query strings.
-     *
-     * ```js
-     * const myURL = new URL('https://example.org/?abc=123');
-     * console.log(myURL.searchParams.get('abc'));
-     * // Prints 123
-     *
-     * myURL.searchParams.append('abc', 'xyz');
-     * console.log(myURL.href);
-     * // Prints https://example.org/?abc=123&#x26;abc=xyz
-     *
-     * myURL.searchParams.delete('abc');
-     * myURL.searchParams.set('a', 'b');
-     * console.log(myURL.href);
-     * // Prints https://example.org/?a=b
-     *
-     * const newSearchParams = new URLSearchParams(myURL.searchParams);
-     * // The above is equivalent to
-     * // const newSearchParams = new URLSearchParams(myURL.search);
-     *
-     * newSearchParams.append('a', 'c');
-     * console.log(myURL.href);
-     * // Prints https://example.org/?a=b
-     * console.log(newSearchParams.toString());
-     * // Prints a=b&#x26;a=c
-     *
-     * // newSearchParams.toString() is implicitly called
-     * myURL.search = newSearchParams;
-     * console.log(myURL.href);
-     * // Prints https://example.org/?a=b&#x26;a=c
-     * newSearchParams.delete('a');
-     * console.log(myURL.href);
-     * // Prints https://example.org/?a=b&#x26;a=c
-     * ```
-     * @since v7.5.0, v6.13.0
-     */
-    class URLSearchParams implements Iterable<[string, string]> {
-        constructor(
-            init?:
-                | URLSearchParams
-                | string
-                | Record<string, string | readonly string[]>
-                | Iterable<[string, string]>
-                | ReadonlyArray<[string, string]>,
-        );
-        /**
-         * Append a new name-value pair to the query string.
-         */
+    var URLPattern: {
+        prototype: URLPattern;
+        new(input: URLPatternInput, baseURL: string | URL, options?: URLPatternOptions): URLPattern;
+        new(input?: URLPatternInput, options?: URLPatternOptions): URLPattern;
+    };
+    interface URLSearchParams {
+        readonly size: number;
         append(name: string, value: string): void;
-        /**
-         * If `value` is provided, removes all name-value pairs
-         * where name is `name` and value is `value`.
-         *
-         * If `value` is not provided, removes all name-value pairs whose name is `name`.
-         */
         delete(name: string, value?: string): void;
-        /**
-         * Returns an ES6 `Iterator` over each of the name-value pairs in the query.
-         * Each item of the iterator is a JavaScript `Array`. The first item of the `Array` is the `name`, the second item of the `Array` is the `value`.
-         *
-         * Alias for `urlSearchParams[@@iterator]()`.
-         */
-        entries(): URLSearchParamsIterator<[string, string]>;
-        /**
-         * Iterates over each name-value pair in the query and invokes the given function.
-         *
-         * ```js
-         * const myURL = new URL('https://example.org/?a=b&#x26;c=d');
-         * myURL.searchParams.forEach((value, name, searchParams) => {
-         *   console.log(name, value, myURL.searchParams === searchParams);
-         * });
-         * // Prints:
-         * //   a b true
-         * //   c d true
-         * ```
-         * @param fn Invoked for each name-value pair in the query
-         * @param thisArg To be used as `this` value for when `fn` is called
-         */
-        forEach<TThis = this>(
-            fn: (this: TThis, value: string, name: string, searchParams: URLSearchParams) => void,
-            thisArg?: TThis,
-        ): void;
-        /**
-         * Returns the value of the first name-value pair whose name is `name`. If there
-         * are no such pairs, `null` is returned.
-         * @return or `null` if there is no name-value pair with the given `name`.
-         */
         get(name: string): string | null;
-        /**
-         * Returns the values of all name-value pairs whose name is `name`. If there are
-         * no such pairs, an empty array is returned.
-         */
         getAll(name: string): string[];
-        /**
-         * Checks if the `URLSearchParams` object contains key-value pair(s) based on `name` and an optional `value` argument.
-         *
-         * If `value` is provided, returns `true` when name-value pair with
-         * same `name` and `value` exists.
-         *
-         * If `value` is not provided, returns `true` if there is at least one name-value
-         * pair whose name is `name`.
-         */
         has(name: string, value?: string): boolean;
-        /**
-         * Returns an ES6 `Iterator` over the names of each name-value pair.
-         *
-         * ```js
-         * const params = new URLSearchParams('foo=bar&#x26;foo=baz');
-         * for (const name of params.keys()) {
-         *   console.log(name);
-         * }
-         * // Prints:
-         * //   foo
-         * //   foo
-         * ```
-         */
-        keys(): URLSearchParamsIterator<string>;
-        /**
-         * Sets the value in the `URLSearchParams` object associated with `name` to `value`. If there are any pre-existing name-value pairs whose names are `name`,
-         * set the first such pair's value to `value` and remove all others. If not,
-         * append the name-value pair to the query string.
-         *
-         * ```js
-         * const params = new URLSearchParams();
-         * params.append('foo', 'bar');
-         * params.append('foo', 'baz');
-         * params.append('abc', 'def');
-         * console.log(params.toString());
-         * // Prints foo=bar&#x26;foo=baz&#x26;abc=def
-         *
-         * params.set('foo', 'def');
-         * params.set('xyz', 'opq');
-         * console.log(params.toString());
-         * // Prints foo=def&#x26;abc=def&#x26;xyz=opq
-         * ```
-         */
         set(name: string, value: string): void;
-        /**
-         * The total number of parameter entries.
-         * @since v19.8.0
-         */
-        readonly size: number;
-        /**
-         * Sort all existing name-value pairs in-place by their names. Sorting is done
-         * with a [stable sorting algorithm](https://en.wikipedia.org/wiki/Sorting_algorithm#Stability), so relative order between name-value pairs
-         * with the same name is preserved.
-         *
-         * This method can be used, in particular, to increase cache hits.
-         *
-         * ```js
-         * const params = new URLSearchParams('query[]=abc&#x26;type=search&#x26;query[]=123');
-         * params.sort();
-         * console.log(params.toString());
-         * // Prints query%5B%5D=abc&#x26;query%5B%5D=123&#x26;type=search
-         * ```
-         * @since v7.7.0, v6.13.0
-         */
         sort(): void;
-        /**
-         * Returns the search parameters serialized as a string, with characters
-         * percent-encoded where necessary.
-         */
-        toString(): string;
-        /**
-         * Returns an ES6 `Iterator` over the values of each name-value pair.
-         */
-        values(): URLSearchParamsIterator<string>;
+        forEach(callbackfn: (value: string, key: string, parent: URLSearchParams) => void, thisArg?: any): void;
         [Symbol.iterator](): URLSearchParamsIterator<[string, string]>;
+        entries(): URLSearchParamsIterator<[string, string]>;
+        keys(): URLSearchParamsIterator<string>;
+        values(): URLSearchParamsIterator<string>;
     }
-    import {
-        URL as _URL,
-        URLPattern as _URLPattern,
-        URLPatternInit as _URLPatternInit,
-        URLPatternResult as _URLPatternResult,
-        URLSearchParams as _URLSearchParams,
-    } from 'node:url';
-    global {
-        interface URL extends _URL {}
-        var URL: typeof globalThis extends {
-            onmessage: any;
-            URL: infer T;
-        } ? T
-            : typeof _URL;
-        interface URLSearchParams extends _URLSearchParams {}
-        var URLSearchParams: typeof globalThis extends {
-            onmessage: any;
-            URLSearchParams: infer T;
-        } ? T
-            : typeof _URLSearchParams;
-        interface URLPatternInit extends _URLPatternInit {}
-        interface URLPatternResult extends _URLPatternResult {}
-        interface URLPattern extends _URLPattern {}
-        var URLPattern: typeof _URLPattern;
+    var URLSearchParams: {
+        prototype: URLSearchParams;
+        new(init?: string[][] | Record<string, string> | string | URLSearchParams): URLSearchParams;
+    };
+    interface URLSearchParamsIterator<T> extends NodeJS.Iterator<T, NodeJS.BuiltinIteratorReturn, unknown> {
+        [Symbol.iterator](): URLSearchParamsIterator<T>;
     }
+    // #endregion
 }