@node-core/utils 7.2.1 → 7.2.3

package/node_modules/cheerio/node_modules/undici/types/fetch.d.ts

@@ -1,231 +0,0 @@
-// based on https://github.com/Ethan-Arrowood/undici-fetch/blob/249269714db874351589d2d364a0645d5160ae71/index.d.ts (MIT license)
-// and https://github.com/node-fetch/node-fetch/blob/914ce6be5ec67a8bab63d68510aabf07cb818b6d/index.d.ts (MIT license)
-/// <reference types="node" />
-
-import { Blob } from 'node:buffer'
-import { URL, URLSearchParams } from 'node:url'
-import { ReadableStream } from 'node:stream/web'
-import { FormData } from './formdata'
-import { HeaderRecord } from './header'
-import Dispatcher from './dispatcher'
-
-export type RequestInfo = string | URL | Request
-
-export declare function fetch (
-  input: RequestInfo,
-  init?: RequestInit
-): Promise<Response>
-
-export type BodyInit =
-  | ArrayBuffer
-  | AsyncIterable<Uint8Array>
-  | Blob
-  | FormData
-  | Iterable<Uint8Array>
-  | NodeJS.ArrayBufferView
-  | URLSearchParams
-  | null
-  | string
-
-export class BodyMixin {
-  readonly body: ReadableStream | null
-  readonly bodyUsed: boolean
-
-  readonly arrayBuffer: () => Promise<ArrayBuffer>
-  readonly blob: () => Promise<Blob>
-  readonly bytes: () => Promise<Uint8Array>
-  /**
-   * @deprecated This method is not recommended for parsing multipart/form-data bodies in server environments.
-   * It is recommended to use a library such as [@fastify/busboy](https://www.npmjs.com/package/@fastify/busboy) as follows:
-   *
-   * @example
-   * ```js
-   * import { Busboy } from '@fastify/busboy'
-   * import { Readable } from 'node:stream'
-   *
-   * const response = await fetch('...')
-   * const busboy = new Busboy({ headers: { 'content-type': response.headers.get('content-type') } })
-   *
-   * // handle events emitted from `busboy`
-   *
-   * Readable.fromWeb(response.body).pipe(busboy)
-   * ```
-   */
-  readonly formData: () => Promise<FormData>
-  readonly json: () => Promise<unknown>
-  readonly text: () => Promise<string>
-}
-
-export interface SpecIterator<T, TReturn = any, TNext = undefined> {
-  next(...args: [] | [TNext]): IteratorResult<T, TReturn>;
-}
-
-export interface SpecIteratorObject<T, TReturn = undefined, TNext = unknown> extends SpecIterator<T, TReturn, TNext> {
-  [Symbol.iterator](): SpecIteratorObject<T, TReturn, TNext>;
-  map<U>(callbackfn: (value: T, index: number) => U): SpecIteratorObject<U>;
-  filter<S extends T>(predicate: (value: T, index: number) => value is S): SpecIteratorObject<S>;
-  filter(predicate: (value: T, index: number) => unknown): SpecIteratorObject<T>;
-  take(limit: number): SpecIteratorObject<T>;
-  drop(count: number): SpecIteratorObject<T>;
-  flatMap<U>(callbackfn: (value: T, index: number) => Iterator<U> | Iterable<U>): SpecIteratorObject<U>;
-  reduce(callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T): T;
-  reduce(callbackfn: (previousValue: T, currentValue: T, currentIndex: number) => T, initialValue: T): T;
-  reduce<U>(callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U, initialValue: U): U;
-  toArray(): T[];
-  forEach(callbackfn: (value: T, index: number) => void): void;
-  some(predicate: (value: T, index: number) => unknown): boolean;
-  every(predicate: (value: T, index: number) => unknown): boolean;
-  find<S extends T>(predicate: (value: T, index: number) => value is S): S | undefined;
-  find(predicate: (value: T, index: number) => unknown): T | undefined;
-  readonly [Symbol.toStringTag]: string;
-}
-
-export interface SpecIterableIterator<T> extends SpecIteratorObject<T> {
-  [Symbol.iterator](): SpecIterableIterator<T>;
-}
-
-export interface SpecIterable<T> {
-  [Symbol.iterator](): SpecIterableIterator<T>;
-}
-
-export type HeadersInit = [string, string][] | HeaderRecord | Headers
-
-export declare class Headers implements SpecIterable<[string, string]> {
-  constructor (init?: HeadersInit)
-  readonly append: (name: string, value: string) => void
-  readonly delete: (name: string) => void
-  readonly get: (name: string) => string | null
-  readonly has: (name: string) => boolean
-  readonly set: (name: string, value: string) => void
-  readonly getSetCookie: () => string[]
-  readonly forEach: (
-    callbackfn: (value: string, key: string, iterable: Headers) => void,
-    thisArg?: unknown
-  ) => void
-
-  readonly keys: () => SpecIterableIterator<string>
-  readonly values: () => SpecIterableIterator<string>
-  readonly entries: () => SpecIterableIterator<[string, string]>
-  readonly [Symbol.iterator]: () => SpecIterableIterator<[string, string]>
-}
-
-export type RequestCache =
-  | 'default'
-  | 'force-cache'
-  | 'no-cache'
-  | 'no-store'
-  | 'only-if-cached'
-  | 'reload'
-
-export type RequestCredentials = 'omit' | 'include' | 'same-origin'
-
-type RequestDestination =
-  | ''
-  | 'audio'
-  | 'audioworklet'
-  | 'document'
-  | 'embed'
-  | 'font'
-  | 'image'
-  | 'manifest'
-  | 'object'
-  | 'paintworklet'
-  | 'report'
-  | 'script'
-  | 'sharedworker'
-  | 'style'
-  | 'track'
-  | 'video'
-  | 'worker'
-  | 'xslt'
-
-export interface RequestInit {
-  body?: BodyInit | null
-  cache?: RequestCache
-  credentials?: RequestCredentials
-  dispatcher?: Dispatcher
-  duplex?: RequestDuplex
-  headers?: HeadersInit
-  integrity?: string
-  keepalive?: boolean
-  method?: string
-  mode?: RequestMode
-  redirect?: RequestRedirect
-  referrer?: string
-  referrerPolicy?: ReferrerPolicy
-  signal?: AbortSignal | null
-  window?: null
-}
-
-export type ReferrerPolicy =
-  | ''
-  | 'no-referrer'
-  | 'no-referrer-when-downgrade'
-  | 'origin'
-  | 'origin-when-cross-origin'
-  | 'same-origin'
-  | 'strict-origin'
-  | 'strict-origin-when-cross-origin'
-  | 'unsafe-url'
-
-export type RequestMode = 'cors' | 'navigate' | 'no-cors' | 'same-origin'
-
-export type RequestRedirect = 'error' | 'follow' | 'manual'
-
-export type RequestDuplex = 'half'
-
-export declare class Request extends BodyMixin {
-  constructor (input: RequestInfo, init?: RequestInit)
-
-  readonly cache: RequestCache
-  readonly credentials: RequestCredentials
-  readonly destination: RequestDestination
-  readonly headers: Headers
-  readonly integrity: string
-  readonly method: string
-  readonly mode: RequestMode
-  readonly redirect: RequestRedirect
-  readonly referrer: string
-  readonly referrerPolicy: ReferrerPolicy
-  readonly url: string
-
-  readonly keepalive: boolean
-  readonly signal: AbortSignal
-  readonly duplex: RequestDuplex
-
-  public clone (): Request
-}
-
-export interface ResponseInit {
-  readonly status?: number
-  readonly statusText?: string
-  readonly headers?: HeadersInit
-}
-
-export type ResponseType =
-  | 'basic'
-  | 'cors'
-  | 'default'
-  | 'error'
-  | 'opaque'
-  | 'opaqueredirect'
-
-export type ResponseRedirectStatus = 301 | 302 | 303 | 307 | 308
-
-export declare class Response extends BodyMixin {
-  constructor (body?: BodyInit, init?: ResponseInit)
-
-  readonly headers: Headers
-  readonly ok: boolean
-  readonly status: number
-  readonly statusText: string
-  readonly type: ResponseType
-  readonly url: string
-  readonly redirected: boolean
-
-  public clone (): Response
-
-  static error (): Response
-  static json (data: any, init?: ResponseInit): Response
-  static redirect (url: string | URL, status?: ResponseRedirectStatus): Response
-}

