@expo/fingerprint 0.0.1

package/.eslintignore

@@ -0,0 +1 @@
+build

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,118 @@
+# @expo/fingerprint
+
+A library to generate a fingerprint from a React Native project
+
+## Usage
+
+```ts
+import * as Fingerprint from '@expo/fingerprint';
+
+await Fingerprint.createFingerprintAsync('/projectRoot');
+```
+
+### `async function createFingerprintAsync(projectRoot: string, options?: Options): Promise<Fingerprint>`
+
+Create a fingerprint from project
+
+Example:
+
+```ts
+const fingerprint = await createFingerprintAsync('/app');
+console.log(fingerprint);
+```
+
+```json
+{
+  "sources": [
+    {
+      "type": "file",
+      "filePath": "app.json",
+      "reasons": ["expoConfig"],
+      "hash": "378083de0c6e6bb6caf8fb72df658b0b26fb29ef"
+    },
+    {
+      "type": "file",
+      "filePath": "eas.json",
+      "reasons": ["easBuild"],
+      "hash": "f723802b6ea916d1a6c4767b2299cc81ddb22eb4"
+    },
+    {
+      "type": "dir",
+      "filePath": "node_modules/expo",
+      "reasons": ["expoAutolinkingIos", "expoAutolinkingAndroid", "bareRncliAutolinking"],
+      "hash": "1faee4057fa943300905750b51c3b0cbf05f4b0d"
+    }
+  ],
+  "hash": "bf8a3b08935f056270b1688333b02f1ef5fa25bf"
+}
+```
+
+### `async function createProjectHashAsync(projectRoot: string, options?: Options): Promise<string>`
+
+Create a native hash value from project
+
+Example:
+
+```ts
+const hash = await createProjectHashAsync('/app');
+console.log(hash);
+```
+
+```json
+bf8a3b08935f056270b1688333b02f1ef5fa25bf
+```
+
+### `diffFingerprintChangesAsync(fingerprint: Fingerprint, projectRoot: string, options?: Options): Promise<FingerprintSource[]>`
+
+Differentiate given `fingerprint` with the current project fingerprint state
+
+Example:
+
+```ts
+const fingerprint = {
+  sources: [
+    {
+      type: 'file',
+      filePath: 'app.json',
+      reasons: ['expoConfig'],
+      hash: '378083de0c6e6bb6caf8fb72df658b0b26fb29ef',
+    },
+    {
+      type: 'file',
+      filePath: 'eas.json',
+      reasons: ['easBuild'],
+      hash: 'f723802b6ea916d1a6c4767b2299cc81ddb22eb4',
+    },
+    {
+      type: 'dir',
+      filePath: 'node_modules/expo',
+      reasons: ['expoAutolinkingIos', 'expoAutolinkingAndroid', 'bareRncliAutolinking'],
+      hash: '1faee4057fa943300905750b51c3b0cbf05f4b0d',
+    },
+  ],
+  hash: 'bf8a3b08935f056270b1688333b02f1ef5fa25bf',
+};
+const result = await diffFingerprintChangesAsync(fingerprint, '/app');
+console.log(result);
+```
+
+```json
+[
+  {
+    "filePath": "ios",
+    "hash": "e4190c0af9142fe4add4842777d9aec713213cd4",
+    "reasons": ["bareNativeDir"],
+    "type": "dir"
+  },
+  {
+    "filePath": "app.json",
+    "hash": "9ff1b51ca9b9435e8b849bcc82e3900d70f0feee",
+    "reasons": ["expoConfig"],
+    "type": "file"
+  }
+]
+```
+
+## CLI Usage
+
+`npx @expo/fingerprint /path/to/projectRoot`

package/__mocks__/fs/promises.ts

@@ -0,0 +1,2 @@
+import { fs } from 'memfs';
+module.exports = fs.promises;

package/__mocks__/fs.ts

@@ -0,0 +1,2 @@
+import { fs } from 'memfs';
+module.exports = fs;

package/babel.config.js

