@braidlabs/core 0.1.1 → 0.3.0

package/src/weave/context-bridge.js.map

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

package/src/weave/contract.d.ts

@@ -0,0 +1,89 @@
+import type { VersionedSchema } from '@braidlabs/skew';
+/**
+ * Contract negotiation at connect time.
+ *
+ * Skew is the strongest thing Braid has, and it answers the *second* question about version
+ * disagreement: given a mismatch, what can be salvaged? This module asks the first one — should
+ * these two have been connected at all — and it exists because Braid could previously answer only
+ * by failing later, inside whichever interaction happened to touch the missing term.
+ *
+ * Three outcomes, and the third is the one only Braid can offer:
+ *
+ * 1. **compatible** — terms agree; open.
+ * 2. **incompatible** — refuse at mount, naming both versions and the failing term. Failing here is
+ *    strictly better than failing at first interaction: an empty slot with a fallback beats a
+ *    rendered UI that throws when someone clicks it.
+ * 3. **bridged** — the terms disagree but a registered Skew migration spans the gap. Open, and
+ *    report what will be derived or discarded. Detecting skew and reconciling it are not the same
+ *    capability, and this is where the difference shows up.
+ */
+export interface ContractProvisions {
+    events?: string[];
+    actions?: string[];
+}
+export interface ContractRequirements {
+    /** Range the fragment requires of the host's contract version. See `satisfiesRange`. */
+    host?: string;
+    /**
+     * Skew chain version per context key, not a semver range.
+     *
+     * Deliberately the same integers `contextVersions` already uses rather than a parallel
+     * string-range vocabulary: a second way to say "which shape of `cart` do you speak" would need
+     * its own mapping onto the migration chain, and the two would disagree the first time anyone
+     * edited one of them.
+     */
+    context?: Record<string, number>;
+}
+export interface FragmentContract {
+    version: string;
+    requires?: ContractRequirements;
+    provides?: ContractProvisions;
+}
+export interface HostContract {
+    version: string;
+    provides?: ContractProvisions;
+}
+/** One context key the fragment will receive at a version other than the published one. */
+export interface ContextBridge {
+    key: string;
+    /** The version the host publishes. */
+    from: number;
+    /** The version the fragment declared it speaks. */
+    to: number;
+    /** Fields the projection discards on the way down. Empty when the bridge is lossless. */
+    discards: string[];
+}
+export type NegotiationOutcome = 'compatible' | 'bridged' | 'incompatible';
+export interface Negotiation {
+    outcome: NegotiationOutcome;
+    bridges: ContextBridge[];
+    /** Set when incompatible: what disagreed, in terms a developer can act on. */
+    reason?: string;
+    fixHint?: string;
+}
+export interface NegotiateOptions {
+    host: HostContract | undefined;
+    fragment: FragmentContract | undefined;
+    /** Resolves a context key's registered schema. Injected — see `ContextBusLike`. */
+    schemaFor(key: string): VersionedSchema<unknown> | undefined;
+}
+/**
+ * Compares what a fragment requires against what the host offers.
+ *
+ * A fragment that declares no contract is compatible with everything, and must stay that way:
+ * compat mode's whole promise is that being composed requires no change to the app, and a
+ * negotiation that refused undeclared fragments would revoke it.
+ */
+export declare function negotiateContract(options: NegotiateOptions): Negotiation;
+/**
+ * A deliberately narrow subset of semver range syntax.
+ *
+ * `semver` is not a dependency of `@braidlabs/core` and should not become one — it is a browser
+ * runtime bundle, and the ranges that appear in a fragment manifest are the simple ones. The subset
+ * is documented, and anything outside it returns `'unparseable'` rather than a guess, so a range
+ * this build cannot read fails loudly at mount instead of quietly never being enforced.
+ *
+ * Supported: `*`, `1.x` / `1.*`, `1.2.3`, `>=`, `>`, `<=`, `<`, `^`, `~`.
+ * Not supported: hyphen ranges, `||` unions, pre-release precedence.
+ */
+export declare function satisfiesRange(version: string, range: string): boolean | 'unparseable';

package/src/weave/contract.js

