@braidlabs/core 0.1.1

package/src/compat/register-worker.js

@@ -0,0 +1,57 @@
+import { BraidError } from '../errors.js';
+/**
+ * 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 async function registerBraidServiceWorker(options = {}) {
+    const container = globalThis.navigator
+        ?.serviceWorker;
+    if (!container)
+        return null;
+    const url = options.url ?? '/__braid/sw.js';
+    const scope = options.scope ?? '/';
+    let registration;
+    try {
+        registration = await container.register(url, { scope, type: 'module' });
+    }
+    catch (cause) {
+        // The overwhelmingly common cause is the scope: a script at /__braid/sw.js may only claim '/'
+        // if its response carried Service-Worker-Allowed, and a shell serving the script itself
+        // (rather than through the gateway) usually has not configured that.
+        throw new BraidError(`registering the Braid service worker at ${url} failed`, {
+            fragmentId: 'braid-sw',
+            stage: 'realm-boot',
+            cause,
+            fixHint: `the script response must send "Service-Worker-Allowed: ${scope}" — set serviceWorker: true ` +
+                'on the gateway, which is the component that can send it',
+        });
+    }
+    if (options.onVersion) {
+        const listener = (event) => {
+            const data = event.data;
+            if (data?.type === 'braid-sw:version')
+                options.onVersion?.(data);
+        };
+        container.addEventListener('message', listener);
+    }
+    // The controller is what receives messages; a first-load registration has none until it activates
+    // and takes over, so there is nobody to introduce the page to yet. The next navigation does it.
+    container.controller?.postMessage({
+        type: 'braid-sw:hello',
+        page: {
+            ...(options.buildId === undefined ? {} : { buildId: options.buildId }),
+            ...(options.snapshotId === undefined ? {} : { snapshotId: options.snapshotId }),
+        },
+    });
+    return registration;
+}
+//# sourceMappingURL=register-worker.js.map

package/src/compat/register-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-worker.js","sourceRoot":"","sources":["../../../../../libs/core/src/compat/register-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAmC1C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAA6C,EAAE;IAE/C,MAAM,SAAS,GAAI,UAAyE,CAAC,SAAS;QACpG,EAAE,aAAa,CAAC;IAClB,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IAEnC,IAAI,YAAuC,CAAC;IAC5C,IAAI,CAAC;QACH,YAAY,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,8FAA8F;QAC9F,wFAAwF;QACxF,qEAAqE;QACrE,MAAM,IAAI,UAAU,CAAC,2CAA2C,GAAG,SAAS,EAAE;YAC5E,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,YAAY;YACnB,KAAK;YACL,OAAO,EACL,0DAA0D,KAAK,8BAA8B;gBAC7F,yDAAyD;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAqC,CAAC;YACzD,IAAI,IAAI,EAAE,IAAI,KAAK,kBAAkB;gBAAE,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;QACnE,CAAC,CAAC;QACF,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAyB,CAAC,CAAC;IACnE,CAAC;IAED,kGAAkG;IAClG,gGAAgG;IAChG,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC;QAChC,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE;YACJ,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;SAChF;KACF,CAAC,CAAC;IAEH,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/src/compat/script-execution.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Script execution machinery for compat fragments: any script that enters a fragment's DOM is
+ * neutralized in the main document (an inert placeholder keeps the DOM shape the app expects)
+ * and executed in the fragment's realm instead.
+ */
+export declare function compatDomInsertion<T extends Node>(nodeToInsert: T, doInsertTheNode: Function, realmDocument?: Document): T;
+/**
+ * Handles a multi-node insertion (append, prepend, replaceChildren, replaceWith) into a fragment
+ * DOM.
+ *
+ * All scripts and preload links across all node arguments are neutralized first, then the actual
+ * insertion runs exactly once, and only then are the scripts restored and executed in the
+ * fragment's realm, in argument order. (Neutralizing/restoring per-node around a shared deferred
+ * insertion would restore earlier scripts to their live form before the insertion actually
+ * happens, causing them to execute in the main JS context.)
+ */
+export declare function compatMultiNodeDomInsertion(nodes: (Node | string)[], doInsertTheNodes: () => void, realmDocument?: Document): void;
+/**
+ * Activates the initial content of a fragment: patches braid-html/head/body stand-ins and
+ * executes every neutralized script/preload-link in document order in the fragment's realm.
+ *
+ * Used for both server-pierced content and content fetched client-side by the slot (which the
+ * compat adapter neutralizes before insertion).
+ */
+export declare function executeScriptsInFragmentContent(contentRoot: ParentNode, realmDocument: Document): void;
+/**
+ * Weak map of scripts running in the realm to their inert clones in the fragment DOM.
+ */
+export declare const execToInertScriptMap: WeakMap<HTMLScriptElement, HTMLScriptElement>;
+export declare const alreadyExecutedScriptsAndLinks: WeakSet<HTMLScriptElement | HTMLLinkElement>;
+/**
+ * Executes a script in the fragment's realm.
+ * @param inertScript inert script already appended to a document within the fragment DOM
+ * @param realmDocument realm document in which the script should execute
+ * @returns true if the script executed, false if it was ignored
+ */
+export declare function executeInertScript(inertScript: HTMLScriptElement, realmDocument: Document): boolean;
+export declare function executeInertPreloadLink(inertLink: HTMLLinkElement, realmDocument: Document): boolean;
+/**
+ * Attaches exec scripts to the realm and keeps a record of already evaluated scripts.
+ * @param inertScript inert script already appended to a document within the fragment DOM
+ * @param execScript exec script to be attached to the realm document
+ * @param realmDocument realm document in which the script should execute
+ */
+export declare function attachScriptToRealm({ inertScript, execScript, realmDocument, }: {
+    inertScript: HTMLScriptElement;
+    execScript?: HTMLScriptElement;
+    realmDocument: Document;
+}): void;
+/**
+ * Set the type attribute of a script element to "inert".
+ *
+ * This prevents the script from executing in the main JS context when the script is attached to
+ * the main document.
+ */
+export declare function setInertScriptType(script: HTMLScriptElement): void;
+/**
+ * Restore the original script type and erase any signs of us making the script inert.
+ */
+export declare function restoreScriptType(script: HTMLScriptElement): void;
+/**
+ * Neutralizes the original link, so that it doesn't result in a duplicate network call.
+ */
+export declare function setInertLinkRel(link: HTMLLinkElement): void;
+export declare function patchSpecialHtmlElement(node: Element, realmDocument: Document): void;