package/node_modules/cheerio/node_modules/undici/types/formdata.d.ts

@@ -1,114 +0,0 @@
-// Based on https://github.com/octet-stream/form-data/blob/2d0f0dc371517444ce1f22cdde13f51995d0953a/lib/FormData.ts (MIT)
-/// <reference types="node" />
-
-import { File } from 'node:buffer'
-import { SpecIterableIterator } from './fetch'
-
-declare module 'node:buffer' {
-  interface File {
-    readonly [Symbol.toStringTag]: string
-  }
-}
-
-/**
- * A `string` or `File` that represents a single value from a set of `FormData` key-value pairs.
- */
-declare type FormDataEntryValue = string | File
-
-/**
- * Provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using fetch().
- */
-export declare class FormData {
-  /**
-   * Appends a new value onto an existing key inside a FormData object,
-   * or adds the key if it does not already exist.
-   *
-   * The difference between `set()` and `append()` is that if the specified key already exists, `set()` will overwrite all existing values with the new one, whereas `append()` will append the new value onto the end of the existing set of values.
-   *
-   * @param name The name of the field whose data is contained in `value`.
-   * @param value The field's value. This can be [`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob)
-    or [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File). If none of these are specified the value is converted to a string.
-   * @param fileName The filename reported to the server, when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob". The default filename for File objects is the file's filename.
-   */
-  append (name: string, value: unknown, fileName?: string): void
-
-  /**
-   * Set a new value for an existing key inside FormData,
-   * or add the new field if it does not already exist.
-   *
-   * @param name The name of the field whose data is contained in `value`.
-   * @param value The field's value. This can be [`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob)
-    or [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File). If none of these are specified the value is converted to a string.
-   * @param fileName The filename reported to the server, when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob". The default filename for File objects is the file's filename.
-   *
-   */
-  set (name: string, value: unknown, fileName?: string): void
-
-  /**
-   * Returns the first value associated with a given key from within a `FormData` object.
-   * If you expect multiple values and want all of them, use the `getAll()` method instead.
-   *
-   * @param {string} name A name of the value you want to retrieve.
-   *
-   * @returns A `FormDataEntryValue` containing the value. If the key doesn't exist, the method returns null.
-   */
-  get (name: string): FormDataEntryValue | null
-
-  /**
-   * Returns all the values associated with a given key from within a `FormData` object.
-   *
-   * @param {string} name A name of the value you want to retrieve.
-   *
-   * @returns An array of `FormDataEntryValue` whose key matches the value passed in the `name` parameter. If the key doesn't exist, the method returns an empty list.
-   */
-  getAll (name: string): FormDataEntryValue[]
-
-  /**
-   * Returns a boolean stating whether a `FormData` object contains a certain key.
-   *
-   * @param name A string representing the name of the key you want to test for.
-   *
-   * @return A boolean value.
-   */
-  has (name: string): boolean
-
-  /**
-   * Deletes a key and its value(s) from a `FormData` object.
-   *
-   * @param name The name of the key you want to delete.
-   */
-  delete (name: string): void
-
-  /**
-   * Executes given callback function for each field of the FormData instance
-   */
-  forEach: (
-    callbackfn: (value: FormDataEntryValue, key: string, iterable: FormData) => void,
-    thisArg?: unknown
-  ) => void
-
-  /**
-   * Returns an [`iterator`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) allowing to go through all keys contained in this `FormData` object.
-   * Each key is a `string`.
-   */
-  keys: () => SpecIterableIterator<string>
-
-  /**
-   * Returns an [`iterator`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) allowing to go through all values contained in this object `FormData` object.
-   * Each value is a [`FormDataValue`](https://developer.mozilla.org/en-US/docs/Web/API/FormDataEntryValue).
-   */
-  values: () => SpecIterableIterator<FormDataEntryValue>
-
-  /**
-   * Returns an [`iterator`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) allowing to go through the `FormData` key/value pairs.
-   * The key of each pair is a string; the value is a [`FormDataValue`](https://developer.mozilla.org/en-US/docs/Web/API/FormDataEntryValue).
-   */
-  entries: () => SpecIterableIterator<[string, FormDataEntryValue]>
-
-  /**
-   * An alias for FormData#entries()
-   */
-  [Symbol.iterator]: () => SpecIterableIterator<[string, FormDataEntryValue]>
-
-  readonly [Symbol.toStringTag]: string
-}

