proxy-facades 1.0.0

package/dist/mjs/dev_generateEsRuntimeBehaviourCheckerCode.js

@@ -0,0 +1,76 @@
+"use strict";
+// ****  See the function common.ts#checkEsRuntimeBehaviour ***
+// Array:
+outputExpecterCode(["a"], (v) => v.at(0));
+outputExpecterCode(["a", "b", "c"], (v) => v.concat("d", "e", "f"));
+outputExpecterCode(["a", "b", "c"], (v) => v.map(x => read(x)));
+outputExpecterCode(["a", "b", "c"], (v) => v.forEach(x => read(x)));
+outputExpecterCode(["a", "b", "c"], (v) => v.join(","));
+//outputExpecterCode(["a", "b", "c"], (v) => v.keys());
+//outputExpecterCode(["a", "b", "c"], (v) => v.values());
+outputExpecterCode(["a", "b", "c", "d"], (v) => v.slice(1, 3));
+outputExpecterCode(["a", "b", "c"], (v) => v.some(x => x === "a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.filter(x => x === "a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.find(x => x === "a"));
+//outputExpecterCode(["a", "b", "c"], (v) => v.entries());
+outputExpecterCode(["a", "b", "c"], (v) => v.every(x => x === "a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.findIndex(x => x === "a"));
+outputExpecterCode(["a", "b", "c"], (v) => v.includes("b", 1));
+outputExpecterCode(["a", "b", "c"], (v) => v.indexOf("b", 1));
+outputExpecterCode(["a", "b", "c"], (v) => v[Symbol.iterator]().next());
+outputExpecterCode(["a", "b", "b"], (v) => v.lastIndexOf("b", 1));
+outputExpecterCode(["a", "b", "b"], (v) => v.reduce((p, c) => p + c));
+outputExpecterCode(["a", "b", "b"], (v) => v.reduceRight((p, c) => p + c));
+outputExpecterCode(["a", "b", "b"], (v) => v.toLocaleString());
+outputExpecterCode(["a", "b", "b"], (v) => v.toString());
+outputExpecterCode(["a", "b", "c"], (v) => v.unshift("_a", "_b"));
+outputExpecterCode(["a", "b", "c", "d"], v => v.splice(1, 2, "newB", "newC", "newX"));
+outputExpecterCode(["a", "b", "c", "d"], v => v.copyWithin(3, 1, 3));
+outputExpecterCode(["a", "b", "c", "d"], v => v.reverse());
+// Iterator
+console.log("if([].values().forEach) { // Runtime supports these iterator functions like forEach, filter, .... ");
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.forEach(x => x));
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.filter(x => x === "b"));
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.take(2));
+outputExpecterCode(() => ["a", "b", "c"][Symbol.iterator](), it => it.toArray());
+console.log("}");
+// Set:
+//outputExpecterCode(new Set<string>(["a","b","c"]), v => v.forEach(i => read(i))) // TypeError: Method Set.prototype.forEach called on incompatible receiver #<Set>
+//outputExpecterCode(new Set<string>(["a","b","c"]), v => v.intersection(new Set<string>(["b","c","e"]))) // TypeError: Method Set.prototype.intersection called on incompatible receiver #<Set>
+/**
+ *
+ */
+function outputExpecterCode(orig, fn) {
+    let origJS = JSON.stringify(orig);
+    if (typeof orig === "function") {
+        origJS = orig.toString().replace(/\s+/g, " ").replace(/^\(\)=>/, "").toString();
+        orig = orig();
+    }
+    const usedFields = new Set();
+    const proxy = new Proxy(orig, {
+        get(target, p, receiver) {
+            usedFields.add(p);
+            if (p === "next") {
+                //@ts-ignore
+                return (...args) => target.next(...args); // .next() method must run on target, not on proxy
+            }
+            //@ts-ignore
+            return target[p];
+        }
+    });
+    read(fn(proxy));
+    console.log(`expectUsingMethodsOrFields(${origJS}, ${fnToString(fn)}, [${[...usedFields.values()].map(f => typeof f === "string" ? `"${f}"` : `${f.toString().replace(/(^Symbol\()|(\)$)/g, "")}`).join(",")}])`);
+    function fnToString(fn) {
+        return fn.toString().replace(/\s+/g, " ").toString();
+    }
+}
+/**
+ * Just do something the runtime can't optimize away
+ * @param value
+ */
+function read(value) {
+    if (("" + value) == "blaaxyxzzzsdf") {
+        throw new Error("should never get here");
+    }
+}
+//# sourceMappingURL=dev_generateEsRuntimeBehaviourCheckerCode.js.map

