@alessiofrittoli/fetcher 1.0.0 → 2.0.0

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

@@ -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 };

package/dist/index-D-vZzzH1.d.cts

@@ -0,0 +1,398 @@
+import { t as ErrorCode } from "./index-CQSGH5s-.cjs";
+import { AbortController } from "@alessiofrittoli/abort-controller";
+import { Exception } from "@alessiofrittoli/exception";
+import { EventEmitter, Listener } from "@alessiofrittoli/event-emitter";
+import { AbortError, AbortErrorOptions } from "@alessiofrittoli/exception/abort";
+import { UrlInput } from "@alessiofrittoli/url-utils";
+import { UUID } from "@alessiofrittoli/math-utils";
+//#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.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./error/index.cjs");let t=require("@alessiofrittoli/exception");const n=(n,r,i)=>globalThis.fetch(n,r).then(async n=>{let a=n.headers,o=a.get(`Content-Type`),s=o?.includes(`application/json`)||r?.responseType===`json`,c=o?.includes(`form-data`)||r?.responseType===`formdata`,l={response:n,headers:a,data:null,error:null};if(n.ok)return i?i(n):s?(l.data=await n.json(),l):c?(l.data=await n.formData(),l):r?.responseType===`arraybuffer`?(l.data=await n.arrayBuffer(),l):r?.responseType===`blob`?(l.data=await n.blob(),l):(l.data=await n.text(),l);if(s)throw await n.json();return l.error=new t.Exception({message:await n.text()||n.statusText,code:e.ErrorCode.UNKNOWN}),l}).catch(n=>({data:null,headers:null,response:null,error:t.Exception.isException(n)?new t.Exception(n):new t.Exception({...n,name:n.name,message:n.message,code:e.ErrorCode.UNKNOWN,cause:n})}));exports.fetch=n;

package/dist/index.d.cts

@@ -0,0 +1,17 @@
+import { i as Fetch } from "./index-D-vZzzH1.cjs";
+import { AbortSignal } from "@alessiofrittoli/abort-controller";
+//#region src/index.d.ts
+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.
+ */
+export 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>>;
+//#endregion
+export {};

package/dist/index.d.mts

