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

package/dist/cjs/index.cjs

@@ -2101,76 +2101,6 @@ class ArrayHelper {
     }
 }
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Helpers methods for JSON objects.
- */
-class JsonHelper {
-    /**
-     * Serializes in canonical format.
-     * Based on https://www.rfc-editor.org/rfc/rfc8785.
-     * @param object The object to be serialized.
-     * @returns The serialized object.
-     */
-    static canonicalize(object) {
-        const buffer = [];
-        if (object === null ||
-            typeof object !== "object" ||
-            ("toJSON" in object && object.toJSON instanceof Function)) {
-            // Primitive data type
-            buffer.push(JSON.stringify(object));
-        }
-        else if (Array.isArray(object)) {
-            // Array maintain element order
-            const parts = [];
-            for (const element of object) {
-                if (element === undefined) {
-                    parts.push("null");
-                }
-                else {
-                    parts.push(JsonHelper.canonicalize(element));
-                }
-            }
-            buffer.push(`[${parts.join(",")}]`);
-        }
-        else {
-            // Object sort properties
-            const props = [];
-            const keys = Object.keys(object).sort();
-            const o = object;
-            for (const key of keys) {
-                if (o[key] !== undefined) {
-                    props.push(`${JSON.stringify(key)}:${JsonHelper.canonicalize(o[key])}`);
-                }
-            }
-            buffer.push(`{${props.join(",")}}`);
-        }
-        return buffer.join("");
-    }
-    /**
-     * Creates a RFC 6902 diff set.
-     * Based on https://www.rfc-editor.org/rfc/rfc6902.
-     * @param object1 The first object.
-     * @param object2 The second object.
-     * @returns The list of patches.
-     */
-    static diff(object1, object2) {
-        const operations = rfc6902.createPatch(object1, object2);
-        return operations;
-    }
-    /**
-     * Applies a RFC 6902 diff set to an object.
-     * Based on https://www.rfc-editor.org/rfc/rfc6902.
-     * @param object The object to patch.
-     * @param patches The second object.
-     * @returns The updated object.
-     */
-    static patch(object, patches) {
-        return rfc6902.applyPatch(object, patches);
-    }
-}
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /* eslint-disable no-bitwise */
@@ -2423,6 +2353,149 @@ class Converter {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Helpers methods for JSON objects.
+ */
+class JsonHelper {
+    /**
+     * Serializes in canonical format.
+     * Based on https://www.rfc-editor.org/rfc/rfc8785.
+     * @param object The object to be serialized.
+     * @returns The serialized object.
+     */
+    static canonicalize(object) {
+        const buffer = [];
+        if (object === null ||
+            typeof object !== "object" ||
+            ("toJSON" in object && object.toJSON instanceof Function)) {
+            // Primitive data type
+            buffer.push(JSON.stringify(object));
+        }
+        else if (Array.isArray(object)) {
+            // Array maintain element order
+            const parts = [];
+            for (const element of object) {
+                if (element === undefined) {
+                    parts.push("null");
+                }
+                else {
+                    parts.push(JsonHelper.canonicalize(element));
+                }
+            }
+            buffer.push(`[${parts.join(",")}]`);
+        }
+        else {
+            // Object sort properties
+            const props = [];
+            const keys = Object.keys(object).sort();
+            const o = object;
+            for (const key of keys) {
+                if (o[key] !== undefined) {
+                    props.push(`${JSON.stringify(key)}:${JsonHelper.canonicalize(o[key])}`);
+                }
+            }
+            buffer.push(`{${props.join(",")}}`);
+        }
+        return buffer.join("");
+    }
+    /**
+     * Creates a RFC 6902 diff set.
+     * Based on https://www.rfc-editor.org/rfc/rfc6902.
+     * @param object1 The first object.
+     * @param object2 The second object.
+     * @returns The list of patches.
+     */
+    static diff(object1, object2) {
+        const operations = rfc6902.createPatch(object1, object2);
+        return operations;
+    }
+    /**
+     * Applies a RFC 6902 diff set to an object.
+     * Based on https://www.rfc-editor.org/rfc/rfc6902.
+     * @param object The object to patch.
+     * @param patches The second object.
+     * @returns The updated object.
+     */
+    static patch(object, patches) {
+        return rfc6902.applyPatch(object, patches);
+    }
+    /**
+     * Stringify the JSON with support for extended data types date/bigint/uint8array.
+     * @param object The object to stringify.
+     * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+     * @returns The stringified object.
+     */
+    static stringifyEx(object, space) {
+        // We want to keep the 'this' intact for the replacer
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        return JSON.stringify(object, JsonHelper.stringifyExReplacer, space);
+    }
+    /**
+     * Parse the JSON string with support for extended data types date/bigint/uint8array.
+     * @param json The object to pause.
+     * @returns The object.
+     */
+    static parseEx(json) {
+        // We want to keep the 'this' intact for the reviver
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        return JSON.parse(json, JsonHelper.parseExReviver);
+    }
+    /**
+     * Replacer function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static stringifyExReplacer(key, value) {
+        const rawValue = this[key];
+        if (Is.bigint(rawValue)) {
+            return {
+                "@ext": "bigint",
+                value: rawValue.toString()
+            };
+        }
+        else if (Is.date(rawValue)) {
+            return {
+                "@ext": "date",
+                value: rawValue.getTime()
+            };
+        }
+        else if (Is.uint8Array(rawValue)) {
+            return {
+                "@ext": "uint8array",
+                value: Converter.bytesToBase64(rawValue)
+            };
+        }
+        return value;
+    }
+    /**
+     * Reviver function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static parseExReviver(key, value) {
+        if (Is.object(value)) {
+            if (value["@ext"] === "bigint") {
+                return BigInt(value.value);
+            }
+            else if (value["@ext"] === "date") {
+                return new Date(value.value);
+            }
+            else if (value["@ext"] === "uint8array") {
+                return Converter.base64ToBytes(value.value);
+            }
+        }
+        return value;
+    }
+}
+
 /**
  * Class to help with objects.
  */
@@ -2954,6 +3027,55 @@ class ErrorHelper {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types the extracted data can be coerced to.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const CoerceType = {
+    /**
+     * String.
+     */
+    String: "string",
+    /**
+     * Number.
+     */
+    Number: "number",
+    /**
+     * Integer.
+     */
+    Integer: "integer",
+    /**
+     * Boolean.
+     */
+    Boolean: "boolean",
+    /**
+     * Big Integer.
+     */
+    BigInt: "bigint",
+    /**
+     * Date.
+     */
+    Date: "date",
+    /**
+     * Date Time.
+     */
+    DateTime: "datetime",
+    /**
+     * Time.
+     */
+    Time: "time",
+    /**
+     * Object.
+     */
+    Object: "object",
+    /**
+     * Uint8Array.
+     */
+    Uint8Array: "uint8array"
+};
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -3186,6 +3308,38 @@ class Coerce {
             }
         }
     }
+    /**
+     * Coerces a value based on the coercion type.
+     * @param value The value to coerce.
+     * @param type The coercion type to perform.
+     * @returns The coerced value.
+     */
+    static byType(value, type) {
+        switch (type) {
+            case CoerceType.String:
+                return Coerce.string(value);
+            case CoerceType.Number:
+                return Coerce.number(value);
+            case CoerceType.Integer:
+                return Coerce.integer(value);
+            case CoerceType.BigInt:
+                return Coerce.bigint(value);
+            case CoerceType.Boolean:
+                return Coerce.boolean(value);
+            case CoerceType.Date:
+                return Coerce.date(value);
+            case CoerceType.DateTime:
+                return Coerce.dateTime(value);
+            case CoerceType.Time:
+                return Coerce.time(value);
+            case CoerceType.Object:
+                return Coerce.object(value);
+            case CoerceType.Uint8Array:
+                return Coerce.uint8Array(value);
+            default:
+                return value;
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.
@@ -4600,6 +4754,7 @@ exports.Base64Url = Base64Url;
 exports.BaseError = BaseError;
 exports.BitString = BitString;
 exports.Coerce = Coerce;
+exports.CoerceType = CoerceType;
 exports.ComponentFactory = ComponentFactory;
 exports.Compression = Compression;
 exports.CompressionType = CompressionType;

package/dist/esm/index.mjs

@@ -2099,76 +2099,6 @@ class ArrayHelper {
     }
 }
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Helpers methods for JSON objects.
- */
-class JsonHelper {
-    /**
-     * Serializes in canonical format.
-     * Based on https://www.rfc-editor.org/rfc/rfc8785.
-     * @param object The object to be serialized.
-     * @returns The serialized object.
-     */
-    static canonicalize(object) {
-        const buffer = [];
-        if (object === null ||
-            typeof object !== "object" ||
-            ("toJSON" in object && object.toJSON instanceof Function)) {
-            // Primitive data type
-            buffer.push(JSON.stringify(object));
-        }
-        else if (Array.isArray(object)) {
-            // Array maintain element order
-            const parts = [];
-            for (const element of object) {
-                if (element === undefined) {
-                    parts.push("null");
-                }
-                else {
-                    parts.push(JsonHelper.canonicalize(element));
-                }
-            }
-            buffer.push(`[${parts.join(",")}]`);
-        }
-        else {
-            // Object sort properties
-            const props = [];
-            const keys = Object.keys(object).sort();
-            const o = object;
-            for (const key of keys) {
-                if (o[key] !== undefined) {
-                    props.push(`${JSON.stringify(key)}:${JsonHelper.canonicalize(o[key])}`);
-                }
-            }
-            buffer.push(`{${props.join(",")}}`);
-        }
-        return buffer.join("");
-    }
-    /**
-     * Creates a RFC 6902 diff set.
-     * Based on https://www.rfc-editor.org/rfc/rfc6902.
-     * @param object1 The first object.
-     * @param object2 The second object.
-     * @returns The list of patches.
-     */
-    static diff(object1, object2) {
-        const operations = createPatch(object1, object2);
-        return operations;
-    }
-    /**
-     * Applies a RFC 6902 diff set to an object.
-     * Based on https://www.rfc-editor.org/rfc/rfc6902.
-     * @param object The object to patch.
-     * @param patches The second object.
-     * @returns The updated object.
-     */
-    static patch(object, patches) {
-        return applyPatch(object, patches);
-    }
-}
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /* eslint-disable no-bitwise */
@@ -2421,6 +2351,149 @@ class Converter {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Helpers methods for JSON objects.
+ */
+class JsonHelper {
+    /**
+     * Serializes in canonical format.
+     * Based on https://www.rfc-editor.org/rfc/rfc8785.
+     * @param object The object to be serialized.
+     * @returns The serialized object.
+     */
+    static canonicalize(object) {
+        const buffer = [];
+        if (object === null ||
+            typeof object !== "object" ||
+            ("toJSON" in object && object.toJSON instanceof Function)) {
+            // Primitive data type
+            buffer.push(JSON.stringify(object));
+        }
+        else if (Array.isArray(object)) {
+            // Array maintain element order
+            const parts = [];
+            for (const element of object) {
+                if (element === undefined) {
+                    parts.push("null");
+                }
+                else {
+                    parts.push(JsonHelper.canonicalize(element));
+                }
+            }
+            buffer.push(`[${parts.join(",")}]`);
+        }
+        else {
+            // Object sort properties
+            const props = [];
+            const keys = Object.keys(object).sort();
+            const o = object;
+            for (const key of keys) {
+                if (o[key] !== undefined) {
+                    props.push(`${JSON.stringify(key)}:${JsonHelper.canonicalize(o[key])}`);
+                }
+            }
+            buffer.push(`{${props.join(",")}}`);
+        }
+        return buffer.join("");
+    }
+    /**
+     * Creates a RFC 6902 diff set.
+     * Based on https://www.rfc-editor.org/rfc/rfc6902.
+     * @param object1 The first object.
+     * @param object2 The second object.
+     * @returns The list of patches.
+     */
+    static diff(object1, object2) {
+        const operations = createPatch(object1, object2);
+        return operations;
+    }
+    /**
+     * Applies a RFC 6902 diff set to an object.
+     * Based on https://www.rfc-editor.org/rfc/rfc6902.
+     * @param object The object to patch.
+     * @param patches The second object.
+     * @returns The updated object.
+     */
+    static patch(object, patches) {
+        return applyPatch(object, patches);
+    }
+    /**
+     * Stringify the JSON with support for extended data types date/bigint/uint8array.
+     * @param object The object to stringify.
+     * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+     * @returns The stringified object.
+     */
+    static stringifyEx(object, space) {
+        // We want to keep the 'this' intact for the replacer
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        return JSON.stringify(object, JsonHelper.stringifyExReplacer, space);
+    }
+    /**
+     * Parse the JSON string with support for extended data types date/bigint/uint8array.
+     * @param json The object to pause.
+     * @returns The object.
+     */
+    static parseEx(json) {
+        // We want to keep the 'this' intact for the reviver
+        // eslint-disable-next-line @typescript-eslint/unbound-method
+        return JSON.parse(json, JsonHelper.parseExReviver);
+    }
+    /**
+     * Replacer function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static stringifyExReplacer(key, value) {
+        const rawValue = this[key];
+        if (Is.bigint(rawValue)) {
+            return {
+                "@ext": "bigint",
+                value: rawValue.toString()
+            };
+        }
+        else if (Is.date(rawValue)) {
+            return {
+                "@ext": "date",
+                value: rawValue.getTime()
+            };
+        }
+        else if (Is.uint8Array(rawValue)) {
+            return {
+                "@ext": "uint8array",
+                value: Converter.bytesToBase64(rawValue)
+            };
+        }
+        return value;
+    }
+    /**
+     * Reviver function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static parseExReviver(key, value) {
+        if (Is.object(value)) {
+            if (value["@ext"] === "bigint") {
+                return BigInt(value.value);
+            }
+            else if (value["@ext"] === "date") {
+                return new Date(value.value);
+            }
+            else if (value["@ext"] === "uint8array") {
+                return Converter.base64ToBytes(value.value);
+            }
+        }
+        return value;
+    }
+}
+
 /**
  * Class to help with objects.
  */
@@ -2952,6 +3025,55 @@ class ErrorHelper {
     }
 }
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types the extracted data can be coerced to.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const CoerceType = {
+    /**
+     * String.
+     */
+    String: "string",
+    /**
+     * Number.
+     */
+    Number: "number",
+    /**
+     * Integer.
+     */
+    Integer: "integer",
+    /**
+     * Boolean.
+     */
+    Boolean: "boolean",
+    /**
+     * Big Integer.
+     */
+    BigInt: "bigint",
+    /**
+     * Date.
+     */
+    Date: "date",
+    /**
+     * Date Time.
+     */
+    DateTime: "datetime",
+    /**
+     * Time.
+     */
+    Time: "time",
+    /**
+     * Object.
+     */
+    Object: "object",
+    /**
+     * Uint8Array.
+     */
+    Uint8Array: "uint8array"
+};
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -3184,6 +3306,38 @@ class Coerce {
             }
         }
     }
+    /**
+     * Coerces a value based on the coercion type.
+     * @param value The value to coerce.
+     * @param type The coercion type to perform.
+     * @returns The coerced value.
+     */
+    static byType(value, type) {
+        switch (type) {
+            case CoerceType.String:
+                return Coerce.string(value);
+            case CoerceType.Number:
+                return Coerce.number(value);
+            case CoerceType.Integer:
+                return Coerce.integer(value);
+            case CoerceType.BigInt:
+                return Coerce.bigint(value);
+            case CoerceType.Boolean:
+                return Coerce.boolean(value);
+            case CoerceType.Date:
+                return Coerce.date(value);
+            case CoerceType.DateTime:
+                return Coerce.dateTime(value);
+            case CoerceType.Time:
+                return Coerce.time(value);
+            case CoerceType.Object:
+                return Coerce.object(value);
+            case CoerceType.Uint8Array:
+                return Coerce.uint8Array(value);
+            default:
+                return value;
+        }
+    }
 }
 
 // Copyright 2024 IOTA Stiftung.
