@adobe/data-rpc 0.10.11

package/dist/review-fixes.test.js

@@ -0,0 +1,200 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Red tests pinning the PR #197 review findings. Each fails before its fix.
+import { describe, it, expect } from "vitest";
+import { Observe } from "@adobe/data/observe";
+import { createRpcEndpoint } from "./create-endpoint.js";
+import { createRpcLoopbackTransport } from "./transports/loopback-transport.js";
+const flush = async (times = 12) => {
+    for (let i = 0; i < times; i++)
+        await new Promise((r) => setTimeout(r, 0));
+};
+const ignoreSchema = {
+    type: "object",
+    properties: {
+        ignoreArg: { type: "function", signature: { parameters: [{ type: "promise", value: { type: "number" } }], returns: { type: "promise" } } },
+    },
+    required: ["ignoreArg"],
+    additionalProperties: false,
+};
+describe("B1 — rejecting promise arg ignored by the member", () => {
+    it("does not raise an unhandled rejection", async () => {
+        const rejections = [];
+        const onUnhandled = (r) => rejections.push(r);
+        process.on("unhandledRejection", onUnhandled);
+        try {
+            const { a, b } = createRpcLoopbackTransport();
+            const ea = createRpcEndpoint(a);
+            const eb = createRpcEndpoint(b);
+            const service = {
+                serviceName: "ignore",
+                schema: Observe.fromConstant(ignoreSchema),
+                ignoreArg: async () => undefined, // never touches the promise arg
+            };
+            ea.expose("ignore", service, ignoreSchema);
+            const svc = eb.consume("ignore", ignoreSchema);
+            await svc.ignoreArg(Promise.reject(new Error("boom")));
+            await flush();
+            await new Promise((r) => setTimeout(r, 30)); // let any unhandledRejection fire
+            expect(rejections).toEqual([]);
+            ea.close();
+            eb.close();
+        }
+        finally {
+            process.off("unhandledRejection", onUnhandled);
+        }
+    });
+});
+const lateSchema = {
+    type: "object",
+    properties: {
+        lateAwait: { type: "function", signature: { parameters: [{ type: "promise", value: { type: "number" } }], returns: { type: "promise" } } },
+        result: { type: "observe", value: { type: "string" } },
+        lateDrain: { type: "function", signature: { parameters: [{ type: "generator", value: { type: "number" } }], returns: { type: "promise" } } },
+        drained: { type: "observe", value: { type: "string" } },
+    },
+    required: ["lateAwait", "result", "lateDrain", "drained"],
+    additionalProperties: false,
+};
+function makeLate() {
+    const [result, setResult] = Observe.createState("pending");
+    const [drained, setDrained] = Observe.createState("pending");
+    return {
+        serviceName: "late",
+        schema: Observe.fromConstant(lateSchema),
+        result,
+        drained,
+        lateAwait: async (p) => {
+            // Return immediately; consume the arg later, in the background.
+            void p.then((v) => setResult(`resolved:${v}`), (e) => setResult(`rejected:${e.message}`));
+        },
+        lateDrain: async (g) => {
+            void (async () => {
+                let sum = 0;
+                try {
+                    for await (const n of g)
+                        sum += n;
+                    setDrained(`done:${sum}`);
+                }
+                catch (e) {
+                    setDrained(`err:${e.message}`);
+                }
+            })();
+        },
+    };
+}
+describe("S1 — arg consumed after the call completes", () => {
+    it("settles a promise arg instead of hanging the callee", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        ea.expose("late", makeLate(), lateSchema);
+        const svc = eb.consume("late", lateSchema);
+        const seen = [];
+        svc.result((v) => seen.push(v));
+        let resolveArg;
+        const arg = new Promise((r) => (resolveArg = r));
+        await svc.lateAwait(arg); // call resolves before the arg is consumed
+        resolveArg(42);
+        await flush();
+        expect(seen.at(-1)).not.toBe("pending"); // callee's arg promise must settle
+        ea.close();
+        eb.close();
+    });
+    it("terminates a generator arg instead of hanging the callee", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        ea.expose("late", makeLate(), lateSchema);
+        const svc = eb.consume("late", lateSchema);
+        const seen = [];
+        svc.drained((v) => seen.push(v));
+        async function* nums() {
+            yield 1;
+            yield 2;
+            yield 3;
+        }
+        await svc.lateDrain(nums());
+        await flush();
+        expect(seen.at(-1)).not.toBe("pending"); // callee's for-await must terminate
+        ea.close();
+        eb.close();
+    });
+});
+const greetSchema = {
+    type: "object",
+    properties: { greet: { type: "function", signature: { returns: { type: "promise", value: { type: "string" } } } } },
+    required: ["greet"],
+    additionalProperties: false,
+};
+describe("S2 — prototype-chain path traversal", () => {
+    it("rejects path ['constructor'] rather than invoking Object", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const service = {
+            serviceName: "greet",
+            schema: Observe.fromConstant(greetSchema),
+            greet: async () => "hi",
+        };
+        ea.expose("greet", service, greetSchema);
+        const responses = [];
+        b.onMessage((m) => responses.push(m));
+        b.send({ kind: "call", id: 999, service: "greet", path: ["constructor"], args: [] });
+        await flush();
+        const resp = responses.find((m) => "id" in m && m.id === 999);
+        expect(resp?.kind).toBe("reject"); // not a resolve from calling Object()
+        ea.close();
+    });
+});
+const voidArgSchema = {
+    type: "object",
+    properties: {
+        logObs: { type: "function", signature: { parameters: [{ type: "observe", value: { type: "number" } }] } },
+    },
+    required: ["logObs"],
+    additionalProperties: false,
+};
+describe("S4 — constructor arg on a void member", () => {
+    it("throws rather than silently leaking a provider", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        const service = {
+            serviceName: "voidarg",
+            schema: Observe.fromConstant(voidArgSchema),
+            logObs: () => undefined,
+        };
+        ea.expose("voidarg", service, voidArgSchema);
+        const svc = eb.consume("voidarg", voidArgSchema);
+        expect(() => svc.logObs(Observe.fromConstant(1))).toThrowError(/void member/i);
+        ea.close();
+        eb.close();
+    });
+});
+const awaitSchema = {
+    type: "object",
+    properties: {
+        awaitIt: { type: "function", signature: { parameters: [{ type: "promise", value: { type: "number" } }], returns: { type: "promise", value: { type: "number" } } } },
+    },
+    required: ["awaitIt"],
+    additionalProperties: false,
+};
+describe("N2 — raw value at a constructor position", () => {
+    it("passes a bare number through instead of treating it as a ref", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b, { defaultTimeoutMs: 250 });
+        const service = {
+            serviceName: "await",
+            schema: Observe.fromConstant(awaitSchema),
+            awaitIt: async (p) => await p,
+        };
+        ea.expose("await", service, awaitSchema);
+        const svc = eb.consume("await", awaitSchema);
+        // Caller misuse: a raw number where the schema says `promise`.
+        const untyped = svc;
+        expect(await untyped.awaitIt(5)).toBe(5);
+        ea.close();
+        eb.close();
+    });
+});
+//# sourceMappingURL=review-fixes.test.js.map

