@expo/fingerprint 0.1.0 → 0.3.0

package/build/sourcer/ExpoConfigLoader.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * A helper script to load the Expo config and loaded plugins from a project
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExpoConfigLoaderPath = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const module_1 = __importDefault(require("module"));
+const path_1 = __importDefault(require("path"));
+const resolve_from_1 = __importDefault(require("resolve-from"));
+const Options_1 = require("../Options");
+const Path_1 = require("../utils/Path");
+async function runAsync(programName, args = []) {
+    if (args.length < 1) {
+        console.log(`Usage: ${programName} <projectRoot> [ignoredFile]`);
+        return;
+    }
+    const projectRoot = path_1.default.resolve(args[0]);
+    const ignoredFile = args[1] ? path_1.default.resolve(args[1]) : null;
+    // @ts-expect-error: module internal _cache
+    const loadedModulesBefore = new Set(Object.keys(module_1.default._cache));
+    const { getConfig } = require((0, resolve_from_1.default)(path_1.default.resolve(projectRoot), 'expo/config'));
+    const config = await getConfig(projectRoot, { skipSDKVersionRequirement: true });
+    // @ts-expect-error: module internal _cache
+    const loadedModules = Object.keys(module_1.default._cache)
+        .filter((modulePath) => !loadedModulesBefore.has(modulePath))
+        .map((modulePath) => path_1.default.relative(projectRoot, modulePath));
+    const ignoredPaths = await loadIgnoredPathsAsync(ignoredFile);
+    const filteredLoadedModules = loadedModules.filter((modulePath) => !(0, Path_1.isIgnoredPath)(modulePath, ignoredPaths));
+    console.log(JSON.stringify({ config, loadedModules: filteredLoadedModules }));
+}
+// If running from the command line
+if (require.main?.filename === __filename) {
+    (async () => {
+        const programIndex = process.argv.findIndex((arg) => arg === __filename);
+        try {
+            await runAsync(process.argv[programIndex], process.argv.slice(programIndex + 1));
+        }
+        catch (e) {
+            console.error('Uncaught Error', e);
+            process.exit(1);
+        }
+    })();
+}
+/**
+ * Load the generated ignored paths file from caller and remove the file after loading
+ */
+async function loadIgnoredPathsAsync(ignoredFile) {
+    if (!ignoredFile) {
+        return Options_1.DEFAULT_IGNORE_PATHS;
+    }
+    const ignorePaths = [];
+    try {
+        const fingerprintIgnore = await promises_1.default.readFile(ignoredFile, 'utf8');
+        const fingerprintIgnoreLines = fingerprintIgnore.split('\n');
+        for (const line of fingerprintIgnoreLines) {
+            const trimmedLine = line.trim();
+            if (trimmedLine) {
+                ignorePaths.push(trimmedLine);
+            }
+        }
+    }
+    catch { }
+    try {
+        await promises_1.default.rm(ignoredFile);
+    }
+    catch { }
+    return ignorePaths;
+}
+/**
+ * Get the path to the ExpoConfigLoader file.
+ */
+function getExpoConfigLoaderPath() {
+    return path_1.default.join(__dirname, 'ExpoConfigLoader.js');
+}
+exports.getExpoConfigLoaderPath = getExpoConfigLoaderPath;
+//# sourceMappingURL=ExpoConfigLoader.js.map

package/build/sourcer/ExpoConfigLoader.js.map

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

package/build/sourcer/Utils.d.ts

@@ -1,2 +1,6 @@
 import type { HashSource } from '../Fingerprint.types';
 export declare function getFileBasedHashSourceAsync(projectRoot: string, filePath: string, reason: string): Promise<HashSource | null>;
+/**
+ * A version of `JSON.stringify` that keeps the keys sorted
+ */
+export declare function stringifyJsonSorted(target: any, space?: string | number | undefined): string;