@@ -4588,4 +4742,4 @@ class Validation {
     }
 }
 
-export { AlreadyExistsError, ArrayHelper, AsyncCache, Base32, Base58, Base64, Base64Url, BaseError, BitString, Coerce, ComponentFactory, Compression, CompressionType, ConflictError, Converter, EnvHelper, ErrorHelper, Factory, FilenameHelper, GeneralError, GuardError, Guards, HexHelper, I18n, Is, JsonHelper, NotFoundError, NotImplementedError, NotSupportedError, ObjectHelper, RandomHelper, StringHelper, UnauthorizedError, UnprocessableError, Url, Urn, Validation, ValidationError };
+export { AlreadyExistsError, ArrayHelper, AsyncCache, Base32, Base58, Base64, Base64Url, BaseError, BitString, Coerce, CoerceType, ComponentFactory, Compression, CompressionType, ConflictError, Converter, EnvHelper, ErrorHelper, Factory, FilenameHelper, GeneralError, GuardError, Guards, HexHelper, I18n, Is, JsonHelper, NotFoundError, NotImplementedError, NotSupportedError, ObjectHelper, RandomHelper, StringHelper, UnauthorizedError, UnprocessableError, Url, Urn, Validation, ValidationError };

package/dist/types/helpers/jsonHelper.d.ts

