@metamask/snaps-utils 1.0.2 → 2.0.1

package/CHANGELOG.md

@@ -6,241 +6,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [1.0.2]
+## [2.0.1]
 ### Changed
-- No changes this release.
+- Remove deprecated `endowment:long-running` ([#1751](https://github.com/MetaMask/snaps/pull/1751))
 
-## [1.0.1]
+## [2.0.0]
 ### Changed
-- No changes this release.
+- Initial stable release from main branch ([#1757](https://github.com/MetaMask/snaps/pull/1757))
 
-## [1.0.0]
-### Changed
-- Bump semver to `^7.5.4` ([#1631](https://github.com/MetaMask/snaps/pull/1631))
-- Move source code and snap state back to controller state ([#1634](https://github.com/MetaMask/snaps/pull/1634))
-
-## [1.0.0-prerelease.1]
-### Added
-- Add subject type restrictions to snap-specific permissions ([#1366](https://github.com/MetaMask/snaps/pull/1366))
-
-### Changed
-- **BREAKING:** Disallow deriving Ethereum keys ([#1217](https://github.com/MetaMask/snaps/pull/1217))
-  - Coin type `60` is now blocked for derivation. 
-
-### Fixed
-- Improve JSON parsing safety ([#1499](https://github.com/MetaMask/snaps/pull/1499))
-
-## [0.32.2]
-### Changed
-- No changes this release.
-
-## [0.32.1]
-### Changed
-- No changes this release.
-
-## [0.32.0]
-### Changed
-- Use side effects to install snaps via `wallet_snap` permission ([#1301](https://github.com/MetaMask/snaps-monorepo/pull/1301))
-
-## [0.31.0]
-### Changed
-- **BREAKING:** Target `ES2020` ([#1247](https://github.com/MetaMask/snaps-monorepo/pull/1247))
-- Improve validation and sanitizing of snap IDs ([#1237](https://github.com/MetaMask/snaps-monorepo/pull/1237))
-
-## [0.30.0]
-### Changed
-- Properly sandbox iframe and inline SES in execution bundles ([#1193](https://github.com/MetaMask/snaps-monorepo/pull/1193))
-
-## [0.29.0]
-### Changed
-- Skip writing manifest if identical ([#1171](https://github.com/MetaMask/snaps-monorepo/pull/1171))
-  - This fixes a bug on Windows where the CLI could get stuck in a loop
-
-### Removed
-- **BREAKING:** Remove `SnapsGlobalObject` type ([#1014](https://github.com/MetaMask/snaps-monorepo/pull/1014))
-
-## [0.28.0]
-### Added
-- **BREAKING:** Add support for snap registries ([#1090](https://github.com/MetaMask/snaps-monorepo/pull/1090))
-  - This removes the `checkBlockList` constructor argument in favor of `registry`
-  - A registry implementation can be passed here, defaulting to a hosted JSON file
-  - Requiring a snap to be on the allowlist can be toggled with the feature flag `requireAllowlist`
-- Add experimental offscreen execution environment ([#1082](https://github.com/MetaMask/snaps-monorepo/pull/1082))
-
-### Changed
-- **BREAKING:** Bump `key-tree` to 6.2.0 and use `Uint8Array` for secret recovery phrases ([#1137](https://github.com/MetaMask/snaps-monorepo/pull/1137))
-
-### Removed
-- **BREAKING:** Remove `WebSocket` endowment ([#1122](https://github.com/MetaMask/snaps-monorepo/pull/1122))
-
-### Fixed
-- Fix missing cronjob export ([#1134](https://github.com/MetaMask/snaps-monorepo/pull/1134))
-
-## [0.27.1]
-### Changed
-- No changes this release.
-
-## [0.27.0]
-### Changed
-- **BREAKING:** Use SIP-6 algorithm for state encryption ([#1055](https://github.com/MetaMask/snaps-monorepo/pull/1055))
-  - This breaks all existing snaps that use `snap_manageState`
-- **BREAKING:** Use custom UI in transaction insights ([#1047](https://github.com/MetaMask/snaps-monorepo/pull/1047))
-- **BREAKING:** Move all internal types from `snaps-types` to `snaps-utils` ([#1060](https://github.com/MetaMask/snaps-monorepo/pull/1060))
-
-## [0.26.2]
-### Changed
-- No changes this release.
-
-## [0.26.1]
-### Fixed
-- Fix some paths being wrongly normalized ([#1053](https://github.com/MetaMask/snaps-monorepo/pull/1053))
-- Fix utils browser export ([#1049](https://github.com/MetaMask/snaps-monorepo/pull/1049))
-
-## [0.26.0]
-### Fixed
-- Fix post processing issue with `object.eval` ([#1040](https://github.com/MetaMask/snaps-monorepo/pull/1040))
-
-## [0.25.0]
-### Added
-- **BREAKING:** Add JSON-RPC handler permission ([#905](https://github.com/MetaMask/snaps-monorepo/pull/905))
-  - Snaps are now required to request `endowment:rpc` to receive RPC requests.
-
-## [0.24.1]
-### Fixed
-- Fix `snap_getBip32PublicKey` manifest validation ([#970](https://github.com/MetaMask/snaps-monorepo/pull/970))
-
-## [0.24.0]
+## [0.38.4-flask.1]
 ### Added
-- Add transaction insight caveat for accessing transaction origin ([#902](https://github.com/MetaMask/snaps-monorepo/pull/902))
-- Add `snap_getEntropy` JSON-RPC method ([#940](https://github.com/MetaMask/snaps-monorepo/pull/940))
-- Add permission validation to `snap.manifest.json` ([#910](https://github.com/MetaMask/snaps-monorepo/pull/910))
-- Add compile-time warning when using `Math.random` ([#950](https://github.com/MetaMask/snaps-monorepo/pull/950))
+- Add `onNameLookup` export ([#1394](https://github.com/MetaMask/snaps/pull/1394), [#1759](https://github.com/MetaMask/snaps/pull/1759))
 
 ### Changed
-- **BREAKING:** Rename package to start with `snaps-` ([#937](https://github.com/MetaMask/snaps-monorepo/pull/937))
-- **BREAKING:** Remove `wallet` global in favor of `snap` and `ethereum` ([#939](https://github.com/MetaMask/snaps-monorepo/pull/939), [#964](https://github.com/MetaMask/snaps-monorepo/pull/964))
-
-## [0.23.0]
-### Added
-- Add snap cronjobs ([#651](https://github.com/MetaMask/snaps-monorepo/pull/651))
+- Bump `metamask/utils` and `metamask/snaps-registry` ([#1738](https://github.com/MetaMask/snaps/pull/1738))
 
+## [0.38.3-flask.1]
 ### Changed
-- **BREAKING:** Replace Buffer with Typed Arrays ([#878](https://github.com/MetaMask/snaps-monorepo/pull/878))
-- Improve keyring endowment error messaging ([#884](https://github.com/MetaMask/snaps-monorepo/pull/884))
-- Replace JSON schema validation with structs ([#862](https://github.com/MetaMask/snaps-monorepo/pull/862))
-
-### Removed
-- **BREAKING:** Stop including source code in SnapController state ([#861](https://github.com/MetaMask/snaps-monorepo/pull/861))
+- Bump `@metamask/post-message-stream` from 6.1.2 to 7.0.0 ([#1707](https://github.com/MetaMask/snaps/pull/1707), [#1724](https://github.com/MetaMask/snaps/pull/1724))
+- Bump `@metamask/utils` and `@metamask/snaps-registry` ([#1694](https://github.com/MetaMask/snaps/pull/1694))
 
-## [0.22.3]
+## [0.38.2-flask.1]
 ### Fixed
-- Make @babel/types a regular dependency ([#852](https://github.com/MetaMask/snaps-monorepo/pull/852))
+- Remove unused dependencies ([#1680](https://github.com/MetaMask/snaps/pull/1680))
 
-## [0.22.2]
+## [0.38.1-flask.1]
 ### Changed
-- No changes this release.
-
-## [0.22.1]
-### Fixed
-- Add browser entry point for `snap-utils` ([#820](https://github.com/MetaMask/snaps-monorepo/pull/820))
+- Update transaction insights response and add severity level enum ([#1653](https://github.com/MetaMask/snaps/pull/1653))
+   - Snaps are now able to specify a `severity` for alongside their insights.
+   - See [SIP-11](https://metamask.github.io/SIPs/SIPS/sip-11) for more information.
 
-## [0.22.0]
+## [0.38.0-flask.1]
 ### Added
-- Add functionality required for Snap Keyring support ([#700](https://github.com/MetaMask/snaps-monorepo/pull/700), [#777](https://github.com/MetaMask/snaps-monorepo/pull/777))
-
-## [0.21.0]
-### Changed
-- Run eval and fix manifest in bundler plugins ([#731](https://github.com/MetaMask/snaps-monorepo/pull/731))
-
-## [0.20.0]
-### Added
-- **BREAKING:** Add Transaction Insight API ([#642](https://github.com/MetaMask/snaps-monorepo/pull/642))
-- Add internal types from `@metamask/snaps-types` ([#695](https://github.com/MetaMask/snaps-monorepo/pull/695))
-
-### Changed
-- **BREAKING:** Simplify manifest format for permission caveats ([#705](https://github.com/MetaMask/snaps-monorepo/pull/705))
-- Reduce TypeScript compilation target for `snap-controllers` ([#708](https://github.com/MetaMask/snaps-monorepo/pull/708))
-
-## [0.19.1]
-### Added
-- Generate source maps from modified code ([#615](https://github.com/MetaMask/snaps-monorepo/pull/615))
-
-## [0.19.0]
-### Changed
-- Move eval functionality to utils package ([#666](https://github.com/MetaMask/snaps-monorepo/pull/666))
-- Move manifest handling functionality to utils ([#652](https://github.com/MetaMask/snaps-monorepo/pull/652))
-- Move JSON schemas and controller utils to utils package ([#623](https://github.com/MetaMask/snaps-monorepo/pull/623))
-
-### Fixed
-- Fixed missing AbortSignal in default endowments ([#682](https://github.com/MetaMask/snaps-monorepo/pull/682))
-
-## [0.18.1]
-### Changed
-- No changes this release.
+- Add `onInstall` and `onUpdate` lifecycle hooks ([#1643](https://github.com/MetaMask/snaps/pull/1643))
 
-## [0.18.0]
 ### Changed
-- Reduce TypeScript compilation target to ES2017 ([#628](https://github.com/MetaMask/snaps-monorepo/pull/628))
-
-## [0.17.0]
-### Changed
-- **BREAKING:** Bump minimum Node version to 16 ([#601](https://github.com/MetaMask/snaps-monorepo/pull/601))
-
-## [0.16.0]
-### Changed
-- No changes this release.
-
-## [0.15.0]
-### Fixed
-- Fix an issue where comment stripping would break for large files ([#468](https://github.com/MetaMask/snaps-monorepo/pull/468))
-
-## [0.14.0]
-### Changed
-- **BREAKING:** Increase TypeScript compilation target to ES2020 ([#449](https://github.com/MetaMask/snaps-monorepo/pull/449))
-  - This should not be breaking for consumers on any non-deprecated browser or Node.js version.
-
-## [0.13.0]
-### Changed
-- No changes this release.
-
-## [0.12.0]
-### Added
-- Initial release ([#410](https://github.com/MetaMask/snaps-monorepo/pull/410), [#421](https://github.com/MetaMask/snaps-monorepo/pull/421))
-
-[Unreleased]: https://github.com/MetaMask/snaps/compare/v1.0.2...HEAD
-[1.0.2]: https://github.com/MetaMask/snaps/compare/v1.0.1...v1.0.2
-[1.0.1]: https://github.com/MetaMask/snaps/compare/v1.0.0...v1.0.1
-[1.0.0]: https://github.com/MetaMask/snaps/compare/v1.0.0-prerelease.1...v1.0.0
-[1.0.0-prerelease.1]: https://github.com/MetaMask/snaps/compare/v0.32.2...v1.0.0-prerelease.1
-[0.32.2]: https://github.com/MetaMask/snaps/compare/v0.32.1...v0.32.2
-[0.32.1]: https://github.com/MetaMask/snaps/compare/v0.32.0...v0.32.1
-[0.32.0]: https://github.com/MetaMask/snaps/compare/v0.31.0...v0.32.0
-[0.31.0]: https://github.com/MetaMask/snaps/compare/v0.30.0...v0.31.0
-[0.30.0]: https://github.com/MetaMask/snaps/compare/v0.29.0...v0.30.0
-[0.29.0]: https://github.com/MetaMask/snaps/compare/v0.28.0...v0.29.0
-[0.28.0]: https://github.com/MetaMask/snaps/compare/v0.27.1...v0.28.0
-[0.27.1]: https://github.com/MetaMask/snaps/compare/v0.27.0...v0.27.1
-[0.27.0]: https://github.com/MetaMask/snaps/compare/v0.26.2...v0.27.0
-[0.26.2]: https://github.com/MetaMask/snaps/compare/v0.26.1...v0.26.2
-[0.26.1]: https://github.com/MetaMask/snaps/compare/v0.26.0...v0.26.1
-[0.26.0]: https://github.com/MetaMask/snaps/compare/v0.25.0...v0.26.0
-[0.25.0]: https://github.com/MetaMask/snaps/compare/v0.24.1...v0.25.0
-[0.24.1]: https://github.com/MetaMask/snaps/compare/v0.24.0...v0.24.1
-[0.24.0]: https://github.com/MetaMask/snaps/compare/v0.23.0...v0.24.0
-[0.23.0]: https://github.com/MetaMask/snaps/compare/v0.22.3...v0.23.0
-[0.22.3]: https://github.com/MetaMask/snaps/compare/v0.22.2...v0.22.3
-[0.22.2]: https://github.com/MetaMask/snaps/compare/v0.22.1...v0.22.2
-[0.22.1]: https://github.com/MetaMask/snaps/compare/v0.22.0...v0.22.1
-[0.22.0]: https://github.com/MetaMask/snaps/compare/v0.21.0...v0.22.0
-[0.21.0]: https://github.com/MetaMask/snaps/compare/v0.20.0...v0.21.0
-[0.20.0]: https://github.com/MetaMask/snaps/compare/v0.19.1...v0.20.0
-[0.19.1]: https://github.com/MetaMask/snaps/compare/v0.19.0...v0.19.1
-[0.19.0]: https://github.com/MetaMask/snaps/compare/v0.18.1...v0.19.0
-[0.18.1]: https://github.com/MetaMask/snaps/compare/v0.18.0...v0.18.1
-[0.18.0]: https://github.com/MetaMask/snaps/compare/v0.17.0...v0.18.0
-[0.17.0]: https://github.com/MetaMask/snaps/compare/v0.16.0...v0.17.0
-[0.16.0]: https://github.com/MetaMask/snaps/compare/v0.15.0...v0.16.0
-[0.15.0]: https://github.com/MetaMask/snaps/compare/v0.14.0...v0.15.0
-[0.14.0]: https://github.com/MetaMask/snaps/compare/v0.13.0...v0.14.0
-[0.13.0]: https://github.com/MetaMask/snaps/compare/v0.12.0...v0.13.0
-[0.12.0]: https://github.com/MetaMask/snaps/releases/tag/v0.12.0
+- Move source code and snap state back to controller state ([#1634](https://github.com/MetaMask/snaps/pull/1634))
+- Bump `semver` to `^7.5.4` ([#1631](https://github.com/MetaMask/snaps/pull/1631))
+
+## [0.37.2-flask.1]
+### Changed
+- Release package independently ([#1600](https://github.com/MetaMask/snaps/pull/1600))
+  - The version of the package no longer needs to match the version of all other
+    MetaMask Snaps packages.
+
+[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@2.0.1...HEAD
+[2.0.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@2.0.0...@metamask/snaps-utils@2.0.1
+[2.0.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.38.4-flask.1...@metamask/snaps-utils@2.0.0
+[0.38.4-flask.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.38.3-flask.1...@metamask/snaps-utils@0.38.4-flask.1
+[0.38.3-flask.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.38.2-flask.1...@metamask/snaps-utils@0.38.3-flask.1
+[0.38.2-flask.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.38.1-flask.1...@metamask/snaps-utils@0.38.2-flask.1
+[0.38.1-flask.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.38.0-flask.1...@metamask/snaps-utils@0.38.1-flask.1
+[0.38.0-flask.1]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-utils@0.37.2-flask.1...@metamask/snaps-utils@0.38.0-flask.1
+[0.37.2-flask.1]: https://github.com/MetaMask/snaps/releases/tag/@metamask/snaps-utils@0.37.2-flask.1

package/dist/cjs/array.js

@@ -0,0 +1,23 @@
+/**
+ * Checks if array `a` is equal to array `b`. Note that this does not do a deep
+ * equality check. It only checks if the arrays are the same length and if each
+ * element in `a` is equal to (`===`) the corresponding element in `b`.
+ *
+ * @param a - The first array to compare.
+ * @param b - The second array to compare.
+ * @returns `true` if the arrays are equal, `false` otherwise.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "isEqual", {
+    enumerable: true,
+    get: function() {
+        return isEqual;
+    }
+});
+function isEqual(a, b) {
+    return a.length === b.length && a.every((value, index)=>value === b[index]);
+}
+
+//# sourceMappingURL=array.js.map

package/dist/cjs/array.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/array.ts"],"sourcesContent":["/**\n * Checks if array `a` is equal to array `b`. Note that this does not do a deep\n * equality check. It only checks if the arrays are the same length and if each\n * element in `a` is equal to (`===`) the corresponding element in `b`.\n *\n * @param a - The first array to compare.\n * @param b - The second array to compare.\n * @returns `true` if the arrays are equal, `false` otherwise.\n */\nexport function isEqual(a: unknown[], b: unknown[]): boolean {\n  return a.length === b.length && a.every((value, index) => value === b[index]);\n}\n"],"names":["isEqual","a","b","length","every","value","index"],"mappings":"AAAA;;;;;;;;CAQC;;;;+BACeA;;;eAAAA;;;AAAT,SAASA,QAAQC,CAAY,EAAEC,CAAY;IAChD,OAAOD,EAAEE,MAAM,KAAKD,EAAEC,MAAM,IAAIF,EAAEG,KAAK,CAAC,CAACC,OAAOC,QAAUD,UAAUH,CAAC,CAACI,MAAM;AAC9E"}

package/dist/cjs/caveats.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "SnapCaveatType", {
+    enumerable: true,
+    get: function() {
+        return SnapCaveatType;
+    }
+});
+var SnapCaveatType;
+(function(SnapCaveatType) {
+    SnapCaveatType[/**
+   * Permitted derivation paths, used by `snap_getBip32Entropy`.
+   */ "PermittedDerivationPaths"] = 'permittedDerivationPaths';
+    SnapCaveatType[/**
+   * Permitted coin types, used by `snap_getBip44Entropy`.
+   */ "PermittedCoinTypes"] = 'permittedCoinTypes';
+    SnapCaveatType[/**
+   * Caveat specifying a snap cronjob.
+   */ "SnapCronjob"] = 'snapCronjob';
+    SnapCaveatType[/**
+   * Caveat specifying access to the transaction origin, used by `endowment:transaction-insight`.
+   */ "TransactionOrigin"] = 'transactionOrigin';
+    SnapCaveatType[/**
+   * The origins that a Snap can receive JSON-RPC messages from.
+   */ "RpcOrigin"] = 'rpcOrigin';
+    SnapCaveatType[/**
+   * Caveat specifying the snap IDs that can be interacted with.
+   */ "SnapIds"] = 'snapIds';
+    SnapCaveatType[/**
+   * Caveat specifying the CAIP-2 chain IDs that a snap can service, currently limited to `endowment:name-lookup`.
+   */ "ChainIds"] = 'chainIds';
+})(SnapCaveatType || (SnapCaveatType = {}));
+
+//# sourceMappingURL=caveats.js.map

package/dist/cjs/caveats.js.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   * The origins that a Snap can receive JSON-RPC messages from.\n   */\n  RpcOrigin = 'rpcOrigin',\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"],"names":["SnapCaveatType","PermittedDerivationPaths","PermittedCoinTypes","SnapCronjob","TransactionOrigin","RpcOrigin","SnapIds","ChainIds"],"mappings":";;;;;;;;;;IAAO;UAAKA,cAAc;IAAdA,eACV;;GAEC,GACDC,8BAA2B;IAJjBD,eAMV;;GAEC,GACDE,wBAAqB;IATXF,eAWV;;GAEC,GACDG,iBAAc;IAdJH,eAgBV;;GAEC,GACDI,uBAAoB;IAnBVJ,eAqBV;;GAEC,GACDK,eAAY;IAxBFL,eA0BV;;GAEC,GACDM,aAAU;IA7BAN,eA+BV;;GAEC,GACDO,cAAW;GAlCDP,mBAAAA"}

package/dist/cjs/checksum.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    checksum: function() {
+        return checksum;
+    },
+    checksumFiles: function() {
+        return checksumFiles;
+    }
+});
+const _utils = require("@metamask/utils");
+const _sha256 = require("@noble/hashes/sha256");
+const _VirtualFile = require("./virtual-file/VirtualFile");
+function checksum(bytes) {
+    const value = bytes instanceof _VirtualFile.VirtualFile ? bytes.value : bytes;
+    return (0, _sha256.sha256)(value);
+}
+function checksumFiles(files) {
+    return checksum((0, _utils.concatBytes)([
+        ...files
+    ].sort((a, b)=>{
+        (0, _utils.assert)(a.path !== b.path, 'Tried to sort files with non-unique paths.');
+        if (a.path < b.path) {
+            return -1;
+        }
+        return 1;
+    }).map((file)=>checksum(file))));
+}
+
+//# sourceMappingURL=checksum.js.map

package/dist/cjs/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/checksum.ts"],"sourcesContent":["import { assert, concatBytes } from '@metamask/utils';\nimport { sha256 } from '@noble/hashes/sha256';\n\nimport { VirtualFile } from './virtual-file/VirtualFile';\n\n/**\n * Calculates checksum for a single byte array.\n *\n * @param bytes - The byte array to calculate the checksum for.\n * @returns A single sha-256 checksum.\n */\nexport function checksum(bytes: VirtualFile | Uint8Array | string): Uint8Array {\n  const value = bytes instanceof VirtualFile ? bytes.value : bytes;\n  return sha256(value);\n}\n\n/**\n * Calculates checksum over multiple files in a reproducible way.\n *\n * 1. Sort all the files by their paths.\n * 2. Calculate sha-256 checksum of each file separately.\n * 3. Concatenate all the checksums into one buffer and sha-256 that buffer.\n *\n * The sorting of paths is done using {@link https://tc39.es/ecma262/#sec-islessthan UTF-16 Code Units}.\n *\n * @param files - The files over which to calculate the checksum.\n * @returns A single sha-256 checksum.\n */\nexport function checksumFiles(files: VirtualFile[]) {\n  return checksum(\n    concatBytes(\n      [...files]\n        .sort((a, b) => {\n          assert(\n            a.path !== b.path,\n            'Tried to sort files with non-unique paths.',\n          );\n          if (a.path < b.path) {\n            return -1;\n          }\n          return 1;\n        })\n        .map((file) => checksum(file)),\n    ),\n  );\n}\n"],"names":["checksum","checksumFiles","bytes","value","VirtualFile","sha256","files","concatBytes","sort","a","b","assert","path","map","file"],"mappings":";;;;;;;;;;;IAWgBA,QAAQ;eAARA;;IAiBAC,aAAa;eAAbA;;;uBA5BoB;wBACb;6BAEK;AAQrB,SAASD,SAASE,KAAwC;IAC/D,MAAMC,QAAQD,iBAAiBE,wBAAW,GAAGF,MAAMC,KAAK,GAAGD;IAC3D,OAAOG,IAAAA,cAAM,EAACF;AAChB;AAcO,SAASF,cAAcK,KAAoB;IAChD,OAAON,SACLO,IAAAA,kBAAW,EACT;WAAID;KAAM,CACPE,IAAI,CAAC,CAACC,GAAGC;QACRC,IAAAA,aAAM,EACJF,EAAEG,IAAI,KAAKF,EAAEE,IAAI,EACjB;QAEF,IAAIH,EAAEG,IAAI,GAAGF,EAAEE,IAAI,EAAE;YACnB,OAAO,CAAC;QACV;QACA,OAAO;IACT,GACCC,GAAG,CAAC,CAACC,OAASd,SAASc;AAGhC"}

package/dist/cjs/cronjob.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    CronjobRpcRequestStruct: function() {
+        return CronjobRpcRequestStruct;
+    },
+    CronExpressionStruct: function() {
+        return CronExpressionStruct;
+    },
+    parseCronExpression: function() {
+        return parseCronExpression;
+    },
+    CronjobSpecificationStruct: function() {
+        return CronjobSpecificationStruct;
+    },
+    isCronjobSpecification: function() {
+        return isCronjobSpecification;
+    },
+    CronjobSpecificationArrayStruct: function() {
+        return CronjobSpecificationArrayStruct;
+    },
+    isCronjobSpecificationArray: function() {
+        return isCronjobSpecificationArray;
+    }
+});
+const _utils = require("@metamask/utils");
+const _cronparser = require("cron-parser");
+const _superstruct = require("superstruct");
+const CronjobRpcRequestStruct = (0, _superstruct.assign)((0, _superstruct.partial)((0, _superstruct.pick)(_utils.JsonRpcRequestStruct, [
+    'id',
+    'jsonrpc'
+])), (0, _superstruct.omit)(_utils.JsonRpcRequestStruct, [
+    'id',
+    'jsonrpc'
+]));
+const CronExpressionStruct = (0, _superstruct.refine)((0, _superstruct.coerce)((0, _superstruct.string)(), (0, _superstruct.object)({
+    minute: (0, _superstruct.optional)((0, _superstruct.string)()),
+    hour: (0, _superstruct.optional)((0, _superstruct.string)()),
+    dayOfMonth: (0, _superstruct.optional)((0, _superstruct.string)()),
+    month: (0, _superstruct.optional)((0, _superstruct.string)()),
+    dayOfWeek: (0, _superstruct.optional)((0, _superstruct.string)())
+}), (value)=>`${value.minute ?? '*'} ${value.hour ?? '*'} ${value.dayOfMonth ?? '*'} ${value.month ?? '*'} ${value.dayOfWeek ?? '*'}`), 'CronExpression', (value)=>{
+    try {
+        (0, _cronparser.parseExpression)(value);
+        return true;
+    } catch  {
+        return false;
+    }
+});
+function parseCronExpression(expression) {
+    const ensureStringExpression = (0, _superstruct.create)(expression, CronExpressionStruct);
+    return (0, _cronparser.parseExpression)(ensureStringExpression);
+}
+const CronjobSpecificationStruct = (0, _superstruct.object)({
+    expression: CronExpressionStruct,
+    request: CronjobRpcRequestStruct
+});
+function isCronjobSpecification(value) {
+    try {
+        (0, _superstruct.create)(value, CronjobSpecificationStruct);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+const CronjobSpecificationArrayStruct = (0, _superstruct.array)(CronjobSpecificationStruct);
+function isCronjobSpecificationArray(value) {
+    try {
+        (0, _superstruct.create)(value, CronjobSpecificationArrayStruct);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+
+//# sourceMappingURL=cronjob.js.map

package/dist/cjs/cronjob.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cronjob.ts"],"sourcesContent":["import { JsonRpcRequestStruct } from '@metamask/utils';\nimport { parseExpression } from 'cron-parser';\nimport type { Infer } from 'superstruct';\nimport {\n  array,\n  assign,\n  coerce,\n  create,\n  object,\n  omit,\n  optional,\n  partial,\n  pick,\n  refine,\n  string,\n} from 'superstruct';\n\nexport const CronjobRpcRequestStruct = assign(\n  partial(pick(JsonRpcRequestStruct, ['id', 'jsonrpc'])),\n  omit(JsonRpcRequestStruct, ['id', 'jsonrpc']),\n);\nexport type CronjobRpcRequest = Infer<typeof CronjobRpcRequestStruct>;\n\nexport const CronExpressionStruct = refine(\n  coerce(\n    string(),\n    object({\n      minute: optional(string()),\n      hour: optional(string()),\n      dayOfMonth: optional(string()),\n      month: optional(string()),\n      dayOfWeek: optional(string()),\n    }),\n    (value) =>\n      `${value.minute ?? '*'} ${value.hour ?? '*'} ${value.dayOfMonth ?? '*'} ${\n        value.month ?? '*'\n      } ${value.dayOfWeek ?? '*'}`,\n  ),\n  'CronExpression',\n  (value) => {\n    try {\n      parseExpression(value);\n      return true;\n    } catch {\n      return false;\n    }\n  },\n);\n\nexport type CronExpression = Infer<typeof CronExpressionStruct>;\n\n/**\n * Parses a cron expression.\n *\n * @param expression - Expression to parse.\n * @returns A CronExpression class instance.\n */\nexport function parseCronExpression(expression: string | object) {\n  const ensureStringExpression = create(expression, CronExpressionStruct);\n  return parseExpression(ensureStringExpression);\n}\n\nexport const CronjobSpecificationStruct = object({\n  expression: CronExpressionStruct,\n  request: CronjobRpcRequestStruct,\n});\nexport type CronjobSpecification = Infer<typeof CronjobSpecificationStruct>;\n\n/**\n * Check if the given value is a {@link CronjobSpecification} object.\n *\n * @param value - The value to check.\n * @returns Whether the value is a valid {@link CronjobSpecification} object.\n */\nexport function isCronjobSpecification(value: unknown): boolean {\n  try {\n    create(value, CronjobSpecificationStruct);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport const CronjobSpecificationArrayStruct = array(\n  CronjobSpecificationStruct,\n);\n\n/**\n * Check if the given value is an array of {@link CronjobSpecification} objects.\n *\n * @param value - The value to check.\n * @returns Whether the value is a valid array of {@link CronjobSpecification} objects.\n */\nexport function isCronjobSpecificationArray(value: unknown): boolean {\n  try {\n    create(value, CronjobSpecificationArrayStruct);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"names":["CronjobRpcRequestStruct","CronExpressionStruct","parseCronExpression","CronjobSpecificationStruct","isCronjobSpecification","CronjobSpecificationArrayStruct","isCronjobSpecificationArray","assign","partial","pick","JsonRpcRequestStruct","omit","refine","coerce","string","object","minute","optional","hour","dayOfMonth","month","dayOfWeek","value","parseExpression","expression","ensureStringExpression","create","request","array"],"mappings":";;;;;;;;;;;IAiBaA,uBAAuB;eAAvBA;;IAMAC,oBAAoB;eAApBA;;IAkCGC,mBAAmB;eAAnBA;;IAKHC,0BAA0B;eAA1BA;;IAYGC,sBAAsB;eAAtBA;;IASHC,+BAA+B;eAA/BA;;IAUGC,2BAA2B;eAA3BA;;;uBA7FqB;4BACL;6BAczB;AAEA,MAAMN,0BAA0BO,IAAAA,mBAAM,EAC3CC,IAAAA,oBAAO,EAACC,IAAAA,iBAAI,EAACC,2BAAoB,EAAE;IAAC;IAAM;CAAU,IACpDC,IAAAA,iBAAI,EAACD,2BAAoB,EAAE;IAAC;IAAM;CAAU;AAIvC,MAAMT,uBAAuBW,IAAAA,mBAAM,EACxCC,IAAAA,mBAAM,EACJC,IAAAA,mBAAM,KACNC,IAAAA,mBAAM,EAAC;IACLC,QAAQC,IAAAA,qBAAQ,EAACH,IAAAA,mBAAM;IACvBI,MAAMD,IAAAA,qBAAQ,EAACH,IAAAA,mBAAM;IACrBK,YAAYF,IAAAA,qBAAQ,EAACH,IAAAA,mBAAM;IAC3BM,OAAOH,IAAAA,qBAAQ,EAACH,IAAAA,mBAAM;IACtBO,WAAWJ,IAAAA,qBAAQ,EAACH,IAAAA,mBAAM;AAC5B,IACA,CAACQ,QACC,CAAC,EAAEA,MAAMN,MAAM,IAAI,IAAI,CAAC,EAAEM,MAAMJ,IAAI,IAAI,IAAI,CAAC,EAAEI,MAAMH,UAAU,IAAI,IAAI,CAAC,EACtEG,MAAMF,KAAK,IAAI,IAChB,CAAC,EAAEE,MAAMD,SAAS,IAAI,IAAI,CAAC,GAEhC,kBACA,CAACC;IACC,IAAI;QACFC,IAAAA,2BAAe,EAACD;QAChB,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAWK,SAASpB,oBAAoBsB,UAA2B;IAC7D,MAAMC,yBAAyBC,IAAAA,mBAAM,EAACF,YAAYvB;IAClD,OAAOsB,IAAAA,2BAAe,EAACE;AACzB;AAEO,MAAMtB,6BAA6BY,IAAAA,mBAAM,EAAC;IAC/CS,YAAYvB;IACZ0B,SAAS3B;AACX;AASO,SAASI,uBAAuBkB,KAAc;IACnD,IAAI;QACFI,IAAAA,mBAAM,EAACJ,OAAOnB;QACd,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEO,MAAME,kCAAkCuB,IAAAA,kBAAK,EAClDzB;AASK,SAASG,4BAA4BgB,KAAc;IACxD,IAAI;QACFI,IAAAA,mBAAM,EAACJ,OAAOjB;QACd,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF"}

package/dist/cjs/deep-clone.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "deepClone", {
+    enumerable: true,
+    get: function() {
+        return deepClone;
+    }
+});
+const _rfdc = /*#__PURE__*/ _interop_require_default(require("rfdc"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const deepClone = (0, _rfdc.default)({
+    proto: false,
+    circles: false
+});
+
+//# sourceMappingURL=deep-clone.js.map

package/dist/cjs/deep-clone.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/deep-clone.ts"],"sourcesContent":["import rfdc from 'rfdc';\n\nexport const deepClone = rfdc({ proto: false, circles: false });\n"],"names":["deepClone","rfdc","proto","circles"],"mappings":";;;;+BAEaA;;;eAAAA;;;6DAFI;;;;;;AAEV,MAAMA,YAAYC,IAAAA,aAAI,EAAC;IAAEC,OAAO;IAAOC,SAAS;AAAM"}

package/dist/cjs/default-endowments.js

@@ -0,0 +1,49 @@
+/**
+ * Global JavaScript APIs exposed by default to all snaps.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DEFAULT_ENDOWMENTS", {
+    enumerable: true,
+    get: function() {
+        return DEFAULT_ENDOWMENTS;
+    }
+});
+const DEFAULT_ENDOWMENTS = Object.freeze([
+    'atob',
+    'btoa',
+    'BigInt',
+    'console',
+    'crypto',
+    'Date',
+    'Math',
+    'setTimeout',
+    'clearTimeout',
+    'SubtleCrypto',
+    'TextDecoder',
+    'TextEncoder',
+    'URL',
+    'setInterval',
+    'clearInterval',
+    'Int8Array',
+    'Uint8Array',
+    'Uint8ClampedArray',
+    'Int16Array',
+    'Uint16Array',
+    'Int32Array',
+    'Uint32Array',
+    'Float32Array',
+    'Float64Array',
+    'BigInt64Array',
+    'BigUint64Array',
+    'DataView',
+    'ArrayBuffer',
+    // Used by fetch, but also as API for some packages that don't do network connections
+    // https://github.com/MetaMask/snaps-monorepo/issues/662
+    // https://github.com/MetaMask/snaps-monorepo/discussions/678
+    'AbortController',
+    'AbortSignal'
+]);
+
+//# sourceMappingURL=default-endowments.js.map

package/dist/cjs/default-endowments.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/default-endowments.ts"],"sourcesContent":["/**\n * Global JavaScript APIs exposed by default to all snaps.\n */\nexport const DEFAULT_ENDOWMENTS: readonly string[] = Object.freeze([\n  'atob',\n  'btoa',\n  'BigInt',\n  'console',\n  'crypto',\n  'Date',\n  'Math',\n  'setTimeout',\n  'clearTimeout',\n  'SubtleCrypto',\n  'TextDecoder',\n  'TextEncoder',\n  'URL',\n  'setInterval',\n  'clearInterval',\n  'Int8Array',\n  'Uint8Array',\n  'Uint8ClampedArray',\n  'Int16Array',\n  'Uint16Array',\n  'Int32Array',\n  'Uint32Array',\n  'Float32Array',\n  'Float64Array',\n  'BigInt64Array',\n  'BigUint64Array',\n  'DataView',\n  'ArrayBuffer',\n  // Used by fetch, but also as API for some packages that don't do network connections\n  // https://github.com/MetaMask/snaps-monorepo/issues/662\n  // https://github.com/MetaMask/snaps-monorepo/discussions/678\n  'AbortController',\n  'AbortSignal',\n]);\n"],"names":["DEFAULT_ENDOWMENTS","Object","freeze"],"mappings":"AAAA;;CAEC;;;;+BACYA;;;eAAAA;;;AAAN,MAAMA,qBAAwCC,OAAOC,MAAM,CAAC;IACjE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,qFAAqF;IACrF,wDAAwD;IACxD,6DAA6D;IAC7D;IACA;CACD"}

package/dist/cjs/entropy.js

@@ -0,0 +1,23 @@
+// 0xd36e6170 - 0x80000000
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    SIP_6_MAGIC_VALUE: function() {
+        return SIP_6_MAGIC_VALUE;
+    },
+    STATE_ENCRYPTION_MAGIC_VALUE: function() {
+        return STATE_ENCRYPTION_MAGIC_VALUE;
+    }
+});
+const SIP_6_MAGIC_VALUE = `1399742832'`;
+const STATE_ENCRYPTION_MAGIC_VALUE = `572232532'`;
+
+//# sourceMappingURL=entropy.js.map

package/dist/cjs/entropy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/entropy.ts"],"sourcesContent":["// 0xd36e6170 - 0x80000000\nexport const SIP_6_MAGIC_VALUE = `1399742832'` as `${number}'`;\n\n// `${bytesToNumber(keccak256('Snaps state encryption').slice(0, 4))}'`\nexport const STATE_ENCRYPTION_MAGIC_VALUE = `572232532'` as `${number}'`;\n\nexport type MagicValue =\n  | typeof SIP_6_MAGIC_VALUE\n  | typeof STATE_ENCRYPTION_MAGIC_VALUE;\n"],"names":["SIP_6_MAGIC_VALUE","STATE_ENCRYPTION_MAGIC_VALUE"],"mappings":"AAAA,0BAA0B;;;;;;;;;;;;IACbA,iBAAiB;eAAjBA;;IAGAC,4BAA4B;eAA5BA;;;AAHN,MAAMD,oBAAoB,CAAC,WAAW,CAAC;AAGvC,MAAMC,+BAA+B,CAAC,UAAU,CAAC"}

package/dist/cjs/enum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "enumValue", {
+    enumerable: true,
+    get: function() {
+        return enumValue;
+    }
+});
+const _structs = require("./structs");
+function enumValue(constant) {
+    return (0, _structs.literal)(constant);
+}
+
+//# sourceMappingURL=enum.js.map

package/dist/cjs/enum.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/enum.ts"],"sourcesContent":["import type { Struct } from 'superstruct';\n\nimport { literal } from './structs';\n\n/**\n * Get the enum values as union type. This allows using both the enum string\n * values and the enum itself as values.\n *\n * Note: This only works for string enums.\n *\n * @example\n * ```typescript\n * enum Foo {\n *   Bar = 'bar',\n *   Baz = 'baz',\n * }\n *\n * type FooValue = EnumToUnion<Foo>;\n * // FooValue is 'bar' | 'baz'\n *\n * const foo: FooValue = Foo.Bar; // Works\n * const foo: FooValue = 'bar'; // Also works\n * ```\n */\nexport type EnumToUnion<Type extends string> = `${Type}`;\n\n/**\n * Superstruct struct for validating an enum value. This allows using both the\n * enum string values and the enum itself as values.\n *\n * @param constant - The enum to validate against.\n * @returns The superstruct struct.\n */\nexport function enumValue<Type extends string>(\n  constant: Type,\n): Struct<EnumToUnion<Type>, null> {\n  return literal(constant as EnumToUnion<Type>);\n}\n"],"names":["enumValue","constant","literal"],"mappings":";;;;+BAiCgBA;;;eAAAA;;;yBA/BQ;AA+BjB,SAASA,UACdC,QAAc;IAEd,OAAOC,IAAAA,gBAAO,EAACD;AACjB"}

package/dist/cjs/errors.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "getErrorMessage", {
+    enumerable: true,
+    get: function() {
+        return getErrorMessage;
+    }
+});
+const _utils = require("@metamask/utils");
+function getErrorMessage(error) {
+    if ((0, _utils.isObject)(error) && (0, _utils.hasProperty)(error, 'message') && typeof error.message === 'string') {
+        return error.message;
+    }
+    return String(error);
+}
+
+//# sourceMappingURL=errors.js.map