package/dist/review-fixes.test.js.map

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

package/dist/rpc.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/rpc.test.js

@@ -0,0 +1,250 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect, vi } from "vitest";
+import { Observe } from "@adobe/data/observe";
+import { createRpcEndpoint } from "./create-endpoint.js";
+import { createRpcLoopbackTransport } from "./transports/loopback-transport.js";
+var DemoService;
+(function (DemoService) {
+    DemoService.schema = {
+        type: "object",
+        properties: {
+            value: { type: "observe", value: { type: "number" } },
+            tracked: { type: "observe", value: { type: "number" } },
+            selectDouble: { type: "function", signature: { parameters: [{ type: "number" }], returns: { type: "observe", value: { type: "number" } } } },
+            add: { type: "function", signature: { parameters: [{ type: "number" }, { type: "number" }], returns: { type: "promise", value: { type: "number" } } } },
+            fail: { type: "function", signature: { parameters: [{ type: "string" }], returns: { type: "promise", value: { type: "number" } } } },
+            countUp: { type: "function", signature: { parameters: [{ type: "number" }], returns: { type: "generator", value: { type: "number" } } } },
+            explode: { type: "function", signature: { parameters: [{ type: "number" }], returns: { type: "generator", value: { type: "number" } } } },
+            bump: { type: "function" },
+            boom: { type: "function" },
+        },
+        required: ["value", "tracked", "selectDouble", "add", "fail", "countUp", "explode", "bump", "boom"],
+        additionalProperties: false,
+    };
+})(DemoService || (DemoService = {}));
+function makeDemo(seed) {
+    const [value, setValue] = Observe.createState(seed);
+    let current = seed;
+    let activeObservers = 0;
+    const stats = { countUpFinally: 0, explodeFinally: 0, get activeObservers() { return activeObservers; } };
+    // A hand-written observe so we can prove the host unsubscribes on unsubscribe/close.
+    const tracked = (notify) => {
+        activeObservers++;
+        notify(seed);
+        return () => { activeObservers--; };
+    };
+    const service = {
+        serviceName: `demo-${seed}`,
+        schema: Observe.fromConstant(DemoService.schema),
+        value,
+        tracked,
+        selectDouble: (n) => Observe.fromConstant(n * 2),
+        add: async (a, b) => a + b,
+        fail: async (message) => { throw new Error(message); },
+        countUp: async function* (to) {
+            try {
+                for (let i = 1; i <= to; i++)
+                    yield i;
+            }
+            finally {
+                stats.countUpFinally++;
+            }
+        },
+        explode: async function* (to) {
+            try {
+                for (let i = 1; i <= to; i++)
+                    yield i;
+                throw new Error("explode");
+            }
+            finally {
+                stats.explodeFinally++;
+            }
+        },
+        bump: () => { current += 1; setValue(current); },
+        boom: () => { throw new Error("boom"); },
+    };
+    return { service, stats };
+}
+const flush = async (times = 8) => {
+    for (let i = 0; i < times; i++)
+        await new Promise((r) => setTimeout(r, 0));
+};
+function setup(opts) {
+    const { a, b } = createRpcLoopbackTransport();
+    const demoA = makeDemo(10);
+    const demoB = makeDemo(20);
+    const ea = createRpcEndpoint(a, opts?.a);
+    const eb = createRpcEndpoint(b, opts?.b);
+    const unExposeA = ea.expose("A", demoA.service, DemoService.schema);
+    const unExposeB = eb.expose("B", demoB.service, DemoService.schema);
+    const aToB = ea.consume("B", DemoService.schema); // A consumes B's service
+    const bToA = eb.consume("A", DemoService.schema); // B consumes A's service
+    return { ea, eb, demoA, demoB, aToB, bToA, unExposeA, unExposeB };
+}
+describe("promise members (both directions)", () => {
+    it("resolves across the wire in both directions", async () => {
+        const { aToB, bToA } = setup();
+        expect(await aToB.add(2, 3)).toBe(5);
+        expect(await bToA.add(10, 1)).toBe(11);
+    });
+    it("propagates a rejection with reconstructed name/message", async () => {
+        const { aToB } = setup();
+        await expect(aToB.fail("kaboom")).rejects.toThrowError("kaboom");
+    });
+    it("keeps ids independent per originator (bidirectional, both id=1)", async () => {
+        const { aToB, bToA } = setup();
+        const [r1, r2] = await Promise.all([aToB.add(1, 2), bToA.add(3, 4)]);
+        expect(r1).toBe(3);
+        expect(r2).toBe(7);
+    });
+});
+describe("observe members (both directions)", () => {
+    it("streams the initial value asynchronously and reacts to a void mutation", async () => {
+        const { aToB, demoB } = setup();
+        const seen = [];
+        const un = aToB.value((v) => seen.push(v));
+        // First value is a round-trip → NOT synchronous (unlike a local Observe).
+        expect(seen).toEqual([]);
+        await flush();
+        expect(seen).toEqual([20]);
+        aToB.bump(); // void member, other direction of the same channel
+        await flush();
+        expect(seen).toEqual([20, 21]);
+        expect(demoB.stats.activeObservers).toBe(0); // value uses createState, tracked is separate
+        un();
+    });
+    it("fn:observe forwards args and streams the derived value", async () => {
+        const { bToA } = setup();
+        const seen = [];
+        const un = bToA.selectDouble(21)((v) => seen.push(v));
+        await flush();
+        expect(seen).toEqual([42]);
+        un();
+    });
+    it("drops an in-flight next after unsubscribe", async () => {
+        const { aToB } = setup();
+        const seen = [];
+        const un = aToB.value((v) => seen.push(v));
+        un(); // unsubscribe before the first (async) next can arrive
+        await flush();
+        expect(seen).toEqual([]);
+    });
+    it("releases the host subscription on unsubscribe", async () => {
+        const { aToB, demoB } = setup();
+        const un = aToB.tracked(() => undefined);
+        await flush();
+        expect(demoB.stats.activeObservers).toBe(1);
+        un();
+        await flush();
+        expect(demoB.stats.activeObservers).toBe(0);
+    });
+});
+describe("generator members (both directions)", () => {
+    it("streams pull-based values in both directions", async () => {
+        const { aToB, bToA } = setup();
+        const collect = async (gen) => {
+            const out = [];
+            for await (const n of gen)
+                out.push(n);
+            return out;
+        };
+        expect(await collect(aToB.countUp(3))).toEqual([1, 2, 3]);
+        expect(await collect(bToA.countUp(2))).toEqual([1, 2]);
+    });
+    it("propagates a generator throw to the consumer", async () => {
+        const { aToB } = setup();
+        const gen = aToB.explode(2);
+        expect((await gen.next()).value).toBe(1);
+        expect((await gen.next()).value).toBe(2);
+        await expect(gen.next()).rejects.toThrowError("explode");
+    });
+    it("runs host finally on early return / dispose", async () => {
+        const { aToB, demoB } = setup();
+        const gen = aToB.countUp(100);
+        expect((await gen.next()).value).toBe(1);
+        await gen.return(undefined);
+        await flush();
+        expect(demoB.stats.countUpFinally).toBe(1);
+        expect((await gen.next()).done).toBe(true);
+    });
+});
+describe("void members", () => {
+    it("routes a host-handler throw to onError (no wire reply)", async () => {
+        const onError = vi.fn();
+        const { aToB } = setup({ b: { onError } });
+        aToB.boom();
+        await flush();
+        expect(onError).toHaveBeenCalledOnce();
+        expect(onError.mock.calls[0][0].message).toBe("boom");
+    });
+});
+describe("schema discovery", () => {
+    it("consumes with a runtime-fetched schema (after expose)", async () => {
+        const { eb } = setup();
+        const svc = (await eb.consume("A"));
+        expect(await svc.add(4, 5)).toBe(9);
+    });
+    it("supports consume-before-expose ordering", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        const pending = eb.consume("late"); // not yet exposed
+        const demo = makeDemo(7);
+        ea.expose("late", demo.service, DemoService.schema);
+        const svc = (await pending);
+        expect(await svc.add(1, 1)).toBe(2);
+    });
+    it("republishes the schema on the projected service's observable slot", async () => {
+        const { aToB } = setup();
+        let seen;
+        aToB.schema?.((s) => { seen = s; });
+        expect(seen).toEqual(DemoService.schema);
+    });
+});
+describe("trust boundary", () => {
+    it("rejects a call denied by canInvoke", async () => {
+        const { aToB } = setup({ b: { canInvoke: (_svc, member) => member !== "add" } });
+        await expect(aToB.add(1, 2)).rejects.toThrowError(/not permitted/);
+    });
+    it("rejects a call with invalid Data arguments (never invokes the member)", async () => {
+        const { aToB, demoB } = setup();
+        const invoke = vi.spyOn(demoB.service, "add");
+        // Untyped path: send a string where the schema requires a number.
+        const untyped = aToB;
+        await expect(untyped.add("x", "y")).rejects.toThrowError(/invalid arguments/);
+        expect(invoke).not.toHaveBeenCalled();
+    });
+});
+describe("teardown", () => {
+    it("rejects a pending call when the endpoint closes mid-flight", async () => {
+        const { ea, aToB } = setup();
+        const pending = aToB.add(1, 2); // registered synchronously
+        ea.close(); // before any reply can arrive
+        await expect(pending).rejects.toThrowError(/closed/);
+    });
+    it("releases host subscriptions when the channel closes", async () => {
+        const { ea, aToB, demoB } = setup();
+        aToB.tracked(() => undefined);
+        await flush();
+        expect(demoB.stats.activeObservers).toBe(1);
+        ea.close();
+        await flush();
+        expect(demoB.stats.activeObservers).toBe(0);
+    });
+    it("runs host generator finally when the channel closes mid-stream", async () => {
+        const { ea, aToB, demoB } = setup();
+        const gen = aToB.countUp(100);
+        expect((await gen.next()).value).toBe(1);
+        ea.close();
+        await flush();
+        expect(demoB.stats.countUpFinally).toBe(1);
+    });
+    it("ends a consumed generator gracefully after close", async () => {
+        const { ea, aToB } = setup();
+        const gen = aToB.countUp(100);
+        expect((await gen.next()).value).toBe(1);
+        ea.close();
+        expect((await gen.next()).done).toBe(true);
+    });
+});
+//# sourceMappingURL=rpc.test.js.map

