proxy-facades 1.0.0

package/origChangeTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origChangeTracking.js","sourceRoot":"","sources":["origChangeTracking.ts"],"names":[],"mappings":";AAAA,uHAAuH;AACvH,+GAA+G;;;AAqB/G,oDA2BC;AAOD,wCAeC;AAnED,qCAAkF;AAClF,iEAIgC;AAChC,kDAA4D;AAC5D,+CAAgD;AAChD,iCAAkC;AAErB,QAAA,wBAAwB,GAAG,IAAI,qBAAY,EAAE,CAAC;AAI3D;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,GAAW;IAC5C,CAAC,IAAA,+BAAiB,EAAC,GAAG,CAAC,IAAI,IAAA,iBAAU,EAAC,6FAA6F,CAAC,CAAC;IACrI,IAAG,gCAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO;IACX,CAAC;IAED,SAAS,KAAK;QACV,MAAM,cAAc,GAAG,IAAA,4BAAoB,EAAC,GAAG,CAAC,CAAC;QACjD,IAAI,cAAc,EAAE,CAAC;YACjB,IAAI,cAAc,CAAC,4BAA4B,EAAE,CAAC;gBAC9C,8GAA8G;gBAC9G,MAAM,KAAK,GAAG,IAAI,yCAAkB,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,yCAAkB,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,gCAAwB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAmB,GAAM,EAAE,GAAY;IACjE,IAAG,CAAC,gCAAwB,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,IAAA,2BAAkB,EAAC,GAAG,EAAE,IAAI,+BAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,8CAAuB,EAAC,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/origChangeTracking.ts

@@ -0,0 +1,72 @@
+// 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,
+    changeHooksForObject,
+    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: object) {
+    !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<O extends object>(obj: O, key: keyof O) {
+    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];
+    });
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "proxy-facades",
+  "version": "1.0.0",
+  "description": "",
+  "keywords": [
+    "proxy",
+    "tracker",
+    "read-tracking",
+    "write-tracking"
+  ],
+  "author": "Boris Gingold <bogeee@bogitech.de>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bogeeee/proxy-facades.git"
+  },
+  "license": "MIT",
+  "main": "index.js",
+  "exports": {
+    ".": {
+      "import": "./index_esm.mjs",
+      "require": "./index.js"
+    },
+    "./develop": {
+      "browser": "./index.ts"
+    }
+  },
+  "scripts": {
+    "dev:playground.ts": "tsx devPlayground.ts",
+    "dev:generateEsRuntimeBehaviourCheckerCode": "tsx dev_generateEsRuntimeBehaviourCheckerCode.ts",
+    "clean": "tsc --build --clean && rimraf dist",
+    "build": "tsc --build --force && tsc -module ES6 --outDir dist/mjs",
+    "test": "npm run clean && vitest --clearScreen --hideSkippedTests --poolOptions.threads.singleThread",
+    "test_specific": "npm run clean && vitest --clearScreen --hideSkippedTests --poolOptions.threads.singleThread --testNamePattern \"add.*should behave normally. With writes through installed write tracker\"",
+    "prepublish": "npm run clean && npm run build",
+    "publish:npmlogin": "npm login",
+    "publish:publish": "npm run prepublish && npm publish"
+
+  },
+  "dependencies": {
+    "underscore": "^1.13.3",
+    "@types/underscore": "^1.11.4",
+    "@types/node": "^20.12.7"
+  },
+  "devDependencies": {
+    "tsx": "^4.7.0",
+    "@vitest/ui": "^1.5.1",
+    "rimraf": "=5.0.5",
+    "ncp": "=2.0.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.5.0"
+  }
+}

package/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/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"}

