@cedx/base 0.7.0 → 0.8.0

package/ReadMe.md

@@ -1,5 +1,5 @@
 # Belin.io Base
-![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.7.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
+![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.8.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
 
 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).

package/lib/FileExtensions.js

@@ -1,4 +1,4 @@
-import { Duration } from "#Base/Duration.js";
+import { Duration } from "./Duration.js";
 /**
  * Downloads the specified file.
  * @param file The file to be downloaded.

package/lib/Hosting/Environment.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Commonly used environment names.
+ */
+export declare const Environment: Readonly<{
+    /**
+     * Specifies the development environment.
+     */
+    Development: "Development";
+    /**
+     * Specifies the production environment.
+     */
+    Production: "Production";
+    /**
+     * Specifies the staging environment.
+     */
+    Staging: "Staging";
+}>;
+/**
+ * Commonly used environment names.
+ */
+export type Environment = typeof Environment[keyof typeof Environment];
+//# sourceMappingURL=Environment.d.ts.map

package/lib/Hosting/Environment.d.ts.map

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

package/lib/Hosting/Environment.js

@@ -0,0 +1,17 @@
+/**
+ * Commonly used environment names.
+ */
+export const Environment = Object.freeze({
+    /**
+     * Specifies the development environment.
+     */
+    Development: "Development",
+    /**
+     * Specifies the production environment.
+     */
+    Production: "Production",
+    /**
+     * Specifies the staging environment.
+     */
+    Staging: "Staging"
+});

package/lib/Hosting/HostEnvironment.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Provides information about the hosting environment an application is running in.
+ */
+export declare class HostEnvironment {
+    /**
+     * The name of the application.
+     */
+    readonly applicationName: string;
+    /**
+     * The path to the directory that contains the application content files.
+     */
+    readonly contentRootPath: string;
+    /**
+     * The name of the environment.
+     */
+    readonly environmentName: string;
+    /**
+     * Creates a new host environment.
+     * @param options An object providing values to initialize this instance.
+     */
+    constructor(options?: HostEnvironmentOptions);
+    /**
+     * Checks if the current environment name is {@link Environment.Development}.
+     * @returns `true` if the environment name is {@link Environment.Development}, otherwise `false`.
+     */
+    get isDevelopment(): boolean;
+    /**
+     * Checks if the current environment name is {@link Environment.Production}.
+     * @returns `true` if the environment name is {@link Environment.Production}, otherwise `false`.
+     */
+    get isProduction(): boolean;
+    /**
+     * Checks if the current environment name is {@link Environment.Staging}.
+     * @returns `true` if the environment name is {@link Environment.Staging}, otherwise `false`.
+     */
+    get isStaging(): boolean;
+    /**
+     * Compares the current host environment name against the specified value.
+     * @param environmentName The environment name to validate against.
+     * @returns `true` if the specified name is the same as the current environment, otherwise `false`.
+     */
+    isEnvironment(environmentName: string): boolean;
+}
+/**
+ * Defines the options of a {@link HostEnvironment} instance.
+ */
+export type HostEnvironmentOptions = Partial<{
+    /**
+     * The name of the application.
+     */
+    applicationName: string;
+    /**
+     * The path to the directory that contains the application content files.
+     */
+    contentRootPath: string;
+    /**
+     * The name of the environment.
+     */
+    environmentName: string;
+}>;
+//# sourceMappingURL=HostEnvironment.d.ts.map

package/lib/Hosting/HostEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostEnvironment.d.ts","sourceRoot":"","sources":["../../src/Client/Hosting/HostEnvironment.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,eAAe;IAE3B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;OAGG;gBACS,OAAO,GAAE,sBAA2B;IAMhD;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;CAG/C;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC;IAE5C;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC"}

package/lib/Hosting/HostEnvironment.js

@@ -0,0 +1,56 @@
+import { Environment } from "./Environment.js";
+/**
+ * Provides information about the hosting environment an application is running in.
+ */
+export class HostEnvironment {
+    /**
+     * The name of the application.
+     */
+    applicationName;
+    /**
+     * The path to the directory that contains the application content files.
+     */
+    contentRootPath;
+    /**
+     * The name of the environment.
+     */
+    environmentName;
+    /**
+     * Creates a new host environment.
+     * @param options An object providing values to initialize this instance.
+     */
+    constructor(options = {}) {
+        this.applicationName = options.applicationName ?? document.head.querySelector('meta[name="application-name"]')?.content ?? location.hostname;
+        this.contentRootPath = options.contentRootPath ?? document.head.querySelector("base")?.getAttribute("href") ?? "/";
+        this.environmentName = options.environmentName ?? Environment.Production;
+    }
+    /**
+     * Checks if the current environment name is {@link Environment.Development}.
+     * @returns `true` if the environment name is {@link Environment.Development}, otherwise `false`.
+     */
+    get isDevelopment() {
+        return this.isEnvironment(Environment.Development);
+    }
+    /**
+     * Checks if the current environment name is {@link Environment.Production}.
+     * @returns `true` if the environment name is {@link Environment.Production}, otherwise `false`.
+     */
+    get isProduction() {
+        return this.isEnvironment(Environment.Production);
+    }
+    /**
+     * Checks if the current environment name is {@link Environment.Staging}.
+     * @returns `true` if the environment name is {@link Environment.Staging}, otherwise `false`.
+     */
+    get isStaging() {
+        return this.isEnvironment(Environment.Staging);
+    }
+    /**
+     * Compares the current host environment name against the specified value.
+     * @param environmentName The environment name to validate against.
+     * @returns `true` if the specified name is the same as the current environment, otherwise `false`.
+     */
+    isEnvironment(environmentName) {
+        return this.environmentName == environmentName;
+    }
+}

package/lib/UI/FormExtensions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Represents a form control.
+ */
+export type FormControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+/**
+ * Gets all controls belonging to the specified form.
+ * @param form The form element.
+ * @returns The controls belonging to the specified form.
+ */
+export declare function getFormControls(form: HTMLFormElement): FormControl[];
+/**
+ * Returns the first invalid control from the specified form.
+ * @param form The form element.
+ * @returns The first invalid control, or `null` if all controls are valid.
+ */
+export declare function invalidControl(form: HTMLFormElement): FormControl | null;
+/**
+ * Returns a value indicating whether the specified element is a form control.
+ * @param element The element to check.
+ * @returns `true` if the specified element is a form control, otherwise `false`.
+ */
+export declare function isFormControl(element: Element): element is FormControl;
+/**
+ * Resets the validity of the specified element.
+ * @param element The element to process.
+ */
+export declare function resetValidity(element: Element): void;
+/**
+ * Removes whitespace from both ends of the value of the specified element.
+ * @param element The element to process.
+ */
+export declare function trimControl(element: Element): void;
+//# sourceMappingURL=FormExtensions.d.ts.map

package/lib/UI/FormExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormExtensions.d.ts","sourceRoot":"","sources":["../../src/Client/UI/FormExtensions.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAC,iBAAiB,GAAC,mBAAmB,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,EAAE,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,GAAC,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIlD"}

package/lib/UI/FormExtensions.js

@@ -0,0 +1,50 @@
+/**
+ * The types of form controls that are not text inputs.
+ */
+const nonTextualTypes = new Set(["button", "checkbox", "file", "hidden", "image", "password", "radio", "range", "reset", "submit"]);
+/**
+ * Gets all controls belonging to the specified form.
+ * @param form The form element.
+ * @returns The controls belonging to the specified form.
+ */
+export function getFormControls(form) {
+    return Array.from(form.elements).filter(isFormControl);
+}
+/**
+ * Returns the first invalid control from the specified form.
+ * @param form The form element.
+ * @returns The first invalid control, or `null` if all controls are valid.
+ */
+export function invalidControl(form) {
+    return form.querySelector(":not(fieldset):invalid");
+}
+/**
+ * Returns a value indicating whether the specified element is a form control.
+ * @param element The element to check.
+ * @returns `true` if the specified element is a form control, otherwise `false`.
+ */
+export function isFormControl(element) {
+    return element instanceof HTMLInputElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement;
+}
+/**
+ * Resets the validity of the specified element.
+ * @param element The element to process.
+ */
+export function resetValidity(element) {
+    if (element instanceof HTMLFormElement)
+        getFormControls(element).forEach(control => control.setCustomValidity(""));
+    else if (isFormControl(element))
+        element.setCustomValidity("");
+}
+/**
+ * Removes whitespace from both ends of the value of the specified element.
+ * @param element The element to process.
+ */
+export function trimControl(element) {
+    if (element instanceof HTMLFormElement)
+        getFormControls(element).forEach(trimControl);
+    else if (element instanceof HTMLInputElement && !nonTextualTypes.has(element.type))
+        element.value = element.value.trim();
+    else if (element instanceof HTMLTextAreaElement)
+        element.value = element.value.trim();
+}

package/package.json

@@ -7,13 +7,13 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"devDependencies": {
 		"@playwright/browser-chromium": "^1.54.2",
 		"@types/bootstrap": "^5.2.10",
 		"@types/chai": "^5.2.2",
 		"@types/mocha": "^10.0.10",
-		"@types/node": "^24.2.1",
+		"@types/node": "^24.3.0",
 		"@types/serve-handler": "^6.1.4",
 		"chai": "^5.2.1",
 		"esbuild": "^0.25.9",
@@ -38,9 +38,6 @@
 		"lib/",
 		"src/Client/"
 	],
-	"imports": {
-		"#Base/*.js": "./lib/*.js"
-	},
 	"keywords": [
 		"belin",
 		"core",

package/src/Client/FileExtensions.ts

@@ -1,4 +1,4 @@
-import {Duration} from "#Base/Duration.js";
+import {Duration} from "./Duration.js";
 
 /**
  * Downloads the specified file.

package/src/Client/Hosting/Environment.ts

@@ -0,0 +1,25 @@
+/**
+ * Commonly used environment names.
+ */
+export const Environment = Object.freeze({
+
+	/**
+	 * Specifies the development environment.
+	 */
+	Development: "Development",
+
+	/**
+	 * Specifies the production environment.
+	 */
+	Production: "Production",
+
+	/**
+	 * Specifies the staging environment.
+	 */
+	Staging: "Staging"
+});
+
+/**
+ * Commonly used environment names.
+ */
+export type Environment = typeof Environment[keyof typeof Environment];

package/src/Client/Hosting/HostEnvironment.ts

@@ -0,0 +1,86 @@
+import {Environment} from "./Environment.js";
+
+/**
+ * Provides information about the hosting environment an application is running in.
+ */
+export class HostEnvironment {
+
+	/**
+	 * The name of the application.
+	 */
+	readonly applicationName: string;
+
+	/**
+	 * The path to the directory that contains the application content files.
+	 */
+	readonly contentRootPath: string;
+
+	/**
+	 * The name of the environment.
+	 */
+	readonly environmentName: string;
+
+	/**
+	 * Creates a new host environment.
+	 * @param options An object providing values to initialize this instance.
+	 */
+	constructor(options: HostEnvironmentOptions = {}) {
+		this.applicationName = options.applicationName ?? document.head.querySelector<HTMLMetaElement>('meta[name="application-name"]')?.content ?? location.hostname;
+		this.contentRootPath = options.contentRootPath ?? document.head.querySelector("base")?.getAttribute("href") ?? "/";
+		this.environmentName = options.environmentName ?? Environment.Production;
+	}
+
+	/**
+	 * Checks if the current environment name is {@link Environment.Development}.
+	 * @returns `true` if the environment name is {@link Environment.Development}, otherwise `false`.
+	 */
+	get isDevelopment(): boolean {
+		return this.isEnvironment(Environment.Development);
+	}
+
+	/**
+	 * Checks if the current environment name is {@link Environment.Production}.
+	 * @returns `true` if the environment name is {@link Environment.Production}, otherwise `false`.
+	 */
+	get isProduction(): boolean {
+		return this.isEnvironment(Environment.Production);
+	}
+
+	/**
+	 * Checks if the current environment name is {@link Environment.Staging}.
+	 * @returns `true` if the environment name is {@link Environment.Staging}, otherwise `false`.
+	 */
+	get isStaging(): boolean {
+		return this.isEnvironment(Environment.Staging);
+	}
+
+	/**
+	 * Compares the current host environment name against the specified value.
+	 * @param environmentName The environment name to validate against.
+	 * @returns `true` if the specified name is the same as the current environment, otherwise `false`.
+	 */
+	isEnvironment(environmentName: string): boolean {
+		return this.environmentName == environmentName;
+	}
+}
+
+/**
+ * Defines the options of a {@link HostEnvironment} instance.
+ */
+export type HostEnvironmentOptions = Partial<{
+
+	/**
+	 * The name of the application.
+	 */
+	applicationName: string;
+
+	/**
+	 * The path to the directory that contains the application content files.
+	 */
+	contentRootPath: string;
+
+	/**
+	 * The name of the environment.
+	 */
+	environmentName: string;
+}>;

package/src/Client/Hosting/tsconfig.json

@@ -0,0 +1,13 @@
+{
+	"extends": "../../../tsconfig.json",
+	"include": ["**/*.ts"],
+	"compilerOptions": {
+		"composite": true,
+		"declaration": true,
+		"declarationMap": true,
+		"noEmit": false,
+		"outDir": "../../../lib/Hosting",
+		"rootDir": ".",
+		"tsBuildInfoFile": "../../../var/Hosting.tsbuildinfo"
+	}
+}

package/src/Client/UI/FormExtensions.ts

@@ -0,0 +1,55 @@
+/**
+ * The types of form controls that are not text inputs.
+ */
+const nonTextualTypes = new Set<string>(["button", "checkbox", "file", "hidden", "image", "password", "radio", "range", "reset", "submit"]);
+
+/**
+ * Represents a form control.
+ */
+export type FormControl = HTMLInputElement|HTMLSelectElement|HTMLTextAreaElement;
+
+/**
+ * Gets all controls belonging to the specified form.
+ * @param form The form element.
+ * @returns The controls belonging to the specified form.
+ */
+export function getFormControls(form: HTMLFormElement): FormControl[] {
+	return Array.from(form.elements).filter(isFormControl);
+}
+
+/**
+ * Returns the first invalid control from the specified form.
+ * @param form The form element.
+ * @returns The first invalid control, or `null` if all controls are valid.
+ */
+export function invalidControl(form: HTMLFormElement): FormControl|null {
+	return form.querySelector(":not(fieldset):invalid");
+}
+
+/**
+ * Returns a value indicating whether the specified element is a form control.
+ * @param element The element to check.
+ * @returns `true` if the specified element is a form control, otherwise `false`.
+ */
+export function isFormControl(element: Element): element is FormControl {
+	return element instanceof HTMLInputElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement;
+}
+
+/**
+ * Resets the validity of the specified element.
+ * @param element The element to process.
+ */
+export function resetValidity(element: Element): void {
+	if (element instanceof HTMLFormElement) getFormControls(element).forEach(control => control.setCustomValidity(""));
+	else if (isFormControl(element)) element.setCustomValidity("");
+}
+
+/**
+ * Removes whitespace from both ends of the value of the specified element.
+ * @param element The element to process.
+ */
+export function trimControl(element: Element): void {
+	if (element instanceof HTMLFormElement) getFormControls(element).forEach(trimControl);
+	else if (element instanceof HTMLInputElement && !nonTextualTypes.has(element.type)) element.value = element.value.trim();
+	else if (element instanceof HTMLTextAreaElement) element.value = element.value.trim();
+}

package/src/Client/UI/tsconfig.json

@@ -9,8 +9,5 @@
 		"outDir": "../../../lib/UI",
 		"rootDir": ".",
 		"tsBuildInfoFile": "../../../var/UI.tsbuildinfo"
-	},
-	"references": [
-		{"path": "../Base/tsconfig.json"}
-	]
+	}
 }