@@ -0,0 +1,6 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: ['@expo/babel-preset-cli'],
+  };
+};

package/bin/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+const path = require('path');
+
+let Fingerprint;
+try {
+  Fingerprint = require('@expo/fingerprint');
+} catch {}
+if (!Fingerprint) {
+  Fingerprint = require(path.join(__dirname, '..', 'build', 'index'));
+}
+
+(async () => {
+  if (process.argv.length !== 3) {
+    console.log(`Usage: ${path.basename(process.argv[1])} projectRoot`);
+    process.exit(1);
+  }
+  const projectRoot = process.argv[2];
+
+  try {
+    const fingerprint = await Fingerprint.createFingerprintAsync(projectRoot);
+    console.log(JSON.stringify(fingerprint, null, 2));
+    // console.log(fingerprint.hash);
+  } catch (e) {
+    console.error('Uncaught Error', e);
+    process.exit(1);
+  }
+})();

package/build/Dedup.d.ts

@@ -0,0 +1,9 @@
+import type { HashSource } from './Fingerprint.types';
+/**
+ * Strip duplicated sources, mainly for duplicated file or dir
+ */
+export declare function dedupSources(sources: HashSource[], projectRoot: string): HashSource[];
+/**
+ * When two sources are duplicated, merge `src`'s reasons into `dst`
+ */
+export declare function mergeSourceWithReasons(dst: HashSource, src: HashSource): HashSource;

package/build/Dedup.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeSourceWithReasons = exports.dedupSources = void 0;
+const assert_1 = __importDefault(require("assert"));
+const path_1 = __importDefault(require("path"));
+const debug = require('debug')('expo:fingerprint:Dedup');
+/**
+ * Strip duplicated sources, mainly for duplicated file or dir
+ */
+function dedupSources(sources, projectRoot) {
+    const newSources = [];
+    for (const source of sources) {
+        const [duplicatedItemIndex, shouldSwapSource] = findDuplicatedSourceIndex(newSources, source, projectRoot);
+        if (duplicatedItemIndex >= 0) {
+            const duplicatedItem = newSources[duplicatedItemIndex];
+            debug(`Skipping duplicated source: ${source}`);
+            if (shouldSwapSource) {
+                newSources[duplicatedItemIndex] = {
+                    ...source,
+                    reasons: [...source.reasons, ...duplicatedItem.reasons],
+                };
+            }
+            else {
+                duplicatedItem.reasons.push(...source.reasons);
+            }
+        }
+        else {
+            newSources.push(source);
+        }
+    }
+    return newSources;
+}
+exports.dedupSources = dedupSources;
+/**
+ * When two sources are duplicated, merge `src`'s reasons into `dst`
+ */
+function mergeSourceWithReasons(dst, src) {
+    return dst;
+}
+exports.mergeSourceWithReasons = mergeSourceWithReasons;
+/**
+ * Find the duplicated `source` in `newSources`
+ * @return tuple of [duplicatedItemIndexInNewSources, shouldSwapSource]
+ */
+function findDuplicatedSourceIndex(newSources, source, projectRoot) {
+    let shouldSwapSource = false;
+    if (source.type === 'contents') {
+        return [
+            newSources.findIndex((item) => item.type === source.type && item.id === source.id) ?? null,
+            shouldSwapSource,
+        ];
+    }
+    for (const [index, existingSource] of newSources.entries()) {
+        if (existingSource.type === 'contents') {
+            continue;
+        }
+        if (isDescendant(source, existingSource, projectRoot)) {
+            return [index, shouldSwapSource];
+        }
+        // If the new source is ancestor of existing source, replace swap the existing source with the new source
+        if (isDescendant(existingSource, source, projectRoot)) {
+            shouldSwapSource = true;
+            return [index, shouldSwapSource];
+        }
+    }
+    return [-1, shouldSwapSource];
+}
+function isDescendant(from, to, projectRoot) {
+    if (from === to) {
+        return true;
+    }
+    const fromPath = path_1.default.join(projectRoot, from.filePath);
+    const toPath = path_1.default.join(projectRoot, to.filePath);
+    const result = path_1.default.relative(fromPath, toPath).match(/^[./\\/]*$/) != null;
+    if (result) {
+        (0, assert_1.default)(!(to.type === 'file' && from.type === 'dir'), `Unexpected case which a dir is a descendant of a file - from[${fromPath}] to[${toPath}]`);
+    }
+    return result;
+}
+//# sourceMappingURL=Dedup.js.map