package/dist/rpc.test.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,32 @@
+import type { RpcMessage } from "./protocol.js";
+/**
+ * Runtime-agnostic, bidirectional message channel carrying {@link RpcMessage}s.
+ *
+ * Mirrors the `@adobe/data-sync` `SyncTransport` shape (send / onMessage /
+ * onClose / close). RPC is symmetric, so `Send` and `Receive` default to the
+ * same `RpcMessage` union. Implementations are provided for a `MessagePort`
+ * (the primary iframe/worker transport), a `Window` (the initial port handoff),
+ * and an in-process loopback pair (tests / demos).
+ *
+ * The transport does not own serialization — callers pass structured objects and
+ * the underlying channel structured-clones them. Ordering of `send` calls is
+ * preserved and delivery is assumed reliable.
+ */
+export interface RpcTransport<Send = RpcMessage, Receive = RpcMessage> {
+    /**
+     * Send a message to the remote end. `transfer` optionally lists
+     * `Transferable`s handed off zero-copy (e.g. an `ArrayBuffer`); transports
+     * over channels without transfer semantics ignore it.
+     */
+    readonly send: (msg: Send, transfer?: readonly Transferable[]) => void;
+    /** Register a listener for messages from the remote end. Returns an unsubscribe. */
+    readonly onMessage: (listener: (msg: Receive) => void) => () => void;
+    /**
+     * Register a listener that fires once when the channel closes — local
+     * `close()`, remote close, or drop. Returns an unsubscribe. Firing is
+     * idempotent (at most once).
+     */
+    readonly onClose: (listener: () => void) => () => void;
+    /** Tear down the channel. */
+    readonly close: () => void;
+}

