@metamask/snaps-utils 9.3.0 → 9.4.0

package/dist/manifest/validator.cjs

@@ -22,26 +22,34 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _Context_nextSeverity;
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Context_options, _Context_nextSeverity;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasFixes = exports.runValidators = void 0;
 const utils_1 = require("@metamask/utils");
 const defaultValidators = __importStar(require("./validators/index.cjs"));
 class Context {
-    constructor() {
+    /**
+     * Construct a new validator context.
+     *
+     * @param options - The options for the validator context.
+     * @param options.exports - Exports detected by evaluating the bundle.
+     */
+    constructor(options) {
         this.reports = [];
+        _Context_options.set(this, {});
         _Context_nextSeverity.set(this, undefined);
+        __classPrivateFieldSet(this, _Context_options, options, "f");
     }
     report(message, fix) {
         (0, utils_1.assert)(__classPrivateFieldGet(this, _Context_nextSeverity, "f") !== undefined);
@@ -57,8 +65,11 @@ class Context {
     get hasErrors() {
         return this.reports.some((report) => report.severity === 'error');
     }
+    get options() {
+        return __classPrivateFieldGet(this, _Context_options, "f");
+    }
 }
-_Context_nextSeverity = new WeakMap();
+_Context_options = new WeakMap(), _Context_nextSeverity = new WeakMap();
 /**
  * Verify that snap files are completely valid.
  * First it runs validators on unparsed files to check structure.
@@ -66,13 +77,15 @@ _Context_nextSeverity = new WeakMap();
  *
  * @param files - All files required to run a snap.
  * @param rules - Validators to run.
+ * @param options - Options for the validation.
+ * @param options.exports - Exports detected by evaluating the bundle.
  * @returns The validation results.
  */
 // TODO(ritave): snap.manifest.json and package.json should check
 //               json parsing as well instead of assuming it's
 //               already parsed
-async function runValidators(files, rules = Object.values(defaultValidators)) {
-    const context = new Context();
+async function runValidators(files, rules = Object.values(defaultValidators), options = {}) {
+    const context = new Context(options);
     for (const rule of rules) {
         context.prepareForValidator({
             severity: rule.severity,

package/dist/manifest/validator.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validator.cjs","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAyC;AASzC,0EAAkD;AAQlD,MAAM,OAAO;IAAb;QACE,YAAO,GAAsB,EAAE,CAAC;QAEhC,gCAAoC,SAAS,EAAC;IAkBhD,CAAC;IAhBC,MAAM,CAAC,OAAe,EAAE,GAAkB;QACxC,IAAA,cAAM,EAAC,uBAAA,IAAI,6BAAc,KAAK,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,uBAAA,IAAI,6BAAc;YAC5B,OAAO;YACP,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,QAAyC;QAC3D,uBAAA,IAAI,yBAAiB,QAAQ,CAAC,QAAQ,MAAA,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,CAAC;CACF;;AAED;;;;;;;;GAQG;AACH,iEAAiE;AACjE,8DAA8D;AAC9D,+BAA+B;AACxB,KAAK,UAAU,aAAa,CACjC,KAA2B,EAC3B,QAAyB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAkB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAkB;QACzB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AA5BD,sCA4BC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,OAAyB;IAChD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAFD,4BAEC","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type {\n  ValidatorContext,\n  ValidatorFix,\n  ValidatorMeta,\n  ValidatorReport,\n  ValidatorSeverity,\n} from './validator-types';\nimport * as defaultValidators from './validators';\nimport type { SnapFiles, UnvalidatedSnapFiles } from '../types';\n\nexport type ValidatorResults = {\n  files?: SnapFiles;\n  reports: ValidatorReport[];\n};\n\nclass Context implements ValidatorContext {\n  reports: ValidatorReport[] = [];\n\n  #nextSeverity?: ValidatorSeverity = undefined;\n\n  report(message: string, fix?: ValidatorFix): void {\n    assert(this.#nextSeverity !== undefined);\n    this.reports.push({\n      severity: this.#nextSeverity,\n      message,\n      fix,\n    });\n  }\n\n  prepareForValidator(settings: { severity: ValidatorSeverity }) {\n    this.#nextSeverity = settings.severity;\n  }\n\n  get hasErrors() {\n    return this.reports.some((report) => report.severity === 'error');\n  }\n}\n\n/**\n * Verify that snap files are completely valid.\n * First it runs validators on unparsed files to check structure.\n * Secondly it runs validators on parsed files to check semantics.\n *\n * @param files - All files required to run a snap.\n * @param rules - Validators to run.\n * @returns The validation results.\n */\n// TODO(ritave): snap.manifest.json and package.json should check\n//               json parsing as well instead of assuming it's\n//               already parsed\nexport async function runValidators(\n  files: UnvalidatedSnapFiles,\n  rules: ValidatorMeta[] = Object.values(defaultValidators),\n): Promise<ValidatorResults> {\n  const context = new Context();\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.structureCheck?.(files, context);\n  }\n  if (context.hasErrors) {\n    return {\n      reports: context.reports,\n    };\n  }\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.semanticCheck?.(files as SnapFiles, context);\n  }\n  return {\n    files: files as SnapFiles,\n    reports: context.reports,\n  };\n}\n\n/**\n * Get whether any reports has pending fixes.\n *\n * @param results - Results of the validation run.\n * @returns Whether there are fixes pending.\n */\nexport function hasFixes(results: ValidatorResults): boolean {\n  return results.reports.some((report) => report.fix);\n}\n"]}
+{"version":3,"file":"validator.cjs","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAAyC;AAUzC,0EAAkD;AAQlD,MAAM,OAAO;IAOX;;;;;OAKG;IACH,YAAY,OAAgC;QAZ5C,YAAO,GAAsB,EAAE,CAAC;QAEvB,2BAAoC,EAAE,EAAC;QAEhD,gCAAoC,SAAS,EAAC;QAS5C,uBAAA,IAAI,oBAAY,OAAO,MAAA,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,GAAkB;QACxC,IAAA,cAAM,EAAC,uBAAA,IAAI,6BAAc,KAAK,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,uBAAA,IAAI,6BAAc;YAC5B,OAAO;YACP,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,QAAyC;QAC3D,uBAAA,IAAI,yBAAiB,QAAQ,CAAC,QAAQ,MAAA,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO;QACT,OAAO,uBAAA,IAAI,wBAAS,CAAC;IACvB,CAAC;CACF;;AAED;;;;;;;;;;GAUG;AACH,iEAAiE;AACjE,8DAA8D;AAC9D,+BAA+B;AACxB,KAAK,UAAU,aAAa,CACjC,KAA2B,EAC3B,QAAyB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,EACzD,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAkB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAkB;QACzB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AA/BD,sCA+BC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,OAAyB;IAChD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC;AAFD,4BAEC","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type {\n  ValidatorContext,\n  ValidatorContextOptions,\n  ValidatorFix,\n  ValidatorMeta,\n  ValidatorReport,\n  ValidatorSeverity,\n} from './validator-types';\nimport * as defaultValidators from './validators';\nimport type { SnapFiles, UnvalidatedSnapFiles } from '../types';\n\nexport type ValidatorResults = {\n  files?: SnapFiles;\n  reports: ValidatorReport[];\n};\n\nclass Context implements ValidatorContext {\n  reports: ValidatorReport[] = [];\n\n  readonly #options: ValidatorContextOptions = {};\n\n  #nextSeverity?: ValidatorSeverity = undefined;\n\n  /**\n   * Construct a new validator context.\n   *\n   * @param options - The options for the validator context.\n   * @param options.exports - Exports detected by evaluating the bundle.\n   */\n  constructor(options: ValidatorContextOptions) {\n    this.#options = options;\n  }\n\n  report(message: string, fix?: ValidatorFix): void {\n    assert(this.#nextSeverity !== undefined);\n    this.reports.push({\n      severity: this.#nextSeverity,\n      message,\n      fix,\n    });\n  }\n\n  prepareForValidator(settings: { severity: ValidatorSeverity }) {\n    this.#nextSeverity = settings.severity;\n  }\n\n  get hasErrors() {\n    return this.reports.some((report) => report.severity === 'error');\n  }\n\n  get options() {\n    return this.#options;\n  }\n}\n\n/**\n * Verify that snap files are completely valid.\n * First it runs validators on unparsed files to check structure.\n * Secondly it runs validators on parsed files to check semantics.\n *\n * @param files - All files required to run a snap.\n * @param rules - Validators to run.\n * @param options - Options for the validation.\n * @param options.exports - Exports detected by evaluating the bundle.\n * @returns The validation results.\n */\n// TODO(ritave): snap.manifest.json and package.json should check\n//               json parsing as well instead of assuming it's\n//               already parsed\nexport async function runValidators(\n  files: UnvalidatedSnapFiles,\n  rules: ValidatorMeta[] = Object.values(defaultValidators),\n  options: ValidatorContextOptions = {},\n): Promise<ValidatorResults> {\n  const context = new Context(options);\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.structureCheck?.(files, context);\n  }\n\n  if (context.hasErrors) {\n    return {\n      reports: context.reports,\n    };\n  }\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.semanticCheck?.(files as SnapFiles, context);\n  }\n\n  return {\n    files: files as SnapFiles,\n    reports: context.reports,\n  };\n}\n\n/**\n * Get whether any reports has pending fixes.\n *\n * @param results - Results of the validation run.\n * @returns Whether there are fixes pending.\n */\nexport function hasFixes(results: ValidatorResults): boolean {\n  return results.reports.some((report) => report.fix);\n}\n"]}

package/dist/manifest/validator.d.cts

@@ -1,4 +1,4 @@
-import type { ValidatorMeta, ValidatorReport } from "./validator-types.cjs";
+import type { ValidatorContextOptions, ValidatorMeta, ValidatorReport } from "./validator-types.cjs";
 import type { SnapFiles, UnvalidatedSnapFiles } from "../types.cjs";
 export type ValidatorResults = {
     files?: SnapFiles;
@@ -11,9 +11,11 @@ export type ValidatorResults = {
  *
  * @param files - All files required to run a snap.
  * @param rules - Validators to run.
+ * @param options - Options for the validation.
+ * @param options.exports - Exports detected by evaluating the bundle.
  * @returns The validation results.
  */
-export declare function runValidators(files: UnvalidatedSnapFiles, rules?: ValidatorMeta[]): Promise<ValidatorResults>;
+export declare function runValidators(files: UnvalidatedSnapFiles, rules?: ValidatorMeta[], options?: ValidatorContextOptions): Promise<ValidatorResults>;
 /**
  * Get whether any reports has pending fixes.
  *

package/dist/manifest/validator.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.cts","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACb,eAAe,EAEhB,8BAA0B;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAiB;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAyBF;;;;;;;;GAQG;AAIH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,GAAE,aAAa,EAAqC,GACxD,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"validator.d.cts","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,aAAa,EACb,eAAe,EAEhB,8BAA0B;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAiB;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAyCF;;;;;;;;;;GAUG;AAIH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,GAAE,aAAa,EAAqC,EACzD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE3D"}

package/dist/manifest/validator.d.mts

@@ -1,4 +1,4 @@
-import type { ValidatorMeta, ValidatorReport } from "./validator-types.mjs";
+import type { ValidatorContextOptions, ValidatorMeta, ValidatorReport } from "./validator-types.mjs";
 import type { SnapFiles, UnvalidatedSnapFiles } from "../types.mjs";
 export type ValidatorResults = {
     files?: SnapFiles;
@@ -11,9 +11,11 @@ export type ValidatorResults = {
  *
  * @param files - All files required to run a snap.
  * @param rules - Validators to run.
+ * @param options - Options for the validation.
+ * @param options.exports - Exports detected by evaluating the bundle.
  * @returns The validation results.
  */
-export declare function runValidators(files: UnvalidatedSnapFiles, rules?: ValidatorMeta[]): Promise<ValidatorResults>;
+export declare function runValidators(files: UnvalidatedSnapFiles, rules?: ValidatorMeta[], options?: ValidatorContextOptions): Promise<ValidatorResults>;
 /**
  * Get whether any reports has pending fixes.
  *

package/dist/manifest/validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.mts","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACb,eAAe,EAEhB,8BAA0B;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAiB;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAyBF;;;;;;;;GAQG;AAIH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,GAAE,aAAa,EAAqC,GACxD,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"validator.d.mts","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,aAAa,EACb,eAAe,EAEhB,8BAA0B;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,qBAAiB;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAyCF;;;;;;;;;;GAUG;AAIH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,GAAE,aAAa,EAAqC,EACzD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE3D"}

package/dist/manifest/validator.mjs

@@ -1,21 +1,29 @@
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _Context_nextSeverity;
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Context_options, _Context_nextSeverity;
 import { assert } from "@metamask/utils";
 import * as defaultValidators from "./validators/index.mjs";
 class Context {
-    constructor() {
+    /**
+     * Construct a new validator context.
+     *
+     * @param options - The options for the validator context.
+     * @param options.exports - Exports detected by evaluating the bundle.
+     */
+    constructor(options) {
         this.reports = [];
+        _Context_options.set(this, {});
         _Context_nextSeverity.set(this, undefined);
+        __classPrivateFieldSet(this, _Context_options, options, "f");
     }
     report(message, fix) {
         assert(__classPrivateFieldGet(this, _Context_nextSeverity, "f") !== undefined);
@@ -31,8 +39,11 @@ class Context {
     get hasErrors() {
         return this.reports.some((report) => report.severity === 'error');
     }
+    get options() {
+        return __classPrivateFieldGet(this, _Context_options, "f");
+    }
 }
-_Context_nextSeverity = new WeakMap();
+_Context_options = new WeakMap(), _Context_nextSeverity = new WeakMap();
 /**
  * Verify that snap files are completely valid.
  * First it runs validators on unparsed files to check structure.
@@ -40,13 +51,15 @@ _Context_nextSeverity = new WeakMap();
  *
  * @param files - All files required to run a snap.
  * @param rules - Validators to run.
+ * @param options - Options for the validation.
+ * @param options.exports - Exports detected by evaluating the bundle.
  * @returns The validation results.
  */
 // TODO(ritave): snap.manifest.json and package.json should check
 //               json parsing as well instead of assuming it's
 //               already parsed
-export async function runValidators(files, rules = Object.values(defaultValidators)) {
-    const context = new Context();
+export async function runValidators(files, rules = Object.values(defaultValidators), options = {}) {
+    const context = new Context(options);
     for (const rule of rules) {
         context.prepareForValidator({
             severity: rule.severity,

package/dist/manifest/validator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validator.mjs","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,wBAAwB;AASzC,OAAO,KAAK,iBAAiB,+BAAqB;AAQlD,MAAM,OAAO;IAAb;QACE,YAAO,GAAsB,EAAE,CAAC;QAEhC,gCAAoC,SAAS,EAAC;IAkBhD,CAAC;IAhBC,MAAM,CAAC,OAAe,EAAE,GAAkB;QACxC,MAAM,CAAC,uBAAA,IAAI,6BAAc,KAAK,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,uBAAA,IAAI,6BAAc;YAC5B,OAAO;YACP,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,QAAyC;QAC3D,uBAAA,IAAI,yBAAiB,QAAQ,CAAC,QAAQ,MAAA,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,CAAC;CACF;;AAED;;;;;;;;GAQG;AACH,iEAAiE;AACjE,8DAA8D;AAC9D,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA2B,EAC3B,QAAyB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAEzD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAkB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAkB;QACzB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type {\n  ValidatorContext,\n  ValidatorFix,\n  ValidatorMeta,\n  ValidatorReport,\n  ValidatorSeverity,\n} from './validator-types';\nimport * as defaultValidators from './validators';\nimport type { SnapFiles, UnvalidatedSnapFiles } from '../types';\n\nexport type ValidatorResults = {\n  files?: SnapFiles;\n  reports: ValidatorReport[];\n};\n\nclass Context implements ValidatorContext {\n  reports: ValidatorReport[] = [];\n\n  #nextSeverity?: ValidatorSeverity = undefined;\n\n  report(message: string, fix?: ValidatorFix): void {\n    assert(this.#nextSeverity !== undefined);\n    this.reports.push({\n      severity: this.#nextSeverity,\n      message,\n      fix,\n    });\n  }\n\n  prepareForValidator(settings: { severity: ValidatorSeverity }) {\n    this.#nextSeverity = settings.severity;\n  }\n\n  get hasErrors() {\n    return this.reports.some((report) => report.severity === 'error');\n  }\n}\n\n/**\n * Verify that snap files are completely valid.\n * First it runs validators on unparsed files to check structure.\n * Secondly it runs validators on parsed files to check semantics.\n *\n * @param files - All files required to run a snap.\n * @param rules - Validators to run.\n * @returns The validation results.\n */\n// TODO(ritave): snap.manifest.json and package.json should check\n//               json parsing as well instead of assuming it's\n//               already parsed\nexport async function runValidators(\n  files: UnvalidatedSnapFiles,\n  rules: ValidatorMeta[] = Object.values(defaultValidators),\n): Promise<ValidatorResults> {\n  const context = new Context();\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.structureCheck?.(files, context);\n  }\n  if (context.hasErrors) {\n    return {\n      reports: context.reports,\n    };\n  }\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.semanticCheck?.(files as SnapFiles, context);\n  }\n  return {\n    files: files as SnapFiles,\n    reports: context.reports,\n  };\n}\n\n/**\n * Get whether any reports has pending fixes.\n *\n * @param results - Results of the validation run.\n * @returns Whether there are fixes pending.\n */\nexport function hasFixes(results: ValidatorResults): boolean {\n  return results.reports.some((report) => report.fix);\n}\n"]}
+{"version":3,"file":"validator.mjs","sourceRoot":"","sources":["../../src/manifest/validator.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,wBAAwB;AAUzC,OAAO,KAAK,iBAAiB,+BAAqB;AAQlD,MAAM,OAAO;IAOX;;;;;OAKG;IACH,YAAY,OAAgC;QAZ5C,YAAO,GAAsB,EAAE,CAAC;QAEvB,2BAAoC,EAAE,EAAC;QAEhD,gCAAoC,SAAS,EAAC;QAS5C,uBAAA,IAAI,oBAAY,OAAO,MAAA,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,OAAe,EAAE,GAAkB;QACxC,MAAM,CAAC,uBAAA,IAAI,6BAAc,KAAK,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,uBAAA,IAAI,6BAAc;YAC5B,OAAO;YACP,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB,CAAC,QAAyC;QAC3D,uBAAA,IAAI,yBAAiB,QAAQ,CAAC,QAAQ,MAAA,CAAC;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO;QACT,OAAO,uBAAA,IAAI,wBAAS,CAAC;IACvB,CAAC;CACF;;AAED;;;;;;;;;;GAUG;AACH,iEAAiE;AACjE,8DAA8D;AAC9D,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA2B,EAC3B,QAAyB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,EACzD,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAkB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAkB;QACzB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB;IAChD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type {\n  ValidatorContext,\n  ValidatorContextOptions,\n  ValidatorFix,\n  ValidatorMeta,\n  ValidatorReport,\n  ValidatorSeverity,\n} from './validator-types';\nimport * as defaultValidators from './validators';\nimport type { SnapFiles, UnvalidatedSnapFiles } from '../types';\n\nexport type ValidatorResults = {\n  files?: SnapFiles;\n  reports: ValidatorReport[];\n};\n\nclass Context implements ValidatorContext {\n  reports: ValidatorReport[] = [];\n\n  readonly #options: ValidatorContextOptions = {};\n\n  #nextSeverity?: ValidatorSeverity = undefined;\n\n  /**\n   * Construct a new validator context.\n   *\n   * @param options - The options for the validator context.\n   * @param options.exports - Exports detected by evaluating the bundle.\n   */\n  constructor(options: ValidatorContextOptions) {\n    this.#options = options;\n  }\n\n  report(message: string, fix?: ValidatorFix): void {\n    assert(this.#nextSeverity !== undefined);\n    this.reports.push({\n      severity: this.#nextSeverity,\n      message,\n      fix,\n    });\n  }\n\n  prepareForValidator(settings: { severity: ValidatorSeverity }) {\n    this.#nextSeverity = settings.severity;\n  }\n\n  get hasErrors() {\n    return this.reports.some((report) => report.severity === 'error');\n  }\n\n  get options() {\n    return this.#options;\n  }\n}\n\n/**\n * Verify that snap files are completely valid.\n * First it runs validators on unparsed files to check structure.\n * Secondly it runs validators on parsed files to check semantics.\n *\n * @param files - All files required to run a snap.\n * @param rules - Validators to run.\n * @param options - Options for the validation.\n * @param options.exports - Exports detected by evaluating the bundle.\n * @returns The validation results.\n */\n// TODO(ritave): snap.manifest.json and package.json should check\n//               json parsing as well instead of assuming it's\n//               already parsed\nexport async function runValidators(\n  files: UnvalidatedSnapFiles,\n  rules: ValidatorMeta[] = Object.values(defaultValidators),\n  options: ValidatorContextOptions = {},\n): Promise<ValidatorResults> {\n  const context = new Context(options);\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.structureCheck?.(files, context);\n  }\n\n  if (context.hasErrors) {\n    return {\n      reports: context.reports,\n    };\n  }\n\n  for (const rule of rules) {\n    context.prepareForValidator({\n      severity: rule.severity,\n    });\n    await rule.semanticCheck?.(files as SnapFiles, context);\n  }\n\n  return {\n    files: files as SnapFiles,\n    reports: context.reports,\n  };\n}\n\n/**\n * Get whether any reports has pending fixes.\n *\n * @param results - Results of the validation run.\n * @returns Whether there are fixes pending.\n */\nexport function hasFixes(results: ValidatorResults): boolean {\n  return results.reports.some((report) => report.fix);\n}\n"]}

package/dist/manifest/validators/index.cjs

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./checksum.cjs"), exports);
 __exportStar(require("./expected-files.cjs"), exports);
+__exportStar(require("./unused-exports.cjs"), exports);
 __exportStar(require("./icon-dimensions.cjs"), exports);
 __exportStar(require("./is-localization-file.cjs"), exports);
 __exportStar(require("./is-package-json.cjs"), exports);
@@ -25,6 +26,7 @@ __exportStar(require("./manifest-localization.cjs"), exports);
 __exportStar(require("./package-json-recommended-fields.cjs"), exports);
 __exportStar(require("./package-name-match.cjs"), exports);
 __exportStar(require("./platform-version.cjs"), exports);
+__exportStar(require("./production-platform-version.cjs"), exports);
 __exportStar(require("./repository-match.cjs"), exports);
 __exportStar(require("./version-match.cjs"), exports);
 __exportStar(require("./icon-declared.cjs"), exports);

package/dist/manifest/validators/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA2B;AAC3B,uDAAiC;AACjC,wDAAkC;AAClC,6DAAuC;AACvC,wDAAkC;AAClC,qDAA+B;AAC/B,yDAAmC;AACnC,8DAAwC;AACxC,wEAAkD;AAClD,2DAAqC;AACrC,yDAAmC;AACnC,yDAAmC;AACnC,sDAAgC;AAChC,sDAAgC;AAChC,qDAA+B","sourcesContent":["export * from './checksum';\nexport * from './expected-files';\nexport * from './icon-dimensions';\nexport * from './is-localization-file';\nexport * from './is-package-json';\nexport * from './is-snap-icon';\nexport * from './is-snap-manifest';\nexport * from './manifest-localization';\nexport * from './package-json-recommended-fields';\nexport * from './package-name-match';\nexport * from './platform-version';\nexport * from './repository-match';\nexport * from './version-match';\nexport * from './icon-declared';\nexport * from './icon-missing';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA2B;AAC3B,uDAAiC;AACjC,uDAAiC;AACjC,wDAAkC;AAClC,6DAAuC;AACvC,wDAAkC;AAClC,qDAA+B;AAC/B,yDAAmC;AACnC,8DAAwC;AACxC,wEAAkD;AAClD,2DAAqC;AACrC,yDAAmC;AACnC,oEAA8C;AAC9C,yDAAmC;AACnC,sDAAgC;AAChC,sDAAgC;AAChC,qDAA+B","sourcesContent":["export * from './checksum';\nexport * from './expected-files';\nexport * from './unused-exports';\nexport * from './icon-dimensions';\nexport * from './is-localization-file';\nexport * from './is-package-json';\nexport * from './is-snap-icon';\nexport * from './is-snap-manifest';\nexport * from './manifest-localization';\nexport * from './package-json-recommended-fields';\nexport * from './package-name-match';\nexport * from './platform-version';\nexport * from './production-platform-version';\nexport * from './repository-match';\nexport * from './version-match';\nexport * from './icon-declared';\nexport * from './icon-missing';\n"]}

package/dist/manifest/validators/index.d.cts

@@ -1,5 +1,6 @@
 export * from "./checksum.cjs";
 export * from "./expected-files.cjs";
+export * from "./unused-exports.cjs";
 export * from "./icon-dimensions.cjs";
 export * from "./is-localization-file.cjs";
 export * from "./is-package-json.cjs";
@@ -9,6 +10,7 @@ export * from "./manifest-localization.cjs";
 export * from "./package-json-recommended-fields.cjs";
 export * from "./package-name-match.cjs";
 export * from "./platform-version.cjs";
+export * from "./production-platform-version.cjs";
 export * from "./repository-match.cjs";
 export * from "./version-match.cjs";
 export * from "./icon-declared.cjs";

package/dist/manifest/validators/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,kDAA8C;AAC9C,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B"}

package/dist/manifest/validators/index.d.mts

@@ -1,5 +1,6 @@
 export * from "./checksum.mjs";
 export * from "./expected-files.mjs";
+export * from "./unused-exports.mjs";
 export * from "./icon-dimensions.mjs";
 export * from "./is-localization-file.mjs";
 export * from "./is-package-json.mjs";
@@ -9,6 +10,7 @@ export * from "./manifest-localization.mjs";
 export * from "./package-json-recommended-fields.mjs";
 export * from "./package-name-match.mjs";
 export * from "./platform-version.mjs";
+export * from "./production-platform-version.mjs";
 export * from "./repository-match.mjs";
 export * from "./version-match.mjs";
 export * from "./icon-declared.mjs";

package/dist/manifest/validators/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,kDAA8C;AAC9C,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B"}

package/dist/manifest/validators/index.mjs

@@ -1,5 +1,6 @@
 export * from "./checksum.mjs";
 export * from "./expected-files.mjs";
+export * from "./unused-exports.mjs";
 export * from "./icon-dimensions.mjs";
 export * from "./is-localization-file.mjs";
 export * from "./is-package-json.mjs";
@@ -9,6 +10,7 @@ export * from "./manifest-localization.mjs";
 export * from "./package-json-recommended-fields.mjs";
 export * from "./package-name-match.mjs";
 export * from "./platform-version.mjs";
+export * from "./production-platform-version.mjs";
 export * from "./repository-match.mjs";
 export * from "./version-match.mjs";
 export * from "./icon-declared.mjs";

package/dist/manifest/validators/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B","sourcesContent":["export * from './checksum';\nexport * from './expected-files';\nexport * from './icon-dimensions';\nexport * from './is-localization-file';\nexport * from './is-package-json';\nexport * from './is-snap-icon';\nexport * from './is-snap-manifest';\nexport * from './manifest-localization';\nexport * from './package-json-recommended-fields';\nexport * from './package-name-match';\nexport * from './platform-version';\nexport * from './repository-match';\nexport * from './version-match';\nexport * from './icon-declared';\nexport * from './icon-missing';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/manifest/validators/index.ts"],"names":[],"mappings":"AAAA,+BAA2B;AAC3B,qCAAiC;AACjC,qCAAiC;AACjC,sCAAkC;AAClC,2CAAuC;AACvC,sCAAkC;AAClC,mCAA+B;AAC/B,uCAAmC;AACnC,4CAAwC;AACxC,sDAAkD;AAClD,yCAAqC;AACrC,uCAAmC;AACnC,kDAA8C;AAC9C,uCAAmC;AACnC,oCAAgC;AAChC,oCAAgC;AAChC,mCAA+B","sourcesContent":["export * from './checksum';\nexport * from './expected-files';\nexport * from './unused-exports';\nexport * from './icon-dimensions';\nexport * from './is-localization-file';\nexport * from './is-package-json';\nexport * from './is-snap-icon';\nexport * from './is-snap-manifest';\nexport * from './manifest-localization';\nexport * from './package-json-recommended-fields';\nexport * from './package-name-match';\nexport * from './platform-version';\nexport * from './production-platform-version';\nexport * from './repository-match';\nexport * from './version-match';\nexport * from './icon-declared';\nexport * from './icon-missing';\n"]}

package/dist/manifest/validators/production-platform-version.cjs

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productionPlatformVersion = void 0;
+const utils_1 = require("@metamask/utils");
+const semver_1 = require("semver");
+const fs_1 = require("../../fs.cjs");
+/**
+ * Determine the production version of the Snaps platform by inspecting
+ * the latest GitHub release of the MetaMask extension.
+ *
+ * @returns The production version of the Snaps platform or null if any error occurred.
+ */
+const determineProductionVersion = (0, fs_1.useFileSystemCache)('snaps-production-version', (0, utils_1.inMilliseconds)(3, utils_1.Duration.Day), async () => {
+    try {
+        const latestRelease = await fetch('https://api.github.com/repos/metamask/metamask-extension/releases/latest');
+        const latestReleaseJson = await latestRelease.json();
+        const latestReleaseCommit = latestReleaseJson.target_commitish;
+        const packageJsonResponse = await fetch(`https://api.github.com/repos/metamask/metamask-extension/contents/package.json?ref=${latestReleaseCommit}`, { headers: new Headers({ accept: 'application/vnd.github.raw+json' }) });
+        const packageJson = await packageJsonResponse.json();
+        const versionRange = packageJson.dependencies['@metamask/snaps-sdk'];
+        return (0, semver_1.minVersion)(versionRange)?.format();
+    }
+    catch {
+        return null;
+    }
+});
+/**
+ * Check if the platform version in manifest exceeds the version
+ * used in production.
+ */
+exports.productionPlatformVersion = {
+    severity: 'warning',
+    async semanticCheck(files, context) {
+        const manifestPlatformVersion = files.manifest.result.platformVersion;
+        if (!manifestPlatformVersion) {
+            return;
+        }
+        const maximumVersion = await determineProductionVersion();
+        if (!maximumVersion) {
+            return;
+        }
+        if ((0, semver_1.gt)(manifestPlatformVersion, maximumVersion)) {
+            context.report(`The specified platform version "${manifestPlatformVersion}" is not supported in the production version of MetaMask. The current maximum supported version is "${maximumVersion}". To resolve this, downgrade \`@metamask/snaps-sdk\` to a compatible version.`);
+        }
+    },
+};
+//# sourceMappingURL=production-platform-version.cjs.map

package/dist/manifest/validators/production-platform-version.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-platform-version.cjs","sourceRoot":"","sources":["../../../src/manifest/validators/production-platform-version.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAC3D,mCAAwC;AAExC,qCAA8C;AAG9C;;;;;GAKG;AACH,MAAM,0BAA0B,GAAG,IAAA,uBAAkB,EACnD,0BAA0B,EAC1B,IAAA,sBAAc,EAAC,CAAC,EAAE,gBAAQ,CAAC,GAAG,CAAC,EAC/B,KAAK,IAAI,EAAE;IACT,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAC/B,0EAA0E,CAC3E,CAAC;QAEF,MAAM,iBAAiB,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,gBAAgB,CAAC;QAE/D,MAAM,mBAAmB,GAAG,MAAM,KAAK,CACrC,sFAAsF,mBAAmB,EAAE,EAC3G,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC,EAAE,CACxE,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;QAErE,OAAO,IAAA,mBAAU,EAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CACF,CAAC;AAEF;;;GAGG;AACU,QAAA,yBAAyB,GAAkB;IACtD,QAAQ,EAAE,SAAS;IACnB,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO;QAChC,MAAM,uBAAuB,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC;QAEtE,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,0BAA0B,EAAE,CAAC;QAE1D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,IAAA,WAAE,EAAC,uBAAuB,EAAE,cAAc,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,MAAM,CACZ,mCAAmC,uBAAuB,uGAAuG,cAAc,gFAAgF,CAChQ,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import { Duration, inMilliseconds } from '@metamask/utils';\nimport { minVersion, gt } from 'semver';\n\nimport { useFileSystemCache } from '../../fs';\nimport type { ValidatorMeta } from '../validator-types';\n\n/**\n * Determine the production version of the Snaps platform by inspecting\n * the latest GitHub release of the MetaMask extension.\n *\n * @returns The production version of the Snaps platform or null if any error occurred.\n */\nconst determineProductionVersion = useFileSystemCache(\n  'snaps-production-version',\n  inMilliseconds(3, Duration.Day),\n  async () => {\n    try {\n      const latestRelease = await fetch(\n        'https://api.github.com/repos/metamask/metamask-extension/releases/latest',\n      );\n\n      const latestReleaseJson = await latestRelease.json();\n\n      const latestReleaseCommit = latestReleaseJson.target_commitish;\n\n      const packageJsonResponse = await fetch(\n        `https://api.github.com/repos/metamask/metamask-extension/contents/package.json?ref=${latestReleaseCommit}`,\n        { headers: new Headers({ accept: 'application/vnd.github.raw+json' }) },\n      );\n\n      const packageJson = await packageJsonResponse.json();\n\n      const versionRange = packageJson.dependencies['@metamask/snaps-sdk'];\n\n      return minVersion(versionRange)?.format();\n    } catch {\n      return null;\n    }\n  },\n);\n\n/**\n * Check if the platform version in manifest exceeds the version\n * used in production.\n */\nexport const productionPlatformVersion: ValidatorMeta = {\n  severity: 'warning',\n  async semanticCheck(files, context) {\n    const manifestPlatformVersion = files.manifest.result.platformVersion;\n\n    if (!manifestPlatformVersion) {\n      return;\n    }\n\n    const maximumVersion = await determineProductionVersion();\n\n    if (!maximumVersion) {\n      return;\n    }\n\n    if (gt(manifestPlatformVersion, maximumVersion)) {\n      context.report(\n        `The specified platform version \"${manifestPlatformVersion}\" is not supported in the production version of MetaMask. The current maximum supported version is \"${maximumVersion}\". To resolve this, downgrade \\`@metamask/snaps-sdk\\` to a compatible version.`,\n      );\n    }\n  },\n};\n"]}

package/dist/manifest/validators/production-platform-version.d.cts

@@ -0,0 +1,7 @@
+import type { ValidatorMeta } from "../validator-types.cjs";
+/**
+ * Check if the platform version in manifest exceeds the version
+ * used in production.
+ */
+export declare const productionPlatformVersion: ValidatorMeta;
+//# sourceMappingURL=production-platform-version.d.cts.map

package/dist/manifest/validators/production-platform-version.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-platform-version.d.cts","sourceRoot":"","sources":["../../../src/manifest/validators/production-platform-version.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA2B;AAqCxD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,aAqBvC,CAAC"}

package/dist/manifest/validators/production-platform-version.d.mts

@@ -0,0 +1,7 @@
+import type { ValidatorMeta } from "../validator-types.mjs";
+/**
+ * Check if the platform version in manifest exceeds the version
+ * used in production.
+ */
+export declare const productionPlatformVersion: ValidatorMeta;
+//# sourceMappingURL=production-platform-version.d.mts.map

package/dist/manifest/validators/production-platform-version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-platform-version.d.mts","sourceRoot":"","sources":["../../../src/manifest/validators/production-platform-version.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA2B;AAqCxD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,aAqBvC,CAAC"}

package/dist/manifest/validators/production-platform-version.mjs

@@ -0,0 +1,44 @@
+import { Duration, inMilliseconds } from "@metamask/utils";
+import { minVersion, gt } from "semver";
+import { useFileSystemCache } from "../../fs.mjs";
+/**
+ * Determine the production version of the Snaps platform by inspecting
+ * the latest GitHub release of the MetaMask extension.
+ *
+ * @returns The production version of the Snaps platform or null if any error occurred.
+ */
+const determineProductionVersion = useFileSystemCache('snaps-production-version', inMilliseconds(3, Duration.Day), async () => {
+    try {
+        const latestRelease = await fetch('https://api.github.com/repos/metamask/metamask-extension/releases/latest');
+        const latestReleaseJson = await latestRelease.json();
+        const latestReleaseCommit = latestReleaseJson.target_commitish;
+        const packageJsonResponse = await fetch(`https://api.github.com/repos/metamask/metamask-extension/contents/package.json?ref=${latestReleaseCommit}`, { headers: new Headers({ accept: 'application/vnd.github.raw+json' }) });
+        const packageJson = await packageJsonResponse.json();
+        const versionRange = packageJson.dependencies['@metamask/snaps-sdk'];
+        return minVersion(versionRange)?.format();
+    }
+    catch {
+        return null;
+    }
+});
+/**
+ * Check if the platform version in manifest exceeds the version
+ * used in production.
+ */
+export const productionPlatformVersion = {
+    severity: 'warning',
+    async semanticCheck(files, context) {
+        const manifestPlatformVersion = files.manifest.result.platformVersion;
+        if (!manifestPlatformVersion) {
+            return;
+        }
+        const maximumVersion = await determineProductionVersion();
+        if (!maximumVersion) {
+            return;
+        }
+        if (gt(manifestPlatformVersion, maximumVersion)) {
+            context.report(`The specified platform version "${manifestPlatformVersion}" is not supported in the production version of MetaMask. The current maximum supported version is "${maximumVersion}". To resolve this, downgrade \`@metamask/snaps-sdk\` to a compatible version.`);
+        }
+    },
+};
+//# sourceMappingURL=production-platform-version.mjs.map

package/dist/manifest/validators/production-platform-version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-platform-version.mjs","sourceRoot":"","sources":["../../../src/manifest/validators/production-platform-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,wBAAwB;AAC3D,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,eAAe;AAExC,OAAO,EAAE,kBAAkB,EAAE,qBAAiB;AAG9C;;;;;GAKG;AACH,MAAM,0BAA0B,GAAG,kBAAkB,CACnD,0BAA0B,EAC1B,cAAc,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,EAC/B,KAAK,IAAI,EAAE;IACT,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAC/B,0EAA0E,CAC3E,CAAC;QAEF,MAAM,iBAAiB,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,gBAAgB,CAAC;QAE/D,MAAM,mBAAmB,GAAG,MAAM,KAAK,CACrC,sFAAsF,mBAAmB,EAAE,EAC3G,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC,EAAE,CACxE,CAAC;QAEF,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC;QAErE,OAAO,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAkB;IACtD,QAAQ,EAAE,SAAS;IACnB,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO;QAChC,MAAM,uBAAuB,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,CAAC;QAEtE,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,0BAA0B,EAAE,CAAC;QAE1D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,MAAM,CACZ,mCAAmC,uBAAuB,uGAAuG,cAAc,gFAAgF,CAChQ,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import { Duration, inMilliseconds } from '@metamask/utils';\nimport { minVersion, gt } from 'semver';\n\nimport { useFileSystemCache } from '../../fs';\nimport type { ValidatorMeta } from '../validator-types';\n\n/**\n * Determine the production version of the Snaps platform by inspecting\n * the latest GitHub release of the MetaMask extension.\n *\n * @returns The production version of the Snaps platform or null if any error occurred.\n */\nconst determineProductionVersion = useFileSystemCache(\n  'snaps-production-version',\n  inMilliseconds(3, Duration.Day),\n  async () => {\n    try {\n      const latestRelease = await fetch(\n        'https://api.github.com/repos/metamask/metamask-extension/releases/latest',\n      );\n\n      const latestReleaseJson = await latestRelease.json();\n\n      const latestReleaseCommit = latestReleaseJson.target_commitish;\n\n      const packageJsonResponse = await fetch(\n        `https://api.github.com/repos/metamask/metamask-extension/contents/package.json?ref=${latestReleaseCommit}`,\n        { headers: new Headers({ accept: 'application/vnd.github.raw+json' }) },\n      );\n\n      const packageJson = await packageJsonResponse.json();\n\n      const versionRange = packageJson.dependencies['@metamask/snaps-sdk'];\n\n      return minVersion(versionRange)?.format();\n    } catch {\n      return null;\n    }\n  },\n);\n\n/**\n * Check if the platform version in manifest exceeds the version\n * used in production.\n */\nexport const productionPlatformVersion: ValidatorMeta = {\n  severity: 'warning',\n  async semanticCheck(files, context) {\n    const manifestPlatformVersion = files.manifest.result.platformVersion;\n\n    if (!manifestPlatformVersion) {\n      return;\n    }\n\n    const maximumVersion = await determineProductionVersion();\n\n    if (!maximumVersion) {\n      return;\n    }\n\n    if (gt(manifestPlatformVersion, maximumVersion)) {\n      context.report(\n        `The specified platform version \"${manifestPlatformVersion}\" is not supported in the production version of MetaMask. The current maximum supported version is \"${maximumVersion}\". To resolve this, downgrade \\`@metamask/snaps-sdk\\` to a compatible version.`,\n      );\n    }\n  },\n};\n"]}

package/dist/manifest/validators/unused-exports.cjs

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unusedExports = void 0;
+/**
+ * Check if the Snap exports handlers that are not requested in the manifest, or
+ * if the Snap requests permissions for handlers that are not exported.
+ */
+exports.unusedExports = {
+    severity: 'warning',
+    semanticCheck(files, context) {
+        const { handlerEndowments, exports } = context.options ?? {};
+        // The handler endowments or exports must be provided for this check to be
+        // performed.
+        if (!handlerEndowments || !exports) {
+            return;
+        }
+        const unusedHandlers = Object.entries(handlerEndowments)
+            .filter(([handler, endowment]) => {
+            if (endowment === null) {
+                return false;
+            }
+            return (exports.includes(handler) &&
+                !files.manifest.result.initialPermissions[endowment]);
+        })
+            .map(([handler, endowment]) => `${handler} (${endowment})`);
+        const unusedEndowments = Object.entries(handlerEndowments).filter(([handler, endowment]) => {
+            if (endowment === null) {
+                return false;
+            }
+            return (files.manifest.result.initialPermissions[endowment] && !exports.includes(handler));
+        });
+        if (unusedHandlers.length > 0) {
+            // We don't specify a fix function here, because:
+            // 1. Removing the export from the Snap bundle is complicated, as it
+            //    requires AST manipulation.
+            // 2. Adding the permission to the manifest is not always possible, as it
+            //    may require additional configuration in the manifest.
+            context.report(`The Snap exports the following handlers, but does not request permission for them: ${unusedHandlers.join(', ')}.`);
+        }
+        if (unusedEndowments.length > 0) {
+            const formattedEndowments = unusedEndowments
+                .map(([handler, endowment]) => `${handler} (${endowment})`)
+                .join(', ');
+            context.report(`The Snap requests permission for the following handlers, but does not export them: ${formattedEndowments}.`, ({ manifest }) => {
+                unusedEndowments.forEach(([, endowment]) => {
+                    delete manifest.initialPermissions[endowment];
+                });
+                return { manifest };
+            });
+        }
+    },
+};
+//# sourceMappingURL=unused-exports.cjs.map

package/dist/manifest/validators/unused-exports.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-exports.cjs","sourceRoot":"","sources":["../../../src/manifest/validators/unused-exports.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACU,QAAA,aAAa,GAAkB;IAC1C,QAAQ,EAAE,SAAS;IACnB,aAAa,CAAC,KAAK,EAAE,OAAO;QAC1B,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAE7D,0EAA0E;QAC1E,aAAa;QACb,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC;aACrD,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE;YAC/B,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CACvC,SAAqC,CACtC,CACF,CAAC;QACJ,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,SAAS,GAAG,CAAC,CAAC;QAE9D,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAC/D,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE;YACvB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,CACL,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CACtC,SAAqC,CACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAChC,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,iDAAiD;YACjD,oEAAoE;YACpE,gCAAgC;YAChC,yEAAyE;YACzE,2DAA2D;YAC3D,OAAO,CAAC,MAAM,CACZ,sFAAsF,cAAc,CAAC,IAAI,CACvG,IAAI,CACL,GAAG,CACL,CAAC;QACJ,CAAC;QAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,mBAAmB,GAAG,gBAAgB;iBACzC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,SAAS,GAAG,CAAC;iBAC1D,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,CAAC,MAAM,CACZ,sFAAsF,mBAAmB,GAAG,EAC5G,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;gBACf,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE;oBACzC,OAAO,QAAQ,CAAC,kBAAkB,CAChC,SAAqC,CACtC,CAAC;gBACJ,CAAC,CAAC,CAAC;gBAEH,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,CAAC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC","sourcesContent":["import type { InitialPermissions } from '@metamask/snaps-sdk';\n\nimport type { ValidatorMeta } from '../validator-types';\n\n/**\n * Check if the Snap exports handlers that are not requested in the manifest, or\n * if the Snap requests permissions for handlers that are not exported.\n */\nexport const unusedExports: ValidatorMeta = {\n  severity: 'warning',\n  semanticCheck(files, context) {\n    const { handlerEndowments, exports } = context.options ?? {};\n\n    // The handler endowments or exports must be provided for this check to be\n    // performed.\n    if (!handlerEndowments || !exports) {\n      return;\n    }\n\n    const unusedHandlers = Object.entries(handlerEndowments)\n      .filter(([handler, endowment]) => {\n        if (endowment === null) {\n          return false;\n        }\n\n        return (\n          exports.includes(handler) &&\n          !files.manifest.result.initialPermissions[\n            endowment as keyof InitialPermissions\n          ]\n        );\n      })\n      .map(([handler, endowment]) => `${handler} (${endowment})`);\n\n    const unusedEndowments = Object.entries(handlerEndowments).filter(\n      ([handler, endowment]) => {\n        if (endowment === null) {\n          return false;\n        }\n\n        return (\n          files.manifest.result.initialPermissions[\n            endowment as keyof InitialPermissions\n          ] && !exports.includes(handler)\n        );\n      },\n    );\n\n    if (unusedHandlers.length > 0) {\n      // We don't specify a fix function here, because:\n      // 1. Removing the export from the Snap bundle is complicated, as it\n      //    requires AST manipulation.\n      // 2. Adding the permission to the manifest is not always possible, as it\n      //    may require additional configuration in the manifest.\n      context.report(\n        `The Snap exports the following handlers, but does not request permission for them: ${unusedHandlers.join(\n          ', ',\n        )}.`,\n      );\n    }\n\n    if (unusedEndowments.length > 0) {\n      const formattedEndowments = unusedEndowments\n        .map(([handler, endowment]) => `${handler} (${endowment})`)\n        .join(', ');\n\n      context.report(\n        `The Snap requests permission for the following handlers, but does not export them: ${formattedEndowments}.`,\n        ({ manifest }) => {\n          unusedEndowments.forEach(([, endowment]) => {\n            delete manifest.initialPermissions[\n              endowment as keyof InitialPermissions\n            ];\n          });\n\n          return { manifest };\n        },\n      );\n    }\n  },\n};\n"]}

package/dist/manifest/validators/unused-exports.d.cts

@@ -0,0 +1,7 @@
+import type { ValidatorMeta } from "../validator-types.cjs";
+/**
+ * Check if the Snap exports handlers that are not requested in the manifest, or
+ * if the Snap requests permissions for handlers that are not exported.
+ */
+export declare const unusedExports: ValidatorMeta;
+//# sourceMappingURL=unused-exports.d.cts.map

package/dist/manifest/validators/unused-exports.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-exports.d.cts","sourceRoot":"","sources":["../../../src/manifest/validators/unused-exports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA2B;AAExD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAwE3B,CAAC"}

package/dist/manifest/validators/unused-exports.d.mts

@@ -0,0 +1,7 @@
+import type { ValidatorMeta } from "../validator-types.mjs";
+/**
+ * Check if the Snap exports handlers that are not requested in the manifest, or
+ * if the Snap requests permissions for handlers that are not exported.
+ */
+export declare const unusedExports: ValidatorMeta;
+//# sourceMappingURL=unused-exports.d.mts.map

package/dist/manifest/validators/unused-exports.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-exports.d.mts","sourceRoot":"","sources":["../../../src/manifest/validators/unused-exports.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA2B;AAExD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,aAwE3B,CAAC"}