package/src/compat/script-execution.js

@@ -0,0 +1,361 @@
+/* eslint-disable @typescript-eslint/no-unsafe-function-type --
+ * ported from the matrix-tested web-fragments fork: the deferred-insertion callbacks are
+ * arbitrary pre-bound native method wrappers. */
+import { assert } from '../utils/assert.js';
+import { getInternalReference } from './metadata.js';
+/**
+ * Script execution machinery for compat fragments: any script that enters a fragment's DOM is
+ * neutralized in the main document (an inert placeholder keeps the DOM shape the app expects)
+ * and executed in the fragment's realm instead.
+ */
+export function compatDomInsertion(nodeToInsert, doInsertTheNode, realmDocument) {
+    // if we are operating outside of a fragment DOM or the appended child is neither an element nor
+    // a document fragment (which can carry scripts, e.g. cloned template contents), then just append
+    if (!realmDocument || !(nodeToInsert instanceof HTMLElement || nodeToInsert instanceof DocumentFragment)) {
+        return doInsertTheNode();
+    }
+    // if the child's prototype is directly HTMLElement, then check if this is a HTML/BODY/HEAD element and rewrite it
+    if (nodeToInsert instanceof HTMLElement && Object.getPrototypeOf(nodeToInsert) === HTMLElement.prototype) {
+        patchSpecialHtmlElement(nodeToInsert, realmDocument);
+    }
+    // if the child is a script, then append and execute it in the fragment's realm
+    if (nodeToInsert instanceof HTMLScriptElement) {
+        // if the child is an unattached inline script that doesn't yet have any text content, then we need to treat it in a special way
+        if (!nodeToInsert.src && !nodeToInsert.firstChild && !nodeToInsert.parentNode) {
+            prepareUnattachedInlineScript(nodeToInsert, realmDocument);
+            return doInsertTheNode();
+        }
+        setInertScriptType(nodeToInsert);
+        const returnVal = doInsertTheNode();
+        restoreScriptType(nodeToInsert);
+        executeInertScript(nodeToInsert, realmDocument);
+        return returnVal;
+    }
+    // if it's a preload or prefetch link for a script then append it to the realm and leave an inert node in the fragment DOM
+    if (nodeToInsert instanceof HTMLLinkElement &&
+        (nodeToInsert.rel === 'preload' || nodeToInsert.rel === 'prefetch' || nodeToInsert.rel === 'modulepreload')) {
+        setInertLinkRel(nodeToInsert);
+        const returnVal = doInsertTheNode();
+        executeInertPreloadLink(nodeToInsert, realmDocument);
+        return returnVal;
+    }
+    const nestedScriptsAndLinks = nodeToInsert.querySelectorAll?.('script,link[rel=preload],link[rel=prefetch],link[rel=modulepreload]');
+    // if the child doesn't contain nested scripts or links, then just append it
+    if (nestedScriptsAndLinks.length === 0) {
+        return doInsertTheNode();
+    }
+    // otherwise, append the child and execute all nested scripts in the fragment's realm
+    nestedScriptsAndLinks.forEach((element) => makeElementInert(element));
+    const returnVal = doInsertTheNode();
+    nestedScriptsAndLinks.forEach((element) => restoreElement(element));
+    nestedScriptsAndLinks.forEach((element) => executeElement(element, realmDocument));
+    return returnVal;
+}
+/**
+ * Handles a multi-node insertion (append, prepend, replaceChildren, replaceWith) into a fragment
+ * DOM.
+ *
+ * All scripts and preload links across all node arguments are neutralized first, then the actual
+ * insertion runs exactly once, and only then are the scripts restored and executed in the
+ * fragment's realm, in argument order. (Neutralizing/restoring per-node around a shared deferred
+ * insertion would restore earlier scripts to their live form before the insertion actually
+ * happens, causing them to execute in the main JS context.)
+ */
+export function compatMultiNodeDomInsertion(nodes, doInsertTheNodes, realmDocument) {
+    if (!realmDocument) {
+        return doInsertTheNodes();
+    }
+    const scriptsAndLinks = [];
+    for (const node of nodes) {
+        if (typeof node === 'string') {
+            console.warn('Braid compat: string arguments to append/prepend/replaceChildren/replaceWith are not supported and could result in incorrect script execution. Inserted string: ', node);
+            continue;
+        }
+        if (node instanceof HTMLElement && Object.getPrototypeOf(node) === HTMLElement.prototype) {
+            patchSpecialHtmlElement(node, realmDocument);
+        }
+        if (node instanceof HTMLScriptElement) {
+            if (!node.src && !node.firstChild && !node.parentNode) {
+                prepareUnattachedInlineScript(node, realmDocument);
+            }
+            else {
+                scriptsAndLinks.push(node);
+            }
+        }
+        else if (node instanceof HTMLLinkElement &&
+            (node.rel === 'preload' || node.rel === 'prefetch' || node.rel === 'modulepreload')) {
+            scriptsAndLinks.push(node);
+        }
+        else if (node.nodeType === Node.ELEMENT_NODE || node.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
+            const nested = node.querySelectorAll?.('script,link[rel=preload],link[rel=prefetch],link[rel=modulepreload]');
+            nested?.forEach((element) => scriptsAndLinks.push(element));
+        }
+    }
+    scriptsAndLinks.forEach((element) => makeElementInert(element));
+    doInsertTheNodes();
+    scriptsAndLinks.forEach((element) => restoreElement(element));
+    scriptsAndLinks.forEach((element) => executeElement(element, realmDocument));
+}
+function makeElementInert(element) {
+    if (element instanceof HTMLScriptElement) {
+        setInertScriptType(element);
+    }
+    else {
+        setInertLinkRel(element);
+    }
+}
+function restoreElement(element) {
+    if (element instanceof HTMLScriptElement) {
+        restoreScriptType(element);
+    }
+    else {
+        // don't restore links as we currently don't have another way of keeping them inert
+    }
+}
+function executeElement(element, realmDocument) {
+    if (element instanceof HTMLScriptElement) {
+        executeInertScript(element, realmDocument);
+    }
+    else {
+        executeInertPreloadLink(element, realmDocument);
+    }
+}
+/**
+ * Activates the initial content of a fragment: patches braid-html/head/body stand-ins and
+ * executes every neutralized script/preload-link in document order in the fragment's realm.
+ *
+ * Used for both server-pierced content and content fetched client-side by the slot (which the
+ * compat adapter neutralizes before insertion).
+ */
+export function executeScriptsInFragmentContent(contentRoot, realmDocument) {
+    // In addition to executing scripts, we also need to patch braid- tags if they are present so
+    // that the scripts see them without the prefix.
+    [...contentRoot.querySelectorAll('braid-html, braid-body, braid-head')].forEach((element) => patchSpecialHtmlElement(element, realmDocument));
+    const scriptsAndLinks = [
+        ...contentRoot.querySelectorAll('link[rel=inert-preload],link[rel=inert-prefetch],link[rel=inert-modulepreload],script'),
+    ];
+    scriptsAndLinks.forEach((inertElement) => {
+        if (inertElement instanceof HTMLLinkElement) {
+            executeInertPreloadLink(inertElement, realmDocument);
+        }
+        else {
+            restoreScriptType(inertElement);
+            executeInertScript(inertElement, realmDocument);
+        }
+    });
+}
+/**
+ * Weak map of scripts running in the realm to their inert clones in the fragment DOM.
+ */
+export const execToInertScriptMap = new WeakMap();
+export const alreadyExecutedScriptsAndLinks = new WeakSet();
+/**
+ * Executes a script in the fragment's realm.
+ * @param inertScript inert script already appended to a document within the fragment DOM
+ * @param realmDocument realm document in which the script should execute
+ * @returns true if the script executed, false if it was ignored
+ */
+export function executeInertScript(inertScript, realmDocument) {
+    // If the inert script has already been evaluated but later re-added to the DOM via any DOM
+    // insertion method (i.e. insertBefore() and appendChild()), do not evaluate the script again
+    if (alreadyExecutedScriptsAndLinks.has(inertScript)) {
+        return false;
+    }
+    // If the script does not have a valid type attribute, treat the script node as a data block.
+    // Data blocks live in the main document as-is.
+    const validScriptTypes = ['module', 'text/javascript', 'importmap', 'speculationrules', '', null];
+    if (!validScriptTypes.includes(inertScript.getAttribute('type'))) {
+        return false;
+    }
+    assert(!!(inertScript.src || inertScript.textContent), `Can't execute script without src or textContent!`);
+    attachScriptToRealm({ inertScript, realmDocument });
+    return true;
+}
+export function executeInertPreloadLink(inertLink, realmDocument) {
+    // If the inert link has already been evaluated but later re-added to the DOM via any DOM
+    // insertion method, do not evaluate the link again
+    if (alreadyExecutedScriptsAndLinks.has(inertLink)) {
+        return false;
+    }
+    // If the link does not have a valid href attribute then skip
+    if (!inertLink.href)
+        return false;
+    const execLink = realmDocument.importNode(inertLink, true);
+    restoreLinkRel(execLink);
+    // Grab the Event constructor from the realm
+    const Event = realmDocument.defaultView.Event;
+    // Redispatch the load event onto the inert link in the fragment DOM
+    execLink.addEventListener('load', () => {
+        inertLink.dispatchEvent(new Event('load', { cancelable: false }));
+    });
+    // Redispatch the error event onto the inert link in the fragment DOM
+    execLink.addEventListener('error', () => {
+        inertLink.dispatchEvent(new Event('error', { cancelable: false }));
+    });
+    getInternalReference(realmDocument, 'body').appendChild(execLink);
+    alreadyExecutedScriptsAndLinks.add(inertLink);
+    return true;
+}
+/**
+ * Attaches exec scripts to the realm and keeps a record of already evaluated scripts.
+ * @param inertScript inert script already appended to a document within the fragment DOM
+ * @param execScript exec script to be attached to the realm document
+ * @param realmDocument realm document in which the script should execute
+ */
+export function attachScriptToRealm({ inertScript, execScript, realmDocument, }) {
+    if (!execScript) {
+        // Build a FRESH script element rather than cloning: a script that descends from a parser
+        // document (DOMParser, fragment parsing) carries the spec's "already started" flag, and
+        // cloning preserves the flag — a clone would silently never execute.
+        //
+        // The fresh element must be created realm-side with the realm document's NATIVE
+        // createElement: the facade virtualizes `realmDocument.createElement` into the main
+        // document, and a script adopted across documents does not execute.
+        execScript = Document.prototype.createElement.call(realmDocument, 'script');
+        for (const attribute of inertScript.attributes) {
+            execScript.setAttribute(attribute.name, attribute.value);
+        }
+        execScript.textContent = inertScript.textContent;
+    }
+    // the following line will append the executable script to the realm
+    // - inline scripts (script with textContent) will be executed synchronously when attached
+    // - external scripts (with src attribute) will execute once the current turn of the event loop unwinds
+    execToInertScriptMap.set(execScript, inertScript);
+    // redispatch the load event onto the inert script in the fragment DOM
+    execScript.addEventListener('load', () => {
+        inertScript.dispatchEvent(new Event('load', { cancelable: false }));
+    });
+    // redispatch the error event onto the inert script in the fragment DOM
+    execScript.addEventListener('error', () => {
+        inertScript.dispatchEvent(new Event('error', { cancelable: false }));
+    });
+    getInternalReference(realmDocument, 'body').appendChild(execScript);
+    alreadyExecutedScriptsAndLinks.add(inertScript);
+}
+/**
+ * Set the type attribute of a script element to "inert".
+ *
+ * This prevents the script from executing in the main JS context when the script is attached to
+ * the main document.
+ */
+export function setInertScriptType(script) {
+    const scriptType = script.type;
+    if (scriptType) {
+        script.setAttribute('data-script-type', scriptType);
+    }
+    script.setAttribute('type', 'inert');
+}
+/**
+ * Restore the original script type and erase any signs of us making the script inert.
+ */
+export function restoreScriptType(script) {
+    const scriptType = script.getAttribute('data-script-type');
+    script.removeAttribute('data-script-type');
+    script.removeAttribute('type');
+    if (scriptType) {
+        script.setAttribute('type', scriptType);
+    }
+}
+/**
+ * Neutralizes the original link, so that it doesn't result in a duplicate network call.
+ */
+export function setInertLinkRel(link) {
+    const linkRel = link.rel;
+    if (linkRel) {
+        link.rel = 'inert-' + linkRel;
+    }
+}
+/**
+ * Reverses the `setInertLinkRel` operation.
+ */
+function restoreLinkRel(link) {
+    const linkRel = link.rel;
+    if (linkRel && linkRel.startsWith('inert-')) {
+        // strip the 'inert-' prefix
+        link.rel = linkRel.slice(6);
+    }
+}
+/**
+ * Inline scripts that do not have textContent set are not evaluated until the first time
+ * textContent is set.
+ *
+ * We prepare these scripts for future execution by:
+ * - appending a non-neutralized clone of the script to the realm document
+ * - neutralizing the original script so that it doesn't execute in the main JS context in the future
+ * - patching the script's appendChild method to also append to the clone which will execute the
+ *   script in the fragment's realm
+ *
+ * If text content is added later, the script then executes in the fragment's realm.
+ */
+function prepareUnattachedInlineScript(script, realmDocument) {
+    // We must clone the script before neutralizing it, otherwise the clone will also be neutralized
+    const execScript = realmDocument.importNode(script, true);
+    const inertScript = script;
+    // neutralize the script so that it doesn't execute in the main JS context
+    inertScript.textContent = '//inert';
+    document.body.appendChild(inertScript);
+    // now restore the inert script so the code using it doesn't see what we did
+    inertScript.remove();
+    inertScript.firstChild.remove();
+    // We have already cloned the inertScript so we don't need to clone it again.
+    // Cloning again would cause the execScript to be neutralized.
+    attachScriptToRealm({ inertScript, execScript, realmDocument });
+    const origScriptAppendChild = inertScript.appendChild;
+    inertScript.appendChild = function (node) {
+        origScriptAppendChild.call(inertScript, node);
+        execScript.appendChild.call(execScript, realmDocument.importNode(node, true));
+        // restore appendChild since only the first invocation should execute a script
+        inertScript.appendChild = origScriptAppendChild;
+        return node;
+    };
+}
+/**
+ * Rewrite the tagName for the special braid-* stand-in elements so fragment code sees plain
+ * HTML/HEAD/BODY, and map their sizing reads onto the host page's real elements.
+ */
+let lazyBraidCustomElements;
+function getBraidCustomElements() {
+    lazyBraidCustomElements ??= new Map([
+        ['BRAID-HTML', document.documentElement],
+        ['BRAID-HEAD', document.head],
+        ['BRAID-BODY', document.body],
+    ]);
+    return lazyBraidCustomElements;
+}
+export function patchSpecialHtmlElement(node, realmDocument) {
+    const originalTagName = node.tagName;
+    const mappedElement = getBraidCustomElements().get(originalTagName);
+    if (mappedElement) {
+        Object.defineProperties(node, {
+            clientWidth: {
+                get() {
+                    return mappedElement.clientWidth;
+                },
+            },
+            clientHeight: {
+                get() {
+                    return mappedElement.clientHeight;
+                },
+            },
+            nodeName: {
+                get() {
+                    return originalTagName.replace(/^BRAID-/i, '');
+                },
+            },
+            tagName: {
+                get() {
+                    return originalTagName.replace(/^BRAID-/i, '');
+                },
+            },
+        });
+        // if the node is BRAID-HEAD, we are done
+        if (node.tagName === 'HEAD') {
+            return;
+        }
+        // otherwise we need to patch addEventListener and removeEventListener to support retargeting
+        // to the main <html> and <body> elements
+        node.addEventListener = realmDocument.addEventListener;
+        node.removeEventListener = realmDocument.removeEventListener;
+    }
+}
+//# sourceMappingURL=script-execution.js.map