package/dist/mjs/dev_generateEsRuntimeBehaviourCheckerCode.js.map

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

package/dist/mjs/index.d.ts

@@ -0,0 +1,8 @@
+export { RecordedRead, RecordedReadOnProxiedObject, ClassTrackingConfiguration, dualUseTracker_callOrigMethodOnTarget, IteratorReturningProxiedValue, GetIteratorValueProxiedFn, DualUseTracker, ForWatchedProxyHandler } from "./common";
+export { ProxyFacade, FacadeProxyHandler, invalidateObject, getGlobalOrig } from "./proxyFacade";
+export { deleteProperty, changeTrackedOrigObjects, installChangeTracker } from "./origChangeTracking";
+export { RecordedArrayValuesRead } from "./class-trackers/Array";
+export { RecordedMap_has, RecordedMap_get, RecordedMapEntriesRead, RecordedMapKeysRead, RecordedMapValuesRead } from "./class-trackers/Map";
+export { RecordedSet_has, RecordedSetValuesRead } from "./class-trackers/Set";
+export { RecordedValueRead, RecordedUnspecificRead, RecordedPropertyRead, RecordedOwnKeysRead, WatchedProxyFacade, WatchedProxyHandler } from "./watchedProxyFacade";
+//# sourceMappingURL=index.d.ts.map

package/dist/mjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,qCAAqC,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,cAAc,EAAE,sBAAsB,EAAC,MAAM,UAAU,CAAA;AACvO,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAC,cAAc,EAAE,wBAAwB,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAC,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAA;AACzI,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAC,iBAAiB,EAAE,sBAAsB,EAAE,oBAAoB,EAAC,mBAAmB,EAAE,kBAAkB,EAAG,mBAAmB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/mjs/index.js

@@ -0,0 +1,8 @@
+export { RecordedRead, RecordedReadOnProxiedObject, ClassTrackingConfiguration, dualUseTracker_callOrigMethodOnTarget } from "./common";
+export { ProxyFacade, FacadeProxyHandler, invalidateObject, getGlobalOrig } from "./proxyFacade";
+export { deleteProperty, changeTrackedOrigObjects, installChangeTracker } from "./origChangeTracking";
+export { RecordedArrayValuesRead } from "./class-trackers/Array";
+export { RecordedMap_has, RecordedMap_get, RecordedMapEntriesRead, RecordedMapKeysRead, RecordedMapValuesRead } from "./class-trackers/Map";
+export { RecordedSet_has, RecordedSetValuesRead } from "./class-trackers/Set";
+export { RecordedValueRead, RecordedUnspecificRead, RecordedPropertyRead, RecordedOwnKeysRead, WatchedProxyFacade, WatchedProxyHandler } from "./watchedProxyFacade";
+//# sourceMappingURL=index.js.map

package/dist/mjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,qCAAqC,EAAmG,MAAM,UAAU,CAAA;AACvO,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,eAAe,CAAC;AAC/F,OAAO,EAAC,cAAc,EAAE,wBAAwB,EAAE,oBAAoB,EAAC,MAAM,sBAAsB,CAAA;AACnG,OAAO,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAC,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAA;AACzI,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAC,iBAAiB,EAAE,sBAAsB,EAAE,oBAAoB,EAAC,mBAAmB,EAAE,kBAAkB,EAAG,mBAAmB,EAAC,MAAM,sBAAsB,CAAC"}

package/dist/mjs/objectChangeTracking.d.ts