@@ -26,4 +26,33 @@ export declare class JsonHelper {
      * @returns The updated object.
      */
     static patch<T = unknown>(object: T, patches: IPatchOperation[]): T;
+    /**
+     * Stringify the JSON with support for extended data types date/bigint/uint8array.
+     * @param object The object to stringify.
+     * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+     * @returns The stringified object.
+     */
+    static stringifyEx(object: unknown, space?: string | number): string;
+    /**
+     * Parse the JSON string with support for extended data types date/bigint/uint8array.
+     * @param json The object to pause.
+     * @returns The object.
+     */
+    static parseEx(json: string): unknown;
+    /**
+     * Replacer function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    static stringifyExReplacer(this: any, key: string, value: unknown): unknown;
+    /**
+     * Reviver function to handle extended data types.
+     * @param this The object.
+     * @param key The key.
+     * @param value The value.
+     * @returns The value.
+     */
+    static parseExReviver(this: any, key: string, value: unknown): unknown;
 }

package/dist/types/index.d.ts

@@ -24,6 +24,7 @@ export * from "./helpers/jsonHelper";
 export * from "./helpers/objectHelper";
 export * from "./helpers/randomHelper";
 export * from "./helpers/stringHelper";
+export * from "./models/coerceType";
 export * from "./models/compressionType";
 export * from "./models/IComponent";
 export * from "./models/IError";

