@braidlabs/core 0.1.1 → 0.3.0

package/src/weave/same-realm-backing.d.ts

@@ -0,0 +1,21 @@
+import { ChannelBacking } from './channel.js';
+/**
+ * The trusted-tier transport: a linked pair of backings that hand envelopes straight to each other.
+ *
+ * No serialization, no `postMessage`, no clone — a same-origin realm shares a heap with its host, so
+ * paying for a structured clone at this layer would be a cost with no buyer. Clone discipline lives
+ * one level up, where the *bus* decides what a fragment is allowed to keep a reference to.
+ *
+ * **Delivery is asynchronous anyway, and that is the whole design.** Dispatching synchronously would
+ * be faster and would make this backing behave differently from `port-backing` in the one way that
+ * matters most: reentrancy. A synchronous backing lets a handler observe a send completing before
+ * its own frame returns, so code written against it works on the trusted tier and deadlocks or
+ * reorders on the untrusted one — a bug that would only surface in Phase 5, in a fragment nobody
+ * has the source of. Queuing a microtask costs nothing measurable and makes the two transports
+ * behave identically.
+ */
+export interface SameRealmBackingPair {
+    host: ChannelBacking;
+    fragment: ChannelBacking;
+}
+export declare function createSameRealmBackingPair(): SameRealmBackingPair;

package/src/weave/same-realm-backing.js

@@ -0,0 +1,44 @@
+export function createSameRealmBackingPair() {
+    let hostHandler;
+    let fragmentHandler;
+    let closed = false;
+    const deliver = (to, envelope) => {
+        if (closed)
+            return;
+        queueMicrotask(() => {
+            if (closed)
+                return;
+            to()?.(envelope);
+        });
+    };
+    const closeBoth = () => {
+        closed = true;
+        hostHandler = undefined;
+        fragmentHandler = undefined;
+    };
+    return {
+        host: {
+            post: (envelope) => deliver(() => fragmentHandler, envelope),
+            receive(handler) {
+                hostHandler = handler;
+                return () => {
+                    if (hostHandler === handler)
+                        hostHandler = undefined;
+                };
+            },
+            close: closeBoth,
+        },
+        fragment: {
+            post: (envelope) => deliver(() => hostHandler, envelope),
+            receive(handler) {
+                fragmentHandler = handler;
+                return () => {
+                    if (fragmentHandler === handler)
+                        fragmentHandler = undefined;
+                };
+            },
+            close: closeBoth,
+        },
+    };
+}
+//# sourceMappingURL=same-realm-backing.js.map

package/src/weave/same-realm-backing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"same-realm-backing.js","sourceRoot":"","sources":["../../../../../libs/core/src/weave/same-realm-backing.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,0BAA0B;IACxC,IAAI,WAAuD,CAAC;IAC5D,IAAI,eAA2D,CAAC;IAChE,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,OAAO,GAAG,CAAC,EAAoD,EAAE,QAAkB,EAAE,EAAE;QAC3F,IAAI,MAAM;YAAE,OAAO;QACnB,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,MAAM;gBAAE,OAAO;YACnB,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,MAAM,GAAG,IAAI,CAAC;QACd,WAAW,GAAG,SAAS,CAAC;QACxB,eAAe,GAAG,SAAS,CAAC;IAC9B,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC;YAC5D,OAAO,CAAC,OAAO;gBACb,WAAW,GAAG,OAAO,CAAC;gBACtB,OAAO,GAAG,EAAE;oBACV,IAAI,WAAW,KAAK,OAAO;wBAAE,WAAW,GAAG,SAAS,CAAC;gBACvD,CAAC,CAAC;YACJ,CAAC;YACD,KAAK,EAAE,SAAS;SACjB;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;YACxD,OAAO,CAAC,OAAO;gBACb,eAAe,GAAG,OAAO,CAAC;gBAC1B,OAAO,GAAG,EAAE;oBACV,IAAI,eAAe,KAAK,OAAO;wBAAE,eAAe,GAAG,SAAS,CAAC;gBAC/D,CAAC,CAAC;YACJ,CAAC;YACD,KAAK,EAAE,SAAS;SACjB;KACF,CAAC;AACJ,CAAC"}