package/node_modules/cheerio/node_modules/undici/types/global-dispatcher.d.ts

@@ -1,9 +0,0 @@
-import Dispatcher from './dispatcher'
-
-declare function setGlobalDispatcher<DispatcherImplementation extends Dispatcher> (dispatcher: DispatcherImplementation): void
-declare function getGlobalDispatcher (): Dispatcher
-
-export {
-  getGlobalDispatcher,
-  setGlobalDispatcher
-}

package/node_modules/cheerio/node_modules/undici/types/global-origin.d.ts

@@ -1,7 +0,0 @@
-declare function setGlobalOrigin (origin: string | URL | undefined): void
-declare function getGlobalOrigin (): URL | undefined
-
-export {
-  setGlobalOrigin,
-  getGlobalOrigin
-}

package/node_modules/cheerio/node_modules/undici/types/h2c-client.d.ts

@@ -1,73 +0,0 @@
-import { URL } from 'node:url'
-import Dispatcher from './dispatcher'
-import buildConnector from './connector'
-
-type H2ClientOptions = Omit<Dispatcher.ConnectOptions, 'origin'>
-
-/**
- * A basic H2C client, mapped on top a single TCP connection. Pipelining is disabled by default.
- */
-export class H2CClient extends Dispatcher {
-  constructor (url: string | URL, options?: H2CClient.Options)
-  /** Property to get and set the pipelining factor. */
-  pipelining: number
-  /** `true` after `client.close()` has been called. */
-  closed: boolean
-  /** `true` after `client.destroyed()` has been called or `client.close()` has been called and the client shutdown has completed. */
-  destroyed: boolean
-
-  // Override dispatcher APIs.
-  override connect (
-    options: H2ClientOptions
-  ): Promise<Dispatcher.ConnectData>
-  override connect (
-    options: H2ClientOptions,
-    callback: (err: Error | null, data: Dispatcher.ConnectData) => void
-  ): void
-}
-
-export declare namespace H2CClient {
-  export interface Options {
-    /** The maximum length of request headers in bytes. Default: Node.js' `--max-http-header-size` or `16384` (16KiB). */
-    maxHeaderSize?: number;
-    /** The amount of time, in milliseconds, the parser will wait to receive the complete HTTP headers (Node 14 and above only). Default: `300e3` milliseconds (300s). */
-    headersTimeout?: number;
-    /** TODO */
-    connectTimeout?: number;
-    /** The timeout after which a request will time out, in milliseconds. Monitors time between receiving body data. Use `0` to disable it entirely. Default: `300e3` milliseconds (300s). */
-    bodyTimeout?: number;
-    /** the timeout, in milliseconds, after which a socket without active requests will time out. Monitors time between activity on a connected socket. This value may be overridden by *keep-alive* hints from the server. Default: `4e3` milliseconds (4s). */
-    keepAliveTimeout?: number;
-    /** the maximum allowed `idleTimeout`, in milliseconds, when overridden by *keep-alive* hints from the server. Default: `600e3` milliseconds (10min). */
-    keepAliveMaxTimeout?: number;
-    /** A number of milliseconds subtracted from server *keep-alive* hints when overriding `idleTimeout` to account for timing inaccuracies caused by e.g. transport latency. Default: `1e3` milliseconds (1s). */
-    keepAliveTimeoutThreshold?: number;
-    /** TODO */
-    socketPath?: string;
-    /** The amount of concurrent requests to be sent over the single TCP/TLS connection according to [RFC7230](https://tools.ietf.org/html/rfc7230#section-6.3.2). Default: `1`. */
-    pipelining?: number;
-    /** If `true`, an error is thrown when the request content-length header doesn't match the length of the request body. Default: `true`. */
-    strictContentLength?: boolean;
-    /** TODO */
-    maxCachedSessions?: number;
-    /** TODO */
-    connect?: Omit<Partial<buildConnector.BuildOptions>, 'allowH2'> | buildConnector.connector;
-    /** TODO */
-    maxRequestsPerClient?: number;
-    /** TODO */
-    localAddress?: string;
-    /** Max response body size in bytes, -1 is disabled */
-    maxResponseSize?: number;
-    /** Enables a family autodetection algorithm that loosely implements section 5 of RFC 8305. */
-    autoSelectFamily?: boolean;
-    /** The amount of time in milliseconds to wait for a connection attempt to finish before trying the next address when using the `autoSelectFamily` option. */
-    autoSelectFamilyAttemptTimeout?: number;
-    /**
-     * @description Dictates the maximum number of concurrent streams for a single H2 session. It can be overridden by a SETTINGS remote frame.
-     * @default 100
-    */
-    maxConcurrentStreams?: number
-  }
-}
-
-export default H2CClient

