@metamask/utils 8.1.0 → 8.2.1

package/CHANGELOG.md

@@ -6,6 +6,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [8.2.1]
+### Fixed
+- Fix issue with source maps where line numbers were incorrect for src/error.ts ([#156](https://github.com/MetaMask/utils/pull/156))
+
+## [8.2.0]
+### Added
+- Add struct utils for validating JSON objects with optional values ([#136](https://github.com/MetaMask/utils/pull/136))
+- Add filesystem utils ([#148](https://github.com/MetaMask/utils/pull/148))
+- Add error utils ([#146](https://github.com/MetaMask/utils/pull/146), [#151](https://github.com/MetaMask/utils/pull/151))
+- Add base64 encoding and decoding functions ([#145](https://github.com/MetaMask/utils/pull/145))
+
+### Changed
+- Use `tsup` for bundling ([#144](https://github.com/MetaMask/utils/pull/144))
+  - This makes the package fully compliant with ES modules.
+- Bump `@ethereumjs/tx` from `4.1.2` to `4.2.0` ([#133](https://github.com/MetaMask/utils/pull/133))
+
 ## [8.1.0]
 ### Changed
 - Make types for JSON-RPC-related structs more accurate ([#134](https://github.com/MetaMask/utils/pull/134))
@@ -192,7 +208,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - Initial release
 
-[Unreleased]: https://github.com/MetaMask/utils/compare/v8.1.0...HEAD
+[Unreleased]: https://github.com/MetaMask/utils/compare/v8.2.1...HEAD
+[8.2.1]: https://github.com/MetaMask/utils/compare/v8.2.0...v8.2.1
+[8.2.0]: https://github.com/MetaMask/utils/compare/v8.1.0...v8.2.0
 [8.1.0]: https://github.com/MetaMask/utils/compare/v8.0.0...v8.1.0
 [8.0.0]: https://github.com/MetaMask/utils/compare/v7.1.0...v8.0.0
 [7.1.0]: https://github.com/MetaMask/utils/compare/v7.0.0...v7.1.0

package/dist/assert.js

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunk6ZDHSOUVjs = require('./chunk-6ZDHSOUV.js');
+require('./chunk-IZC266HS.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+exports.AssertionError = _chunk6ZDHSOUVjs.AssertionError; exports.assert = _chunk6ZDHSOUVjs.assert; exports.assertExhaustive = _chunk6ZDHSOUVjs.assertExhaustive; exports.assertStruct = _chunk6ZDHSOUVjs.assertStruct;
+//# sourceMappingURL=assert.js.map

package/dist/assert.js.map

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

package/dist/assert.mjs

@@ -0,0 +1,16 @@
+import {
+  AssertionError,
+  assert,
+  assertExhaustive,
+  assertStruct
+} from "./chunk-74DGVJVE.mjs";
+import "./chunk-XYGUOY6N.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  AssertionError,
+  assert,
+  assertExhaustive,
+  assertStruct
+};
+//# sourceMappingURL=assert.mjs.map

package/dist/assert.mjs.map

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

package/dist/base64.js

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk6NZW4WK4js = require('./chunk-6NZW4WK4.js');
+require('./chunk-6ZDHSOUV.js');
+require('./chunk-IZC266HS.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+exports.base64 = _chunk6NZW4WK4js.base64;
+//# sourceMappingURL=base64.js.map

package/dist/base64.js.map

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

package/dist/base64.mjs

@@ -0,0 +1,11 @@
+import {
+  base64
+} from "./chunk-NQMRFZHB.mjs";
+import "./chunk-74DGVJVE.mjs";
+import "./chunk-XYGUOY6N.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  base64
+};
+//# sourceMappingURL=base64.mjs.map

package/dist/base64.mjs.map

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

package/dist/bytes.js

@@ -0,0 +1,43 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkQEPVHEP7js = require('./chunk-QEPVHEP7.js');
+require('./chunk-6ZDHSOUV.js');
+require('./chunk-IZC266HS.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.assertIsBytes = _chunkQEPVHEP7js.assertIsBytes; exports.base64ToBytes = _chunkQEPVHEP7js.base64ToBytes; exports.bigIntToBytes = _chunkQEPVHEP7js.bigIntToBytes; exports.bytesToBase64 = _chunkQEPVHEP7js.bytesToBase64; exports.bytesToBigInt = _chunkQEPVHEP7js.bytesToBigInt; exports.bytesToHex = _chunkQEPVHEP7js.bytesToHex; exports.bytesToNumber = _chunkQEPVHEP7js.bytesToNumber; exports.bytesToSignedBigInt = _chunkQEPVHEP7js.bytesToSignedBigInt; exports.bytesToString = _chunkQEPVHEP7js.bytesToString; exports.concatBytes = _chunkQEPVHEP7js.concatBytes; exports.createDataView = _chunkQEPVHEP7js.createDataView; exports.hexToBytes = _chunkQEPVHEP7js.hexToBytes; exports.isBytes = _chunkQEPVHEP7js.isBytes; exports.numberToBytes = _chunkQEPVHEP7js.numberToBytes; exports.signedBigIntToBytes = _chunkQEPVHEP7js.signedBigIntToBytes; exports.stringToBytes = _chunkQEPVHEP7js.stringToBytes; exports.valueToBytes = _chunkQEPVHEP7js.valueToBytes;
+//# sourceMappingURL=bytes.js.map

package/dist/bytes.js.map

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

package/dist/bytes.mjs

@@ -0,0 +1,43 @@
+import {
+  assertIsBytes,
+  base64ToBytes,
+  bigIntToBytes,
+  bytesToBase64,
+  bytesToBigInt,
+  bytesToHex,
+  bytesToNumber,
+  bytesToSignedBigInt,
+  bytesToString,
+  concatBytes,
+  createDataView,
+  hexToBytes,
+  isBytes,
+  numberToBytes,
+  signedBigIntToBytes,
+  stringToBytes,
+  valueToBytes
+} from "./chunk-VA2DRBDE.mjs";
+import "./chunk-74DGVJVE.mjs";
+import "./chunk-XYGUOY6N.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  assertIsBytes,
+  base64ToBytes,
+  bigIntToBytes,
+  bytesToBase64,
+  bytesToBigInt,
+  bytesToHex,
+  bytesToNumber,
+  bytesToSignedBigInt,
+  bytesToString,
+  concatBytes,
+  createDataView,
+  hexToBytes,
+  isBytes,
+  numberToBytes,
+  signedBigIntToBytes,
+  stringToBytes,
+  valueToBytes
+};
+//# sourceMappingURL=bytes.mjs.map

package/dist/bytes.mjs.map

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

package/dist/caip-types.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkU7ZUGCE7js = require('./chunk-U7ZUGCE7.js');
+require('./chunk-3W5G4CYI.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.CAIP_ACCOUNT_ADDRESS_REGEX = _chunkU7ZUGCE7js.CAIP_ACCOUNT_ADDRESS_REGEX; exports.CAIP_ACCOUNT_ID_REGEX = _chunkU7ZUGCE7js.CAIP_ACCOUNT_ID_REGEX; exports.CAIP_CHAIN_ID_REGEX = _chunkU7ZUGCE7js.CAIP_CHAIN_ID_REGEX; exports.CAIP_NAMESPACE_REGEX = _chunkU7ZUGCE7js.CAIP_NAMESPACE_REGEX; exports.CAIP_REFERENCE_REGEX = _chunkU7ZUGCE7js.CAIP_REFERENCE_REGEX; exports.CaipAccountAddressStruct = _chunkU7ZUGCE7js.CaipAccountAddressStruct; exports.CaipAccountIdStruct = _chunkU7ZUGCE7js.CaipAccountIdStruct; exports.CaipChainIdStruct = _chunkU7ZUGCE7js.CaipChainIdStruct; exports.CaipNamespaceStruct = _chunkU7ZUGCE7js.CaipNamespaceStruct; exports.CaipReferenceStruct = _chunkU7ZUGCE7js.CaipReferenceStruct; exports.isCaipAccountAddress = _chunkU7ZUGCE7js.isCaipAccountAddress; exports.isCaipAccountId = _chunkU7ZUGCE7js.isCaipAccountId; exports.isCaipChainId = _chunkU7ZUGCE7js.isCaipChainId; exports.isCaipNamespace = _chunkU7ZUGCE7js.isCaipNamespace; exports.isCaipReference = _chunkU7ZUGCE7js.isCaipReference; exports.parseCaipAccountId = _chunkU7ZUGCE7js.parseCaipAccountId; exports.parseCaipChainId = _chunkU7ZUGCE7js.parseCaipChainId;
+//# sourceMappingURL=caip-types.js.map

package/dist/caip-types.js.map

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

package/dist/caip-types.mjs

@@ -0,0 +1,40 @@
+import {
+  CAIP_ACCOUNT_ADDRESS_REGEX,
+  CAIP_ACCOUNT_ID_REGEX,
+  CAIP_CHAIN_ID_REGEX,
+  CAIP_NAMESPACE_REGEX,
+  CAIP_REFERENCE_REGEX,
+  CaipAccountAddressStruct,
+  CaipAccountIdStruct,
+  CaipChainIdStruct,
+  CaipNamespaceStruct,
+  CaipReferenceStruct,
+  isCaipAccountAddress,
+  isCaipAccountId,
+  isCaipChainId,
+  isCaipNamespace,
+  isCaipReference,
+  parseCaipAccountId,
+  parseCaipChainId
+} from "./chunk-TGOMTREC.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  CAIP_ACCOUNT_ADDRESS_REGEX,
+  CAIP_ACCOUNT_ID_REGEX,
+  CAIP_CHAIN_ID_REGEX,
+  CAIP_NAMESPACE_REGEX,
+  CAIP_REFERENCE_REGEX,
+  CaipAccountAddressStruct,
+  CaipAccountIdStruct,
+  CaipChainIdStruct,
+  CaipNamespaceStruct,
+  CaipReferenceStruct,
+  isCaipAccountAddress,
+  isCaipAccountId,
+  isCaipChainId,
+  isCaipNamespace,
+  isCaipReference,
+  parseCaipAccountId,
+  parseCaipChainId
+};
+//# sourceMappingURL=caip-types.mjs.map

package/dist/caip-types.mjs.map

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

package/dist/checksum.js

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkE4C7EW4Rjs = require('./chunk-E4C7EW4R.js');
+require('./chunk-6NZW4WK4.js');
+require('./chunk-6ZDHSOUV.js');
+require('./chunk-IZC266HS.js');
+require('./chunk-QVEKZRZ2.js');
+require('./chunk-3W5G4CYI.js');
+
+
+exports.ChecksumStruct = _chunkE4C7EW4Rjs.ChecksumStruct;
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

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

package/dist/checksum.mjs

@@ -0,0 +1,12 @@
+import {
+  ChecksumStruct
+} from "./chunk-GZS3IQBZ.mjs";
+import "./chunk-NQMRFZHB.mjs";
+import "./chunk-74DGVJVE.mjs";
+import "./chunk-XYGUOY6N.mjs";
+import "./chunk-H4YFDLB7.mjs";
+import "./chunk-X66SUIEF.mjs";
+export {
+  ChecksumStruct
+};
+//# sourceMappingURL=checksum.mjs.map

package/dist/checksum.mjs.map

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

package/dist/chunk-2LBGT4GH.js

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// src/logging.ts
+var _debug = require('debug'); var _debug2 = _interopRequireDefault(_debug);
+var globalLogger = _debug2.default.call(void 0, "metamask");
+function createProjectLogger(projectName) {
+  return globalLogger.extend(projectName);
+}
+function createModuleLogger(projectLogger, moduleName) {
+  return projectLogger.extend(moduleName);
+}
+
+
+
+
+exports.createProjectLogger = createProjectLogger; exports.createModuleLogger = createModuleLogger;
+//# sourceMappingURL=chunk-2LBGT4GH.js.map

package/dist/chunk-2LBGT4GH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging.ts"],"names":[],"mappings":";AACA,OAAO,WAAW;AAElB,IAAM,eAAe,MAAM,UAAU;AAc9B,SAAS,oBAAoB,aAA+B;AACjE,SAAO,aAAa,OAAO,WAAW;AACxC;AAgBO,SAAS,mBACd,eACA,YACU;AACV,SAAO,cAAc,OAAO,UAAU;AACxC","sourcesContent":["import type { Debugger } from 'debug';\nimport debug from 'debug';\n\nconst globalLogger = debug('metamask');\n\n/**\n * Creates a logger via the `debug` library whose log messages will be tagged\n * using the name of your project. By default, such messages will be\n * suppressed, but you can reveal them by setting the `DEBUG` environment\n * variable to `metamask:<projectName>`. You can also set this variable to\n * `metamask:*` if you want to see log messages from all MetaMask projects that\n * are also using this function to create their loggers.\n *\n * @param projectName - The name of your project. This should be the name of\n * your NPM package if you're developing one.\n * @returns An instance of `debug`.\n */\nexport function createProjectLogger(projectName: string): Debugger {\n  return globalLogger.extend(projectName);\n}\n\n/**\n * Creates a logger via the `debug` library which is derived from the logger for\n * the whole project whose log messages will be tagged using the name of your\n * module. By default, such messages will be suppressed, but you can reveal them\n * by setting the `DEBUG` environment variable to\n * `metamask:<projectName>:<moduleName>`. You can also set this variable to\n * `metamask:<projectName>:*` if you want to see log messages from the project,\n * or `metamask:*` if you want to see log messages from all MetaMask projects.\n *\n * @param projectLogger - The logger created via {@link createProjectLogger}.\n * @param moduleName - The name of your module. You could use the name of the\n * file where you're using this logger or some other name.\n * @returns An instance of `debug`.\n */\nexport function createModuleLogger(\n  projectLogger: Debugger,\n  moduleName: string,\n): Debugger {\n  return projectLogger.extend(moduleName);\n}\n"]}

package/dist/chunk-2TBCL6EF.js

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

package/dist/chunk-2TBCL6EF.js.map

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

package/dist/chunk-3W5G4CYI.js

@@ -0,0 +1,25 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+
+
+
+
+
+exports.__privateGet = __privateGet; exports.__privateAdd = __privateAdd; exports.__privateSet = __privateSet;
+//# sourceMappingURL=chunk-3W5G4CYI.js.map

package/dist/chunk-3W5G4CYI.js.map

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

package/dist/chunk-4D6XQBHA.js

@@ -0,0 +1,69 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunk6ZDHSOUVjs = require('./chunk-6ZDHSOUV.js');
+
+// src/versions.ts
+
+
+
+
+
+
+var _semver = require('semver');
+var _superstruct = require('superstruct');
+var VersionStruct = _superstruct.refine.call(void 0, 
+  _superstruct.string.call(void 0, ),
+  "Version",
+  (value) => {
+    if (_semver.valid.call(void 0, value) === null) {
+      return `Expected SemVer version, got "${value}"`;
+    }
+    return true;
+  }
+);
+var VersionRangeStruct = _superstruct.refine.call(void 0, 
+  _superstruct.string.call(void 0, ),
+  "Version range",
+  (value) => {
+    if (_semver.validRange.call(void 0, value) === null) {
+      return `Expected SemVer range, got "${value}"`;
+    }
+    return true;
+  }
+);
+function isValidSemVerVersion(version) {
+  return _superstruct.is.call(void 0, version, VersionStruct);
+}
+function isValidSemVerRange(versionRange) {
+  return _superstruct.is.call(void 0, versionRange, VersionRangeStruct);
+}
+function assertIsSemVerVersion(version) {
+  _chunk6ZDHSOUVjs.assertStruct.call(void 0, version, VersionStruct);
+}
+function assertIsSemVerRange(range) {
+  _chunk6ZDHSOUVjs.assertStruct.call(void 0, range, VersionRangeStruct);
+}
+function gtVersion(version1, version2) {
+  return _semver.gt.call(void 0, version1, version2);
+}
+function gtRange(version, range) {
+  return _semver.gtr.call(void 0, version, range);
+}
+function satisfiesVersionRange(version, versionRange) {
+  return _semver.satisfies.call(void 0, version, versionRange, {
+    includePrerelease: true
+  });
+}
+
+
+
+
+
+
+
+
+
+
+
+exports.VersionStruct = VersionStruct; exports.VersionRangeStruct = VersionRangeStruct; exports.isValidSemVerVersion = isValidSemVerVersion; exports.isValidSemVerRange = isValidSemVerRange; exports.assertIsSemVerVersion = assertIsSemVerVersion; exports.assertIsSemVerRange = assertIsSemVerRange; exports.gtVersion = gtVersion; exports.gtRange = gtRange; exports.satisfiesVersionRange = satisfiesVersionRange;
+//# sourceMappingURL=chunk-4D6XQBHA.js.map

package/dist/chunk-4D6XQBHA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/versions.ts"],"names":[],"mappings":";;;;;AAAA;AAAA,EACE,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AAAA,EACb,SAAS;AAAA,EACT,cAAc;AAAA,OACT;AAEP,SAAS,IAAI,QAAQ,cAAc;AAoD5B,IAAM,gBAAgB;AAAA,EAC3B,OAAO;AAAA,EACP;AAAA,EACA,CAAC,UAAU;AACT,QAAI,mBAAmB,KAAK,MAAM,MAAM;AACtC,aAAO,iCAAiC,KAAK;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AACF;AAEO,IAAM,qBAAqB;AAAA,EAChC,OAAO;AAAA,EACP;AAAA,EACA,CAAC,UAAU;AACT,QAAI,iBAAiB,KAAK,MAAM,MAAM;AACpC,aAAO,+BAA+B,KAAK;AAAA,IAC7C;AACA,WAAO;AAAA,EACT;AACF;AAQO,SAAS,qBACd,SAC0B;AAC1B,SAAO,GAAG,SAAS,aAAa;AAClC;AAQO,SAAS,mBACd,cAC6B;AAC7B,SAAO,GAAG,cAAc,kBAAkB;AAC5C;AAOO,SAAS,sBACd,SACkC;AAClC,eAAa,SAAS,aAAa;AACrC;AAOO,SAAS,oBACd,OAC8B;AAC9B,eAAa,OAAO,kBAAkB;AACxC;AASO,SAAS,UACd,UACA,UACS;AACT,SAAO,SAAS,UAAU,QAAQ;AACpC;AASO,SAAS,QAAQ,SAAwB,OAA6B;AAC3E,SAAO,UAAU,SAAS,KAAK;AACjC;AASO,SAAS,sBACd,SACA,cACS;AACT,SAAO,gBAAgB,SAAS,cAAc;AAAA,IAC5C,mBAAmB;AAAA,EACrB,CAAC;AACH","sourcesContent":["import {\n  gt as gtSemver,\n  gtr as gtrSemver,\n  satisfies as satisfiesSemver,\n  valid as validSemVerVersion,\n  validRange as validSemVerRange,\n} from 'semver';\nimport type { Struct } from 'superstruct';\nimport { is, refine, string } from 'superstruct';\n\nimport { assertStruct } from './assert';\nimport type { Opaque } from './opaque';\n\n/**\n * {@link https://codemix.com/opaque-types-in-javascript/ Opaque} type for SemVer ranges.\n *\n * @example Use {@link assertIsSemVerRange} and {@link isValidSemVerRange} to cast to proper type.\n * ```typescript\n * const unsafeRange: string = dataFromUser();\n * assertIsSemVerRange(unsafeRange);\n * unsafeRange\n * // ^? SemVerRange\n * ```\n * @example If you know what you're doing and want to side-step type safety, casting from a string works correctly.\n * ```typescript\n * const unsafeRange: string = dataFromUser();\n * unsafeRange as SemVerRange;\n * // ^? SemVerRange\n * ```\n * @see {@link assertIsSemVerRange}\n * @see {@link isValidSemVerRange}\n */\nexport type SemVerRange = Opaque<string, typeof semVerRange>;\ndeclare const semVerRange: unique symbol;\n\n/**\n * {@link https://codemix.com/opaque-types-in-javascript/ Opaque} type for singular SemVer version.\n *\n * @example Use {@link assertIsSemVerVersion} and {@link isValidSemVerVersion} to cast to proper type.\n * ```typescript\n * const unsafeVersion: string = dataFromUser();\n * assertIsSemVerVersion(unsafeRange);\n * unsafeVersion\n * // ^? SemVerVersion\n * ```\n * @example If you know what you're doing and want to side-step type safety, casting from a string works correctly.\n * ```typescript\n * const unsafeVersion: string = dataFromUser();\n * unsafeRange as SemVerVersion;\n * // ^? SemVerVersion\n * ```\n * @see {@link assertIsSemVerVersion}\n * @see {@link isValidSemVerVersion}\n */\nexport type SemVerVersion = Opaque<string, typeof semVerVersion>;\ndeclare const semVerVersion: unique symbol;\n\n/**\n * A struct for validating a version string.\n */\nexport const VersionStruct = refine<SemVerVersion, null>(\n  string() as unknown as Struct<SemVerVersion, null>,\n  'Version',\n  (value) => {\n    if (validSemVerVersion(value) === null) {\n      return `Expected SemVer version, got \"${value}\"`;\n    }\n    return true;\n  },\n);\n\nexport const VersionRangeStruct = refine<SemVerRange, null>(\n  string() as unknown as Struct<SemVerRange, null>,\n  'Version range',\n  (value) => {\n    if (validSemVerRange(value) === null) {\n      return `Expected SemVer range, got \"${value}\"`;\n    }\n    return true;\n  },\n);\n\n/**\n * Checks whether a SemVer version is valid.\n *\n * @param version - A potential version.\n * @returns `true` if the version is valid, and `false` otherwise.\n */\nexport function isValidSemVerVersion(\n  version: unknown,\n): version is SemVerVersion {\n  return is(version, VersionStruct);\n}\n\n/**\n * Checks whether a SemVer version range is valid.\n *\n * @param versionRange - A potential version range.\n * @returns `true` if the version range is valid, and `false` otherwise.\n */\nexport function isValidSemVerRange(\n  versionRange: unknown,\n): versionRange is SemVerRange {\n  return is(versionRange, VersionRangeStruct);\n}\n\n/**\n * Asserts that a value is a valid concrete SemVer version.\n *\n * @param version - A potential SemVer concrete version.\n */\nexport function assertIsSemVerVersion(\n  version: unknown,\n): asserts version is SemVerVersion {\n  assertStruct(version, VersionStruct);\n}\n\n/**\n * Asserts that a value is a valid SemVer range.\n *\n * @param range - A potential SemVer range.\n */\nexport function assertIsSemVerRange(\n  range: unknown,\n): asserts range is SemVerRange {\n  assertStruct(range, VersionRangeStruct);\n}\n\n/**\n * Checks whether a SemVer version is greater than another.\n *\n * @param version1 - The left-hand version.\n * @param version2 - The right-hand version.\n * @returns `version1 > version2`.\n */\nexport function gtVersion(\n  version1: SemVerVersion,\n  version2: SemVerVersion,\n): boolean {\n  return gtSemver(version1, version2);\n}\n\n/**\n * Checks whether a SemVer version is greater than all possibilities in a range.\n *\n * @param version - A SemvVer version.\n * @param range - The range to check against.\n * @returns `version > range`.\n */\nexport function gtRange(version: SemVerVersion, range: SemVerRange): boolean {\n  return gtrSemver(version, range);\n}\n\n/**\n * Returns whether a SemVer version satisfies a SemVer range.\n *\n * @param version - The SemVer version to check.\n * @param versionRange - The SemVer version range to check against.\n * @returns Whether the version satisfied the version range.\n */\nexport function satisfiesVersionRange(\n  version: SemVerVersion,\n  versionRange: SemVerRange,\n): boolean {\n  return satisfiesSemver(version, versionRange, {\n    includePrerelease: true,\n  });\n}\n"]}

package/dist/chunk-4RMX5YWE.js

@@ -0,0 +1,34 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/time.ts
+var Duration = /* @__PURE__ */ ((Duration2) => {
+  Duration2[Duration2["Millisecond"] = 1] = "Millisecond";
+  Duration2[Duration2["Second"] = 1e3] = "Second";
+  Duration2[Duration2["Minute"] = 6e4] = "Minute";
+  Duration2[Duration2["Hour"] = 36e5] = "Hour";
+  Duration2[Duration2["Day"] = 864e5] = "Day";
+  Duration2[Duration2["Week"] = 6048e5] = "Week";
+  Duration2[Duration2["Year"] = 31536e6] = "Year";
+  return Duration2;
+})(Duration || {});
+var isNonNegativeInteger = (number) => Number.isInteger(number) && number >= 0;
+var assertIsNonNegativeInteger = (number, name) => {
+  if (!isNonNegativeInteger(number)) {
+    throw new Error(
+      `"${name}" must be a non-negative integer. Received: "${number}".`
+    );
+  }
+};
+function inMilliseconds(count, duration) {
+  assertIsNonNegativeInteger(count, "count");
+  return count * duration;
+}
+function timeSince(timestamp) {
+  assertIsNonNegativeInteger(timestamp, "timestamp");
+  return Date.now() - timestamp;
+}
+
+
+
+
+
+exports.Duration = Duration; exports.inMilliseconds = inMilliseconds; exports.timeSince = timeSince;
+//# sourceMappingURL=chunk-4RMX5YWE.js.map

package/dist/chunk-4RMX5YWE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/time.ts"],"names":["Duration"],"mappings":";AAGO,IAAK,WAAL,kBAAKA,cAAL;AAIL,EAAAA,oBAAA,iBAAc,KAAd;AAKA,EAAAA,oBAAA,YAAS,OAAT;AAKA,EAAAA,oBAAA,YAAS,OAAT;AAKA,EAAAA,oBAAA,UAAO,QAAP;AAKA,EAAAA,oBAAA,SAAM,SAAN;AAKA,EAAAA,oBAAA,UAAO,UAAP;AAKA,EAAAA,oBAAA,UAAO,WAAP;AAlCU,SAAAA;AAAA,GAAA;AAqCZ,IAAM,uBAAuB,CAAC,WAC5B,OAAO,UAAU,MAAM,KAAK,UAAU;AAExC,IAAM,6BAA6B,CAAC,QAAgB,SAAiB;AACnE,MAAI,CAAC,qBAAqB,MAAM,GAAG;AACjC,UAAM,IAAI;AAAA,MACR,IAAI,IAAI,gDAAgD,MAAM;AAAA,IAChE;AAAA,EACF;AACF;AASO,SAAS,eAAe,OAAe,UAA4B;AACxE,6BAA2B,OAAO,OAAO;AACzC,SAAO,QAAQ;AACjB;AAQO,SAAS,UAAU,WAA2B;AACnD,6BAA2B,WAAW,WAAW;AACjD,SAAO,KAAK,IAAI,IAAI;AACtB","sourcesContent":["/**\n * Common duration constants, in milliseconds.\n */\nexport enum Duration {\n  /**\n   * A millisecond.\n   */\n  Millisecond = 1,\n\n  /**\n   * A second, in milliseconds.\n   */\n  Second = 1000, // Millisecond * 1000\n\n  /**\n   * A minute, in milliseconds.\n   */\n  Minute = 60_000, // Second * 60\n\n  /**\n   * An hour, in milliseconds.\n   */\n  Hour = 3_600_000, // Minute * 60\n\n  /**\n   * A day, in milliseconds.\n   */\n  Day = 86_400_000, // Hour * 24\n\n  /**\n   * A week, in milliseconds.\n   */\n  Week = 604_800_000, // Day * 7\n\n  /**\n   * A year, in milliseconds.\n   */\n  Year = 31_536_000_000, // Day * 365\n}\n\nconst isNonNegativeInteger = (number: number) =>\n  Number.isInteger(number) && number >= 0;\n\nconst assertIsNonNegativeInteger = (number: number, name: string) => {\n  if (!isNonNegativeInteger(number)) {\n    throw new Error(\n      `\"${name}\" must be a non-negative integer. Received: \"${number}\".`,\n    );\n  }\n};\n\n/**\n * Calculates the millisecond value of the specified number of units of time.\n *\n * @param count - The number of units of time.\n * @param duration - The unit of time to count.\n * @returns The count multiplied by the specified duration.\n */\nexport function inMilliseconds(count: number, duration: Duration): number {\n  assertIsNonNegativeInteger(count, 'count');\n  return count * duration;\n}\n\n/**\n * Gets the milliseconds since a particular Unix epoch timestamp.\n *\n * @param timestamp - A Unix millisecond timestamp.\n * @returns The number of milliseconds elapsed since the specified timestamp.\n */\nexport function timeSince(timestamp: number): number {\n  assertIsNonNegativeInteger(timestamp, 'timestamp');\n  return Date.now() - timestamp;\n}\n"]}

package/dist/chunk-52OU772R.mjs

@@ -0,0 +1,122 @@
+import {
+  isErrorWithCode,
+  wrapError
+} from "./chunk-XYGUOY6N.mjs";
+
+// src/fs.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+async function readFile(filePath) {
+  try {
+    return await fs.promises.readFile(filePath, "utf8");
+  } catch (error) {
+    throw wrapError(error, `Could not read file '${filePath}'`);
+  }
+}
+async function writeFile(filePath, content) {
+  try {
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.promises.writeFile(filePath, content);
+  } catch (error) {
+    throw wrapError(error, `Could not write file '${filePath}'`);
+  }
+}
+async function readJsonFile(filePath, {
+  parser = JSON
+} = {}) {
+  try {
+    const content = await fs.promises.readFile(filePath, "utf8");
+    return parser.parse(content);
+  } catch (error) {
+    throw wrapError(error, `Could not read JSON file '${filePath}'`);
+  }
+}
+async function writeJsonFile(filePath, jsonValue, {
+  stringifier = JSON,
+  prettify = false
+} = {}) {
+  try {
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    const json = prettify ? stringifier.stringify(jsonValue, null, "  ") : stringifier.stringify(jsonValue);
+    await fs.promises.writeFile(filePath, json);
+  } catch (error) {
+    throw wrapError(error, `Could not write JSON file '${filePath}'`);
+  }
+}
+async function fileExists(filePath) {
+  try {
+    const stats = await fs.promises.stat(filePath);
+    return stats.isFile();
+  } catch (error) {
+    if (isErrorWithCode(error) && error.code === "ENOENT") {
+      return false;
+    }
+    throw wrapError(error, `Could not determine if file exists '${filePath}'`);
+  }
+}
+async function directoryExists(directoryPath) {
+  try {
+    const stats = await fs.promises.stat(directoryPath);
+    return stats.isDirectory();
+  } catch (error) {
+    if (isErrorWithCode(error) && error.code === "ENOENT") {
+      return false;
+    }
+    throw wrapError(
+      error,
+      `Could not determine if directory exists '${directoryPath}'`
+    );
+  }
+}
+async function ensureDirectoryStructureExists(directoryPath) {
+  try {
+    await fs.promises.mkdir(directoryPath, { recursive: true });
+  } catch (error) {
+    throw wrapError(
+      error,
+      `Could not create directory structure '${directoryPath}'`
+    );
+  }
+}
+async function forceRemove(entryPath) {
+  try {
+    return await fs.promises.rm(entryPath, {
+      recursive: true,
+      force: true
+    });
+  } catch (error) {
+    throw wrapError(error, `Could not remove file or directory '${entryPath}'`);
+  }
+}
+function createSandbox(projectName) {
+  const timestamp = (/* @__PURE__ */ new Date()).getTime();
+  const directoryPath = path.join(os.tmpdir(), `${projectName}--${timestamp}`);
+  return {
+    directoryPath,
+    async withinSandbox(test) {
+      if (await directoryExists(directoryPath)) {
+        throw new Error(`${directoryPath} already exists. Cannot continue.`);
+      }
+      await ensureDirectoryStructureExists(directoryPath);
+      try {
+        await test({ directoryPath });
+      } finally {
+        await forceRemove(directoryPath);
+      }
+    }
+  };
+}
+
+export {
+  readFile,
+  writeFile,
+  readJsonFile,
+  writeJsonFile,
+  fileExists,
+  directoryExists,
+  ensureDirectoryStructureExists,
+  forceRemove,
+  createSandbox
+};
+//# sourceMappingURL=chunk-52OU772R.mjs.map