@metamask/snap-networks-utils 1.0.0 → 2.0.0

package/dist/utils/sanitize/sanitize.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.cjs","sourceRoot":"","sources":["../../../src/utils/sanitize/sanitize.ts"],"names":[],"mappings":";;AAMA,8DAQC;AAQD,kCAiBC;AAvCD;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,KAAa;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,4CAA4C;IAC5C,4CAA4C;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACxE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["/**\n * Removes control characters from a string.\n *\n * @param input - The string to sanitize.\n * @returns The sanitized string.\n */\nexport function sanitizeControlCharacters(input: string): string {\n  if (!input || typeof input !== 'string') {\n    return '';\n  }\n\n  // Remove all control characters except tab.\n  // eslint-disable-next-line no-control-regex\n  return input.replace(/[\\u0000-\\u0008\\u000A-\\u001F\\u007F]/gu, '');\n}\n\n/**\n * Validates and sanitizes a URI.\n *\n * @param uri - The URI to validate and sanitize.\n * @returns The sanitized URI or an empty string if invalid.\n */\nexport function sanitizeUri(uri: string): string {\n  if (!uri || typeof uri !== 'string') {\n    return '';\n  }\n\n  const sanitized = sanitizeControlCharacters(uri);\n\n  try {\n    const url = new URL(sanitized);\n    const allowedProtocols = ['http:', 'https:', 'wss:', 'ipfs:'];\n    if (!allowedProtocols.includes(url.protocol) || sanitized.length > 2048) {\n      return '';\n    }\n    return sanitized;\n  } catch {\n    return '';\n  }\n}\n"]}

package/dist/utils/sanitize/sanitize.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Removes control characters from a string.
+ *
+ * @param input - The string to sanitize.
+ * @returns The sanitized string.
+ */
+export declare function sanitizeControlCharacters(input: string): string;
+/**
+ * Validates and sanitizes a URI.
+ *
+ * @param uri - The URI to validate and sanitize.
+ * @returns The sanitized URI or an empty string if invalid.
+ */
+export declare function sanitizeUri(uri: string): string;
+//# sourceMappingURL=sanitize.d.cts.map

package/dist/utils/sanitize/sanitize.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.cts","sourceRoot":"","sources":["../../../src/utils/sanitize/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB/C"}

package/dist/utils/sanitize/sanitize.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Removes control characters from a string.
+ *
+ * @param input - The string to sanitize.
+ * @returns The sanitized string.
+ */
+export declare function sanitizeControlCharacters(input: string): string;
+/**
+ * Validates and sanitizes a URI.
+ *
+ * @param uri - The URI to validate and sanitize.
+ * @returns The sanitized URI or an empty string if invalid.
+ */
+export declare function sanitizeUri(uri: string): string;
+//# sourceMappingURL=sanitize.d.mts.map

package/dist/utils/sanitize/sanitize.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.mts","sourceRoot":"","sources":["../../../src/utils/sanitize/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB/C"}

package/dist/utils/sanitize/sanitize.mjs