package/node_modules/cheerio/node_modules/undici/types/handlers.d.ts

@@ -1,14 +0,0 @@
-import Dispatcher from './dispatcher'
-
-export declare class RedirectHandler implements Dispatcher.DispatchHandler {
-  constructor (
-    dispatch: Dispatcher.Dispatch,
-    maxRedirections: number,
-    opts: Dispatcher.DispatchOptions,
-    handler: Dispatcher.DispatchHandler
-  )
-}
-
-export declare class DecoratorHandler implements Dispatcher.DispatchHandler {
-  constructor (handler: Dispatcher.DispatchHandler)
-}

package/node_modules/cheerio/node_modules/undici/types/header.d.ts

@@ -1,160 +0,0 @@
-import { Autocomplete } from './utility'
-
-/**
- * The header type declaration of `undici`.
- */
-export type IncomingHttpHeaders = Record<string, string | string[] | undefined>
-
-type HeaderNames = Autocomplete<
-  | 'Accept'
-  | 'Accept-CH'
-  | 'Accept-Charset'
-  | 'Accept-Encoding'
-  | 'Accept-Language'
-  | 'Accept-Patch'
-  | 'Accept-Post'
-  | 'Accept-Ranges'
-  | 'Access-Control-Allow-Credentials'
-  | 'Access-Control-Allow-Headers'
-  | 'Access-Control-Allow-Methods'
-  | 'Access-Control-Allow-Origin'
-  | 'Access-Control-Expose-Headers'
-  | 'Access-Control-Max-Age'
-  | 'Access-Control-Request-Headers'
-  | 'Access-Control-Request-Method'
-  | 'Age'
-  | 'Allow'
-  | 'Alt-Svc'
-  | 'Alt-Used'
-  | 'Authorization'
-  | 'Cache-Control'
-  | 'Clear-Site-Data'
-  | 'Connection'
-  | 'Content-Disposition'
-  | 'Content-Encoding'
-  | 'Content-Language'
-  | 'Content-Length'
-  | 'Content-Location'
-  | 'Content-Range'
-  | 'Content-Security-Policy'
-  | 'Content-Security-Policy-Report-Only'
-  | 'Content-Type'
-  | 'Cookie'
-  | 'Cross-Origin-Embedder-Policy'
-  | 'Cross-Origin-Opener-Policy'
-  | 'Cross-Origin-Resource-Policy'
-  | 'Date'
-  | 'Device-Memory'
-  | 'ETag'
-  | 'Expect'
-  | 'Expect-CT'
-  | 'Expires'
-  | 'Forwarded'
-  | 'From'
-  | 'Host'
-  | 'If-Match'
-  | 'If-Modified-Since'
-  | 'If-None-Match'
-  | 'If-Range'
-  | 'If-Unmodified-Since'
-  | 'Keep-Alive'
-  | 'Last-Modified'
-  | 'Link'
-  | 'Location'
-  | 'Max-Forwards'
-  | 'Origin'
-  | 'Permissions-Policy'
-  | 'Priority'
-  | 'Proxy-Authenticate'
-  | 'Proxy-Authorization'
-  | 'Range'
-  | 'Referer'
-  | 'Referrer-Policy'
-  | 'Retry-After'
-  | 'Sec-Fetch-Dest'
-  | 'Sec-Fetch-Mode'
-  | 'Sec-Fetch-Site'
-  | 'Sec-Fetch-User'
-  | 'Sec-Purpose'
-  | 'Sec-WebSocket-Accept'
-  | 'Server'
-  | 'Server-Timing'
-  | 'Service-Worker-Navigation-Preload'
-  | 'Set-Cookie'
-  | 'SourceMap'
-  | 'Strict-Transport-Security'
-  | 'TE'
-  | 'Timing-Allow-Origin'
-  | 'Trailer'
-  | 'Transfer-Encoding'
-  | 'Upgrade'
-  | 'Upgrade-Insecure-Requests'
-  | 'User-Agent'
-  | 'Vary'
-  | 'Via'
-  | 'WWW-Authenticate'
-  | 'X-Content-Type-Options'
-  | 'X-Frame-Options'
->
-
-type IANARegisteredMimeType = Autocomplete<
-  | 'audio/aac'
-  | 'video/x-msvideo'
-  | 'image/avif'
-  | 'video/av1'
-  | 'application/octet-stream'
-  | 'image/bmp'
-  | 'text/css'
-  | 'text/csv'
-  | 'application/vnd.ms-fontobject'
-  | 'application/epub+zip'
-  | 'image/gif'
-  | 'application/gzip'
-  | 'text/html'
-  | 'image/x-icon'
-  | 'text/calendar'
-  | 'image/jpeg'
-  | 'text/javascript'
-  | 'application/json'
-  | 'application/ld+json'
-  | 'audio/x-midi'
-  | 'audio/mpeg'
-  | 'video/mp4'
-  | 'video/mpeg'
-  | 'audio/ogg'
-  | 'video/ogg'
-  | 'application/ogg'
-  | 'audio/opus'
-  | 'font/otf'
-  | 'application/pdf'
-  | 'image/png'
-  | 'application/rtf'
-  | 'image/svg+xml'
-  | 'image/tiff'
-  | 'video/mp2t'
-  | 'font/ttf'
-  | 'text/plain'
-  | 'application/wasm'
-  | 'video/webm'
-  | 'audio/webm'
-  | 'image/webp'
-  | 'font/woff'
-  | 'font/woff2'
-  | 'application/xhtml+xml'
-  | 'application/xml'
-  | 'application/zip'
-  | 'video/3gpp'
-  | 'video/3gpp2'
-  | 'model/gltf+json'
-  | 'model/gltf-binary'
->
-
-type KnownHeaderValues = {
-  'content-type': IANARegisteredMimeType
-}
-
-export type HeaderRecord = {
-  [K in HeaderNames | Lowercase<HeaderNames>]?: Lowercase<K> extends keyof KnownHeaderValues
-    ? KnownHeaderValues[Lowercase<K>]
-    : string
-}