@metamask/snaps-utils 6.1.0 → 7.0.1

package/dist/chunk-5R7UF7KM.mjs

@@ -0,0 +1,21 @@
+// src/handler-types.ts
+var HandlerType = /* @__PURE__ */ ((HandlerType2) => {
+  HandlerType2["OnRpcRequest"] = "onRpcRequest";
+  HandlerType2["OnSignature"] = "onSignature";
+  HandlerType2["OnTransaction"] = "onTransaction";
+  HandlerType2["OnCronjob"] = "onCronjob";
+  HandlerType2["OnInstall"] = "onInstall";
+  HandlerType2["OnUpdate"] = "onUpdate";
+  HandlerType2["OnNameLookup"] = "onNameLookup";
+  HandlerType2["OnKeyringRequest"] = "onKeyringRequest";
+  HandlerType2["OnHomePage"] = "onHomePage";
+  HandlerType2["OnUserInput"] = "onUserInput";
+  return HandlerType2;
+})(HandlerType || {});
+var SNAP_EXPORT_NAMES = Object.values(HandlerType);
+
+export {
+  HandlerType,
+  SNAP_EXPORT_NAMES
+};
+//# sourceMappingURL=chunk-5R7UF7KM.mjs.map

package/dist/chunk-5R7UF7KM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handler-types.ts"],"sourcesContent":["export enum HandlerType {\n  OnRpcRequest = 'onRpcRequest',\n  OnSignature = 'onSignature',\n  OnTransaction = 'onTransaction',\n  OnCronjob = 'onCronjob',\n  OnInstall = 'onInstall',\n  OnUpdate = 'onUpdate',\n  OnNameLookup = 'onNameLookup',\n  OnKeyringRequest = 'onKeyringRequest',\n  OnHomePage = 'onHomePage',\n  OnUserInput = 'onUserInput',\n}\n\nexport type SnapHandler = {\n  /**\n   * The type of handler.\n   */\n  type: HandlerType;\n\n  /**\n   * Whether the handler is required, i.e., whether the request will fail if the\n   * handler is called, but the snap does not export it.\n   *\n   * This is primarily used for the lifecycle handlers, which are optional.\n   */\n  required: boolean;\n\n  /**\n   * Validate the given snap export. This should return a type guard for the\n   * handler type.\n   *\n   * @param snapExport - The export to validate.\n   * @returns Whether the export is valid.\n   */\n  validator: (snapExport: unknown) => boolean;\n};\n\nexport const SNAP_EXPORT_NAMES = Object.values(HandlerType);\n"],"mappings":";AAAO,IAAK,cAAL,kBAAKA,iBAAL;AACL,EAAAA,aAAA,kBAAe;AACf,EAAAA,aAAA,iBAAc;AACd,EAAAA,aAAA,mBAAgB;AAChB,EAAAA,aAAA,eAAY;AACZ,EAAAA,aAAA,eAAY;AACZ,EAAAA,aAAA,cAAW;AACX,EAAAA,aAAA,kBAAe;AACf,EAAAA,aAAA,sBAAmB;AACnB,EAAAA,aAAA,gBAAa;AACb,EAAAA,aAAA,iBAAc;AAVJ,SAAAA;AAAA,GAAA;AAqCL,IAAM,oBAAoB,OAAO,OAAO,WAAW;","names":["HandlerType"]}

package/dist/chunk-63OXILAY.mjs

@@ -0,0 +1,69 @@
+import {
+  DEFAULT_ENDOWMENTS
+} from "./chunk-BGSO2GQC.mjs";
+
+// src/mock.ts
+import crypto from "crypto";
+import EventEmitter from "events";
+var NETWORK_APIS = ["fetch", "Request", "Headers", "Response"];
+var ALL_APIS = [
+  ...DEFAULT_ENDOWMENTS,
+  ...NETWORK_APIS,
+  "WebAssembly"
+];
+function getMockSnapGlobal() {
+  return { request: async () => true };
+}
+function getMockEthereumProvider() {
+  const mockProvider = new EventEmitter();
+  mockProvider.request = async () => true;
+  return mockProvider;
+}
+var isConstructor = (value) => Boolean(typeof value?.prototype?.constructor?.name === "string");
+var mockFunction = () => true;
+var MockClass = class {
+};
+var handler = {
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  construct(Target, args) {
+    return new Proxy(new Target(...args), handler);
+  },
+  get(_target, _prop) {
+    return mockFunction;
+  }
+};
+var generateMockClass = (value) => {
+  return new Proxy(value, handler);
+};
+var mockWindow = {
+  crypto,
+  SubtleCrypto: MockClass
+};
+var generateMockEndowment = (key) => {
+  const globalValue = globalThis[key];
+  if (globalValue && DEFAULT_ENDOWMENTS.includes(key)) {
+    return globalValue;
+  }
+  const globalOrMocked = globalValue ?? mockWindow[key];
+  const type = typeof globalOrMocked;
+  const isFunction = type === "function";
+  if (isFunction && isConstructor(globalOrMocked)) {
+    return generateMockClass(globalOrMocked);
+  } else if (isFunction || !globalOrMocked) {
+    return mockFunction;
+  }
+  return globalOrMocked;
+};
+var generateMockEndowments = () => {
+  return ALL_APIS.reduce(
+    (acc, cur) => ({ ...acc, [cur]: generateMockEndowment(cur) }),
+    { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() }
+  );
+};
+
+export {
+  ALL_APIS,
+  isConstructor,
+  generateMockEndowments
+};
+//# sourceMappingURL=chunk-63OXILAY.mjs.map