package/src/compat/script-execution.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * Service worker containment for compat realms.
+ *
+ * A realm's `navigator` is aliased to the host window's, so without this a fragment reaches the
+ * host page's real `ServiceWorkerContainer` — and `register()` installs a **persistent worker on
+ * the host's origin** that outlives the fragment's unmount, because `env.signal` teardown has
+ * nothing to unregister it with.
+ *
+ * The invariants had a hole here worth naming. Host purity says *Braid* never patches the host;
+ * nothing said anything about a *fragment* installing origin-wide persistent state. Realm isolation
+ * covers JavaScript, and a service worker is neither JavaScript state nor scoped to a realm — it is
+ * infrastructure attached to the origin.
+ *
+ * So registration is refused, loudly. A fragment that wants offline behavior should get it from the
+ * host's worker rather than installing a second one, and two workers racing for one scope is a
+ * debugging problem nobody should inherit by accident.
+ *
+ * The container stays *present* rather than being deleted: `'serviceWorker' in navigator` is how
+ * every app feature-detects, and answering false would make an app that genuinely needs a worker
+ * degrade in silence instead of saying so.
+ */
+export declare function createRealmNavigator(hostNavigator: Navigator, fragmentId: string): Navigator;

package/src/compat/service-worker.js

@@ -0,0 +1,104 @@
+import { BraidError } from '../errors.js';
+import { isDevMode } from '../config.js';
+/**
+ * Service worker containment for compat realms.
+ *
+ * A realm's `navigator` is aliased to the host window's, so without this a fragment reaches the
+ * host page's real `ServiceWorkerContainer` — and `register()` installs a **persistent worker on
+ * the host's origin** that outlives the fragment's unmount, because `env.signal` teardown has
+ * nothing to unregister it with.
+ *
+ * The invariants had a hole here worth naming. Host purity says *Braid* never patches the host;
+ * nothing said anything about a *fragment* installing origin-wide persistent state. Realm isolation
+ * covers JavaScript, and a service worker is neither JavaScript state nor scoped to a realm — it is
+ * infrastructure attached to the origin.
+ *
+ * So registration is refused, loudly. A fragment that wants offline behavior should get it from the
+ * host's worker rather than installing a second one, and two workers racing for one scope is a
+ * debugging problem nobody should inherit by accident.
+ *
+ * The container stays *present* rather than being deleted: `'serviceWorker' in navigator` is how
+ * every app feature-detects, and answering false would make an app that genuinely needs a worker
+ * degrade in silence instead of saying so.
+ */
+export function createRealmNavigator(hostNavigator, fragmentId) {
+    const container = createContainmentContainer(fragmentId);
+    return new Proxy(hostNavigator, {
+        get(target, property, receiver) {
+            if (property === 'serviceWorker')
+                return container;
+            const value = Reflect.get(target, property, target);
+            // Navigator members are natively bound to the real navigator; handing back an unbound
+            // function would make `navigator.sendBeacon(...)` throw an illegal-invocation error.
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+        // `navigator.serviceWorker = x` is silently ignored by the platform (the property has no
+        // setter); mirroring that is more predictable than throwing.
+        set(target, property, value, receiver) {
+            if (property === 'serviceWorker')
+                return true;
+            return Reflect.set(target, property, value, receiver);
+        },
+        has(target, property) {
+            return property === 'serviceWorker' || Reflect.has(target, property);
+        },
+    });
+}
+function createContainmentContainer(fragmentId) {
+    const refuse = (operation) => new BraidError(`a fragment may not ${operation} a service worker`, {
+        fragmentId,
+        stage: 'realm-boot',
+        fixHint: 'a service worker attaches to the whole origin, outlives this fragment, and is not scoped ' +
+            'by the realm — so the shell must own it. Register it from the host and let this fragment ' +
+            "share it, or drop the registration if the fragment's offline behavior is not needed here.",
+    });
+    const report = (operation) => {
+        if (isDevMode()) {
+            console.warn(`[braid:${fragmentId}] refused to ${operation} a service worker. Registration would install ` +
+                `origin-wide persistent state that survives this fragment's unmount; the shell owns the worker.`);
+        }
+    };
+    const target = new EventTarget();
+    const container = {
+        async register() {
+            report('register');
+            throw refuse('register');
+        },
+        /**
+         * Empty rather than the host's registrations.
+         *
+         * Reporting them would tell a fragment what else is installed on the origin — the host's
+         * infrastructure is not the fragment's business, and a fragment acting on a registration it
+         * did not create is a worse outcome than one that sees none.
+         */
+        async getRegistration() {
+            return undefined;
+        },
+        async getRegistrations() {
+            return [];
+        },
+        /**
+         * Rejected, which is a deliberate deviation: the spec leaves `ready` pending forever when there
+         * is no registration. A promise that never settles is indistinguishable from a hang, and in an
+         * emulation layer an honest error beats a spec-accurate silence.
+         */
+        get ready() {
+            report('await readiness of');
+            return Promise.reject(refuse('use'));
+        },
+        get controller() {
+            return null;
+        },
+        startMessages() {
+            // no worker, so no messages to start delivering
+        },
+        addEventListener: target.addEventListener.bind(target),
+        removeEventListener: target.removeEventListener.bind(target),
+        dispatchEvent: target.dispatchEvent.bind(target),
+        oncontrollerchange: null,
+        onmessage: null,
+        onmessageerror: null,
+    };
+    return container;
+}
+//# sourceMappingURL=service-worker.js.map

package/src/compat/service-worker.js.map

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