2019-11-12 20:55:13 +08:00
|
|
|
/*
|
|
|
|
MIT License http://www.opensource.org/licenses/mit-license.php
|
|
|
|
Author Tobias Koppers @sokra
|
|
|
|
*/
|
|
|
|
|
|
|
|
"use strict";
|
|
|
|
|
2025-03-14 03:39:02 +08:00
|
|
|
const { DEFAULTS } = require("../config/defaults");
|
2019-11-12 20:55:13 +08:00
|
|
|
const createHash = require("../util/createHash");
|
|
|
|
|
|
|
|
/** @typedef {import("../util/Hash")} Hash */
|
2021-09-22 18:12:46 +08:00
|
|
|
/** @typedef {typeof import("../util/Hash")} HashConstructor */
|
2019-11-12 20:55:13 +08:00
|
|
|
|
|
|
|
/**
|
2024-06-11 21:09:50 +08:00
|
|
|
* @typedef {object} HashableObject
|
2025-03-12 09:56:14 +08:00
|
|
|
* @property {(hash: Hash) => void} updateHash
|
2019-11-12 20:55:13 +08:00
|
|
|
*/
|
|
|
|
|
|
|
|
class LazyHashedEtag {
|
|
|
|
/**
|
|
|
|
* @param {HashableObject} obj object with updateHash method
|
2021-09-22 18:12:46 +08:00
|
|
|
* @param {string | HashConstructor} hashFunction the hash function to use
|
2019-11-12 20:55:13 +08:00
|
|
|
*/
|
2025-03-14 03:39:02 +08:00
|
|
|
constructor(obj, hashFunction = DEFAULTS.HASH_FUNCTION) {
|
2019-11-12 20:55:13 +08:00
|
|
|
this._obj = obj;
|
|
|
|
this._hash = undefined;
|
2021-09-22 18:12:46 +08:00
|
|
|
this._hashFunction = hashFunction;
|
2019-11-12 20:55:13 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @returns {string} hash of object
|
|
|
|
*/
|
|
|
|
toString() {
|
|
|
|
if (this._hash === undefined) {
|
2021-09-22 18:12:46 +08:00
|
|
|
const hash = createHash(this._hashFunction);
|
2019-11-12 20:55:13 +08:00
|
|
|
this._obj.updateHash(hash);
|
|
|
|
this._hash = /** @type {string} */ (hash.digest("base64"));
|
|
|
|
}
|
|
|
|
return this._hash;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-09-22 18:12:46 +08:00
|
|
|
/** @type {Map<string | HashConstructor, WeakMap<HashableObject, LazyHashedEtag>>} */
|
|
|
|
const mapStrings = new Map();
|
|
|
|
|
|
|
|
/** @type {WeakMap<HashConstructor, WeakMap<HashableObject, LazyHashedEtag>>} */
|
|
|
|
const mapObjects = new WeakMap();
|
2019-11-12 20:55:13 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @param {HashableObject} obj object with updateHash method
|
2024-03-18 01:15:44 +08:00
|
|
|
* @param {(string | HashConstructor)=} hashFunction the hash function to use
|
2019-11-12 20:55:13 +08:00
|
|
|
* @returns {LazyHashedEtag} etag
|
|
|
|
*/
|
2025-03-14 03:39:02 +08:00
|
|
|
const getter = (obj, hashFunction = DEFAULTS.HASH_FUNCTION) => {
|
2021-09-22 18:12:46 +08:00
|
|
|
let innerMap;
|
|
|
|
if (typeof hashFunction === "string") {
|
|
|
|
innerMap = mapStrings.get(hashFunction);
|
|
|
|
if (innerMap === undefined) {
|
|
|
|
const newHash = new LazyHashedEtag(obj, hashFunction);
|
|
|
|
innerMap = new WeakMap();
|
|
|
|
innerMap.set(obj, newHash);
|
|
|
|
mapStrings.set(hashFunction, innerMap);
|
|
|
|
return newHash;
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
innerMap = mapObjects.get(hashFunction);
|
|
|
|
if (innerMap === undefined) {
|
|
|
|
const newHash = new LazyHashedEtag(obj, hashFunction);
|
|
|
|
innerMap = new WeakMap();
|
|
|
|
innerMap.set(obj, newHash);
|
|
|
|
mapObjects.set(hashFunction, innerMap);
|
|
|
|
return newHash;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
const hash = innerMap.get(obj);
|
2019-11-12 20:55:13 +08:00
|
|
|
if (hash !== undefined) return hash;
|
2021-09-22 18:12:46 +08:00
|
|
|
const newHash = new LazyHashedEtag(obj, hashFunction);
|
|
|
|
innerMap.set(obj, newHash);
|
2019-11-12 20:55:13 +08:00
|
|
|
return newHash;
|
|
|
|
};
|
|
|
|
|
|
|
|
module.exports = getter;
|