MetaMask · Mrtenz · Aug 8, 2025 · Aug 7, 2025 · Aug 7, 2025 · Aug 8, 2025
@@ -6,7 +6,6 @@ import {
   getPackageJson,
   getSnapManifest,
 } from '@metamask/snaps-utils/test-utils';
-import type { SemVerVersion } from '@metamask/utils';
 import normalFs from 'fs';
 import { dirname } from 'path';
 import type { Configuration } from 'webpack';
@@ -58,7 +57,7 @@ describe('build', () => {
   beforeEach(async () => {
     const { manifest } = await getMockSnapFilesWithUpdatedChecksum({
       manifest: getSnapManifest({
-        platformVersion: getPlatformVersion() as SemVerVersion,
+        platformVersion: getPlatformVersion(),
       }),
     });
 

@@ -30,6 +30,13 @@ import {
 import { NpmSnapFileNames } from '../types';
 
 jest.mock('fs');
+jest.mock('../fs', () => ({
+  ...jest.requireActual('../fs'),
+  useFileSystemCache:
+    <Type>(_key: string, _ttl: number, fn: () => Promise<Type>) =>
+    async () =>
+      fn(),
+}));
 
 const BASE_PATH = '/snap';
 const MANIFEST_PATH = join(BASE_PATH, NpmSnapFileNames.Manifest);
@@ -157,6 +164,39 @@ describe('checkManifest', () => {
     expect(version).toBe('1.0.0');
   });
 
+  it('includes new validation warnings', async () => {
+    fetchMock.mockResponseOnce(MOCK_GITHUB_RESPONSE).mockResponseOnce(
+      JSON.stringify({
+        dependencies: {
+          '@metamask/snaps-sdk': '1.0.0',
+        },
+      }),
+    );
+
+    const manifest = getSnapManifest({
+      shasum: '29MYwcRiruhy9BEJpN/TBIhxoD3t0P4OdXztV9rW8tc=',
+    });
+    delete manifest.platformVersion;
+
+    await fs.writeFile(MANIFEST_PATH, JSON.stringify(manifest));
+
+    const { files, updated, reports } = await checkManifest(BASE_PATH);
+    const unfixed = reports.filter((report) => !report.wasFixed);
+    const fixed = reports.filter((report) => report.wasFixed);
+
+    const defaultManifest = await getDefaultManifest();
+
+    expect(files?.manifest.result).toStrictEqual(defaultManifest);
+    expect(updated).toBe(true);
+    expect(unfixed).toHaveLength(1);
+    expect(fixed).toHaveLength(2);
+
+    const file = await readJsonFile<SnapManifest>(MANIFEST_PATH);
+    const { source, version } = file.result;
+    expect(source.shasum).toBe(defaultManifest.source.shasum);
+    expect(version).toBe('1.0.0');
+  });
+
   it('returns a warning if package.json is missing recommended fields', async () => {
     const { repository, ...packageJson } = getPackageJson();
 
@@ -348,7 +388,7 @@ describe('runFixes', () => {
     const rule: ValidatorMeta = {
       severity: 'error',
       semanticCheck(_, context) {
-        context.report('Always fail', (files) => files);
+        context.report('always-fail', 'Always fail', (files) => files);
       },
     };
 
@@ -360,7 +400,9 @@ describe('runFixes', () => {
     expect(fixesResults).toStrictEqual({
       files,
       updated: false,
-      reports: [{ severity: 'error', message: 'Always fail' }],
+      reports: [
+        { id: 'always-fail', severity: 'error', message: 'Always fail' },
+      ],
     });
   });
 });

@@ -232,6 +232,8 @@ export async function runFixes(
   assert(fixResults.files);
   fixResults.files.manifest = fixResults.files.manifest.clone();
 
+  const mergedReports: ValidatorReport[] = deepClone(fixResults.reports);
+
   for (
     let attempts = 1;
     shouldRunFixes && attempts <= MAX_ATTEMPTS;
@@ -259,15 +261,21 @@ export async function runFixes(
 
     fixResults = await runValidators(fixResults.files, rules);
     shouldRunFixes = hasFixes(fixResults, errorsOnly);
+
+    mergedReports.push(
+      ...fixResults.reports.filter(
+        (report) =>
+          !mergedReports.find((mergedReport) => mergedReport.id === report.id),
+      ),
+    );
   }
 
-  const initialReports: (CheckManifestReport & ValidatorReport)[] = deepClone(
-    results.reports,
-  );
+  const allReports: (CheckManifestReport & ValidatorReport)[] =
+    deepClone(mergedReports);
 
   // Was fixed
   if (!shouldRunFixes) {
-    for (const report of initialReports) {
+    for (const report of allReports) {
       if (report.fix) {
         report.wasFixed = true;
         delete report.fix;
@@ -277,18 +285,18 @@ export async function runFixes(
     return {
       files: fixResults.files,
       updated: true,
-      reports: initialReports,
+      reports: allReports,
     };
   }
 
-  for (const report of initialReports) {
+  for (const report of allReports) {
     delete report.fix;
   }
 
   return {
     files: results.files,
     updated: false,
-    reports: initialReports,
+    reports: allReports,
   };
 }
 

@@ -27,11 +27,12 @@ export type ValidatorContextOptions = {
 export type ValidatorSeverity = 'error' | 'warning';
 
 export type ValidatorContext = {
-  readonly report: (message: string, fix?: ValidatorFix) => void;
+  readonly report: (id: string, message: string, fix?: ValidatorFix) => void;
   readonly options?: ValidatorContextOptions;
 };
 
 export type ValidatorReport = {
+  id: string;
   severity: ValidatorSeverity;
   message: string;
   fix?: ValidatorFix;
@@ -41,7 +42,8 @@ export type ValidatorMeta = {
   severity: ValidatorSeverity;
 
   /**
-   * 1. Run the validator on unverified files to ensure that the files are structurally sound.
+   * 1. Run the validator on unverified files to ensure that the files are
+   * structurally sound.
    *
    * @param files - Files to be verified
    * @param context - Validator context to report errors

@@ -33,12 +33,22 @@ class Context implements ValidatorContext {
     this.#options = options;
   }
 
-  report(message: string, fix?: ValidatorFix): void {
+  /**
+   * Report a validation error or warning.
+   *
+   * @param id - The unique identifier for the report.
+   * @param message - The message describing the validation issue.
+   * @param fix - An optional fix function that can be used to automatically
+   * resolve the issue.
+   */
+  report(id: string, message: string, fix?: ValidatorFix): void {
     assert(this.#nextSeverity !== undefined);
+
     this.reports.push({
-      severity: this.#nextSeverity,
+      id,
       message,
       fix,
+      severity: this.#nextSeverity,
     });
   }
 
@@ -80,6 +90,7 @@ export async function runValidators(
     context.prepareForValidator({
       severity: rule.severity,
     });
+
     await rule.structureCheck?.(files, context);
   }
 
@@ -93,6 +104,7 @@ export async function runValidators(
     context.prepareForValidator({
       severity: rule.severity,
     });
+
     await rule.semanticCheck?.(files as SnapFiles, context);
   }
 

@@ -27,6 +27,7 @@ describe('checksum', () => {
 
     expect(report).toHaveBeenCalledTimes(1);
     expect(report).toHaveBeenCalledWith(
+      'checksum',
       expect.stringContaining(
         '"snap.manifest.json" "shasum" field does not match computed shasum.',
       ),
@@ -38,7 +39,7 @@ describe('checksum', () => {
     const manifest = getSnapManifest({ shasum: 'foobar' });
 
     let fix: ValidatorFix | undefined;
-    const report = (_: any, fixer?: ValidatorFix) => {
+    const report = (_id: string, _message: string, fixer?: ValidatorFix) => {
       assert(fixer !== undefined);
       fix = fixer;
     };

@@ -14,6 +14,7 @@ export const checksum: ValidatorMeta = {
     const expectedChecksum = await getSnapChecksum(fetchedFiles);
     if (gotChecksum !== expectedChecksum) {
       context.report(
+        'checksum',
         `"${NpmSnapFileNames.Manifest}" "shasum" field does not match computed shasum. Got "${gotChecksum}", expected "${expectedChecksum}".`,
         async ({ manifest }) => {
           manifest.source.shasum = expectedChecksum;

@@ -25,6 +25,7 @@ describe('expectedFiles', () => {
 
       expect(report).toHaveBeenCalledTimes(1);
       expect(report).toHaveBeenCalledWith(
+        'expected-files',
         expect.stringContaining('Missing file'),
       );
     },

@@ -17,7 +17,10 @@ export const expectedFiles: ValidatorMeta = {
   structureCheck(files, context) {
     for (const expectedFile of EXPECTED_SNAP_FILES) {
       if (!files[expectedFile]) {
-        context.report(`Missing file "${SnapFileNameFromKey[expectedFile]}".`);
+        context.report(
+          'expected-files',
+          `Missing file "${SnapFileNameFromKey[expectedFile]}".`,
+        );
       }
     }
   },

@@ -23,6 +23,7 @@ describe('iconDeclared', () => {
     });
 
     expect(report).toHaveBeenCalledWith(
+      'icon-declared',
       'No icon found in the Snap manifest. It is recommended to include an icon for the Snap. See https://docs.metamask.io/snaps/how-to/design-a-snap/#guidelines-at-a-glance for more information.',
     );
   });

@@ -8,6 +8,7 @@ export const iconDeclared: ValidatorMeta = {
   semanticCheck(files, context) {
     if (!files.manifest.result.source.location.npm.iconPath) {
       context.report(
+        'icon-declared',
         'No icon found in the Snap manifest. It is recommended to include an icon for the Snap. See https://docs.metamask.io/snaps/how-to/design-a-snap/#guidelines-at-a-glance for more information.',
       );
     }

@@ -28,6 +28,7 @@ describe('iconDimensions', () => {
     });
 
     expect(report).toHaveBeenCalledWith(
+      'icon-dimensions',
       'The icon in the Snap manifest is not square. It is recommended to use a square icon for the Snap.',
     );
   });

@@ -14,6 +14,7 @@ export const iconDimensions: ValidatorMeta = {
     const dimensions = getSvgDimensions(files.svgIcon.toString());
     if (dimensions && dimensions?.height !== dimensions.width) {
       context.report(
+        'icon-dimensions',
         'The icon in the Snap manifest is not square. It is recommended to use a square icon for the Snap.',
       );
     }

@@ -23,6 +23,7 @@ describe('iconMissing', () => {
     await iconMissing.semanticCheck(files, { report });
 
     expect(report).toHaveBeenCalledWith(
+      'icon-missing',
       'Could not find icon "images/icon.svg".',
     );
   });

@@ -8,7 +8,7 @@ export const iconMissing: ValidatorMeta = {
   semanticCheck(files, context) {
     const { iconPath } = files.manifest.result.source.location.npm;
     if (iconPath && !files.svgIcon) {
-      context.report(`Could not find icon "${iconPath}".`);
+      context.report('icon-missing', `Could not find icon "${iconPath}".`);
     }
   },
 };
@@ -52,6 +52,7 @@ describe('isLocalizationFile', () => {
     );
 
     expect(report).toHaveBeenCalledWith(
+      'is-localization-file',
       'Failed to validate localization file "/foo": At path: messages — Expected a value of type record, but received: "foo".',
     );
   });

@@ -16,6 +16,7 @@ export const isLocalizationFile: ValidatorMeta = {
       if (error) {
         for (const failure of error.failures()) {
           context.report(
+            'is-localization-file',
             `Failed to validate localization file "${
               file.path
             }": ${getStructFailureMessage(

@@ -64,6 +64,7 @@ describe('isPackageJson', () => {
     );
 
     expect(report).toHaveBeenCalledWith(
+      'is-package-json',
       '"package.json" is invalid: At path: version — Expected SemVer version, got "foo".',
     );
   });

@@ -20,6 +20,7 @@ export const isPackageJson: ValidatorMeta = {
     if (error) {
       for (const failure of error.failures()) {
         context.report(
+          'is-package-json',
           `"${
             NpmSnapFileNames.PackageJson
           }" is invalid: ${getStructFailureMessage(

@@ -32,6 +32,9 @@ describe('isSnapIcon', () => {
       { report },
     );
 
-    expect(report).toHaveBeenCalledWith('Snap icon must be a valid SVG.');
+    expect(report).toHaveBeenCalledWith(
+      'is-snap-icon',
+      'Snap icon must be a valid SVG.',
+    );
   });
 });
@@ -17,7 +17,7 @@ export const isSnapIcon: ValidatorMeta = {
       assertIsSnapIcon(files.svgIcon);
     } catch (error) {
       assert(error instanceof Error);
-      context.report(error.message);
+      context.report('is-snap-icon', error.message);
     }
   },
 };
@@ -42,6 +42,7 @@ describe('isSnapManifest', () => {
     );
 
     expect(report).toHaveBeenCalledWith(
+      'is-snap-manifest',
       '"snap.manifest.json" is invalid: Expected a value of type object, but received: "foo".',
     );
   });

@@ -18,6 +18,7 @@ export const isSnapManifest: ValidatorMeta = {
     if (error) {
       for (const failure of error.failures()) {
         context.report(
+          'is-snap-manifest',
           `"${NpmSnapFileNames.Manifest}" is invalid: ${getStructFailureMessage(
             SnapManifestStruct,
             failure,

@@ -43,6 +43,7 @@ describe('manifestLocalization', () => {
     await manifestLocalization.semanticCheck(files, { report });
 
     expect(report).toHaveBeenCalledWith(
+      'manifest-localization',
       'Failed to localize Snap manifest: Failed to translate "{{ name }}": No translation found for "name" in "en" file.',
     );
   });

@@ -26,6 +26,7 @@ export const manifestLocalization: ValidatorMeta = {
         getLocalizedSnapManifest(manifest, locale, localizations);
       } catch (error) {
         context.report(
+          'manifest-localization',
           `Failed to localize Snap manifest: ${getErrorMessage(error)}`,
         );
       }

@@ -26,6 +26,7 @@ describe('packageJsonRecommendedFields', () => {
     await packageJsonRecommendedFields.semanticCheck(files, { report });
 
     expect(report).toHaveBeenCalledWith(
+      'package-json-recommended-fields',
       'Missing recommended package.json property: "repository".',
     );
   });
-Original file line number
+Diff line change
@@ Expand Up / @@ -23,6 +23,7 @@ describe('iconDeclared', () => { @@
         });
         expect(report).toHaveBeenCalledWith(
+          'icon-declared',
           'No icon found in the Snap manifest. It is recommended to include an icon for the Snap. See https://docs.metamask.io/snaps/how-to/design-a-snap/#guidelines-at-a-glance for more information.',
         );
       });
@@ Expand Down @@