package/build/Dedup.js.map

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

package/build/Fingerprint.d.ts

@@ -0,0 +1,13 @@
+import type { Fingerprint, FingerprintSource, Options } from './Fingerprint.types';
+/**
+ * Create a fingerprint from project
+ */
+export declare function createFingerprintAsync(projectRoot: string, options?: Options): Promise<Fingerprint>;
+/**
+ * Create a native hash value from project
+ */
+export declare function createProjectHashAsync(projectRoot: string, options?: Options): Promise<string>;
+/**
+ * Differentiate given `fingerprint` with the current project fingerprint state
+ */
+export declare function diffFingerprintChangesAsync(fingerprint: Fingerprint, projectRoot: string, options?: Options): Promise<FingerprintSource[]>;

package/build/Fingerprint.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffFingerprintChangesAsync = exports.createProjectHashAsync = exports.createFingerprintAsync = void 0;
+const Dedup_1 = require("./Dedup");
+const Options_1 = require("./Options");
+const Sort_1 = require("./Sort");
+const Hash_1 = require("./hash/Hash");
+const Sourcer_1 = require("./sourcer/Sourcer");
+/**
+ * Create a fingerprint from project
+ */
+async function createFingerprintAsync(projectRoot, options) {
+    const opts = (0, Options_1.normalizeOptions)(options);
+    const sources = await (0, Sourcer_1.getHashSourcesAsync)(projectRoot, opts);
+    const normalizedSources = (0, Sort_1.sortSources)((0, Dedup_1.dedupSources)(sources, projectRoot));
+    const fingerprint = await (0, Hash_1.createFingerprintFromSourcesAsync)(normalizedSources, projectRoot, opts);
+    return fingerprint;
+}
+exports.createFingerprintAsync = createFingerprintAsync;
+/**
+ * Create a native hash value from project
+ */
+async function createProjectHashAsync(projectRoot, options) {
+    const fingerprint = await createFingerprintAsync(projectRoot, options);
+    return fingerprint.hash;
+}
+exports.createProjectHashAsync = createProjectHashAsync;
+/**
+ * Differentiate given `fingerprint` with the current project fingerprint state
+ */
+async function diffFingerprintChangesAsync(fingerprint, projectRoot, options) {
+    const newFingerprint = await createFingerprintAsync(projectRoot, options);
+    if (fingerprint.hash === newFingerprint.hash) {
+        return [];
+    }
+    const result = newFingerprint.sources.filter((newItem) => {
+        return !fingerprint.sources.find((item) => item.type === newItem.type && item.hash === newItem.hash);
+    });
+    return result;
+}
+exports.diffFingerprintChangesAsync = diffFingerprintChangesAsync;
+//# sourceMappingURL=Fingerprint.js.map

package/build/Fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fingerprint.js","sourceRoot":"","sources":["../src/Fingerprint.ts"],"names":[],"mappings":";;;AAAA,mCAAuC;AAEvC,uCAA6C;AAC7C,iCAAqC;AACrC,sCAAgE;AAChE,+CAAwD;AAExD;;GAEG;AACI,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,OAAiB;IAEjB,MAAM,IAAI,GAAG,IAAA,0BAAgB,EAAC,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAmB,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,iBAAiB,GAAG,IAAA,kBAAW,EAAC,IAAA,oBAAY,EAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,MAAM,IAAA,wCAAiC,EAAC,iBAAiB,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IAClG,OAAO,WAAW,CAAC;AACrB,CAAC;AATD,wDASC;AAED;;GAEG;AACI,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,OAAiB;IAEjB,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACvE,OAAO,WAAW,CAAC,IAAI,CAAC;AAC1B,CAAC;AAND,wDAMC;AAED;;GAEG;AACI,KAAK,UAAU,2BAA2B,CAC/C,WAAwB,EACxB,WAAmB,EACnB,OAAiB;IAEjB,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1E,IAAI,WAAW,CAAC,IAAI,KAAK,cAAc,CAAC,IAAI,EAAE;QAC5C,OAAO,EAAE,CAAC;KACX;IACD,MAAM,MAAM,GAAwB,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5E,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAfD,kEAeC"}