package/build/sourcer/Utils.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFileBasedHashSourceAsync = void 0;
+exports.stringifyJsonSorted = exports.getFileBasedHashSourceAsync = void 0;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 async function getFileBasedHashSourceAsync(projectRoot, filePath, reason) {
@@ -22,4 +22,41 @@ async function getFileBasedHashSourceAsync(projectRoot, filePath, reason) {
     return result;
 }
 exports.getFileBasedHashSourceAsync = getFileBasedHashSourceAsync;
+/**
+ * A version of `JSON.stringify` that keeps the keys sorted
+ */
+function stringifyJsonSorted(target, space) {
+    return JSON.stringify(target, (_, value) => sortJson(value), space);
+}
+exports.stringifyJsonSorted = stringifyJsonSorted;
+function sortJson(json) {
+    if (Array.isArray(json)) {
+        return json.sort((a, b) => {
+            // Sort array items by their stringified value.
+            // We don't need the array to be sorted in meaningful way, just to be sorted in deterministic.
+            // E.g. `[{ b: '2' }, {}, { a: '3' }, null]` -> `[null, { a : '3' }, { b: '2' }, {}]`
+            // This result is not a perfect solution, but it's good enough for our use case.
+            const stringifiedA = stringifyJsonSorted(a);
+            const stringifiedB = stringifyJsonSorted(b);
+            if (stringifiedA < stringifiedB) {
+                return -1;
+            }
+            else if (stringifiedA > stringifiedB) {
+                return 1;
+            }
+            return 0;
+        });
+    }
+    if (json != null && typeof json === 'object') {
+        // Sort object items by keys
+        return Object.keys(json)
+            .sort()
+            .reduce((acc, key) => {
+            acc[key] = json[key];
+            return acc;
+        }, {});
+    }
+    // Return primitives
+    return json;
+}
 //# sourceMappingURL=Utils.js.map

package/build/sourcer/Utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../src/sourcer/Utils.ts"],"names":[],"mappings":";;;;;;AAAA,2DAA6B;AAC7B,gDAAwB;AAIjB,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,QAAgB,EAChB,MAAc;IAEd,IAAI,MAAM,GAAsB,IAAI,CAAC;IACrC,IAAI;QACF,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;YACzC,QAAQ;YACR,OAAO,EAAE,CAAC,MAAM,CAAC;SAClB,CAAC;KACH;IAAC,MAAM;QACN,MAAM,GAAG,IAAI,CAAC;KACf;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAjBD,kEAiBC"}
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../src/sourcer/Utils.ts"],"names":[],"mappings":";;;;;;AAAA,2DAA6B;AAC7B,gDAAwB;AAIjB,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,QAAgB,EAChB,MAAc;IAEd,IAAI,MAAM,GAAsB,IAAI,CAAC;IACrC,IAAI;QACF,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC7D,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;YACzC,QAAQ;YACR,OAAO,EAAE,CAAC,MAAM,CAAC;SAClB,CAAC;KACH;IAAC,MAAM;QACN,MAAM,GAAG,IAAI,CAAC;KACf;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAjBD,kEAiBC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAW,EAAE,KAAmC;IAClF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAFD,kDAEC;AAED,SAAS,QAAQ,CAAC,IAAS;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,+CAA+C;YAC/C,8FAA8F;YAC9F,qFAAqF;YACrF,gFAAgF;YAChF,MAAM,YAAY,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,YAAY,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,YAAY,GAAG,YAAY,EAAE;gBAC/B,OAAO,CAAC,CAAC,CAAC;aACX;iBAAM,IAAI,YAAY,GAAG,YAAY,EAAE;gBACtC,OAAO,CAAC,CAAC;aACV;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;KACJ;IAED,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC5C,4BAA4B;QAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACrB,IAAI,EAAE;aACN,MAAM,CAAC,CAAC,GAAQ,EAAE,GAAW,EAAE,EAAE;YAChC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;KACV;IAED,oBAAoB;IACpB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/build/utils/Path.d.ts

@@ -0,0 +1,5 @@
+import minimatch from 'minimatch';
+/**
+ * Indicate the given `filePath` should be excluded by `ignorePaths`
+ */
+export declare function isIgnoredPath(filePath: string, ignorePaths: string[], minimatchOptions?: minimatch.IOptions): boolean;

package/build/utils/Path.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIgnoredPath = void 0;
+const minimatch_1 = __importDefault(require("minimatch"));
+/**
+ * Indicate the given `filePath` should be excluded by `ignorePaths`
+ */
+function isIgnoredPath(filePath, ignorePaths, minimatchOptions = { dot: true }) {
+    const minimatchObjs = ignorePaths.map((ignorePath) => new minimatch_1.default.Minimatch(ignorePath, minimatchOptions));
+    let result = false;
+    for (const minimatchObj of minimatchObjs) {
+        const currMatch = minimatchObj.match(filePath);
+        if (minimatchObj.negate && result && !currMatch) {
+            // Special handler for negate (!pattern).
+            // As long as previous match result is true and not matched from the current negate pattern, we should early return.
+            return false;
+        }
+        result || (result = currMatch);
+    }
+    return result;
+}
+exports.isIgnoredPath = isIgnoredPath;
+//# sourceMappingURL=Path.js.map

package/build/utils/Path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Path.js","sourceRoot":"","sources":["../../src/utils/Path.ts"],"names":[],"mappings":";;;;;;AAAA,0DAAkC;AAElC;;GAEG;AACH,SAAgB,aAAa,CAC3B,QAAgB,EAChB,WAAqB,EACrB,mBAAuC,EAAE,GAAG,EAAE,IAAI,EAAE;IAEpD,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CACnC,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,mBAAS,CAAC,SAAS,CAAC,UAAU,EAAE,gBAAgB,CAAC,CACtE,CAAC;IAEF,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;QACxC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,YAAY,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC,SAAS,EAAE;YAC/C,yCAAyC;YACzC,oHAAoH;YACpH,OAAO,KAAK,CAAC;SACd;QACD,MAAM,KAAN,MAAM,GAAK,SAAS,EAAC;KACtB;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AApBD,sCAoBC"}

package/e2e/__tests__/__snapshots__/managed-test.ts.snap

@@ -131,11 +131,12 @@ exports[`getHashSourcesAsync - managed project should match snapshot 1`] = `
     "type": "contents",
   },
   {
-    "filePath": "app.json",
+    "contents": "{"android":{"adaptiveIcon":{"backgroundColor":"#FFFFFF","foregroundImage":"./assets/adaptive-icon.png"}},"assetBundlePatterns":["**/*"],"icon":"./assets/icon.png","ios":{"supportsTablet":true},"name":"fingerprint-e2e-managed","orientation":"portrait","platforms":["android","ios"],"sdkVersion":"47.0.0","slug":"fingerprint-e2e-managed","splash":{"backgroundColor":"#ffffff","image":"./assets/splash.png","resizeMode":"contain"},"updates":{"fallbackToCacheTimeout":0},"userInterfaceStyle":"light","version":"1.0.0","web":{"favicon":"./assets/favicon.png"}}",
+    "id": "expoConfig",
     "reasons": [
       "expoConfig",
     ],
-    "type": "file",
+    "type": "contents",
   },
   {
     "filePath": "./assets/icon.png",

package/e2e/__tests__/bare-test.ts

@@ -6,6 +6,13 @@ import rimraf from 'rimraf';
 
 import { createProjectHashAsync } from '../../src/Fingerprint';
 
+jest.mock('../../src/sourcer/ExpoConfigLoader', () => ({
+  // Mock the getExpoConfigLoaderPath to use the built version rather than the typescript version from src
+  getExpoConfigLoaderPath: jest.fn(() =>
+    path.resolve(__dirname, '..', '..', 'build', 'sourcer', 'ExpoConfigLoader.js')
+  ),
+}));
+
 describe('bare project test', () => {
   jest.setTimeout(600000);
   const tmpDir = os.tmpdir();

package/e2e/__tests__/managed-test.ts

@@ -8,9 +8,16 @@ import {
   createProjectHashAsync,
   diffFingerprintChangesAsync,
 } from '../../src/Fingerprint';
-import { normalizeOptions } from '../../src/Options';
+import { normalizeOptionsAsync } from '../../src/Options';
 import { getHashSourcesAsync } from '../../src/sourcer/Sourcer';
 
+jest.mock('../../src/sourcer/ExpoConfigLoader', () => ({
+  // Mock the getExpoConfigLoaderPath to use the built version rather than the typescript version from src
+  getExpoConfigLoaderPath: jest.fn(() =>
+    path.resolve(__dirname, '..', '..', 'build', 'sourcer', 'ExpoConfigLoader.js')
+  ),
+}));
+
 describe('managed project test', () => {
   jest.setTimeout(600000);
   const tmpDir = require('temp-dir');
@@ -65,7 +72,7 @@ describe('managed project test', () => {
 
     const configPath = path.join(projectRoot, 'app.json');
     const config = JSON.parse(await fs.readFile(configPath, 'utf8'));
-    config.jsEngine = 'hermes';
+    config.expo.jsEngine = 'hermes';
     await fs.writeFile(configPath, JSON.stringify(config, null, 2));
 
     const hash2 = await createProjectHashAsync(projectRoot);
@@ -147,7 +154,10 @@ describe(`getHashSourcesAsync - managed project`, () => {
   });
 
   it('should match snapshot', async () => {
-    const sources = await getHashSourcesAsync(projectRoot, normalizeOptions());
+    const sources = await getHashSourcesAsync(
+      projectRoot,
+      await normalizeOptionsAsync(projectRoot)
+    );
     expect(sources).toMatchSnapshot();
   });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/fingerprint",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "A library to generate a fingerprint from a React Native project",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -11,7 +11,7 @@
     "clean": "rimraf build ./tsconfig.tsbuildinfo",
     "lint": "eslint .",
     "test": "jest",
-    "test:e2e": "jest --config e2e/jest.config.js"
+    "test:e2e": "yarn prepare && jest --config e2e/jest.config.js"
   },
   "bin": {
     "fingerprint": "bin/cli.js"
@@ -48,5 +48,5 @@
     "glob": "^7.1.7",
     "temp-dir": "^2.0.0"
   },
-  "gitHead": "1f5e9f77f22e5d6a464d34194236684a45fcf322"
+  "gitHead": "039366f050814a220cf31f87e0fbdf27416bb478"
 }

package/src/Fingerprint.ts

@@ -1,6 +1,6 @@
 import { dedupSources } from './Dedup';
 import type { Fingerprint, FingerprintSource, Options } from './Fingerprint.types';
-import { normalizeOptions } from './Options';
+import { normalizeOptionsAsync } from './Options';
 import { sortSources } from './Sort';
 import { createFingerprintFromSourcesAsync } from './hash/Hash';
 import { getHashSourcesAsync } from './sourcer/Sourcer';
@@ -12,7 +12,7 @@ export async function createFingerprintAsync(
   projectRoot: string,
   options?: Options
 ): Promise<Fingerprint> {
-  const opts = normalizeOptions(options);
+  const opts = await normalizeOptionsAsync(projectRoot, options);
   const sources = await getHashSourcesAsync(projectRoot, opts);
   const normalizedSources = sortSources(dedupSources(sources, projectRoot));
   const fingerprint = await createFingerprintFromSourcesAsync(normalizedSources, projectRoot, opts);

package/src/Fingerprint.types.ts

@@ -39,9 +39,21 @@ export interface Options {
   /**
    * Excludes directories from hashing. This supported pattern is as `glob()`.
    * Default is `['android/build', 'android/app/build', 'android/app/.cxx', 'ios/Pods']`.
+   * @deprecated Use `ignorePaths` instead.
    */
   dirExcludes?: string[];
 
+  /**
+   * Ignore files and directories from hashing. This supported pattern is as `glob()`.
+   *
+   * Please note that the pattern matching is slightly different from gitignore. For example, we don't support partial matching where `build` does not match `android/build`. You should use `'**' + '/build'` instead.
+   * @see [minimatch implementations](https://github.com/isaacs/minimatch#comparisons-to-other-fnmatchglob-implementations) for more reference.
+   *
+   * Besides this `ignorePaths`, fingerprint comes with implicit default ignorePaths defined in `Options.DEFAULT_IGNORE_PATHS`.
+   * If you want to override the default ignorePaths, use `!` prefix.
+   */
+  ignorePaths?: string[];
+
   /**
    * Additional sources for hashing.
    */
@@ -54,7 +66,7 @@ export interface NormalizedOptions extends Options {
   platforms: NonNullable<Options['platforms']>;
   concurrentIoLimit: NonNullable<Options['concurrentIoLimit']>;
   hashAlgorithm: NonNullable<Options['hashAlgorithm']>;
-  dirExcludes: NonNullable<Options['dirExcludes']>;
+  ignorePaths: NonNullable<Options['ignorePaths']>;
 }
 
 export interface HashSourceFile {

package/src/Options.ts

@@ -1,18 +1,81 @@
+import fs from 'fs/promises';
 import os from 'os';
+import path from 'path';
 
 import type { NormalizedOptions, Options } from './Fingerprint.types';
 
-export function normalizeOptions(options?: Options): NormalizedOptions {
+export const FINGERPRINT_IGNORE_FILENAME = '.fingerprintignore';
+
+export const DEFAULT_IGNORE_PATHS = [
+  FINGERPRINT_IGNORE_FILENAME,
+  '**/android/build/**/*',
+  '**/android/app/build/**/*',
+  '**/android/app/.cxx/**/*',
+  '**/ios/Pods/**/*',
+
+  // Ignore all expo configs because we will read expo config in a HashSourceContents already
+  'app.config.ts',
+  'app.config.js',
+  'app.config.json',
+  'app.json',
+
+  // Ignore default javascript files when calling `getConfig()`
+  '**/node_modules/@babel/**/*',
+  '**/node_modules/@expo/**/*',
+  '**/node_modules/@jridgewell/**/*',
+  '**/node_modules/expo/config.js',
+  '**/node_modules/expo/config-plugins.js',
+  `**/node_modules/{${[
+    'debug',
+    'escape-string-regexp',
+    'getenv',
+    'graceful-fs',
+    'has-flag',
+    'imurmurhash',
+    'js-tokens',
+    'json5',
+    'lines-and-columns',
+    'require-from-string',
+    'resolve-from',
+    'signal-exit',
+    'sucrase',
+    'supports-color',
+    'ts-interface-checker',
+    'write-file-atomic',
+  ].join(',')}}/**/*`,
+];
+
+export async function normalizeOptionsAsync(
+  projectRoot: string,
+  options?: Options
+): Promise<NormalizedOptions> {
   return {
     ...options,
     platforms: options?.platforms ?? ['android', 'ios'],
     concurrentIoLimit: options?.concurrentIoLimit ?? os.cpus().length,
     hashAlgorithm: options?.hashAlgorithm ?? 'sha1',
-    dirExcludes: options?.dirExcludes ?? [
-      '**/android/build',
-      '**/android/app/build',
-      '**/android/app/.cxx',
-      'ios/Pods',
-    ],
+    ignorePaths: await collectIgnorePathsAsync(projectRoot, options),
   };
 }
+
+async function collectIgnorePathsAsync(projectRoot: string, options?: Options): Promise<string[]> {
+  const ignorePaths = [
+    ...DEFAULT_IGNORE_PATHS,
+    ...(options?.ignorePaths ?? []),
+    ...(options?.dirExcludes?.map((dirExclude) => `${dirExclude}/**/*`) ?? []),
+  ];
+
+  const fingerprintIgnorePath = path.join(projectRoot, FINGERPRINT_IGNORE_FILENAME);
+  try {
+    const fingerprintIgnore = await fs.readFile(fingerprintIgnorePath, 'utf8');
+    const fingerprintIgnoreLines = fingerprintIgnore.split('\n');
+    for (const line of fingerprintIgnoreLines) {
+      const trimmedLine = line.trim();
+      if (trimmedLine) {
+        ignorePaths.push(trimmedLine);
+      }
+    }
+  } catch {}
+
+  return ignorePaths;
+}

package/src/__tests__/Fingerprint-test.ts

@@ -2,7 +2,7 @@ import { vol } from 'memfs';
 
 import { createFingerprintAsync, diffFingerprintChangesAsync } from '../Fingerprint';
 import type { Fingerprint } from '../Fingerprint.types';
-import { normalizeOptions } from '../Options';
+import { normalizeOptionsAsync } from '../Options';
 
 jest.mock('fs');
 jest.mock('fs/promises');
@@ -15,8 +15,12 @@ describe(diffFingerprintChangesAsync, () => {
 
   it('should return empty array when fingerprint matched', async () => {
     vol.fromJSON(require('../sourcer/__tests__/fixtures/ExpoManaged47Project.json'));
-    const fingerprint = await createFingerprintAsync('/app', normalizeOptions());
-    const diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    const fingerprint = await createFingerprintAsync('/app', await normalizeOptionsAsync('/app'));
+    const diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     expect(diff.length).toBe(0);
   });
 
@@ -27,16 +31,21 @@ describe(diffFingerprintChangesAsync, () => {
       hash: '',
     };
 
-    const diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    const diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     expect(diff).toMatchInlineSnapshot(`
       [
         {
-          "filePath": "app.json",
-          "hash": "1fd2d92d50dc1da96b41795046b9ea4e30dd2b48",
+          "contents": "{"android":{"adaptiveIcon":{"backgroundColor":"#FFFFFF","foregroundImage":"./assets/adaptive-icon.png"}},"assetBundlePatterns":["**/*"],"icon":"./assets/icon.png","ios":{"supportsTablet":true},"name":"sdk47","orientation":"portrait","platforms":["android","ios","web"],"slug":"sdk47","splash":{"backgroundColor":"#ffffff","image":"./assets/splash.png","resizeMode":"contain"},"updates":{"fallbackToCacheTimeout":0},"userInterfaceStyle":"light","version":"1.0.0","web":{"favicon":"./assets/favicon.png"}}",
+          "hash": "33b2b95de3b0b474810630e51527a2c0a6e5de9c",
+          "id": "expoConfig",
           "reasons": [
             "expoConfig",
           ],
-          "type": "file",
+          "type": "contents",
         },
       ]
     `);
@@ -46,19 +55,27 @@ describe(diffFingerprintChangesAsync, () => {
     vol.fromJSON(require('../sourcer/__tests__/fixtures/ExpoManaged47Project.json'));
     const packageJson = JSON.parse(vol.readFileSync('/app/package.json', 'utf8').toString());
     jest.doMock('/app/package.json', () => packageJson, { virtual: true });
-    const fingerprint = await createFingerprintAsync('/app', normalizeOptions());
+    const fingerprint = await createFingerprintAsync('/app', await normalizeOptionsAsync('/app'));
 
     // first round for bumping package version which should not cause changes
     packageJson.version = '111.111.111';
     jest.doMock('/app/package.json', () => packageJson, { virtual: true });
-    let diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    let diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     expect(diff.length).toBe(0);
 
     // second round to update scripts section and it should cause changes
     packageJson.scripts ||= {};
     packageJson.scripts.postinstall = 'echo "hello"';
     jest.doMock('/app/package.json', () => packageJson, { virtual: true });
-    diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     jest.dontMock('/app/package.json');
     expect(diff).toMatchInlineSnapshot(`
       [
@@ -77,20 +94,25 @@ describe(diffFingerprintChangesAsync, () => {
 
   it('should return diff from file changes', async () => {
     vol.fromJSON(require('../sourcer/__tests__/fixtures/ExpoManaged47Project.json'));
-    const fingerprint = await createFingerprintAsync('/app', normalizeOptions());
+    const fingerprint = await createFingerprintAsync('/app', await normalizeOptionsAsync('/app'));
     const config = JSON.parse(vol.readFileSync('/app/app.json', 'utf8').toString());
     config.expo.jsEngine = 'jsc';
     vol.writeFileSync('/app/app.json', JSON.stringify(config, null, 2));
-    const diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    const diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     expect(diff).toMatchInlineSnapshot(`
       [
         {
-          "filePath": "app.json",
-          "hash": "9ff1b51ca9b9435e8b849bcc82e3900d70f0feee",
+          "contents": "{"android":{"adaptiveIcon":{"backgroundColor":"#FFFFFF","foregroundImage":"./assets/adaptive-icon.png"}},"assetBundlePatterns":["**/*"],"icon":"./assets/icon.png","ios":{"supportsTablet":true},"jsEngine":"jsc","name":"sdk47","orientation":"portrait","platforms":["android","ios","web"],"slug":"sdk47","splash":{"backgroundColor":"#ffffff","image":"./assets/splash.png","resizeMode":"contain"},"updates":{"fallbackToCacheTimeout":0},"userInterfaceStyle":"light","version":"1.0.0","web":{"favicon":"./assets/favicon.png"}}",
+          "hash": "7068a4234e7312c6ac54b776ea4dfad0ac789b2a",
+          "id": "expoConfig",
           "reasons": [
             "expoConfig",
           ],
-          "type": "file",
+          "type": "contents",
         },
       ]
     `);
@@ -98,9 +120,13 @@ describe(diffFingerprintChangesAsync, () => {
 
   it('should return diff from dir changes', async () => {
     vol.fromJSON(require('../sourcer/__tests__/fixtures/BareReactNative70Project.json'));
-    const fingerprint = await createFingerprintAsync('/app', normalizeOptions());
+    const fingerprint = await createFingerprintAsync('/app', await normalizeOptionsAsync('/app'));
     vol.writeFileSync('/app/ios/README.md', '# Adding new file in ios dir');
-    const diff = await diffFingerprintChangesAsync(fingerprint, '/app', normalizeOptions());
+    const diff = await diffFingerprintChangesAsync(
+      fingerprint,
+      '/app',
+      await normalizeOptionsAsync('/app')
+    );
     expect(diff).toMatchInlineSnapshot(`
       [
         {

package/src/hash/Hash.ts

@@ -1,7 +1,6 @@
 import { createHash } from 'crypto';
 import { createReadStream } from 'fs';
 import fs from 'fs/promises';
-import minimatch from 'minimatch';
 import pLimit from 'p-limit';
 import path from 'path';
 
@@ -13,6 +12,7 @@ import type {
   HashSourceContents,
   NormalizedOptions,
 } from '../Fingerprint.types';
+import { isIgnoredPath } from '../utils/Path';
 import { profile } from '../utils/Profile';
 
 /**
@@ -82,10 +82,14 @@ export async function createFileHashResultsAsync(
   limiter: pLimit.Limit,
   projectRoot: string,
   options: NormalizedOptions
-): Promise<HashResult> {
+): Promise<HashResult | null> {
   // Backup code for faster hashing
   /*
   return limiter(async () => {
+    if (isIgnoredPath(filePath, options.ignorePaths)) {
+      return null;
+    }
+
     const hasher = createHash(options.hashAlgorithm);
 
     const stat = await fs.stat(filePath);
@@ -102,7 +106,11 @@ export async function createFileHashResultsAsync(
   */
 
   return limiter(() => {
-    return new Promise<HashResult>((resolve, reject) => {
+    return new Promise<HashResult | null>((resolve, reject) => {
+      if (isIgnoredPath(filePath, options.ignorePaths)) {
+        return resolve(null);
+      }
+
       let resolved = false;
       const hasher = createHash(options.hashAlgorithm);
       const stream = createReadStream(path.join(projectRoot, filePath));
@@ -123,18 +131,6 @@ export async function createFileHashResultsAsync(
   });
 }
 
-/**
- * Indicate the given `dirPath` should be excluded by `dirExcludes`
- */
-function isExcludedDir(dirPath: string, dirExcludes: string[]): boolean {
-  for (const exclude of dirExcludes) {
-    if (minimatch(dirPath, exclude)) {
-      return true;
-    }
-  }
-  return false;
-}
-
 /**
  * Create `HashResult` for a dir.
  * If the dir is excluded, returns null rather than a HashResult
@@ -146,7 +142,7 @@ export async function createDirHashResultsAsync(
   options: NormalizedOptions,
   depth: number = 0
 ): Promise<HashResult | null> {
-  if (isExcludedDir(dirPath, options.dirExcludes)) {
+  if (isIgnoredPath(dirPath, options.ignorePaths)) {
     return null;
   }
   const dirents = (await fs.readdir(path.join(projectRoot, dirPath), { withFileTypes: true })).sort(
@@ -164,12 +160,15 @@ export async function createDirHashResultsAsync(
   }
 
   const hasher = createHash(options.hashAlgorithm);
-  const results = await Promise.all(promises);
+  const results = (await Promise.all(promises)).filter(
+    (result): result is HashResult => result != null
+  );
+  if (results.length === 0) {
+    return null;
+  }
   for (const result of results) {
-    if (result != null) {
-      hasher.update(result.id);
-      hasher.update(result.hex);
-    }
+    hasher.update(result.id);
+    hasher.update(result.hex);
   }
   const hex = hasher.digest('hex');