@fgv/ts-extras 2.1.1-alpha.1 → 2.1.1-alpha.3

package/dist/ts-extras.d.ts

@@ -1,15 +1,8 @@
 import { Converter } from '@fgv/ts-utils';
 import { Converters as Converters_2 } from '@fgv/ts-utils';
+import { Hash as Hash_2 } from '@fgv/ts-utils';
 import { Result } from '@fgv/ts-utils';
 
-/**
- * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.
- * @param parts - The strings to be hashed
- * @returns An md5 hash of the parts
- * @public
- */
-declare function computeHash(parts: string[]): string;
-
 declare namespace Converters {
     export {
         extendedArrayOf,
@@ -199,8 +192,7 @@ declare interface Formattable {
 
     declare namespace Hash {
         export {
-            computeHash,
-            Normalizer
+            Md5Normalizer
         }
     }
     export { Hash }
@@ -226,46 +218,13 @@ declare interface Formattable {
     }
 
     /**
-     * Computes a normalized hash for an arbitrary javascript value.
+     * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object
+     * hash using the MD5 algorithm.
      * @public
      */
-    declare class Normalizer {
-        /**
-         * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not
-         * intended to be secure.  Also not fast and not intended to be fast.
-         *
-         * Normalization just sorts Maps, Sets and object keys by hash so that differences in order
-         * do not affect the hash.
-         *
-         * @param from - The arbitrary `unknown` to be hashed.
-         * @returns A normalized md5 hash for the supplied value.
-         */
-        computeHash(from: unknown): Result<string>;
-        /**
-         * Compares two property names from some object being normalized.
-         * @param k1 - First key to be compared.
-         * @param k2 - Second key to be compared.
-         * @returns `1` if `k1` is greater, `-1` if `k2` is greater and
-         * `0` if they are equal.
-         * @internal
-         */
-        protected _compareKeys(k1: unknown, k2: unknown): number;
-        /**
-         * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).
-         * @remarks
-         * Converts property names (entry key) to string and then sorts as string.
-         * @param entries - The entries to be normalized.
-         * @returns A normalized sorted array of entries.
-         * @internal
-         */
-        protected _normalizeEntries(entries: Iterable<[unknown, unknown]>): [unknown, unknown][];
-        /**
-         * Constructs a normalized string representation of some literal value.
-         * @param from - The literal value to be normalized.
-         * @returns A normalized string representation of the literal.
-         * @internal
-         */
-        protected _normalizeLiteral(from: string | number | bigint | boolean | symbol | undefined | Date | RegExp | null): Result<string>;
+    declare class Md5Normalizer extends Hash_2.HashingNormalizer {
+        constructor();
+        static md5Hash(parts: string[]): string;
     }
 
     /**

package/lib/packlets/hash/index.d.ts

@@ -1,2 +1,2 @@
-export * from './hash';
+export * from './md5Normalizer';
 //# sourceMappingURL=index.d.ts.map

package/lib/packlets/hash/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":"AAsBA,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":"AAsBA,cAAc,iBAAiB,CAAC"}

package/lib/packlets/hash/index.js

@@ -35,5 +35,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./hash"), exports);
+__exportStar(require("./md5Normalizer"), exports);
 //# sourceMappingURL=index.js.map

package/lib/packlets/hash/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,yCAAuB","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './hash';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/hash/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,kDAAgC","sourcesContent":["/*\n * Copyright (c) 2020 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nexport * from './md5Normalizer';\n"]}

package/lib/packlets/hash/md5Normalizer.d.ts

@@ -0,0 +1,11 @@
+import { Hash } from '@fgv/ts-utils';
+/**
+ * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object
+ * hash using the MD5 algorithm.
+ * @public
+ */
+export declare class Md5Normalizer extends Hash.HashingNormalizer {
+    constructor();
+    static md5Hash(parts: string[]): string;
+}
+//# sourceMappingURL=md5Normalizer.d.ts.map

package/lib/packlets/hash/md5Normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md5Normalizer.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/md5Normalizer.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,IAAI,CAAC,iBAAiB;;WAKzC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CAG/C"}

package/lib/packlets/hash/md5Normalizer.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ * Copyright (c) 2023 Erik Fortune
+ *
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Md5Normalizer = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const crypto = __importStar(require("crypto"));
+/**
+ * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object
+ * hash using the MD5 algorithm.
+ * @public
+ */
+class Md5Normalizer extends ts_utils_1.Hash.HashingNormalizer {
+    constructor() {
+        super(Md5Normalizer.md5Hash);
+    }
+    static md5Hash(parts) {
+        return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');
+    }
+}
+exports.Md5Normalizer = Md5Normalizer;
+//# sourceMappingURL=md5Normalizer.js.map

package/lib/packlets/hash/md5Normalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"md5Normalizer.js","sourceRoot":"","sources":["../../../src/packlets/hash/md5Normalizer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,4CAAqC;AACrC,+CAAiC;AACjC;;;;GAIG;AACH,MAAa,aAAc,SAAQ,eAAI,CAAC,iBAAiB;IACvD;QACE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,KAAe;QACnC,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC;CACF;AARD,sCAQC","sourcesContent":["/*\n * Copyright (c) 2023 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Hash } from '@fgv/ts-utils';\nimport * as crypto from 'crypto';\n/**\n * A {@link Hash.HashingNormalizer | hashing normalizer} which computes object\n * hash using the MD5 algorithm.\n * @public\n */\nexport class Md5Normalizer extends Hash.HashingNormalizer {\n  public constructor() {\n    super(Md5Normalizer.md5Hash);\n  }\n\n  public static md5Hash(parts: string[]): string {\n    return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fgv/ts-extras",
-	"version": "2.1.1-alpha.1",
+	"version": "2.1.1-alpha.3",
 	"description": "Assorted Typescript Utilities",
 	"main": "lib/index.js",
 	"types": "dist/ts-extras.d.ts",
@@ -46,8 +46,8 @@
 		"@types/heft-jest": "1.0.6",
 		"@rushstack/heft-jest-plugin": "~0.11.0",
 		"eslint-plugin-tsdoc": "~0.2.17",
-		"@fgv/ts-utils-jest": "2.1.1-alpha.1",
-		"@fgv/ts-utils": "2.1.1-alpha.1"
+		"@fgv/ts-utils-jest": "2.1.1-alpha.3",
+		"@fgv/ts-utils": "2.1.1-alpha.3"
 	},
 	"dependencies": {
 		"luxon": "^3.4.4",
@@ -55,7 +55,7 @@
 		"papaparse": "^5.4.1"
 	},
 	"peerDependencies": {
-		"@fgv/ts-utils": "2.1.1-alpha.1"
+		"@fgv/ts-utils": "2.1.1-alpha.3"
 	},
 	"scripts": {
 		"build": "heft test --clean",

package/lib/packlets/hash/hash.d.ts

@@ -1,51 +0,0 @@
-import { Result } from '@fgv/ts-utils';
-/**
- * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.
- * @param parts - The strings to be hashed
- * @returns An md5 hash of the parts
- * @public
- */
-export declare function computeHash(parts: string[]): string;
-/**
- * Computes a normalized hash for an arbitrary javascript value.
- * @public
- */
-export declare class Normalizer {
-    /**
-     * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not
-     * intended to be secure.  Also not fast and not intended to be fast.
-     *
-     * Normalization just sorts Maps, Sets and object keys by hash so that differences in order
-     * do not affect the hash.
-     *
-     * @param from - The arbitrary `unknown` to be hashed.
-     * @returns A normalized md5 hash for the supplied value.
-     */
-    computeHash(from: unknown): Result<string>;
-    /**
-     * Compares two property names from some object being normalized.
-     * @param k1 - First key to be compared.
-     * @param k2 - Second key to be compared.
-     * @returns `1` if `k1` is greater, `-1` if `k2` is greater and
-     * `0` if they are equal.
-     * @internal
-     */
-    protected _compareKeys(k1: unknown, k2: unknown): number;
-    /**
-     * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).
-     * @remarks
-     * Converts property names (entry key) to string and then sorts as string.
-     * @param entries - The entries to be normalized.
-     * @returns A normalized sorted array of entries.
-     * @internal
-     */
-    protected _normalizeEntries(entries: Iterable<[unknown, unknown]>): [unknown, unknown][];
-    /**
-     * Constructs a normalized string representation of some literal value.
-     * @param from - The literal value to be normalized.
-     * @returns A normalized string representation of the literal.
-     * @internal
-     */
-    protected _normalizeLiteral(from: string | number | bigint | boolean | symbol | undefined | Date | RegExp | null): Result<string>;
-}
-//# sourceMappingURL=hash.d.ts.map

package/lib/packlets/hash/hash.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/packlets/hash/hash.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,MAAM,EAA4C,MAAM,eAAe,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;;;;;OASG;IACI,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IA4BjD;;;;;;;OAOG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM;IAaxD;;;;;;;OAOG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;IAIxF;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CACzB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GACnF,MAAM,CAAC,MAAM,CAAC;CAuBlB"}

package/lib/packlets/hash/hash.js

@@ -1,166 +0,0 @@
-"use strict";
-/*
- * Copyright (c) 2021 Erik Fortune
- *
- * 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.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Normalizer = exports.computeHash = void 0;
-const crypto = __importStar(require("crypto"));
-const ts_utils_1 = require("@fgv/ts-utils");
-/**
- * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.
- * @param parts - The strings to be hashed
- * @returns An md5 hash of the parts
- * @public
- */
-function computeHash(parts) {
-    return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');
-}
-exports.computeHash = computeHash;
-/**
- * Computes a normalized hash for an arbitrary javascript value.
- * @public
- */
-class Normalizer {
-    /**
-     * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not
-     * intended to be secure.  Also not fast and not intended to be fast.
-     *
-     * Normalization just sorts Maps, Sets and object keys by hash so that differences in order
-     * do not affect the hash.
-     *
-     * @param from - The arbitrary `unknown` to be hashed.
-     * @returns A normalized md5 hash for the supplied value.
-     */
-    computeHash(from) {
-        switch (typeof from) {
-            case 'string':
-            case 'bigint':
-            case 'boolean':
-            case 'number':
-            case 'symbol':
-            case 'undefined':
-                return this._normalizeLiteral(from).onSuccess((v) => {
-                    return (0, ts_utils_1.captureResult)(() => computeHash([v]));
-                });
-            case 'object':
-                if (from === null || from instanceof Date || from instanceof RegExp) {
-                    return this._normalizeLiteral(from).onSuccess((v) => {
-                        return (0, ts_utils_1.captureResult)(() => computeHash([v]));
-                    });
-                }
-                else if (Array.isArray(from)) {
-                    return (0, ts_utils_1.mapResults)(from.map((e) => this.computeHash(e))).onSuccess((a) => {
-                        return (0, ts_utils_1.captureResult)(() => computeHash(a));
-                    });
-                }
-                else if (from instanceof Map || from instanceof Set) {
-                    return this.computeHash(this._normalizeEntries(from.entries()));
-                }
-                return this.computeHash(this._normalizeEntries(Object.entries(from)));
-        }
-        return (0, ts_utils_1.fail)(`computeHash: Unexpected type - cannot hash '${typeof from}'`);
-    }
-    /**
-     * Compares two property names from some object being normalized.
-     * @param k1 - First key to be compared.
-     * @param k2 - Second key to be compared.
-     * @returns `1` if `k1` is greater, `-1` if `k2` is greater and
-     * `0` if they are equal.
-     * @internal
-     */
-    _compareKeys(k1, k2) {
-        const cs1 = String(k1);
-        const cs2 = String(k2);
-        if (cs1 > cs2) {
-            return 1;
-        }
-        if (cs2 > cs1) {
-            return -1;
-        }
-        /* c8 ignore next 2 */
-        return 0;
-    }
-    /**
-     * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).
-     * @remarks
-     * Converts property names (entry key) to string and then sorts as string.
-     * @param entries - The entries to be normalized.
-     * @returns A normalized sorted array of entries.
-     * @internal
-     */
-    _normalizeEntries(entries) {
-        return Array.from(entries).sort((e1, e2) => this._compareKeys(e1[0], e2[0]));
-    }
-    /**
-     * Constructs a normalized string representation of some literal value.
-     * @param from - The literal value to be normalized.
-     * @returns A normalized string representation of the literal.
-     * @internal
-     */
-    _normalizeLiteral(from) {
-        switch (typeof from) {
-            case 'string':
-                return (0, ts_utils_1.succeed)(from);
-            case 'bigint':
-            case 'boolean':
-            case 'number':
-            case 'symbol':
-            case 'undefined':
-                return (0, ts_utils_1.succeed)(`${typeof from}:[[[${String(from)}]]]`);
-        }
-        if (from === null) {
-            return (0, ts_utils_1.succeed)('object:[[[null]]');
-        }
-        if (from instanceof Date) {
-            return (0, ts_utils_1.succeed)(`Date:[[[${String(from.valueOf())}]]]`);
-        }
-        if (from instanceof RegExp) {
-            return (0, ts_utils_1.succeed)(`RegExp:[[[${from.toString()}]]]`);
-        }
-        /* c8 ignore next 2 */
-        return (0, ts_utils_1.fail)(`cannot normalize ${JSON.stringify(from)}`);
-    }
-}
-exports.Normalizer = Normalizer;
-//# sourceMappingURL=hash.js.map

package/lib/packlets/hash/hash.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/packlets/hash/hash.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2021 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport * as crypto from 'crypto';\nimport { Result, captureResult, fail, mapResults, succeed } from '@fgv/ts-utils';\n\n/**\n * Computes an md5 hash from an array of strings. Not secure and not intended to be secure.\n * @param parts - The strings to be hashed\n * @returns An md5 hash of the parts\n * @public\n */\nexport function computeHash(parts: string[]): string {\n  return crypto.createHash('md5').update(parts.join('|'), 'utf8').digest('hex');\n}\n\n/**\n * Computes a normalized hash for an arbitrary javascript value.\n * @public\n */\nexport class Normalizer {\n  /**\n   * Computes a normalized md5 hash from an arbitrary supplied object.  Not secure and not\n   * intended to be secure.  Also not fast and not intended to be fast.\n   *\n   * Normalization just sorts Maps, Sets and object keys by hash so that differences in order\n   * do not affect the hash.\n   *\n   * @param from - The arbitrary `unknown` to be hashed.\n   * @returns A normalized md5 hash for the supplied value.\n   */\n  public computeHash(from: unknown): Result<string> {\n    switch (typeof from) {\n      case 'string':\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return this._normalizeLiteral(from).onSuccess((v) => {\n          return captureResult(() => computeHash([v]));\n        });\n      case 'object':\n        if (from === null || from instanceof Date || from instanceof RegExp) {\n          return this._normalizeLiteral(from).onSuccess((v) => {\n            return captureResult(() => computeHash([v]));\n          });\n        } else if (Array.isArray(from)) {\n          return mapResults(from.map((e) => this.computeHash(e))).onSuccess((a) => {\n            return captureResult(() => computeHash(a));\n          });\n        } else if (from instanceof Map || from instanceof Set) {\n          return this.computeHash(this._normalizeEntries(from.entries()));\n        }\n        return this.computeHash(this._normalizeEntries(Object.entries(from)));\n    }\n    return fail(`computeHash: Unexpected type - cannot hash '${typeof from}'`);\n  }\n\n  /**\n   * Compares two property names from some object being normalized.\n   * @param k1 - First key to be compared.\n   * @param k2 - Second key to be compared.\n   * @returns `1` if `k1` is greater, `-1` if `k2` is greater and\n   * `0` if they are equal.\n   * @internal\n   */\n  protected _compareKeys(k1: unknown, k2: unknown): number {\n    const cs1 = String(k1);\n    const cs2 = String(k2);\n    if (cs1 > cs2) {\n      return 1;\n    }\n    if (cs2 > cs1) {\n      return -1;\n    }\n    /* c8 ignore next 2 */\n    return 0;\n  }\n\n  /**\n   * Normalizes an array of object property entries (e.g. as returned by `Object.entries()`).\n   * @remarks\n   * Converts property names (entry key) to string and then sorts as string.\n   * @param entries - The entries to be normalized.\n   * @returns A normalized sorted array of entries.\n   * @internal\n   */\n  protected _normalizeEntries(entries: Iterable<[unknown, unknown]>): [unknown, unknown][] {\n    return Array.from(entries).sort((e1, e2) => this._compareKeys(e1[0], e2[0]));\n  }\n\n  /**\n   * Constructs a normalized string representation of some literal value.\n   * @param from - The literal value to be normalized.\n   * @returns A normalized string representation of the literal.\n   * @internal\n   */\n  protected _normalizeLiteral(\n    from: string | number | bigint | boolean | symbol | undefined | Date | RegExp | null\n  ): Result<string> {\n    switch (typeof from) {\n      case 'string':\n        return succeed(from);\n      case 'bigint':\n      case 'boolean':\n      case 'number':\n      case 'symbol':\n      case 'undefined':\n        return succeed(`${typeof from}:[[[${String(from)}]]]`);\n    }\n    if (from === null) {\n      return succeed('object:[[[null]]');\n    }\n    if (from instanceof Date) {\n      return succeed(`Date:[[[${String(from.valueOf())}]]]`);\n    }\n    if (from instanceof RegExp) {\n      return succeed(`RegExp:[[[${from.toString()}]]]`);\n    }\n    /* c8 ignore next 2 */\n    return fail(`cannot normalize ${JSON.stringify(from)}`);\n  }\n}\n"]}