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

package/dist/cjs/index.cjs

@@ -2525,7 +2525,7 @@ class ObjectHelper {
         let pathValue = obj;
         for (const pathPart of pathParts) {
             // Is the path part numeric i.e. an array index.
-            const arrayMatch = /(\d+)/.exec(pathPart);
+            const arrayMatch = /^(\d+)$/.exec(pathPart);
             if (arrayMatch) {
                 const arrayIndex = Number.parseInt(arrayMatch[1], 10);
                 if (Is.arrayValue(pathValue) && arrayIndex < pathValue.length) {
@@ -2561,7 +2561,7 @@ class ObjectHelper {
         for (let i = 0; i < pathParts.length; i++) {
             const pathPart = pathParts[i];
             // Is the path part numeric i.e. an array index.
-            const arrayMatch = /(\d+)/.exec(pathPart);
+            const arrayMatch = /^(\d+)$/.exec(pathPart);
             const arrayIndex = arrayMatch ? Number.parseInt(arrayMatch[1], 10) : -1;
             if (i === pathParts.length - 1) {
                 // Last part of path so set the value
@@ -2592,7 +2592,7 @@ class ObjectHelper {
                     pathValue = pathValue[arrayIndex];
                 }
                 if (Is.empty(pathValue)) {
-                    const nextArrayMatch = /(\d+)/.exec(pathParts[i + 1]);
+                    const nextArrayMatch = /^(\d+)$/.exec(pathParts[i + 1]);
                     const nextArrayIndex = nextArrayMatch ? Number.parseInt(nextArrayMatch[1], 10) : -1;
                     if (nextArrayIndex >= 0) {
                         pathValue = [];
@@ -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

@@ -2523,7 +2523,7 @@ class ObjectHelper {
         let pathValue = obj;
         for (const pathPart of pathParts) {
             // Is the path part numeric i.e. an array index.
-            const arrayMatch = /(\d+)/.exec(pathPart);
+            const arrayMatch = /^(\d+)$/.exec(pathPart);
             if (arrayMatch) {
                 const arrayIndex = Number.parseInt(arrayMatch[1], 10);
                 if (Is.arrayValue(pathValue) && arrayIndex < pathValue.length) {
@@ -2559,7 +2559,7 @@ class ObjectHelper {
         for (let i = 0; i < pathParts.length; i++) {
             const pathPart = pathParts[i];
             // Is the path part numeric i.e. an array index.
-            const arrayMatch = /(\d+)/.exec(pathPart);
+            const arrayMatch = /^(\d+)$/.exec(pathPart);
             const arrayIndex = arrayMatch ? Number.parseInt(arrayMatch[1], 10) : -1;
             if (i === pathParts.length - 1) {
                 // Last part of path so set the value
@@ -2590,7 +2590,7 @@ class ObjectHelper {
                     pathValue = pathValue[arrayIndex];
                 }
                 if (Is.empty(pathValue)) {
-                    const nextArrayMatch = /(\d+)/.exec(pathParts[i + 1]);
+                    const nextArrayMatch = /^(\d+)$/.exec(pathParts[i + 1]);
                     const nextArrayIndex = nextArrayMatch ? Number.parseInt(nextArrayMatch[1], 10) : -1;
                     if (nextArrayIndex >= 0) {
                         pathValue = [];
@@ -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.25
+## 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.25",
+	"version": "0.0.1-next.27",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",