@@ -0,0 +1,43 @@
+import { ClassTrackingConfiguration, EventHook, ObjKey } from "./common";
+/**
+ * Contains change listeners for one specific object.
+ * Note for specificity: There will be only one of the **change** events fired. The Recorded...Read.onChange handler will add the listeners to all possible candidates. It's this way around.
+ * Does not apply to setterInvoke.. These are fired in addition (not thought through for all situations)
+ */
+declare class ObjectChangeHooks {
+    /**
+     * For writes on **setters** (also if these are the same/unchanged values)
+     */
+    setterInvoke: import("./Util").DefaultMap<ObjKey, EventHook>;
+    changeSpecificProperty: import("./Util").DefaultMap<ObjKey, EventHook>;
+    changeAnyProperty: EventHook;
+    /**
+     * Means, the result of Object.keys will be different after the change. All iterations over the object/arrays's keys or values are informed that there was a change. Individual {@link changeSpecificProperty} are not affected!
+     */
+    changeOwnKeys: EventHook;
+    /**
+     * These will always be called, no matter how specific a change is
+     */
+    anyChange: EventHook;
+    /**
+     *
+     */
+    unspecificChange: EventHook;
+}
+export declare const changeHooksForObject: WeakMap<object, ObjectChangeHooks>;
+export declare function getChangeHooksForObject(obj: object): ObjectChangeHooks;
+export declare class ObjectProxyHandler implements ProxyHandler<object> {
+    target: object;
+    origPrototype: object | null;
+    proxy: object;
+    trackingConfig?: ClassTrackingConfiguration;
+    constructor(target: object, trackingConfig: ClassTrackingConfiguration | undefined);
+    installSetterTrap(key: ObjKey): void;
+    protected withUnspecificChange<R>(changeFn: () => R): R;
+    get(fake_target: object, key: ObjKey, receiver: any): any;
+    set(fake_target: object, key: ObjKey, value: any, receiver: any): boolean;
+    getPrototypeOf(target: object): object | null;
+    defineProperty(target: object, property: string | symbol, attributes: PropertyDescriptor): boolean;
+}
+export {};
+//# sourceMappingURL=objectChangeTracking.d.ts.map

package/dist/mjs/objectChangeTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectChangeTracking.d.ts","sourceRoot":"","sources":["../../objectChangeTracking.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,0BAA0B,EAC1B,SAAS,EAGT,MAAM,EAIT,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,cAAM,iBAAiB;IACnB;;OAEG;IACH,YAAY,iDAA4D;IACxE,sBAAsB,iDAA4D;IAClF,iBAAiB,YAAmB;IAEpC;;OAEG;IACH,aAAa,YAAmB;IAChC;;OAEG;IACH,SAAS,YAAmB;IAE5B;;OAEG;IACH,gBAAgB,YAAmB;CACtC;AAID,eAAO,MAAM,oBAAoB,oCAA2C,CAAC;AAC7E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,qBAMlD;AAED,qBAAa,kBAAmB,YAAW,YAAY,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,0BAA0B,CAAA;gBAE/B,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,0BAA0B,GAAG,SAAS;IAmBlF,iBAAiB,CAAC,GAAG,EAAE,MAAM;IAkE7B,SAAS,CAAC,oBAAoB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAIvD,GAAG,CAAC,WAAW,EAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAC,GAAG,GAAG,GAAG;IA2EvD,GAAG,CAAC,WAAW,EAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAC,GAAG,EAAE,QAAQ,EAAC,GAAG;IAkB5D,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI7C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,OAAO;CAIrG"}

package/dist/mjs/objectChangeTracking.js