package/dist/types/models/coerceType.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The types the extracted data can be coerced to.
+ */
+export declare const CoerceType: {
+    /**
+     * String.
+     */
+    readonly String: "string";
+    /**
+     * Number.
+     */
+    readonly Number: "number";
+    /**
+     * Integer.
+     */
+    readonly Integer: "integer";
+    /**
+     * Boolean.
+     */
+    readonly Boolean: "boolean";
+    /**
+     * Big Integer.
+     */
+    readonly BigInt: "bigint";
+    /**
+     * Date.
+     */
+    readonly Date: "date";
+    /**
+     * Date Time.
+     */
+    readonly DateTime: "datetime";
+    /**
+     * Time.
+     */
+    readonly Time: "time";
+    /**
+     * Object.
+     */
+    readonly Object: "object";
+    /**
+     * Uint8Array.
+     */
+    readonly Uint8Array: "uint8array";
+};
+/**
+ * The types the extracted data can be coerced to.
+ */
+export type CoerceType = (typeof CoerceType)[keyof typeof CoerceType];

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

@@ -1,3 +1,4 @@
+import { CoerceType } from "../models/coerceType";
 /**
  * Coerce an object from one type to another.
  */
@@ -72,4 +73,11 @@ export declare class Coerce {
      * @returns The value if it can be coerced.
      */
     static uint8Array(value: unknown): Uint8Array | undefined;
+    /**
+     * Coerces a value based on the coercion type.
+     * @param value The value to coerce.
+     * @param type The coercion type to perform.
+     * @returns The coerced value.
+     */
+    static byType(value: unknown, type?: CoerceType): unknown;
 }

