@cedx/base 0.1.0

package/License.md

@@ -0,0 +1,20 @@
+# MIT License
+Copyright © Cédric Belin
+
+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/ReadMe.md

@@ -0,0 +1,21 @@
+# Belin.io Base
+![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![NuGet](https://badgen.net/nuget/v/Belin.Base) ![License](https://badgen.net/badge/license/MIT/blue) ![Downloads](https://badgen.net/nuget/dt/Belin.Base)  
+![Node.js](https://badgen.net/npm/node/@cedx/base) ![npm](https://badgen.net/npm/v/@cedx/base) ![License](https://badgen.net/npm/license/@cedx/base) ![Downloads](https://badgen.net/npm/dt/@cedx/base)
+
+Base library by [Cédric Belin](https://belin.io), full stack developer,
+implemented in [C#](https://learn.microsoft.com/en-us/dotnet/csharp) and [TypeScript](https://www.typescriptlang.org).
+
+> This library is dedicated to personal/side projects.  
+> **Use at your own risk!** No support will be provided.
+
+## Documentation
+- [User guide](https://github.com/cedx/base/wiki)
+- [API reference](https://cedx.github.io/base)
+- [Examples](https://github.com/cedx/base/tree/main/example)
+
+## Development
+- [Git repository](https://github.com/cedx/base)
+- [Submit an issue](https://github.com/cedx/base/issues)
+
+## Licence
+[Belin.io Base](https://github.com/cedx/base) is distributed under the MIT License.

package/lib/Abstractions/ILoadingIndicator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
+ */
+export interface ILoadingIndicator {
+    /**
+     * Starts the loading indicator.
+     */
+    start: () => void;
+    /**
+     * Stops the loading indicator.
+     * @param options Value indicating whether to force the loading indicator to stop.
+     */
+    stop: (options?: {
+        force?: boolean;
+    }) => void;
+}
+//# sourceMappingURL=ILoadingIndicator.d.ts.map

package/lib/Abstractions/ILoadingIndicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILoadingIndicator.d.ts","sourceRoot":"","sources":["../../src/Client/Abstractions/ILoadingIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEjC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;;OAGG;IACH,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI,CAAC;CAC5C"}

package/lib/Abstractions/ILoadingIndicator.js

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

package/lib/DependencyInjection/Container.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Provides a dependency container.
+ */
+export declare class Container {
+    #private;
+    /**
+     * Removes the service registered with the specified identifier.
+     * @param id The identification token.
+     */
+    delete(id: ContainerToken): void;
+    /**
+     * Gets the service registered with the specified identifier.
+     * @param id The identification token.
+     * @returns The instance of the service registered with the specified identifier.
+     * @throws `Error` if there is no factory registered with the specified identifier.
+     */
+    get<T>(id: ContainerToken): T;
+    /**
+     * Gets a value indicating whether this container has a service registered with the specified identifier.
+     * @param id The identification token.
+     * @returns `true` if a service registered with the specified identifier exists in this container, otherwise `false`.
+     */
+    has(id: ContainerToken): boolean;
+    /**
+     * Registers a service factory with this container.
+     * @param id The identification token.
+     * @param factory The service factory.
+     * @returns This instance.
+     */
+    register(id: ContainerToken, factory: () => unknown): this;
+    /**
+     * Registers a service instance with this container.
+     * @param id The identification token.
+     * @param service The service instance.
+     * @returns This instance.
+     */
+    set(id: ContainerToken, service: unknown): this;
+}
+/**
+ * A token identifying a service.
+ */
+export type ContainerToken = string | symbol | (new (...args: any[]) => any);
+//# sourceMappingURL=Container.d.ts.map

package/lib/DependencyInjection/Container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/Client/DependencyInjection/Container.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAS;;IAYrB;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAKhC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,GAAG,CAAC;IAS7B;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO;IAIhC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI;IAK1D;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAI/C;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAC,MAAM,GAAC,CAAC,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC"}

package/lib/DependencyInjection/Container.js

@@ -0,0 +1,65 @@
+/**
+ * Provides a dependency container.
+ */
+export class Container {
+    /**
+     * The registered factories.
+     */
+    #factories = new Map;
+    /**
+     * The registered services.
+     */
+    #services = new Map;
+    /**
+     * Removes the service registered with the specified identifier.
+     * @param id The identification token.
+     */
+    delete(id) {
+        this.#factories.delete(id);
+        this.#services.delete(id);
+    }
+    /**
+     * Gets the service registered with the specified identifier.
+     * @param id The identification token.
+     * @returns The instance of the service registered with the specified identifier.
+     * @throws `Error` if there is no factory registered with the specified identifier.
+     */
+    get(id) {
+        if (!this.#services.has(id))
+            if (this.#factories.has(id))
+                this.set(id, this.#factories.get(id)());
+            else if (typeof id == "function")
+                this.set(id, Reflect.construct(id, []));
+            else
+                throw Error("There is no factory registered with the specified identifier.");
+        return this.#services.get(id);
+    }
+    /**
+     * Gets a value indicating whether this container has a service registered with the specified identifier.
+     * @param id The identification token.
+     * @returns `true` if a service registered with the specified identifier exists in this container, otherwise `false`.
+     */
+    has(id) {
+        return this.#factories.has(id) || this.#services.has(id);
+    }
+    /**
+     * Registers a service factory with this container.
+     * @param id The identification token.
+     * @param factory The service factory.
+     * @returns This instance.
+     */
+    register(id, factory) {
+        this.#factories.set(id, factory);
+        return this;
+    }
+    /**
+     * Registers a service instance with this container.
+     * @param id The identification token.
+     * @param service The service instance.
+     * @returns This instance.
+     */
+    set(id, service) {
+        this.#services.set(id, service);
+        return this;
+    }
+}

package/lib/Html/AppTheme.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Enumerates different themes an operating system or application can show.
+ */
+export declare const AppTheme: Readonly<{
+    /**
+     * The system predefined theme mode.
+     */
+    System: "System";
+    /**
+     * The light predefined theme mode.
+     */
+    Light: "Light";
+    /**
+     * The dark predefined theme mode.
+     */
+    Dark: "Dark";
+}>;
+/**
+ * Enumerates different themes an operating system or application can show.
+ */
+export type AppTheme = typeof AppTheme[keyof typeof AppTheme];
+/**
+ * Gets the icon corresponding to the specified theme.
+ * @param theme The theme mode.
+ * @returns The icon corresponding to the specified theme.
+ */
+export declare function themeIcon(theme: AppTheme): string;
+/**
+ * Gets the label corresponding to the specified theme.
+ * @param theme The theme mode.
+ * @returns The label corresponding to the specified theme.
+ */
+export declare function themeLabel(theme: AppTheme): string;
+//# sourceMappingURL=AppTheme.d.ts.map

package/lib/Html/AppTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppTheme.d.ts","sourceRoot":"","sources":["../../src/Client/Html/AppTheme.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ;IAEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMlD"}

package/lib/Html/AppTheme.js

@@ -0,0 +1,41 @@
+/**
+ * Enumerates different themes an operating system or application can show.
+ */
+export const AppTheme = Object.freeze({
+    /**
+     * The system predefined theme mode.
+     */
+    System: "System",
+    /**
+     * The light predefined theme mode.
+     */
+    Light: "Light",
+    /**
+     * The dark predefined theme mode.
+     */
+    Dark: "Dark"
+});
+/**
+ * Gets the icon corresponding to the specified theme.
+ * @param theme The theme mode.
+ * @returns The icon corresponding to the specified theme.
+ */
+export function themeIcon(theme) {
+    switch (theme) {
+        case AppTheme.Dark: return "dark_mode";
+        case AppTheme.Light: return "light_mode";
+        default: return "contrast";
+    }
+}
+/**
+ * Gets the label corresponding to the specified theme.
+ * @param theme The theme mode.
+ * @returns The label corresponding to the specified theme.
+ */
+export function themeLabel(theme) {
+    switch (theme) {
+        case AppTheme.Dark: return "Sombre";
+        case AppTheme.Light: return "Clair";
+        default: return "Auto";
+    }
+}

package/lib/Html/MenuAlignment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export declare const MenuAlignment: Readonly<{
+    /**
+     * The dropdown menu is right aligned.
+     */
+    End: "End";
+    /**
+     * The dropdown menu is left aligned.
+     */
+    Start: "Start";
+}>;
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export type MenuAlignment = typeof MenuAlignment[keyof typeof MenuAlignment];
+//# sourceMappingURL=MenuAlignment.d.ts.map

package/lib/Html/MenuAlignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MenuAlignment.d.ts","sourceRoot":"","sources":["../../src/Client/Html/MenuAlignment.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,aAAa;IAEzB;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}

package/lib/Html/MenuAlignment.js

@@ -0,0 +1,13 @@
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export const MenuAlignment = Object.freeze({
+    /**
+     * The dropdown menu is right aligned.
+     */
+    End: "End",
+    /**
+     * The dropdown menu is left aligned.
+     */
+    Start: "Start"
+});

package/lib/Html/ViewportScroller.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Defines the scrolling options.
+ */
+export type ScrollOptions = Partial<{
+    /**
+     * Value indicating whether scrolling is instant or animates smoothly.
+     */
+    behavior: ScrollBehavior;
+}>;
+/**
+ * Manages the scroll position.
+ */
+export declare class ViewportScroller {
+    #private;
+    /**
+     * Creates a new viewport scroller.
+     * @param viewport A function that returns the element used as viewport.
+     */
+    constructor(viewport?: () => Element);
+    /**
+     * The top offset used when scrolling to an element.
+     */
+    get scrollOffset(): number;
+    /**
+     * Scrolls to the specified anchor.
+     * @param anchor The identifier or name of an elment.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToAnchor(anchor: string, options?: ScrollOptions): void;
+    /**
+     * Scrolls to the specified element.
+     * @param element The element to scroll to.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToElement(element: Element, options?: ScrollOptions): void;
+    /**
+     * Scrolls to the specified position.
+     * @param x The pixel along the horizontal axis.
+     * @param y The pixel along the vertical axis.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToPosition(x: number, y: number, options?: ScrollOptions): void;
+    /**
+     * Scrolls to the top.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToTop(options?: ScrollOptions): void;
+}
+//# sourceMappingURL=ViewportScroller.d.ts.map

package/lib/Html/ViewportScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportScroller.d.ts","sourceRoot":"","sources":["../../src/Client/Html/ViewportScroller.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;IAEnC;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,qBAAa,gBAAgB;;IAY5B;;;OAGG;gBACS,QAAQ,GAAE,MAAM,OAAqE;IAIjG;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAWzB;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAKjE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAMpE;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAIzE;;;OAGG;IACH,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI;CAG9C"}

package/lib/Html/ViewportScroller.js

@@ -0,0 +1,69 @@
+/**
+ * Manages the scroll position.
+ */
+export class ViewportScroller {
+    /**
+     * The top offset used when scrolling to an element.
+     */
+    #scrollOffset = -1;
+    /**
+     * The function returning the element used as viewport.
+     */
+    #viewport;
+    /**
+     * Creates a new viewport scroller.
+     * @param viewport A function that returns the element used as viewport.
+     */
+    constructor(viewport = () => document.scrollingElement ?? document.documentElement) {
+        this.#viewport = viewport;
+    }
+    /**
+     * The top offset used when scrolling to an element.
+     */
+    get scrollOffset() {
+        if (this.#scrollOffset < 0) {
+            const fontSize = parseInt(getComputedStyle(document.body).fontSize);
+            this.#scrollOffset = Number.isNaN(fontSize) ? 0 : fontSize * 2;
+            const navbarHeight = parseInt(getComputedStyle(document.documentElement).getPropertyValue("--navbar-height"));
+            this.#scrollOffset += Number.isNaN(navbarHeight) ? 0 : navbarHeight;
+        }
+        const actionBar = document.body.querySelector("action-bar");
+        return this.#scrollOffset + (actionBar?.offsetHeight ?? 0);
+    }
+    /**
+     * Scrolls to the specified anchor.
+     * @param anchor The identifier or name of an elment.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToAnchor(anchor, options = {}) {
+        const element = document.getElementById(anchor) ?? document.body.querySelector(`[name="${anchor}"]`);
+        if (element)
+            this.scrollToElement(element, options);
+    }
+    /**
+     * Scrolls to the specified element.
+     * @param element The element to scroll to.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToElement(element, options = {}) {
+        const { left, top } = element.getBoundingClientRect();
+        const { scrollLeft, scrollTop } = this.#viewport();
+        this.scrollToPosition(left + scrollLeft, top + scrollTop - this.scrollOffset, options);
+    }
+    /**
+     * Scrolls to the specified position.
+     * @param x The pixel along the horizontal axis.
+     * @param y The pixel along the vertical axis.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToPosition(x, y, options = {}) {
+        this.#viewport().scrollTo({ left: x, top: y, behavior: options.behavior ?? "auto" });
+    }
+    /**
+     * Scrolls to the top.
+     * @param options Value indicating whether scrolling is instant or animates smoothly.
+     */
+    scrollToTop(options = {}) {
+        this.scrollToPosition(0, 0, options);
+    }
+}

package/lib/Http/HttpClient.d.ts

@@ -0,0 +1,68 @@
+import type { ILoadingIndicator } from "#Abstractions/ILoadingIndicator.js";
+/**
+ * Performs HTTP requests.
+ */
+export declare class HttpClient {
+    #private;
+    /**
+     * The base URL of the remote service.
+     */
+    readonly baseUrl: URL;
+    /**
+     * Creates a new HTTP client.
+     * @param options An object providing values to initialize this instance.
+     */
+    constructor(options?: HttpClientOptions);
+    /**
+     * Performs a DELETE request.
+     * @param url The URL of the resource to fetch.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    delete(url?: string | URL, options?: RequestInit): Promise<Response>;
+    /**
+     * Performs a GET request.
+     * @param url The URL of the resource to fetch.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    get(url?: string | URL, options?: RequestInit): Promise<Response>;
+    /**
+     * Performs a PATCH request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    patch(url?: string | URL, body?: unknown, options?: RequestInit): Promise<Response>;
+    /**
+     * Performs a POST request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    post(url?: string | URL, body?: unknown, options?: RequestInit): Promise<Response>;
+    /**
+     * Performs a PUT request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    put(url?: string | URL, body?: unknown, options?: RequestInit): Promise<Response>;
+}
+/**
+ * Defines the options of a {@link HttpClient} instance.
+ */
+export type HttpClientOptions = Partial<{
+    /**
+     * The base URL of the remote service.
+     */
+    baseUrl: string | URL;
+    /**
+     * The function returning the component used as loading indicator.
+     */
+    loadingIndicator: () => ILoadingIndicator | null;
+}>;
+//# sourceMappingURL=HttpClient.d.ts.map

package/lib/Http/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/Client/Http/HttpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AAG1E;;GAEG;AACH,qBAAa,UAAU;;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IAOtB;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAM3C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAC,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIlE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAC,GAAG,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI/D;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIjF;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhF;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAiC/E;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,OAAO,EAAE,MAAM,GAAC,GAAG,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,MAAM,iBAAiB,GAAC,IAAI,CAAC;CAC/C,CAAC,CAAC"}

package/lib/Http/HttpClient.js

@@ -0,0 +1,102 @@
+import { HttpError } from "./HttpError.js";
+/**
+ * Performs HTTP requests.
+ */
+export class HttpClient {
+    /**
+     * The base URL of the remote service.
+     */
+    baseUrl;
+    /**
+     * The function returning the component used as loading indicator.
+     */
+    #loadingIndicator;
+    /**
+     * Creates a new HTTP client.
+     * @param options An object providing values to initialize this instance.
+     */
+    constructor(options = {}) {
+        const url = options.baseUrl ? (options.baseUrl instanceof URL ? options.baseUrl.href : options.baseUrl) : document.baseURI;
+        this.baseUrl = new URL(url.endsWith("/") ? url : `${url}/`);
+        this.#loadingIndicator = options.loadingIndicator ?? (() => document.body.querySelector("loading-indicator"));
+    }
+    /**
+     * Performs a DELETE request.
+     * @param url The URL of the resource to fetch.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    delete(url, options) {
+        return this.#fetch("DELETE", url, null, options);
+    }
+    /**
+     * Performs a GET request.
+     * @param url The URL of the resource to fetch.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    get(url, options) {
+        return this.#fetch("GET", url, null, options);
+    }
+    /**
+     * Performs a PATCH request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    patch(url, body, options) {
+        return this.#fetch("PATCH", url, body, options);
+    }
+    /**
+     * Performs a POST request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    post(url, body, options) {
+        return this.#fetch("POST", url, body, options);
+    }
+    /**
+     * Performs a PUT request.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    put(url, body, options) {
+        return this.#fetch("PUT", url, body, options);
+    }
+    /**
+     * Performs a custom HTTP request.
+     * @param method The HTTP method.
+     * @param url The URL of the resource to fetch.
+     * @param body The request body.
+     * @param options The request options.
+     * @returns The server response.
+     */
+    async #fetch(method, url = "", body = null, options = {}) {
+        const headers = new Headers(options.headers);
+        if (!headers.has("accept"))
+            headers.set("accept", "application/json");
+        if (body && !(body instanceof Blob || body instanceof FormData || body instanceof URLSearchParams)) {
+            if (typeof body != "string")
+                body = JSON.stringify(body);
+            if (!headers.has("content-type"))
+                headers.set("content-type", "application/json");
+        }
+        const loadingIndicator = this.#loadingIndicator();
+        try {
+            loadingIndicator?.start();
+            const request = new Request(new URL(url, this.baseUrl), { ...options, method, headers, body });
+            const response = await fetch(request);
+            if (!response.ok)
+                throw new HttpError(response);
+            return response;
+        }
+        finally {
+            loadingIndicator?.stop();
+        }
+    }
+}

package/lib/Http/HttpError.d.ts

@@ -0,0 +1,33 @@
+import { StatusCodes } from "./StatusCodes.js";
+/**
+ * An object thrown when an HTTP error occurs.
+ */
+export declare class HttpError extends globalThis.Error {
+    #private;
+    /**
+     * Creates a new HTTP error.
+     * @param response The server response.
+     */
+    constructor(response: Response);
+    /**
+     * The server response.
+     */
+    get cause(): Response;
+    /**
+     * Value indicating whether the response's status code is between 400 and 499.
+     */
+    get isClientError(): boolean;
+    /**
+     * Value indicating whether the response's status code is between 500 and 599.
+     */
+    get isServerError(): boolean;
+    /**
+     * The response's status code.
+     */
+    get status(): StatusCodes;
+    /**
+     * The validation errors.
+     */
+    get validationErrors(): Promise<Map<string, string>>;
+}
+//# sourceMappingURL=HttpError.d.ts.map

package/lib/Http/HttpError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpError.d.ts","sourceRoot":"","sources":["../../src/Client/Http/HttpError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU,CAAC,KAAK;;IAO9C;;;OAGG;gBACS,QAAQ,EAAE,QAAQ;IAK9B;;OAEG;IACH,IAAa,KAAK,IAAI,QAAQ,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAG3B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAG3B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,WAAW,CAExB;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAInD;CAgBD"}