@alessiofrittoli/fetcher 1.1.0 → 2.0.0

package/README.md

@@ -1,34 +1,57 @@
-# Fetcher 🔭
-
-[![NPM Latest Version][version-badge]][npm-url] [![Coverage Status][coverage-badge]][coverage-url] [![Socket Status][socket-badge]][socket-url] [![NPM Monthly Downloads][downloads-badge]][npm-url] [![Dependencies][deps-badge]][deps-url]
-
-[![GitHub Sponsor][sponsor-badge]][sponsor-url]
-
-[version-badge]: https://img.shields.io/npm/v/%40alessiofrittoli%2Ffetcher
-[npm-url]: https://npmjs.org/package/%40alessiofrittoli%2Ffetcher
-[coverage-badge]: https://coveralls.io/repos/github/alessiofrittoli/fetcher/badge.svg
-[coverage-url]: https://coveralls.io/github/alessiofrittoli/fetcher
-[socket-badge]: https://socket.dev/api/badge/npm/package/@alessiofrittoli/fetcher
-[socket-url]: https://socket.dev/npm/package/@alessiofrittoli/fetcher/overview
-[downloads-badge]: https://img.shields.io/npm/dm/%40alessiofrittoli%2Ffetcher.svg
-[deps-badge]: https://img.shields.io/librariesio/release/npm/%40alessiofrittoli%2Ffetcher
-[deps-url]: https://libraries.io/npm/%40alessiofrittoli%2Ffetcher
+<h1 align="center">Fetcher 🔭</h1>
+<h2 align="center">
+  Typescript fetch/xhr utilities
+</h2>
+<p align="center">
+  <a href="https://npmjs.org/package/@alessiofrittoli/fetcher">
+    <img src="https://img.shields.io/npm/v/@alessiofrittoli/fetcher" alt="Latest version"/>
+  </a>
+  <a href="https://coveralls.io/github/alessiofrittoli/fetcher">
+    <img src="https://coveralls.io/repos/github/alessiofrittoli/fetcher/badge.svg" alt="Test coverage"/>
+  </a>
+  <a href="https://socket.dev/npm/package/@alessiofrittoli/fetcher/overview">
+    <img src="https://socket.dev/api/badge/npm/package/@alessiofrittoli/fetcher" alt="Socket Security score"/>
+  </a>
+  <a href="https://npmjs.org/package/@alessiofrittoli/fetcher">
+    <img src="https://img.shields.io/npm/dm/@alessiofrittoli/fetcher.svg" alt="npm downloads"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/fetcher">
+    <img src="https://badgen.net/bundlephobia/dependency-count/@alessiofrittoli/fetcher" alt="Dependencies"/>
+  </a>
+  <a href="https://libraries.io/npm/%40alessiofrittoli%2Ffetcher">
+    <img src="https://img.shields.io/librariesio/release/npm/@alessiofrittoli/fetcher" alt="Dependencies status"/>
+  </a>
+</p>
+<p align="center">
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/fetcher">
+    <img src="https://badgen.net/bundlephobia/min/@alessiofrittoli/fetcher" alt="minified"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/fetcher">
+    <img src="https://badgen.net/bundlephobia/minzip/@alessiofrittoli/fetcher" alt="minizipped"/>
+  </a>
+  <a href="https://bundlephobia.com/package/@alessiofrittoli/fetcher">
+    <img src="https://badgen.net/bundlephobia/tree-shaking/@alessiofrittoli/fetcher" alt="Tree shakable"/>
+  </a>
+</p>
+<p align="center">
+  <a href="https://github.com/sponsors/alessiofrittoli">
+    <img src="https://img.shields.io/static/v1?label=Fund%20this%20package&message=%E2%9D%A4&logo=GitHub&color=%23DB61A2" alt="Fund this package"/>
+  </a>
+</p>
 
 [sponsor-badge]: https://img.shields.io/static/v1?label=Fund%20this%20package&message=%E2%9D%A4&logo=GitHub&color=%23DB61A2
 [sponsor-url]: https://github.com/sponsors/alessiofrittoli
 
-## Typescript fetch/xhr utilities
+### Table of Content
 