package/build/Fingerprint.types.d.ts

@@ -0,0 +1,78 @@
+/// <reference types="node" />
+export type FingerprintSource = HashSource & {
+    /**
+     * Hash value of the `source`.
+     * If the source is excluding by `Options.dirExcludes`, the value will be null.
+     */
+    hash: string | null;
+};
+export interface Fingerprint {
+    /**
+     * Sources and their hash values to generate a fingerprint
+     */
+    sources: FingerprintSource[];
+    /**
+     * The final hash value of the whole fingerprint
+     */
+    hash: string;
+}
+export type Platform = 'android' | 'ios';
+export interface Options {
+    /**
+     * Only get native files from the given platforms. Default is `['android', 'ios']`.
+     */
+    platforms?: Platform[];
+    /**
+     * I/O concurrent limit. Default is the number of CPU core.
+     */
+    concurrentIoLimit?: number;
+    /**
+     * The algorithm passing to `crypto.createHash()`. Default is `'sha1'`.
+     */
+    hashAlgorithm?: string;
+    /**
+     * Excludes directories from hashing. This supported pattern is as `glob()`.
+     * Default is `['android/build', 'android/app/build', 'android/app/.cxx', 'ios/Pods']`.
+     */
+    dirExcludes?: string[];
+    /**
+     * Additional sources for hashing.
+     */
+    extraSources?: HashSource[];
+}
+export interface NormalizedOptions extends Options {
+    platforms: NonNullable<Options['platforms']>;
+    concurrentIoLimit: NonNullable<Options['concurrentIoLimit']>;
+    hashAlgorithm: NonNullable<Options['hashAlgorithm']>;
+    dirExcludes: NonNullable<Options['dirExcludes']>;
+}
+export interface HashSourceFile {
+    type: 'file';
+    filePath: string;
+    /**
+     * Reasons of this source coming from
+     */
+    reasons: string[];
+}
+export interface HashSourceDir {
+    type: 'dir';
+    filePath: string;
+    /**
+     * Reasons of this source coming from
+     */
+    reasons: string[];
+}
+export interface HashSourceContents {
+    type: 'contents';
+    id: string;
+    contents: string | Buffer;
+    /**
+     * Reasons of this source coming from
+     */
+    reasons: string[];
+}
+export type HashSource = HashSourceFile | HashSourceDir | HashSourceContents;
+export interface HashResult {
+    id: string;
+    hex: string;
+}

package/build/Fingerprint.types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=Fingerprint.types.js.map

package/build/Fingerprint.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fingerprint.types.js","sourceRoot":"","sources":["../src/Fingerprint.types.ts"],"names":[],"mappings":";;AAiGA,YAAY"}

package/build/Options.d.ts

@@ -0,0 +1,2 @@
+import type { NormalizedOptions, Options } from './Fingerprint.types';
+export declare function normalizeOptions(options?: Options): NormalizedOptions;

package/build/Options.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = void 0;
+const os_1 = __importDefault(require("os"));
+function normalizeOptions(options) {
+    return {
+        ...options,
+        platforms: options?.platforms ?? ['android', 'ios'],
+        concurrentIoLimit: options?.concurrentIoLimit ?? os_1.default.cpus().length,
+        hashAlgorithm: options?.hashAlgorithm ?? 'sha1',
+        dirExcludes: options?.dirExcludes ?? [
+            '**/android/build',
+            '**/android/app/build',
+            '**/android/app/.cxx',
+            'ios/Pods',
+        ],
+    };
+}
+exports.normalizeOptions = normalizeOptions;
+//# sourceMappingURL=Options.js.map