package/docs/changelog.md

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

package/docs/reference/classes/Coerce.md

@@ -275,3 +275,31 @@ The value if it can be coerced.
 #### Throws
 
 TypeError If the value can not be coerced.
+
+***
+
+### byType()
+
+> `static` **byType**(`value`, `type`?): `unknown`
+
+Coerces a value based on the coercion type.
+
+#### Parameters
+
+##### value
+
+`unknown`
+
+The value to coerce.
+
+##### type?
+
+[`CoerceType`](../type-aliases/CoerceType.md)
+
+The coercion type to perform.
+
+#### Returns
+
+`unknown`
+
+The coerced value.

package/docs/reference/classes/JsonHelper.md

@@ -100,3 +100,121 @@ The second object.
 `T`
 
 The updated object.
+
+***
+
+### stringifyEx()
+
+> `static` **stringifyEx**(`object`, `space`?): `string`
+
+Stringify the JSON with support for extended data types date/bigint/uint8array.
+
+#### Parameters
+
+##### object
+
+`unknown`
+
+The object to stringify.
+
+##### space?
+
+Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.
+
+`string` | `number`
+
+#### Returns
+
+`string`
+
+The stringified object.
+
+***
+
+### parseEx()
+
+> `static` **parseEx**(`json`): `unknown`
+
+Parse the JSON string with support for extended data types date/bigint/uint8array.
+
+#### Parameters
+
+##### json
+
+`string`
+
+The object to pause.
+
+#### Returns
+
+`unknown`
+
+The object.
+
+***
+
+### stringifyExReplacer()
+
+> `static` **stringifyExReplacer**(`this`, `key`, `value`): `unknown`
+
+Replacer function to handle extended data types.
+
+#### Parameters
+
+##### this
+
+`any`
+
+The object.
+
+##### key
+
+`string`
+
+The key.
+
+##### value
+
+`unknown`
+
+The value.
+
+#### Returns
+
+`unknown`
+
+The value.
+
+***
+
+### parseExReviver()
+
+> `static` **parseExReviver**(`this`, `key`, `value`): `unknown`
+
+Reviver function to handle extended data types.
+
+#### Parameters
+
+##### this
+
+`any`
+
+The object.
+
+##### key
+
+`string`
+
+The key.
+
+##### value
+
+`unknown`
+
+The value.
+
+#### Returns
+
+`unknown`
+
+The value.

