@twin.org/core 0.0.1-next.26 → 0.0.1-next.27

package/dist/cjs/index.cjs

@@ -3009,6 +3009,18 @@ class Coerce {
             return value.getTime();
         }
     }
+    /**
+     * Coerce the value to an integer.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static integer(value) {
+        const num = Coerce.number(value);
+        if (!Is.undefined(num)) {
+            return Math.trunc(num);
+        }
+    }
     /**
      * Coerce the value to a bigint.
      * @param value The value to coerce.
@@ -3155,6 +3167,25 @@ class Coerce {
             catch { }
         }
     }
+    /**
+     * Coerce the value to a Uint8Array.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static uint8Array(value) {
+        if (Is.undefined(value)) {
+            return value;
+        }
+        if (Is.string(value)) {
+            if (Is.stringHex(value.toLowerCase(), true)) {
+                return Converter.hexToBytes(value.toLowerCase());
+            }
+            if (Is.stringBase64(value)) {
+                return Converter.base64ToBytes(value);
+            }
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

package/dist/esm/index.mjs

@@ -3007,6 +3007,18 @@ class Coerce {
             return value.getTime();
         }
     }
+    /**
+     * Coerce the value to an integer.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static integer(value) {
+        const num = Coerce.number(value);
+        if (!Is.undefined(num)) {
+            return Math.trunc(num);
+        }
+    }
     /**
      * Coerce the value to a bigint.
      * @param value The value to coerce.
@@ -3153,6 +3165,25 @@ class Coerce {
             catch { }
         }
     }
+    /**
+     * Coerce the value to a Uint8Array.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static uint8Array(value) {
+        if (Is.undefined(value)) {
+            return value;
+        }
+        if (Is.string(value)) {
+            if (Is.stringHex(value.toLowerCase(), true)) {
+                return Converter.hexToBytes(value.toLowerCase());
+            }
+            if (Is.stringBase64(value)) {
+                return Converter.base64ToBytes(value);
+            }
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.

package/dist/types/utils/coerce.d.ts

@@ -16,6 +16,13 @@ export declare class Coerce {
      * @returns The value if it can be coerced.
      */
     static number(value: unknown): number | undefined;
+    /**
+     * Coerce the value to an integer.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static integer(value: unknown): number | undefined;
     /**
      * Coerce the value to a bigint.
      * @param value The value to coerce.
@@ -58,4 +65,11 @@ export declare class Coerce {
      * @returns The value if it can be coerced.
      */
     static object<T = unknown>(value: unknown): T | undefined;
+    /**
+     * Coerce the value to a Uint8Array.
+     * @param value The value to coerce.
+     * @throws TypeError If the value can not be coerced.
+     * @returns The value if it can be coerced.
+     */
+    static uint8Array(value: unknown): Uint8Array | undefined;
 }

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/core - Changelog
 
-## 0.0.1-next.26
+## 0.0.1-next.27
 
 - Initial Release

package/docs/reference/classes/Coerce.md

@@ -66,6 +66,32 @@ TypeError If the value can not be coerced.
 
 ***
 
+### integer()
+
+> `static` **integer**(`value`): `undefined` \| `number`
+
+Coerce the value to an integer.
+
+#### Parameters
+
+##### value
+
+`unknown`
+
+The value to coerce.
+
+#### Returns
+
+`undefined` \| `number`
+
+The value if it can be coerced.
+
+#### Throws
+
+TypeError If the value can not be coerced.
+
+***
+
 ### bigint()
 
 > `static` **bigint**(`value`): `undefined` \| `bigint`
@@ -223,3 +249,29 @@ The value if it can be coerced.
 #### Throws
 
 TypeError If the value can not be coerced.
+
+***
+
+### uint8Array()
+
+> `static` **uint8Array**(`value`): `undefined` \| `Uint8Array`
+
+Coerce the value to a Uint8Array.
+
+#### Parameters
+
+##### value
+
+`unknown`
+
+The value to coerce.
+
+#### Returns
+
+`undefined` \| `Uint8Array`
+
+The value if it can be coerced.
+
+#### Throws
+
+TypeError If the value can not be coerced.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.1-next.26",
+	"version": "0.0.1-next.27",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",