package/src/Client/tsconfig.json

@@ -3,6 +3,7 @@
 	"references": [
 		{"path": "Base/tsconfig.json"},
 		{"path": "Data/tsconfig.json"},
+		{"path": "Hosting/tsconfig.json"},
 		{"path": "Net/tsconfig.json"},
 		{"path": "UI/tsconfig.json"}
 	]

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

@@ -1,83 +0,0 @@
-/**
- * Performs HTTP requests.
- */
-export declare class HttpClient {
-    #private;
-    /**
-     * The base URL of the remote service.
-     */
-    readonly baseAddress: 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;
-}>;
-/**
- * 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=HttpClient.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../../src/Client/Net/Http/HttpClient.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,UAAU;;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;IAO1B;;;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;AAEH;;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/Net/Http/HttpClient.js

@@ -1,104 +0,0 @@
-import { MediaType } from "../Mime/MediaType.js";
-import { HttpMethod } from "./HttpMethod.js";
-import { HttpRequestError } from "./HttpRequestError.js";
-/**
- * Performs HTTP requests.
- */
-export class HttpClient {
-    /**
-     * The base URL of the remote service.
-     */
-    baseAddress;
-    /**
-     * 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.baseAddress = new URL(url.endsWith("/") ? url : `${url}/`);
-        this.#loadingIndicator = options.loadingIndicator ?? (() => document.body.querySelector("loading-indicator, .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(HttpMethod.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(HttpMethod.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(HttpMethod.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(HttpMethod.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(HttpMethod.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", MediaType.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", MediaType.Application.Json);
-        }
-        const loadingIndicator = this.#loadingIndicator();
-        try {
-            loadingIndicator?.start();
-            const request = new Request(new URL(url, this.baseAddress), { ...options, method, headers, body });
-            const response = await fetch(request);
-            if (!response.ok)
-                throw new HttpRequestError(response);
-            return response;
-        }
-        finally {
-            loadingIndicator?.stop();
-        }
-    }
-}

package/lib/Net/Http/HttpRequestError.d.ts

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

package/lib/Net/Http/HttpRequestError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"HttpRequestError.d.ts","sourceRoot":"","sources":["../../../src/Client/Net/Http/HttpRequestError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAE3C;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,KAAK;;IAOrD;;;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,UAAU,IAAI,UAAU,CAE3B;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAInD;CAgBD"}

package/lib/Net/Http/HttpRequestError.js

@@ -1,66 +0,0 @@
-import { StatusCode } from "./StatusCode.js";
-/**
- * An error thrown by the HTTP client.
- */
-export class HttpRequestError extends globalThis.Error {
-    /**
-     * The validation errors.
-     */
-    #validationErrors = null;
-    /**
-     * Creates a new HTTP error.
-     * @param response The HTTP response.
-     */
-    constructor(response) {
-        super(`${response.status} ${response.statusText}`, { cause: response });
-        this.name = "HttpRequestError";
-    }
-    /**
-     * The HTTP response.
-     */
-    get cause() {
-        return super.cause;
-    }
-    /**
-     * Value indicating whether the HTTP status code is between 400 and 499.
-     */
-    get isClientError() {
-        const { statusCode } = this;
-        return statusCode >= 400 && statusCode < 500;
-    }
-    /**
-     * Value indicating whether the HTTP status code is between 500 and 599.
-     */
-    get isServerError() {
-        const { statusCode } = this;
-        return statusCode >= 500 && statusCode < 600;
-    }
-    /**
-     * The HTTP status code.
-     */
-    get statusCode() {
-        return this.cause.status;
-    }
-    /**
-     * The validation errors.
-     */
-    get validationErrors() {
-        return this.#validationErrors
-            ? Promise.resolve(this.#validationErrors)
-            : this.#parseValidationErrors().then(errors => this.#validationErrors = errors);
-    }
-    /**
-     * Parses the validation errors returned in the body of the specified response.
-     * @returns The validation errors provided by the response body.
-     */
-    async #parseValidationErrors() {
-        try {
-            const statuses = [StatusCode.BadRequest, StatusCode.UnprocessableContent];
-            const ignoreBody = this.cause.bodyUsed || !statuses.includes(this.statusCode);
-            return new Map(ignoreBody ? [] : Object.entries(await this.cause.json()));
-        }
-        catch {
-            return new Map;
-        }
-    }
-}

package/src/Client/Net/Http/HttpClient.ts

@@ -1,145 +0,0 @@
-import {MediaType} from "../Mime/MediaType.js";
-import {HttpMethod} from "./HttpMethod.js";
-import {HttpRequestError} from "./HttpRequestError.js";
-
-/**
- * Performs HTTP requests.
- */
-export class HttpClient {
-
-	/**
-	 * The base URL of the remote service.
-	 */
-	readonly baseAddress: URL;
-
-	/**
-	 * The function returning the component used as loading indicator.
-	 */
-	readonly #loadingIndicator: () => ILoadingIndicator|null;
-
-	/**
-	 * Creates a new HTTP client.
-	 * @param options An object providing values to initialize this instance.
-	 */
-	constructor(options: HttpClientOptions = {}) {
-		const url = options.baseUrl ? (options.baseUrl instanceof URL ? options.baseUrl.href : options.baseUrl) : document.baseURI;
-		this.baseAddress = new URL(url.endsWith("/") ? url : `${url}/`);
-		this.#loadingIndicator = options.loadingIndicator ?? (() => document.body.querySelector("loading-indicator, .loading-indicator") as ILoadingIndicator|null);
-	}
-
-	/**
-	 * 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> {
-		return this.#fetch(HttpMethod.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?: string|URL, options?: RequestInit): Promise<Response> {
-		return this.#fetch(HttpMethod.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?: string|URL, body?: unknown, options?: RequestInit): Promise<Response> {
-		return this.#fetch(HttpMethod.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?: string|URL, body?: unknown, options?: RequestInit): Promise<Response> {
-		return this.#fetch(HttpMethod.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?: string|URL, body?: unknown, options?: RequestInit): Promise<Response> {
-		return this.#fetch(HttpMethod.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: string, url: string|URL = "", body: unknown = null, options: RequestInit = {}): Promise<Response> {
-		const headers = new Headers(options.headers);
-		if (!headers.has("Accept")) headers.set("Accept", MediaType.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", MediaType.Application.Json);
-		}
-
-		const loadingIndicator = this.#loadingIndicator();
-		try {
-			loadingIndicator?.start();
-			const request = new Request(new URL(url, this.baseAddress), {...options, method, headers, body} as RequestInit);
-			const response = await fetch(request);
-			if (!response.ok) throw new HttpRequestError(response);
-			return response;
-		}
-		finally {
-			loadingIndicator?.stop();
-		}
-	}
-}
-
-/**
- * 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;
-}>;
-
-/**
- * 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;
-}

package/src/Client/Net/Http/HttpRequestError.ts

@@ -1,75 +0,0 @@
-import {StatusCode} from "./StatusCode.js";
-
-/**
- * An error thrown by the HTTP client.
- */
-export class HttpRequestError extends globalThis.Error {
-
-	/**
-	 * The validation errors.
-	 */
-	#validationErrors: Map<string, string>|null = null;
-
-	/**
-	 * Creates a new HTTP error.
-	 * @param response The HTTP response.
-	 */
-	constructor(response: Response) {
-		super(`${response.status} ${response.statusText}`, {cause: response});
-		this.name = "HttpRequestError";
-	}
-
-	/**
-	 * The HTTP response.
-	 */
-	override get cause(): Response {
-		return super.cause as Response;
-	}
-
-	/**
-	 * Value indicating whether the HTTP status code is between 400 and 499.
-	 */
-	get isClientError(): boolean {
-		const {statusCode} = this;
-		return statusCode >= 400 && statusCode < 500;
-	}
-
-	/**
-	 * Value indicating whether the HTTP status code is between 500 and 599.
-	 */
-	get isServerError(): boolean {
-		const {statusCode} = this;
-		return statusCode >= 500 && statusCode < 600;
-	}
-
-	/**
-	 * The HTTP status code.
-	 */
-	get statusCode(): StatusCode {
-		return this.cause.status as StatusCode;
-	}
-
-	/**
-	 * The validation errors.
-	 */
-	get validationErrors(): Promise<Map<string, string>> {
-		return this.#validationErrors
-			? Promise.resolve(this.#validationErrors)
-			: this.#parseValidationErrors().then(errors => this.#validationErrors = errors);
-	}
-
-	/**
-	 * Parses the validation errors returned in the body of the specified response.
-	 * @returns The validation errors provided by the response body.
-	 */
-	async #parseValidationErrors(): Promise<Map<string, string>> {
-		try {
-			const statuses: StatusCode[] = [StatusCode.BadRequest, StatusCode.UnprocessableContent];
-			const ignoreBody = this.cause.bodyUsed || !statuses.includes(this.statusCode);
-			return new Map(ignoreBody ? [] : Object.entries(await this.cause.json() as Record<string, string>));
-		}
-		catch {
-			return new Map;
-		}
-	}
-}