xdbc 1.0.108 → 1.0.109

package/dist/DBC/EQ.js

@@ -86,6 +86,23 @@ export class EQ extends DBC {
     check(toCheck) {
         return EQ.checkAlgorithm(toCheck, this.equivalent, this.invert);
     }
+    /**
+     * Invokes the {@link EQ.checkAlgorithm } passing the value **toCheck** and the specified **type** .
+     *
+     * @param toCheck See {@link EQ.checkAlgorithm }.
+     *
+     * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link EQ }.
+     *
+     * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link EQ }.*/
+    static tsCheck(toCheck, equivalent) {
+        const result = EQ.checkAlgorithm(toCheck, equivalent, false);
+        if (result) {
+            return toCheck;
+        }
+        else {
+            throw new DBC.Infringement(result);
+        }
+    }
     /**
      * Creates this {@link EQ } by setting the protected property {@link EQ.equivalent } used by {@link EQ.check }.
      *

package/dist/DBC.js

@@ -70,9 +70,8 @@ export class DBC {
         const originalMethod = descriptor.value;
         // biome-ignore lint/suspicious/noExplicitAny: Gotta be any since parameter-values may be undefined.
         descriptor.value = function (...args) {
-            // to correctly capture 'this' from the call site
             // #region   Check if a value of one of the method's parameter has been requested and pass it to the
-            //            receptor, if so.
+            //           receptor, if so.
             if (DBC.paramValueRequests.has(target) &&
                 DBC.paramValueRequests.get(target).has(propertyKey)) {
                 for (const index of DBC.paramValueRequests
@@ -89,10 +88,8 @@ export class DBC {
                     }
                 }
             }
-            // #endregion   Check if a value of one of the method's parameter has been requested and pass it to the
+            // #endregion	Check if a value of one of the method's parameter has been requested and pass it to the
             //              receptor, if so.
-            // The 'this' here is now the correct 'this' of the instance
-            // where the decorated method was called.
             return originalMethod.apply(this, args);
         };
         return descriptor;

package/package.json

@@ -1,5 +1,5 @@
 {
-	"version": "1.0.108",
+	"version": "1.0.109",
 	"name": "xdbc",
 	"scripts": {
 		"docs": "typedoc",

package/src/DBC/EQ.ts

@@ -124,6 +124,24 @@ export class EQ extends DBC {
 	public check(toCheck: any) {
 		return EQ.checkAlgorithm(toCheck, this.equivalent, this.invert);
 	}
+	/**
+	 * Invokes the {@link EQ.checkAlgorithm } passing the value **toCheck** and the specified **type** .
+	 *
+	 * @param toCheck See {@link EQ.checkAlgorithm }.
+	 *
+	 * @returns The **CANDIDATE** **toCheck** doesn't fulfill this {@link EQ }.
+	 * 
+	 * @throws A {@link DBC.Infringement } if the **CANDIDATE** **toCheck** does not fulfill this {@link EQ }.*/
+	public static tsCheck<CANDIDATE>( toCheck : CANDIDATE | undefined | null, equivalent : any ) : CANDIDATE {
+		const result = EQ.checkAlgorithm(toCheck, equivalent, false );
+
+		if( result ) {
+			return toCheck as CANDIDATE ;
+		}
+		else {
+			throw new DBC.Infringement( result as string );
+		}
+	}
 	/**
 	 * Creates this {@link EQ } by setting the protected property {@link EQ.equivalent } used by {@link EQ.check }.
 	 *

package/src/DBC.ts

@@ -92,41 +92,36 @@ export class DBC {
     propertyKey: string,
     descriptor: PropertyDescriptor,
 ): PropertyDescriptor {
-    const originalMethod = descriptor.value;
-
-    // biome-ignore lint/suspicious/noExplicitAny: Gotta be any since parameter-values may be undefined.
-    descriptor.value = function (...args: any[]) { // Changed to a regular function expression
-                                                  // to correctly capture 'this' from the call site
-        // #region   Check if a value of one of the method's parameter has been requested and pass it to the
-        //            receptor, if so.
-        if (
-            DBC.paramValueRequests.has(target) &&
-            DBC.paramValueRequests.get(target).has(propertyKey)
-        ) {
-            for (const index of DBC.paramValueRequests
-                .get(target)
-                .get(propertyKey)
-                .keys()) {
-                if (index < args.length) {
-                    for (const receptor of DBC.paramValueRequests
-                        .get(target)
-                        .get(propertyKey)
-                        .get(index)) {
-                        receptor(args[index]);
-                    }
-                }
-            }
-        }
-        // #endregion   Check if a value of one of the method's parameter has been requested and pass it to the
-        //              receptor, if so.
-
-        // The 'this' here is now the correct 'this' of the instance
-        // where the decorated method was called.
-        return originalMethod.apply(this, args);
-    };
+		const originalMethod = descriptor.value;
+		// biome-ignore lint/suspicious/noExplicitAny: Gotta be any since parameter-values may be undefined.
+		descriptor.value = function (...args: any[]) {
+			// #region   Check if a value of one of the method's parameter has been requested and pass it to the
+			//           receptor, if so.
+			if (
+				DBC.paramValueRequests.has(target) &&
+				DBC.paramValueRequests.get(target).has(propertyKey)
+			) {
+				for (const index of DBC.paramValueRequests
+					.get(target)
+					.get(propertyKey)
+					.keys()) {
+					if (index < args.length) {
+						for (const receptor of DBC.paramValueRequests
+							.get(target)
+							.get(propertyKey)
+							.get(index)) {
+							receptor(args[index]);
+						}
+					}
+				}
+			}
+			// #endregion	Check if a value of one of the method's parameter has been requested and pass it to the
+			//              receptor, if so.
+			return originalMethod.apply(this, args);
+		};
 
-    return descriptor;
-}
+		return descriptor;
+	}
 	// #endregion Parameter-value requests.
 	// #region Class
 	/**