@metamask/snaps-controllers 9.5.0 → 9.6.0

package/dist/utils.cjs

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchSnap = exports.getSnapFiles = exports.withTimeout = exports.hasTimedOut = exports.delayWithTimer = exports.delay = exports.permissionsDiff = exports.setDiff = void 0;
+const snaps_sdk_1 = require("@metamask/snaps-sdk");
+const snaps_utils_1 = require("@metamask/snaps-utils");
+const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
+const Timer_1 = require("./snaps/Timer.cjs");
+/**
+ * Takes two objects and does a Set Difference of them.
+ * Set Difference is generally defined as follows:
+ * ```
+ * 𝑥 ∈ A ∖ B ⟺ 𝑥 ∈ A ∧ 𝑥 ∉ B
+ * ```
+ * Meaning that the returned object contains all properties of A expect those that also
+ * appear in B. Notice that properties that appear in B, but not in A, have no effect.
+ *
+ * @see [Set Difference]{@link https://proofwiki.org/wiki/Definition:Set_Difference}
+ * @param objectA - The object on which the difference is being calculated.
+ * @param objectB - The object whose properties will be removed from objectA.
+ * @returns The objectA without properties from objectB.
+ */
+function setDiff(objectA, objectB) {
+    return Object.entries(objectA).reduce((acc, [key, value]) => {
+        if (!(key in objectB)) {
+            acc[key] = value;
+        }
+        return acc;
+    }, {});
+}
+exports.setDiff = setDiff;
+/**
+ * Calculate a difference between two permissions objects.
+ *
+ * Similar to `setDiff` except for one additional condition:
+ * Permissions in B should be removed from A if they exist in both and have differing caveats.
+ *
+ * @param permissionsA - An object containing one or more partial permissions.
+ * @param permissionsB - An object containing one or more partial permissions to be subtracted from A.
+ * @returns The permissions set A without properties from B.
+ */
+function permissionsDiff(permissionsA, permissionsB) {
+    return Object.entries(permissionsA).reduce((acc, [key, value]) => {
+        const isIncluded = key in permissionsB;
+        if (!isIncluded ||
+            (isIncluded &&
+                !(0, fast_deep_equal_1.default)(value.caveats ?? [], permissionsB[key].caveats ?? []))) {
+            acc[key] = value;
+        }
+        return acc;
+    }, {});
+}
+exports.permissionsDiff = permissionsDiff;
+/**
+ * A Promise that delays its return for a given amount of milliseconds.
+ *
+ * @param ms - Milliseconds to delay the execution for.
+ * @param result - The result to return from the Promise after delay.
+ * @returns A promise that is void if no result provided, result otherwise.
+ * @template Result - The `result`.
+ */
+function delay(ms, result) {
+    return delayWithTimer(new Timer_1.Timer(ms), result);
+}
+exports.delay = delay;
+/**
+ * A Promise that delays it's return by using a pausable Timer.
+ *
+ * @param timer - Timer used to control the delay.
+ * @param result - The result to return from the Promise after delay.
+ * @returns A promise that is void if no result provided, result otherwise.
+ * @template Result - The `result`.
+ */
+function delayWithTimer(timer, result) {
+    let rejectFunc;
+    const promise = new Promise((resolve, reject) => {
+        timer.start(() => {
+            result === undefined ? resolve() : resolve(result);
+        });
+        rejectFunc = reject;
+    });
+    promise.cancel = () => {
+        if (timer.status !== 'finished') {
+            timer.cancel();
+            rejectFunc(new Error('The delay has been canceled.'));
+        }
+    };
+    return promise;
+}
+exports.delayWithTimer = delayWithTimer;
+/*
+ * We use a Symbol instead of rejecting the promise so that Errors thrown
+ * by the main promise will propagate.
+ */
+exports.hasTimedOut = Symbol('Used to check if the requested promise has timeout (see withTimeout)');
+/**
+ * Executes the given Promise, if the Timer expires before the Promise settles, we return earlier.
+ *
+ * NOTE:** The given Promise is not cancelled or interrupted, and will continue to execute uninterrupted. We will just discard its result if it does not complete before the timeout.
+ *
+ * @param promise - The promise that you want to execute.
+ * @param timerOrMs - The timer controlling the timeout or a ms value.
+ * @returns The resolved `PromiseValue`, or the hasTimedOut symbol if
+ * returning early.
+ * @template PromiseValue - The value of the Promise.
+ */
+async function withTimeout(promise, timerOrMs) {
+    const timer = typeof timerOrMs === 'number' ? new Timer_1.Timer(timerOrMs) : timerOrMs;
+    const delayPromise = delayWithTimer(timer, exports.hasTimedOut);
+    try {
+        return await Promise.race([promise, delayPromise]);
+    }
+    finally {
+        delayPromise.cancel();
+    }
+}
+exports.withTimeout = withTimeout;
+/**
+ * Get all files in a Snap from an array of file paths.
+ *
+ * @param location - The location of the Snap.
+ * @param files - The array of file paths.
+ * @returns The array of files as {@link VirtualFile}s.
+ */
+async function getSnapFiles(location, files) {
+    if (!files || files.length === 0) {
+        return [];
+    }
+    return await Promise.all(files.map(async (filePath) => location.fetch(filePath)));
+}
+exports.getSnapFiles = getSnapFiles;
+/**
+ * Fetch the Snap manifest, source code, and any other files from the given
+ * location.
+ *
+ * @param snapId - The ID of the Snap to fetch.
+ * @param location - The location of the Snap.
+ * @returns The Snap files and location.
+ * @throws If the Snap files are invalid, or if the Snap could not be fetched.
+ */
+async function fetchSnap(snapId, location) {
+    try {
+        const manifest = await location.manifest();
+        const sourceCode = await location.fetch(manifest.result.source.location.npm.filePath);
+        (0, snaps_sdk_1.assert)(sourceCode.size < snaps_utils_1.MAX_FILE_SIZE, 'Snap source code must be smaller than 64 MB.');
+        const { iconPath } = manifest.result.source.location.npm;
+        const svgIcon = iconPath ? await location.fetch(iconPath) : undefined;
+        const auxiliaryFiles = await getSnapFiles(location, manifest.result.source.files);
+        (0, snaps_utils_1.validateAuxiliaryFiles)(auxiliaryFiles);
+        await Promise.all(auxiliaryFiles.map(async (file) => {
+            // This should still be safe
+            // eslint-disable-next-line require-atomic-updates
+            file.data.base64 = await (0, snaps_utils_1.encodeBase64)(file);
+        }));
+        const localizationFiles = await getSnapFiles(location, manifest.result.source.locales);
+        const validatedLocalizationFiles = (0, snaps_utils_1.getValidatedLocalizationFiles)(localizationFiles);
+        const files = {
+            manifest,
+            sourceCode,
+            svgIcon,
+            auxiliaryFiles,
+            localizationFiles: validatedLocalizationFiles,
+        };
+        await (0, snaps_utils_1.validateFetchedSnap)(files);
+        return files;
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch snap "${snapId}": ${(0, snaps_sdk_1.getErrorMessage)(error)}.`);
+    }
+}
+exports.fetchSnap = fetchSnap;
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PermissionConstraint } from '@metamask/permission-controller';\nimport type { SnapId } from '@metamask/snaps-sdk';\nimport { assert, getErrorMessage } from '@metamask/snaps-sdk';\nimport {\n  MAX_FILE_SIZE,\n  encodeBase64,\n  getValidatedLocalizationFiles,\n  validateAuxiliaryFiles,\n  validateFetchedSnap,\n} from '@metamask/snaps-utils';\nimport deepEqual from 'fast-deep-equal';\n\nimport type { SnapLocation } from './snaps';\nimport { Timer } from './snaps/Timer';\n\n/**\n * Takes two objects and does a Set Difference of them.\n * Set Difference is generally defined as follows:\n * ```\n * 𝑥 ∈ A ∖ B ⟺ 𝑥 ∈ A ∧ 𝑥 ∉ B\n * ```\n * Meaning that the returned object contains all properties of A expect those that also\n * appear in B. Notice that properties that appear in B, but not in A, have no effect.\n *\n * @see [Set Difference]{@link https://proofwiki.org/wiki/Definition:Set_Difference}\n * @param objectA - The object on which the difference is being calculated.\n * @param objectB - The object whose properties will be removed from objectA.\n * @returns The objectA without properties from objectB.\n */\nexport function setDiff<\n  ObjectA extends Record<any, unknown>,\n  ObjectB extends Record<any, unknown>,\n>(objectA: ObjectA, objectB: ObjectB): Diff<ObjectA, ObjectB> {\n  return Object.entries(objectA).reduce<Record<any, unknown>>(\n    (acc, [key, value]) => {\n      if (!(key in objectB)) {\n        acc[key] = value;\n      }\n      return acc;\n    },\n    {},\n  ) as Diff<ObjectA, ObjectB>;\n}\n\n/**\n * Calculate a difference between two permissions objects.\n *\n * Similar to `setDiff` except for one additional condition:\n * Permissions in B should be removed from A if they exist in both and have differing caveats.\n *\n * @param permissionsA - An object containing one or more partial permissions.\n * @param permissionsB - An object containing one or more partial permissions to be subtracted from A.\n * @returns The permissions set A without properties from B.\n */\nexport function permissionsDiff<\n  PermissionsA extends Record<string, Pick<PermissionConstraint, 'caveats'>>,\n  PermissionsB extends Record<string, Pick<PermissionConstraint, 'caveats'>>,\n>(\n  permissionsA: PermissionsA,\n  permissionsB: PermissionsB,\n): Diff<PermissionsA, PermissionsB> {\n  return Object.entries(permissionsA).reduce<\n    Record<string, Pick<PermissionConstraint, 'caveats'>>\n  >((acc, [key, value]) => {\n    const isIncluded = key in permissionsB;\n    if (\n      !isIncluded ||\n      (isIncluded &&\n        !deepEqual(value.caveats ?? [], permissionsB[key].caveats ?? []))\n    ) {\n      acc[key] = value;\n    }\n    return acc;\n  }, {}) as Diff<PermissionsA, PermissionsB>;\n}\n\n/**\n * A Promise that delays its return for a given amount of milliseconds.\n *\n * @param ms - Milliseconds to delay the execution for.\n * @param result - The result to return from the Promise after delay.\n * @returns A promise that is void if no result provided, result otherwise.\n * @template Result - The `result`.\n */\nexport function delay<Result = void>(\n  ms: number,\n  result?: Result,\n): Promise<Result> & { cancel: () => void } {\n  return delayWithTimer(new Timer(ms), result);\n}\n\n/**\n * A Promise that delays it's return by using a pausable Timer.\n *\n * @param timer - Timer used to control the delay.\n * @param result - The result to return from the Promise after delay.\n * @returns A promise that is void if no result provided, result otherwise.\n * @template Result - The `result`.\n */\nexport function delayWithTimer<Result = void>(\n  timer: Timer,\n  result?: Result,\n): Promise<Result> & { cancel: () => void } {\n  let rejectFunc: (reason: Error) => void;\n  const promise: any = new Promise<Result>((resolve: any, reject) => {\n    timer.start(() => {\n      result === undefined ? resolve() : resolve(result);\n    });\n    rejectFunc = reject;\n  });\n\n  promise.cancel = () => {\n    if (timer.status !== 'finished') {\n      timer.cancel();\n      rejectFunc(new Error('The delay has been canceled.'));\n    }\n  };\n  return promise;\n}\n\n/*\n * We use a Symbol instead of rejecting the promise so that Errors thrown\n * by the main promise will propagate.\n */\nexport const hasTimedOut = Symbol(\n  'Used to check if the requested promise has timeout (see withTimeout)',\n);\n\n/**\n * Executes the given Promise, if the Timer expires before the Promise settles, we return earlier.\n *\n * NOTE:** The given Promise is not cancelled or interrupted, and will continue to execute uninterrupted. We will just discard its result if it does not complete before the timeout.\n *\n * @param promise - The promise that you want to execute.\n * @param timerOrMs - The timer controlling the timeout or a ms value.\n * @returns The resolved `PromiseValue`, or the hasTimedOut symbol if\n * returning early.\n * @template PromiseValue - The value of the Promise.\n */\nexport async function withTimeout<PromiseValue = void>(\n  promise: Promise<PromiseValue>,\n  timerOrMs: Timer | number,\n): Promise<PromiseValue | typeof hasTimedOut> {\n  const timer =\n    typeof timerOrMs === 'number' ? new Timer(timerOrMs) : timerOrMs;\n  const delayPromise = delayWithTimer(timer, hasTimedOut);\n  try {\n    return await Promise.race([promise, delayPromise]);\n  } finally {\n    delayPromise.cancel();\n  }\n}\n\n/**\n * Checks whether the type is composed of literal types\n *\n * @returns @type {true} if whole type is composed of literals, @type {false} if whole type is not literals, @type {boolean} if mixed\n * @example\n * ```\n * type t1 = IsLiteral<1 | 2 | \"asd\" | true>;\n * // t1 = true\n *\n * type t2 = IsLiteral<number | string>;\n * // t2 = false\n *\n * type t3 = IsLiteral<1 | string>;\n * // t3 = boolean\n *\n * const s = Symbol();\n * type t4 = IsLiteral<typeof s>;\n * // t4 = true\n *\n * type t5 = IsLiteral<symbol>\n * // t5 = false;\n * ```\n */\ntype IsLiteral<Type> = Type extends string | number | boolean | symbol\n  ? Extract<string | number | boolean | symbol, Type> extends never\n    ? true\n    : false\n  : false;\n\n/**\n * Returns all keys of an object, that are literal, as an union\n *\n * @example\n * ```\n * type t1 = _LiteralKeys<{a: number, b: 0, c: 'foo', d: string}>\n * // t1 = 'b' | 'c'\n * ```\n * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}\n */\ntype LiteralKeys<Type> = NonNullable<\n  {\n    [Key in keyof Type]: IsLiteral<Key> extends true ? Key : never;\n  }[keyof Type]\n>;\n\n/**\n * Returns all keys of an object, that are not literal, as an union\n *\n * @example\n * ```\n * type t1 = _NonLiteralKeys<{a: number, b: 0, c: 'foo', d: string}>\n * // t1 = 'a' | 'd'\n * ```\n * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}\n */\ntype NonLiteralKeys<Type> = NonNullable<\n  {\n    [Key in keyof Type]: IsLiteral<Key> extends false ? Key : never;\n  }[keyof Type]\n>;\n\n/**\n * A set difference of two objects based on their keys\n *\n * @example\n * ```\n * type t1 = Diff<{a: string, b: string}, {a: number}>\n * // t1 = {b: string};\n * type t2 = Diff<{a: string, 0: string}, Record<string, unknown>>;\n * // t2 = { a?: string, 0: string};\n * type t3 = Diff<{a: string, 0: string, 1: string}, Record<1 | string, unknown>>;\n * // t3 = {a?: string, 0: string}\n * ```\n * @see {@link setDiff} for the main use-case\n */\nexport type Diff<First, Second> = Omit<First, LiteralKeys<Second>> &\n  Partial<Pick<First, Extract<keyof First, NonLiteralKeys<Second>>>>;\n\n/**\n * Makes every specified property of the specified object type mutable.\n *\n * @template Type - The object whose readonly properties to make mutable.\n * @template TargetKey - The property key(s) to make mutable.\n */\nexport type Mutable<\n  Type extends Record<string, unknown>,\n  TargetKey extends string,\n> = {\n  -readonly [Key in keyof Pick<Type, TargetKey>]: Type[Key];\n} & {\n  [Key in keyof Omit<Type, TargetKey>]: Type[Key];\n};\n\n/**\n * Get all files in a Snap from an array of file paths.\n *\n * @param location - The location of the Snap.\n * @param files - The array of file paths.\n * @returns The array of files as {@link VirtualFile}s.\n */\nexport async function getSnapFiles(\n  location: SnapLocation,\n  files?: string[] | undefined,\n) {\n  if (!files || files.length === 0) {\n    return [];\n  }\n\n  return await Promise.all(\n    files.map(async (filePath) => location.fetch(filePath)),\n  );\n}\n\n/**\n * Fetch the Snap manifest, source code, and any other files from the given\n * location.\n *\n * @param snapId - The ID of the Snap to fetch.\n * @param location - The location of the Snap.\n * @returns The Snap files and location.\n * @throws If the Snap files are invalid, or if the Snap could not be fetched.\n */\nexport async function fetchSnap(snapId: SnapId, location: SnapLocation) {\n  try {\n    const manifest = await location.manifest();\n\n    const sourceCode = await location.fetch(\n      manifest.result.source.location.npm.filePath,\n    );\n\n    assert(\n      sourceCode.size < MAX_FILE_SIZE,\n      'Snap source code must be smaller than 64 MB.',\n    );\n\n    const { iconPath } = manifest.result.source.location.npm;\n    const svgIcon = iconPath ? await location.fetch(iconPath) : undefined;\n\n    const auxiliaryFiles = await getSnapFiles(\n      location,\n      manifest.result.source.files,\n    );\n\n    validateAuxiliaryFiles(auxiliaryFiles);\n\n    await Promise.all(\n      auxiliaryFiles.map(async (file) => {\n        // This should still be safe\n        // eslint-disable-next-line require-atomic-updates\n        file.data.base64 = await encodeBase64(file);\n      }),\n    );\n\n    const localizationFiles = await getSnapFiles(\n      location,\n      manifest.result.source.locales,\n    );\n\n    const validatedLocalizationFiles =\n      getValidatedLocalizationFiles(localizationFiles);\n\n    const files = {\n      manifest,\n      sourceCode,\n      svgIcon,\n      auxiliaryFiles,\n      localizationFiles: validatedLocalizationFiles,\n    };\n\n    await validateFetchedSnap(files);\n\n    return files;\n  } catch (error) {\n    throw new Error(\n      `Failed to fetch snap \"${snapId}\": ${getErrorMessage(error)}.`,\n    );\n  }\n}\n"]}

