@metamask/snap-networks-utils 1.0.0 → 2.0.0

package/dist/utils/proofOfOwnership/proofOfOwnership.cjs

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProofOfOwnershipBatchResponseStruct = exports.ProofOfOwnershipBatchItemResponseStruct = exports.ProofOfOwnershipBatchErrorStruct = exports.ProofOfOwnershipBatchSuccessStruct = exports.ProofOfOwnershipBatchRequestParamsStruct = exports.ProofOfOwnershipBatchRequestItemStruct = exports.ProofOfOwnershipMessageStruct = exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = void 0;
+exports.parseProofOfOwnershipMessage = parseProofOfOwnershipMessage;
+const superstruct_1 = require("@metamask/superstruct");
+const uuidStruct_1 = require("../uuidStruct/uuidStruct.cjs");
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+exports.ProofOfOwnershipMessageStruct = (0, superstruct_1.object)({
+    nonce: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+    address: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+});
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+exports.ProofOfOwnershipBatchRequestItemStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    message: (0, superstruct_1.string)(),
+});
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+exports.ProofOfOwnershipBatchRequestParamsStruct = (0, superstruct_1.object)({
+    items: (0, superstruct_1.array)(exports.ProofOfOwnershipBatchRequestItemStruct),
+});
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchSuccessStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    signature: (0, superstruct_1.string)(),
+});
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchErrorStruct = (0, superstruct_1.object)({
+    accountId: uuidStruct_1.UuidStruct,
+    error: (0, superstruct_1.nonempty)((0, superstruct_1.string)()),
+});
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+exports.ProofOfOwnershipBatchItemResponseStruct = (0, superstruct_1.union)([
+    exports.ProofOfOwnershipBatchSuccessStruct,
+    exports.ProofOfOwnershipBatchErrorStruct,
+]);
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+exports.ProofOfOwnershipBatchResponseStruct = (0, superstruct_1.object)({
+    results: (0, superstruct_1.array)(exports.ProofOfOwnershipBatchItemResponseStruct),
+});
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+function parseProofOfOwnershipMessage(message) {
+    if (!message.startsWith(exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {
+        throw new Error(`Message must start with "${exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}"`);
+    }
+    const remainder = message.slice(exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);
+    const separatorIndex = remainder.lastIndexOf(':');
+    if (separatorIndex === -1) {
+        throw new Error('Message must follow the format "metamask:proof-of-ownership:{nonce}:{address}"');
+    }
+    const nonce = remainder.slice(0, separatorIndex);
+    const address = remainder.slice(separatorIndex + 1);
+    if (nonce.length === 0) {
+        throw new Error('Message must include a non-empty nonce');
+    }
+    if (address.length === 0) {
+        throw new Error('Message must include a non-empty address');
+    }
+    return { nonce, address };
+}
+//# sourceMappingURL=proofOfOwnership.cjs.map

package/dist/utils/proofOfOwnership/proofOfOwnership.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.cjs","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":";;;AA6HA,oEA6BC;AAzJD,uDAA+E;AAE/E,6DAAsD;AAEtD;;GAEG;AACU,QAAA,iCAAiC,GAAG,8BAA8B,CAAC;AAEhF;;GAEG;AACU,QAAA,6BAA6B,GAAG,IAAA,oBAAM,EAAC;IAClD,KAAK,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;IACzB,OAAO,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC5B,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,sCAAsC,GAAG,IAAA,oBAAM,EAAC;IAC3D,SAAS,EAAE,uBAAU;IACrB,OAAO,EAAE,IAAA,oBAAM,GAAE;CAClB,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,wCAAwC,GAAG,IAAA,oBAAM,EAAC;IAC7D,KAAK,EAAE,IAAA,mBAAK,EAAC,8CAAsC,CAAC;CACrD,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,kCAAkC,GAAG,IAAA,oBAAM,EAAC;IACvD,SAAS,EAAE,uBAAU;IACrB,SAAS,EAAE,IAAA,oBAAM,GAAE;CACpB,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,gCAAgC,GAAG,IAAA,oBAAM,EAAC;IACrD,SAAS,EAAE,uBAAU;IACrB,KAAK,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;CAC1B,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,uCAAuC,GAAG,IAAA,mBAAK,EAAC;IAC3D,0CAAkC;IAClC,wCAAgC;CACjC,CAAC,CAAC;AASH;;GAEG;AACU,QAAA,mCAAmC,GAAG,IAAA,oBAAM,EAAC;IACxD,OAAO,EAAE,IAAA,mBAAK,EAAC,+CAAuC,CAAC;CACxD,CAAC,CAAC;AASH;;;;;;;;;;;GAWG;AACH,SAAgB,4BAA4B,CAC1C,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,yCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,4BAA4B,yCAAiC,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,yCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport { array, nonempty, object, string, union } from '@metamask/superstruct';\n\nimport { UuidStruct } from '../uuidStruct/uuidStruct';\n\n/**\n * Prefix for proof-of-ownership messages signed by network snaps.\n */\nexport const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';\n\n/**\n * Validates parsed proof-of-ownership message fields.\n */\nexport const ProofOfOwnershipMessageStruct = object({\n  nonce: nonempty(string()),\n  address: nonempty(string()),\n});\n\n/**\n * Parsed proof-of-ownership message fields.\n */\nexport type ProofOfOwnershipMessage = Infer<\n  typeof ProofOfOwnershipMessageStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch request item.\n */\nexport const ProofOfOwnershipBatchRequestItemStruct = object({\n  accountId: UuidStruct,\n  message: string(),\n});\n\n/**\n * One proof-of-ownership batch request item.\n */\nexport type ProofOfOwnershipBatchRequestItem = Infer<\n  typeof ProofOfOwnershipBatchRequestItemStruct\n>;\n\n/**\n * Validates proof-of-ownership batch request params.\n */\nexport const ProofOfOwnershipBatchRequestParamsStruct = object({\n  items: array(ProofOfOwnershipBatchRequestItemStruct),\n});\n\n/**\n * Proof-of-ownership batch request params.\n */\nexport type ProofOfOwnershipBatchRequestParams = Infer<\n  typeof ProofOfOwnershipBatchRequestParamsStruct\n>;\n\n/**\n * Validates one successful proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchSuccessStruct = object({\n  accountId: UuidStruct,\n  signature: string(),\n});\n\n/**\n * One successful proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchSuccess = Infer<\n  typeof ProofOfOwnershipBatchSuccessStruct\n>;\n\n/**\n * Validates one failed proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchErrorStruct = object({\n  accountId: UuidStruct,\n  error: nonempty(string()),\n});\n\n/**\n * One failed proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchError = Infer<\n  typeof ProofOfOwnershipBatchErrorStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchItemResponseStruct = union([\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipBatchErrorStruct,\n]);\n\n/**\n * One proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchItemResponse = Infer<\n  typeof ProofOfOwnershipBatchItemResponseStruct\n>;\n\n/**\n * Validates a proof-of-ownership batch response.\n */\nexport const ProofOfOwnershipBatchResponseStruct = object({\n  results: array(ProofOfOwnershipBatchItemResponseStruct),\n});\n\n/**\n * Proof-of-ownership batch response shape.\n */\nexport type ProofOfOwnershipBatchResponse = Infer<\n  typeof ProofOfOwnershipBatchResponseStruct\n>;\n\n/**\n * Parses a plaintext proof-of-ownership message in the format\n * `metamask:proof-of-ownership:{nonce}:{address}`.\n *\n * Address validity is intentionally not checked here because it is\n * chain-specific. Callers should validate the returned address with the\n * relevant network/address validator.\n *\n * @param message - The plaintext message to parse.\n * @returns The parsed nonce and address.\n * @throws Error if the message format is invalid.\n */\nexport function parseProofOfOwnershipMessage(\n  message: string,\n): ProofOfOwnershipMessage {\n  if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {\n    throw new Error(\n      `Message must start with \"${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}\"`,\n    );\n  }\n\n  const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);\n  const separatorIndex = remainder.lastIndexOf(':');\n  if (separatorIndex === -1) {\n    throw new Error(\n      'Message must follow the format \"metamask:proof-of-ownership:{nonce}:{address}\"',\n    );\n  }\n\n  const nonce = remainder.slice(0, separatorIndex);\n  const address = remainder.slice(separatorIndex + 1);\n\n  if (nonce.length === 0) {\n    throw new Error('Message must include a non-empty nonce');\n  }\n\n  if (address.length === 0) {\n    throw new Error('Message must include a non-empty address');\n  }\n\n  return { nonce, address };\n}\n"]}

