xdbc 1.0.207 → 1.0.209

package/dist/DBC/OR.js

@@ -1,113 +0,0 @@
-import { DBC } from "../DBC";
-/**
- * A {@link DBC } defining that all elements of an {@link object }s have to fulfill
- * one of the given {@link object }s check-methods (**( toCheck : any ) => boolean | string** ).
- *
- * @remarks
- * Maintainer: Callari, Salvatore (XDBC@WaXCode.net) */
-export class OR extends DBC {
-    // #region Condition checking.
-    /**
-     * Checks the **value** against the given **conditions**
-     *
-     * @param conditions	The **{ check: (toCheck: any) => boolean | string }**-{@link object }s to check the **value** against.
-     * @param value			Either **value**-{@link Array < any >}, which's elements will be checked, or the value to be
-     * 						checked itself.
-     * @param index			If specified with "idxEnd" being undefined, this {@link Number } will be seen as the index of
-     * 						the value-{@link Array }'s element to check. If value isn't an {@link Array } this parameter
-     * 						will not have any effect.
-     * 						With "idxEnd" not undefined this parameter indicates the beginning of the span of elements to
-     * 						check within the value-{@link Array }.
-     * @param idxEnd		Indicates the last element's index (including) of the span of value-{@link Array } elements to check.
-     * 						Setting this parameter to -1 specifies that all value-{@link Array }'s elements beginning from the
-     * 						specified **index** shall be checked.
-     *
-     * @returns TRUE if at least one of the provided **conditions** is fulfilled, otherwise a {@link string } containing all **conditions** returned {@link string }s separated by " || ". */
-    static checkAlgorithm(conditions, value) {
-        let result = "";
-        for (let i = 0; i < conditions.length; i++) {
-            const conditionResult = conditions[i].check(value);
-            if (typeof conditionResult === "string") {
-                result += `${conditionResult}${i === conditions.length - 1 ? "" : " or "}`;
-            }
-            else {
-                return true;
-            }
-        }
-        return result;
-    }
-    /**
-     * A parameter-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
-     * of the **realConditions** to check the tagged parameter-value against with.
-     * When specifying an **index** and the tagged parameter's **value** is an {@link Array }, the **realConditions** apply to the
-     * element at the specified **index**.
-     * If the {@link Array } is too short the currently processed { check: (toCheck: any) => boolean | string } of
-     * **realConditions** will be verified to TRUE automatically, considering optional parameters.
-     * If an **index** is specified but the tagged parameter's value isn't an array, the **index** is treated as being undefined.
-     * If **index** is undefined and the tagged parameter's value is an {@link Array } each element of it will be checked
-     * against the **realConditions**.
-     *
-     * @param realConditions	Either one or more **{ check: (toCheck: any) => boolean | string }** to check the tagged parameter-value
-     * 							against with.
-     * @param path				See {@link DBC.decPrecondition }.
-     * @param dbc				See {@link DBC.decPrecondition }.
-     *
-     * @returns	A {@link string } as soon as one { check: (toCheck: any) => boolean | string } of **realConditions** returns one.
-     * 			Otherwise TRUE. */
-    static PRE(conditions, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPrecondition((value, target, methodName, parameterIndex) => {
-            return OR.checkAlgorithm(conditions, value);
-        }, dbc, path);
-    }
-    /**
-     * A method-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
-     * of the **realConditions** to check the tagged method's return-value against with.
-     *
-     * @param realConditions	Either one or more { check: (toCheck: any) => boolean | string } to check the tagged parameter-value
-     * 							against with.
-     * @param path				See {@link DBC.decPrecondition }.
-     * @param dbc				See {@link DBC.decPrecondition }.
-     *
-     * @returns	A {@link string } as soon as one **{ check: (toCheck: any) => boolean | string }** of **realConditions** return one.
-     * 			Otherwise TRUE. */
-    static POST(conditions, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPostcondition((value, target, propertyKey) => {
-            return OR.checkAlgorithm(conditions, value);
-        }, dbc, path);
-    }
-    /**
-     * A field-decorator factory using the {@link OR.checkAlgorithm } with either multiple or a single one
-     * of the **realConditions** to check the tagged field.
-     *
-     * @param realConditions	Either one or more { check: (toCheck: any) => boolean | string } to check the tagged parameter-value
-     * 							against with.
-     * @param path				See {@link DBC.decInvariant }.
-     * @param dbc				See {@link DBC.decInvariant }.
-     *
-     * @returns	See {@link DBC.decInvariant }. */
-    static INVARIANT(conditions, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decInvariant([new OR(conditions)], path, dbc);
-    }
-    // #endregion Condition checking.
-    // #region Referenced Condition checking.
-    //
-    // For usage in dynamic scenarios (like global functions).
-    //
-    /**
-     * Invokes the {@link OR.checkAlgorithm } passing the value **toCheck** and {@link OR.conditions }.
-     *
-     * @param toCheck See {@link OR.checkAlgorithm }.
-     *
-     * @returns See {@link OR.checkAlgorithm}. */
-    check(toCheck) {
-        return OR.checkAlgorithm(this.conditions, toCheck);
-    }
-    /**
-     * Creates this {@link OR } by setting the protected property {@link OR.conditions } used by {@link OR.check }.
-     *
-     * @param conditions See {@link OR.check }. */
-    constructor(conditions) {
-        super();
-        this.conditions = conditions;
-    }
-}