@@ -0,0 +1,209 @@
+/**
+ * Listeners for one object
+ */
+import { newDefaultMap } from "./Util";
+import { EventHook, getPropertyDescriptor, runChangeOperation, UnspecificObjectChange, } from "./common";
+/**
+ * Contains change listeners for one specific object.
+ * Note for specificity: There will be only one of the **change** events fired. The Recorded...Read.onChange handler will add the listeners to all possible candidates. It's this way around.
+ * Does not apply to setterInvoke.. These are fired in addition (not thought through for all situations)
+ */
+class ObjectChangeHooks {
+    constructor() {
+        /**
+         * For writes on **setters** (also if these are the same/unchanged values)
+         */
+        this.setterInvoke = newDefaultMap(() => new EventHook());
+        this.changeSpecificProperty = newDefaultMap(() => new EventHook());
+        this.changeAnyProperty = new EventHook();
+        /**
+         * Means, the result of Object.keys will be different after the change. All iterations over the object/arrays's keys or values are informed that there was a change. Individual {@link changeSpecificProperty} are not affected!
+         */
+        this.changeOwnKeys = new EventHook();
+        /**
+         * These will always be called, no matter how specific a change is
+         */
+        this.anyChange = new EventHook();
+        /**
+         *
+         */
+        this.unspecificChange = new EventHook();
+    }
+}
+export const changeHooksForObject = new WeakMap();
+export function getChangeHooksForObject(obj) {
+    let result = changeHooksForObject.get(obj);
+    if (result === undefined) {
+        changeHooksForObject.set(obj, result = new ObjectChangeHooks());
+    }
+    return result;
+}
+export class ObjectProxyHandler {
+    constructor(target, trackingConfig) {
+        this.target = target;
+        this.trackingConfig = trackingConfig;
+        this.origPrototype = Object.getPrototypeOf(target);
+        Object.getOwnPropertyNames(target).forEach(key => {
+            if (key === "length" && Array.isArray(target)) {
+                return; // Leave the length property as is. It won't be set directly anyway
+            }
+            this.installSetterTrap(key);
+        });
+        // Create proxy:
+        //const targetForProxy = {}; // The virtual way
+        const targetForProxy = target; // Preserves Object.keys and instanceof behaviour :), iterators and other stuff. But the downside with this is, that it does not allow to proxy read only properties
+        this.proxy = new Proxy(targetForProxy, this);
+    }
+    installSetterTrap(key) {
+        let target = this.target;
+        let origDescriptor = getPropertyDescriptor(target, key);
+        //@ts-ignore
+        let currentValue = (origDescriptor === null || origDescriptor === void 0 ? void 0 : origDescriptor.value /* performance */) || target[key];
+        const origSetter = origDescriptor === null || origDescriptor === void 0 ? void 0 : origDescriptor.set;
+        const origGetter = origDescriptor === null || origDescriptor === void 0 ? void 0 : origDescriptor.get;
+        let origOwnDescriptor = Object.getOwnPropertyDescriptor(target, key);
+        if (origOwnDescriptor !== undefined) {
+            if (origOwnDescriptor.configurable !== true) {
+                throw new Error("Cannot delete non- 'configurable' property:" + String(key));
+            }
+            //@ts-ignore
+            delete target[key]; // delete the old, or the following Object.defineProperty will conflict
+        }
+        const newSetter = (newValue) => {
+            const changeHooksForTarget = getChangeHooksForObject(target);
+            if (origSetter !== undefined) {
+                runChangeOperation(target, new UnspecificObjectChange(target), [changeHooksForTarget.setterInvoke.get(key)], () => {
+                    origSetter.apply(target, [newValue]); // call the setter
+                });
+                return;
+            }
+            if (origGetter !== undefined) {
+                currentValue = origGetter.apply(target); // call the getter. Is this a good idea to refresh the value here?
+                throw new TypeError("Target originally had a getter and no setter but the property is set.");
+            }
+            //@ts-ignore
+            if (newValue !== currentValue) { // modify ?
+                // run change operation and call listeners:
+                const hooksToServe = [];
+                if (Array.isArray(target)) {
+                    hooksToServe.push(changeHooksForTarget.unspecificChange);
+                }
+                hooksToServe.push(changeHooksForTarget.changeSpecificProperty.get(key));
+                hooksToServe.push(changeHooksForTarget.changeAnyProperty);
+                runChangeOperation(target, new UnspecificObjectChange(target), hooksToServe, () => {
+                    //@ts-ignore
+                    currentValue = newValue;
+                });
+            }
+        };
+        newSetter.origHadSetter = origSetter !== undefined;
+        const newGetter = () => {
+            if (origGetter !== undefined) {
+                currentValue = origGetter.apply(target); // call the getter
+            }
+            return currentValue;
+        };
+        newGetter.origHadGetter = origGetter !== undefined;
+        Object.defineProperty(target, key, {
+            set: newSetter,
+            get: newGetter,
+            enumerable: origOwnDescriptor !== undefined ? origOwnDescriptor === null || origOwnDescriptor === void 0 ? void 0 : origOwnDescriptor.enumerable : true,
+            configurable: true, // Allow to delete the property. Note that you should use the {@link deleteProperty} function
+        });
+    }
+    withUnspecificChange(changeFn) {
+        return runChangeOperation(this.target, new UnspecificObjectChange(this.target), [getChangeHooksForObject(this.target).unspecificChange], changeFn);
+    }
+    get(fake_target, key, receiver) {
+        var _a, _b, _c;
+        // Validity check
+        const target = this.target;
+        if (receiver !== target) {
+            throw new Error("Invalid state. Get was called on a different object than this write-tracker-proxy (which is set as the prototype) is for. Did you clone the object, resulting in shared prototypes?");
+        }
+        // Check for and use change tracker class:
+        const changeTrackerClass = (_a = this.trackingConfig) === null || _a === void 0 ? void 0 : _a.changeTracker;
+        if (changeTrackerClass !== undefined) {
+            let propOnSupervisor = Object.getOwnPropertyDescriptor(changeTrackerClass.prototype, key);
+            if (propOnSupervisor !== undefined) { // Supervisor class is responsible for the property (or method) ?
+                //@ts-ignore
+                if (propOnSupervisor.get) { // Prop is a getter?
+                    return propOnSupervisor.get.apply(target);
+                }
+                else if (propOnSupervisor.value) { // Prop is a value, meaning a function. (Supervisors don't have fields)
+                    return changeTrackerClass.prototype[key];
+                }
+            }
+            else {
+                const origValue = changeTrackerClass.prototype[key];
+                if (typeof origValue === "function") {
+                    origMethod = origValue;
+                    if ((_b = this.trackingConfig) === null || _b === void 0 ? void 0 : _b.knownHighLevelMethods.has(key)) {
+                        return trapForHighLevelWriterMethod;
+                    }
+                    else if (!((_c = this.trackingConfig) === null || _c === void 0 ? void 0 : _c.readOnlyMethods.has(key)) && !(key in Object.prototype)) { // Read-write method that was not handled directly by change tracker class?
+                        return trapForGenericWriterMethod; // Assume the worst, that it is a writer method
+                    }
+                }
+            }
+        }
+        // return this.target[key]; // This line does not work because it does not consult ObjectProxyHandler#getPrototypeOf and therefore uses the actual tinkered prototype chain which has this proxy in there and calls get (endless recursion)
+        const propDesc = getPropertyDescriptor(target, key);
+        if (propDesc !== undefined) {
+            let result;
+            let getter = propDesc.get;
+            if (getter !== undefined) {
+                result = getter.apply(target);
+            }
+            else {
+                result = propDesc.value;
+            }
+            return result;
+        }
+        var origMethod = undefined;
+        /**
+          * Calls the unspecificChange listeners
+          * @param args
+          */
+        function trapForGenericWriterMethod(...args) {
+            if (this !== receiver) {
+                //throw new Error("Invalid state. Method was called on invalid target")
+            }
+            return runChangeOperation(target, new UnspecificObjectChange(target), [getChangeHooksForObject(target).unspecificChange], () => {
+                return origMethod.apply(this, args); // call original method
+            });
+        }
+        /**
+         * Wraps it in runAndCallListenersOnce_after
+         * @param args
+         */
+        function trapForHighLevelWriterMethod(...args) {
+            if (this !== receiver) {
+                //throw new Error("Invalid state. Method was called on invalid target")
+            }
+            return runChangeOperation(target, undefined, [], () => {
+                return origMethod.apply(this, args); // call original method
+            });
+        }
+    }
+    set(fake_target, key, value, receiver) {
+        // Validity check
+        if (receiver !== this.target) {
+            throw new Error("Invalid state. Set was called on a different object than this write-tracker-proxy (which is set as the prototype) is for. Did you clone the object, resulting in shared prototypes?");
+        }
+        runChangeOperation(this.target, new UnspecificObjectChange(this.target), [getChangeHooksForObject(this.target).changeOwnKeys], () => {
+            // if this "set" method got called, there is no setter trap installed yet
+            this.installSetterTrap(key);
+            //@ts-ignore
+            this.target[key] = value; // Set value again. this should call the setter trap
+        });
+        return true;
+    }
+    getPrototypeOf(target) {
+        return this.origPrototype;
+    }
+    defineProperty(target, property, attributes) {
+        throw new Error("Defineproperty not yet supported");
+    }
+}
+//# sourceMappingURL=objectChangeTracking.js.map