package/dist/utils/proofOfOwnership/proofOfOwnership.d.cts

@@ -0,0 +1,143 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export declare const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = "metamask:proof-of-ownership:";
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export declare const ProofOfOwnershipMessageStruct: import("@metamask/superstruct").Struct<{
+    address: string;
+    nonce: string;
+}, {
+    nonce: import("@metamask/superstruct").Struct<string, null>;
+    address: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Parsed proof-of-ownership message fields.
+ */
+export type ProofOfOwnershipMessage = Infer<typeof ProofOfOwnershipMessageStruct>;
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export declare const ProofOfOwnershipBatchRequestItemStruct: import("@metamask/superstruct").Struct<{
+    message: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    message: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One proof-of-ownership batch request item.
+ */
+export type ProofOfOwnershipBatchRequestItem = Infer<typeof ProofOfOwnershipBatchRequestItemStruct>;
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export declare const ProofOfOwnershipBatchRequestParamsStruct: import("@metamask/superstruct").Struct<{
+    items: {
+        message: string;
+        accountId: string;
+    }[];
+}, {
+    items: import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }[], import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }, {
+        accountId: import("@metamask/superstruct").Struct<string, null>;
+        message: import("@metamask/superstruct").Struct<string, null>;
+    }>>;
+}>;
+/**
+ * Proof-of-ownership batch request params.
+ */
+export type ProofOfOwnershipBatchRequestParams = Infer<typeof ProofOfOwnershipBatchRequestParamsStruct>;
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchSuccessStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    signature: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One successful proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchSuccess = Infer<typeof ProofOfOwnershipBatchSuccessStruct>;
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchErrorStruct: import("@metamask/superstruct").Struct<{
+    error: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    error: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One failed proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchError = Infer<typeof ProofOfOwnershipBatchErrorStruct>;
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchItemResponseStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+} | {
+    error: string;
+    accountId: string;
+}, null>;
+/**
+ * One proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchItemResponse = Infer<typeof ProofOfOwnershipBatchItemResponseStruct>;
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export declare const ProofOfOwnershipBatchResponseStruct: import("@metamask/superstruct").Struct<{
+    results: ({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[];
+}, {
+    results: import("@metamask/superstruct").Struct<({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[], import("@metamask/superstruct").Struct<{
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    }, null>>;
+}>;
+/**
+ * Proof-of-ownership batch response shape.
+ */
+export type ProofOfOwnershipBatchResponse = Infer<typeof ProofOfOwnershipBatchResponseStruct>;
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export declare function parseProofOfOwnershipMessage(message: string): ProofOfOwnershipMessage;
+//# sourceMappingURL=proofOfOwnership.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.d.cts","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAKnD;;GAEG;AACH,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;EAGxC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;EAGjD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAClD,OAAO,sCAAsC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;EAEnD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,OAAO,wCAAwC,CAChD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAG7C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAC9C,OAAO,kCAAkC,CAC1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAG3C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;;QAGlD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,OAAO,uCAAuC,CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;EAE9C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAC/C,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,uBAAuB,CA2BzB"}