package/dist/transport.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/transports/loopback-transport.d.ts

@@ -0,0 +1,13 @@
+import type { RpcTransport } from "../transport.js";
+/**
+ * A paired in-process loopback transport for tests and single-process demos.
+ * Messages sent on `a` are delivered asynchronously to `b`'s listeners and
+ * vice-versa. Each message is `structuredClone`d on `send`, exactly as a
+ * `MessagePort` would — so a non-cloneable payload throws here too, and no
+ * live references leak across the (simulated) boundary. Closing either side
+ * tears down the whole channel and fires every `onClose` listener once.
+ */
+export declare function createRpcLoopbackTransport(): {
+    a: RpcTransport;
+    b: RpcTransport;
+};

package/dist/transports/loopback-transport.js

@@ -0,0 +1,102 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * One directed, buffered, asynchronous pipe. Delivery is scheduled on a
+ * microtask (never synchronous with `send`) to model a real `MessagePort`,
+ * where the first value of a subscription necessarily arrives after the
+ * subscribe call returns. Messages sent before a listener registers are
+ * buffered and flushed once one does. FIFO order is preserved.
+ */
+function createDirectedPipe() {
+    const listeners = new Set();
+    const pending = [];
+    let flushScheduled = false;
+    let closed = false;
+    const drain = () => {
+        flushScheduled = false;
+        if (closed)
+            return;
+        while (pending.length > 0 && listeners.size > 0) {
+            const msg = pending.shift();
+            for (const l of listeners)
+                l(msg);
+        }
+    };
+    const schedule = () => {
+        if (flushScheduled || closed)
+            return;
+        flushScheduled = true;
+        queueMicrotask(drain);
+    };
+    return {
+        push(msg) {
+            if (closed)
+                return;
+            pending.push(msg);
+            schedule();
+        },
+        onMessage(listener) {
+            listeners.add(listener);
+            if (pending.length > 0)
+                schedule();
+            return () => listeners.delete(listener);
+        },
+        close() {
+            closed = true;
+            pending.length = 0;
+            listeners.clear();
+        },
+    };
+}
+/**
+ * A paired in-process loopback transport for tests and single-process demos.
+ * Messages sent on `a` are delivered asynchronously to `b`'s listeners and
+ * vice-versa. Each message is `structuredClone`d on `send`, exactly as a
+ * `MessagePort` would — so a non-cloneable payload throws here too, and no
+ * live references leak across the (simulated) boundary. Closing either side
+ * tears down the whole channel and fires every `onClose` listener once.
+ */
+export function createRpcLoopbackTransport() {
+    const aToB = createDirectedPipe(); // a.send → b.onMessage
+    const bToA = createDirectedPipe(); // b.send → a.onMessage
+    let closed = false;
+    const closeA = new Set();
+    const closeB = new Set();
+    const doClose = () => {
+        if (closed)
+            return;
+        closed = true;
+        aToB.close();
+        bToA.close();
+        for (const l of closeA)
+            l();
+        for (const l of closeB)
+            l();
+        closeA.clear();
+        closeB.clear();
+    };
+    const makeSide = (out, inbound, closeListeners) => ({
+        send(msg) {
+            if (closed)
+                return;
+            // Clone on send to model the structured-clone boundary of a real port.
+            out.push(structuredClone(msg));
+        },
+        onMessage(listener) {
+            return inbound.onMessage(listener);
+        },
+        onClose(listener) {
+            if (closed) {
+                listener();
+                return () => undefined;
+            }
+            closeListeners.add(listener);
+            return () => closeListeners.delete(listener);
+        },
+        close: doClose,
+    });
+    return {
+        a: makeSide(aToB, bToA, closeA),
+        b: makeSide(bToA, aToB, closeB),
+    };
+}
+//# sourceMappingURL=loopback-transport.js.map

package/dist/transports/loopback-transport.js.map

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