@blumintinc/typescript-memoize 1.2.0

package/README.md

@@ -0,0 +1,342 @@
+# typescript-memoize
+
+[![npm](https://img.shields.io/npm/v/typescript-memoize.svg)](https://www.npmjs.com/package/typescript-memoize)
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/darrylhodgins/typescript-memoize/master/LICENSE)
+![Test](https://github.com/darrylhodgins/typescript-memoize/workflows/Test/badge.svg)
+
+A memoize decorator for Typescript.
+
+## Installation
+
+```
+npm install --save typescript-memoize
+```
+
+## Usage:
+
+```typescript
+@Memoize(hashFunction?: (...args: any[]) => any)
+```
+
+You can use it in several ways:
+
+* Memoize a `get` accessor,
+* Memoize a method which takes no parameters,
+* Memoize a method which varies based on its first parameter only,
+* Memoize a method which varies based on some combination of parameters
+* Memoize a method using objects with deep equality comparison (default)
+
+You can call memoized methods *within* the same class, too.  This could be useful if you want to memoize the return value for an entire data set, and also a filtered or mapped version of that same set.
+
+## Memoize a `get` accessor, or a method which takes no parameters
+
+These both work the same way. Subsequent calls to a memoized method without parameters, or to a `get` accessor, always return the same value.
+
+I generally consider it an anti-pattern for a call to a `get` accessor to trigger an expensive operation.  Simply adding `Memoize()` to a `get` allows for seamless lazy-loading.
+
+```typescript
+import {Memoize,MemoizeExpiring} from 'typescript-memoize';
+
+class SimpleFoo {
+
+    // Memoize a method without parameters
+    @Memoize()
+    public getAllTheData() {
+       // do some expensive operation to get data
+       return data;
+    }
+
+    // Memoize a method and expire the value after some time in milliseconds
+    @MemoizeExpiring(5000)
+    public getDataForSomeTime() {
+        // do some expensive operation to get data
+        return data;
+    }
+
+    // Memoize a getter
+    @Memoize()
+    public get someValue() {
+        // do some expensive operation to calculate value
+        return value;
+    }
+
+}
+```
+
+And then we call them from somewhere else in our code:
+
+```typescript
+let simpleFoo = new SimpleFoo();
+
+// Memoizes a calculated value and returns it:
+let methodVal1 = simpleFoo.getAllTheData();
+
+// Returns memoized value
+let methodVal2 = simpleFoo.getAllTheData();
+
+// Memoizes (lazy-loads) a calculated value and returns it:
+let getterVal1 = simpleFoo.someValue;
+
+// Returns memoized value
+let getterVal2 = simpleFoo.someValue;
+
+```
+
+## Memoize a method which varies based on its first parameter only
+
+Subsequent calls to this style of memoized method will always return the same value.
+
+I'm not really sure why anyone would use this approach to memoize a method with *more* than one parameter, but it's possible.
+
+```typescript
+import {Memoize} from 'typescript-memoize';
+
+class ComplicatedFoo {
+
+	// Memoize a method without parameters (just like the first example)
+	@Memoize()
+	public getAllTheData() {
+		// do some expensive operation to get data
+		return data;
+	}
+
+	// Memoize a method with one parameter
+	@Memoize()
+	public getSomeOfTheData(id: number) {
+		let allTheData = this.getAllTheData(); // if you want to!
+		// do some expensive operation to get data
+		return data;
+	}
+
+	// Memoize a method with multiple parameters
+	// Only the first parameter will be used for memoization
+	@Memoize()
+	public getGreeting(name: string, planet: string) {
+		return 'Hello, ' + name + '! Welcome to ' + planet;
+	}
+
+}
+```
+
+We call these methods from somewhere else in our code:
+
+```typescript
+let complicatedFoo = new ComplicatedFoo();
+
+// Returns calculated value and memoizes it:
+let oneParam1 = complicatedFoo.getSomeOfTheData();
+
+// Returns memoized value
+let oneParam2 = complicatedFoo.getSomeOfTheData();
+
+// Memoizes a calculated value and returns it:
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal1 = complicatedFoo.getGreeting('Darryl', 'Earth');
+
+// Ignores the second parameter, and returns memoized value
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal2 = complicatedFoo.getGreeting('Darryl', 'Mars');
+```
+
+## Memoize a method which varies based on some combination of parameters
+
+Pass in a `hashFunction` which takes the same parameters as your target method, to memoize values based on all parameters, or some other custom logic
+
+```typescript
+import {Memoize} from 'typescript-memoize';
+
+class MoreComplicatedFoo {
+
+	// Memoize a method with multiple parameters
+	// Memoize will remember values based on keys like: 'name;planet'
+	@Memoize((name: string, planet: string) => {
+		return name + ';' + planet;
+	})
+	public getBetterGreeting(name: string, planet: string) {
+		return 'Hello, ' + name + '! Welcome to ' + planet;
+	}
+	
+	// Memoize based on some other logic
+	@Memoize(() => {
+		return new Date();
+	})
+	public memoryLeak(greeting: string) {
+		return greeting + '!!!!!';
+	}
+
+	// Memoize also accepts parameters via a single object argument
+	@Memoize({
+		expiring: 10000, // milliseconds
+		hashFunction: (name: string, planet: string) => {
+			return name + ';' + planet;
+		}
+	})
+	public getSameBetterGreeting(name: string, planet: string) {
+		return 'Hello, ' + name + '! Welcome to ' + planet;
+	}
+
+}
+```
+
+We call these methods from somewhere else in our code.  By now you should be getting the idea:
+
+```typescript
+let moreComplicatedFoo = new MoreComplicatedFoo();
+
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal1 = moreComplicatedFoo.getBetterGreeting('Darryl', 'Earth');
+
+// 'Hello, Darryl! Welcome to Mars'
+let greeterVal2 = moreComplicatedFoo.getBetterGreeting('Darryl', 'Mars');
+
+// Fill up the computer with useless greetings:
+let greeting = moreComplicatedFoo.memoryLeak('Hello');
+
+```
+
+## Memoize accepts one or more "tag" strings that allow the cache to be invalidated on command
+
+Passing an array with one or more "tag" strings these will allow you to later clear the cache of results associated with methods or the `get`accessors using the `clear()` function.
+
+The `clear()` function also requires an array of "tag" strings.
+
+```typescript
+import {Memoize} from 'typescript-memoize';
+
+class ClearableFoo {
+
+	// Memoize accepts tags
+	@Memoize({ tags: ["foo", "bar"] })
+	public getClearableGreeting(name: string, planet: string) {
+		return 'Hello, ' + name + '! Welcome to ' + planet;
+	}
+
+
+	// Memoize accepts tags
+	@Memoize({ tags: ["bar"] })
+	public getClearableSum(a: number, b: number) {
+		return a + b;
+	}
+
+}
+```
+
+We call these methods from somewhere else in our code.
+
+```typescript
+import {clear} from 'typescript-memoize';
+
+let clearableFoo = new ClearableFoo();
+
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal1 = clearableFoo.getClearableGreeting('Darryl', 'Earth');
+
+// Ignores the second parameter, and returns memoized value
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal2 = clearableFoo.getClearableGreeting('Darryl', 'Mars');
+
+// '3'
+let sum1 = clearableFoo.getClearableSum(2, 1);
+
+// Ignores the second parameter, and returns memoized value
+// '3'
+let sum2 = clearableFoo.getClearableSum(2, 2);
+
+clear(["foo"]);
+
+// The memoized values are cleared, return a new value
+// 'Hello, Darryl! Welcome to Mars'
+let greeterVal3 = clearableFoo.getClearableGreeting('Darryl', 'Mars');
+
+
+// The memoized value is not associated with 'foo' tag, returns memoized value
+// '3'
+let sum3 = clearableFoo.getClearableSum(2, 2);
+
+clear(["bar"]);
+
+// The memoized values are cleared, return a new value
+// 'Hello, Darryl! Welcome to Earth'
+let greeterVal4 = clearableFoo.getClearableGreeting('Darryl', 'Earth');
+
+
+// The memoized values are cleared, return a new value
+// '4'
+let sum4 = clearableFoo.getClearableSum(2, 2);
+
+```
+
+## Memoize with deep equality comparison
+
+By default, memoization now uses deep equality when comparing objects, which is useful for objects and arrays with the same structure but different references. If needed, you can disable deep equality with the `useDeepEqual: false` option:
+
+```typescript
+import {Memoize} from 'typescript-memoize';
+
+class DeepEqualityFoo {
+    // Uses deep equality comparison by default
+    @Memoize()
+    public processObject(obj: any) {
+        // This will only be called once for objects with the same structure,
+        // even if they are different instances
+        return expensiveOperation(obj);
+    }
+
+    // Disable deep equality if you want reference equality instead
+    @Memoize({
+        useDeepEqual: false
+    })
+    public processObjectWithReferenceEquality(obj: any) {
+        // This will be called for each new object reference,
+        // even if they have the same structure
+        return expensiveOperation(obj);
+    }
+
+    // Combine with other options
+    @Memoize({
+        expiring: 5000, // expire after 5 seconds
+        tags: ["objects"]
+    })
+    public processComplexObject(obj: any) {
+        return expensiveOperation(obj);
+    }
+}
+```
+
+We can call these methods and get memoized results based on deep equality:
+
+```typescript
+let deepFoo = new DeepEqualityFoo();
+
+// First call with an object
+const result1 = deepFoo.processObject({ id: 123, name: "Test" });
+
+// Second call with different object instance but same structure
+// Will return the memoized result without calling the original method again
+const result2 = deepFoo.processObject({ id: 123, name: "Test" });
+
+// Call with different object structure
+// Will call the original method again
+const result3 = deepFoo.processObject({ id: 456, name: "Different" });
+
+// Deep equality works with complex nested objects too
+const result4 = deepFoo.processComplexObject({ 
+    user: { 
+        id: 123, 
+        details: { 
+            age: 30, 
+            preferences: ["red", "blue"] 
+        } 
+    }
+});
+
+// Using reference equality will call the method for each new object
+const refObj = { id: 123, name: "Test" };
+const result5 = deepFoo.processObjectWithReferenceEquality(refObj);
+// This will be memoized since it's the same reference
+const result6 = deepFoo.processObjectWithReferenceEquality(refObj);
+// This will call the method again since it's a new reference
+const result7 = deepFoo.processObjectWithReferenceEquality({ id: 123, name: "Test" });
+```
+
+The deep equality comparison uses the [fast-deep-equal](https://www.npmjs.com/package/fast-deep-equal) package for efficient deep equality comparisons.

package/dist/es2015/memoize-decorator.d.ts

@@ -0,0 +1,10 @@
+interface MemoizeArgs {
+    expiring?: number;
+    hashFunction?: boolean | ((...args: any[]) => any);
+    tags?: string[];
+    useDeepEqual?: boolean;
+}
+export declare function Memoize(args?: MemoizeArgs | MemoizeArgs['hashFunction']): (target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => void;
+export declare function MemoizeExpiring(expiring: number, hashFunction?: MemoizeArgs['hashFunction']): (target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => void;
+export declare function clear(tags: string[]): number;
+export {};

package/dist/es2015/memoize-decorator.js

@@ -0,0 +1,219 @@
+const equal = require('fast-deep-equal');
+export function Memoize(args) {
+    var _a;
+    let hashFunction;
+    let duration;
+    let tags;
+    let useDeepEqual = false;
+    if (typeof args === 'object') {
+        hashFunction = args.hashFunction;
+        duration = args.expiring;
+        tags = args.tags;
+        useDeepEqual = (_a = args.useDeepEqual) !== null && _a !== void 0 ? _a : false;
+    }
+    else {
+        hashFunction = args;
+    }
+    return (target, propertyKey, descriptor) => {
+        if (descriptor.value != null) {
+            descriptor.value = getNewFunction(descriptor.value, hashFunction, duration, tags, useDeepEqual);
+        }
+        else if (descriptor.get != null) {
+            descriptor.get = getNewFunction(descriptor.get, hashFunction, duration, tags, useDeepEqual);
+        }
+        else {
+            throw 'Only put a Memoize() decorator on a method or get accessor.';
+        }
+    };
+}
+export function MemoizeExpiring(expiring, hashFunction) {
+    return Memoize({
+        expiring,
+        hashFunction
+    });
+}
+const clearCacheTagsMap = new Map();
+export function clear(tags) {
+    const cleared = new Set();
+    for (const tag of tags) {
+        const maps = clearCacheTagsMap.get(tag);
+        if (maps) {
+            for (const mp of maps) {
+                if (!cleared.has(mp)) {
+                    mp.clear();
+                    cleared.add(mp);
+                }
+            }
+        }
+    }
+    return cleared.size;
+}
+class DeepEqualMap {
+    constructor() {
+        this.map = new Map();
+    }
+    has(key) {
+        const entries = Array.from(this.map.values());
+        for (const entry of entries) {
+            if (equal(entry.key, key)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    get(key) {
+        const entries = Array.from(this.map.values());
+        for (const entry of entries) {
+            if (equal(entry.key, key)) {
+                return entry.value;
+            }
+        }
+        return undefined;
+    }
+    set(key, value) {
+        const entries = Array.from(this.map.entries());
+        for (const [serializedKey, entry] of entries) {
+            if (equal(entry.key, key)) {
+                this.map.delete(serializedKey);
+                break;
+            }
+        }
+        const serializedKey = `${Date.now()}_${Math.random()}`;
+        this.map.set(serializedKey, { key, value });
+        return this;
+    }
+    clear() {
+        this.map.clear();
+    }
+}
+function getNewFunction(originalMethod, hashFunction, duration = 0, tags, useDeepEqual = false) {
+    const propMapName = Symbol(`__memoized_map__`);
+    const propDeepMapName = Symbol(`__memoized_deep_map__`);
+    return function (...args) {
+        let returnedValue;
+        if (useDeepEqual) {
+            if (!this.hasOwnProperty(propDeepMapName)) {
+                Object.defineProperty(this, propDeepMapName, {
+                    configurable: false,
+                    enumerable: false,
+                    writable: false,
+                    value: new DeepEqualMap()
+                });
+            }
+            let myMap = this[propDeepMapName];
+            if (Array.isArray(tags)) {
+                for (const tag of tags) {
+                    const mapWrapper = {
+                        clear: () => myMap.clear()
+                    };
+                    if (clearCacheTagsMap.has(tag)) {
+                        clearCacheTagsMap.get(tag).push(mapWrapper);
+                    }
+                    else {
+                        clearCacheTagsMap.set(tag, [mapWrapper]);
+                    }
+                }
+            }
+            let hashKey;
+            if (hashFunction === true) {
+                hashKey = args;
+            }
+            else if (hashFunction) {
+                hashKey = hashFunction.apply(this, args);
+            }
+            else if (args.length > 0) {
+                hashKey = args.length === 1 ? args[0] : args;
+            }
+            else {
+                hashKey = this;
+            }
+            const timestampKey = { __timestamp: true, key: hashKey };
+            let isExpired = false;
+            if (duration > 0) {
+                if (!myMap.has(timestampKey)) {
+                    isExpired = true;
+                }
+                else {
+                    let timestamp = myMap.get(timestampKey);
+                    isExpired = (Date.now() - timestamp) > duration;
+                }
+            }
+            if (myMap.has(hashKey) && !isExpired) {
+                returnedValue = myMap.get(hashKey);
+            }
+            else {
+                returnedValue = originalMethod.apply(this, args);
+                myMap.set(hashKey, returnedValue);
+                if (duration > 0) {
+                    myMap.set(timestampKey, Date.now());
+                }
+            }
+        }
+        else {
+            if (!this.hasOwnProperty(propMapName)) {
+                Object.defineProperty(this, propMapName, {
+                    configurable: false,
+                    enumerable: false,
+                    writable: false,
+                    value: new Map()
+                });
+            }
+            let myMap = this[propMapName];
+            if (Array.isArray(tags)) {
+                for (const tag of tags) {
+                    if (clearCacheTagsMap.has(tag)) {
+                        clearCacheTagsMap.get(tag).push(myMap);
+                    }
+                    else {
+                        clearCacheTagsMap.set(tag, [myMap]);
+                    }
+                }
+            }
+            if (hashFunction || args.length > 0 || duration > 0) {
+                let hashKey;
+                if (hashFunction === true) {
+                    hashKey = args.map(a => a.toString()).join('!');
+                }
+                else if (hashFunction) {
+                    hashKey = hashFunction.apply(this, args);
+                }
+                else {
+                    hashKey = args[0];
+                }
+                const timestampKey = `${hashKey}__timestamp`;
+                let isExpired = false;
+                if (duration > 0) {
+                    if (!myMap.has(timestampKey)) {
+                        isExpired = true;
+                    }
+                    else {
+                        let timestamp = myMap.get(timestampKey);
+                        isExpired = (Date.now() - timestamp) > duration;
+                    }
+                }
+                if (myMap.has(hashKey) && !isExpired) {
+                    returnedValue = myMap.get(hashKey);
+                }
+                else {
+                    returnedValue = originalMethod.apply(this, args);
+                    myMap.set(hashKey, returnedValue);
+                    if (duration > 0) {
+                        myMap.set(timestampKey, Date.now());
+                    }
+                }
+            }
+            else {
+                const hashKey = this;
+                if (myMap.has(hashKey)) {
+                    returnedValue = myMap.get(hashKey);
+                }
+                else {
+                    returnedValue = originalMethod.apply(this, args);
+                    myMap.set(hashKey, returnedValue);
+                }
+            }
+        }
+        return returnedValue;
+    };
+}
+//# sourceMappingURL=memoize-decorator.js.map

package/dist/es2015/memoize-decorator.js.map

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

package/dist/memoize-decorator.d.ts

@@ -0,0 +1,10 @@
+interface MemoizeArgs {
+    expiring?: number;
+    hashFunction?: boolean | ((...args: any[]) => any);
+    tags?: string[];
+    useDeepEqual?: boolean;
+}
+export declare function Memoize(args?: MemoizeArgs | MemoizeArgs['hashFunction']): (target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => void;
+export declare function MemoizeExpiring(expiring: number, hashFunction?: MemoizeArgs['hashFunction']): (target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => void;
+export declare function clear(tags: string[]): number;
+export {};

package/dist/memoize-decorator.js

@@ -0,0 +1,249 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.clear = exports.MemoizeExpiring = exports.Memoize = void 0;
+    var equal = require('fast-deep-equal');
+    function Memoize(args) {
+        var _a;
+        var hashFunction;
+        var duration;
+        var tags;
+        var useDeepEqual = true;
+        if (typeof args === 'object') {
+            hashFunction = args.hashFunction;
+            duration = args.expiring;
+            tags = args.tags;
+            useDeepEqual = (_a = args.useDeepEqual) !== null && _a !== void 0 ? _a : true;
+        }
+        else {
+            hashFunction = args;
+        }
+        return function (target, propertyKey, descriptor) {
+            if (descriptor.value != null) {
+                descriptor.value = getNewFunction(descriptor.value, hashFunction, duration, tags, useDeepEqual);
+            }
+            else if (descriptor.get != null) {
+                descriptor.get = getNewFunction(descriptor.get, hashFunction, duration, tags, useDeepEqual);
+            }
+            else {
+                throw 'Only put a Memoize() decorator on a method or get accessor.';
+            }
+        };
+    }
+    exports.Memoize = Memoize;
+    function MemoizeExpiring(expiring, hashFunction) {
+        return Memoize({
+            expiring: expiring,
+            hashFunction: hashFunction
+        });
+    }
+    exports.MemoizeExpiring = MemoizeExpiring;
+    var clearCacheTagsMap = new Map();
+    function clear(tags) {
+        var cleared = new Set();
+        for (var _i = 0, tags_1 = tags; _i < tags_1.length; _i++) {
+            var tag = tags_1[_i];
+            var maps = clearCacheTagsMap.get(tag);
+            if (maps) {
+                for (var _a = 0, maps_1 = maps; _a < maps_1.length; _a++) {
+                    var mp = maps_1[_a];
+                    if (!cleared.has(mp)) {
+                        mp.clear();
+                        cleared.add(mp);
+                    }
+                }
+            }
+        }
+        return cleared.size;
+    }
+    exports.clear = clear;
+    var DeepEqualMap = (function () {
+        function DeepEqualMap() {
+            this.map = new Map();
+        }
+        DeepEqualMap.prototype.has = function (key) {
+            var entries = Array.from(this.map.values());
+            for (var _i = 0, entries_1 = entries; _i < entries_1.length; _i++) {
+                var entry = entries_1[_i];
+                if (equal(entry.key, key)) {
+                    return true;
+                }
+            }
+            return false;
+        };
+        DeepEqualMap.prototype.get = function (key) {
+            var entries = Array.from(this.map.values());
+            for (var _i = 0, entries_2 = entries; _i < entries_2.length; _i++) {
+                var entry = entries_2[_i];
+                if (equal(entry.key, key)) {
+                    return entry.value;
+                }
+            }
+            return undefined;
+        };
+        DeepEqualMap.prototype.set = function (key, value) {
+            var entries = Array.from(this.map.entries());
+            for (var _i = 0, entries_3 = entries; _i < entries_3.length; _i++) {
+                var _a = entries_3[_i], serializedKey_1 = _a[0], entry = _a[1];
+                if (equal(entry.key, key)) {
+                    this.map.delete(serializedKey_1);
+                    break;
+                }
+            }
+            var serializedKey = Date.now() + "_" + Math.random();
+            this.map.set(serializedKey, { key: key, value: value });
+            return this;
+        };
+        DeepEqualMap.prototype.clear = function () {
+            this.map.clear();
+        };
+        return DeepEqualMap;
+    }());
+    function getNewFunction(originalMethod, hashFunction, duration, tags, useDeepEqual) {
+        if (duration === void 0) { duration = 0; }
+        if (useDeepEqual === void 0) { useDeepEqual = true; }
+        var propMapName = Symbol("__memoized_map__");
+        var propDeepMapName = Symbol("__memoized_deep_map__");
+        return function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            var returnedValue;
+            if (useDeepEqual) {
+                if (!this.hasOwnProperty(propDeepMapName)) {
+                    Object.defineProperty(this, propDeepMapName, {
+                        configurable: false,
+                        enumerable: false,
+                        writable: false,
+                        value: new DeepEqualMap()
+                    });
+                }
+                var myMap_1 = this[propDeepMapName];
+                if (Array.isArray(tags)) {
+                    for (var _a = 0, tags_2 = tags; _a < tags_2.length; _a++) {
+                        var tag = tags_2[_a];
+                        var mapWrapper = {
+                            clear: function () { return myMap_1.clear(); }
+                        };
+                        if (clearCacheTagsMap.has(tag)) {
+                            clearCacheTagsMap.get(tag).push(mapWrapper);
+                        }
+                        else {
+                            clearCacheTagsMap.set(tag, [mapWrapper]);
+                        }
+                    }
+                }
+                var hashKey = void 0;
+                if (hashFunction === true) {
+                    hashKey = args;
+                }
+                else if (hashFunction) {
+                    hashKey = hashFunction.apply(this, args);
+                }
+                else if (args.length > 0) {
+                    hashKey = args.length === 1 ? args[0] : args;
+                }
+                else {
+                    hashKey = this;
+                }
+                var timestampKey = { __timestamp: true, key: hashKey };
+                var isExpired = false;
+                if (duration > 0) {
+                    if (!myMap_1.has(timestampKey)) {
+                        isExpired = true;
+                    }
+                    else {
+                        var timestamp = myMap_1.get(timestampKey);
+                        isExpired = (Date.now() - timestamp) > duration;
+                    }
+                }
+                if (myMap_1.has(hashKey) && !isExpired) {
+                    returnedValue = myMap_1.get(hashKey);
+                }
+                else {
+                    returnedValue = originalMethod.apply(this, args);
+                    myMap_1.set(hashKey, returnedValue);
+                    if (duration > 0) {
+                        myMap_1.set(timestampKey, Date.now());
+                    }
+                }
+            }
+            else {
+                if (!this.hasOwnProperty(propMapName)) {
+                    Object.defineProperty(this, propMapName, {
+                        configurable: false,
+                        enumerable: false,
+                        writable: false,
+                        value: new Map()
+                    });
+                }
+                var myMap = this[propMapName];
+                if (Array.isArray(tags)) {
+                    for (var _b = 0, tags_3 = tags; _b < tags_3.length; _b++) {
+                        var tag = tags_3[_b];
+                        if (clearCacheTagsMap.has(tag)) {
+                            clearCacheTagsMap.get(tag).push(myMap);
+                        }
+                        else {
+                            clearCacheTagsMap.set(tag, [myMap]);
+                        }
+                    }
+                }
+                if (hashFunction || args.length > 0 || duration > 0) {
+                    var hashKey = void 0;
+                    if (hashFunction === true) {
+                        hashKey = args.map(function (a) { return a.toString(); }).join('!');
+                    }
+                    else if (hashFunction) {
+                        hashKey = hashFunction.apply(this, args);
+                    }
+                    else {
+                        hashKey = args[0];
+                    }
+                    var timestampKey = hashKey + "__timestamp";
+                    var isExpired = false;
+                    if (duration > 0) {
+                        if (!myMap.has(timestampKey)) {
+                            isExpired = true;
+                        }
+                        else {
+                            var timestamp = myMap.get(timestampKey);
+                            isExpired = (Date.now() - timestamp) > duration;
+                        }
+                    }
+                    if (myMap.has(hashKey) && !isExpired) {
+                        returnedValue = myMap.get(hashKey);
+                    }
+                    else {
+                        returnedValue = originalMethod.apply(this, args);
+                        myMap.set(hashKey, returnedValue);
+                        if (duration > 0) {
+                            myMap.set(timestampKey, Date.now());
+                        }
+                    }
+                }
+                else {
+                    var hashKey = this;
+                    if (myMap.has(hashKey)) {
+                        returnedValue = myMap.get(hashKey);
+                    }
+                    else {
+                        returnedValue = originalMethod.apply(this, args);
+                        myMap.set(hashKey, returnedValue);
+                    }
+                }
+            }
+            return returnedValue;
+        };
+    }
+});
+//# sourceMappingURL=memoize-decorator.js.map

package/dist/memoize-decorator.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@blumintinc/typescript-memoize",
+  "version": "1.2.0",
+  "description": "Memoize decorator for Typescript with deep equality",
+  "main": "./dist/memoize-decorator.js",
+  "module": "./dist/es2015/memoize-decorator.js",
+  "typings": "./dist/memoize-decorator.d.ts",
+  "scripts": {
+    "test": "karma start test/karma.config.js --single-run",
+    "prepublish": "npm run build && npm run build:es2015",
+    "clean": "rm -rf ./dist",
+    "build": "tsc",
+    "build:es2015": "tsc --module es2015 --target es2015 --outDir dist/es2015",
+    "tslint": "tslint --project .",
+    "eslint": "npm run tslint"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BluMintInc/typescript-memoize.git"
+  },
+  "keywords": [
+    "typescript",
+    "memoize",
+    "functional",
+    "decorator"
+  ],
+  "author": "Joseph O'Connor",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/BluMintInc/typescript-memoize/issues"
+  },
+  "homepage": "https://github.com/BluMintInc/typescript-memoize#readme",
+  "devDependencies": {
+    "@types/jasmine": "3.6.2",
+    "@types/node": "14.14.9",
+    "awesome-typescript-loader": "5.2.1",
+    "es6-shim": "0.35.6",
+    "jasmine-core": "3.6.0",
+    "karma": "6.3.16",
+    "karma-chrome-launcher": "3.1.0",
+    "karma-es6-shim": "1.0.0",
+    "karma-jasmine": "4.0.1",
+    "karma-jasmine-html-reporter": "1.5.4",
+    "karma-junit-reporter": "2.0.1",
+    "karma-sourcemap-loader": "0.3.8",
+    "karma-spec-reporter": "0.0.32",
+    "karma-threshold-reporter": "0.1.15",
+    "karma-typescript": "5.2.0",
+    "source-map-loader": "1.1.2",
+    "tslib": "2.0.3",
+    "tslint": "6.1.3",
+    "typescript": "4.1.2"
+  },
+  "dependencies": {
+    "fast-deep-equal": "^3.1.3"
+  }
+}

package/src/memoize-decorator.ts

@@ -0,0 +1,250 @@
+const equal = require('fast-deep-equal');
+
+interface MemoizeArgs {
+	expiring?: number;
+	hashFunction?: boolean | ((...args: any[]) => any);
+	tags?: string[];
+	useDeepEqual?: boolean;
+}
+
+export function Memoize(args?: MemoizeArgs | MemoizeArgs['hashFunction']) {
+	let hashFunction: MemoizeArgs['hashFunction'];
+	let duration: MemoizeArgs['expiring'];
+	let tags: MemoizeArgs['tags'];
+	let useDeepEqual: MemoizeArgs['useDeepEqual'] = true;
+
+	if (typeof args === 'object') {
+		hashFunction = args.hashFunction;
+		duration = args.expiring;
+		tags = args.tags;
+		useDeepEqual = args.useDeepEqual ?? true;
+	} else {
+		hashFunction = args;
+	}
+
+	return (target: Object, propertyKey: string, descriptor: TypedPropertyDescriptor<any>) => {
+		if (descriptor.value != null) {
+			descriptor.value = getNewFunction(descriptor.value, hashFunction, duration, tags, useDeepEqual);
+		} else if (descriptor.get != null) {
+			descriptor.get = getNewFunction(descriptor.get, hashFunction, duration, tags, useDeepEqual);
+		} else {
+			throw 'Only put a Memoize() decorator on a method or get accessor.';
+		}
+	};
+}
+
+export function MemoizeExpiring(expiring: number, hashFunction?: MemoizeArgs['hashFunction']) {
+	return Memoize({
+		expiring,
+		hashFunction
+	});
+}
+
+const clearCacheTagsMap: Map<string, Map<any, any>[]> = new Map();
+
+export function clear (tags: string[]): number {
+	const cleared: Set<Map<any, any>> = new Set();
+	for (const tag of tags) {
+		const maps = clearCacheTagsMap.get(tag);
+		if (maps) {
+			for (const mp of maps) {
+				if (!cleared.has(mp)) {
+					mp.clear();
+					cleared.add(mp);
+				}
+			}
+		}
+	}
+	return cleared.size;
+}
+
+// A wrapper around Map that uses deep equality for key comparison
+class DeepEqualMap<K, V> {
+	private map = new Map<string, { key: K, value: V }>();
+	
+	has(key: K): boolean {
+		const entries = Array.from(this.map.values());
+		for (const entry of entries) {
+			if (equal(entry.key, key)) {
+				return true;
+			}
+		}
+		return false;
+	}
+	
+	get(key: K): V | undefined {
+		const entries = Array.from(this.map.values());
+		for (const entry of entries) {
+			if (equal(entry.key, key)) {
+				return entry.value;
+			}
+		}
+		return undefined;
+	}
+	
+	set(key: K, value: V): this {
+		const entries = Array.from(this.map.entries());
+		for (const [serializedKey, entry] of entries) {
+			if (equal(entry.key, key)) {
+				this.map.delete(serializedKey);
+				break;
+			}
+		}
+		
+		const serializedKey = `${Date.now()}_${Math.random()}`;
+		this.map.set(serializedKey, { key, value });
+		return this;
+	}
+	
+	clear(): void {
+		this.map.clear();
+	}
+}
+
+function getNewFunction(
+	originalMethod: () => void, 
+	hashFunction?: MemoizeArgs['hashFunction'], 
+	duration: number = 0, 
+	tags?: MemoizeArgs['tags'],
+	useDeepEqual: boolean = true
+) {
+	const propMapName = Symbol(`__memoized_map__`);
+	const propDeepMapName = Symbol(`__memoized_deep_map__`);
+
+	// The function returned here gets called instead of originalMethod.
+	return function (...args: any[]) {
+		let returnedValue: any;
+
+		// Get or create appropriate map based on deep equality requirement
+		if (useDeepEqual) {
+			if (!this.hasOwnProperty(propDeepMapName)) {
+				Object.defineProperty(this, propDeepMapName, {
+					configurable: false,
+					enumerable: false,
+					writable: false,
+					value: new DeepEqualMap<any, any>()
+				});
+			}
+			let myMap: DeepEqualMap<any, any> = this[propDeepMapName];
+			
+			if (Array.isArray(tags)) {
+				for (const tag of tags) {
+					// Since DeepEqualMap doesn't match the Map interface exactly,
+					// we wrap it in a Map for tag clearing purposes
+					const mapWrapper = {
+						clear: () => myMap.clear()
+					} as any;
+					
+					if (clearCacheTagsMap.has(tag)) {
+						clearCacheTagsMap.get(tag).push(mapWrapper);
+					} else {
+						clearCacheTagsMap.set(tag, [mapWrapper]);
+					}
+				}
+			}
+			
+			let hashKey: any;
+			
+			// If true is passed as first parameter, will automatically use every argument
+			if (hashFunction === true) {
+				hashKey = args;
+			} else if (hashFunction) {
+				hashKey = hashFunction.apply(this, args);
+			} else if (args.length > 0) {
+				hashKey = args.length === 1 ? args[0] : args;
+			} else {
+				hashKey = this;
+			}
+			
+			// Handle expiration
+			const timestampKey = { __timestamp: true, key: hashKey };
+			let isExpired: boolean = false;
+			
+			if (duration > 0) {
+				if (!myMap.has(timestampKey)) {
+					isExpired = true;
+				} else {
+					let timestamp = myMap.get(timestampKey);
+					isExpired = (Date.now() - timestamp) > duration;
+				}
+			}
+			
+			if (myMap.has(hashKey) && !isExpired) {
+				returnedValue = myMap.get(hashKey);
+			} else {
+				returnedValue = originalMethod.apply(this, args);
+				myMap.set(hashKey, returnedValue);
+				if (duration > 0) {
+					myMap.set(timestampKey, Date.now());
+				}
+			}
+		} else {
+			// Original implementation with standard Map (shallow equality)
+			if (!this.hasOwnProperty(propMapName)) {
+				Object.defineProperty(this, propMapName, {
+					configurable: false,
+					enumerable: false,
+					writable: false,
+					value: new Map<any, any>()
+				});
+			}
+			let myMap: Map<any, any> = this[propMapName];
+
+			if (Array.isArray(tags)) {
+				for (const tag of tags) {
+					if (clearCacheTagsMap.has(tag)) {
+						clearCacheTagsMap.get(tag).push(myMap);
+					} else {
+						clearCacheTagsMap.set(tag, [myMap]);
+					}
+				}
+			}
+
+			if (hashFunction || args.length > 0 || duration > 0) {
+				let hashKey: any;
+
+				// If true is passed as first parameter, will automatically use every argument, passed to string
+				if (hashFunction === true) {
+					hashKey = args.map(a => a.toString()).join('!');
+				} else if (hashFunction) {
+					hashKey = hashFunction.apply(this, args);
+				} else {
+					hashKey = args[0];
+				}
+
+				const timestampKey = `${hashKey}__timestamp`;
+				let isExpired: boolean = false;
+				if (duration > 0) {
+					if (!myMap.has(timestampKey)) {
+						// "Expired" since it was never called before
+						isExpired = true;
+					} else {
+						let timestamp = myMap.get(timestampKey);
+						isExpired = (Date.now() - timestamp) > duration;
+					}
+				}
+
+				if (myMap.has(hashKey) && !isExpired) {
+					returnedValue = myMap.get(hashKey);
+				} else {
+					returnedValue = originalMethod.apply(this, args);
+					myMap.set(hashKey, returnedValue);
+					if (duration > 0) {
+						myMap.set(timestampKey, Date.now());
+					}
+				}
+
+			} else {
+				const hashKey = this;
+				if (myMap.has(hashKey)) {
+					returnedValue = myMap.get(hashKey);
+				} else {
+					returnedValue = originalMethod.apply(this, args);
+					myMap.set(hashKey, returnedValue);
+				}
+			}
+		}
+
+		return returnedValue;
+	};
+}