@@ -0,0 +1,143 @@
+/**
+ * Compares what a fragment requires against what the host offers.
+ *
+ * A fragment that declares no contract is compatible with everything, and must stay that way:
+ * compat mode's whole promise is that being composed requires no change to the app, and a
+ * negotiation that refused undeclared fragments would revoke it.
+ */
+export function negotiateContract(options) {
+    const { host, fragment, schemaFor } = options;
+    if (!fragment)
+        return { outcome: 'compatible', bridges: [] };
+    const requiredHost = fragment.requires?.host;
+    if (requiredHost !== undefined) {
+        if (!host) {
+            return {
+                outcome: 'incompatible',
+                bridges: [],
+                reason: `the fragment requires a host contract matching "${requiredHost}", and this host declares none`,
+                fixHint: 'declare the host contract: initBraid({ contract: { version: "1.0.0" } })',
+            };
+        }
+        const satisfied = satisfiesRange(host.version, requiredHost);
+        if (satisfied === 'unparseable') {
+            // Refused rather than waved through. A range nobody can read is a requirement nobody is
+            // checking, and the failure mode of silently passing it is a fragment that mounts against a
+            // host it was never meant to run on.
+            return {
+                outcome: 'incompatible',
+                bridges: [],
+                reason: `the fragment requires host "${requiredHost}", which is not a range this build understands`,
+                fixHint: `use one of: "1.2.3", ">=1.2.3", ">1.2.3", "<=1.2.3", "<1.2.3", "^1.2.3", "~1.2.3", "1.x", "*"`,
+            };
+        }
+        if (!satisfied) {
+            return {
+                outcome: 'incompatible',
+                bridges: [],
+                reason: `the fragment requires host "${requiredHost}", and this host is "${host.version}"`,
+                fixHint: 'deploy a host that satisfies the range, or relax the fragment’s requires.host',
+            };
+        }
+    }
+    const bridges = [];
+    for (const [key, declared] of Object.entries(fragment.requires?.context ?? {})) {
+        const schema = schemaFor(key);
+        // No schema registered means no projection happens and none is needed — the value crosses as
+        // published, exactly as an untyped context always has.
+        if (!schema || declared === schema.version)
+            continue;
+        if (declared > schema.version) {
+            return {
+                outcome: 'incompatible',
+                bridges: [],
+                reason: `the fragment reads context "${key}" at v${declared}, and this host publishes v${schema.version}`,
+                fixHint: 'the fragment is newer than the host — deploy the host, or pin the fragment to a version it can produce',
+            };
+        }
+        const spanned = schema.steps.filter((step) => step.to > declared && step.to <= schema.version);
+        const missing = spanned.filter((step) => !step.down);
+        if (missing.length > 0) {
+            return {
+                outcome: 'incompatible',
+                bridges: [],
+                reason: `context "${key}" cannot be bridged from v${schema.version} down to v${declared}: ` +
+                    `${missing.map((step) => `v${step.to} (${step.description})`).join(', ')} ` +
+                    `${missing.length === 1 ? 'declares' : 'declare'} no down migration`,
+                fixHint: `add a down migration to the step that introduced v${missing[0]?.to}`,
+            };
+        }
+        bridges.push({
+            key,
+            from: schema.version,
+            to: declared,
+            // What the fragment will not see. Reported rather than merely permitted: a bridge that
+            // silently drops a field is how a fragment ends up rendering a confidently wrong screen.
+            discards: [...new Set(spanned.flatMap((step) => step.lossy ?? []))],
+        });
+    }
+    return { outcome: bridges.length > 0 ? 'bridged' : 'compatible', bridges };
+}
+/**
+ * A deliberately narrow subset of semver range syntax.
+ *
+ * `semver` is not a dependency of `@braidlabs/core` and should not become one — it is a browser
+ * runtime bundle, and the ranges that appear in a fragment manifest are the simple ones. The subset
+ * is documented, and anything outside it returns `'unparseable'` rather than a guess, so a range
+ * this build cannot read fails loudly at mount instead of quietly never being enforced.
+ *
+ * Supported: `*`, `1.x` / `1.*`, `1.2.3`, `>=`, `>`, `<=`, `<`, `^`, `~`.
+ * Not supported: hyphen ranges, `||` unions, pre-release precedence.
+ */
+export function satisfiesRange(version, range) {
+    const trimmed = range.trim();
+    if (trimmed === '*' || trimmed === '')
+        return true;
+    const target = parseVersion(version);
+    if (!target)
+        return 'unparseable';
+    const wildcard = /^(\d+)\.(x|\*)$/.exec(trimmed);
+    if (wildcard)
+        return target[0] === Number(wildcard[1]);
+    const operatorMatch = /^(>=|<=|>|<|\^|~)?\s*(\d+\.\d+\.\d+)$/.exec(trimmed);
+    if (!operatorMatch)
+        return 'unparseable';
+    const bound = parseVersion(operatorMatch[2]);
+    if (!bound)
+        return 'unparseable';
+    const order = compareVersions(target, bound);
+    switch (operatorMatch[1]) {
+        case undefined:
+            return order === 0;
+        case '>=':
+            return order >= 0;
+        case '>':
+            return order > 0;
+        case '<=':
+            return order <= 0;
+        case '<':
+            return order < 0;
+        case '^':
+            // Caret: same major, and not older. Major 0 is treated as every minor being breaking, which
+            // is the convention pre-1.0 packages actually rely on.
+            return order >= 0 && target[0] === bound[0] && (bound[0] !== 0 || target[1] === bound[1]);
+        case '~':
+            return order >= 0 && target[0] === bound[0] && target[1] === bound[1];
+        default:
+            return 'unparseable';
+    }
+}
+function parseVersion(value) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(value.trim());
+    if (!match)
+        return undefined;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function compareVersions(a, b) {
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] < b[i] ? -1 : 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=contract.js.map

