@twin.org/core 0.0.1-next.48 → 0.0.1-next.49

package/dist/cjs/index.cjs

@@ -2353,12 +2353,15 @@ class Converter {
     }
 }
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 /**
  * Helpers methods for JSON objects.
  */
 class JsonHelper {
+    /**
+     * Runtime name for the class.
+     * @internal
+     */
+    static _CLASS_NAME = "JsonHelper";
     /**
      * Serializes in canonical format.
      * Based on https://www.rfc-editor.org/rfc/rfc8785.
@@ -2417,9 +2420,17 @@ class JsonHelper {
      * @param object The object to patch.
      * @param patches The second object.
      * @returns The updated object.
+     * @throws GeneralError if the patch fails.
      */
     static patch(object, patches) {
-        return rfc6902.applyPatch(object, patches);
+        const clone = ObjectHelper.clone(object);
+        const result = rfc6902.applyPatch(clone, patches);
+        for (let i = 0; i < result.length; i++) {
+            if (!Is.empty(result[i])) {
+                throw new GeneralError(JsonHelper._CLASS_NAME, "failedPatch", { index: i }, result[i]);
+            }
+        }
+        return clone;
     }
     /**
      * Stringify the JSON with support for extended data types date/bigint/uint8array.

package/dist/esm/index.mjs

@@ -2351,12 +2351,15 @@ class Converter {
     }
 }
 
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
 /**
  * Helpers methods for JSON objects.
  */
 class JsonHelper {
+    /**
+     * Runtime name for the class.
+     * @internal
+     */
+    static _CLASS_NAME = "JsonHelper";
     /**
      * Serializes in canonical format.
      * Based on https://www.rfc-editor.org/rfc/rfc8785.
@@ -2415,9 +2418,17 @@ class JsonHelper {
      * @param object The object to patch.
      * @param patches The second object.
      * @returns The updated object.
+     * @throws GeneralError if the patch fails.
      */
     static patch(object, patches) {
-        return applyPatch(object, patches);
+        const clone = ObjectHelper.clone(object);
+        const result = applyPatch(clone, patches);
+        for (let i = 0; i < result.length; i++) {
+            if (!Is.empty(result[i])) {
+                throw new GeneralError(JsonHelper._CLASS_NAME, "failedPatch", { index: i }, result[i]);
+            }
+        }
+        return clone;
     }
     /**
      * Stringify the JSON with support for extended data types date/bigint/uint8array.

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

@@ -24,6 +24,7 @@ export declare class JsonHelper {
      * @param object The object to patch.
      * @param patches The second object.
      * @returns The updated object.
+     * @throws GeneralError if the patch fails.
      */
     static patch<T = unknown>(object: T, patches: IPatchOperation[]): T;
     /**

package/docs/changelog.md

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

package/docs/reference/classes/JsonHelper.md

@@ -101,6 +101,10 @@ The second object.
 
 The updated object.
 
+#### Throws
+
+GeneralError if the patch fails.
+
 ***
 
 ### stringifyEx()

package/locales/en.json

@@ -95,6 +95,9 @@
 		},
 		"base58": {
 			"invalidCharacter": "Data contains a character \"{invalidCharacter}\" which is not in the charset"
+		},
+		"jsonHelper": {
+			"failedPatch": "Failed to patch the JSON object, patch index \"{index}\" failed"
 		}
 	},
 	"errorNames": {

package/package.json

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