package/dist/utils/proofOfOwnership/proofOfOwnership.d.mts

@@ -0,0 +1,143 @@
+import type { Infer } from "@metamask/superstruct";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export declare const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = "metamask:proof-of-ownership:";
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export declare const ProofOfOwnershipMessageStruct: import("@metamask/superstruct").Struct<{
+    address: string;
+    nonce: string;
+}, {
+    nonce: import("@metamask/superstruct").Struct<string, null>;
+    address: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * Parsed proof-of-ownership message fields.
+ */
+export type ProofOfOwnershipMessage = Infer<typeof ProofOfOwnershipMessageStruct>;
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export declare const ProofOfOwnershipBatchRequestItemStruct: import("@metamask/superstruct").Struct<{
+    message: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    message: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One proof-of-ownership batch request item.
+ */
+export type ProofOfOwnershipBatchRequestItem = Infer<typeof ProofOfOwnershipBatchRequestItemStruct>;
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export declare const ProofOfOwnershipBatchRequestParamsStruct: import("@metamask/superstruct").Struct<{
+    items: {
+        message: string;
+        accountId: string;
+    }[];
+}, {
+    items: import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }[], import("@metamask/superstruct").Struct<{
+        message: string;
+        accountId: string;
+    }, {
+        accountId: import("@metamask/superstruct").Struct<string, null>;
+        message: import("@metamask/superstruct").Struct<string, null>;
+    }>>;
+}>;
+/**
+ * Proof-of-ownership batch request params.
+ */
+export type ProofOfOwnershipBatchRequestParams = Infer<typeof ProofOfOwnershipBatchRequestParamsStruct>;
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchSuccessStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    signature: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One successful proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchSuccess = Infer<typeof ProofOfOwnershipBatchSuccessStruct>;
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchErrorStruct: import("@metamask/superstruct").Struct<{
+    error: string;
+    accountId: string;
+}, {
+    accountId: import("@metamask/superstruct").Struct<string, null>;
+    error: import("@metamask/superstruct").Struct<string, null>;
+}>;
+/**
+ * One failed proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchError = Infer<typeof ProofOfOwnershipBatchErrorStruct>;
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export declare const ProofOfOwnershipBatchItemResponseStruct: import("@metamask/superstruct").Struct<{
+    accountId: string;
+    signature: string;
+} | {
+    error: string;
+    accountId: string;
+}, null>;
+/**
+ * One proof-of-ownership batch result.
+ */
+export type ProofOfOwnershipBatchItemResponse = Infer<typeof ProofOfOwnershipBatchItemResponseStruct>;
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export declare const ProofOfOwnershipBatchResponseStruct: import("@metamask/superstruct").Struct<{
+    results: ({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[];
+}, {
+    results: import("@metamask/superstruct").Struct<({
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    })[], import("@metamask/superstruct").Struct<{
+        accountId: string;
+        signature: string;
+    } | {
+        error: string;
+        accountId: string;
+    }, null>>;
+}>;
+/**
+ * Proof-of-ownership batch response shape.
+ */
+export type ProofOfOwnershipBatchResponse = Infer<typeof ProofOfOwnershipBatchResponseStruct>;
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export declare function parseProofOfOwnershipMessage(message: string): ProofOfOwnershipMessage;
+//# sourceMappingURL=proofOfOwnership.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.d.mts","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAKnD;;GAEG;AACH,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;EAGxC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,KAAK,CACzC,OAAO,6BAA6B,CACrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sCAAsC;;;;;;EAGjD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,KAAK,CAClD,OAAO,sCAAsC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;EAEnD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAAG,KAAK,CACpD,OAAO,wCAAwC,CAChD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kCAAkC;;;;;;EAG7C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAC9C,OAAO,kCAAkC,CAC1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;EAG3C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,KAAK,CAC5C,OAAO,gCAAgC,CACxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;;QAGlD,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,OAAO,uCAAuC,CAC/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;EAE9C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,KAAK,CAC/C,OAAO,mCAAmC,CAC3C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GACd,uBAAuB,CA2BzB"}

package/dist/utils/proofOfOwnership/proofOfOwnership.mjs

@@ -0,0 +1,85 @@
+import { array, nonempty, object, string, union } from "@metamask/superstruct";
+import { UuidStruct } from "../uuidStruct/uuidStruct.mjs";
+/**
+ * Prefix for proof-of-ownership messages signed by network snaps.
+ */
+export const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';
+/**
+ * Validates parsed proof-of-ownership message fields.
+ */
+export const ProofOfOwnershipMessageStruct = object({
+    nonce: nonempty(string()),
+    address: nonempty(string()),
+});
+/**
+ * Validates one proof-of-ownership batch request item.
+ */
+export const ProofOfOwnershipBatchRequestItemStruct = object({
+    accountId: UuidStruct,
+    message: string(),
+});
+/**
+ * Validates proof-of-ownership batch request params.
+ */
+export const ProofOfOwnershipBatchRequestParamsStruct = object({
+    items: array(ProofOfOwnershipBatchRequestItemStruct),
+});
+/**
+ * Validates one successful proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchSuccessStruct = object({
+    accountId: UuidStruct,
+    signature: string(),
+});
+/**
+ * Validates one failed proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchErrorStruct = object({
+    accountId: UuidStruct,
+    error: nonempty(string()),
+});
+/**
+ * Validates one proof-of-ownership batch result.
+ */
+export const ProofOfOwnershipBatchItemResponseStruct = union([
+    ProofOfOwnershipBatchSuccessStruct,
+    ProofOfOwnershipBatchErrorStruct,
+]);
+/**
+ * Validates a proof-of-ownership batch response.
+ */
+export const ProofOfOwnershipBatchResponseStruct = object({
+    results: array(ProofOfOwnershipBatchItemResponseStruct),
+});
+/**
+ * Parses a plaintext proof-of-ownership message in the format
+ * `metamask:proof-of-ownership:{nonce}:{address}`.
+ *
+ * Address validity is intentionally not checked here because it is
+ * chain-specific. Callers should validate the returned address with the
+ * relevant network/address validator.
+ *
+ * @param message - The plaintext message to parse.
+ * @returns The parsed nonce and address.
+ * @throws Error if the message format is invalid.
+ */
+export function parseProofOfOwnershipMessage(message) {
+    if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {
+        throw new Error(`Message must start with "${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}"`);
+    }
+    const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);
+    const separatorIndex = remainder.lastIndexOf(':');
+    if (separatorIndex === -1) {
+        throw new Error('Message must follow the format "metamask:proof-of-ownership:{nonce}:{address}"');
+    }
+    const nonce = remainder.slice(0, separatorIndex);
+    const address = remainder.slice(separatorIndex + 1);
+    if (nonce.length === 0) {
+        throw new Error('Message must include a non-empty nonce');
+    }
+    if (address.length === 0) {
+        throw new Error('Message must include a non-empty address');
+    }
+    return { nonce, address };
+}
+//# sourceMappingURL=proofOfOwnership.mjs.map

package/dist/utils/proofOfOwnership/proofOfOwnership.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"proofOfOwnership.mjs","sourceRoot":"","sources":["../../../src/utils/proofOfOwnership/proofOfOwnership.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,8BAA8B;AAE/E,OAAO,EAAE,UAAU,EAAE,qCAAiC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,8BAA8B,CAAC;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;IAClD,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC5B,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,MAAM,CAAC;IAC3D,SAAS,EAAE,UAAU;IACrB,OAAO,EAAE,MAAM,EAAE;CAClB,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,wCAAwC,GAAG,MAAM,CAAC;IAC7D,KAAK,EAAE,KAAK,CAAC,sCAAsC,CAAC;CACrD,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC;IACvD,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,MAAM,EAAE;CACpB,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;IACrD,SAAS,EAAE,UAAU;IACrB,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;CAC1B,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,uCAAuC,GAAG,KAAK,CAAC;IAC3D,kCAAkC;IAClC,gCAAgC;CACjC,CAAC,CAAC;AASH;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC;IACxD,OAAO,EAAE,KAAK,CAAC,uCAAuC,CAAC;CACxD,CAAC,CAAC;AASH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,4BAA4B,iCAAiC,GAAG,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport { array, nonempty, object, string, union } from '@metamask/superstruct';\n\nimport { UuidStruct } from '../uuidStruct/uuidStruct';\n\n/**\n * Prefix for proof-of-ownership messages signed by network snaps.\n */\nexport const PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = 'metamask:proof-of-ownership:';\n\n/**\n * Validates parsed proof-of-ownership message fields.\n */\nexport const ProofOfOwnershipMessageStruct = object({\n  nonce: nonempty(string()),\n  address: nonempty(string()),\n});\n\n/**\n * Parsed proof-of-ownership message fields.\n */\nexport type ProofOfOwnershipMessage = Infer<\n  typeof ProofOfOwnershipMessageStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch request item.\n */\nexport const ProofOfOwnershipBatchRequestItemStruct = object({\n  accountId: UuidStruct,\n  message: string(),\n});\n\n/**\n * One proof-of-ownership batch request item.\n */\nexport type ProofOfOwnershipBatchRequestItem = Infer<\n  typeof ProofOfOwnershipBatchRequestItemStruct\n>;\n\n/**\n * Validates proof-of-ownership batch request params.\n */\nexport const ProofOfOwnershipBatchRequestParamsStruct = object({\n  items: array(ProofOfOwnershipBatchRequestItemStruct),\n});\n\n/**\n * Proof-of-ownership batch request params.\n */\nexport type ProofOfOwnershipBatchRequestParams = Infer<\n  typeof ProofOfOwnershipBatchRequestParamsStruct\n>;\n\n/**\n * Validates one successful proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchSuccessStruct = object({\n  accountId: UuidStruct,\n  signature: string(),\n});\n\n/**\n * One successful proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchSuccess = Infer<\n  typeof ProofOfOwnershipBatchSuccessStruct\n>;\n\n/**\n * Validates one failed proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchErrorStruct = object({\n  accountId: UuidStruct,\n  error: nonempty(string()),\n});\n\n/**\n * One failed proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchError = Infer<\n  typeof ProofOfOwnershipBatchErrorStruct\n>;\n\n/**\n * Validates one proof-of-ownership batch result.\n */\nexport const ProofOfOwnershipBatchItemResponseStruct = union([\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipBatchErrorStruct,\n]);\n\n/**\n * One proof-of-ownership batch result.\n */\nexport type ProofOfOwnershipBatchItemResponse = Infer<\n  typeof ProofOfOwnershipBatchItemResponseStruct\n>;\n\n/**\n * Validates a proof-of-ownership batch response.\n */\nexport const ProofOfOwnershipBatchResponseStruct = object({\n  results: array(ProofOfOwnershipBatchItemResponseStruct),\n});\n\n/**\n * Proof-of-ownership batch response shape.\n */\nexport type ProofOfOwnershipBatchResponse = Infer<\n  typeof ProofOfOwnershipBatchResponseStruct\n>;\n\n/**\n * Parses a plaintext proof-of-ownership message in the format\n * `metamask:proof-of-ownership:{nonce}:{address}`.\n *\n * Address validity is intentionally not checked here because it is\n * chain-specific. Callers should validate the returned address with the\n * relevant network/address validator.\n *\n * @param message - The plaintext message to parse.\n * @returns The parsed nonce and address.\n * @throws Error if the message format is invalid.\n */\nexport function parseProofOfOwnershipMessage(\n  message: string,\n): ProofOfOwnershipMessage {\n  if (!message.startsWith(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX)) {\n    throw new Error(\n      `Message must start with \"${PROOF_OF_OWNERSHIP_MESSAGE_PREFIX}\"`,\n    );\n  }\n\n  const remainder = message.slice(PROOF_OF_OWNERSHIP_MESSAGE_PREFIX.length);\n  const separatorIndex = remainder.lastIndexOf(':');\n  if (separatorIndex === -1) {\n    throw new Error(\n      'Message must follow the format \"metamask:proof-of-ownership:{nonce}:{address}\"',\n    );\n  }\n\n  const nonce = remainder.slice(0, separatorIndex);\n  const address = remainder.slice(separatorIndex + 1);\n\n  if (nonce.length === 0) {\n    throw new Error('Message must include a non-empty nonce');\n  }\n\n  if (address.length === 0) {\n    throw new Error('Message must include a non-empty address');\n  }\n\n  return { nonce, address };\n}\n"]}

package/dist/utils/safeMerge/safeMerge.cjs

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeMerge = void 0;
+/**
+ * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's
+ * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider
+ * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects
+ * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.
+ *
+ * @param overridee - The object to override.
+ * @param overrider - The object to override with.
+ * @returns The merged object (using shallow, top-level merge semantics).
+ * @example
+ * const overridee = { name: 'John' };
+ * const overrider = { name: undefined, age: 30 };
+ * const merged = safeMerge(overridee, overrider);
+ * // merged is { name: 'John', age: 30 }
+ */
+const safeMerge = (overridee, overrider) => ({
+    ...overridee,
+    ...Object.fromEntries(Object.entries(overrider).filter(([_key, value]) => value !== undefined &&
+        value !== null &&
+        (!value || typeof value !== 'object' || Object.keys(value).length > 0))),
+});
+exports.safeMerge = safeMerge;
+//# sourceMappingURL=safeMerge.cjs.map

package/dist/utils/safeMerge/safeMerge.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeMerge.cjs","sourceRoot":"","sources":["../../../src/utils/safeMerge/safeMerge.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;GAcG;AACI,MAAM,SAAS,GAAG,CACvB,SAAqB,EACrB,SAAqB,EACI,EAAE,CAAC,CAAC;IAC7B,GAAG,SAAS;IACZ,GAAI,MAAM,CAAC,WAAW,CACpB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAC9B,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAChB,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CACzE,CACa;CACjB,CAAC,CAAC;AAbU,QAAA,SAAS,aAanB","sourcesContent":["/**\n * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's\n * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider\n * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects\n * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.\n *\n * @param overridee - The object to override.\n * @param overrider - The object to override with.\n * @returns The merged object (using shallow, top-level merge semantics).\n * @example\n * const overridee = { name: 'John' };\n * const overrider = { name: undefined, age: 30 };\n * const merged = safeMerge(overridee, overrider);\n * // merged is { name: 'John', age: 30 }\n */\nexport const safeMerge = <TOverridee extends object, TOverrider extends object>(\n  overridee: TOverridee,\n  overrider: TOverrider,\n): TOverridee & TOverrider => ({\n  ...overridee,\n  ...(Object.fromEntries(\n    Object.entries(overrider).filter(\n      ([_key, value]) =>\n        value !== undefined &&\n        value !== null &&\n        (!value || typeof value !== 'object' || Object.keys(value).length > 0),\n    ),\n  ) as TOverrider),\n});\n"]}

package/dist/utils/safeMerge/safeMerge.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's
+ * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider
+ * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects
+ * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.
+ *
+ * @param overridee - The object to override.
+ * @param overrider - The object to override with.
+ * @returns The merged object (using shallow, top-level merge semantics).
+ * @example
+ * const overridee = { name: 'John' };
+ * const overrider = { name: undefined, age: 30 };
+ * const merged = safeMerge(overridee, overrider);
+ * // merged is { name: 'John', age: 30 }
+ */
+export declare const safeMerge: <TOverridee extends object, TOverrider extends object>(overridee: TOverridee, overrider: TOverrider) => TOverridee & TOverrider;
+//# sourceMappingURL=safeMerge.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safeMerge.d.cts","sourceRoot":"","sources":["../../../src/utils/safeMerge/safeMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM,EAC5E,WAAW,UAAU,EACrB,WAAW,UAAU,KACpB,UAAU,GAAG,UAUd,CAAC"}

package/dist/utils/safeMerge/safeMerge.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's
+ * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider
+ * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects
+ * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.
+ *
+ * @param overridee - The object to override.
+ * @param overrider - The object to override with.
+ * @returns The merged object (using shallow, top-level merge semantics).
+ * @example
+ * const overridee = { name: 'John' };
+ * const overrider = { name: undefined, age: 30 };
+ * const merged = safeMerge(overridee, overrider);
+ * // merged is { name: 'John', age: 30 }
+ */
+export declare const safeMerge: <TOverridee extends object, TOverrider extends object>(overridee: TOverridee, overrider: TOverrider) => TOverridee & TOverrider;
+//# sourceMappingURL=safeMerge.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safeMerge.d.mts","sourceRoot":"","sources":["../../../src/utils/safeMerge/safeMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,SAAS,MAAM,EAAE,UAAU,SAAS,MAAM,EAC5E,WAAW,UAAU,EACrB,WAAW,UAAU,KACpB,UAAU,GAAG,UAUd,CAAC"}

package/dist/utils/safeMerge/safeMerge.mjs

@@ -0,0 +1,22 @@
+/**
+ * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's
+ * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider
+ * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects
+ * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.
+ *
+ * @param overridee - The object to override.
+ * @param overrider - The object to override with.
+ * @returns The merged object (using shallow, top-level merge semantics).
+ * @example
+ * const overridee = { name: 'John' };
+ * const overrider = { name: undefined, age: 30 };
+ * const merged = safeMerge(overridee, overrider);
+ * // merged is { name: 'John', age: 30 }
+ */
+export const safeMerge = (overridee, overrider) => ({
+    ...overridee,
+    ...Object.fromEntries(Object.entries(overrider).filter(([_key, value]) => value !== undefined &&
+        value !== null &&
+        (!value || typeof value !== 'object' || Object.keys(value).length > 0))),
+});
+//# sourceMappingURL=safeMerge.mjs.map

package/dist/utils/safeMerge/safeMerge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeMerge.mjs","sourceRoot":"","sources":["../../../src/utils/safeMerge/safeMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,SAAqB,EACrB,SAAqB,EACI,EAAE,CAAC,CAAC;IAC7B,GAAG,SAAS;IACZ,GAAI,MAAM,CAAC,WAAW,CACpB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAC9B,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAChB,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CACzE,CACa;CACjB,CAAC,CAAC","sourcesContent":["/**\n * Shallowly merges two objects at the top level, keeping values from the overridee object when the overrider's\n * corresponding top-level properties are undefined, null, or empty objects. Non-undefined values from the overrider\n * take precedence. Empty objects in the overrider are filtered out to preserve the overridee's values. Nested objects\n * are not merged recursively: if a nested property exists in the overrider, it replaces the overridee's value entirely.\n *\n * @param overridee - The object to override.\n * @param overrider - The object to override with.\n * @returns The merged object (using shallow, top-level merge semantics).\n * @example\n * const overridee = { name: 'John' };\n * const overrider = { name: undefined, age: 30 };\n * const merged = safeMerge(overridee, overrider);\n * // merged is { name: 'John', age: 30 }\n */\nexport const safeMerge = <TOverridee extends object, TOverrider extends object>(\n  overridee: TOverridee,\n  overrider: TOverrider,\n): TOverridee & TOverrider => ({\n  ...overridee,\n  ...(Object.fromEntries(\n    Object.entries(overrider).filter(\n      ([_key, value]) =>\n        value !== undefined &&\n        value !== null &&\n        (!value || typeof value !== 'object' || Object.keys(value).length > 0),\n    ),\n  ) as TOverrider),\n});\n"]}

package/dist/utils/sanitize/sanitize.cjs

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeControlCharacters = sanitizeControlCharacters;
+exports.sanitizeUri = sanitizeUri;
+/**
+ * Removes control characters from a string.
+ *
+ * @param input - The string to sanitize.
+ * @returns The sanitized string.
+ */
+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.
+ */
+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.cjs.map