package/src/weave/contract.js.map

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

package/src/weave/envelope.d.ts

@@ -0,0 +1,80 @@
+/**
+ * The Weave envelope — the unit that crosses a fragment boundary.
+ *
+ * Braid already had a *bus*: `braidContext` publishes with structured cloning, per-subscriber
+ * Skew projection and subscriber isolation. What it did not have was a **wire**. A fragment
+ * reached the bus because the host built `env.context` as closures over `braidContext` and handed
+ * that object into the realm — a synchronous cross-realm call on a shared object graph. That works
+ * for a same-origin realm and for nothing else: a closure cannot be handed to another origin, which
+ * is the real reason the untrusted tier throws rather than degrades.
+ *
+ * This module is the addressing layer that was missing underneath. The bus's semantics are
+ * unchanged and are not re-implemented here — they remain the specification this format serves.
+ */
+/**
+ * Version of the Weave envelope format.
+ *
+ * Deliberately distinct from `BRAID_PROTOCOL_VERSION`, which versions the *client ↔ gateway*
+ * composition protocol. The two move for unrelated reasons: a change to how the gateway namespaces
+ * fragment assets has nothing to do with how a mounted fragment talks to its host, and a single
+ * number covering both would force one side to break for the other's benefit.
+ */
+export declare const WEAVE_VERSION = 1;
+/** A failure delivered as a reply, rather than thrown into a realm that cannot catch it. */
+export interface WeaveErrorPayload {
+    message: string;
+    /** Mirrors `BraidErrorStage` where the failure had one; absent for transport-level faults. */
+    stage?: string;
+    fixHint?: string;
+}
+export interface Envelope {
+    v: typeof WEAVE_VERSION;
+    /** Unique per message. Correlates a reply to its request; also useful in a trace. */
+    id: string;
+    /**
+     * Set only on a reply, to the `id` being answered.
+     *
+     * A reply is not a message type — it is any message answering another. Keeping that in a field
+     * rather than in `type` means a handler for `ctx/get` never has to know whether the value it
+     * returns will be delivered as a reply or dropped; the channel decides from `reply` below.
+     */
+    re?: string;
+    /** Set on a request to mean "a reply to this id is expected". */
+    reply?: true;
+    type: string;
+    fragmentId: string;
+    /**
+     * Document-instance id: unique to one boot of one fragment, surviving nothing — not a reload,
+     * not a re-mount of the same fragment into the same slot.
+     *
+     * Cheap to carry now and expensive to add later, because it is the only thing that distinguishes
+     * "the fragment reloaded" from "this is a different fragment". Liveness (Phase 2) needs it to
+     * avoid crediting a dead instance's beats to its replacement, and negotiated teardown (Phase 3)
+     * needs it to avoid ACKing a close on behalf of an instance that never received it.
+     */
+    instance: string;
+    /**
+     * Which bus this addresses. `undefined` means the host bus — which is every message today.
+     *
+     * Reserved, unused, and deliberately not removed: the fragment-local bus is planned last, and
+     * without this field a context message addresses a *key* but not a *bus*. Introducing a second
+     * bus later would then mean either bumping `WEAVE_VERSION` or smuggling the scope into the key
+     * string, and both are worse than one optional field nothing currently sets.
+     */
+    scope?: string;
+    payload?: unknown;
+    /** Set on a reply that failed. Mutually exclusive with a meaningful `payload`. */
+    error?: WeaveErrorPayload;
+}
+/**
+ * Identity generator for message and instance ids.
+ *
+ * `crypto.randomUUID` is required to be present in a secure context and is available in every
+ * environment Braid targets, but it is absent over plain http on a LAN address — a configuration
+ * developers hit constantly when testing on a phone — so the fallback exists to keep the dev loop
+ * working rather than to be cryptographically interesting. Ids here are correlation handles, never
+ * capabilities: nothing is authorized by holding one.
+ */
+export declare function weaveId(): string;
+/** Narrows an unknown message — anything can arrive on a port — to a well-formed envelope. */
+export declare function isEnvelope(value: unknown): value is Envelope;