package/dist/mjs/objectChangeTracking.js.map

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

package/dist/mjs/origChangeTracking.d.ts

@@ -0,0 +1,14 @@
+import { PartialGraph } from "./common";
+export declare const changeTrackedOrigObjects: PartialGraph;
+/**
+ *
+ * @param obj
+ */
+export declare function installChangeTracker(obj: object): void;
+/**
+ * Use this to delete properties on objects that have a write tracker installed. Otherwise they are not deletable and the write tracker cannot track the object's keys modification and inform listeners
+ * @param obj
+ * @param key
+ */
+export declare function deleteProperty<O extends object>(obj: O, key: keyof O): boolean;
+//# sourceMappingURL=origChangeTracking.d.ts.map

package/dist/mjs/origChangeTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origChangeTracking.d.ts","sourceRoot":"","sources":["../../origChangeTracking.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAA6C,MAAM,UAAU,CAAC;AAUlF,eAAO,MAAM,wBAAwB,cAAqB,CAAC;AAI3D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,QA2B/C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,WAepE"}

package/dist/mjs/origChangeTracking.js

@@ -0,0 +1,58 @@
+// This file has functions / classes that allow to watch writes to the original unproxied objects (or arrays/sets/maps)
+// unproxied=not part of a proxy facade. Technically this can install Proxys as the prototype, to catch writes.
+import { PartialGraph, runChangeOperation, UnspecificObjectChange } from "./common";
+import { ObjectProxyHandler, getChangeHooksForObject } from "./objectChangeTracking";
+import { getTrackingConfigFor } from "./class-trackers/index";
+import { isProxyForAFacade } from "./proxyFacade";
+import { throwError } from "./Util";
+export const changeTrackedOrigObjects = new PartialGraph();
+/**
+ *
+ * @param obj
+ */
+export function installChangeTracker(obj) {
+    !isProxyForAFacade(obj) || throwError("Cannot install change tracker on a proxy. The proxy should already support change tracking.");
+    if (changeTrackedOrigObjects.hasObj(obj)) {
+        return;
+    }
+    function inner() {
+        const trackingConfig = getTrackingConfigFor(obj);
+        if (trackingConfig) {
+            if (trackingConfig.trackSettingObjectProperties) {
+                // Achieve this with the ObjectProxyhandler. It will consider getTrackingConfigFor(obj).changeTracker itsself:
+                const proxy = new ObjectProxyHandler(obj, trackingConfig).proxy;
+                Object.setPrototypeOf(obj, proxy);
+                return;
+            }
+            if (trackingConfig.changeTracker !== undefined) {
+                Object.setPrototypeOf(obj, trackingConfig.changeTracker.prototype);
+            }
+        }
+        else { // Non-special object ?
+            const proxy = new ObjectProxyHandler(obj, trackingConfig).proxy;
+            Object.setPrototypeOf(obj, proxy);
+        }
+    }
+    inner();
+    changeTrackedOrigObjects._register(obj);
+}
+/**
+ * Use this to delete properties on objects that have a write tracker installed. Otherwise they are not deletable and the write tracker cannot track the object's keys modification and inform listeners
+ * @param obj
+ * @param key
+ */
+export function deleteProperty(obj, key) {
+    if (!changeTrackedOrigObjects.hasObj(obj)) {
+        return delete obj[key];
+    }
+    const doesExist = Object.getOwnPropertyDescriptor(obj, key) !== undefined;
+    if (!doesExist) {
+        return true;
+    }
+    return runChangeOperation(obj, new UnspecificObjectChange(obj), [getChangeHooksForObject(obj).changeOwnKeys], () => {
+        //@ts-ignore
+        obj[key] = undefined; // Set to undefined first, so property change listeners will get informed
+        return delete obj[key];
+    });
+}
+//# sourceMappingURL=origChangeTracking.js.map