package/dist/chunk-63OXILAY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mock.ts"],"sourcesContent":["import crypto from 'crypto';\nimport EventEmitter from 'events';\n\nimport { DEFAULT_ENDOWMENTS } from './default-endowments';\n\nconst NETWORK_APIS = ['fetch', 'Request', 'Headers', 'Response'];\n\nexport const ALL_APIS: string[] = [\n  ...DEFAULT_ENDOWMENTS,\n  ...NETWORK_APIS,\n  'WebAssembly',\n];\n\ntype MockSnapGlobal = {\n  request: () => Promise<any>;\n};\n\ntype MockEthereumProvider = EventEmitter & {\n  request: () => Promise<any>;\n};\n\n/**\n * Get a mock snap API, that always returns `true` for requests.\n *\n * @returns A mocked snap provider.\n */\nfunction getMockSnapGlobal(): MockSnapGlobal {\n  // eslint-disable-next-line @typescript-eslint/require-await\n  return { request: async () => true };\n}\n\n/**\n * Get a mock Ethereum provider, that always returns `true` for requests.\n *\n * @returns A mocked ethereum provider.\n */\nfunction getMockEthereumProvider(): MockEthereumProvider {\n  const mockProvider = new EventEmitter() as Partial<MockEthereumProvider>;\n  // eslint-disable-next-line @typescript-eslint/require-await\n  mockProvider.request = async () => true;\n  return mockProvider as MockEthereumProvider;\n}\n\n/**\n * Check if a value is a constructor.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a constructor, or `false` otherwise.\n */\nexport const isConstructor = (value: any) =>\n  Boolean(typeof value?.prototype?.constructor?.name === 'string');\n\n/**\n * A function that always returns `true`.\n *\n * @returns `true`.\n */\nconst mockFunction = () => true;\nclass MockClass {}\n\nconst handler = {\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  construct(Target: any, args: any[]): any {\n    return new Proxy(new Target(...args), handler);\n  },\n  get(_target: any, _prop: any) {\n    return mockFunction;\n  },\n};\n\n/**\n * Generate a mock class for a given value. The value is wrapped in a Proxy, and\n * all methods are replaced with a mock function.\n *\n * @param value - The value to mock.\n * @returns A mock class.\n */\nconst generateMockClass = (value: any) => {\n  return new Proxy(value, handler);\n};\n\n// Things not currently auto-mocked because of NodeJS, by adding them here we\n// have types for them and can use that to generate mocks if needed.\nconst mockWindow: Record<string, unknown> = {\n  crypto,\n  SubtleCrypto: MockClass,\n};\n\n/**\n * Generate a mock endowment for a certain class or function on the `globalThis`\n * object.\n *\n * @param key - The key to generate the mock endowment for.\n * @returns A mocked class or function. If the key is part of the default\n * endowments, the original value is returned.\n */\nconst generateMockEndowment = (key: string) => {\n  const globalValue = (globalThis as any)[key];\n\n  // Default exposed APIs don't need to be mocked\n  if (globalValue && DEFAULT_ENDOWMENTS.includes(key)) {\n    return globalValue;\n  }\n\n  // Fall back to mockWindow for certain APIs not exposed in global in Node.JS\n  const globalOrMocked = globalValue ?? mockWindow[key];\n\n  const type = typeof globalOrMocked;\n  const isFunction = type === 'function';\n  if (isFunction && isConstructor(globalOrMocked)) {\n    return generateMockClass(globalOrMocked);\n  } else if (isFunction || !globalOrMocked) {\n    // Fall back to function mock for now\n    return mockFunction;\n  }\n  return globalOrMocked;\n};\n\n/**\n * Generate mock endowments for all the APIs as defined in {@link ALL_APIS}.\n *\n * @returns A map of endowments.\n */\nexport const generateMockEndowments = () => {\n  return ALL_APIS.reduce<Record<string, any>>(\n    (acc, cur) => ({ ...acc, [cur]: generateMockEndowment(cur) }),\n    { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() },\n  );\n};\n"],"mappings":";;;;;AAAA,OAAO,YAAY;AACnB,OAAO,kBAAkB;AAIzB,IAAM,eAAe,CAAC,SAAS,WAAW,WAAW,UAAU;AAExD,IAAM,WAAqB;AAAA,EAChC,GAAG;AAAA,EACH,GAAG;AAAA,EACH;AACF;AAeA,SAAS,oBAAoC;AAE3C,SAAO,EAAE,SAAS,YAAY,KAAK;AACrC;AAOA,SAAS,0BAAgD;AACvD,QAAM,eAAe,IAAI,aAAa;AAEtC,eAAa,UAAU,YAAY;AACnC,SAAO;AACT;AAQO,IAAM,gBAAgB,CAAC,UAC5B,QAAQ,OAAO,OAAO,WAAW,aAAa,SAAS,QAAQ;AAOjE,IAAM,eAAe,MAAM;AAC3B,IAAM,YAAN,MAAgB;AAAC;AAEjB,IAAM,UAAU;AAAA;AAAA,EAEd,UAAU,QAAa,MAAkB;AACvC,WAAO,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI,GAAG,OAAO;AAAA,EAC/C;AAAA,EACA,IAAI,SAAc,OAAY;AAC5B,WAAO;AAAA,EACT;AACF;AASA,IAAM,oBAAoB,CAAC,UAAe;AACxC,SAAO,IAAI,MAAM,OAAO,OAAO;AACjC;AAIA,IAAM,aAAsC;AAAA,EAC1C;AAAA,EACA,cAAc;AAChB;AAUA,IAAM,wBAAwB,CAAC,QAAgB;AAC7C,QAAM,cAAe,WAAmB,GAAG;AAG3C,MAAI,eAAe,mBAAmB,SAAS,GAAG,GAAG;AACnD,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,eAAe,WAAW,GAAG;AAEpD,QAAM,OAAO,OAAO;AACpB,QAAM,aAAa,SAAS;AAC5B,MAAI,cAAc,cAAc,cAAc,GAAG;AAC/C,WAAO,kBAAkB,cAAc;AAAA,EACzC,WAAW,cAAc,CAAC,gBAAgB;AAExC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,IAAM,yBAAyB,MAAM;AAC1C,SAAO,SAAS;AAAA,IACd,CAAC,KAAK,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,sBAAsB,GAAG,EAAE;AAAA,IAC3D,EAAE,MAAM,kBAAkB,GAAG,UAAU,wBAAwB,EAAE;AAAA,EACnE;AACF;","names":[]}

package/dist/chunk-6CHO3LOX.mjs

@@ -0,0 +1,10 @@
+// src/json.ts
+import { getSafeJson } from "@metamask/utils";
+function parseJson(json) {
+  return getSafeJson(JSON.parse(json));
+}
+
+export {
+  parseJson
+};
+//# sourceMappingURL=chunk-6CHO3LOX.mjs.map

package/dist/chunk-6CHO3LOX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json.ts"],"sourcesContent":["import type { Json } from '@metamask/utils';\nimport { getSafeJson } from '@metamask/utils';\n\n// TODO: Upstream this to @metamask/utils\n\n/**\n * Parse JSON safely.\n *\n * Does multiple kinds of validation and strips unwanted properties like\n * `__proto__` and `constructor`.\n *\n * @param json - A JSON string to be parsed.\n * @returns The parsed JSON object.\n * @template Type - The type of the JSON object. The type is not actually\n * checked, but it is used to infer the return type.\n */\nexport function parseJson<Type extends Json = Json>(json: string) {\n  return getSafeJson<Type>(JSON.parse(json));\n}\n"],"mappings":";AACA,SAAS,mBAAmB;AAerB,SAAS,UAAoC,MAAc;AAChE,SAAO,YAAkB,KAAK,MAAM,IAAI,CAAC;AAC3C;","names":[]}

package/dist/chunk-6LOYTBS3.js

@@ -0,0 +1,107 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/namespace.ts
+
+
+
+
+
+
+
+
+
+var _superstruct = require('superstruct');
+var CHAIN_ID_REGEX = /^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})$/u;
+var ACCOUNT_ID_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})):(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;
+var ACCOUNT_ADDRESS_REGEX = /^(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;
+function parseChainId(chainId) {
+  const match = CHAIN_ID_REGEX.exec(chainId);
+  if (!match?.groups) {
+    throw new Error("Invalid chain ID.");
+  }
+  return {
+    namespace: match.groups.namespace,
+    reference: match.groups.reference
+  };
+}
+function parseAccountId(accountId) {
+  const match = ACCOUNT_ID_REGEX.exec(accountId);
+  if (!match?.groups) {
+    throw new Error("Invalid account ID.");
+  }
+  return {
+    address: match.groups.accountAddress,
+    chainId: match.groups.chainId,
+    chain: {
+      namespace: match.groups.namespace,
+      reference: match.groups.reference
+    }
+  };
+}
+var LimitedString = _superstruct.size.call(void 0, _superstruct.string.call(void 0, ), 1, 40);
+var ChainIdStringStruct = _superstruct.define.call(void 0, 
+  "Chain ID",
+  _superstruct.string.call(void 0, ).validator
+);
+var ChainIdStruct = _superstruct.pattern.call(void 0, 
+  ChainIdStringStruct,
+  CHAIN_ID_REGEX
+);
+var AccountIdStruct = _superstruct.pattern.call(void 0, _superstruct.string.call(void 0, ), ACCOUNT_ID_REGEX);
+var AccountIdArrayStruct = _superstruct.array.call(void 0, AccountIdStruct);
+var AccountAddressStruct = _superstruct.pattern.call(void 0, _superstruct.string.call(void 0, ), ACCOUNT_ADDRESS_REGEX);
+var ChainStruct = _superstruct.object.call(void 0, {
+  id: ChainIdStruct,
+  name: LimitedString
+});
+var NamespaceStruct = _superstruct.object.call(void 0, {
+  /**
+   * A list of supported chains in the namespace.
+   */
+  chains: _superstruct.array.call(void 0, ChainStruct),
+  /**
+   * A list of supported RPC methods on the namespace, that a DApp can call.
+   */
+  methods: _superstruct.optional.call(void 0, _superstruct.array.call(void 0, LimitedString)),
+  /**
+   * A list of supported RPC events on the namespace, that a DApp can listen to.
+   */
+  events: _superstruct.optional.call(void 0, _superstruct.array.call(void 0, LimitedString))
+});
+var NamespaceIdStruct = _superstruct.pattern.call(void 0, _superstruct.string.call(void 0, ), /^[-a-z0-9]{3,8}$/u);
+function isNamespaceId(value) {
+  return _superstruct.is.call(void 0, value, NamespaceIdStruct);
+}
+function isChainId(value) {
+  return _superstruct.is.call(void 0, value, ChainIdStruct);
+}
+function isAccountId(value) {
+  return _superstruct.is.call(void 0, value, AccountIdStruct);
+}
+function isAccountIdArray(value) {
+  return _superstruct.is.call(void 0, value, AccountIdArrayStruct);
+}
+function isNamespace(value) {
+  return _superstruct.is.call(void 0, value, NamespaceStruct);
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.CHAIN_ID_REGEX = CHAIN_ID_REGEX; exports.ACCOUNT_ID_REGEX = ACCOUNT_ID_REGEX; exports.ACCOUNT_ADDRESS_REGEX = ACCOUNT_ADDRESS_REGEX; exports.parseChainId = parseChainId; exports.parseAccountId = parseAccountId; exports.LimitedString = LimitedString; exports.ChainIdStringStruct = ChainIdStringStruct; exports.ChainIdStruct = ChainIdStruct; exports.AccountIdStruct = AccountIdStruct; exports.AccountIdArrayStruct = AccountIdArrayStruct; exports.AccountAddressStruct = AccountAddressStruct; exports.ChainStruct = ChainStruct; exports.NamespaceStruct = NamespaceStruct; exports.NamespaceIdStruct = NamespaceIdStruct; exports.isNamespaceId = isNamespaceId; exports.isChainId = isChainId; exports.isAccountId = isAccountId; exports.isAccountIdArray = isAccountIdArray; exports.isNamespace = isNamespace;
+//# sourceMappingURL=chunk-6LOYTBS3.js.map

package/dist/chunk-6LOYTBS3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/namespace.ts"],"names":[],"mappings":";AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIA,IAAM,iBACX;AAEK,IAAM,mBACX;AAEK,IAAM,wBAAwB;AAS9B,SAAS,aAAa,SAG3B;AACA,QAAM,QAAQ,eAAe,KAAK,OAAO;AACzC,MAAI,CAAC,OAAO,QAAQ;AAClB,UAAM,IAAI,MAAM,mBAAmB;AAAA,EACrC;AAEA,SAAO;AAAA,IACL,WAAW,MAAM,OAAO;AAAA,IACxB,WAAW,MAAM,OAAO;AAAA,EAC1B;AACF;AASO,SAAS,eAAe,WAI7B;AACA,QAAM,QAAQ,iBAAiB,KAAK,SAAS;AAC7C,MAAI,CAAC,OAAO,QAAQ;AAClB,UAAM,IAAI,MAAM,qBAAqB;AAAA,EACvC;AAEA,SAAO;AAAA,IACL,SAAS,MAAM,OAAO;AAAA,IACtB,SAAS,MAAM,OAAO;AAAA,IACtB,OAAO;AAAA,MACL,WAAW,MAAM,OAAO;AAAA,MACxB,WAAW,MAAM,OAAO;AAAA,IAC1B;AAAA,EACF;AACF;AAMO,IAAM,gBAAgB,KAAK,OAAO,GAAG,GAAG,EAAE;AAE1C,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA,OAAO,EAAE;AACX;AAKO,IAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF;AAIO,IAAM,kBAAkB,QAAQ,OAAO,GAAG,gBAAgB;AAE1D,IAAM,uBAAuB,MAAM,eAAe;AAClD,IAAM,uBAAuB,QAAQ,OAAO,GAAG,qBAAqB;AAMpE,IAAM,cAAc,OAAO;AAAA,EAChC,IAAI;AAAA,EACJ,MAAM;AACR,CAAC;AAGM,IAAM,kBAAkB,OAAO;AAAA;AAAA;AAAA;AAAA,EAIpC,QAAQ,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAKzB,SAAS,SAAS,MAAM,aAAa,CAAC;AAAA;AAAA;AAAA;AAAA,EAKtC,QAAQ,SAAS,MAAM,aAAa,CAAC;AACvC,CAAC;AAMM,IAAM,oBAAoB,QAAQ,OAAO,GAAG,mBAAmB;AAS/D,SAAS,cAAc,OAAsC;AAClE,SAAO,GAAG,OAAO,iBAAiB;AACpC;AAQO,SAAS,UAAU,OAAkC;AAC1D,SAAO,GAAG,OAAO,aAAa;AAChC;AAQO,SAAS,YAAY,OAAoC;AAC9D,SAAO,GAAG,OAAO,eAAe;AAClC;AAQO,SAAS,iBAAiB,OAAsC;AACrE,SAAO,GAAG,OAAO,oBAAoB;AACvC;AAQO,SAAS,YAAY,OAAoC;AAC9D,SAAO,GAAG,OAAO,eAAe;AAClC","sourcesContent":["import type { AccountId, ChainId } from '@metamask/snaps-sdk';\nimport type { Infer } from 'superstruct';\nimport {\n  array,\n  define,\n  is,\n  object,\n  optional,\n  pattern,\n  size,\n  string,\n} from 'superstruct';\n\nimport type { InferMatching } from './structs';\n\nexport const CHAIN_ID_REGEX =\n  /^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})$/u;\n\nexport const ACCOUNT_ID_REGEX =\n  /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})):(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;\n\nexport const ACCOUNT_ADDRESS_REGEX = /^(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;\n\n/**\n * Parse a chain ID string to an object containing the namespace and reference.\n * This validates the chain ID before parsing it.\n *\n * @param chainId - The chain ID to validate and parse.\n * @returns The parsed chain ID.\n */\nexport function parseChainId(chainId: ChainId): {\n  namespace: NamespaceId;\n  reference: string;\n} {\n  const match = CHAIN_ID_REGEX.exec(chainId);\n  if (!match?.groups) {\n    throw new Error('Invalid chain ID.');\n  }\n\n  return {\n    namespace: match.groups.namespace,\n    reference: match.groups.reference,\n  };\n}\n\n/**\n * Parse an account ID to an object containing the chain, chain ID and address.\n * This validates the account ID before parsing it.\n *\n * @param accountId - The account ID to validate and parse.\n * @returns The parsed account ID.\n */\nexport function parseAccountId(accountId: AccountId): {\n  chain: { namespace: NamespaceId; reference: string };\n  chainId: ChainId;\n  address: string;\n} {\n  const match = ACCOUNT_ID_REGEX.exec(accountId);\n  if (!match?.groups) {\n    throw new Error('Invalid account ID.');\n  }\n\n  return {\n    address: match.groups.accountAddress,\n    chainId: match.groups.chainId as ChainId,\n    chain: {\n      namespace: match.groups.namespace,\n      reference: match.groups.reference,\n    },\n  };\n}\n\n/**\n * A helper struct for a string with a minimum length of 1 and a maximum length\n * of 40.\n */\nexport const LimitedString = size(string(), 1, 40);\n\nexport const ChainIdStringStruct = define<ChainId>(\n  'Chain ID',\n  string().validator,\n);\n\n/**\n * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.\n */\nexport const ChainIdStruct = pattern<ChainId, null>(\n  ChainIdStringStruct,\n  CHAIN_ID_REGEX,\n);\n\nexport type Caip2ChainId = InferMatching<typeof ChainIdStruct, ChainId>;\n\nexport const AccountIdStruct = pattern(string(), ACCOUNT_ID_REGEX);\n\nexport const AccountIdArrayStruct = array(AccountIdStruct);\nexport const AccountAddressStruct = pattern(string(), ACCOUNT_ADDRESS_REGEX);\nexport type AccountAddress = Infer<typeof AccountAddressStruct>;\n\n/**\n * A chain descriptor.\n */\nexport const ChainStruct = object({\n  id: ChainIdStruct,\n  name: LimitedString,\n});\nexport type Chain = Infer<typeof ChainStruct>;\n\nexport const NamespaceStruct = object({\n  /**\n   * A list of supported chains in the namespace.\n   */\n  chains: array(ChainStruct),\n\n  /**\n   * A list of supported RPC methods on the namespace, that a DApp can call.\n   */\n  methods: optional(array(LimitedString)),\n\n  /**\n   * A list of supported RPC events on the namespace, that a DApp can listen to.\n   */\n  events: optional(array(LimitedString)),\n});\nexport type Namespace = Infer<typeof NamespaceStruct>;\n\n/**\n * A CAIP-2 namespace, i.e., the first part of a chain ID.\n */\nexport const NamespaceIdStruct = pattern(string(), /^[-a-z0-9]{3,8}$/u);\nexport type NamespaceId = Infer<typeof NamespaceIdStruct>;\n\n/**\n * Check if the given value is a CAIP-2 namespace ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-2 namespace ID.\n */\nexport function isNamespaceId(value: unknown): value is NamespaceId {\n  return is(value, NamespaceIdStruct);\n}\n\n/**\n * Check if the given value is a CAIP-2 chain ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-2 chain ID.\n */\nexport function isChainId(value: unknown): value is ChainId {\n  return is(value, ChainIdStruct);\n}\n\n/**\n * Check if the given value is a CAIP-10 account ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-10 account ID.\n */\nexport function isAccountId(value: unknown): value is AccountId {\n  return is(value, AccountIdStruct);\n}\n\n/**\n * Check if the given value is an array of CAIP-10 account IDs.\n *\n * @param value - The value to check.\n * @returns Whether the value is an array of CAIP-10 account IDs.\n */\nexport function isAccountIdArray(value: unknown): value is AccountId[] {\n  return is(value, AccountIdArrayStruct);\n}\n\n/**\n * Check if a value is a {@link Namespace}.\n *\n * @param value - The value to validate.\n * @returns True if the value is a valid {@link Namespace}.\n */\nexport function isNamespace(value: unknown): value is Namespace {\n  return is(value, NamespaceStruct);\n}\n"]}

package/dist/chunk-6YRUDGNL.mjs

@@ -0,0 +1,18 @@
+import {
+  VirtualFile
+} from "./chunk-ZJRWU4AJ.mjs";
+
+// src/bytes.ts
+import { stringToBytes } from "@metamask/utils";
+function getBytes(bytes) {
+  const unwrapped = bytes instanceof VirtualFile ? bytes.value : bytes;
+  if (typeof unwrapped === "string") {
+    return stringToBytes(unwrapped);
+  }
+  return unwrapped;
+}
+
+export {
+  getBytes
+};
+//# sourceMappingURL=chunk-6YRUDGNL.mjs.map

package/dist/chunk-6YRUDGNL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bytes.ts"],"sourcesContent":["import { stringToBytes } from '@metamask/utils';\n\nimport { VirtualFile } from './virtual-file/VirtualFile';\n\n/**\n * Convert a bytes-like input value to a Uint8Array.\n *\n * @param bytes - A bytes-like value.\n * @returns The input value converted to a Uint8Array if necessary.\n */\nexport function getBytes(bytes: VirtualFile | Uint8Array | string): Uint8Array {\n  // Unwrap VirtualFiles to extract the content\n  // The content is then either a string or Uint8Array\n  const unwrapped = bytes instanceof VirtualFile ? bytes.value : bytes;\n\n  if (typeof unwrapped === 'string') {\n    return stringToBytes(unwrapped);\n  }\n\n  return unwrapped;\n}\n"],"mappings":";;;;;AAAA,SAAS,qBAAqB;AAUvB,SAAS,SAAS,OAAsD;AAG7E,QAAM,YAAY,iBAAiB,cAAc,MAAM,QAAQ;AAE/D,MAAI,OAAO,cAAc,UAAU;AACjC,WAAO,cAAc,SAAS;AAAA,EAChC;AAEA,SAAO;AACT;","names":[]}

package/dist/chunk-772OPTGX.js

@@ -0,0 +1,70 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/ui.ts
+var _snapssdk = require('@metamask/snaps-sdk');
+var _utils = require('@metamask/utils');
+var MARKDOWN_LINK_REGEX = /\[(?<name>[^\]]*)\]\((?<url>[^)]+)\)/giu;
+var ALLOWED_PROTOCOLS = ["https:", "mailto:"];
+function validateTextLinks(text, isOnPhishingList) {
+  const matches = String.prototype.matchAll.call(text, MARKDOWN_LINK_REGEX);
+  for (const { groups } of matches) {
+    const link = groups?.url;
+    if (!link) {
+      continue;
+    }
+    try {
+      const url = new URL(link);
+      _utils.assert.call(void 0, 
+        ALLOWED_PROTOCOLS.includes(url.protocol),
+        `Protocol must be one of: ${ALLOWED_PROTOCOLS.join(", ")}.`
+      );
+      const hostname = url.protocol === "mailto:" ? url.pathname.split("@")[1] : url.hostname;
+      _utils.assert.call(void 0, !isOnPhishingList(hostname), "The specified URL is not allowed.");
+    } catch (error) {
+      throw new Error(
+        `Invalid URL: ${error instanceof _utils.AssertionError ? error.message : "Unable to parse URL."}`
+      );
+    }
+  }
+}
+function validateComponentLinks(component, isOnPhishingList) {
+  const { type } = component;
+  switch (type) {
+    case _snapssdk.NodeType.Panel:
+      component.children.forEach(
+        (node) => validateComponentLinks(node, isOnPhishingList)
+      );
+      break;
+    case _snapssdk.NodeType.Row:
+      validateComponentLinks(component.value, isOnPhishingList);
+      break;
+    case _snapssdk.NodeType.Text:
+      validateTextLinks(component.value, isOnPhishingList);
+      break;
+    default:
+      break;
+  }
+}
+function getTotalTextLength(component) {
+  const { type } = component;
+  switch (type) {
+    case _snapssdk.NodeType.Panel:
+      return component.children.reduce(
+        // This is a bug in TypeScript: https://github.com/microsoft/TypeScript/issues/48313
+        // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
+        (sum, node) => sum + getTotalTextLength(node),
+        0
+      );
+    case _snapssdk.NodeType.Row:
+      return getTotalTextLength(component.value);
+    case _snapssdk.NodeType.Text:
+      return component.value.length;
+    default:
+      return 0;
+  }
+}
+
+
+
+
+
+exports.validateTextLinks = validateTextLinks; exports.validateComponentLinks = validateComponentLinks; exports.getTotalTextLength = getTotalTextLength;
+//# sourceMappingURL=chunk-772OPTGX.js.map

package/dist/chunk-772OPTGX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui.ts"],"names":[],"mappings":";AACA,SAAS,gBAAgB;AACzB,SAAS,QAAQ,sBAAsB;AAEvC,IAAM,sBAAsB;AAE5B,IAAM,oBAAoB,CAAC,UAAU,SAAS;AAUvC,SAAS,kBACd,MACA,kBACA;AACA,QAAM,UAAU,OAAO,UAAU,SAAS,KAAK,MAAM,mBAAmB;AAExE,aAAW,EAAE,OAAO,KAAK,SAAS;AAChC,UAAM,OAAO,QAAQ;AAIrB,QAAI,CAAC,MAAM;AACT;AAAA,IACF;AAEA,QAAI;AACF,YAAM,MAAM,IAAI,IAAI,IAAI;AACxB;AAAA,QACE,kBAAkB,SAAS,IAAI,QAAQ;AAAA,QACvC,4BAA4B,kBAAkB,KAAK,IAAI,CAAC;AAAA,MAC1D;AAEA,YAAM,WACJ,IAAI,aAAa,YAAY,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC,IAAI,IAAI;AAEhE,aAAO,CAAC,iBAAiB,QAAQ,GAAG,mCAAmC;AAAA,IACzE,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,gBACE,iBAAiB,iBACb,MAAM,UACN,sBACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAWO,SAAS,uBACd,WACA,kBACA;AACA,QAAM,EAAE,KAAK,IAAI;AACjB,UAAQ,MAAM;AAAA,IACZ,KAAK,SAAS;AACZ,gBAAU,SAAS;AAAA,QAAQ,CAAC,SAC1B,uBAAuB,MAAM,gBAAgB;AAAA,MAC/C;AACA;AAAA,IACF,KAAK,SAAS;AACZ,6BAAuB,UAAU,OAAO,gBAAgB;AACxD;AAAA,IACF,KAAK,SAAS;AACZ,wBAAkB,UAAU,OAAO,gBAAgB;AACnD;AAAA,IACF;AACE;AAAA,EACJ;AACF;AAQO,SAAS,mBAAmB,WAA8B;AAC/D,QAAM,EAAE,KAAK,IAAI;AAEjB,UAAQ,MAAM;AAAA,IACZ,KAAK,SAAS;AACZ,aAAO,UAAU,SAAS;AAAA;AAAA;AAAA,QAGxB,CAAC,KAAK,SAAS,MAAM,mBAAmB,IAAI;AAAA,QAC5C;AAAA,MACF;AAAA,IACF,KAAK,SAAS;AACZ,aAAO,mBAAmB,UAAU,KAAK;AAAA,IAC3C,KAAK,SAAS;AACZ,aAAO,UAAU,MAAM;AAAA,IACzB;AACE,aAAO;AAAA,EACX;AACF","sourcesContent":["import type { Component } from '@metamask/snaps-sdk';\nimport { NodeType } from '@metamask/snaps-sdk';\nimport { assert, AssertionError } from '@metamask/utils';\n\nconst MARKDOWN_LINK_REGEX = /\\[(?<name>[^\\]]*)\\]\\((?<url>[^)]+)\\)/giu;\n\nconst ALLOWED_PROTOCOLS = ['https:', 'mailto:'];\n\n/**\n * Searches for markdown links in a string and checks them against the phishing list.\n *\n * @param text - The text to verify.\n * @param isOnPhishingList - The function that checks the link against the\n * phishing list.\n * @throws If the text contains a link that is not allowed.\n */\nexport function validateTextLinks(\n  text: string,\n  isOnPhishingList: (url: string) => boolean,\n) {\n  const matches = String.prototype.matchAll.call(text, MARKDOWN_LINK_REGEX);\n\n  for (const { groups } of matches) {\n    const link = groups?.url;\n\n    /* This case should never happen with the regex but the TS type allows for undefined */\n    /* istanbul ignore next */\n    if (!link) {\n      continue;\n    }\n\n    try {\n      const url = new URL(link);\n      assert(\n        ALLOWED_PROTOCOLS.includes(url.protocol),\n        `Protocol must be one of: ${ALLOWED_PROTOCOLS.join(', ')}.`,\n      );\n\n      const hostname =\n        url.protocol === 'mailto:' ? url.pathname.split('@')[1] : url.hostname;\n\n      assert(!isOnPhishingList(hostname), 'The specified URL is not allowed.');\n    } catch (error) {\n      throw new Error(\n        `Invalid URL: ${\n          error instanceof AssertionError\n            ? error.message\n            : 'Unable to parse URL.'\n        }`,\n      );\n    }\n  }\n}\n\n/**\n * Search for links in UI components and check that the URL they are trying to\n * pass in is not in the phishing list.\n *\n * @param component - The custom UI component.\n * @param isOnPhishingList - The function that checks the link against the\n * phishing list.\n * @throws If the component contains a link that is not allowed.\n */\nexport function validateComponentLinks(\n  component: Component,\n  isOnPhishingList: (url: string) => boolean,\n) {\n  const { type } = component;\n  switch (type) {\n    case NodeType.Panel:\n      component.children.forEach((node) =>\n        validateComponentLinks(node, isOnPhishingList),\n      );\n      break;\n    case NodeType.Row:\n      validateComponentLinks(component.value, isOnPhishingList);\n      break;\n    case NodeType.Text:\n      validateTextLinks(component.value, isOnPhishingList);\n      break;\n    default:\n      break;\n  }\n}\n\n/**\n * Calculate the total length of all text in the component.\n *\n * @param component - A custom UI component.\n * @returns The total length of all text components in the component.\n */\nexport function getTotalTextLength(component: Component): number {\n  const { type } = component;\n\n  switch (type) {\n    case NodeType.Panel:\n      return component.children.reduce<number>(\n        // This is a bug in TypeScript: https://github.com/microsoft/TypeScript/issues/48313\n        // eslint-disable-next-line @typescript-eslint/restrict-plus-operands\n        (sum, node) => sum + getTotalTextLength(node),\n        0,\n      );\n    case NodeType.Row:\n      return getTotalTextLength(component.value);\n    case NodeType.Text:\n      return component.value.length;\n    default:\n      return 0;\n  }\n}\n"]}

package/dist/chunk-7LG4D4XA.mjs

@@ -0,0 +1,20 @@
+// src/caveats.ts
+var SnapCaveatType = /* @__PURE__ */ ((SnapCaveatType2) => {
+  SnapCaveatType2["PermittedDerivationPaths"] = "permittedDerivationPaths";
+  SnapCaveatType2["PermittedCoinTypes"] = "permittedCoinTypes";
+  SnapCaveatType2["SnapCronjob"] = "snapCronjob";
+  SnapCaveatType2["TransactionOrigin"] = "transactionOrigin";
+  SnapCaveatType2["SignatureOrigin"] = "signatureOrigin";
+  SnapCaveatType2["RpcOrigin"] = "rpcOrigin";
+  SnapCaveatType2["KeyringOrigin"] = "keyringOrigin";
+  SnapCaveatType2["SnapIds"] = "snapIds";
+  SnapCaveatType2["ChainIds"] = "chainIds";
+  SnapCaveatType2["LookupMatchers"] = "lookupMatchers";
+  SnapCaveatType2["MaxRequestTime"] = "maxRequestTime";
+  return SnapCaveatType2;
+})(SnapCaveatType || {});
+
+export {
+  SnapCaveatType
+};
+//# sourceMappingURL=chunk-7LG4D4XA.mjs.map

package/dist/chunk-7LG4D4XA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/caveats.ts"],"sourcesContent":["export enum SnapCaveatType {\n  /**\n   * Permitted derivation paths, used by `snap_getBip32Entropy`.\n   */\n  PermittedDerivationPaths = 'permittedDerivationPaths',\n\n  /**\n   * Permitted coin types, used by `snap_getBip44Entropy`.\n   */\n  PermittedCoinTypes = 'permittedCoinTypes',\n\n  /**\n   * Caveat specifying a snap cronjob.\n   */\n  SnapCronjob = 'snapCronjob',\n\n  /**\n   * Caveat specifying access to the transaction origin, used by `endowment:transaction-insight`.\n   */\n  TransactionOrigin = 'transactionOrigin',\n\n  /**\n   * Caveat specifying access to the signature origin, used by `endowment:signature-insight`.\n   */\n  SignatureOrigin = 'signatureOrigin',\n\n  /**\n   * The origins that a Snap can receive JSON-RPC messages from.\n   */\n  RpcOrigin = 'rpcOrigin',\n\n  /**\n   * The origins that a Snap can receive keyring messages from.\n   */\n  KeyringOrigin = 'keyringOrigin',\n\n  /**\n   * Caveat specifying the snap IDs that can be interacted with.\n   */\n  SnapIds = 'snapIds',\n\n  /**\n   * Caveat specifying the CAIP-2 chain IDs that a snap can service, currently limited to `endowment:name-lookup`.\n   */\n  ChainIds = 'chainIds',\n\n  /**\n   * Caveat specifying the input that a name lookup snap can service, currently limited to `endowment:name-lookup`.\n   */\n  LookupMatchers = 'lookupMatchers',\n\n  /**\n   * Caveat specifying the max request time for a handler endowment.\n   */\n  MaxRequestTime = 'maxRequestTime',\n}\n"],"mappings":";AAAO,IAAK,iBAAL,kBAAKA,oBAAL;AAIL,EAAAA,gBAAA,8BAA2B;AAK3B,EAAAA,gBAAA,wBAAqB;AAKrB,EAAAA,gBAAA,iBAAc;AAKd,EAAAA,gBAAA,uBAAoB;AAKpB,EAAAA,gBAAA,qBAAkB;AAKlB,EAAAA,gBAAA,eAAY;AAKZ,EAAAA,gBAAA,mBAAgB;AAKhB,EAAAA,gBAAA,aAAU;AAKV,EAAAA,gBAAA,cAAW;AAKX,EAAAA,gBAAA,oBAAiB;AAKjB,EAAAA,gBAAA,oBAAiB;AAtDP,SAAAA;AAAA,GAAA;","names":["SnapCaveatType"]}

package/dist/chunk-7LOABHVW.js

@@ -0,0 +1 @@
+"use strict";//# sourceMappingURL=chunk-7LOABHVW.js.map

package/dist/chunk-7LOABHVW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":""}

package/dist/chunk-7MTAHOWC.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-7MTAHOWC.mjs.map

package/dist/chunk-7MTAHOWC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-7P62OIGX.js

@@ -0,0 +1,69 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+var _chunkN722KRZWjs = require('./chunk-N722KRZW.js');
+
+// src/mock.ts
+var _crypto = require('crypto'); var _crypto2 = _interopRequireDefault(_crypto);
+var _events = require('events'); var _events2 = _interopRequireDefault(_events);
+var NETWORK_APIS = ["fetch", "Request", "Headers", "Response"];
+var ALL_APIS = [
+  ..._chunkN722KRZWjs.DEFAULT_ENDOWMENTS,
+  ...NETWORK_APIS,
+  "WebAssembly"
+];
+function getMockSnapGlobal() {
+  return { request: async () => true };
+}
+function getMockEthereumProvider() {
+  const mockProvider = new (0, _events2.default)();
+  mockProvider.request = async () => true;
+  return mockProvider;
+}
+var isConstructor = (value) => Boolean(typeof value?.prototype?.constructor?.name === "string");
+var mockFunction = () => true;
+var MockClass = class {
+};
+var handler = {
+  // eslint-disable-next-line @typescript-eslint/naming-convention
+  construct(Target, args) {
+    return new Proxy(new Target(...args), handler);
+  },
+  get(_target, _prop) {
+    return mockFunction;
+  }
+};
+var generateMockClass = (value) => {
+  return new Proxy(value, handler);
+};
+var mockWindow = {
+  crypto: _crypto2.default,
+  SubtleCrypto: MockClass
+};
+var generateMockEndowment = (key) => {
+  const globalValue = globalThis[key];
+  if (globalValue && _chunkN722KRZWjs.DEFAULT_ENDOWMENTS.includes(key)) {
+    return globalValue;
+  }
+  const globalOrMocked = globalValue ?? mockWindow[key];
+  const type = typeof globalOrMocked;
+  const isFunction = type === "function";
+  if (isFunction && isConstructor(globalOrMocked)) {
+    return generateMockClass(globalOrMocked);
+  } else if (isFunction || !globalOrMocked) {
+    return mockFunction;
+  }
+  return globalOrMocked;
+};
+var generateMockEndowments = () => {
+  return ALL_APIS.reduce(
+    (acc, cur) => ({ ...acc, [cur]: generateMockEndowment(cur) }),
+    { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() }
+  );
+};
+
+
+
+
+
+exports.ALL_APIS = ALL_APIS; exports.isConstructor = isConstructor; exports.generateMockEndowments = generateMockEndowments;
+//# sourceMappingURL=chunk-7P62OIGX.js.map

package/dist/chunk-7P62OIGX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mock.ts"],"names":[],"mappings":";;;;;AAAA,OAAO,YAAY;AACnB,OAAO,kBAAkB;AAIzB,IAAM,eAAe,CAAC,SAAS,WAAW,WAAW,UAAU;AAExD,IAAM,WAAqB;AAAA,EAChC,GAAG;AAAA,EACH,GAAG;AAAA,EACH;AACF;AAeA,SAAS,oBAAoC;AAE3C,SAAO,EAAE,SAAS,YAAY,KAAK;AACrC;AAOA,SAAS,0BAAgD;AACvD,QAAM,eAAe,IAAI,aAAa;AAEtC,eAAa,UAAU,YAAY;AACnC,SAAO;AACT;AAQO,IAAM,gBAAgB,CAAC,UAC5B,QAAQ,OAAO,OAAO,WAAW,aAAa,SAAS,QAAQ;AAOjE,IAAM,eAAe,MAAM;AAC3B,IAAM,YAAN,MAAgB;AAAC;AAEjB,IAAM,UAAU;AAAA;AAAA,EAEd,UAAU,QAAa,MAAkB;AACvC,WAAO,IAAI,MAAM,IAAI,OAAO,GAAG,IAAI,GAAG,OAAO;AAAA,EAC/C;AAAA,EACA,IAAI,SAAc,OAAY;AAC5B,WAAO;AAAA,EACT;AACF;AASA,IAAM,oBAAoB,CAAC,UAAe;AACxC,SAAO,IAAI,MAAM,OAAO,OAAO;AACjC;AAIA,IAAM,aAAsC;AAAA,EAC1C;AAAA,EACA,cAAc;AAChB;AAUA,IAAM,wBAAwB,CAAC,QAAgB;AAC7C,QAAM,cAAe,WAAmB,GAAG;AAG3C,MAAI,eAAe,mBAAmB,SAAS,GAAG,GAAG;AACnD,WAAO;AAAA,EACT;AAGA,QAAM,iBAAiB,eAAe,WAAW,GAAG;AAEpD,QAAM,OAAO,OAAO;AACpB,QAAM,aAAa,SAAS;AAC5B,MAAI,cAAc,cAAc,cAAc,GAAG;AAC/C,WAAO,kBAAkB,cAAc;AAAA,EACzC,WAAW,cAAc,CAAC,gBAAgB;AAExC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,IAAM,yBAAyB,MAAM;AAC1C,SAAO,SAAS;AAAA,IACd,CAAC,KAAK,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,sBAAsB,GAAG,EAAE;AAAA,IAC3D,EAAE,MAAM,kBAAkB,GAAG,UAAU,wBAAwB,EAAE;AAAA,EACnE;AACF","sourcesContent":["import crypto from 'crypto';\nimport EventEmitter from 'events';\n\nimport { DEFAULT_ENDOWMENTS } from './default-endowments';\n\nconst NETWORK_APIS = ['fetch', 'Request', 'Headers', 'Response'];\n\nexport const ALL_APIS: string[] = [\n  ...DEFAULT_ENDOWMENTS,\n  ...NETWORK_APIS,\n  'WebAssembly',\n];\n\ntype MockSnapGlobal = {\n  request: () => Promise<any>;\n};\n\ntype MockEthereumProvider = EventEmitter & {\n  request: () => Promise<any>;\n};\n\n/**\n * Get a mock snap API, that always returns `true` for requests.\n *\n * @returns A mocked snap provider.\n */\nfunction getMockSnapGlobal(): MockSnapGlobal {\n  // eslint-disable-next-line @typescript-eslint/require-await\n  return { request: async () => true };\n}\n\n/**\n * Get a mock Ethereum provider, that always returns `true` for requests.\n *\n * @returns A mocked ethereum provider.\n */\nfunction getMockEthereumProvider(): MockEthereumProvider {\n  const mockProvider = new EventEmitter() as Partial<MockEthereumProvider>;\n  // eslint-disable-next-line @typescript-eslint/require-await\n  mockProvider.request = async () => true;\n  return mockProvider as MockEthereumProvider;\n}\n\n/**\n * Check if a value is a constructor.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a constructor, or `false` otherwise.\n */\nexport const isConstructor = (value: any) =>\n  Boolean(typeof value?.prototype?.constructor?.name === 'string');\n\n/**\n * A function that always returns `true`.\n *\n * @returns `true`.\n */\nconst mockFunction = () => true;\nclass MockClass {}\n\nconst handler = {\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  construct(Target: any, args: any[]): any {\n    return new Proxy(new Target(...args), handler);\n  },\n  get(_target: any, _prop: any) {\n    return mockFunction;\n  },\n};\n\n/**\n * Generate a mock class for a given value. The value is wrapped in a Proxy, and\n * all methods are replaced with a mock function.\n *\n * @param value - The value to mock.\n * @returns A mock class.\n */\nconst generateMockClass = (value: any) => {\n  return new Proxy(value, handler);\n};\n\n// Things not currently auto-mocked because of NodeJS, by adding them here we\n// have types for them and can use that to generate mocks if needed.\nconst mockWindow: Record<string, unknown> = {\n  crypto,\n  SubtleCrypto: MockClass,\n};\n\n/**\n * Generate a mock endowment for a certain class or function on the `globalThis`\n * object.\n *\n * @param key - The key to generate the mock endowment for.\n * @returns A mocked class or function. If the key is part of the default\n * endowments, the original value is returned.\n */\nconst generateMockEndowment = (key: string) => {\n  const globalValue = (globalThis as any)[key];\n\n  // Default exposed APIs don't need to be mocked\n  if (globalValue && DEFAULT_ENDOWMENTS.includes(key)) {\n    return globalValue;\n  }\n\n  // Fall back to mockWindow for certain APIs not exposed in global in Node.JS\n  const globalOrMocked = globalValue ?? mockWindow[key];\n\n  const type = typeof globalOrMocked;\n  const isFunction = type === 'function';\n  if (isFunction && isConstructor(globalOrMocked)) {\n    return generateMockClass(globalOrMocked);\n  } else if (isFunction || !globalOrMocked) {\n    // Fall back to function mock for now\n    return mockFunction;\n  }\n  return globalOrMocked;\n};\n\n/**\n * Generate mock endowments for all the APIs as defined in {@link ALL_APIS}.\n *\n * @returns A map of endowments.\n */\nexport const generateMockEndowments = () => {\n  return ALL_APIS.reduce<Record<string, any>>(\n    (acc, cur) => ({ ...acc, [cur]: generateMockEndowment(cur) }),\n    { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() },\n  );\n};\n"]}

package/dist/chunk-7Y3WSN44.mjs

@@ -0,0 +1,103 @@
+import {
+  readVirtualFile
+} from "./chunk-IGMAXVPP.mjs";
+import {
+  parseJson
+} from "./chunk-6CHO3LOX.mjs";
+
+// src/fs.ts
+import { promises as fs } from "fs";
+import os from "os";
+import pathUtils from "path";
+async function isDirectory(pathString, createDir) {
+  try {
+    const stats = await fs.stat(pathString);
+    return stats.isDirectory();
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      if (!createDir) {
+        return false;
+      }
+      await fs.mkdir(pathString, { recursive: true });
+      return true;
+    }
+    return false;
+  }
+}
+async function isFile(pathString) {
+  try {
+    const stats = await fs.stat(pathString);
+    return stats.isFile();
+  } catch (error) {
+    return false;
+  }
+}
+async function readJsonFile(pathString) {
+  if (!pathString.endsWith(".json")) {
+    throw new Error('The specified file must be a ".json" file.');
+  }
+  let file;
+  try {
+    file = await readVirtualFile(pathString, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      throw new Error(
+        `Could not find '${pathString}'. Please ensure that the file exists.`
+      );
+    }
+    throw error;
+  }
+  file.result = parseJson(file.toString());
+  return file;
+}
+function getOutfilePath(outDir, outFileName) {
+  return pathUtils.join(outDir, outFileName || "bundle.js");
+}
+function validateOutfileName(filename) {
+  if (!filename.endsWith(".js") || filename === ".js" || pathUtils.basename(filename) !== filename) {
+    throw new Error(`Invalid outfile name: ${filename}. Must be a .js file`);
+  }
+  return true;
+}
+async function validateFilePath(filePath) {
+  const exists = await isFile(filePath);
+  if (!exists) {
+    throw new Error(
+      `Invalid params: '${filePath}' is not a file or does not exist.`
+    );
+  }
+  return true;
+}
+async function validateDirPath(dirPath, createDir) {
+  const exists = await isDirectory(dirPath, createDir);
+  if (!exists) {
+    throw new Error(
+      `Invalid params: '${dirPath}' is not a directory or could not be created.`
+    );
+  }
+  return true;
+}
+async function useTemporaryFile(fileName, fileContents, fn) {
+  const filePath = pathUtils.join(os.tmpdir(), fileName);
+  await fs.mkdir(pathUtils.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, fileContents);
+  try {
+    await fn(filePath);
+  } finally {
+    if (await isFile(filePath)) {
+      await fs.unlink(filePath);
+    }
+  }
+}
+
+export {
+  isDirectory,
+  isFile,
+  readJsonFile,
+  getOutfilePath,
+  validateOutfileName,
+  validateFilePath,
+  validateDirPath,
+  useTemporaryFile
+};
+//# sourceMappingURL=chunk-7Y3WSN44.mjs.map

package/dist/chunk-7Y3WSN44.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fs.ts"],"sourcesContent":["import type { Json } from '@metamask/utils';\nimport { promises as fs } from 'fs';\nimport os from 'os';\nimport pathUtils from 'path';\n\nimport { parseJson } from './json';\nimport type { VirtualFile } from './virtual-file';\nimport { readVirtualFile } from './virtual-file/node';\n\n/**\n * Checks whether the given path string resolves to an existing directory, and\n * optionally creates the directory if it doesn't exist.\n *\n * @param pathString - The path string to check.\n * @param createDir - Whether to create the directory if it doesn't exist.\n * @returns Whether the given path is an existing directory.\n */\nexport async function isDirectory(\n  pathString: string,\n  createDir: boolean,\n): Promise<boolean> {\n  try {\n    const stats = await fs.stat(pathString);\n    return stats.isDirectory();\n  } catch (error) {\n    if (error.code === 'ENOENT') {\n      if (!createDir) {\n        return false;\n      }\n\n      await fs.mkdir(pathString, { recursive: true });\n      return true;\n    }\n\n    return false;\n  }\n}\n\n/**\n * Checks whether the given path string resolves to an existing file.\n *\n * @param pathString - The path string to check.\n * @returns Whether the given path is an existing file.\n */\nexport async function isFile(pathString: string): Promise<boolean> {\n  try {\n    const stats = await fs.stat(pathString);\n    return stats.isFile();\n  } catch (error) {\n    return false;\n  }\n}\n\n/**\n * Reads a `.json` file, parses its contents, and returns them.\n *\n * @param pathString - The path to the JSON file.\n * @returns The parsed contents of the JSON file.\n */\nexport async function readJsonFile<Type extends Json = Json>(\n  pathString: string,\n): Promise<VirtualFile<Type>> {\n  if (!pathString.endsWith('.json')) {\n    throw new Error('The specified file must be a \".json\" file.');\n  }\n\n  let file;\n  try {\n    file = await readVirtualFile(pathString, 'utf8');\n  } catch (error) {\n    if (error.code === 'ENOENT') {\n      throw new Error(\n        `Could not find '${pathString}'. Please ensure that the file exists.`,\n      );\n    }\n\n    throw error;\n  }\n  file.result = parseJson(file.toString());\n  return file as VirtualFile<Type>;\n}\n\n/**\n * Gets the complete out file path from an output file name and parent\n * directory path.\n *\n * @param outDir - The path to the out file's parent directory.\n * @param outFileName - The out file's name.\n * @returns The complete path to the out file.\n */\nexport function getOutfilePath(outDir: string, outFileName: string): string {\n  return pathUtils.join(outDir, outFileName || 'bundle.js');\n}\n\n/**\n * Ensures that the outfile name is just a `.js` file name.\n * Throws on validation failure.\n *\n * @param filename - The file name to validate.\n * @returns `true` if validation succeeded.\n * @throws If the file name is invalid.\n */\nexport function validateOutfileName(filename: string): boolean {\n  if (\n    !filename.endsWith('.js') ||\n    filename === '.js' ||\n    pathUtils.basename(filename) !== filename\n  ) {\n    throw new Error(`Invalid outfile name: ${filename}. Must be a .js file`);\n  }\n  return true;\n}\n\n/**\n * Validates a file path. Throws on validation failure.\n *\n * @param filePath - The file path to validate.\n * @returns `true` if validation succeeded.\n * @throws If the path does not resolve to a file.\n */\nexport async function validateFilePath(filePath: string): Promise<boolean> {\n  const exists = await isFile(filePath);\n  if (!exists) {\n    throw new Error(\n      `Invalid params: '${filePath}' is not a file or does not exist.`,\n    );\n  }\n  return true;\n}\n\n/**\n * Validates a directory path. Throws on validation failure.\n *\n * @param dirPath - The directory path to validate.\n * @param createDir - Whether to create the directory if it doesn't exist.\n * @returns `true` if validation succeeded or the directory was created.\n * @throws If the directory does not exist or could not be created.\n */\nexport async function validateDirPath(\n  dirPath: string,\n  createDir: boolean,\n): Promise<boolean> {\n  const exists = await isDirectory(dirPath, createDir);\n  if (!exists) {\n    throw new Error(\n      `Invalid params: '${dirPath}' is not a directory or could not be created.`,\n    );\n  }\n  return true;\n}\n\n/**\n * Creates a temporary file with a given name and content, writes it to disk and calls the provided function.\n * This function handles deletion of the temporary file after usage.\n *\n * @param fileName - The name of the temporary file.\n * @param fileContents - The content of the temporary file.\n * @param fn - The callback function to call when the temporary file has been created.\n */\nexport async function useTemporaryFile(\n  fileName: string,\n  fileContents: string,\n  fn: (path: string) => Promise<unknown>,\n): Promise<void> {\n  const filePath = pathUtils.join(os.tmpdir(), fileName);\n  await fs.mkdir(pathUtils.dirname(filePath), { recursive: true });\n  await fs.writeFile(filePath, fileContents);\n  try {\n    await fn(filePath);\n  } finally {\n    if (await isFile(filePath)) {\n      await fs.unlink(filePath);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AACA,SAAS,YAAY,UAAU;AAC/B,OAAO,QAAQ;AACf,OAAO,eAAe;AActB,eAAsB,YACpB,YACA,WACkB;AAClB,MAAI;AACF,UAAM,QAAQ,MAAM,GAAG,KAAK,UAAU;AACtC,WAAO,MAAM,YAAY;AAAA,EAC3B,SAAS,OAAO;AACd,QAAI,MAAM,SAAS,UAAU;AAC3B,UAAI,CAAC,WAAW;AACd,eAAO;AAAA,MACT;AAEA,YAAM,GAAG,MAAM,YAAY,EAAE,WAAW,KAAK,CAAC;AAC9C,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,OAAO,YAAsC;AACjE,MAAI;AACF,UAAM,QAAQ,MAAM,GAAG,KAAK,UAAU;AACtC,WAAO,MAAM,OAAO;AAAA,EACtB,SAAS,OAAO;AACd,WAAO;AAAA,EACT;AACF;AAQA,eAAsB,aACpB,YAC4B;AAC5B,MAAI,CAAC,WAAW,SAAS,OAAO,GAAG;AACjC,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,gBAAgB,YAAY,MAAM;AAAA,EACjD,SAAS,OAAO;AACd,QAAI,MAAM,SAAS,UAAU;AAC3B,YAAM,IAAI;AAAA,QACR,mBAAmB,UAAU;AAAA,MAC/B;AAAA,IACF;AAEA,UAAM;AAAA,EACR;AACA,OAAK,SAAS,UAAU,KAAK,SAAS,CAAC;AACvC,SAAO;AACT;AAUO,SAAS,eAAe,QAAgB,aAA6B;AAC1E,SAAO,UAAU,KAAK,QAAQ,eAAe,WAAW;AAC1D;AAUO,SAAS,oBAAoB,UAA2B;AAC7D,MACE,CAAC,SAAS,SAAS,KAAK,KACxB,aAAa,SACb,UAAU,SAAS,QAAQ,MAAM,UACjC;AACA,UAAM,IAAI,MAAM,yBAAyB,QAAQ,sBAAsB;AAAA,EACzE;AACA,SAAO;AACT;AASA,eAAsB,iBAAiB,UAAoC;AACzE,QAAM,SAAS,MAAM,OAAO,QAAQ;AACpC,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,oBAAoB,QAAQ;AAAA,IAC9B;AAAA,EACF;AACA,SAAO;AACT;AAUA,eAAsB,gBACpB,SACA,WACkB;AAClB,QAAM,SAAS,MAAM,YAAY,SAAS,SAAS;AACnD,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,oBAAoB,OAAO;AAAA,IAC7B;AAAA,EACF;AACA,SAAO;AACT;AAUA,eAAsB,iBACpB,UACA,cACA,IACe;AACf,QAAM,WAAW,UAAU,KAAK,GAAG,OAAO,GAAG,QAAQ;AACrD,QAAM,GAAG,MAAM,UAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAC/D,QAAM,GAAG,UAAU,UAAU,YAAY;AACzC,MAAI;AACF,UAAM,GAAG,QAAQ;AAAA,EACnB,UAAE;AACA,QAAI,MAAM,OAAO,QAAQ,GAAG;AAC1B,YAAM,GAAG,OAAO,QAAQ;AAAA,IAC1B;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-A3RRMELT.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-A3RRMELT.mjs.map

package/dist/chunk-A3RRMELT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}