@@ -1,12 +1,17 @@
-declare global {
-    interface RequestInit {
-        /** The expected ResponseType. */
-        responseType?: XMLHttpRequestResponseType | 'formdata';
-    }
-    interface ProgressEvent {
-        readonly type: keyof XMLHttpRequestEventTargetEventMap;
-    }
+import { i as Fetch } from "./index-B8rmZCit.mjs";
+import { AbortSignal } from "@alessiofrittoli/abort-controller";
+//#region src/index.d.ts
+interface RequestInit extends globalThis.RequestInit {
+  signal?: AbortSignal;
 }
-type DoNotUse = never;
-
-export type { DoNotUse };
+/**
+ * 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.
+ */
+export 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>>;
+//#endregion
+export {};

package/dist/index.mjs

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

package/dist/ping/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@alessiofrittoli/url-utils");const t=(t,n)=>navigator.sendBeacon(e.Url.format(t),n);exports.ping=t;

package/dist/ping/index.d.cts

@@ -0,0 +1,9 @@
+import { UrlInput } from "@alessiofrittoli/url-utils";
+//#region src/ping/index.d.ts
+/**
+ * Asynchronously sends an HTTP POST request containing a small amount of data to a web server.
+ *
+ * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/sendBeacon)
+ */
+export declare const ping: (url: UrlInput, data?: BodyInit | null) => boolean;
+//#endregion

package/dist/ping/index.d.mts

@@ -0,0 +1,9 @@
+import { UrlInput } from "@alessiofrittoli/url-utils";
+//#region src/ping/index.d.ts
+/**
+ * Asynchronously sends an HTTP POST request containing a small amount of data to a web server.
+ *
+ * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/sendBeacon)
+ */
+export declare const ping: (url: UrlInput, data?: BodyInit | null) => boolean;
+//#endregion

package/dist/ping/index.mjs

@@ -0,0 +1 @@
+import{Url as e}from"@alessiofrittoli/url-utils";const t=(t,n)=>navigator.sendBeacon(e.format(t),n);export{t as ping};

package/dist/types/index.d.cts

@@ -0,0 +1,2 @@
+import { i as Fetch, n as XHR, t as RequestMethod } from "../index-D-vZzzH1.cjs";
+export { Fetch, RequestMethod, XHR };

package/dist/types/index.d.mts

@@ -0,0 +1,2 @@
+import { i as Fetch, n as XHR, t as RequestMethod } from "../index-B8rmZCit.mjs";
+export { Fetch, RequestMethod, XHR };

package/dist/types/index.mjs

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

package/dist/xhr/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../error/index.cjs");let t=require("@alessiofrittoli/exception"),n=require("@alessiofrittoli/url-utils"),r=require("@alessiofrittoli/exception/abort"),i=require("@alessiofrittoli/abort-controller"),a=require("@alessiofrittoli/math-utils"),o=require("@alessiofrittoli/event-emitter");var s=class s extends o.EventEmitter{request;_requestId=(0,a.randomUUID)();get requestId(){return this._requestId}set requestId(e){this._requestId=e}_debug;get debug(){return this._debug}set debug(e){this._debug=e}_controller;get controller(){return this._controller}set controller(e){this._controller=e}_timeout;get timeout(){return this._timeout}set timeout(e){this._timeout=e}_credentials;get credentials(){return this._credentials}set credentials(e){this._credentials=e}_withCredentials;get withCredentials(){return this._withCredentials}set withCredentials(e){this._withCredentials=e}autoResponseType=!1;listenersRegistered=!1;static ProgressEvents=[`abort`,`timeout`,`error`,`loadstart`,`progress`,`load`,`loadend`];static MapReadyStateToXhrEvent={0:`unsent`,1:`opened`,2:`headers`,3:`loading`,4:`done`};constructor(e={}){super({captureRejections:!0}),this.request=typeof XMLHttpRequest<`u`?new XMLHttpRequest:null;let{credentials:t,withCredentials:n=!1,timeout:r=0,autoResponseType:i=!0,debug:a=!1}=e;this._debug=a,this._timeout=r,this._withCredentials=n,this._credentials=t,this.autoResponseType=i}init(e){if(!this.request)return this.error(this.getXhrNotAvailableError());let{url:t,method:r=`GET`,headers:i,controller:o,debug:s=this.debug,timeout:c=this.timeout,withCredentials:l=this.withCredentials,credentials:u=this.credentials,responseType:d,autoResponseType:f=this.autoResponseType}=e;return this.autoResponseType=f,this.requestId=(0,a.randomUUID)(),this.debug=s,this.request.open(r,n.Url.format(t),!0,u?.username,u?.password),this.request.timeout=c===null?0:c,this.request.withCredentials=l!==null&&l,d!==void 0&&(this.autoResponseType=!1,this.request.responseType=d),i&&this.setRequestHeaders(i),this.setupAbortController(o).registerListeners().emit(`init`,this),this.log(`Xhr initialized.`),this}send(n){if(!this.request)return this.error(this.getXhrNotAvailableError());this.request.readyState!==XMLHttpRequest.OPENED&&this.init(n);let{body:r}=n;try{return this.emit(`send`,this),this.request.send(r),this}catch(n){let r=n,i=r.name===t.ExceptionName.InvalidStateError?e.ErrorCode.XHR_INVALID_STATE:e.ErrorCode.UNKNOWN;return this.error(new t.Exception({...r,name:r.name,message:r.message,code:i,cause:r,isCritical:!0}))}}upload(e){let{files:t}=e,n=new FormData;return Array.from(t).forEach(e=>{n.append(e.name,e,e.name)}),this.send({...e,body:n})}getResponse(){if(!this.request)this.error(this.getXhrNotAvailableError());else return this.request.response}abort(e,t){return this.request?(this.controller?.abort(e,t),this):this.error(this.getXhrNotAvailableError())}setRequestHeaders(e){if(!this.request)return this.error(this.getXhrNotAvailableError());let t=new Headers(e);return Array.from(t.entries()).forEach(([e,t])=>{this.request.setRequestHeader(e,t)}),this}getResponseHeader(e){return this.request?this.request.getResponseHeader(e):(this.error(this.getXhrNotAvailableError()),null)}destroy(){return this.log({message:`Xhr destroyed.`}).abort(`Xhr has been destroyed.`,{code:e.ErrorCode.XHR_DESTROYED}).unregisterListeners().removeAllListeners()}log(...e){return this.debug&&console.log({class:`Xhr`,requestId:this.requestId},...e),this}success(e){return this.emit(`success`,e,this),this}error(e){if(this.listenerCount(`error`)===0)throw e;return this.emit(`error`,e,this),this}getXhrNotAvailableError(){return new t.Exception({message:`XMLHttpRequest not available.`,code:e.ErrorCode.XHR_NOT_AVAILABLE,isCritical:!0})}setupAbortController(e){let t=this.controller;return e&&(this.controller=e),(!this.controller||this.controller.signal.aborted)&&(this.controller=new i.AbortController,this.log({method:`.init()`},`new AbortController created.`)),t!==this.controller&&(this.log({method:`.init()`},`Register AbortSignal "abort" event listener.`),t?.signal.removeEventListener(`abort`,this.onControllerSignalAbort),this.controller.signal.addEventListener(`abort`,this.onControllerSignalAbort)),this}setResponseTypeFromResponseHeaders(){let e=this.getResponseContentType();return this.request.responseType=this.contentTypeToResponseType(e),this.log({method:`.setResponseTypeFromResponseHeaders()`,contentType:e,XhrResponseType:this.request.responseType},`Set XMLHttpRequest.responseType from Content-Type Response Headers.`),this}contentTypeToResponseType(e=this.getResponseContentType()){let t=e?.toLowerCase()||!1;return!t||t.includes(`text/plain`)?`text`:t.includes(`text/html`)||t.includes(`application/xml`)?`document`:t.includes(`application/json`)?`json`:t.startsWith(`image/`)||t.startsWith(`video/`)?`blob`:`arraybuffer`}getResponseContentType(){return this.getResponseHeader(`Content-Type`)}onReadyStateChange=async n=>{let{readyState:r,status:i}=this.request;if(this.log({event:`readystatechange`,readyState:r,status:this.request.status,data:n}),this.autoResponseType&&r===XMLHttpRequest.HEADERS_RECEIVED&&this.setResponseTypeFromResponseHeaders(),this.emit(`readystatechange`,n,this),r!==XMLHttpRequest.DONE||i<=0)return this.emitReadyStateEvent({readyState:r,event:n});let a=this.getResponse();if(i<100||i>=400){let{responseType:o}=this.request,{getErrorFromResponse:s}=await Promise.resolve().then(()=>require("../getErrorFromResponse-D3OARgUA.cjs")),c=await s({response:a,responseType:o});return this.emitReadyStateEvent({readyState:r,event:n}),c?this.error(c):this.error(new t.Exception({message:`Error from the server.`,code:e.ErrorCode.UNKNOWN,status:i,cause:a,isCritical:!0}))}return this.emitReadyStateEvent({readyState:r,event:n}),this.success(a)};onProgressChange=n=>{let{type:i}=n;if(this.log({event:i,data:n,progress:n.loaded/n.total*100},`${n.loaded} bytes transferred.`),i===`abort`){let t=this.controller?.signal.reason||new r.AbortError({message:`signal is aborted without reason`,code:e.ErrorCode.ABORT});return this.emit(`abort`,t,n,this)}if(i===`error`)return this.error(new t.Exception({message:`ProgressEvent Error`,code:e.ErrorCode.UNKNOWN,cause:n,isCritical:!0}));this.emit(i,n,this)};onControllerSignalAbort=()=>{this.log({method:`.onControllerSignalAbort()`,reason:this.controller?.signal.reason},`Abort XHR request.`),this.controller?.signal.removeEventListener(`abort`,this.onControllerSignalAbort),this.request.abort()};emitReadyStateEvent({readyState:e,event:t}){let n=s.MapReadyStateToXhrEvent[e];return this.emit(n,t,this),this.log({event:`readystatechange:${n}`,readyState:e,status:this.request.status,data:t}),this}registerListeners(){return this.request?(this.listenersRegistered||=(this.log({method:`.registerListeners()`},`Register "readystatechange" event listener.`),this.request.addEventListener(`readystatechange`,this.onReadyStateChange),s.ProgressEvents.map(e=>{this.log({method:`.registerListeners()`},`Register "${e}" event listener.`),this.request.addEventListener(e,this.onProgressChange)}),!0),this):this.error(this.getXhrNotAvailableError())}unregisterListeners(){return this.request?(this.listenersRegistered&&(this.listenersRegistered=!1,this.log({method:`.unregisterListeners()`},`Unregister "readystatechange" event listener.`),this.request.removeEventListener(`readystatechange`,this.onReadyStateChange),s.ProgressEvents.map(e=>{this.log({method:`.unregisterListeners()`},`Unregister "${e}" event listener.`),this.request.removeEventListener(e,this.onProgressChange)})),this):this.error(this.getXhrNotAvailableError())}};exports.Xhr=s;

package/dist/xhr/index.d.cts

@@ -0,0 +1,2 @@
+import { r as Xhr } from "../index-D-vZzzH1.cjs";
+export { Xhr };

package/dist/xhr/index.d.mts

@@ -1,8 +1,2 @@
-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';
+import { r as Xhr } from "../index-B8rmZCit.mjs";
+export { Xhr };

package/dist/xhr/index.mjs

@@ -1 +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};
+import{ErrorCode as e}from"../error/index.mjs";import{Exception as t,ExceptionName as n}from"@alessiofrittoli/exception";import{Url as r}from"@alessiofrittoli/url-utils";import{AbortError as i}from"@alessiofrittoli/exception/abort";import{AbortController as a}from"@alessiofrittoli/abort-controller";import{randomUUID as o}from"@alessiofrittoli/math-utils";import{EventEmitter as s}from"@alessiofrittoli/event-emitter";var c=class c extends s{request;_requestId=o();get requestId(){return this._requestId}set requestId(e){this._requestId=e}_debug;get debug(){return this._debug}set debug(e){this._debug=e}_controller;get controller(){return this._controller}set controller(e){this._controller=e}_timeout;get timeout(){return this._timeout}set timeout(e){this._timeout=e}_credentials;get credentials(){return this._credentials}set credentials(e){this._credentials=e}_withCredentials;get withCredentials(){return this._withCredentials}set withCredentials(e){this._withCredentials=e}autoResponseType=!1;listenersRegistered=!1;static ProgressEvents=[`abort`,`timeout`,`error`,`loadstart`,`progress`,`load`,`loadend`];static MapReadyStateToXhrEvent={0:`unsent`,1:`opened`,2:`headers`,3:`loading`,4:`done`};constructor(e={}){super({captureRejections:!0}),this.request=typeof XMLHttpRequest<`u`?new XMLHttpRequest:null;let{credentials:t,withCredentials:n=!1,timeout:r=0,autoResponseType:i=!0,debug:a=!1}=e;this._debug=a,this._timeout=r,this._withCredentials=n,this._credentials=t,this.autoResponseType=i}init(e){if(!this.request)return this.error(this.getXhrNotAvailableError());let{url:t,method:n=`GET`,headers:i,controller:a,debug:s=this.debug,timeout:c=this.timeout,withCredentials:l=this.withCredentials,credentials:u=this.credentials,responseType:d,autoResponseType:f=this.autoResponseType}=e;return this.autoResponseType=f,this.requestId=o(),this.debug=s,this.request.open(n,r.format(t),!0,u?.username,u?.password),this.request.timeout=c===null?0:c,this.request.withCredentials=l!==null&&l,d!==void 0&&(this.autoResponseType=!1,this.request.responseType=d),i&&this.setRequestHeaders(i),this.setupAbortController(a).registerListeners().emit(`init`,this),this.log(`Xhr initialized.`),this}send(r){if(!this.request)return this.error(this.getXhrNotAvailableError());this.request.readyState!==XMLHttpRequest.OPENED&&this.init(r);let{body:i}=r;try{return this.emit(`send`,this),this.request.send(i),this}catch(r){let i=r,a=i.name===n.InvalidStateError?e.XHR_INVALID_STATE:e.UNKNOWN;return this.error(new t({...i,name:i.name,message:i.message,code:a,cause:i,isCritical:!0}))}}upload(e){let{files:t}=e,n=new FormData;return Array.from(t).forEach(e=>{n.append(e.name,e,e.name)}),this.send({...e,body:n})}getResponse(){if(!this.request)this.error(this.getXhrNotAvailableError());else return this.request.response}abort(e,t){return this.request?(this.controller?.abort(e,t),this):this.error(this.getXhrNotAvailableError())}setRequestHeaders(e){if(!this.request)return this.error(this.getXhrNotAvailableError());let t=new Headers(e);return Array.from(t.entries()).forEach(([e,t])=>{this.request.setRequestHeader(e,t)}),this}getResponseHeader(e){return this.request?this.request.getResponseHeader(e):(this.error(this.getXhrNotAvailableError()),null)}destroy(){return this.log({message:`Xhr destroyed.`}).abort(`Xhr has been destroyed.`,{code:e.XHR_DESTROYED}).unregisterListeners().removeAllListeners()}log(...e){return this.debug&&console.log({class:`Xhr`,requestId:this.requestId},...e),this}success(e){return this.emit(`success`,e,this),this}error(e){if(this.listenerCount(`error`)===0)throw e;return this.emit(`error`,e,this),this}getXhrNotAvailableError(){return new t({message:`XMLHttpRequest not available.`,code:e.XHR_NOT_AVAILABLE,isCritical:!0})}setupAbortController(e){let t=this.controller;return e&&(this.controller=e),(!this.controller||this.controller.signal.aborted)&&(this.controller=new a,this.log({method:`.init()`},`new AbortController created.`)),t!==this.controller&&(this.log({method:`.init()`},`Register AbortSignal "abort" event listener.`),t?.signal.removeEventListener(`abort`,this.onControllerSignalAbort),this.controller.signal.addEventListener(`abort`,this.onControllerSignalAbort)),this}setResponseTypeFromResponseHeaders(){let e=this.getResponseContentType();return this.request.responseType=this.contentTypeToResponseType(e),this.log({method:`.setResponseTypeFromResponseHeaders()`,contentType:e,XhrResponseType:this.request.responseType},`Set XMLHttpRequest.responseType from Content-Type Response Headers.`),this}contentTypeToResponseType(e=this.getResponseContentType()){let t=e?.toLowerCase()||!1;return!t||t.includes(`text/plain`)?`text`:t.includes(`text/html`)||t.includes(`application/xml`)?`document`:t.includes(`application/json`)?`json`:t.startsWith(`image/`)||t.startsWith(`video/`)?`blob`:`arraybuffer`}getResponseContentType(){return this.getResponseHeader(`Content-Type`)}onReadyStateChange=async n=>{let{readyState:r,status:i}=this.request;if(this.log({event:`readystatechange`,readyState:r,status:this.request.status,data:n}),this.autoResponseType&&r===XMLHttpRequest.HEADERS_RECEIVED&&this.setResponseTypeFromResponseHeaders(),this.emit(`readystatechange`,n,this),r!==XMLHttpRequest.DONE||i<=0)return this.emitReadyStateEvent({readyState:r,event:n});let a=this.getResponse();if(i<100||i>=400){let{responseType:o}=this.request,{getErrorFromResponse:s}=await import(`../getErrorFromResponse-CIppVMTN.mjs`),c=await s({response:a,responseType:o});return this.emitReadyStateEvent({readyState:r,event:n}),c?this.error(c):this.error(new t({message:`Error from the server.`,code:e.UNKNOWN,status:i,cause:a,isCritical:!0}))}return this.emitReadyStateEvent({readyState:r,event:n}),this.success(a)};onProgressChange=n=>{let{type:r}=n;if(this.log({event:r,data:n,progress:n.loaded/n.total*100},`${n.loaded} bytes transferred.`),r===`abort`){let t=this.controller?.signal.reason||new i({message:`signal is aborted without reason`,code:e.ABORT});return this.emit(`abort`,t,n,this)}if(r===`error`)return this.error(new t({message:`ProgressEvent Error`,code:e.UNKNOWN,cause:n,isCritical:!0}));this.emit(r,n,this)};onControllerSignalAbort=()=>{this.log({method:`.onControllerSignalAbort()`,reason:this.controller?.signal.reason},`Abort XHR request.`),this.controller?.signal.removeEventListener(`abort`,this.onControllerSignalAbort),this.request.abort()};emitReadyStateEvent({readyState:e,event:t}){let n=c.MapReadyStateToXhrEvent[e];return this.emit(n,t,this),this.log({event:`readystatechange:${n}`,readyState:e,status:this.request.status,data:t}),this}registerListeners(){return this.request?(this.listenersRegistered||=(this.log({method:`.registerListeners()`},`Register "readystatechange" event listener.`),this.request.addEventListener(`readystatechange`,this.onReadyStateChange),c.ProgressEvents.map(e=>{this.log({method:`.registerListeners()`},`Register "${e}" event listener.`),this.request.addEventListener(e,this.onProgressChange)}),!0),this):this.error(this.getXhrNotAvailableError())}unregisterListeners(){return this.request?(this.listenersRegistered&&(this.listenersRegistered=!1,this.log({method:`.unregisterListeners()`},`Unregister "readystatechange" event listener.`),this.request.removeEventListener(`readystatechange`,this.onReadyStateChange),c.ProgressEvents.map(e=>{this.log({method:`.unregisterListeners()`},`Unregister "${e}" event listener.`),this.request.removeEventListener(e,this.onProgressChange)})),this):this.error(this.getXhrNotAvailableError())}};export{c as Xhr};