@braidlabs/core 0.1.1

package/src/compat/realm-patches.js

@@ -0,0 +1,573 @@
+/* eslint-disable @typescript-eslint/no-unsafe-function-type --
+ * ported from the matrix-tested web-fragments fork: constructor and History-method interception
+ * operates on arbitrary native function shapes. */
+import { compatMetadataSymbol, setInternalReference, getInternalReference } from './metadata.js';
+import { execToInertScriptMap } from './script-execution.js';
+import { assert } from '../utils/assert.js';
+import { installDocumentFacade } from './document-facade.js';
+import { createDocumentOverrides } from './document-overrides.js';
+import { createFragmentBoundary } from './fragment-boundary.js';
+import { makeScriptBornInert } from './born-inert-scripts.js';
+import { navigationBus, ensureHostNavigationSources } from './navigation-bus.js';
+import { createRealmNavigator } from './service-worker.js';
+export function initializeRealmContext(realm, fragmentShadowRoot, braidDocumentElement, boundNavigation, fragmentAbortController) {
+    assert(realm.window !== null && realm.document !== null, 'attempted to patch the realm before it was ready');
+    const realmWindow = realm.window;
+    const realmDocument = realm.document;
+    const mainDocument = fragmentShadowRoot.host.ownerDocument;
+    const mainWindow = mainDocument.defaultView;
+    // cleanup event listeners attached to the window when the realm iframe gets destroyed.
+    // TODO: "pagehide" would be preferred over the discouraged "unload" event, but we'd need to
+    // figure out how to restore the previously attached listeners if the page resumes from bfcache
+    realmWindow.addEventListener('unload', () => fragmentAbortController.abort());
+    /**
+     * All main-realm interception is confined to the fragment boundary: nodes inside the
+     * fragment's DOM are stamped with per-fragment prototypes and a shadow-root-scoped
+     * MutationObserver acts as the activation safety net.
+     */
+    const fragmentBoundary = createFragmentBoundary({
+        realmDocument,
+        shadowRoot: fragmentShadowRoot,
+        braidDocumentElement,
+        abortSignal: fragmentAbortController.signal,
+    });
+    /** ---------------------------------------------- Window Patches ------------------------------------------------ */
+    /**
+     * START> WINDOW: GLOBAL CONSTRUCTORS PATCHES
+     */
+    const globalConstructors = Object.entries(Object.getOwnPropertyDescriptors(realmWindow)).flatMap(([property, descriptor]) => /^[A-Z]/.test(property) && typeof descriptor.value === 'function' ? descriptor.value : []);
+    function hasInstance(instance) {
+        const parentContextConstructor = mainWindow[this.name];
+        return (Function.prototype[Symbol.hasInstance].call(this, instance) ||
+            (typeof parentContextConstructor === 'function' && instance instanceof parentContextConstructor));
+    }
+    // extend global constructors to support instanceof checks using
+    // their equivalent constructor from the parent execution context
+    globalConstructors.forEach((constructor) => {
+        try {
+            Object.defineProperty(constructor, Symbol.hasInstance, {
+                value: hasInstance,
+            });
+        }
+        catch (e) {
+            console.warn(`Braid compat: failed to patch \`${constructor.name}[Symbol.hasInstance]\`\nA browser extension might be interfering with the browser APIs...\nSome application functionality may not work as expected!`, '\nError:', e, `\nDescriptor:`, Object.getOwnPropertyDescriptor(constructor, Symbol.hasInstance));
+        }
+    });
+    // END> WINDOW: GLOBAL CONSTRUCTORS PATCHES
+    /**
+     * START> WINDOW: MISC PATCHES
+     */
+    realmWindow.IntersectionObserver = mainWindow.IntersectionObserver;
+    realmWindow.MutationObserver = mainWindow.MutationObserver;
+    realmWindow.ResizeObserver = mainWindow.ResizeObserver;
+    // CSSStyleSheets don't work across documents, so we need to use the constructor from the main context
+    realmWindow.CSSStyleSheet = mainWindow.CSSStyleSheet;
+    realmWindow.matchMedia = mainWindow.matchMedia.bind(mainWindow); // needs to be bound to mainWindow otherwise operates on the realm window
+    // The realm's navigator is the host's, with one member contained: a service worker attaches to
+    // the whole origin and outlives the fragment, so a fragment must not be able to install one.
+    // See service-worker.ts — the realm isolates JavaScript, and a worker is not JavaScript state.
+    const realmNavigator = createRealmNavigator(mainWindow.navigator, realm.fragmentId);
+    // the navigator API is defined as an enumerable and configurable property with a getter and an undefined setter
+    Object.defineProperty(realmWindow, 'navigator', {
+        set: undefined,
+        get: () => realmNavigator,
+        configurable: true,
+        enumerable: true,
+    });
+    // dispatch events onto the shadowRoot if the event is not one of the special realm events
+    const originalDispatchEvent = realmWindow.dispatchEvent.bind(realmWindow);
+    realmWindow.dispatchEvent = function compatDispatchEvent(event) {
+        if (realmEvents.includes(event?.type)) {
+            return originalDispatchEvent(event);
+        }
+        else {
+            return fragmentShadowRoot.dispatchEvent(event);
+        }
+    };
+    const windowSizeProperties = ['innerHeight', 'innerWidth', 'outerHeight', 'outerWidth', 'visualViewport'];
+    for (const windowSizeProperty of windowSizeProperties) {
+        Object.defineProperty(realmWindow, windowSizeProperty, {
+            get: function compatWindowSizeGetter() {
+                return mainWindow[windowSizeProperty];
+            },
+        });
+    }
+    // END> WINDOW: MISC PATCHES
+    /**
+     * START> WINDOW: HISTORY PATCHES
+     */
+    // WARNING: Be sure this class stays declared inside of this function!
+    // We rely on each compat context having its own instance of this constructor
+    // so we can use an instanceof check to avoid double-handling the event inside
+    // the same context it was dispatched from.
+    class SyntheticPopStateEvent extends PopStateEvent {
+    }
+    /**
+     * True until the fragment's own scripts have finished running.
+     *
+     * A framework's router performs an initial navigation as it starts — resolving a default route,
+     * following a `redirectTo`, normalizing a trailing slash. That is the fragment settling into the
+     * route it was *given*, not the user navigating, and letting it reach the host's History API
+     * means a fragment can rewrite the host's URL the instant it mounts.
+     */
+    let booting = true;
+    /**
+     * Whether the user has acted inside this fragment.
+     *
+     * **Scripts having run is not the same as the router having settled**, and assuming it was is
+     * what let this bug survive its first fix. Angular resolves its initial route asynchronously —
+     * measured at ~170ms after mount, long after the last `<script>` returned — so a window that
+     * closed when boot finished was already open again by the time the redirect landed, and a
+     * fragment mounted on a page it does not own dragged the host to one of its own routes.
+     *
+     * No timing fix survives that honestly: the next router is slower than whatever delay we pick.
+     * So the gate is causal rather than temporal — a navigation the user did not ask for stays
+     * inside the realm, whenever it happens. The fragment still navigates itself; it just cannot
+     * move the address bar until someone touches it.
+     *
+     * The cost is deliberate: a bound fragment that redirects with no user input (an async auth
+     * check, say) now changes only its own location. That is the safer default of the two, and the
+     * host URL staying where the host put it is the property worth keeping.
+     */
+    let userHasActed = false;
+    // Capture phase, so a fragment that stops propagation on its own handlers cannot also suppress
+    // the signal that it is being used.
+    for (const eventName of ['pointerdown', 'keydown', 'touchstart']) {
+        braidDocumentElement.addEventListener(eventName, () => void (userHasActed = true), {
+            capture: true,
+            signal: fragmentAbortController.signal,
+        });
+    }
+    if (boundNavigation) {
+        setInternalReference(realmWindow, 'history');
+        const historyProxy = new Proxy(mainWindow.history, {
+            get(target, property, receiver) {
+                if (typeof Object.getOwnPropertyDescriptor(History.prototype, property)?.value === 'function') {
+                    return function (...args) {
+                        // During boot, a bound fragment's navigation is confined to its own realm: the host
+                        // keeps the URL it navigated to, and the fragment still gets the location it asked for.
+                        if ((booting || !userHasActed) && MUTATING_HISTORY_METHODS.has(property)) {
+                            return Reflect.apply(History.prototype.replaceState, getInternalReference(realmWindow, 'history'), [args[0], args[1] ?? '', args[2] ?? realmWindow.location.href]);
+                        }
+                        const applyNavigation = () => Reflect.apply(History.prototype[property], this === receiver ? target : this, args);
+                        // suppress the automatic host navigation sources while we apply the mutation, so
+                        // this fragment-initiated navigation isn't re-reported as a host navigation
+                        const result = navigationBus.withFragmentNavigation(applyNavigation);
+                        // dispatch a popstate event on the main window to inform listeners of a location change
+                        // (both the host application and the other fragments observe navigations this way)
+                        mainWindow.dispatchEvent(new SyntheticPopStateEvent('popstate'));
+                        return result;
+                    };
+                }
+                return Reflect.get(target, property, target);
+            },
+            set(target, property, receiver) {
+                return Reflect.set(target, property, receiver);
+            },
+        });
+        Object.defineProperties(realmWindow, {
+            history: {
+                get() {
+                    return historyProxy;
+                },
+            },
+        });
+    }
+    else {
+        const standaloneHistoryStack = [
+            { state: realmWindow.history.state, title: realmDocument.title, url: realmWindow.location.href },
+        ];
+        let standaloneHistoryCursor = 0;
+        // for standalone fragments we should always use replaceState instead of pushState so that we
+        // don't create unexpected history entries in the joint session history. In order for back()
+        // and forward() to work correctly, we implement our own history stack with behavior similar
+        // to window.history
+        Object.defineProperties(realmWindow.history, {
+            pushState: {
+                value: function compatStandalonePushState(state, title, url) {
+                    if (standaloneHistoryCursor !== standaloneHistoryStack.length - 1) {
+                        standaloneHistoryStack.splice(standaloneHistoryCursor + 1);
+                    }
+                    standaloneHistoryStack.push({ state, title, url: url ?? null });
+                    standaloneHistoryCursor++;
+                    realmWindow.history.replaceState(state, title, url);
+                },
+            },
+            /**
+             * Traverses the virtual stack and tells the fragment about it.
+             *
+             * The `popstate` is not decoration: a router only learns it has moved by hearing one, so
+             * without it `back()` changed the URL and left the application rendering the previous route.
+             */
+            go: {
+                value: function compatStandaloneGo(delta) {
+                    // Unpatched, this reached the real `go()` — which traverses the **joint** session
+                    // history and drags the top document with it. That is the whole hazard this branch
+                    // exists to avoid, and it was reachable by any router calling `go(-1)`.
+                    const steps = Math.trunc(delta ?? 0);
+                    if (steps === 0)
+                        return;
+                    const next = Math.min(Math.max(standaloneHistoryCursor + steps, 0), standaloneHistoryStack.length - 1);
+                    if (next === standaloneHistoryCursor)
+                        return;
+                    standaloneHistoryCursor = next;
+                    const { state, title, url } = standaloneHistoryStack[standaloneHistoryCursor];
+                    realmWindow.history.replaceState(state, title, url);
+                    realmWindow.dispatchEvent(new PopStateEvent('popstate', { state }));
+                },
+            },
+            back: {
+                value: function compatStandaloneBack() {
+                    realmWindow.history.go(-1);
+                },
+            },
+            forward: {
+                value: function compatStandaloneForward() {
+                    realmWindow.history.go(1);
+                },
+            },
+            length: {
+                get() {
+                    return standaloneHistoryStack.length;
+                },
+            },
+        });
+    }
+    if (boundNavigation) {
+        // When a navigation event occurs on the main window, either programmatically through the
+        // History API or by the back/forward button, we need to reflect those changes onto the
+        // realm's location via history.replaceState(), then dispatch a PopStateEvent so that
+        // fragments listening to popstate are made aware of the location change and retrigger
+        // their render updates.
+        const handleNavigate = (e) => {
+            getInternalReference(realmWindow, 'history').replaceState(window.history.state, '', window.location.href);
+            if (e instanceof SyntheticPopStateEvent) {
+                return;
+            }
+            realmWindow.dispatchEvent(new PopStateEvent('popstate', e instanceof PopStateEvent ? e : undefined));
+        };
+        // host-initiated pushState/replaceState calls are detected without patching the host's
+        // History API: via the onHostNavigation adapter and/or the Navigation API
+        const unsubscribe = navigationBus.subscribe(() => handleNavigate(new Event('braid:host-navigation')));
+        fragmentAbortController.signal.addEventListener('abort', unsubscribe);
+        ensureHostNavigationSources();
+        // Forward the popstate event triggered on the main window to every registered realm window.
+        // This covers native back/forward navigations as well as the synthetic popstate events
+        // dispatched by any fragment's history proxy.
+        window.addEventListener('popstate', handleNavigate, {
+            signal: fragmentAbortController.signal,
+        });
+    }
+    // END> WINDOW: HISTORY PATCHES
+    /** ---------------------------------------------- Document Patches ------------------------------------------------ */
+    /**
+     * START> DOCUMENT PATCHES
+     *
+     * The Document API surface is virtualized via a proxy facade spliced into the document's
+     * prototype chain. The virtualized member implementations live in document-overrides.ts, and
+     * every Document member's audit status is recorded in document-member-classification.ts.
+     *
+     * Note: native references (body, currentScript) must be captured before the facade is installed.
+     */
+    setInternalReference(realmDocument, 'body');
+    const getUnpatchedRealmDocumentCurrentScript = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Object.getPrototypeOf(realmDocument)), 'currentScript').get.bind(realmDocument);
+    installDocumentFacade(realmDocument, createDocumentOverrides({
+        realmDocument,
+        mainDocument,
+        braidDocumentElement,
+        fragmentShadowRoot,
+        boundNavigation,
+        getRealmDocumentReadyState: () => fragmentShadowRoot[compatMetadataSymbol].documentReadyState,
+        // grab the currently executing script in the realm, and map it to its clone in the main document
+        getCurrentScript: () => execToInertScriptMap.get(getUnpatchedRealmDocumentCurrentScript()),
+        boundary: {
+            stampNode: fragmentBoundary.stampNode,
+            makeScriptBornInert,
+        },
+    }));
+    // END> DOCUMENT PATCHES
+    /** ---------------------------------------------- Event System Patches ------------------------------------------------ */
+    /**
+     * START> EVENT SYSTEM PATCHES
+     */
+    // A list of events for which we don't want to retarget listeners as these events are dispatched in the realm.
+    const realmEvents = ['load', 'popstate', 'beforeunload', 'unload'];
+    // Maps realm EventTargets (window and document) to a target in the main context
+    const realmTargetToFragmentTarget = (target) => {
+        switch (target) {
+            case realmWindow:
+                return fragmentShadowRoot;
+            case realmDocument:
+                return braidDocumentElement;
+            default:
+                return target;
+        }
+    };
+    const mainTargetToRealmTarget = (target) => {
+        switch (target) {
+            case mainWindow:
+                return realmWindow;
+            case mainDocument:
+                return realmDocument;
+            case mainDocument.documentElement:
+                return realmDocument.documentElement;
+            case mainDocument.body:
+                return realmDocument.body;
+            default:
+                console.warn('Braid compat events: Unknown main context target: ', target);
+                return target;
+        }
+    };
+    const fragmentTargetToMainTarget = (target) => {
+        switch (target) {
+            case fragmentShadowRoot:
+                return mainWindow;
+            case braidDocumentElement:
+                return mainDocument;
+            case realmDocument.documentElement:
+                return mainDocument.documentElement;
+            case realmDocument.body:
+                return mainDocument.body;
+            default:
+                console.warn('Braid compat events: Unknown fragment context target: ', target);
+                return target;
+        }
+    };
+    // Weak map that maps app-provided listeners to listeners actually registered with the DOM.
+    // The main purpose of this map is to facilitate deregistration of event listeners
+    const appToCompatListenerMap = new WeakMap();
+    // Redirect event listeners (except for `realmEvents` defined above)
+    // from the realm window or document to the shadow root.
+    const compatAddEventListener = new Proxy(realmWindow.EventTarget.prototype.addEventListener, {
+        apply(originalAddEventListener, originalListenerTarget, argumentsList) {
+            const [eventName, appListenerOrObject, optionsOrCapture] = argumentsList;
+            // if the app didn't pass a listener, ignore the call
+            if (!appListenerOrObject)
+                return;
+            if (!originalListenerTarget) {
+                // addEventListener can be called unbound, in which case the target is the realm window
+                originalListenerTarget = realmWindow;
+            }
+            // if the event is a realm event, then skip everything and register the listener directly on the realm window
+            if (realmEvents.includes(eventName) && originalListenerTarget === realmWindow) {
+                originalAddEventListener.call(realmWindow, eventName, appListenerOrObject, optionsOrCapture);
+                return;
+            }
+            // normalize the options object
+            const options = typeof optionsOrCapture === 'boolean'
+                ? { capture: optionsOrCapture }
+                : typeof optionsOrCapture === 'object'
+                    ? optionsOrCapture ?? {}
+                    : {};
+            // browsers default to passive events for the following events
+            // https://dom.spec.whatwg.org/#default-passive-value
+            if (!('passive' in options) &&
+                (eventName === 'mousewheel' ||
+                    eventName === 'touchstart' ||
+                    eventName === 'touchmove' ||
+                    eventName === 'wheel') &&
+                (originalListenerTarget === realmWindow ||
+                    originalListenerTarget === realmDocument ||
+                    originalListenerTarget === realmDocument.documentElement ||
+                    originalListenerTarget === realmDocument.body)) {
+                options.passive = true;
+            }
+            // normalize appListener
+            const appListener = typeof appListenerOrObject === 'object' ? appListenerOrObject?.handleEvent : appListenerOrObject;
+            if (!appListener) {
+                // this is some kind of unknown listener, possibly feature detection for passive event
+                // support like the one performed by react
+                Reflect.apply(originalAddEventListener, originalListenerTarget, argumentsList);
+                return;
+            }
+            // reuse or create if needed a wrapper around the appListener that will patch the event to
+            // make it look like an event the app receives in standalone mode.
+            let { compatListener, mainProxyListener } = appToCompatListenerMap.get(appListener) ?? {};
+            if (!compatListener || !mainProxyListener) {
+                // create the compat listener
+                compatListener = function compatListener(event) {
+                    // capture properties of the original event
+                    const originalEventProps = {
+                        target: event.target,
+                        currentTarget: event.currentTarget,
+                        // TODO(perf): could we defer the composedPath() call until we actually need it
+                        composedPath: event.composedPath(),
+                    };
+                    // rewrite the composedPath by removing any references to the main or fragment objects
+                    let compatComposedPath = [...originalEventProps.composedPath];
+                    if (compatComposedPath.length === 1 && compatComposedPath[0] === fragmentShadowRoot) {
+                        compatComposedPath = [realmWindow];
+                    }
+                    else {
+                        compatComposedPath.splice(
+                        // remove braidDocumentElement and everything above it
+                        originalEventProps.composedPath.indexOf(braidDocumentElement), Infinity, 
+                        // and add the realmDocument and realmWindow to the list
+                        realmDocument, realmWindow);
+                    }
+                    // patch the event
+                    const originalEventPrototype = Object.getPrototypeOf(event);
+                    const eventPatch = Object.create(originalEventPrototype, {
+                        currentTarget: {
+                            get() {
+                                return originalListenerTarget;
+                            },
+                        },
+                        composedPath: {
+                            value: () => {
+                                return compatComposedPath;
+                            },
+                        },
+                        target: {
+                            get() {
+                                return originalEventProps.target === fragmentShadowRoot ? realmWindow : originalEventProps.target;
+                            },
+                        },
+                    });
+                    if (event instanceof UIEvent) {
+                        Object.defineProperty(eventPatch, 'view', {
+                            get() {
+                                return realmWindow;
+                            },
+                        });
+                    }
+                    // splice the patched event object into the prototype chain, this ensures that:
+                    // - the instanceof checks keep on working
+                    // - the isTrusted property is preserved
+                    // - the properties we need to patch get overshadowed in the prototypical lookup
+                    // - unpatching the event is as simple as re-splicing the prototype chain later
+                    Object.setPrototypeOf(event, eventPatch);
+                    try {
+                        appListener.call(originalListenerTarget, event);
+                    }
+                    finally {
+                        // unpatch the event
+                        Object.setPrototypeOf(event, originalEventPrototype);
+                    }
+                };
+                // create the proxy listener retargeting the events from the main context
+                mainProxyListener = function compatProxyListener(event) {
+                    if (event.target !== mainWindow &&
+                        event.target !== mainDocument &&
+                        event.target !== mainDocument.documentElement &&
+                        event.target !== mainDocument.body) {
+                        // if the event doesn't target any of the main top level EventTargets then we can ignore it —
+                        // it is either not relevant for us or it targets an element in the fragment DOM and
+                        // we'll handle it once it trickles down there
+                        return;
+                    }
+                    // capture properties of the original event
+                    const originalEventProps = {
+                        target: event.target,
+                        currentTarget: event.currentTarget,
+                    };
+                    // rewrite the composedPath by removing any references to the main or fragment objects
+                    const compatComposedPath = event.composedPath().map(mainTargetToRealmTarget);
+                    // patch the event
+                    const originalEventPrototype = Object.getPrototypeOf(event);
+                    const eventPatch = Object.create(originalEventPrototype, {
+                        currentTarget: {
+                            get() {
+                                return originalListenerTarget;
+                            },
+                        },
+                        target: {
+                            get() {
+                                return mainTargetToRealmTarget(originalEventProps.target);
+                            },
+                        },
+                        composedPath: {
+                            value: () => {
+                                return compatComposedPath;
+                            },
+                        },
+                    });
+                    if (event instanceof UIEvent) {
+                        Object.defineProperty(eventPatch, 'view', {
+                            get() {
+                                return realmWindow;
+                            },
+                        });
+                    }
+                    // splice the patched event object into the prototype chain (see compatListener above)
+                    Object.setPrototypeOf(event, eventPatch);
+                    try {
+                        appListener.call(originalListenerTarget, event);
+                    }
+                    finally {
+                        // unpatch the event
+                        Object.setPrototypeOf(event, originalEventPrototype);
+                    }
+                };
+                appToCompatListenerMap.set(appListener, {
+                    compatListener,
+                    mainProxyListener,
+                });
+            }
+            // determine the actual registration target within the fragment DOM tree
+            const compatListenerTarget = realmTargetToFragmentTarget(originalListenerTarget);
+            const modifiedArgumentsList = [eventName, compatListener, options];
+            Reflect.apply(originalAddEventListener, compatListenerTarget, modifiedArgumentsList);
+            if (eventName === 'DOMContentLoaded' || eventName === 'readystatechange') {
+                // DOMContentLoaded and readystatechange events are special in that they don't require
+                // shadow listeners — we dispatch them ourselves on the fragment document
+                return;
+            }
+            // and now let's register the shadow listener onto the main window
+            const mainProxyListenerTarget = fragmentTargetToMainTarget(compatListenerTarget);
+            // coalesce any provided signal with the one from our abort controller so that we can
+            // remove this listener when the fragment is destroyed
+            const mainProxyListenerAbortSignal = AbortSignal.any([fragmentAbortController.signal, options?.signal].filter((signal) => signal != null));
+            const mainProxyListenerOptions = {
+                ...options,
+                signal: mainProxyListenerAbortSignal,
+            };
+            // register the listener on the main window, document, <html>, or <body> target
+            mainProxyListenerTarget.addEventListener(eventName, mainProxyListener, mainProxyListenerOptions);
+        },
+    });
+    const compatRemoveEventListener = new Proxy(realmWindow.EventTarget.prototype.removeEventListener, {
+        apply(originalRemoveEventListener, originalListenerTarget, argumentsList) {
+            const [eventName, appListenerOrObject, optionsOrCapture] = argumentsList;
+            if (!appListenerOrObject)
+                return;
+            if (!originalListenerTarget) {
+                // removeEventListener can be called unbound, in which case the target is the realm window
+                originalListenerTarget = realmWindow;
+            }
+            // if the event is a realm event, then skip everything and remove the listener directly on the realm window
+            if (realmEvents.includes(eventName) && originalListenerTarget === realmWindow) {
+                originalRemoveEventListener.call(realmWindow, eventName, appListenerOrObject, optionsOrCapture);
+                return;
+            }
+            const appListener = typeof appListenerOrObject === 'object' ? appListenerOrObject?.handleEvent : appListenerOrObject;
+            if (!appListener) {
+                // this is some kind of unknown listener, possibly feature detection for passive event support
+                Reflect.apply(originalRemoveEventListener, originalListenerTarget, argumentsList);
+                return;
+            }
+            const compatListenerTarget = realmTargetToFragmentTarget(originalListenerTarget);
+            const compatListeners = appToCompatListenerMap.get(appListener);
+            if (!compatListeners) {
+                // we never added this listener, so it likely isn't registered, pass it through just in case
+                Reflect.apply(originalRemoveEventListener, originalListenerTarget, argumentsList);
+                return;
+            }
+            const { compatListener, mainProxyListener } = compatListeners;
+            const modifiedArgumentsList = [eventName, compatListener, optionsOrCapture];
+            Reflect.apply(originalRemoveEventListener, compatListenerTarget, modifiedArgumentsList);
+            mainWindow.removeEventListener(eventName, mainProxyListener, optionsOrCapture);
+        },
+    });
+    realmWindow.addEventListener = realmDocument.addEventListener = compatAddEventListener;
+    realmWindow.removeEventListener = realmDocument.removeEventListener = compatRemoveEventListener;
+    // END: EVENT SYSTEM PATCHES
+    return Object.assign(fragmentBoundary, {
+        bootComplete() {
+            booting = false;
+        },
+    });
+}
+/** History methods that move the user, as opposed to reading state. */
+const MUTATING_HISTORY_METHODS = new Set(['pushState', 'replaceState', 'back', 'forward', 'go']);
+//# sourceMappingURL=realm-patches.js.map