package/dist/DBC/REGEX.js

@@ -1,110 +0,0 @@
-import { DBC } from "../DBC";
-/**
- * A {@link DBC } providing {@link REGEX }-contracts and standard {@link RegExp } for common use cases in {@link REGEX.stdExp }.
- *
- * @remarks
- * Maintainer: Callari, Salvatore (XDBC@WaXCode.net) */
-export class REGEX extends DBC {
-    // #region Condition checking.
-    /**
-     * Checks if the value **toCheck** is complies to the {@link RegExp } **expression**.
-     *
-     * @param toCheck		The value that has comply to the {@link RegExp } **expression** for this {@link DBC } to be fulfilled.
-     * @param expression	The {@link RegExp } the one **toCheck** has comply to in order for this {@link DBC } to be
-     * 						fulfilled.
-     *
-     * @returns TRUE if the value **toCheck** complies with the {@link RegExp } **expression**, otherwise FALSE. */
-    static checkAlgorithm(toCheck, expression) {
-        if (!expression.test(toCheck)) {
-            return `Value has to comply to regular expression "${expression}"`;
-        }
-        return true;
-    }
-    /**
-     * A parameter-decorator factory using the {@link REGEX.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged parameter.
-     *
-     * @param expression	See {@link REGEX.checkAlgorithm }.
-     * @param path			See {@link DBC.decPrecondition }.
-     * @param dbc			See {@link DBC.decPrecondition }.
-     *
-     * @returns See {@link DBC.decPrecondition }. */
-    static PRE(expression, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPrecondition((value, target, methodName, parameterIndex) => {
-            return REGEX.checkAlgorithm(value, expression);
-        }, dbc, path);
-    }
-    /**
-     * A method-decorator factory using the {@link REGEX.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged method's returnvalue.
-     *
-     * @param expression	See {@link REGEX.checkAlgorithm }.
-     * @param path			See {@link DBC.Postcondition }.
-     * @param dbc			See {@link DBC.decPostcondition }.
-     *
-     * @returns See {@link DBC.decPostcondition }. */
-    static POST(expression, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPostcondition((value, target, propertyKey) => {
-            return REGEX.checkAlgorithm(value, expression);
-        }, dbc, path);
-    }
-    /**
-     * A field-decorator factory using the {@link REGEX.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged field.
-     *
-     * @param expression	See {@link REGEX.checkAlgorithm }.
-     * @param path			See {@link DBC.decInvariant }.
-     * @param dbc			See {@link DBC.decInvariant }.
-     *
-     * @returns See {@link DBC.decInvariant }. */
-    static INVARIANT(expression, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decInvariant([new REGEX(expression)], path, dbc);
-    }
-    // #endregion Condition checking.
-    // #region Referenced Condition checking.
-    //
-    // For usage in dynamic scenarios (like with AE-DBC).
-    //
-    /**
-     * Invokes the {@link REGEX.checkAlgorithm } passing the value **toCheck** and {@link REGEX.equivalent }.
-     *
-     * @param toCheck See {@link REGEX.checkAlgorithm }.
-     *
-     * @returns See {@link EQ.checkAlgorithm}. */
-    check(toCheck) {
-        return REGEX.checkAlgorithm(toCheck, this.expression);
-    }
-    /**
-     * Creates this {@link REGEX } by setting the protected property {@link REGEX.expression } used by {@link REGEX.check }.
-     *
-     * @param expression See {@link REGEX.check }. */
-    constructor(expression) {
-        super();
-        this.expression = expression;
-    }
-    // #endregion Referenced Condition checking.
-    // #region In-Method checking.
-    /**
-     * Invokes the {@link REGEX.checkAlgorithm } passing the value **toCheck** and {@link REGEX.expression }.
-     *
-     * @param toCheck		See {@link REGEX.checkAlgorithm}.
-     * @param expression	See {@link REGEX.checkAlgorithm}.
-     */
-    static check(toCheck, expression) {
-        const checkResult = REGEX.checkAlgorithm(toCheck, expression);
-        if (typeof checkResult === "string") {
-            throw new DBC.Infringement(checkResult);
-        }
-    }
-}
-/** Stores often used {@link RegExp }s. */
-REGEX.stdExp = {
-    htmlAttributeName: /^[a-zA-Z_:][a-zA-Z0-9_.:-]*$/,
-    eMail: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/i,
-    property: /^[$_A-Za-z][$_A-Za-z0-9]*$/,
-    url: /^(?:(?:http:|https?|ftp):\/\/)?(?:\S+(?::\S*)?@)?(?:localhost|(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z]{2,})(?::\d{2,5})?(?:\/(?:[\w\-\.]*\/)*[\w\-\.]+(?:\?\S*)?(?:#\S*)?)?$/i,
-    keyPath: /^([a-zA-Z_$][a-zA-Z0-9_$]*\.)*[a-zA-Z_$][a-zA-Z0-9_$]*$/,
-    date: /^\d{1,4}[.\/-]\d{1,2}[.\/-]\d{1,4}$/i,
-    dateFormat: /^((D{1,2}[./-]M{1,2}[./-]Y{1,4})|(M{1,2}[./-]D{1,2}[./-]Y{1,4})|Y{1,4}[./-]D{1,2}[./-]M{1,2}|(Y{1,4}[./-]M{1,2}[./-]D{1,2}))$/i,
-    cssSelector: /^(?:\*|#[\w-]+|\.[\w-]+|(?:[\w-]+|\*)(?::(?:[\w-]+(?:\([\w-]+\))?)+)?(?:\[(?:[\w-]+(?:(?:=|~=|\|=|\*=|\$=|\^=)\s*(?:"[^"]*"|'[^']*'|[\w-]+)\s*)?)?\])+|\[\s*[\w-]+\s*=\s*(?:"[^"]*"|'[^']*'|[\w-]+)\s*\])(?:,\s*(?:\*|#[\w-]+|\.[\w-]+|(?:[\w-]+|\*)(?::(?:[\w-]+(?:\([\w-]+\))?)+)?(?:\[(?:[\w-]+(?:(?:=|~=|\|=|\*=|\$=|\^=)\s*(?:"[^"]*"|'[^']*'|[\w-]+)\s*)?)?\])+|\[\s*[\w-]+\s*=\s*(?:"[^"]*"|'[^']*'|[\w-]+)\s*\]))*$/,
-};

package/dist/DBC/TYPE.js

@@ -1,87 +0,0 @@
-import { DBC } from "../DBC";
-/**
- * A {@link DBC } defining that an {@link object }s gotta be of certain {@link TYPE.type }.
- *
- * @remarks
- * Author: 		Salvatore Callari (Callari@WaXCode.net) / 2025
- * Maintainer:	Salvatore Callari (XDBC@WaXCode.net) */
-export class TYPE extends DBC {
-    /**
-     * Checks if the value **toCheck** is of the **type** specified.
-     *
-     * @param toCheck	The {@link Object } which's **type** to check.
-     * @param type		The type the {@link object} **toCheck** has to be of.
-     *
-     * @returns TRUE if the value **toCheck** is of the specified **type**, otherwise FALSE. */
-    // biome-ignore lint/suspicious/noExplicitAny: Necessary for dynamic type checking of also UNDEFINED.
-    static checkAlgorithm(toCheck, type) {
-        // biome-ignore lint/suspicious/useValidTypeof: Necessary
-        if (typeof toCheck !== type) {
-            return `Value has to to be of type "${type}" but is of type "${typeof toCheck}"`;
-        }
-        return true;
-    }
-    /**
-     * A parameter-decorator factory using the {@link TYPE.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged parameter.
-     *
-     * @param type	See {@link TYPE.checkAlgorithm }.
-     * @param path	See {@link DBC.decPrecondition }.
-     * @param dbc	See {@link DBC.decPrecondition }.
-     *
-     * @returns See {@link DBC.decPrecondition }. */
-    static PRE(type, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPrecondition((value, target, methodName, parameterIndex) => {
-            return TYPE.checkAlgorithm(value, type);
-        }, dbc, path);
-    }
-    /**
-     * A method-decorator factory using the {@link TYPE.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged method's returnvalue.
-     *
-     * @param type	See {@link TYPE.checkAlgorithm }.
-     * @param path	See {@link DBC.Postcondition }.
-     * @param dbc	See {@link DBC.decPostcondition }.
-     *
-     * @returns See {@link DBC.decPostcondition }. */
-    static POST(type, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPostcondition((value, target, propertyKey) => {
-            return TYPE.checkAlgorithm(value, type);
-        }, dbc, path);
-    }
-    /**
-     * A field-decorator factory using the {@link TYPE.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged field.
-     *
-     * @param type	See {@link TYPE.checkAlgorithm }.
-     * @param path	See {@link DBC.decInvariant }.
-     * @param dbc	See {@link DBC.decInvariant }.
-     *
-     * @returns See {@link DBC.decInvariant }. */
-    static INVARIANT(type, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decInvariant([new TYPE(type)], path, dbc);
-    }
-    // #endregion Condition checking.
-    // #region Referenced Condition checking.
-    //
-    // For usage in dynamic scenarios (like with AE-DBC).
-    //
-    /**
-     * Invokes the {@link TYPE.checkAlgorithm } passing the value **toCheck** and the {@link TYPE.type } .
-     *
-     * @param toCheck See {@link TYPE.checkAlgorithm }.
-     *
-     * @returns See {@link TYPE.checkAlgorithm}. */
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
-    check(toCheck) {
-        return TYPE.checkAlgorithm(toCheck, this.type);
-    }
-    /**
-     * Creates this {@link TYPE } by setting the protected property {@link TYPE.type } used by {@link TYPE.check }.
-     *
-     * @param type See {@link TYPE.check }. */
-    constructor(type) {
-        super();
-        this.type = type;
-    }
-}

package/dist/DBC/ZOD.js

@@ -1,114 +0,0 @@
-import { DBC } from "../DBC";
-import { z } from 'zod';
-/**
- * A {@link DBC } defining that the an {@link object }s gotta be an instance of a certain {@link ZOD.schema }.
- *
- * @remarks
- * Maintainer: Salvatore Callari (XDBC@WaXCode.net) */
-export class ZOD extends DBC {
-    /**
-     * Checks if the value **toCheck** complies to the specified {@link z.ZodType }.
-     *
-     * @param toCheck	The value that has to comply to the specified **schema** in order for this {@link DBC }
-     * @param schema	The {@link z.ZodType } the {@link object } **toCheck** has comply to in order for this {@link DBC } to be
-     * 					fulfilled.
-     *
-     * @returns TRUE if the value **toCheck** complies to the specified **schema**, otherwise FALSE. */
-    // biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-    static checkAlgorithm(toCheck, schema) {
-        if (!schema.safeParse(toCheck).success) {
-            console.log(z.toJSONSchema(schema));
-            return `Value has to correspond to "${JSON.stringify(z.toJSONSchema(schema).properties)}" but is constituted as "${JSON.stringify(toCheck)}"`;
-        }
-        return true;
-    }
-    /**
-     * A parameter-decorator factory using the {@link ZOD.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged parameter.
-     *
-     * @param schema	See {@link ZOD.checkAlgorithm }.
-     * @param path		See {@link DBC.decPrecondition }.
-     * @param dbc		See {@link DBC.decPrecondition }.
-     *
-     * @returns See {@link DBC.decPrecondition }. */
-    static PRE(
-    // biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-    schema, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPrecondition((value, target, methodName, parameterIndex) => {
-            return ZOD.checkAlgorithm(value, schema);
-        }, dbc, path);
-    }
-    /**
-     * A method-decorator factory using the {@link ZOD.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged method's returnvalue.
-     *
-     * @param schema	See {@link ZOD.checkAlgorithm }.
-     * @param path	See {@link DBC.Postcondition }.
-     * @param dbc	See {@link DBC.decPostcondition }.
-     *
-     * @returns See {@link DBC.decPostcondition }. */
-    static POST(
-    // biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-    schema, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decPostcondition((value, target, propertyKey) => {
-            return ZOD.checkAlgorithm(value, schema);
-        }, dbc, path);
-    }
-    /**
-     * A field-decorator factory using the {@link ZOD.checkAlgorithm } to determine whether this {@link DBC } is fulfilled
-     * by the tagged method's returnvalue.
-     *
-     * @param schema	See {@link ZOD.checkAlgorithm }.
-     * @param path	See {@link DBC.decInvariant }.
-     * @param dbc	See {@link DBC.decInvariant }.
-     *
-     * @returns See {@link DBC.decInvariant }. */
-    static INVARIANT(
-    // biome-ignore lint/suspicious/noExplicitAny: In order to perform an "instanceof" check.
-    schema, path = undefined, dbc = "WaXCode.DBC") {
-        return DBC.decInvariant([new ZOD(schema)], path, dbc);
-    }
-    // #endregion Condition checking.
-    // #region Referenced Condition checking.
-    //
-    // For usage in dynamic scenarios (like with AE-DBC).
-    //
-    /**
-     * Invokes the {@link ZOD.checkAlgorithm } passing the value **toCheck** and the {@link ZOD.schema } .
-     *
-     * @param toCheck See {@link ZOD.checkAlgorithm }.
-     *
-     * @returns See {@link ZOD.checkAlgorithm}. */
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
-    check(toCheck) {
-        return ZOD.checkAlgorithm(toCheck, this.schema);
-    }
-    /**
-     * Invokes the {@link ZOD.checkAlgorithm } passing the value **toCheck** and the {@link ZOD.schema } .
-     *
-     * @param toCheck 	See {@link ZOD.checkAlgorithm }.
-     * @param schema	See {@link ZOD.checkAlgorithm }.
-     * @param id		A {@link string } identifying this {@link ZOD } via the {@link DBC.Infringement }-Message.
-     *
-     * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link ZOD }.
-     *
-     * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link DEFINED }. */
-    static tsCheck(toCheck, schema, id = undefined) {
-        const result = ZOD.checkAlgorithm(toCheck, schema);
-        if (result === true) {
-            return toCheck;
-        }
-        else {
-            throw new DBC.Infringement(`${id ? `(${id}) ` : ""}${result}`);
-        }
-    }
-    /**
-     * Creates this {@link ZOD } by setting the protected property {@link ZOD.schema } used by {@link ZOD.check }.
-     *
-     * @param schema See {@link ZOD.check }. */
-    // biome-ignore lint/suspicious/noExplicitAny: <explanation>
-    constructor(schema) {
-        super();
-        this.schema = schema;
-    }
-}