package/src/weave/envelope.js

@@ -0,0 +1,49 @@
+/**
+ * The Weave envelope — the unit that crosses a fragment boundary.
+ *
+ * Braid already had a *bus*: `braidContext` publishes with structured cloning, per-subscriber
+ * Skew projection and subscriber isolation. What it did not have was a **wire**. A fragment
+ * reached the bus because the host built `env.context` as closures over `braidContext` and handed
+ * that object into the realm — a synchronous cross-realm call on a shared object graph. That works
+ * for a same-origin realm and for nothing else: a closure cannot be handed to another origin, which
+ * is the real reason the untrusted tier throws rather than degrades.
+ *
+ * This module is the addressing layer that was missing underneath. The bus's semantics are
+ * unchanged and are not re-implemented here — they remain the specification this format serves.
+ */
+/**
+ * Version of the Weave envelope format.
+ *
+ * Deliberately distinct from `BRAID_PROTOCOL_VERSION`, which versions the *client ↔ gateway*
+ * composition protocol. The two move for unrelated reasons: a change to how the gateway namespaces
+ * fragment assets has nothing to do with how a mounted fragment talks to its host, and a single
+ * number covering both would force one side to break for the other's benefit.
+ */
+export const WEAVE_VERSION = 1;
+/**
+ * Identity generator for message and instance ids.
+ *
+ * `crypto.randomUUID` is required to be present in a secure context and is available in every
+ * environment Braid targets, but it is absent over plain http on a LAN address — a configuration
+ * developers hit constantly when testing on a phone — so the fallback exists to keep the dev loop
+ * working rather than to be cryptographically interesting. Ids here are correlation handles, never
+ * capabilities: nothing is authorized by holding one.
+ */
+export function weaveId() {
+    const cryptoApi = globalThis.crypto;
+    if (cryptoApi && typeof cryptoApi.randomUUID === 'function')
+        return cryptoApi.randomUUID();
+    return `w-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/** Narrows an unknown message — anything can arrive on a port — to a well-formed envelope. */
+export function isEnvelope(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (candidate.v === WEAVE_VERSION &&
+        typeof candidate.id === 'string' &&
+        typeof candidate.type === 'string' &&
+        typeof candidate.fragmentId === 'string' &&
+        typeof candidate.instance === 'string');
+}
+//# sourceMappingURL=envelope.js.map

package/src/weave/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../../../libs/core/src/weave/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAkD/B;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO;IACrB,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC,UAAU,EAAE,CAAC;IAC3F,OAAO,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAA0B,CAAC;IAC7C,OAAO,CACL,SAAS,CAAC,CAAC,KAAK,aAAa;QAC7B,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ;QAChC,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,OAAO,SAAS,CAAC,UAAU,KAAK,QAAQ;QACxC,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,CACvC,CAAC;AACJ,CAAC"}

package/src/weave/guest.d.ts

@@ -0,0 +1,59 @@
+import { BoundaryChannel } from './channel.js';
+import { ClosingCoordinator } from './closing.js';
+import { FragmentContract } from './contract.js';
+/**
+ * The guest half of the untrusted tier: what a cross-origin fragment runs to join a host page.
+ *
+ * ```ts
+ * const session = await connectToBraidHost({ hostOrigin: 'https://portal.example.com' });
+ * session.context.subscribe('user', renderUser);
+ * session.onClosing(() => flushOutbox());
+ * ```
+ *
+ * Note what a session **does not** have, compared with `FragmentEnv`: no `root`, no `document`, no
+ * `location`, no `history`. A cross-origin fragment already owns all four — it is a whole document
+ * with its own URL — and handing it host-shaped substitutes would be re-creating exactly the
+ * illusion this tier exists to refuse. What crosses is state and lifecycle, nothing more.
+ *
+ * This is intentionally small. The framework adapters that make it ergonomic are Phase 7's job; this
+ * is the primitive they will be written against, shipped now because the untrusted tier is not
+ * testable without a guest and a tier with no guest is a tier nobody can use.
+ */
+export interface GuestSession {
+    readonly channel: BoundaryChannel;
+    readonly context: {
+        get(key: string): unknown;
+        subscribe(key: string, listener: (value: unknown) => void, options?: {
+            signal?: AbortSignal;
+        }): () => void;
+    };
+    readonly props: Readonly<Record<string, unknown>>;
+    onPropsChanged(listener: (props: Readonly<Record<string, unknown>>) => void): () => void;
+    /** Fragment → host. Surfaced on the slot element as `braid:event`. */
+    emit(type: string, detail?: unknown): void;
+    onClosing: ClosingCoordinator['onClosing'];
+    setDirty: ClosingCoordinator['setDirty'];
+    /** Aborts when the host closes the session. */
+    readonly signal: AbortSignal;
+    disconnect(): void;
+}
+export interface ConnectOptions {
+    /**
+     * The exact origin of the host page this fragment agrees to be embedded by.
+     *
+     * Required, and deliberately not defaulted to "whoever framed me". A fragment that accepted a
+     * channel from any parent could be framed by an attacker's page, handed a plausible-looking
+     * context, and induced to render a user's data inside a document that can screenshot it. The
+     * fragment decides who may embed it, and this is where it says so.
+     */
+    hostOrigin: string;
+    /** Skew chain versions this fragment can parse, per context key. */
+    contextVersions?: Readonly<Record<string, number>>;
+    contract?: FragmentContract;
+    /** How long to wait for a host to offer a connection. */
+    timeoutMs?: number;
+    /** Beat interval; defaults to the shared two seconds. */
+    beatIntervalMs?: number;
+}
+/** Waits for a host to offer a port, then completes the Weave handshake over it. */
+export declare function connectToBraidHost(options: ConnectOptions): Promise<GuestSession>;

package/src/weave/guest.js

@@ -0,0 +1,120 @@
+import { BraidError } from '../errors.js';
+import { SANDBOX_CONNECT, SANDBOX_READY, } from '../realm/sandbox-realm.js';
+import { createBoundaryChannel } from './channel.js';
+import { createPortBacking } from './port-backing.js';
+import { createContextMirror } from './context-bridge.js';
+import { createClosingCoordinator } from './closing.js';
+import { answerHandshake } from './handshake.js';
+import { startFragmentBeats } from './liveness.js';
+import { FRAGMENT_EVENT, PROPS_CHANGED } from './messages.js';
+const CONNECT_TIMEOUT_MS = 15_000;
+/** Waits for a host to offer a port, then completes the Weave handshake over it. */
+export async function connectToBraidHost(options) {
+    const { hostOrigin } = options;
+    const { port, fragmentId, instance } = await acceptConnection(hostOrigin, options.timeoutMs ?? CONNECT_TIMEOUT_MS);
+    const controller = new AbortController();
+    const channel = createBoundaryChannel({
+        backing: createPortBacking(port),
+        fragmentId,
+        instance,
+        signal: controller.signal,
+    });
+    const context = createContextMirror(channel);
+    const closing = createClosingCoordinator(channel);
+    let props = {};
+    const propsListeners = new Set();
+    const announceProps = () => {
+        for (const listener of [...propsListeners]) {
+            try {
+                listener(props);
+            }
+            catch (error) {
+                console.error('braid: a props listener threw', error);
+            }
+        }
+    };
+    channel.on(PROPS_CHANGED, (payload) => {
+        props = (payload ?? {}).props ?? {};
+        announceProps();
+    });
+    const opened = answerHandshake({
+        channel,
+        ...(options.contextVersions === undefined ? {} : { contextVersions: options.contextVersions }),
+        ...(options.contract === undefined ? {} : { contract: options.contract }),
+        onOpen(open) {
+            context.seed(open);
+            props = open.props ?? {};
+            announceProps();
+        },
+    });
+    await opened;
+    /**
+     * Beats run on this document's own timers, which is what makes them meaningful here — more so
+     * than on the trusted tier, where the "realm" is a hidden frame. A cross-origin fragment that
+     * hangs is a whole application hanging, and its beats stop because its event loop stopped.
+     */
+    startFragmentBeats({
+        channel,
+        scheduler: window,
+        signal: controller.signal,
+        ...(options.beatIntervalMs === undefined ? {} : { beatIntervalMs: options.beatIntervalMs }),
+    });
+    return {
+        channel,
+        context: { get: (key) => context.get(key), subscribe: (key, listener, subscribeOptions) => context.subscribe(key, listener, { signal: subscribeOptions?.signal ?? controller.signal }) },
+        get props() {
+            return props;
+        },
+        onPropsChanged(listener) {
+            propsListeners.add(listener);
+            return () => void propsListeners.delete(listener);
+        },
+        emit: (type, detail) => channel.send(FRAGMENT_EVENT, { type, detail }),
+        onClosing: closing.onClosing,
+        setDirty: closing.setDirty,
+        signal: controller.signal,
+        disconnect: () => controller.abort(),
+    };
+}
+/** Announces readiness, then takes the first port a pinned host offers. */
+function acceptConnection(hostOrigin, timeoutMs) {
+    const { promise, resolve, reject } = Promise.withResolvers();
+    const onMessage = (event) => {
+        // Origin pinning, the whole point. `event.origin` is set by the browser and cannot be forged by
+        // the sender, which is what makes it worth checking and `event.data` worth distrusting.
+        if (event.origin !== hostOrigin)
+            return;
+        const data = event.data;
+        if (data?.braid !== SANDBOX_CONNECT)
+            return;
+        const port = event.ports[0];
+        if (!port)
+            return;
+        cleanup();
+        resolve({ port, fragmentId: String(data.fragmentId ?? 'fragment'), instance: String(data.instance ?? 'instance') });
+    };
+    const timer = setTimeout(() => {
+        cleanup();
+        reject(new BraidError(`no braid host offered a connection within ${timeoutMs}ms`, {
+            fragmentId: '<unconnected>',
+            stage: 'handshake',
+            fixHint: `check that this page is framed by "${hostOrigin}" and that the host mounts it with trust="untrusted"`,
+        }));
+    }, timeoutMs);
+    function cleanup() {
+        clearTimeout(timer);
+        window.removeEventListener('message', onMessage);
+    }
+    window.addEventListener('message', onMessage);
+    /**
+     * Announced *after* the listener is attached, so the two orderings converge.
+     *
+     * The host posts on the frame's `load` event, which may fire before this module has even been
+     * evaluated. Announcing tells a host that already gave up waiting to post again; attaching first
+     * means a host that posted immediately is not missed either.
+     */
+    const ready = { braid: SANDBOX_READY, v: 1 };
+    window.parent?.postMessage(ready, hostOrigin);
+    return promise;
+}
+//# sourceMappingURL=guest.js.map

package/src/weave/guest.js.map

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