package/build/Options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Options.js","sourceRoot":"","sources":["../src/Options.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AAIpB,SAAgB,gBAAgB,CAAC,OAAiB;IAChD,OAAO;QACL,GAAG,OAAO;QACV,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC;QACnD,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,YAAE,CAAC,IAAI,EAAE,CAAC,MAAM;QACjE,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,MAAM;QAC/C,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI;YACnC,kBAAkB;YAClB,sBAAsB;YACtB,qBAAqB;YACrB,UAAU;SACX;KACF,CAAC;AACJ,CAAC;AAbD,4CAaC"}

package/build/Sort.d.ts

@@ -0,0 +1,2 @@
+import type { HashSource } from './Fingerprint.types';
+export declare function sortSources<T extends HashSource>(sources: T[]): T[];

package/build/Sort.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortSources = void 0;
+function sortSources(sources) {
+    const typeOrder = {
+        file: 0,
+        dir: 1,
+        contents: 2,
+    };
+    return sources.sort((a, b) => {
+        const typeResult = typeOrder[a.type] - typeOrder[b.type];
+        if (typeResult === 0) {
+            if (a.type === 'file' && b.type === 'file') {
+                return a.filePath.localeCompare(b.filePath);
+            }
+            else if (a.type === 'dir' && b.type === 'dir') {
+                return a.filePath.localeCompare(b.filePath);
+            }
+            else if (a.type === 'contents' && b.type === 'contents') {
+                return a.id.localeCompare(b.id);
+            }
+        }
+        return typeResult;
+    });
+}
+exports.sortSources = sortSources;
+//# sourceMappingURL=Sort.js.map

package/build/Sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sort.js","sourceRoot":"","sources":["../src/Sort.ts"],"names":[],"mappings":";;;AAEA,SAAgB,WAAW,CAAuB,OAAY;IAC5D,MAAM,SAAS,GAAG;QAChB,IAAI,EAAE,CAAC;QACP,GAAG,EAAE,CAAC;QACN,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,UAAU,KAAK,CAAC,EAAE;YACpB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE;gBAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;aAC7C;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE;gBAC/C,OAAO,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;aAC7C;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE;gBACzD,OAAO,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACjC;SACF;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAnBD,kCAmBC"}

package/build/hash/Hash.d.ts

@@ -0,0 +1,28 @@
+import pLimit from 'p-limit';
+import type { Fingerprint, FingerprintSource, HashResult, HashSource, HashSourceContents, NormalizedOptions } from '../Fingerprint.types';
+/**
+ * Create a `Fingerprint` from `HashSources` array
+ */
+export declare function createFingerprintFromSourcesAsync(sources: HashSource[], projectRoot: string, options: NormalizedOptions): Promise<Fingerprint>;
+/**
+ * Create a `FingerprintSource` from a `HashSource`
+ * This function will get a hash value and merge back to original source
+ */
+export declare function createFingerprintSourceAsync(source: HashSource, limiter: pLimit.Limit, projectRoot: string, options: NormalizedOptions): Promise<FingerprintSource>;
+/**
+ * Create a `HashResult` from a file
+ */
+export declare function createFileHashResultsAsync(filePath: string, limiter: pLimit.Limit, projectRoot: string, options: NormalizedOptions): Promise<HashResult>;
+/**
+ * Create `HashResult` for a dir.
+ * If the dir is excluded, returns null rather than a HashResult
+ */
+export declare function createDirHashResultsAsync(dirPath: string, limiter: pLimit.Limit, projectRoot: string, options: NormalizedOptions, depth?: number): Promise<HashResult | null>;
+/**
+ * Create `HashResult` for a `HashSourceContents`
+ */
+export declare function createContentsHashResultsAsync(source: HashSourceContents, options: NormalizedOptions): Promise<HashResult>;
+/**
+ * Create id from given source
+ */
+export declare function createSourceId(source: HashSource): string;