package/dist/{types/utils.d.ts → utils.d.cts}

@@ -1,7 +1,7 @@
-import type { PermissionConstraint } from '@metamask/permission-controller';
-import type { SnapId } from '@metamask/snaps-sdk';
-import type { SnapLocation } from './snaps';
-import { Timer } from './snaps/Timer';
+import type { PermissionConstraint } from "@metamask/permission-controller";
+import type { SnapId } from "@metamask/snaps-sdk";
+import type { SnapLocation } from "./snaps/index.cjs";
+import { Timer } from "./snaps/Timer.cjs";
 /**
  * Takes two objects and does a Set Difference of them.
  * Set Difference is generally defined as follows:
@@ -158,8 +158,6 @@ export declare function getSnapFiles(location: SnapLocation, files?: string[] |
  */
 export declare function fetchSnap(snapId: SnapId, location: SnapLocation): Promise<{
     manifest: import("@metamask/snaps-utils").VirtualFile<{
-        description: string;
-        version: import("@metamask/utils").SemVerVersion;
         source: {
             location: {
                 npm: {
@@ -173,14 +171,9 @@ export declare function fetchSnap(snapId: SnapId, location: SnapLocation): Promi
             files?: string[] | undefined;
             locales?: string[] | undefined;
         };
-        proposedName: string; /**
-         * A Promise that delays it's return by using a pausable Timer.
-         *
-         * @param timer - Timer used to control the delay.
-         * @param result - The result to return from the Promise after delay.
-         * @returns A promise that is void if no result provided, result otherwise.
-         * @template Result - The `result`.
-         */
+        description: string;
+        version: import("@metamask/utils").SemVerVersion;
+        proposedName: string;
         initialPermissions: Partial<{
             'endowment:cronjob': {
                 jobs: import("@metamask/snaps-sdk").Cronjob[];
@@ -249,3 +242,4 @@ export declare function fetchSnap(snapId: SnapId, location: SnapLocation): Promi
     }>[];
 }>;
 export {};
+//# sourceMappingURL=utils.d.cts.map

package/dist/utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.mts

@@ -0,0 +1,245 @@
+import type { PermissionConstraint } from "@metamask/permission-controller";
+import type { SnapId } from "@metamask/snaps-sdk";
+import type { SnapLocation } from "./snaps/index.mjs";
+import { Timer } from "./snaps/Timer.mjs";
+/**
+ * Takes two objects and does a Set Difference of them.
+ * Set Difference is generally defined as follows:
+ * ```
+ * 𝑥 ∈ A ∖ B ⟺ 𝑥 ∈ A ∧ 𝑥 ∉ B
+ * ```
+ * Meaning that the returned object contains all properties of A expect those that also
+ * appear in B. Notice that properties that appear in B, but not in A, have no effect.
+ *
+ * @see [Set Difference]{@link https://proofwiki.org/wiki/Definition:Set_Difference}
+ * @param objectA - The object on which the difference is being calculated.
+ * @param objectB - The object whose properties will be removed from objectA.
+ * @returns The objectA without properties from objectB.
+ */
+export declare function setDiff<ObjectA extends Record<any, unknown>, ObjectB extends Record<any, unknown>>(objectA: ObjectA, objectB: ObjectB): Diff<ObjectA, ObjectB>;
+/**
+ * Calculate a difference between two permissions objects.
+ *
+ * Similar to `setDiff` except for one additional condition:
+ * Permissions in B should be removed from A if they exist in both and have differing caveats.
+ *
+ * @param permissionsA - An object containing one or more partial permissions.
+ * @param permissionsB - An object containing one or more partial permissions to be subtracted from A.
+ * @returns The permissions set A without properties from B.
+ */
+export declare function permissionsDiff<PermissionsA extends Record<string, Pick<PermissionConstraint, 'caveats'>>, PermissionsB extends Record<string, Pick<PermissionConstraint, 'caveats'>>>(permissionsA: PermissionsA, permissionsB: PermissionsB): Diff<PermissionsA, PermissionsB>;
+/**
+ * A Promise that delays its return for a given amount of milliseconds.
+ *
+ * @param ms - Milliseconds to delay the execution for.
+ * @param result - The result to return from the Promise after delay.
+ * @returns A promise that is void if no result provided, result otherwise.
+ * @template Result - The `result`.
+ */
+export declare function delay<Result = void>(ms: number, result?: Result): Promise<Result> & {
+    cancel: () => void;
+};
+/**
+ * A Promise that delays it's return by using a pausable Timer.
+ *
+ * @param timer - Timer used to control the delay.
+ * @param result - The result to return from the Promise after delay.
+ * @returns A promise that is void if no result provided, result otherwise.
+ * @template Result - The `result`.
+ */
+export declare function delayWithTimer<Result = void>(timer: Timer, result?: Result): Promise<Result> & {
+    cancel: () => void;
+};
+export declare const hasTimedOut: unique symbol;
+/**
+ * Executes the given Promise, if the Timer expires before the Promise settles, we return earlier.
+ *
+ * NOTE:** The given Promise is not cancelled or interrupted, and will continue to execute uninterrupted. We will just discard its result if it does not complete before the timeout.
+ *
+ * @param promise - The promise that you want to execute.
+ * @param timerOrMs - The timer controlling the timeout or a ms value.
+ * @returns The resolved `PromiseValue`, or the hasTimedOut symbol if
+ * returning early.
+ * @template PromiseValue - The value of the Promise.
+ */
+export declare function withTimeout<PromiseValue = void>(promise: Promise<PromiseValue>, timerOrMs: Timer | number): Promise<PromiseValue | typeof hasTimedOut>;
+/**
+ * Checks whether the type is composed of literal types
+ *
+ * @returns @type {true} if whole type is composed of literals, @type {false} if whole type is not literals, @type {boolean} if mixed
+ * @example
+ * ```
+ * type t1 = IsLiteral<1 | 2 | "asd" | true>;
+ * // t1 = true
+ *
+ * type t2 = IsLiteral<number | string>;
+ * // t2 = false
+ *
+ * type t3 = IsLiteral<1 | string>;
+ * // t3 = boolean
+ *
+ * const s = Symbol();
+ * type t4 = IsLiteral<typeof s>;
+ * // t4 = true
+ *
+ * type t5 = IsLiteral<symbol>
+ * // t5 = false;
+ * ```
+ */
+type IsLiteral<Type> = Type extends string | number | boolean | symbol ? Extract<string | number | boolean | symbol, Type> extends never ? true : false : false;
+/**
+ * Returns all keys of an object, that are literal, as an union
+ *
+ * @example
+ * ```
+ * type t1 = _LiteralKeys<{a: number, b: 0, c: 'foo', d: string}>
+ * // t1 = 'b' | 'c'
+ * ```
+ * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}
+ */
+type LiteralKeys<Type> = NonNullable<{
+    [Key in keyof Type]: IsLiteral<Key> extends true ? Key : never;
+}[keyof Type]>;
+/**
+ * Returns all keys of an object, that are not literal, as an union
+ *
+ * @example
+ * ```
+ * type t1 = _NonLiteralKeys<{a: number, b: 0, c: 'foo', d: string}>
+ * // t1 = 'a' | 'd'
+ * ```
+ * @see [Literal types]{@link https://www.typescriptlang.org/docs/handbook/literal-types.html}
+ */
+type NonLiteralKeys<Type> = NonNullable<{
+    [Key in keyof Type]: IsLiteral<Key> extends false ? Key : never;
+}[keyof Type]>;
+/**
+ * A set difference of two objects based on their keys
+ *
+ * @example
+ * ```
+ * type t1 = Diff<{a: string, b: string}, {a: number}>
+ * // t1 = {b: string};
+ * type t2 = Diff<{a: string, 0: string}, Record<string, unknown>>;
+ * // t2 = { a?: string, 0: string};
+ * type t3 = Diff<{a: string, 0: string, 1: string}, Record<1 | string, unknown>>;
+ * // t3 = {a?: string, 0: string}
+ * ```
+ * @see {@link setDiff} for the main use-case
+ */
+export type Diff<First, Second> = Omit<First, LiteralKeys<Second>> & Partial<Pick<First, Extract<keyof First, NonLiteralKeys<Second>>>>;
+/**
+ * Makes every specified property of the specified object type mutable.
+ *
+ * @template Type - The object whose readonly properties to make mutable.
+ * @template TargetKey - The property key(s) to make mutable.
+ */
+export type Mutable<Type extends Record<string, unknown>, TargetKey extends string> = {
+    -readonly [Key in keyof Pick<Type, TargetKey>]: Type[Key];
+} & {
+    [Key in keyof Omit<Type, TargetKey>]: Type[Key];
+};
+/**
+ * Get all files in a Snap from an array of file paths.
+ *
+ * @param location - The location of the Snap.
+ * @param files - The array of file paths.
+ * @returns The array of files as {@link VirtualFile}s.
+ */
+export declare function getSnapFiles(location: SnapLocation, files?: string[] | undefined): Promise<import("@metamask/snaps-utils").VirtualFile<unknown>[]>;
+/**
+ * Fetch the Snap manifest, source code, and any other files from the given
+ * location.
+ *
+ * @param snapId - The ID of the Snap to fetch.
+ * @param location - The location of the Snap.
+ * @returns The Snap files and location.
+ * @throws If the Snap files are invalid, or if the Snap could not be fetched.
+ */
+export declare function fetchSnap(snapId: SnapId, location: SnapLocation): Promise<{
+    manifest: import("@metamask/snaps-utils").VirtualFile<{
+        source: {
+            location: {
+                npm: {
+                    registry: "https://registry.npmjs.org" | "https://registry.npmjs.org/";
+                    filePath: string;
+                    packageName: string;
+                    iconPath?: string | undefined;
+                };
+            };
+            shasum: string;
+            files?: string[] | undefined;
+            locales?: string[] | undefined;
+        };
+        description: string;
+        version: import("@metamask/utils").SemVerVersion;
+        proposedName: string;
+        initialPermissions: Partial<{
+            'endowment:cronjob': {
+                jobs: import("@metamask/snaps-sdk").Cronjob[];
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:ethereum-provider': import("@metamask/snaps-sdk").EmptyObject;
+            'endowment:keyring': {
+                allowedOrigins?: string[] | undefined;
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:lifecycle-hooks'?: {
+                maxRequestTime?: number | undefined;
+            } | undefined;
+            'endowment:name-lookup': {
+                chains?: `${string}:${string}`[] | undefined;
+                matchers?: import("@metamask/snaps-sdk").NameLookupMatchers | undefined;
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:network-access': import("@metamask/snaps-sdk").EmptyObject;
+            'endowment:page-home'?: {
+                maxRequestTime?: number | undefined;
+            } | undefined;
+            'endowment:rpc': {
+                dapps?: boolean | undefined;
+                snaps?: boolean | undefined;
+                allowedOrigins?: string[] | undefined;
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:signature-insight': {
+                allowSignatureOrigin?: boolean | undefined;
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:transaction-insight': {
+                allowTransactionOrigin?: boolean | undefined;
+                maxRequestTime?: number | undefined;
+            };
+            'endowment:webassembly': import("@metamask/snaps-sdk").EmptyObject;
+            snap_dialog: import("@metamask/snaps-sdk").EmptyObject;
+            snap_getBip32Entropy: import("@metamask/snaps-sdk").Bip32Entropy[];
+            snap_getBip32PublicKey: import("@metamask/snaps-sdk").Bip32Entropy[];
+            snap_getBip44Entropy: import("@metamask/snaps-sdk").Bip44Entropy[];
+            snap_getEntropy: import("@metamask/snaps-sdk").EmptyObject;
+            snap_getLocale: import("@metamask/snaps-sdk").EmptyObject;
+            snap_manageAccounts: import("@metamask/snaps-sdk").EmptyObject;
+            snap_manageState: import("@metamask/snaps-sdk").EmptyObject;
+            snap_notify: import("@metamask/snaps-sdk").EmptyObject;
+            wallet_snap: Record<string, import("@metamask/snaps-sdk").RequestedSnap>;
+        }>;
+        manifestVersion: "0.1";
+        repository?: {
+            type: string;
+            url: string;
+        } | undefined;
+        initialConnections?: Record<string & URL, {}> | undefined;
+        $schema?: string | undefined;
+    }>;
+    sourceCode: import("@metamask/snaps-utils").VirtualFile<unknown>;
+    svgIcon: import("@metamask/snaps-utils").VirtualFile<unknown> | undefined;
+    auxiliaryFiles: import("@metamask/snaps-utils").VirtualFile<unknown>[];
+    localizationFiles: import("@metamask/snaps-utils").VirtualFile<{
+        messages: Record<string, {
+            message: string;
+            description?: string | undefined;
+        }>;
+        locale: string;
+    }>[];
+}>;
+export {};
+//# sourceMappingURL=utils.d.mts.map

package/dist/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}