package/dist/mjs/origChangeTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origChangeTracking.js","sourceRoot":"","sources":["../../origChangeTracking.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,+GAA+G;AAG/G,OAAO,EAAC,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,UAAU,CAAC;AAClF,OAAO,EACH,kBAAkB,EAElB,uBAAuB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAC;AAElC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,YAAY,EAAE,CAAC;AAI3D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC5C,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,6FAA6F,CAAC,CAAC;IACrI,IAAG,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO;IACX,CAAC;IAED,SAAS,KAAK;QACV,MAAM,cAAc,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACjD,IAAI,cAAc,EAAE,CAAC;YACjB,IAAI,cAAc,CAAC,4BAA4B,EAAE,CAAC;gBAC9C,8GAA8G;gBAC9G,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC;gBAChE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAClC,OAAO;YACX,CAAC;YAED,IAAI,cAAc,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBAC7C,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACvE,CAAC;QACL,CAAC;aAAM,CAAC,CAAC,uBAAuB;YAC5B,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,KAAK,CAAC;YAChE,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IACD,KAAK,EAAE,CAAC;IAER,wBAAwB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAmB,GAAM,EAAE,GAAY;IACjE,IAAG,CAAC,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,SAAS,CAAC;IAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,kBAAkB,CAAC,GAAG,EAAE,IAAI,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE;QAC/G,YAAY;QACZ,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,yEAAyE;QAC/F,OAAO,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/mjs/proxyFacade.d.ts