package/proxyFacade.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FacadeProxyHandler = exports.ProxyFacade = void 0;
+exports.isProxyForAFacade = isProxyForAFacade;
+exports.invalidateObject = invalidateObject;
+exports.getGlobalOrig = getGlobalOrig;
+/**
+ *
+ */
+const common_1 = require("./common");
+const origChangeTracking_1 = require("./origChangeTracking");
+class ProxyFacade extends common_1.PartialGraph {
+    constructor() {
+        super(...arguments);
+        // *** Configuration: ***
+        /**
+         * Treats them like functions, meaning, they get a proxied 'this'. WatchProxies will see the access to the real properties
+         */
+        this.propertyAccessorsAsWhiteBox = true;
+        // *** State: ***
+        this.objectsToProxyHandlers = new WeakMap();
+    }
+    getProxyFor(value) {
+        if (value === null || typeof value !== "object") { // not an object?
+            return value;
+        }
+        if (this.hasObj(value)) { // Already our proxied object ?
+            return value;
+        }
+        let handlerForObj = this.objectsToProxyHandlers.get(value);
+        if (handlerForObj !== undefined) { // value was an unproxied object and we have the proxy for it ?
+            return handlerForObj.proxy;
+        }
+        handlerForObj = this.crateHandler(value, this);
+        // register:
+        proxyToProxyHandler.set(handlerForObj.proxy, handlerForObj);
+        this.objectsToProxyHandlers.set(value, handlerForObj);
+        this._register(handlerForObj.proxy);
+        return handlerForObj.proxy;
+    }
+    /**
+     *
+     * @param value
+     * @return the original non-proxied value
+     */
+    getUnproxiedValue(value) {
+        var _a;
+        if (value === null || typeof value !== "object") { // not an object?
+            return value;
+        }
+        return ((_a = proxyToProxyHandler.get(value)) === null || _a === void 0 ? void 0 : _a.target) || value;
+    }
+    getHandlerFor(obj) {
+        return getProxyHandler(this.getProxyFor(obj));
+    }
+}
+exports.ProxyFacade = ProxyFacade;
+class FacadeProxyHandler {
+    constructor(target, facade) {
+        this.target = target;
+        this.facade = facade;
+        // 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);
+    }
+    deleteProperty(target, key) {
+        //@ts-ignore
+        return (0, origChangeTracking_1.deleteProperty)(this.target, key);
+    }
+    defineProperty(target, property, attributes) {
+        throw new Error("Must not use defineProperty on a proxied object. Handling of change tracking etc. for this may not be implemented");
+    }
+    get(fake_target, p, receiver) {
+        var _a;
+        // Validity check
+        if (receiver !== this.proxy) {
+            throw new Error("Invalid state. Get was called on a different object than this proxy  is for."); // Cannot imagine a legal case
+        }
+        const getter = (_a = (0, common_1.getPropertyDescriptor)(this.target, p)) === null || _a === void 0 ? void 0 : _a.get;
+        let value;
+        if (this.facade.propertyAccessorsAsWhiteBox && getter !== undefined && getter.origHadGetter !== false) { // Access via real property accessor ?
+            return value = getter.apply(this.proxy, []); // Call the accessor with a proxied this
+        }
+        else {
+            //@ts-ignore
+            value = this.rawRead(p);
+        }
+        if (value != null && typeof value === "object") {
+            const descriptor = Object.getOwnPropertyDescriptor(this.target, p);
+            // Handle read-only property:
+            if (descriptor !== undefined && descriptor.writable === false) {
+                // The js runtime would prevent us from returning a proxy :( Pretty mean :(
+                throw new Error("Cannot proxy a read-only property. This is not implemented."); // TODO: Implement the virtual way (see constructor)
+            }
+            return this.facade.getProxyFor(value);
+        }
+        return value;
+    }
+    rawRead(key) {
+        //@ts-ignore
+        return this.target[key];
+    }
+    set(fake_target, p, value, receiver) {
+        var _a;
+        // Validity check
+        if (receiver !== this.proxy) {
+            throw new Error("Invalid state. Set was called on a different object than this proxy  is for."); // Cannot imagine a legal case
+        }
+        const setter = (_a = (0, common_1.getPropertyDescriptor)(this.target, p)) === null || _a === void 0 ? void 0 : _a.set;
+        if (this.facade.propertyAccessorsAsWhiteBox && setter !== undefined && setter.origHadSetter !== false) { // Setting via real property accessor ?
+            setter.apply(this.proxy, [value]); // Only call the accessor with a proxied this
+        }
+        else {
+            const unproxiedValue = this.facade.getUnproxiedValue(value);
+            //@ts-ignore
+            if (this.target[p] !== unproxiedValue) { // modify ?
+                this.rawChange(p, unproxiedValue);
+            }
+        }
+        return true;
+    }
+    rawChange(p, newUnproxiedValue) {
+        //@ts-ignore
+        this.target[p] = newUnproxiedValue;
+    }
+}
+exports.FacadeProxyHandler = FacadeProxyHandler;
+const proxyToProxyHandler = new WeakMap();
+function getProxyHandler(proxy) {
+    return proxyToProxyHandler.get(proxy);
+}
+function isProxyForAFacade(obj) {
+    return proxyToProxyHandler.has(obj);
+}
+/**
+ * Makes the obj throw an error when trying to access it
+ * @param obj
+ * @param message
+ * @param cause
+ */
+function invalidateObject(obj, message, cause) {
+    const throwInvalid = () => {
+        throw new Error(message, { cause: cause });
+    };
+    // Delete all writeable  own props:
+    const descrs = Object.getOwnPropertyDescriptors(obj);
+    for (const k in descrs) {
+        const desc = descrs[k];
+        if (desc.configurable) {
+            //@ts-ignore
+            delete obj[k];
+        }
+    }
+    Object.setPrototypeOf(obj, new Proxy(obj, {
+        get(target, p, receiver) {
+            throwInvalid();
+        },
+        set(target, p, newValue, receiver) {
+            throwInvalid();
+            return false;
+        },
+        defineProperty(target, property, attributes) {
+            throwInvalid();
+            return false;
+        },
+        deleteProperty(target, p) {
+            throwInvalid();
+            return false;
+        },
+        ownKeys(target) {
+            throwInvalid();
+            return [];
+        }
+    }));
+}
+/**
+ * @returns the real real origial object from the real world
+ */
+function getGlobalOrig(obj) {
+    let handler;
+    while ((handler = proxyToProxyHandler.get(obj)) !== undefined) {
+        obj = handler.target;
+    }
+    return obj;
+}
+//# sourceMappingURL=proxyFacade.js.map

