@alessiofrittoli/fetcher 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,153 @@
+# 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
+
+[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 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)
+- [Credits](#made-with-)
+
+---
+
+### Getting started
+
+Run the following command to start using `fetcher` in your projects:
+
+```bash
+npm i @alessiofrittoli/fetcher
+```
+
+or using `pnpm`
+
+```bash
+pnpm i @alessiofrittoli/fetcher
+```
+
+---
+
+### Development
+
+#### Install depenendencies
+
+```bash
+npm install
+```
+
+or using `pnpm`
+
+```bash
+pnpm i
+```
+
+#### Build the source code
+
+Run the following command to test and build code for distribution.
+
+```bash
+pnpm build
+```
+
+#### [ESLint](https://www.npmjs.com/package/eslint)
+
+warnings / errors check.
+
+```bash
+pnpm lint
+```
+
+#### [Jest](https://npmjs.com/package/jest)
+
+Run all the defined test suites by running the following:
+
+```bash
+# Run tests and watch file changes.
+pnpm test:watch
+
+# Run tests in a CI environment.
+pnpm test:ci
+```
+
+- See [`package.json`](./package.json) file scripts for more info.
+
+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
+```
+
+---
+
+### Contributing
+
+Contributions are truly welcome!
+
+Please refer to the [Contributing Doc](./CONTRIBUTING.md) for more information on how to start contributing to this project.
+
+Help keep this project up to date with [GitHub Sponsor][sponsor-url].
+
+[![GitHub Sponsor][sponsor-badge]][sponsor-url]
+
+---
+
+### 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.
+
+### Made with ☕
+
+<table style='display:flex;gap:20px;'>
+  <tbody>
+    <tr>
+      <td>
+        <img alt="avatar" src='https://avatars.githubusercontent.com/u/35973186' style='width:60px;border-radius:50%;object-fit:contain;'>
+      </td>
+      <td>
+        <table style='display:flex;gap:2px;flex-direction:column;'>
+          <tbody>
+              <tr>
+                <td>
+                  <a href='https://github.com/alessiofrittoli' target='_blank' rel='noopener'>Alessio Frittoli</a>
+                </td>
+              </tr>
+              <tr>
+                <td>
+                  <small>
+                    <a href='https://alessiofrittoli.it' target='_blank' rel='noopener'>https://alessiofrittoli.it</a> |
+                    <a href='mailto:info@alessiofrittoli.it' target='_blank' rel='noopener'>info@alessiofrittoli.it</a>
+                  </small>
+                </td>
+              </tr>
+          </tbody>
+        </table>
+      </td>
+    </tr>
+  </tbody>
+</table>

package/dist/chunk-HNNMLJIA.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _code = require('@alessiofrittoli/exception/code');var o=(r=>(r.XHR_NOT_AVAILABLE="ERR:XHRNOTAVAILABLE",r.XHR_INVALID_STATE="ERR:XHRINVALIDSTATE",r))(o||{}),p= exports.b ={Exception:_code.ErrorCode,Request:o};exports.a = o; exports.b = p;

package/dist/chunk-LOWOZ6LK.mjs

@@ -0,0 +1 @@
+import{ErrorCode as E}from"@alessiofrittoli/exception/code";var o=(r=>(r.XHR_NOT_AVAILABLE="ERR:XHRNOTAVAILABLE",r.XHR_INVALID_STATE="ERR:XHRINVALIDSTATE",r))(o||{}),t={Exception:E,Request:o};export{o as a,t as b};

package/dist/error.d.mts

@@ -0,0 +1,13 @@
+import { ErrorCode as ErrorCode$1 } from '@alessiofrittoli/exception/code';
+
+declare enum Request {
+    XHR_NOT_AVAILABLE = "ERR:XHRNOTAVAILABLE",
+    XHR_INVALID_STATE = "ERR:XHRINVALIDSTATE"
+}
+declare const ErrorCode: {
+    Exception: typeof ErrorCode$1;
+    Request: typeof Request;
+};
+type ErrorCode = MergedEnumValue<typeof ErrorCode>;
+
+export { ErrorCode, Request };

package/dist/error.d.ts

@@ -0,0 +1,13 @@
+import { ErrorCode as ErrorCode$1 } from '@alessiofrittoli/exception/code';
+
+declare enum Request {
+    XHR_NOT_AVAILABLE = "ERR:XHRNOTAVAILABLE",
+    XHR_INVALID_STATE = "ERR:XHRINVALIDSTATE"
+}
+declare const ErrorCode: {
+    Exception: typeof ErrorCode$1;
+    Request: typeof Request;
+};
+type ErrorCode = MergedEnumValue<typeof ErrorCode>;
+
+export { ErrorCode, Request };

package/dist/error.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkHNNMLJIAjs = require('./chunk-HNNMLJIA.js');exports.ErrorCode = _chunkHNNMLJIAjs.b; exports.Request = _chunkHNNMLJIAjs.a;

package/dist/error.mjs

@@ -0,0 +1 @@
+import{a,b}from"./chunk-LOWOZ6LK.mjs";export{b as ErrorCode,a as Request};

package/dist/fetch.d.mts

@@ -0,0 +1,23 @@
+import { AbortSignal } from '@alessiofrittoli/abort-controller';
+import { F as Fetch } from './types-DuGUXaTD.mjs';
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/url-utils';
+import './error.mjs';
+import '@alessiofrittoli/exception/code';
+
+interface RequestInit extends globalThis.RequestInit {
+    signal?: AbortSignal;
+}
+/**
+ * An extended version of the global fetch API.
+ *
+ * @param input			The RequestInfo | URL.
+ * @param init			The RequestInit.
+ * @param onfulfilled	(Optional) A callback to run on Request fulfill. This could be used to alter the returned result.
+ * @returns	An object with the parsed Request data, Request error, Request Response instance and Request Headers.
+ */
+declare const fetch: <T, U extends RequestInit = RequestInit, V = Fetch.ReturnDataType<T, U>>(input: RequestInfo | URL, init?: U, onfulfilled?: Fetch.OnFulfilledCallback<V>) => Promise<Fetch.Result<V>>;
+
+export { fetch };

package/dist/fetch.d.ts

@@ -0,0 +1,23 @@
+import { AbortSignal } from '@alessiofrittoli/abort-controller';
+import { F as Fetch } from './types-CVc-rxXe.js';
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/url-utils';
+import './error.js';
+import '@alessiofrittoli/exception/code';
+
+interface RequestInit extends globalThis.RequestInit {
+    signal?: AbortSignal;
+}
+/**
+ * An extended version of the global fetch API.
+ *
+ * @param input			The RequestInfo | URL.
+ * @param init			The RequestInit.
+ * @param onfulfilled	(Optional) A callback to run on Request fulfill. This could be used to alter the returned result.
+ * @returns	An object with the parsed Request data, Request error, Request Response instance and Request Headers.
+ */
+declare const fetch: <T, U extends RequestInit = RequestInit, V = Fetch.ReturnDataType<T, U>>(input: RequestInfo | URL, init?: U, onfulfilled?: Fetch.OnFulfilledCallback<V>) => Promise<Fetch.Result<V>>;
+
+export { fetch };

package/dist/fetch.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkHNNMLJIAjs = require('./chunk-HNNMLJIA.js');var _exception = require('@alessiofrittoli/exception');var h=(l,a,s)=>globalThis.fetch(l,a).then(async t=>{let o=t.headers,c=o.get("Content-Type"),i=_optionalChain([c, 'optionalAccess', _ => _.includes, 'call', _2 => _2("application/json")])||_optionalChain([a, 'optionalAccess', _3 => _3.responseType])==="json",u=_optionalChain([c, 'optionalAccess', _4 => _4.includes, 'call', _5 => _5("form-data")])||_optionalChain([a, 'optionalAccess', _6 => _6.responseType])==="formdata",e={response:t,headers:o,data:null,error:null};if(t.ok)return s?s(t):i?(e.data=await t.json(),e):u?(e.data=await t.formData(),e):_optionalChain([a, 'optionalAccess', _7 => _7.responseType])==="arraybuffer"?(e.data=await t.arrayBuffer(),e):_optionalChain([a, 'optionalAccess', _8 => _8.responseType])==="blob"?(e.data=await t.blob(),e):(e.data=await t.text(),e);if(i)throw await t.json();return e.error=new (0, _exception.Exception)(await t.text()||t.statusText,{code:_chunkHNNMLJIAjs.b.Exception.UNKNOWN}),e}).catch(t=>({data:null,headers:null,response:null,error:_exception.Exception.isException(t)?new (0, _exception.Exception)(t.message,{...t}):new (0, _exception.Exception)(t.message,{code:_chunkHNNMLJIAjs.b.Exception.UNKNOWN,name:t.name,cause:t})}));exports.fetch = h;

package/dist/fetch.mjs

@@ -0,0 +1 @@
+import{b as n}from"./chunk-LOWOZ6LK.mjs";import{Exception as r}from"@alessiofrittoli/exception";var m=(l,a,s)=>globalThis.fetch(l,a).then(async t=>{let o=t.headers,c=o.get("Content-Type"),i=c?.includes("application/json")||a?.responseType==="json",u=c?.includes("form-data")||a?.responseType==="formdata",e={response:t,headers:o,data:null,error:null};if(t.ok)return s?s(t):i?(e.data=await t.json(),e):u?(e.data=await t.formData(),e):a?.responseType==="arraybuffer"?(e.data=await t.arrayBuffer(),e):a?.responseType==="blob"?(e.data=await t.blob(),e):(e.data=await t.text(),e);if(i)throw await t.json();return e.error=new r(await t.text()||t.statusText,{code:n.Exception.UNKNOWN}),e}).catch(t=>({data:null,headers:null,response:null,error:r.isException(t)?new r(t.message,{...t}):new r(t.message,{code:n.Exception.UNKNOWN,name:t.name,cause:t})}));export{m as fetch};

package/dist/getErrorFromResponse-7V2YFS4F.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _webutils = require('@alessiofrittoli/web-utils');var _cryptobuffer = require('@alessiofrittoli/crypto-buffer');var _exception = require('@alessiofrittoli/exception');var m=async n=>{let{response:s}=n,{responseType:o}=n;switch(o){case"document":break;case"json":{let e=s;if(e&&_exception.Exception.isException(e))return new (0, _exception.Exception)(e.message,{...e});break}case"":case"text":case"arraybuffer":case"blob":default:{let e=o==="arraybuffer"?_cryptobuffer.binaryToString.call(void 0, s):o==="blob"?await s.text():s;if(_webutils.isJson.call(void 0, e)){let t=JSON.parse(e);if(_exception.Exception.isException(t))return new (0, _exception.Exception)(t.message,{...t})}break}}return null};exports.getErrorFromResponse = m;

package/dist/getErrorFromResponse-IJTUOFPH.mjs

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

package/dist/index.d.mts

@@ -0,0 +1,12 @@
+declare global {
+    interface RequestInit {
+        /** The expected ResponseType. */
+        responseType?: XMLHttpRequestResponseType | 'formdata';
+    }
+    interface ProgressEvent {
+        readonly type: keyof XMLHttpRequestEventTargetEventMap;
+    }
+}
+type DoNotUse = never;
+
+export type { DoNotUse };

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface RequestInit {
+        /** The expected ResponseType. */
+        responseType?: XMLHttpRequestResponseType | 'formdata';
+    }
+    interface ProgressEvent {
+        readonly type: keyof XMLHttpRequestEventTargetEventMap;
+    }
+}
+type DoNotUse = never;
+
+export type { DoNotUse };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/logReadyStateChange-2QWX5XIU.mjs

@@ -0,0 +1 @@
+var r=t=>{let e={event:"readystatechange",readyState:t.request.readyState,status:t.request.status,message:""};switch(t.request.readyState){case XMLHttpRequest.UNSENT:e.message="Request unsent";break;case XMLHttpRequest.OPENED:e.message="Request opened";break;case XMLHttpRequest.HEADERS_RECEIVED:e.message="Request headers received";break;case XMLHttpRequest.LOADING:e.message="Request loading";break;case XMLHttpRequest.DONE:e.message="Request done";break}t.log(e)};export{r as logReadyStateChange};

package/dist/logReadyStateChange-MSYI3OBQ.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var a=t=>{let e={event:"readystatechange",readyState:t.request.readyState,status:t.request.status,message:""};switch(t.request.readyState){case XMLHttpRequest.UNSENT:e.message="Request unsent";break;case XMLHttpRequest.OPENED:e.message="Request opened";break;case XMLHttpRequest.HEADERS_RECEIVED:e.message="Request headers received";break;case XMLHttpRequest.LOADING:e.message="Request loading";break;case XMLHttpRequest.DONE:e.message="Request done";break}t.log(e)};exports.logReadyStateChange = a;

package/dist/types-CVc-rxXe.d.ts

@@ -0,0 +1,227 @@
+import Emitter, { EventEmitter } from '@alessiofrittoli/event-emitter';
+import { Exception } from '@alessiofrittoli/exception';
+import { AbortErrorOptions, AbortError } from '@alessiofrittoli/exception/abort';
+import * as _alessiofrittoli_url_utils from '@alessiofrittoli/url-utils';
+import { UrlInput } from '@alessiofrittoli/url-utils';
+import { AbortController } from '@alessiofrittoli/abort-controller';
+import { ErrorCode } from './error.js';
+
+/**
+ * Easly handle XML HTTP Requests.
+ *
+ */
+declare class Xhr<TReturn = unknown> extends EventEmitter<XHR.Event.Map<TReturn>> implements XHR.Options {
+    /** The XMLHttpRequest instance.  */
+    request: XMLHttpRequest;
+    url: _alessiofrittoli_url_utils.UrlInput;
+    method: RequestMethod;
+    body: XMLHttpRequestBodyInit | Document | undefined;
+    headers: Headers;
+    credentials: {
+        username?: string | null;
+        password?: string | null;
+    } | undefined;
+    response?: TReturn;
+    controller: AbortController<ErrorCode>;
+    debug: boolean;
+    /** Indicates whether to automatically set the XHR response type based on the Response Content-Type Header. */
+    private setResponseType;
+    private static NotAvailableErr;
+    /** XHR progress events. */
+    static readonly ProgressEvents: XHR.Event.Progress[];
+    /**
+     * Construct a new instance of Xhr.
+     *
+     * @param options Required options for a proper initialization.
+     */
+    constructor(options: XHR.Options);
+    /**
+     * Initialise XMLHttpRequest.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    init(options?: XHR.InitOptions): this;
+    /**
+     * Send XMLHttpRequest.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    send(): Promise<this>;
+    /**
+     * Cancels any network activity.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    abort(reason?: string, options?: AbortErrorOptions): this;
+    /**
+     * Executed when `Xhr.controller` get aborted through `Xhr.abort()` or `Xhr.controller.abort()` methods.
+     *
+     */
+    private controllerAbortListener;
+    /**
+     * Handle `readystatechange` events.
+     *
+     * @param event The Event interface.
+     */
+    private readyStateChangeHandler;
+    /**
+     * Handle and emit progress events.
+     *
+     * See {@link Xhr.ProgressEvents} for a list of listened events.
+     *
+     * @param event The ProgressEvent interface.
+     */
+    private progressEventHandler;
+    /**
+     * Emit success or error events based on the received Response on Request Load End.
+     *
+     */
+    private loadEndHandler;
+    /**
+     * Add listeners to the XMLHttpRequest instance.
+     *
+     * See {@link Xhr.ProgressEvents} for a list of listened events.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private addProgressListeners;
+    /**
+     * Set the request headers.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private setHeaders;
+    /**
+     * 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;
+    /**
+     * Automatically set `XMLHttpRequestResponseType` based on the received Response `Content-Type` Header.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private setResponseTypeFromResponseHeaders;
+    /**
+     * Get formatted response.
+     *
+     * @returns The response text or an object from a json response.
+     */
+    getResponse(): TReturn | undefined;
+    /**
+     * Get `Content-Type` Response Header.
+     *
+     * @returns The Response Header value, `null` if none has been found.
+     */
+    getResponseContentType(): string | null;
+    /**
+     * 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(name: string): string | null;
+    /**
+     * 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;
+    /**
+     * Prints to `stdout` with newline.
+     *
+     * @param	data The data print out.
+     * @returns	The current `Xhr` instance for chaining purposes.
+     */
+    log(data: Record<'message', string> & Record<string, any>): this;
+}
+
+type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+declare namespace Fetch {
+    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>>;
+}
+declare namespace XHR {
+    namespace Event {
+        type Progress = keyof XMLHttpRequestEventTargetEventMap;
+        type Map<TReturn = unknown> = {
+            init: [xhr: Xhr<TReturn>];
+            send: [xhr: Xhr<TReturn>];
+            success: [response: TReturn, xhr: Xhr<TReturn>];
+            error: [error: Exception<string, ErrorCode>, xhr: Xhr<TReturn>];
+            abort: [reason: AbortError<string, ErrorCode>, event: ProgressEvent<XMLHttpRequestEventTarget>, xhr: Xhr<TReturn>];
+            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> = (Emitter.Listener<XHR.Event.Map<TReturn>, TEvent>);
+    }
+    interface InitOptions {
+        /**
+         * A custom controller object that allows you to abort one or more DOM requests as and when desired.
+         */
+        controller?: AbortController<ErrorCode>;
+    }
+    interface Options extends XHR.InitOptions {
+        /** The URL string or URL object. */
+        url: UrlInput;
+        /** The request method. Default: `GET`. */
+        method?: RequestMethod;
+        /** The expected Response Type. */
+        responseType?: XMLHttpRequestResponseType;
+        /** Automatically set the `responseType` from Response Content-Type Header if set to `true` and `responseType` hasn't been set. Default: `true`. */
+        autoResponseType?: boolean;
+        /** The body object to send. */
+        body?: Document | XMLHttpRequestBodyInit;
+        /** The request HeadersInit object. */
+        headers?: Headers | HeadersInit;
+        /**
+         * True when credentials are to be included in a cross-origin request. False when they are to be excluded in a cross-origin request and when cookies are to be ignored in its response. Initially false.
+         *
+         * When set: throws an "InvalidStateError" DOMException if state is not unsent or opened, or if the send() flag is set.
+         */
+        withCredentials?: XMLHttpRequest['withCredentials'];
+        /**
+         * An object with `username` and `password` to send along with the request.
+         *
+         */
+        credentials?: {
+            username?: string | null;
+            password?: string | 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.
+         */
+        timeout?: XMLHttpRequest['timeout'];
+        /** Whether to `console.log` data on different events. */
+        debug?: boolean;
+    }
+}
+
+export { Fetch as F, type RequestMethod as R, Xhr as X, XHR as a };

package/dist/types-DuGUXaTD.d.mts

@@ -0,0 +1,227 @@
+import Emitter, { EventEmitter } from '@alessiofrittoli/event-emitter';
+import { Exception } from '@alessiofrittoli/exception';
+import { AbortErrorOptions, AbortError } from '@alessiofrittoli/exception/abort';
+import * as _alessiofrittoli_url_utils from '@alessiofrittoli/url-utils';
+import { UrlInput } from '@alessiofrittoli/url-utils';
+import { AbortController } from '@alessiofrittoli/abort-controller';
+import { ErrorCode } from './error.mjs';
+
+/**
+ * Easly handle XML HTTP Requests.
+ *
+ */
+declare class Xhr<TReturn = unknown> extends EventEmitter<XHR.Event.Map<TReturn>> implements XHR.Options {
+    /** The XMLHttpRequest instance.  */
+    request: XMLHttpRequest;
+    url: _alessiofrittoli_url_utils.UrlInput;
+    method: RequestMethod;
+    body: XMLHttpRequestBodyInit | Document | undefined;
+    headers: Headers;
+    credentials: {
+        username?: string | null;
+        password?: string | null;
+    } | undefined;
+    response?: TReturn;
+    controller: AbortController<ErrorCode>;
+    debug: boolean;
+    /** Indicates whether to automatically set the XHR response type based on the Response Content-Type Header. */
+    private setResponseType;
+    private static NotAvailableErr;
+    /** XHR progress events. */
+    static readonly ProgressEvents: XHR.Event.Progress[];
+    /**
+     * Construct a new instance of Xhr.
+     *
+     * @param options Required options for a proper initialization.
+     */
+    constructor(options: XHR.Options);
+    /**
+     * Initialise XMLHttpRequest.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    init(options?: XHR.InitOptions): this;
+    /**
+     * Send XMLHttpRequest.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    send(): Promise<this>;
+    /**
+     * Cancels any network activity.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    abort(reason?: string, options?: AbortErrorOptions): this;
+    /**
+     * Executed when `Xhr.controller` get aborted through `Xhr.abort()` or `Xhr.controller.abort()` methods.
+     *
+     */
+    private controllerAbortListener;
+    /**
+     * Handle `readystatechange` events.
+     *
+     * @param event The Event interface.
+     */
+    private readyStateChangeHandler;
+    /**
+     * Handle and emit progress events.
+     *
+     * See {@link Xhr.ProgressEvents} for a list of listened events.
+     *
+     * @param event The ProgressEvent interface.
+     */
+    private progressEventHandler;
+    /**
+     * Emit success or error events based on the received Response on Request Load End.
+     *
+     */
+    private loadEndHandler;
+    /**
+     * Add listeners to the XMLHttpRequest instance.
+     *
+     * See {@link Xhr.ProgressEvents} for a list of listened events.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private addProgressListeners;
+    /**
+     * Set the request headers.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private setHeaders;
+    /**
+     * 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;
+    /**
+     * Automatically set `XMLHttpRequestResponseType` based on the received Response `Content-Type` Header.
+     *
+     * @returns The current `Xhr` instance for chaining purposes.
+     */
+    private setResponseTypeFromResponseHeaders;
+    /**
+     * Get formatted response.
+     *
+     * @returns The response text or an object from a json response.
+     */
+    getResponse(): TReturn | undefined;
+    /**
+     * Get `Content-Type` Response Header.
+     *
+     * @returns The Response Header value, `null` if none has been found.
+     */
+    getResponseContentType(): string | null;
+    /**
+     * 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(name: string): string | null;
+    /**
+     * 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;
+    /**
+     * Prints to `stdout` with newline.
+     *
+     * @param	data The data print out.
+     * @returns	The current `Xhr` instance for chaining purposes.
+     */
+    log(data: Record<'message', string> & Record<string, any>): this;
+}
+
+type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+declare namespace Fetch {
+    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>>;
+}
+declare namespace XHR {
+    namespace Event {
+        type Progress = keyof XMLHttpRequestEventTargetEventMap;
+        type Map<TReturn = unknown> = {
+            init: [xhr: Xhr<TReturn>];
+            send: [xhr: Xhr<TReturn>];
+            success: [response: TReturn, xhr: Xhr<TReturn>];
+            error: [error: Exception<string, ErrorCode>, xhr: Xhr<TReturn>];
+            abort: [reason: AbortError<string, ErrorCode>, event: ProgressEvent<XMLHttpRequestEventTarget>, xhr: Xhr<TReturn>];
+            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> = (Emitter.Listener<XHR.Event.Map<TReturn>, TEvent>);
+    }
+    interface InitOptions {
+        /**
+         * A custom controller object that allows you to abort one or more DOM requests as and when desired.
+         */
+        controller?: AbortController<ErrorCode>;
+    }
+    interface Options extends XHR.InitOptions {
+        /** The URL string or URL object. */
+        url: UrlInput;
+        /** The request method. Default: `GET`. */
+        method?: RequestMethod;
+        /** The expected Response Type. */
+        responseType?: XMLHttpRequestResponseType;
+        /** Automatically set the `responseType` from Response Content-Type Header if set to `true` and `responseType` hasn't been set. Default: `true`. */
+        autoResponseType?: boolean;
+        /** The body object to send. */
+        body?: Document | XMLHttpRequestBodyInit;
+        /** The request HeadersInit object. */
+        headers?: Headers | HeadersInit;
+        /**
+         * True when credentials are to be included in a cross-origin request. False when they are to be excluded in a cross-origin request and when cookies are to be ignored in its response. Initially false.
+         *
+         * When set: throws an "InvalidStateError" DOMException if state is not unsent or opened, or if the send() flag is set.
+         */
+        withCredentials?: XMLHttpRequest['withCredentials'];
+        /**
+         * An object with `username` and `password` to send along with the request.
+         *
+         */
+        credentials?: {
+            username?: string | null;
+            password?: string | 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.
+         */
+        timeout?: XMLHttpRequest['timeout'];
+        /** Whether to `console.log` data on different events. */
+        debug?: boolean;
+    }
+}
+
+export { Fetch as F, type RequestMethod as R, Xhr as X, XHR as a };

package/dist/types.d.mts

@@ -0,0 +1,8 @@
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/url-utils';
+import '@alessiofrittoli/abort-controller';
+import './error.mjs';
+export { F as Fetch, R as RequestMethod, a as XHR } from './types-DuGUXaTD.mjs';
+import '@alessiofrittoli/exception/code';

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/url-utils';
+import '@alessiofrittoli/abort-controller';
+import './error.js';
+export { F as Fetch, R as RequestMethod, a as XHR } from './types-CVc-rxXe.js';
+import '@alessiofrittoli/exception/code';

package/dist/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/xhr/index.d.mts

@@ -0,0 +1,8 @@
+export { X as Xhr } from '../types-DuGUXaTD.mjs';
+import '@alessiofrittoli/url-utils';
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/abort-controller';
+import '../error.mjs';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/code';

package/dist/xhr/index.d.ts

@@ -0,0 +1,8 @@
+export { X as Xhr } from '../types-CVc-rxXe.js';
+import '@alessiofrittoli/url-utils';
+import '@alessiofrittoli/event-emitter';
+import '@alessiofrittoli/exception/abort';
+import '@alessiofrittoli/abort-controller';
+import '../error.js';
+import '@alessiofrittoli/exception';
+import '@alessiofrittoli/exception/code';

package/dist/xhr/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkHNNMLJIAjs = require('../chunk-HNNMLJIA.js');var _urlutils = require('@alessiofrittoli/url-utils');var _eventemitter = require('@alessiofrittoli/event-emitter');var _exception = require('@alessiofrittoli/exception');var _abortcontroller = require('@alessiofrittoli/abort-controller');var r=class r extends _eventemitter.EventEmitter{constructor(e){super({captureRejections:!0});this.setResponseType=!1;this.controllerAbortListener=()=>{this.controller.signal.removeEventListener("abort",this.controllerAbortListener),this.request.abort(),this.log({message:this.controller.signal.reason.message})};this.readyStateChangeHandler=async e=>{if(this.setResponseType&&this.setResponseTypeFromResponseHeaders(),this.debug){let{logReadyStateChange:t}=await Promise.resolve().then(() => _interopRequireWildcard(require("../logReadyStateChange-MSYI3OBQ.js")));t(this)}this.response=this.getResponse(),this.emit("readystatechange",e,this)};this.progressEventHandler=e=>{let t=e.type;return this.log({event:t,message:`${e.loaded} bytes transferred.`}),t==="abort"?(this.emit("abort",this.controller.signal.reason,e,this),this):t==="error"?this.error(new (0, _exception.Exception)("ProgressEvent Error",{code:_chunkHNNMLJIAjs.b.Exception.UNKNOWN,cause:e})):(this.emit(t,e,this),this)};this.loadEndHandler=async()=>{let{status:e}=this.request;if(e<=0)return this;try{if(e<100||e>=400){if(this.setResponseTypeFromResponseHeaders(),this.contentTypeToResponseType()==="json"&&_exception.Exception.isException(this.response))return this.error(new (0, _exception.Exception)(this.response.message,{...this.response}));let{response:t}=this,{responseType:n}=this.request,{getErrorFromResponse:u}=await Promise.resolve().then(() => _interopRequireWildcard(require("../getErrorFromResponse-7V2YFS4F.js"))),o=await u({responseType:n,response:t});return o?this.error(o):this.error(new (0, _exception.Exception)("Error from the server.",{code:_chunkHNNMLJIAjs.b.Exception.UNKNOWN,cause:this.response}))}return this.success()}catch(t){let n=t;return this.error(new (0, _exception.Exception)(n.message,{code:_chunkHNNMLJIAjs.b.Exception.UNKNOWN,...n}))}};this.request=typeof XMLHttpRequest<"u"?new XMLHttpRequest:null,this.setResponseType=_nullishCoalesce(e.autoResponseType, () => (!0)),this.request&&(typeof e.responseType<"u"&&(this.setResponseType=!1,this.request.responseType=e.responseType),typeof e.withCredentials<"u"&&(this.request.withCredentials=e.withCredentials),e.timeout&&(this.request.timeout=e.timeout)),this.url=e.url,this.method=e.method||"GET",this.body=e.body,this.controller=e.controller||new _abortcontroller.AbortController,this.headers=new Headers(e.headers),this.credentials=e.credentials,this.debug=e.debug||!1}init(e={}){return this.request?(e.controller&&(this.controller=e.controller),this.controller.signal.aborted&&(this.controller=e.controller||new _abortcontroller.AbortController),this.emit("init",this),this.addProgressListeners(),this.request.open(this.method,_urlutils.Url.format(this.url),!0,_optionalChain([this, 'access', _ => _.credentials, 'optionalAccess', _2 => _2.username]),_optionalChain([this, 'access', _3 => _3.credentials, 'optionalAccess', _4 => _4.password])),this.setHeaders(),this.request.removeEventListener("readystatechange",this.readyStateChangeHandler),this.request.addEventListener("readystatechange",this.readyStateChangeHandler),this.once("loadend",this.loadEndHandler),this.controller.signal.addEventListener("abort",this.controllerAbortListener),this):this.error(r.NotAvailableErr)}async send(){if(!this.request)return this.error(r.NotAvailableErr);try{return this.emit("send",this),await this.request.send(this.body),this}catch(e){let t=e,n=t.name==="InvalidStateError"?_chunkHNNMLJIAjs.b.Request.XHR_INVALID_STATE:_chunkHNNMLJIAjs.b.Exception.UNKNOWN;return this.error(new (0, _exception.Exception)(t.message,{code:n,name:t.name,cause:t}))}}abort(e,t){return this.request?(this.controller.abort(e,t),this):this.error(r.NotAvailableErr)}addProgressListeners(){return this.request?(r.ProgressEvents.map(e=>{this.request.removeEventListener(e,this.progressEventHandler),this.request.addEventListener(e,this.progressEventHandler)}),this):this.error(r.NotAvailableErr)}setHeaders(){return this.request?(Array.from(this.headers.entries()).forEach(([e,t])=>{this.request.setRequestHeader(e,t)}),this):this.error(r.NotAvailableErr)}contentTypeToResponseType(e){return typeof e>"u"&&(e=this.getResponseContentType()),e?(e=e.toLowerCase(),e.includes("text/html")||e.includes("application/xml")?"document":e.includes("application/json")?"json":e.includes("application/octet-stream")?"arraybuffer":e.startsWith("image/")||e.startsWith("video/")?"blob":"text"):""}setResponseTypeFromResponseHeaders(){if(this.request.readyState===XMLHttpRequest.LOADING||this.request.readyState===XMLHttpRequest.DONE)return this;let e=this.getResponseContentType();return this.request.responseType=this.contentTypeToResponseType(e),this.log({message:"Set XMLHttpRequest.responseType from Content-Type Response Headers.",contentType:e,XhrResponseType:this.request.responseType}),this}getResponse(){if(!this.request){this.error(r.NotAvailableErr);return}return this.response=this.request.response,this.response}getResponseContentType(){return this.getResponseHeader("Content-Type")}getResponseHeader(e){return this.request.getResponseHeader(e)}success(){return this.emit("success",this.response,this),this}error(e){return this.emit("error",e,this),this}log(e){return this.debug?(console.log({class:"Xhr",...e}),this):this}};r.NotAvailableErr=new (0, _exception.Exception)("XMLHttpRequest not available",{code:_chunkHNNMLJIAjs.b.Request.XHR_NOT_AVAILABLE}),r.ProgressEvents=["abort","timeout","error","loadstart","progress","load","loadend"];var h=r;exports.Xhr = h;

package/dist/xhr/index.mjs

@@ -0,0 +1 @@
+import{b as s}from"../chunk-LOWOZ6LK.mjs";import{Url as p}from"@alessiofrittoli/url-utils";import{EventEmitter as l}from"@alessiofrittoli/event-emitter";import{Exception as i}from"@alessiofrittoli/exception";import{AbortController as a}from"@alessiofrittoli/abort-controller";var r=class r extends l{constructor(e){super({captureRejections:!0});this.setResponseType=!1;this.controllerAbortListener=()=>{this.controller.signal.removeEventListener("abort",this.controllerAbortListener),this.request.abort(),this.log({message:this.controller.signal.reason.message})};this.readyStateChangeHandler=async e=>{if(this.setResponseType&&this.setResponseTypeFromResponseHeaders(),this.debug){let{logReadyStateChange:t}=await import("../logReadyStateChange-2QWX5XIU.mjs");t(this)}this.response=this.getResponse(),this.emit("readystatechange",e,this)};this.progressEventHandler=e=>{let t=e.type;return this.log({event:t,message:`${e.loaded} bytes transferred.`}),t==="abort"?(this.emit("abort",this.controller.signal.reason,e,this),this):t==="error"?this.error(new i("ProgressEvent Error",{code:s.Exception.UNKNOWN,cause:e})):(this.emit(t,e,this),this)};this.loadEndHandler=async()=>{let{status:e}=this.request;if(e<=0)return this;try{if(e<100||e>=400){if(this.setResponseTypeFromResponseHeaders(),this.contentTypeToResponseType()==="json"&&i.isException(this.response))return this.error(new i(this.response.message,{...this.response}));let{response:t}=this,{responseType:n}=this.request,{getErrorFromResponse:u}=await import("../getErrorFromResponse-IJTUOFPH.mjs"),o=await u({responseType:n,response:t});return o?this.error(o):this.error(new i("Error from the server.",{code:s.Exception.UNKNOWN,cause:this.response}))}return this.success()}catch(t){let n=t;return this.error(new i(n.message,{code:s.Exception.UNKNOWN,...n}))}};this.request=typeof XMLHttpRequest<"u"?new XMLHttpRequest:null,this.setResponseType=e.autoResponseType??!0,this.request&&(typeof e.responseType<"u"&&(this.setResponseType=!1,this.request.responseType=e.responseType),typeof e.withCredentials<"u"&&(this.request.withCredentials=e.withCredentials),e.timeout&&(this.request.timeout=e.timeout)),this.url=e.url,this.method=e.method||"GET",this.body=e.body,this.controller=e.controller||new a,this.headers=new Headers(e.headers),this.credentials=e.credentials,this.debug=e.debug||!1}init(e={}){return this.request?(e.controller&&(this.controller=e.controller),this.controller.signal.aborted&&(this.controller=e.controller||new a),this.emit("init",this),this.addProgressListeners(),this.request.open(this.method,p.format(this.url),!0,this.credentials?.username,this.credentials?.password),this.setHeaders(),this.request.removeEventListener("readystatechange",this.readyStateChangeHandler),this.request.addEventListener("readystatechange",this.readyStateChangeHandler),this.once("loadend",this.loadEndHandler),this.controller.signal.addEventListener("abort",this.controllerAbortListener),this):this.error(r.NotAvailableErr)}async send(){if(!this.request)return this.error(r.NotAvailableErr);try{return this.emit("send",this),await this.request.send(this.body),this}catch(e){let t=e,n=t.name==="InvalidStateError"?s.Request.XHR_INVALID_STATE:s.Exception.UNKNOWN;return this.error(new i(t.message,{code:n,name:t.name,cause:t}))}}abort(e,t){return this.request?(this.controller.abort(e,t),this):this.error(r.NotAvailableErr)}addProgressListeners(){return this.request?(r.ProgressEvents.map(e=>{this.request.removeEventListener(e,this.progressEventHandler),this.request.addEventListener(e,this.progressEventHandler)}),this):this.error(r.NotAvailableErr)}setHeaders(){return this.request?(Array.from(this.headers.entries()).forEach(([e,t])=>{this.request.setRequestHeader(e,t)}),this):this.error(r.NotAvailableErr)}contentTypeToResponseType(e){return typeof e>"u"&&(e=this.getResponseContentType()),e?(e=e.toLowerCase(),e.includes("text/html")||e.includes("application/xml")?"document":e.includes("application/json")?"json":e.includes("application/octet-stream")?"arraybuffer":e.startsWith("image/")||e.startsWith("video/")?"blob":"text"):""}setResponseTypeFromResponseHeaders(){if(this.request.readyState===XMLHttpRequest.LOADING||this.request.readyState===XMLHttpRequest.DONE)return this;let e=this.getResponseContentType();return this.request.responseType=this.contentTypeToResponseType(e),this.log({message:"Set XMLHttpRequest.responseType from Content-Type Response Headers.",contentType:e,XhrResponseType:this.request.responseType}),this}getResponse(){if(!this.request){this.error(r.NotAvailableErr);return}return this.response=this.request.response,this.response}getResponseContentType(){return this.getResponseHeader("Content-Type")}getResponseHeader(e){return this.request.getResponseHeader(e)}success(){return this.emit("success",this.response,this),this}error(e){return this.emit("error",e,this),this}log(e){return this.debug?(console.log({class:"Xhr",...e}),this):this}};r.NotAvailableErr=new i("XMLHttpRequest not available",{code:s.Request.XHR_NOT_AVAILABLE}),r.ProgressEvents=["abort","timeout","error","loadstart","progress","load","loadend"];var h=r;export{h as Xhr};

package/license.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Alessio Frittoli.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,125 @@
+{
+	"name": "@alessiofrittoli/fetcher",
+	"version": "0.1.0-alpha.1",
+	"description": "Typescript fetch/xhr utilities",
+	"author": {
+		"name": "Alessio Frittoli",
+		"email": "info@alessiofrittoli.it",
+		"url": "https://alessiofrittoli.it"
+	},
+	"license": "MIT",
+	"funding": [
+		{
+			"type": "github",
+			"url": "https://github.com/sponsors/alessiofrittoli"
+		}
+	],
+	"keywords": [
+		"fetch",
+		"ajax"
+	],
+	"homepage": "https://github.com/alessiofrittoli/fetcher#readme",
+	"bugs": {
+		"url": "https://github.com/alessiofrittoli/fetcher/issues",
+		"email": "info@alessiofrittoli.it"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/alessiofrittoli/fetcher.git"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist",
+		"scripts/postinstall"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.js"
+		},
+		"./fetch": {
+			"types": "./dist/fetch.d.ts",
+			"import": "./dist/fetch.mjs",
+			"require": "./dist/fetch.js"
+		},
+		"./xhr": {
+			"types": "./dist/xhr/index.d.ts",
+			"import": "./dist/xhr/index.mjs",
+			"require": "./dist/xhr/index.js"
+		},
+		"./error": {
+			"types": "./dist/error.d.ts",
+			"import": "./dist/error.mjs",
+			"require": "./dist/error.js"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts"
+		}
+	},
+	"sideEffects": false,
+	"scripts": {
+		"//1a": "*********************************************************************",
+		"//1b": "******************** DEV - BUILD - LINT - RELEASE *******************",
+		"//1c": "*********************************************************************",
+		"dev": "NODE_ENV=development tsup --watch",
+		"build:prod": "NODE_ENV=production tsup",
+		"build": "pnpm lint && pnpm test:ci && pnpm build:prod",
+		"lint": "eslint",
+		"release": "node scripts/publish.js --verbose --npm",
+		"//2a": "*********************************************************************",
+		"//2b": "***************************** UNIT TESTS ****************************",
+		"//2c": "*********************************************************************",
+		"test": "jest --verbose",
+		"test:watch": "jest --watchAll --verbose",
+		"test:ci": "jest --ci --verbose",
+		"//3a": "*********************************************************************",
+		"//3b": "************************ UNIT TESTS COVERAGE ************************",
+		"//3c": "*********************************************************************",
+		"test:coverage": "pnpm test:watch --coverage",
+		"test:coverage:ci": "pnpm test:ci --coverage",
+		"test:serve-coverage": "http-server ./coverage/lcov-report --gzip true -p 0 -o --silent",
+		"test:coverage:serve": "concurrently --prefix none --kill-others \"pnpm test:coverage\" \"pnpm test:serve-coverage\"",
+		"//4a": "*********************************************************************",
+		"//4b": "************************ TARGETED UNIT TESTS ************************",
+		"//4c": "*********************************************************************",
+		"test:fetch": "pnpm test:watch fetch.test.ts"
+	},
+	"devDependencies": {
+		"@alessiofrittoli/crypto-buffer": "^3.6.0",
+		"@eslint/js": "^9.27.0",
+		"@jest/globals": "^29.7.0",
+		"@types/jest": "^29.5.14",
+		"@types/node": "^22.15.21",
+		"concurrently": "^9.1.2",
+		"dotenv": "^16.5.0",
+		"eslint": "^9.27.0",
+		"globals": "^16.1.0",
+		"http-server": "^14.1.1",
+		"jest": "^29.7.0",
+		"jest-environment-jsdom": "^29.7.0",
+		"ts-jest": "^29.3.4",
+		"ts-node": "^10.9.2",
+		"tsup": "^8.5.0",
+		"typescript": "^5.8.3",
+		"typescript-eslint": "^8.32.1"
+	},
+	"dependencies": {
+		"@alessiofrittoli/abort-controller": "^0.1.0",
+		"@alessiofrittoli/chain-functions": "^2.3.0",
+		"@alessiofrittoli/event-emitter": "^1.4.0",
+		"@alessiofrittoli/exception": "^3.2.0",
+		"@alessiofrittoli/node-scripts": "^2.6.0",
+		"@alessiofrittoli/type-utils": "^1.8.0",
+		"@alessiofrittoli/url-utils": "^3.4.0",
+		"@alessiofrittoli/web-utils": "^1.11.0"
+	},
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"@alessiofrittoli/type-utils",
+			"esbuild"
+		]
+	}
+}

package/scripts/postinstall/index.js

@@ -0,0 +1,16 @@
+const { Chain }	= require( '@alessiofrittoli/chain-functions' )
+const tsSetup	= require( './ts-setup.js' )
+const project = require( '../../package.json' )
+
+/** @type {import( '@alessiofrittoli/chain-functions/types' ).LastChainLink<() => void | Promise<void>>} */
+const lastChainLink = () => () => {
+	console.log( {
+		package: project.name,
+		message: 'Post-Install done'
+	  } )
+}
+
+/** @type {import( '@alessiofrittoli/chain-functions/types' ).ChainFactory<() => void | Promise<void>>} */
+const chain = [ tsSetup, lastChainLink ]
+
+Chain.functions( chain )()

package/scripts/postinstall/ts-setup.js

@@ -0,0 +1,15 @@
+const project = require( '../../package.json' )
+const { addTypesReference } = require( '@alessiofrittoli/node-scripts/postinstall' )
+
+
+/** @type {import( '@alessiofrittoli/chain-functions/types' ).ChainLink<() => void | Promise<void>>} */
+const tsSetup = next => () => {
+	
+	addTypesReference( {
+		name: project.name,
+	} )
+
+	return next()
+}
+
+module.exports = tsSetup