@@ -0,0 +1,45 @@
+/**
+ *
+ */
+import { ObjKey, PartialGraph } from "./common";
+export declare abstract class ProxyFacade<HANDLER extends FacadeProxyHandler<any>> extends PartialGraph {
+    /**
+     * Treats them like functions, meaning, they get a proxied 'this'. WatchProxies will see the access to the real properties
+     */
+    propertyAccessorsAsWhiteBox: boolean;
+    protected objectsToProxyHandlers: WeakMap<object, HANDLER>;
+    protected abstract crateHandler(target: object, facade: any): HANDLER;
+    getProxyFor<O>(value: O): O;
+    /**
+     *
+     * @param value
+     * @return the original non-proxied value
+     */
+    getUnproxiedValue<O>(value: O): O;
+    getHandlerFor(obj: object): HANDLER;
+}
+export declare abstract class FacadeProxyHandler<FACADE extends ProxyFacade<any>> implements ProxyHandler<object> {
+    target: object;
+    proxy: object;
+    facade: FACADE;
+    constructor(target: object, facade: FACADE);
+    deleteProperty(target: object, key: string | symbol): boolean;
+    defineProperty(target: object, property: string | symbol, attributes: PropertyDescriptor): boolean;
+    get(fake_target: object, p: string | symbol, receiver: any): any;
+    protected rawRead(key: ObjKey): unknown;
+    set(fake_target: object, p: string | symbol, value: any, receiver: any): boolean;
+    protected rawChange(p: string | symbol, newUnproxiedValue: any): void;
+}
+export declare function isProxyForAFacade(obj: object): boolean;
+/**
+ * Makes the obj throw an error when trying to access it
+ * @param obj
+ * @param message
+ * @param cause
+ */
+export declare function invalidateObject(obj: object, message: string, cause?: Error): void;
+/**
+ * @returns the real real origial object from the real world
+ */
+export declare function getGlobalOrig<T extends object>(obj: T): T;
+//# sourceMappingURL=proxyFacade.d.ts.map

package/dist/mjs/proxyFacade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxyFacade.d.ts","sourceRoot":"","sources":["../../proxyFacade.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAIH,MAAM,EACN,YAAY,EAEf,MAAM,UAAU,CAAC;AAIlB,8BAAsB,WAAW,CAAC,OAAO,SAAS,kBAAkB,CAAC,GAAG,CAAC,CAAE,SAAQ,YAAY;IAE3F;;OAEG;IACI,2BAA2B,UAAQ;IAG1C,SAAS,CAAC,sBAAsB,2BAAkC;IAElE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO;IAErE,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAwB3B;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAQjC,aAAa,CAAC,GAAG,EAAE,MAAM,GAC4B,OAAO;CAG/D;AAED,8BAAsB,kBAAkB,CAAC,MAAM,SAAS,WAAW,CAAC,GAAG,CAAC,CAAE,YAAW,YAAY,CAAC,MAAM,CAAC;IACrG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAU1C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAK7D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,OAAO;IAIlG,GAAG,CAAE,WAAW,EAAC,MAAM,EAAE,CAAC,EAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAC,GAAG;IA+BxD,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,GAAG,CAAC,WAAW,EAAC,MAAM,EAAE,CAAC,EAAC,MAAM,GAAG,MAAM,EAAE,KAAK,EAAC,GAAG,EAAE,QAAQ,EAAC,GAAG;IAoBlE,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,iBAAiB,EAAE,GAAG;CAOjE;AAQD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,WAE5C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,QAoC3E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAMzD"}