package/proxyFacade.js.map

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

package/proxyFacade.ts

@@ -0,0 +1,222 @@
+/**
+ *
+ */
+import {
+    getPropertyDescriptor,
+    GetterFlags,
+    objectMembershipInGraphs,
+    ObjKey,
+    PartialGraph,
+    SetterFlags
+} from "./common";
+import {deleteProperty} from "./origChangeTracking";
+
+
+export abstract class ProxyFacade<HANDLER extends FacadeProxyHandler<any>> extends PartialGraph {
+    // *** Configuration: ***
+    /**
+     * Treats them like functions, meaning, they get a proxied 'this'. WatchProxies will see the access to the real properties
+     */
+    public propertyAccessorsAsWhiteBox = true;
+
+    // *** State: ***
+    protected objectsToProxyHandlers = new WeakMap<object, HANDLER>();
+
+    protected abstract crateHandler(target: object, facade: any): HANDLER;
+
+    getProxyFor<O>(value: O): O {
+        if(value === null || typeof value !== "object") { // not an object?
+            return value;
+        }
+
+        if(this.hasObj(value)) { // Already our proxied object ?
+            return value;
+        }
+
+        let handlerForObj = this.objectsToProxyHandlers.get(value);
+        if(handlerForObj !== undefined) { // value was an unproxied object and we have the proxy for it ?
+            return handlerForObj.proxy as O;
+        }
+
+        handlerForObj = this.crateHandler(value, this);
+        // register:
+        proxyToProxyHandler.set(handlerForObj.proxy, handlerForObj);
+        this.objectsToProxyHandlers.set(value, handlerForObj);
+        this._register(handlerForObj.proxy);
+
+
+        return handlerForObj.proxy as O;
+    }
+
+    /**
+     *
+     * @param value
+     * @return the original non-proxied value
+     */
+    getUnproxiedValue<O>(value: O): O {
+        if(value === null || typeof value !== "object") { // not an object?
+            return value;
+        }
+
+        return proxyToProxyHandler.get(value)?.target as O|| value;
+    }
+
+    getHandlerFor(obj: object) {
+        return getProxyHandler(this.getProxyFor(obj)) as HANDLER;
+    }
+
+}
+
+export abstract class FacadeProxyHandler<FACADE extends ProxyFacade<any>> implements ProxyHandler<object> {
+    target: object;
+    proxy: object;
+    facade: FACADE;
+
+    constructor(target: object, facade: FACADE) {
+        this.target = target;
+        this.facade = facade;
+
+        // 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);
+    }
+
+    deleteProperty(target: object, key: string | symbol): boolean {
+        //@ts-ignore
+        return deleteProperty(this.target,key);
+    }
+
+    defineProperty(target: object, property: string | symbol, attributes: PropertyDescriptor): boolean {
+        throw new Error("Must not use defineProperty on a proxied object. Handling of change tracking etc. for this may not be implemented");
+    }
+
+    get (fake_target:object, p:string | symbol, receiver:any) {
+        // Validity check
+        if(receiver !== this.proxy) {
+            throw new Error("Invalid state. Get was called on a different object than this proxy  is for."); // Cannot imagine a legal case
+        }
+
+        const getter = getPropertyDescriptor(this.target, p)?.get;
+        let value;
+        if(this.facade.propertyAccessorsAsWhiteBox && getter !== undefined && (getter as GetterFlags).origHadGetter !== false) { // Access via real property accessor ?
+            return value = getter.apply(this.proxy,[]); // Call the accessor with a proxied this
+        }
+        else {
+            //@ts-ignore
+            value = this.rawRead(p);
+        }
+
+        if(value != null && typeof value === "object") {
+            const descriptor = Object.getOwnPropertyDescriptor(this.target, p);
+
+            // Handle read-only property:
+            if(descriptor !== undefined && descriptor.writable === false) {
+                // The js runtime would prevent us from returning a proxy :( Pretty mean :(
+                throw new Error("Cannot proxy a read-only property. This is not implemented."); // TODO: Implement the virtual way (see constructor)
+            }
+
+            return this.facade.getProxyFor(value);
+        }
+
+        return value;
+    }
+
+    protected rawRead(key: ObjKey): unknown {
+        //@ts-ignore
+        return this.target[key as any];
+    }
+
+    set(fake_target:object, p:string | symbol, value:any, receiver:any) {
+        // Validity check
+        if(receiver !== this.proxy) {
+            throw new Error("Invalid state. Set was called on a different object than this proxy  is for."); // Cannot imagine a legal case
+        }
+
+        const setter = getPropertyDescriptor(this.target, p)?.set;
+        if(this.facade.propertyAccessorsAsWhiteBox && setter !== undefined && (setter as SetterFlags).origHadSetter !== false) { // Setting via real property accessor ?
+            setter.apply(this.proxy,[value]); // Only call the accessor with a proxied this
+        }
+        else {
+            const unproxiedValue = this.facade.getUnproxiedValue(value);
+            //@ts-ignore
+            if (this.target[p] !== unproxiedValue) { // modify ?
+                this.rawChange(p, unproxiedValue);
+            }
+        }
+        return true
+    }
+
+    protected rawChange(p: string | symbol, newUnproxiedValue: any) {
+        //@ts-ignore
+        this.target[p] = newUnproxiedValue
+    }
+
+
+
+}
+
+
+const proxyToProxyHandler = new WeakMap<object, FacadeProxyHandler<any>>();
+function getProxyHandler(proxy: object) {
+    return proxyToProxyHandler.get(proxy);
+}
+
+export function isProxyForAFacade(obj: object) {
+    return proxyToProxyHandler.has(obj);
+}
+
+/**
+ * Makes the obj throw an error when trying to access it
+ * @param obj
+ * @param message
+ * @param cause
+ */
+export function invalidateObject(obj: object, message: string, cause?: Error) {
+    const throwInvalid = () => {
+        throw new Error(message, {cause: cause});
+    }
+
+    // Delete all writeable  own props:
+    const descrs = Object.getOwnPropertyDescriptors(obj);
+    for(const k in descrs) {
+        const desc = descrs[k];
+        if(desc.configurable) {
+            //@ts-ignore
+            delete obj[k];
+        }
+    }
+
+    Object.setPrototypeOf(obj, new Proxy(obj, {
+        get(target: object, p: string | symbol, receiver: any): any {
+            throwInvalid();
+        },
+        set(target: object, p: string | symbol, newValue: any, receiver: any): boolean {
+            throwInvalid()
+            return false;
+        },
+        defineProperty(target: object, property: string | symbol, attributes: PropertyDescriptor): boolean {
+            throwInvalid();
+            return false;
+        },
+        deleteProperty(target: object, p: string | symbol): boolean {
+            throwInvalid()
+            return false;
+        },
+        ownKeys(target: object): ArrayLike<string | symbol> {
+            throwInvalid()
+            return [];
+        }
+    }))
+}
+
+/**
+ * @returns the real real origial object from the real world
+ */
+export function getGlobalOrig<T extends object>(obj: T): T {
+    let handler: FacadeProxyHandler<any> | undefined
+    while((handler = proxyToProxyHandler.get(obj)) !== undefined) {
+        obj = handler.target as T;
+    }
+    return obj;
+}