-### Table of Contents
-
-- [Getting started](#getting-started)
 - [Development](#development)
-  - [Install depenendencies](#install-depenendencies)
-  - [Build the source code](#build-the-source-code)
-  - [ESLint](#eslint)
-  - [Jest](#jest)
-- [Contributing](#contributing)
-- [Security](#security)
+  - [Local development](#local-development)
+  - [Production build](#production-build)
+  - [Unit tests](#unit-tests)
+    - [Run tests with coverage](#run-tests-with-coverage)
+  - [Contributing](#contributing)
+  - [Security](#security)
+- [API Reference](#api-reference)
 - [Credits](#made-with-)
 
 ---
@@ -51,39 +74,43 @@ pnpm i @alessiofrittoli/fetcher
 
 ### Development
 
-#### Install depenendencies
+Run the following to start development
 
-```bash
-npm install
-```
+```shell
+nvm use
 
-or using `pnpm`
-
-```bash
 pnpm i
 ```
 
-#### Build the source code
+#### Local development
 
-Run the following command to test and build code for distribution.
+Run the following
 
-```bash
-pnpm build
+```shell
+pnpm dev
 ```
 
-#### [ESLint](https://www.npmjs.com/package/eslint)
+This will generate unminified output code, sourcemaps and will enable source file watcher.
 
-warnings / errors check.
+---
 
-```bash
-pnpm lint
+#### Production build
+
+Run the following to create a local production build
+
+```shell
+pnpm build
 ```
 
-#### [Jest](https://npmjs.com/package/jest)
+This will generate minified output code without sourcemaps.
+
+---
+
+#### Unit tests
 
 Run all the defined test suites by running the following:
 
-```bash
+```shell
 # Run tests and watch file changes.
 pnpm test:watch
 
@@ -91,21 +118,21 @@ pnpm test:watch
 pnpm test:ci
 ```
 
-- See [`package.json`](./package.json) file scripts for more info.
+---
 
-Run tests with coverage.
+##### Run tests with coverage
 
 An HTTP server is then started to serve coverage files from `./coverage` folder.
 
 ⚠️ You may see a blank page the first time you run this command. Simply refresh the browser to see the updates.
 
-```bash
-test:coverage:serve
+```shell
+pnpm test:coverage:serve
 ```
 
 ---
 
-### Contributing
+#### Contributing
 
 Contributions are truly welcome!
 
@@ -117,10 +144,18 @@ Help keep this project up to date with [GitHub Sponsor][sponsor-url].
 
 ---
 
-### Security
+#### Security
 
 If you believe you have found a security vulnerability, we encourage you to **_responsibly disclose this and NOT open a public issue_**. We will investigate all legitimate reports. Email `security@alessiofrittoli.it` to disclose any security vulnerabilities.
 
+---
+
+### API Reference
+
+⚠️ Docs coming soon ⚠️
+
+---
+
 ### Made with ☕
 
 <table style='display:flex;gap:20px;'>

package/dist/error/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@alessiofrittoli/exception/code");const t={XHR_NOT_AVAILABLE:`ERR:XHRNOTAVAILABLE`,XHR_INVALID_STATE:`ERR:XHRINVALIDSTATE`,XHR_DESTROYED:`ERR:XHRDESTROYED`},n={...e.ErrorCode,...t};exports.ErrorCode=n,exports.Request=t;

package/dist/error/index.d.cts

@@ -0,0 +1,2 @@
+import { n as Request, t as ErrorCode } from "../index-CQSGH5s-.cjs";
+export { ErrorCode, Request };

package/dist/error/index.d.mts

@@ -0,0 +1,2 @@
+import { n as Request, t as ErrorCode } from "../index-CQSGH5s-.mjs";
+export { ErrorCode, Request };

package/dist/error/index.mjs

@@ -0,0 +1 @@
+import{ErrorCode as e}from"@alessiofrittoli/exception/code";const t={XHR_NOT_AVAILABLE:`ERR:XHRNOTAVAILABLE`,XHR_INVALID_STATE:`ERR:XHRINVALIDSTATE`,XHR_DESTROYED:`ERR:XHRDESTROYED`},n={...e,...t};export{n as ErrorCode,t as Request};

package/dist/getErrorFromResponse-CIppVMTN.mjs

@@ -0,0 +1 @@
+import{Exception as e}from"@alessiofrittoli/exception";import{binaryToString as t}from"@alessiofrittoli/crypto-buffer";import{isJson as n}from"@alessiofrittoli/web-utils";const r=async r=>{let{response:i,responseType:a}=r;switch(a){case`document`:return null;case`json`:{let t=i;return t&&e.isException(t)?new e(t):null}default:{let r=a===`arraybuffer`?t(i):a===`blob`?await i.text():i;if(n(r)){let t=JSON.parse(r);if(e.isException(t))return new e(t)}return null}}};export{r as getErrorFromResponse};

package/dist/getErrorFromResponse-D3OARgUA.cjs

@@ -0,0 +1 @@
+let e=require("@alessiofrittoli/exception"),t=require("@alessiofrittoli/crypto-buffer"),n=require("@alessiofrittoli/web-utils");const r=async r=>{let{response:i,responseType:a}=r;switch(a){case`document`:return null;case`json`:{let t=i;return t&&e.Exception.isException(t)?new e.Exception(t):null}default:{let r=a===`arraybuffer`?(0,t.binaryToString)(i):a===`blob`?await i.text():i;if((0,n.isJson)(r)){let t=JSON.parse(r);if(e.Exception.isException(t))return new e.Exception(t)}return null}}};exports.getErrorFromResponse=r;

package/dist/globals/index.d.cts

@@ -0,0 +1,15 @@
+//#region src/globals/index.d.ts
+declare global {
+  interface RequestInit {
+    /**
+     * The expected ResponseType.
+     *
+     */
+    responseType?: XMLHttpRequestResponseType | 'formdata';
+  }
+  interface ProgressEvent {
+    readonly type: keyof XMLHttpRequestEventTargetEventMap;
+  }
+}
+//#endregion
+export {};

package/dist/globals/index.d.mts

@@ -0,0 +1,15 @@
+//#region src/globals/index.d.ts
+declare global {
+  interface RequestInit {
+    /**
+     * The expected ResponseType.
+     *
+     */
+    responseType?: XMLHttpRequestResponseType | 'formdata';
+  }
+  interface ProgressEvent {
+    readonly type: keyof XMLHttpRequestEventTargetEventMap;
+  }
+}
+//#endregion
+export {};

package/dist/globals/index.mjs

@@ -0,0 +1 @@
+export{};

package/dist/index-B8rmZCit.d.mts

@@ -0,0 +1,398 @@
+import { t as ErrorCode } from "./index-CQSGH5s-.mjs";
+import { Exception } from "@alessiofrittoli/exception";
+import { UrlInput } from "@alessiofrittoli/url-utils";
+import { AbortError, AbortErrorOptions } from "@alessiofrittoli/exception/abort";
+import { AbortController } from "@alessiofrittoli/abort-controller";
+import { UUID } from "@alessiofrittoli/math-utils";
+import { EventEmitter, Listener } from "@alessiofrittoli/event-emitter";
+//#region src/fetch/types.d.ts
+declare namespace Fetch {
+  type Method = RequestMethod;
+  type Result<T> = {
+    /**
+     * The received Response.
+     *
+     */
+    response: Response | null;
+    /**
+     * The received Response Headers.
+     *
+     */
+    headers: Headers | null;
+  } & ({
+    /** The parsed data. */
+    data: T;
+    error: null;
+  } | {
+    /** The parsed error. */
+    error: Exception;
+    data: null;
+  });
+  type ReturnDataType<T, U extends RequestInit = RequestInit> = T extends undefined ? U['responseType'] extends 'blob' ? Blob : U['responseType'] extends 'formdata' ? FormData : U['responseType'] extends 'arraybuffer' ? ArrayBuffer : string : T;
+  type OnFulfilledCallback<V> = (response: Response) => Fetch.Result<V> | PromiseLike<Fetch.Result<V>>;
+}
+//#endregion
+//#region src/xhr/index.d.ts
+declare class Xhr<TReturn = unknown> extends EventEmitter<XHR.Event.Map<TReturn>> {
+  /**
+   * The XMLHttpRequest instance.
+   *
+   */
+  readonly request: XMLHttpRequest;
+  /**
+   * The current request UUID.
+   *
+   */
+  protected _requestId: UUID;
+  /**
+   * The current request UUID.
+   *
+   */
+  get requestId(): typeof this._requestId;
+  protected set requestId(value: typeof this._requestId);
+  /**
+   * Enables debug logging.
+   *
+   * @default false
+   */
+  protected _debug: boolean;
+  /**
+   * Enables debug logging.
+   *
+   * @default false
+   */
+  get debug(): typeof this._debug;
+  protected set debug(value: typeof this._debug);
+  /**
+   * The AbortController used to cancel network activities.
+   *
+   */
+  protected _controller?: AbortController<ErrorCode>;
+  /**
+   * The AbortController used to cancel network activities.
+   *
+   */
+  get controller(): typeof this._controller;
+  protected set controller(value: typeof this._controller);
+  /**
+   * The Xhr.timeout property is an unsigned long representing the number of milliseconds a request can take before
+   * automatically being terminated. The default value is 0, which means there is no timeout.
+   * When a timeout happens, a timeout event is fired.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/timeout)
+   *
+   * @default 0
+   */
+  protected _timeout: number | null;
+  /**
+   * The Xhr.timeout property is an unsigned long representing the number of milliseconds a request can take before
+   * automatically being terminated. The default value is 0, which means there is no timeout.
+   * When a timeout happens, a timeout event is fired.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/timeout)
+   *
+   * @default 0
+   */
+  get timeout(): typeof this._timeout;
+  protected set timeout(value: typeof this._timeout);
+  /**
+   * An object with `username` and `password` to send along with the request.
+   *
+   */
+  protected _credentials?: XHR.Credentials | null;
+  /**
+   * An object with `username` and `password` to send along with the request.
+   *
+   */
+  get credentials(): typeof this._credentials;
+  protected set credentials(value: typeof this._credentials);
+  /**
+   * The Xhr.withCredentials property is a boolean value that indicates whether or not cross-site Access-Control
+   * requests should be made using credentials such as cookies, authentication headers
+   * or TLS client certificates. Setting `withCredentials` has no effect on same-origin requests.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/withCredentials)
+   *
+   * @default false
+   */
+  protected _withCredentials: boolean | null;
+  /**
+   * The Xhr.withCredentials property is a boolean value that indicates whether or not cross-site Access-Control
+   * requests should be made using credentials such as cookies, authentication headers
+   * or TLS client certificates. Setting `withCredentials` has no effect on same-origin requests.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/withCredentials)
+   *
+   * @default false
+   */
+  get withCredentials(): typeof this._withCredentials;
+  protected set withCredentials(value: typeof this._withCredentials);
+  /**
+   * Indicates whether to automatically set the XHR response type based on the Response Content-Type Header.
+   *
+   */
+  private autoResponseType;
+  /**
+   * Indicates whther event listeners have been registered.
+   *
+   */
+  private listenersRegistered;
+  /** XHR progress events. */
+  static readonly ProgressEvents: XHR.Event.Progress[];
+  private static MapReadyStateToXhrEvent;
+  /**
+   * Construct a new instance of Xhr.
+   *
+   * @param options Required options for a proper initialization.
+   */
+  constructor(options?: XHR.ConstructOptions);
+  /**
+   * Initialise XMLHttpRequest.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private init;
+  /**
+   * Send XMLHttpRequest.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  send<T = TReturn>(options: XHR.Options): Xhr<T>;
+  /**
+   * Upload files via XMLHttpRequest.
+   *
+   * Use `Xhr.request.upload` to listen upload events.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  upload<T = TReturn>(options: XHR.UploadOptions): Xhr<T>;
+  /**
+   * Get formatted response.
+   *
+   * @returns The response text or an object from a json response.
+   */
+  getResponse<T = TReturn>(): T | null | undefined;
+  /**
+   * Cancels any network activity.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  abort<T = ErrorCode, U = TReturn>(reason?: string, options?: AbortErrorOptions<T>): Xhr<U>;
+  /**
+   * Set the request headers.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  setRequestHeaders<T = TReturn>(headers: Headers | HeadersInit): Xhr<T>;
+  /**
+   * Get Response Header.
+   *
+   * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/getResponseHeader)
+   *
+   * @param	name The Header name.
+   * @returns	The Response Header value, `null` if none has been found.
+   */
+  getResponseHeader<T = TReturn>(name: string): string | null;
+  /**
+   * Cancel any network activity an unregister all listeners.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  destroy<T = TReturn>(): Xhr<T>;
+  /**
+   * Prints to `stdout` with newline.
+   *
+   * @param	data The data print out.
+   * @returns	The current `Xhr` instance for chaining purposes.
+   */
+  log<T = TReturn>(...data: any[]): Xhr<T>;
+  /**
+   * On success functions.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private success;
+  /**
+   * On error functions.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private error;
+  /**
+   * Get XMLHttpRequest not available error.
+   *
+   * @returns The newly created error with `ErrorCode.XHR_NOT_AVAILABLE` code.
+   */
+  private getXhrNotAvailableError;
+  private setupAbortController;
+  /**
+   * Automatically set `XMLHttpRequestResponseType` based on the received Response `Content-Type` Header.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private setResponseTypeFromResponseHeaders;
+  /**
+   * Convert MIME `Content-Type` to `XMLHttpRequestResponseType`.
+   *
+   * @param	contentType (Optional) The MIME `Content-Type`. Default: `Content-Type` Response Header.
+   * @returns	The `XMLHttpRequestResponseType` based on the given MIME `Content-Type`.
+   */
+  private contentTypeToResponseType;
+  /**
+   * Get `Content-Type` Response Header.
+   *
+   * @returns The Response Header value, `null` if none has been found.
+   */
+  getResponseContentType(): string | null;
+  /**
+   * Handle `readystatechange` events.
+   *
+   * @param event The Event interface.
+   */
+  private onReadyStateChange;
+  /**
+   * Handle and emit progress events.
+   *
+   * @param event The ProgressEvent interface.
+   */
+  private onProgressChange;
+  /**
+   * Executed when `Xhr.controller` get aborted through `Xhr.abort()` or `Xhr.controller.abort()` methods.
+   *
+   */
+  private onControllerSignalAbort;
+  /**
+   * Emit ReadyStateChange events.
+   *
+   */
+  private emitReadyStateEvent;
+  /**
+   * Add listeners to the XMLHttpRequest instance.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private registerListeners;
+  /**
+   * Remove listeners attached to the XMLHttpRequest instance.
+   *
+   * @returns The current `Xhr` instance for chaining purposes.
+   */
+  private unregisterListeners;
+}
+//#endregion
+//#region src/xhr/types.d.ts
+declare namespace XHR {
+  type Method = RequestMethod;
+  type ReadyState = typeof XMLHttpRequest.UNSENT | typeof XMLHttpRequest.OPENED | typeof XMLHttpRequest.HEADERS_RECEIVED | typeof XMLHttpRequest.LOADING | typeof XMLHttpRequest.DONE;
+  type Credentials = {
+    /**
+     * The optional user name to use for authentication purposes.
+     *
+     * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/open#user)
+     */
+    username?: string | null;
+    /**
+     * The optional user password to use for authentication purposes.
+     *
+     * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/open#password)
+     */
+    password?: string | null;
+  };
+  namespace Event {
+    type Progress = keyof XMLHttpRequestEventTargetEventMap;
+    type ReadyStateChange = 'readystatechange' | 'unsent' | 'opened' | 'headers' | 'loading' | 'done';
+    type Map<TReturn = unknown> = {
+      init: [xhr: Xhr<TReturn>];
+      send: [xhr: Xhr<TReturn>];
+      success: [response: TReturn | null | undefined, xhr: Xhr<TReturn>];
+      error: [error: Exception<ErrorCode>, xhr: Xhr<TReturn>];
+      abort: [reason: AbortError<ErrorCode>, event: ProgressEvent<XMLHttpRequestEventTarget>, xhr: Xhr<TReturn>];
+    } & { [event in ReadyStateChange]: [event: Event, xhr: Xhr<TReturn>]; } & { [event in Exclude<XHR.Event.Progress, 'abort' | 'error'>]: [event: ProgressEvent<XMLHttpRequestEventTarget>, xhr: Xhr<TReturn>]; };
+    type Listener<TEvent extends keyof XHR.Event.Map<TReturn>, TReturn = unknown> = Listener<XHR.Event.Map<TReturn>, TEvent>;
+  }
+  interface ConstructOptions {
+    /**
+     * Enables debug logging.
+     *
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Automatically set the `responseType` from Response Content-Type Header if set to `true` and `responseType` hasn't been set.
+     *
+     * @default true
+     */
+    autoResponseType?: boolean;
+    /**
+     * The Xhr.withCredentials property is a boolean value that indicates whether or not cross-site Access-Control
+     * requests should be made using credentials such as cookies, authentication headers
+     * or TLS client certificates. Setting `withCredentials` has no effect on same-origin requests.
+     *
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/XMLHttpRequest/withCredentials)
+     *
+     * @default false
+     */
+    withCredentials?: XMLHttpRequest['withCredentials'] | null;
+    /**
+     * An object with `username` and `password` to send along with the request.
+     *
+     */
+    credentials?: XHR.Credentials | null;
+    /**
+     * Can be set to a time in milliseconds. When set to a non-zero value will cause fetching to terminate after the given time has passed. When the time has passed, the request has not yet completed, and this's synchronous flag is unset, a timeout event will then be dispatched, or a "TimeoutError" DOMException will be thrown otherwise (for the send() method).
+     *
+     * When set: throws an "InvalidAccessError" DOMException if the synchronous flag is set and current global object is a Window object.
+     *
+     * @default 0
+     */
+    timeout?: XMLHttpRequest['timeout'] | null;
+  }
+  interface InitOptions extends XHR.ConstructOptions {
+    /**
+     * The URL string or URL object the request is made to.
+     *
+     */
+    url: UrlInput;
+    /**
+     * The request method.
+     *
+     * @default 'GET'
+     */
+    method?: RequestMethod;
+    /**
+     * The request HeadersInit object.
+     *
+     */
+    headers?: Headers | HeadersInit;
+    /**
+     * A custom controller object that allows you to abort one or more DOM requests as and when desired.
+     *
+     */
+    controller?: AbortController<ErrorCode>;
+    /**
+     * The expected Response Type.
+     *
+     */
+    responseType?: XMLHttpRequestResponseType;
+  }
+  interface Options extends Omit<XHR.InitOptions, 'eventsTarget'> {
+    /**
+     * The body object to send.
+     *
+     */
+    body?: Document | XMLHttpRequestBodyInit;
+  }
+  interface UploadOptions extends Omit<XHR.Options, 'body'> {
+    /**
+     * The HTMLInputElement `FileList` or an array of `File` to upload.
+     *
+     * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/files)
+     */
+    files: File[] | FileList;
+  }
+}
+//#endregion
+//#region src/types/index.d.ts
+type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+//#endregion
+export { Fetch as i, XHR as n, Xhr as r, RequestMethod as t };

package/dist/index-CQSGH5s-.d.cts

@@ -0,0 +1,25 @@
+import { ValueOf } from "@alessiofrittoli/type-utils";
+//#region src/error/index.d.ts
+declare const Request: {
+  readonly XHR_NOT_AVAILABLE: "ERR:XHRNOTAVAILABLE";
+  readonly XHR_INVALID_STATE: "ERR:XHRINVALIDSTATE";
+  readonly XHR_DESTROYED: "ERR:XHRDESTROYED";
+};
+declare const ErrorCode: {
+  readonly XHR_NOT_AVAILABLE: "ERR:XHRNOTAVAILABLE";
+  readonly XHR_INVALID_STATE: "ERR:XHRINVALIDSTATE";
+  readonly XHR_DESTROYED: "ERR:XHRDESTROYED";
+  readonly UNKNOWN: "ERR:UNKNOWN";
+  readonly ABORT: "ERR:ABORT";
+  readonly EMPTY_VALUE: "ERR:EMPTYVALUE";
+  readonly WRONG_VALUE: "ERR:WRONGVALUE";
+  readonly EXPIRED: "ERR:EXPIRED";
+  readonly TOO_EARLY: "ERR:TOOEARLY";
+  readonly TOO_MANY: "ERR:TOOMANY";
+  readonly QUOTA_REACHED: "ERR:QUOTAREACHED";
+  readonly NOT_FOUND: "ERR:NOTFOUND";
+  readonly OFFLINE: "ERR:INTERNETDISCONNECTED";
+};
+type ErrorCode = ValueOf<typeof ErrorCode>;
+//#endregion
+export { Request as n, ErrorCode as t };