package/src/compat/realm-patches.js.map

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

package/src/compat/register-worker.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Registering Braid's service worker, from the shell.
+ *
+ * This is the shell's job rather than the runtime's, and that is a deliberate line. Braid is
+ * unopinionated about shells — prescribing one turns a library into a framework — so what ships here
+ * is the *wiring*, not the shell: one call, with the failure modes named.
+ *
+ * Note the asymmetry with everything else in this package. A fragment must **not** register a
+ * worker (compat realms refuse it, see `service-worker.ts`) because a fragment installing
+ * origin-wide persistent state outlives the fragment. The host may, because the origin is the
+ * host's.
+ */
+export interface RegisterBraidServiceWorkerOptions {
+    /** Where the gateway serves the script. Matches `serviceWorker: true` on the gateway. */
+    url?: string;
+    /**
+     * The scope to claim. Must be allowed by the script response's `Service-Worker-Allowed` header,
+     * which is exactly what the gateway sends.
+     */
+    scope?: string;
+    /**
+     * Tell the worker what build this page is, so it can report disagreement.
+     *
+     * Sent as a message rather than baked into the script URL: a URL that changes per build is a new
+     * worker every deploy, with a fresh install-and-wait lifecycle each time.
+     */
+    buildId?: string;
+    snapshotId?: string;
+    /** Called with the worker's answer, including any skew diagnosis. */
+    onVersion?: (report: unknown) => void;
+}
+/**
+ * Registers the worker and introduces the page to it.
+ *
+ * ```ts
+ * import { registerBraidServiceWorker } from '@braidlabs/core';
+ * await registerBraidServiceWorker({ buildId: BUILD_ID });
+ * ```
+ *
+ * Resolves to the registration, or `null` where service workers are unavailable — a non-secure
+ * origin, a browser without them, or SSR. That is a `null` rather than a throw because a worker is
+ * an enhancement: a page that works without one should not fail to start because it could not have
+ * one.
+ */
+export declare function registerBraidServiceWorker(options?: RegisterBraidServiceWorkerOptions): Promise<ServiceWorkerRegistration | null>;