@@ -0,0 +1,38 @@
+/**
+ * Removes control characters from a string.
+ *
+ * @param input - The string to sanitize.
+ * @returns The sanitized string.
+ */
+export function sanitizeControlCharacters(input) {
+    if (!input || typeof input !== 'string') {
+        return '';
+    }
+    // Remove all control characters except tab.
+    // eslint-disable-next-line no-control-regex
+    return input.replace(/[\u0000-\u0008\u000A-\u001F\u007F]/gu, '');
+}
+/**
+ * Validates and sanitizes a URI.
+ *
+ * @param uri - The URI to validate and sanitize.
+ * @returns The sanitized URI or an empty string if invalid.
+ */
+export function sanitizeUri(uri) {
+    if (!uri || typeof uri !== 'string') {
+        return '';
+    }
+    const sanitized = sanitizeControlCharacters(uri);
+    try {
+        const url = new URL(sanitized);
+        const allowedProtocols = ['http:', 'https:', 'wss:', 'ipfs:'];
+        if (!allowedProtocols.includes(url.protocol) || sanitized.length > 2048) {
+            return '';
+        }
+        return sanitized;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=sanitize.mjs.map

package/dist/utils/sanitize/sanitize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.mjs","sourceRoot":"","sources":["../../../src/utils/sanitize/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,4CAA4C;IAC5C,4CAA4C;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACxE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC","sourcesContent":["/**\n * Removes control characters from a string.\n *\n * @param input - The string to sanitize.\n * @returns The sanitized string.\n */\nexport function sanitizeControlCharacters(input: string): string {\n  if (!input || typeof input !== 'string') {\n    return '';\n  }\n\n  // Remove all control characters except tab.\n  // eslint-disable-next-line no-control-regex\n  return input.replace(/[\\u0000-\\u0008\\u000A-\\u001F\\u007F]/gu, '');\n}\n\n/**\n * Validates and sanitizes a URI.\n *\n * @param uri - The URI to validate and sanitize.\n * @returns The sanitized URI or an empty string if invalid.\n */\nexport function sanitizeUri(uri: string): string {\n  if (!uri || typeof uri !== 'string') {\n    return '';\n  }\n\n  const sanitized = sanitizeControlCharacters(uri);\n\n  try {\n    const url = new URL(sanitized);\n    const allowedProtocols = ['http:', 'https:', 'wss:', 'ipfs:'];\n    if (!allowedProtocols.includes(url.protocol) || sanitized.length > 2048) {\n      return '';\n    }\n    return sanitized;\n  } catch {\n    return '';\n  }\n}\n"]}

package/dist/utils/serialization/serialization.cjs

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserialize = exports.serialize = void 0;
+const bignumber_js_1 = require("bignumber.js");
+const lodash_1 = require("lodash");
+/**
+ * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.
+ * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.
+ *
+ * @param value - The value to serialize.
+ * @returns The serialized value.
+ */
+const serialize = (value) => (0, lodash_1.cloneDeepWith)(value, (val) => {
+    if (val === undefined) {
+        return {
+            __type: 'undefined',
+        };
+    }
+    if (val instanceof bignumber_js_1.BigNumber) {
+        return {
+            __type: 'BigNumber',
+            value: val.toString(),
+        };
+    }
+    if (typeof val === 'bigint') {
+        return {
+            __type: 'bigint',
+            value: val.toString(),
+        };
+    }
+    if (val instanceof Uint8Array) {
+        const binaryString = Array.from(val, (byte) => String.fromCharCode(byte)).join('');
+        return {
+            __type: 'Uint8Array',
+            value: btoa(binaryString),
+        };
+    }
+    // Return undefined to let lodash handle the cloning of other values
+    return undefined;
+});
+exports.serialize = serialize;
+/**
+ * Deserializes the passed value from a JSON object back to its original values.
+ * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.
+ *
+ * @param serializedValue - The value to deserialize.
+ * @returns The deserialized value.
+ */
+const deserialize = (serializedValue) => JSON.parse(JSON.stringify(serializedValue), (_key, value) => {
+    if (!value) {
+        return value;
+    }
+    if (value.__type === 'undefined') {
+        return undefined;
+    }
+    if (value.__type === 'BigNumber') {
+        return new bignumber_js_1.BigNumber(value.value);
+    }
+    if (value.__type === 'bigint') {
+        return BigInt(value.value);
+    }
+    if (value.__type === 'Uint8Array') {
+        const binaryString = atob(value.value);
+        const bytes = new Uint8Array(binaryString.length);
+        for (let index = 0; index < binaryString.length; index++) {
+            bytes[index] = binaryString.charCodeAt(index);
+        }
+        return bytes;
+    }
+    return value;
+});
+exports.deserialize = deserialize;
+//# sourceMappingURL=serialization.cjs.map

package/dist/utils/serialization/serialization.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.cjs","sourceRoot":"","sources":["../../../src/utils/serialization/serialization.ts"],"names":[],"mappings":";;;AACA,+CAAyC;AACzC,mCAAuC;AAIvC;;;;;;GAMG;AACI,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAQ,EAAE,CACrD,IAAA,sBAAa,EAAC,KAAK,EAAE,CAAC,GAAY,EAAE,EAAE;IACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,YAAY,wBAAS,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAC1B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC,CAAC;AAlCQ,QAAA,SAAS,aAkCjB;AAEL;;;;;;GAMG;AACI,MAAM,WAAW,GAAG,CAAC,eAAqB,EAAgB,EAAE,CACjE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,wBAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACzD,KAAK,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,CAAC;AA5BQ,QAAA,WAAW,eA4BnB","sourcesContent":["import type { Json } from '@metamask/snaps-sdk';\nimport { BigNumber } from 'bignumber.js';\nimport { cloneDeepWith } from 'lodash';\n\nimport type { Serializable } from './types';\n\n/**\n * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.\n * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.\n *\n * @param value - The value to serialize.\n * @returns The serialized value.\n */\nexport const serialize = (value: Serializable): Json =>\n  cloneDeepWith(value, (val: unknown) => {\n    if (val === undefined) {\n      return {\n        __type: 'undefined',\n      };\n    }\n\n    if (val instanceof BigNumber) {\n      return {\n        __type: 'BigNumber',\n        value: val.toString(),\n      };\n    }\n\n    if (typeof val === 'bigint') {\n      return {\n        __type: 'bigint',\n        value: val.toString(),\n      };\n    }\n\n    if (val instanceof Uint8Array) {\n      const binaryString = Array.from(val, (byte) =>\n        String.fromCharCode(byte),\n      ).join('');\n      return {\n        __type: 'Uint8Array',\n        value: btoa(binaryString),\n      };\n    }\n\n    // Return undefined to let lodash handle the cloning of other values\n    return undefined;\n  });\n\n/**\n * Deserializes the passed value from a JSON object back to its original values.\n * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.\n *\n * @param serializedValue - The value to deserialize.\n * @returns The deserialized value.\n */\nexport const deserialize = (serializedValue: Json): Serializable =>\n  JSON.parse(JSON.stringify(serializedValue), (_key, value) => {\n    if (!value) {\n      return value;\n    }\n\n    if (value.__type === 'undefined') {\n      return undefined;\n    }\n\n    if (value.__type === 'BigNumber') {\n      return new BigNumber(value.value);\n    }\n\n    if (value.__type === 'bigint') {\n      return BigInt(value.value);\n    }\n\n    if (value.__type === 'Uint8Array') {\n      const binaryString = atob(value.value);\n      const bytes = new Uint8Array(binaryString.length);\n      for (let index = 0; index < binaryString.length; index++) {\n        bytes[index] = binaryString.charCodeAt(index);\n      }\n      return bytes;\n    }\n\n    return value;\n  });\n"]}

package/dist/utils/serialization/serialization.d.cts

@@ -0,0 +1,19 @@
+import type { Json } from "@metamask/snaps-sdk";
+import type { Serializable } from "./types.cjs";
+/**
+ * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.
+ * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.
+ *
+ * @param value - The value to serialize.
+ * @returns The serialized value.
+ */
+export declare const serialize: (value: Serializable) => Json;
+/**
+ * Deserializes the passed value from a JSON object back to its original values.
+ * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.
+ *
+ * @param serializedValue - The value to deserialize.
+ * @returns The deserialized value.
+ */
+export declare const deserialize: (serializedValue: Json) => Serializable;
+//# sourceMappingURL=serialization.d.cts.map

package/dist/utils/serialization/serialization.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.cts","sourceRoot":"","sources":["../../../src/utils/serialization/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,4BAA4B;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAgB;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,KAAG,IAkC5C,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,iBAAiB,IAAI,KAAG,YA4BhD,CAAC"}

package/dist/utils/serialization/serialization.d.mts

@@ -0,0 +1,19 @@
+import type { Json } from "@metamask/snaps-sdk";
+import type { Serializable } from "./types.mjs";
+/**
+ * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.
+ * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.
+ *
+ * @param value - The value to serialize.
+ * @returns The serialized value.
+ */
+export declare const serialize: (value: Serializable) => Json;
+/**
+ * Deserializes the passed value from a JSON object back to its original values.
+ * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.
+ *
+ * @param serializedValue - The value to deserialize.
+ * @returns The deserialized value.
+ */
+export declare const deserialize: (serializedValue: Json) => Serializable;
+//# sourceMappingURL=serialization.d.mts.map

package/dist/utils/serialization/serialization.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.mts","sourceRoot":"","sources":["../../../src/utils/serialization/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,4BAA4B;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAgB;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,YAAY,KAAG,IAkC5C,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,iBAAiB,IAAI,KAAG,YA4BhD,CAAC"}

package/dist/utils/serialization/serialization.mjs

@@ -0,0 +1,69 @@
+import { BigNumber } from "bignumber.js";
+import $lodash from "lodash";
+const { cloneDeepWith } = $lodash;
+/**
+ * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.
+ * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.
+ *
+ * @param value - The value to serialize.
+ * @returns The serialized value.
+ */
+export const serialize = (value) => cloneDeepWith(value, (val) => {
+    if (val === undefined) {
+        return {
+            __type: 'undefined',
+        };
+    }
+    if (val instanceof BigNumber) {
+        return {
+            __type: 'BigNumber',
+            value: val.toString(),
+        };
+    }
+    if (typeof val === 'bigint') {
+        return {
+            __type: 'bigint',
+            value: val.toString(),
+        };
+    }
+    if (val instanceof Uint8Array) {
+        const binaryString = Array.from(val, (byte) => String.fromCharCode(byte)).join('');
+        return {
+            __type: 'Uint8Array',
+            value: btoa(binaryString),
+        };
+    }
+    // Return undefined to let lodash handle the cloning of other values
+    return undefined;
+});
+/**
+ * Deserializes the passed value from a JSON object back to its original values.
+ * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.
+ *
+ * @param serializedValue - The value to deserialize.
+ * @returns The deserialized value.
+ */
+export const deserialize = (serializedValue) => JSON.parse(JSON.stringify(serializedValue), (_key, value) => {
+    if (!value) {
+        return value;
+    }
+    if (value.__type === 'undefined') {
+        return undefined;
+    }
+    if (value.__type === 'BigNumber') {
+        return new BigNumber(value.value);
+    }
+    if (value.__type === 'bigint') {
+        return BigInt(value.value);
+    }
+    if (value.__type === 'Uint8Array') {
+        const binaryString = atob(value.value);
+        const bytes = new Uint8Array(binaryString.length);
+        for (let index = 0; index < binaryString.length; index++) {
+            bytes[index] = binaryString.charCodeAt(index);
+        }
+        return bytes;
+    }
+    return value;
+});
+//# sourceMappingURL=serialization.mjs.map

package/dist/utils/serialization/serialization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.mjs","sourceRoot":"","sources":["../../../src/utils/serialization/serialization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,qBAAqB;;;AAKzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAQ,EAAE,CACrD,aAAa,CAAC,KAAK,EAAE,CAAC,GAAY,EAAE,EAAE;IACpC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAC1B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC,CAAC;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,eAAqB,EAAgB,EAAE,CACjE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACzD,KAAK,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,CAAC","sourcesContent":["import type { Json } from '@metamask/snaps-sdk';\nimport { BigNumber } from 'bignumber.js';\nimport { cloneDeepWith } from 'lodash';\n\nimport type { Serializable } from './types';\n\n/**\n * Serializes the passed value to a JSON object so it can be stored in JSON-serializable storage like the snap state and interface context.\n * It transforms non-JSON-serializable values into a specific JSON-serializable representation that can be deserialized later.\n *\n * @param value - The value to serialize.\n * @returns The serialized value.\n */\nexport const serialize = (value: Serializable): Json =>\n  cloneDeepWith(value, (val: unknown) => {\n    if (val === undefined) {\n      return {\n        __type: 'undefined',\n      };\n    }\n\n    if (val instanceof BigNumber) {\n      return {\n        __type: 'BigNumber',\n        value: val.toString(),\n      };\n    }\n\n    if (typeof val === 'bigint') {\n      return {\n        __type: 'bigint',\n        value: val.toString(),\n      };\n    }\n\n    if (val instanceof Uint8Array) {\n      const binaryString = Array.from(val, (byte) =>\n        String.fromCharCode(byte),\n      ).join('');\n      return {\n        __type: 'Uint8Array',\n        value: btoa(binaryString),\n      };\n    }\n\n    // Return undefined to let lodash handle the cloning of other values\n    return undefined;\n  });\n\n/**\n * Deserializes the passed value from a JSON object back to its original values.\n * It transforms the JSON-serializable representation of non-JSON-serializable values back into their original values.\n *\n * @param serializedValue - The value to deserialize.\n * @returns The deserialized value.\n */\nexport const deserialize = (serializedValue: Json): Serializable =>\n  JSON.parse(JSON.stringify(serializedValue), (_key, value) => {\n    if (!value) {\n      return value;\n    }\n\n    if (value.__type === 'undefined') {\n      return undefined;\n    }\n\n    if (value.__type === 'BigNumber') {\n      return new BigNumber(value.value);\n    }\n\n    if (value.__type === 'bigint') {\n      return BigInt(value.value);\n    }\n\n    if (value.__type === 'Uint8Array') {\n      const binaryString = atob(value.value);\n      const bytes = new Uint8Array(binaryString.length);\n      for (let index = 0; index < binaryString.length; index++) {\n        bytes[index] = binaryString.charCodeAt(index);\n      }\n      return bytes;\n    }\n\n    return value;\n  });\n"]}

package/dist/utils/serialization/types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.cjs.map

package/dist/utils/serialization/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sourceRoot":"","sources":["../../../src/utils/serialization/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/snaps-sdk';\nimport type { BigNumber } from 'bignumber.js';\n\n/**\n * A primitive value that can be serialized to JSON using the `serialize` function.\n */\nexport type Serializable =\n  | Json\n  | undefined\n  | null\n  | bigint\n  | BigNumber\n  | Uint8Array\n  | Serializable[]\n  | {\n      [prop: string]: Serializable;\n    };\n"]}

package/dist/utils/serialization/types.d.cts

@@ -0,0 +1,8 @@
+import type { Json } from "@metamask/snaps-sdk";
+/**
+ * A primitive value that can be serialized to JSON using the `serialize` function.
+ */
+export type Serializable = Json | undefined | null | bigint | BigNumber | Uint8Array | Serializable[] | {
+    [prop: string]: Serializable;
+};
+//# sourceMappingURL=types.d.cts.map

package/dist/utils/serialization/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../../src/utils/serialization/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,4BAA4B;AAGhD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,MAAM,GACN,SAAS,GACT,UAAU,GACV,YAAY,EAAE,GACd;IACE,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B,CAAC"}

package/dist/utils/serialization/types.d.mts

@@ -0,0 +1,8 @@
+import type { Json } from "@metamask/snaps-sdk";
+/**
+ * A primitive value that can be serialized to JSON using the `serialize` function.
+ */
+export type Serializable = Json | undefined | null | bigint | BigNumber | Uint8Array | Serializable[] | {
+    [prop: string]: Serializable;
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/utils/serialization/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../../src/utils/serialization/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,4BAA4B;AAGhD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,MAAM,GACN,SAAS,GACT,UAAU,GACV,YAAY,EAAE,GACd;IACE,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9B,CAAC"}

package/dist/utils/serialization/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/utils/serialization/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../../src/utils/serialization/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/snaps-sdk';\nimport type { BigNumber } from 'bignumber.js';\n\n/**\n * A primitive value that can be serialized to JSON using the `serialize` function.\n */\nexport type Serializable =\n  | Json\n  | undefined\n  | null\n  | bigint\n  | BigNumber\n  | Uint8Array\n  | Serializable[]\n  | {\n      [prop: string]: Serializable;\n    };\n"]}

package/dist/utils/state/IStateManager.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IStateManager.cjs.map

package/dist/utils/state/IStateManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStateManager.cjs","sourceRoot":"","sources":["../../../src/utils/state/IStateManager.ts"],"names":[],"mappings":"","sourcesContent":["import type { Serializable } from '../serialization/types';\n\nexport type IStateManager<TStateValue extends Record<string, Serializable>> = {\n  /**\n   * Gets the whole state object.\n   *\n   * ⚠️ WARNING: Use with caution because it transfers the whole state, which might contain a lot of data.\n   * If you need to retrieve only a specific part of the state, use IStateManager.getKey instead.\n   */\n  get(): Promise<TStateValue>;\n  /**\n   * Gets the value of the passed key in the state object.\n   * The key is the JSON path to the value to get.\n   *\n   * @returns The value of the key, or undefined if the key does not exist.\n   */\n  getKey<TResponse extends Serializable>(\n    key: string,\n  ): Promise<TResponse | undefined>;\n  /**\n   * Sets the value of the passed key in the state object.\n   * The key is a JSON path to the value to set.\n   *\n   * @param key - The key to set, which is a JSON path to the location.\n   * @param value - The value to set.\n   */\n  setKey(key: string, value: Serializable): Promise<void>;\n  /**\n   * Atomically reads the current value at `key`, applies `updater`, and writes the result back.\n   *\n   * Implementations must ensure that no concurrent state write can interleave between the\n   * read and the write. This makes the method safe for updates where the next value depends\n   * on the current value, such as merging objects.\n   *\n   * Prefer this over a manual `getKey` + `setKey` sequence whenever the new value depends on\n   * the current one.\n   *\n   * @param key - The JSON-path key to update.\n   * @param updater - Receives the current value (or `undefined` when the key is absent) and\n   * returns the new value to store.\n   */\n  setKeyWith<TValue extends Serializable>(\n    key: string,\n    updater: (currentValue: TValue | undefined) => TValue,\n  ): Promise<void>;\n  /**\n   * Updates the whole state object.\n   *\n   * Typically used for bulk `set`s or `delete`s, because:\n   * - Atomicity: Using a single `state.update` ensures that all changes are applied atomically.\n   * - Performance: One round trip instead of many `setKey` / `deleteKey` calls.\n   * - State Consistency: Read once, modify in memory, write the complete updated state back.\n   *\n   * ⚠️ WARNING: Use with caution because:\n   * - it will override the whole state.\n   * - it transfers the whole state back and forth to the data store.\n   *\n   * For single updates, use `setKey` or `deleteKey` instead.\n   *\n   * @param updaterFunction - The function that updates the state.\n   * @returns The updated state.\n   */\n  update(\n    updaterFunction: (state: TStateValue) => TStateValue,\n  ): Promise<TStateValue>;\n  /**\n   * Deletes the value of the passed key in the state object.\n   * The key is a JSON path to the value to delete.\n   */\n  deleteKey(key: string): Promise<void>;\n  /**\n   * Deletes multiple keys in the state object in a single operation.\n   * The keys are JSON paths to the values to delete.\n   */\n  deleteKeys(keys: string[]): Promise<void>;\n};\n"]}

package/dist/utils/state/IStateManager.d.cts

@@ -0,0 +1,69 @@
+import type { Serializable } from "../serialization/types.cjs";
+export type IStateManager<TStateValue extends Record<string, Serializable>> = {
+    /**
+     * Gets the whole state object.
+     *
+     * ⚠️ WARNING: Use with caution because it transfers the whole state, which might contain a lot of data.
+     * If you need to retrieve only a specific part of the state, use IStateManager.getKey instead.
+     */
+    get(): Promise<TStateValue>;
+    /**
+     * Gets the value of the passed key in the state object.
+     * The key is the JSON path to the value to get.
+     *
+     * @returns The value of the key, or undefined if the key does not exist.
+     */
+    getKey<TResponse extends Serializable>(key: string): Promise<TResponse | undefined>;
+    /**
+     * Sets the value of the passed key in the state object.
+     * The key is a JSON path to the value to set.
+     *
+     * @param key - The key to set, which is a JSON path to the location.
+     * @param value - The value to set.
+     */
+    setKey(key: string, value: Serializable): Promise<void>;
+    /**
+     * Atomically reads the current value at `key`, applies `updater`, and writes the result back.
+     *
+     * Implementations must ensure that no concurrent state write can interleave between the
+     * read and the write. This makes the method safe for updates where the next value depends
+     * on the current value, such as merging objects.
+     *
+     * Prefer this over a manual `getKey` + `setKey` sequence whenever the new value depends on
+     * the current one.
+     *
+     * @param key - The JSON-path key to update.
+     * @param updater - Receives the current value (or `undefined` when the key is absent) and
+     * returns the new value to store.
+     */
+    setKeyWith<TValue extends Serializable>(key: string, updater: (currentValue: TValue | undefined) => TValue): Promise<void>;
+    /**
+     * Updates the whole state object.
+     *
+     * Typically used for bulk `set`s or `delete`s, because:
+     * - Atomicity: Using a single `state.update` ensures that all changes are applied atomically.
+     * - Performance: One round trip instead of many `setKey` / `deleteKey` calls.
+     * - State Consistency: Read once, modify in memory, write the complete updated state back.
+     *
+     * ⚠️ WARNING: Use with caution because:
+     * - it will override the whole state.
+     * - it transfers the whole state back and forth to the data store.
+     *
+     * For single updates, use `setKey` or `deleteKey` instead.
+     *
+     * @param updaterFunction - The function that updates the state.
+     * @returns The updated state.
+     */
+    update(updaterFunction: (state: TStateValue) => TStateValue): Promise<TStateValue>;
+    /**
+     * Deletes the value of the passed key in the state object.
+     * The key is a JSON path to the value to delete.
+     */
+    deleteKey(key: string): Promise<void>;
+    /**
+     * Deletes multiple keys in the state object in a single operation.
+     * The keys are JSON paths to the values to delete.
+     */
+    deleteKeys(keys: string[]): Promise<void>;
+};
+//# sourceMappingURL=IStateManager.d.cts.map

package/dist/utils/state/IStateManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStateManager.d.cts","sourceRoot":"","sources":["../../../src/utils/state/IStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAE3D,MAAM,MAAM,aAAa,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI;IAC5E;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,SAAS,YAAY,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAM,SAAS,YAAY,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GACpD,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GACnD,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC"}

package/dist/utils/state/IStateManager.d.mts

@@ -0,0 +1,69 @@
+import type { Serializable } from "../serialization/types.mjs";
+export type IStateManager<TStateValue extends Record<string, Serializable>> = {
+    /**
+     * Gets the whole state object.
+     *
+     * ⚠️ WARNING: Use with caution because it transfers the whole state, which might contain a lot of data.
+     * If you need to retrieve only a specific part of the state, use IStateManager.getKey instead.
+     */
+    get(): Promise<TStateValue>;
+    /**
+     * Gets the value of the passed key in the state object.
+     * The key is the JSON path to the value to get.
+     *
+     * @returns The value of the key, or undefined if the key does not exist.
+     */
+    getKey<TResponse extends Serializable>(key: string): Promise<TResponse | undefined>;
+    /**
+     * Sets the value of the passed key in the state object.
+     * The key is a JSON path to the value to set.
+     *
+     * @param key - The key to set, which is a JSON path to the location.
+     * @param value - The value to set.
+     */
+    setKey(key: string, value: Serializable): Promise<void>;
+    /**
+     * Atomically reads the current value at `key`, applies `updater`, and writes the result back.
+     *
+     * Implementations must ensure that no concurrent state write can interleave between the
+     * read and the write. This makes the method safe for updates where the next value depends
+     * on the current value, such as merging objects.
+     *
+     * Prefer this over a manual `getKey` + `setKey` sequence whenever the new value depends on
+     * the current one.
+     *
+     * @param key - The JSON-path key to update.
+     * @param updater - Receives the current value (or `undefined` when the key is absent) and
+     * returns the new value to store.
+     */
+    setKeyWith<TValue extends Serializable>(key: string, updater: (currentValue: TValue | undefined) => TValue): Promise<void>;
+    /**
+     * Updates the whole state object.
+     *
+     * Typically used for bulk `set`s or `delete`s, because:
+     * - Atomicity: Using a single `state.update` ensures that all changes are applied atomically.
+     * - Performance: One round trip instead of many `setKey` / `deleteKey` calls.
+     * - State Consistency: Read once, modify in memory, write the complete updated state back.
+     *
+     * ⚠️ WARNING: Use with caution because:
+     * - it will override the whole state.
+     * - it transfers the whole state back and forth to the data store.
+     *
+     * For single updates, use `setKey` or `deleteKey` instead.
+     *
+     * @param updaterFunction - The function that updates the state.
+     * @returns The updated state.
+     */
+    update(updaterFunction: (state: TStateValue) => TStateValue): Promise<TStateValue>;
+    /**
+     * Deletes the value of the passed key in the state object.
+     * The key is a JSON path to the value to delete.
+     */
+    deleteKey(key: string): Promise<void>;
+    /**
+     * Deletes multiple keys in the state object in a single operation.
+     * The keys are JSON paths to the values to delete.
+     */
+    deleteKeys(keys: string[]): Promise<void>;
+};
+//# sourceMappingURL=IStateManager.d.mts.map

package/dist/utils/state/IStateManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStateManager.d.mts","sourceRoot":"","sources":["../../../src/utils/state/IStateManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAE3D,MAAM,MAAM,aAAa,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI;IAC5E;;;;;OAKG;IACH,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,SAAS,SAAS,YAAY,EACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,MAAM,SAAS,YAAY,EACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GACpD,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CACJ,eAAe,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GACnD,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C,CAAC"}

package/dist/utils/state/IStateManager.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IStateManager.mjs.map

package/dist/utils/state/IStateManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStateManager.mjs","sourceRoot":"","sources":["../../../src/utils/state/IStateManager.ts"],"names":[],"mappings":"","sourcesContent":["import type { Serializable } from '../serialization/types';\n\nexport type IStateManager<TStateValue extends Record<string, Serializable>> = {\n  /**\n   * Gets the whole state object.\n   *\n   * ⚠️ WARNING: Use with caution because it transfers the whole state, which might contain a lot of data.\n   * If you need to retrieve only a specific part of the state, use IStateManager.getKey instead.\n   */\n  get(): Promise<TStateValue>;\n  /**\n   * Gets the value of the passed key in the state object.\n   * The key is the JSON path to the value to get.\n   *\n   * @returns The value of the key, or undefined if the key does not exist.\n   */\n  getKey<TResponse extends Serializable>(\n    key: string,\n  ): Promise<TResponse | undefined>;\n  /**\n   * Sets the value of the passed key in the state object.\n   * The key is a JSON path to the value to set.\n   *\n   * @param key - The key to set, which is a JSON path to the location.\n   * @param value - The value to set.\n   */\n  setKey(key: string, value: Serializable): Promise<void>;\n  /**\n   * Atomically reads the current value at `key`, applies `updater`, and writes the result back.\n   *\n   * Implementations must ensure that no concurrent state write can interleave between the\n   * read and the write. This makes the method safe for updates where the next value depends\n   * on the current value, such as merging objects.\n   *\n   * Prefer this over a manual `getKey` + `setKey` sequence whenever the new value depends on\n   * the current one.\n   *\n   * @param key - The JSON-path key to update.\n   * @param updater - Receives the current value (or `undefined` when the key is absent) and\n   * returns the new value to store.\n   */\n  setKeyWith<TValue extends Serializable>(\n    key: string,\n    updater: (currentValue: TValue | undefined) => TValue,\n  ): Promise<void>;\n  /**\n   * Updates the whole state object.\n   *\n   * Typically used for bulk `set`s or `delete`s, because:\n   * - Atomicity: Using a single `state.update` ensures that all changes are applied atomically.\n   * - Performance: One round trip instead of many `setKey` / `deleteKey` calls.\n   * - State Consistency: Read once, modify in memory, write the complete updated state back.\n   *\n   * ⚠️ WARNING: Use with caution because:\n   * - it will override the whole state.\n   * - it transfers the whole state back and forth to the data store.\n   *\n   * For single updates, use `setKey` or `deleteKey` instead.\n   *\n   * @param updaterFunction - The function that updates the state.\n   * @returns The updated state.\n   */\n  update(\n    updaterFunction: (state: TStateValue) => TStateValue,\n  ): Promise<TStateValue>;\n  /**\n   * Deletes the value of the passed key in the state object.\n   * The key is a JSON path to the value to delete.\n   */\n  deleteKey(key: string): Promise<void>;\n  /**\n   * Deletes multiple keys in the state object in a single operation.\n   * The keys are JSON paths to the values to delete.\n   */\n  deleteKeys(keys: string[]): Promise<void>;\n};\n"]}

package/dist/utils/state/InMemoryState.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryState = void 0;
+const lodash_1 = require("lodash");
+/**
+ * A simple implementation of the `IStateManager` interface that relies on an in-memory
+ * state. Intended for tests.
+ */
+class InMemoryState {
+    #state;
+    constructor(initialState) {
+        this.#state = initialState;
+    }
+    async get() {
+        return this.#state;
+    }
+    async getKey(key) {
+        return (0, lodash_1.get)(this.#state, key);
+    }
+    async setKey(key, value) {
+        (0, lodash_1.set)(this.#state, key, value);
+    }
+    async setKeyWith(key, updater) {
+        const oldValue = (0, lodash_1.get)(this.#state, key);
+        (0, lodash_1.set)(this.#state, key, updater(oldValue));
+    }
+    async update(callback) {
+        this.#state = callback(this.#state);
+        return this.#state;
+    }
+    async deleteKey(key) {
+        (0, lodash_1.unset)(this.#state, key);
+    }
+    async deleteKeys(keys) {
+        keys.forEach((key) => {
+            (0, lodash_1.unset)(this.#state, key);
+        });
+    }
+}
+exports.InMemoryState = InMemoryState;
+//# sourceMappingURL=InMemoryState.cjs.map

package/dist/utils/state/InMemoryState.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryState.cjs","sourceRoot":"","sources":["../../../src/utils/state/InMemoryState.ts"],"names":[],"mappings":";;;AAAA,mCAAyC;AAKzC;;;GAGG;AACH,MAAa,aAAa;IAGxB,MAAM,CAAc;IAEpB,YAAY,YAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,GAAW;QAEX,OAAO,IAAA,YAAG,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAA0B,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAmB;QAC3C,IAAA,YAAG,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,OAAqD;QAErD,MAAM,QAAQ,GAAG,IAAA,YAAG,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAuB,CAAC;QAC7D,IAAA,YAAG,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAA6C;QAE7C,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAA,cAAK,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAc;QAC7B,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,IAAA,cAAK,EAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA/CD,sCA+CC","sourcesContent":["import { get, set, unset } from 'lodash';\n\nimport type { Serializable } from '../serialization/types';\nimport type { IStateManager } from './IStateManager';\n\n/**\n * A simple implementation of the `IStateManager` interface that relies on an in-memory\n * state. Intended for tests.\n */\nexport class InMemoryState<\n  TStateValue extends Record<string, Serializable>,\n> implements IStateManager<TStateValue> {\n  #state: TStateValue;\n\n  constructor(initialState: TStateValue) {\n    this.#state = initialState;\n  }\n\n  async get(): Promise<TStateValue> {\n    return this.#state;\n  }\n\n  async getKey<TResponse extends Serializable>(\n    key: string,\n  ): Promise<TResponse | undefined> {\n    return get(this.#state, key) as TResponse | undefined;\n  }\n\n  async setKey(key: string, value: Serializable): Promise<void> {\n    set(this.#state, key, value);\n  }\n\n  async setKeyWith<TValue extends Serializable>(\n    key: string,\n    updater: (currentValue: TValue | undefined) => TValue,\n  ): Promise<void> {\n    const oldValue = get(this.#state, key) as TValue | undefined;\n    set(this.#state, key, updater(oldValue));\n  }\n\n  async update(\n    callback: (state: TStateValue) => TStateValue,\n  ): Promise<TStateValue> {\n    this.#state = callback(this.#state);\n    return this.#state;\n  }\n\n  async deleteKey(key: string): Promise<void> {\n    unset(this.#state, key);\n  }\n\n  async deleteKeys(keys: string[]): Promise<void> {\n    keys.forEach((key) => {\n      unset(this.#state, key);\n    });\n  }\n}\n"]}

package/dist/utils/state/InMemoryState.d.cts

@@ -0,0 +1,18 @@
+import type { Serializable } from "../serialization/types.cjs";
+import type { IStateManager } from "./IStateManager.cjs";
+/**
+ * A simple implementation of the `IStateManager` interface that relies on an in-memory
+ * state. Intended for tests.
+ */
+export declare class InMemoryState<TStateValue extends Record<string, Serializable>> implements IStateManager<TStateValue> {
+    #private;
+    constructor(initialState: TStateValue);
+    get(): Promise<TStateValue>;
+    getKey<TResponse extends Serializable>(key: string): Promise<TResponse | undefined>;
+    setKey(key: string, value: Serializable): Promise<void>;
+    setKeyWith<TValue extends Serializable>(key: string, updater: (currentValue: TValue | undefined) => TValue): Promise<void>;
+    update(callback: (state: TStateValue) => TStateValue): Promise<TStateValue>;
+    deleteKey(key: string): Promise<void>;
+    deleteKeys(keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=InMemoryState.d.cts.map

package/dist/utils/state/InMemoryState.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryState.d.cts","sourceRoot":"","sources":["../../../src/utils/state/InMemoryState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAErD;;;GAGG;AACH,qBAAa,aAAa,CACxB,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAChD,YAAW,aAAa,CAAC,WAAW,CAAC;;gBAGzB,YAAY,EAAE,WAAW;IAI/B,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAI3B,MAAM,CAAC,SAAS,SAAS,YAAY,EACzC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,UAAU,CAAC,MAAM,SAAS,YAAY,EAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GACpD,OAAO,CAAC,IAAI,CAAC;IAKV,MAAM,CACV,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAC5C,OAAO,CAAC,WAAW,CAAC;IAKjB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}

package/dist/utils/state/InMemoryState.d.mts

@@ -0,0 +1,18 @@
+import type { Serializable } from "../serialization/types.mjs";
+import type { IStateManager } from "./IStateManager.mjs";
+/**
+ * A simple implementation of the `IStateManager` interface that relies on an in-memory
+ * state. Intended for tests.
+ */
+export declare class InMemoryState<TStateValue extends Record<string, Serializable>> implements IStateManager<TStateValue> {
+    #private;
+    constructor(initialState: TStateValue);
+    get(): Promise<TStateValue>;
+    getKey<TResponse extends Serializable>(key: string): Promise<TResponse | undefined>;
+    setKey(key: string, value: Serializable): Promise<void>;
+    setKeyWith<TValue extends Serializable>(key: string, updater: (currentValue: TValue | undefined) => TValue): Promise<void>;
+    update(callback: (state: TStateValue) => TStateValue): Promise<TStateValue>;
+    deleteKey(key: string): Promise<void>;
+    deleteKeys(keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=InMemoryState.d.mts.map

package/dist/utils/state/InMemoryState.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryState.d.mts","sourceRoot":"","sources":["../../../src/utils/state/InMemoryState.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAErD;;;GAGG;AACH,qBAAa,aAAa,CACxB,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAChD,YAAW,aAAa,CAAC,WAAW,CAAC;;gBAGzB,YAAY,EAAE,WAAW;IAI/B,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAI3B,MAAM,CAAC,SAAS,SAAS,YAAY,EACzC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAI3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,UAAU,CAAC,MAAM,SAAS,YAAY,EAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GACpD,OAAO,CAAC,IAAI,CAAC;IAKV,MAAM,CACV,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,WAAW,GAC5C,OAAO,CAAC,WAAW,CAAC;IAKjB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhD"}