package/docs/reference/index.md

@@ -54,9 +54,11 @@
 
 ## Type Aliases
 
+- [CoerceType](type-aliases/CoerceType.md)
 - [CompressionType](type-aliases/CompressionType.md)
 
 ## Variables
 
 - [ComponentFactory](variables/ComponentFactory.md)
+- [CoerceType](variables/CoerceType.md)
 - [CompressionType](variables/CompressionType.md)

package/docs/reference/type-aliases/CoerceType.md

@@ -0,0 +1,5 @@
+# Type Alias: CoerceType
+
+> **CoerceType**: *typeof* [`CoerceType`](../variables/CoerceType.md)\[keyof *typeof* [`CoerceType`](../variables/CoerceType.md)\]
+
+The types the extracted data can be coerced to.

package/docs/reference/variables/CoerceType.md

@@ -0,0 +1,67 @@
+# Variable: CoerceType
+
+> `const` **CoerceType**: `object`
+
+The types the extracted data can be coerced to.
+
+## Type declaration
+
+### String
+
+> `readonly` **String**: `"string"` = `"string"`
+
+String.
+
+### Number
+
+> `readonly` **Number**: `"number"` = `"number"`
+
+Number.
+
+### Integer
+
+> `readonly` **Integer**: `"integer"` = `"integer"`
+
+Integer.
+
+### Boolean
+
+> `readonly` **Boolean**: `"boolean"` = `"boolean"`
+
+Boolean.
+
+### BigInt
+
+> `readonly` **BigInt**: `"bigint"` = `"bigint"`
+
+Big Integer.
+
+### Date
+
+> `readonly` **Date**: `"date"` = `"date"`
+
+Date.
+
+### DateTime
+
+> `readonly` **DateTime**: `"datetime"` = `"datetime"`
+
+Date Time.
+
+### Time
+
+> `readonly` **Time**: `"time"` = `"time"`
+
+Time.
+
+### Object
+
+> `readonly` **Object**: `"object"` = `"object"`
+
+Object.
+
+### Uint8Array
+
+> `readonly` **Uint8Array**: `"uint8array"` = `"uint8array"`
+
+Uint8Array.

package/package.json

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