@adobe/data-rpc 0.10.11

package/dist/host/register-service.js

@@ -0,0 +1,169 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { validate } from "@adobe/data/schema";
+import { isPureDataSchema } from "../arg-marshal.js";
+import { reconstructError } from "../consume/reconstruct-error.js";
+import { marshalError } from "./marshal-error.js";
+/**
+ * Resolve an authorized, argument-validated member for an incoming request.
+ * `path` addresses the member from the service root, walking through any nested
+ * services. Returns the leaf member schema + callable, or an `RpcError`
+ * describing why it was refused (service not exposed, member absent, not
+ * permitted, or bad args).
+ */
+function resolve(ctx, service, path, args) {
+    const label = `${service}.${path.join(".")}`;
+    const exposed = ctx.exposed.get(service);
+    if (exposed === undefined) {
+        return { error: { name: "RpcError", message: `service "${service}" is not exposed` } };
+    }
+    if (path.length === 0) {
+        return { error: { name: "RpcError", message: `empty member path for service "${service}"` } };
+    }
+    if (!ctx.canInvoke(service, path.join("."))) {
+        return { error: { name: "RpcError", message: `"${label}" is not permitted` } };
+    }
+    // Walk the schema tree to the leaf member schema (through nested services).
+    // Own-property checks only, so a wire path can never reach an inherited member
+    // (e.g. `constructor`, `__proto__`) on the schema or the service object.
+    let memberSchema = exposed.schema;
+    for (const key of path) {
+        const props = memberSchema.properties;
+        if (props === undefined || !Object.prototype.hasOwnProperty.call(props, key)) {
+            return { error: { name: "RpcError", message: `service "${service}" has no member "${label}"` } };
+        }
+        memberSchema = props[key];
+    }
+    const params = memberSchema.signature?.parameters;
+    if (params !== undefined) {
+        const errors = [];
+        params.forEach((p, i) => {
+            if (i >= args.length)
+                errors.push(`missing required argument ${i} for "${label}"`);
+            // Only pure-Data params are validated; a param that carries an observe
+            // (an arg-observe ref on the wire) is not a validatable Data value.
+            else if (isPureDataSchema(p))
+                errors.push(...validate(p, args[i]));
+        });
+        if (errors.length > 0) {
+            return { error: { name: "RpcError", message: `invalid arguments for "${label}": ${errors.join("; ")}` } };
+        }
+    }
+    // Walk the service object tree to the leaf member (own properties only).
+    let target = exposed.service;
+    for (const key of path) {
+        if (target === null || typeof target !== "object" || !Object.prototype.hasOwnProperty.call(target, key)) {
+            return { error: { name: "RpcError", message: `service "${service}" has no member "${label}"` } };
+        }
+        target = target[key];
+    }
+    // Reconstruct any arg-observes into local Observes that pull from the caller.
+    const realArgs = ctx.unmarshalArgs(args, params);
+    return { memberSchema, target: target, args: realArgs };
+}
+/**
+ * Handle one incoming REQUEST message against the host's exposed services.
+ * Response/announcement kinds are handled elsewhere (the caller side); this
+ * covers get-schema, call, send, subscribe/unsubscribe, and the pull-based
+ * generator lifecycle. Returns `true` if the message was a host request it
+ * handled, `false` otherwise (so the endpoint can route it to the caller side).
+ */
+export function handleHostRequest(ctx, msg) {
+    switch (msg.kind) {
+        case "get-schema": {
+            const exposed = ctx.exposed.get(msg.service);
+            ctx.send({ kind: "schema", id: msg.id, service: msg.service, schema: exposed?.schema ?? null });
+            return true;
+        }
+        case "call": {
+            const r = resolve(ctx, msg.service, msg.path, msg.args);
+            if ("error" in r) {
+                ctx.send({ kind: "reject", id: msg.id, error: r.error });
+                return true;
+            }
+            const fn = r.target;
+            Promise.resolve()
+                .then(() => fn(...r.args))
+                .then((value) => ctx.send({ kind: "resolve", id: msg.id, value: value === undefined ? null : value }), (error) => ctx.send({ kind: "reject", id: msg.id, error: marshalError(error) }));
+            return true;
+        }
+        case "send": {
+            const r = resolve(ctx, msg.service, msg.path, msg.args);
+            if ("error" in r) {
+                ctx.onError(reconstructError(r.error));
+                return true;
+            }
+            // A void member's throw has no wire channel — surface it via onError.
+            try {
+                r.target(...r.args);
+            }
+            catch (error) {
+                ctx.onError(error);
+            }
+            return true;
+        }
+        case "subscribe": {
+            const r = resolve(ctx, msg.service, msg.path, msg.args);
+            if ("error" in r) {
+                // An observe has no error channel — surface the refusal via onError.
+                ctx.onError(reconstructError(r.error));
+                return true;
+            }
+            const observe = r.memberSchema.type === "observe"
+                ? r.target
+                : r.target(...r.args);
+            const unobserve = observe((value) => ctx.send({ kind: "next", id: msg.id, value }));
+            ctx.hostSubs.set(msg.id, unobserve);
+            return true;
+        }
+        case "unsubscribe": {
+            ctx.hostSubs.get(msg.id)?.();
+            ctx.hostSubs.delete(msg.id);
+            return true;
+        }
+        case "iterate": {
+            const r = resolve(ctx, msg.service, msg.path, msg.args);
+            if ("error" in r) {
+                ctx.send({ kind: "throw", id: msg.id, error: r.error });
+                return true;
+            }
+            const gen = r.target(...r.args);
+            ctx.hostGens.set(msg.id, gen);
+            return true;
+        }
+        case "pull": {
+            const gen = ctx.hostGens.get(msg.id);
+            if (gen === undefined)
+                return true; // already returned / never iterated
+            gen.next().then((result) => {
+                if (result.done) {
+                    ctx.hostGens.delete(msg.id);
+                    ctx.send({ kind: "done", id: msg.id, value: result.value ?? undefined });
+                }
+                else {
+                    ctx.send({ kind: "yield", id: msg.id, value: result.value });
+                }
+            }, (error) => {
+                ctx.hostGens.delete(msg.id);
+                ctx.send({ kind: "throw", id: msg.id, error: marshalError(error) });
+            });
+            return true;
+        }
+        case "return": {
+            const gen = ctx.hostGens.get(msg.id);
+            ctx.hostGens.delete(msg.id);
+            void gen?.return(undefined).catch((error) => ctx.onError(error));
+            return true;
+        }
+        case "raise": {
+            const gen = ctx.hostGens.get(msg.id);
+            ctx.hostGens.delete(msg.id);
+            void gen?.throw(reconstructError(msg.error)).catch(() => {
+                // The injected error propagating back out is expected; swallow it.
+            });
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=register-service.js.map

package/dist/host/register-service.js.map

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

package/dist/id.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates a per-endpoint monotonic id allocator. Ids identify in-flight calls,
+ * subscriptions, and generators originated by THIS endpoint; they need only be
+ * unique per-originator (see the caller/host table split in `create-endpoint`),
+ * so a simple local counter suffices.
+ */
+export declare function createIdAllocator(): () => number;

package/dist/id.js

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Creates a per-endpoint monotonic id allocator. Ids identify in-flight calls,
+ * subscriptions, and generators originated by THIS endpoint; they need only be
+ * unique per-originator (see the caller/host table split in `create-endpoint`),
+ * so a simple local counter suffices.
+ */
+export function createIdAllocator() {
+    let next = 1;
+    return () => next++;
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { RPC_PROTOCOL_VERSION, type RpcMessage, type RpcError, type RpcRequestKind, type RpcResponseKind } from "./protocol.js";
+export { type RpcTransport } from "./transport.js";
+export { type RpcEndpoint, type RpcEndpointOptions } from "./endpoint.js";
+export { createRpcEndpoint } from "./create-endpoint.js";
+export { createRpcLoopbackTransport } from "./transports/loopback-transport.js";
+export { createMessagePortTransport } from "./transports/message-port-transport.js";
+export { createWindowTransport, type WindowTransportOptions } from "./transports/window-transport.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { RPC_PROTOCOL_VERSION } from "./protocol.js";
+export { createRpcEndpoint } from "./create-endpoint.js";
+export { createRpcLoopbackTransport } from "./transports/loopback-transport.js";
+export { createMessagePortTransport } from "./transports/message-port-transport.js";
+export { createWindowTransport } from "./transports/window-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,oBAAoB,EAA6E,MAAM,eAAe,CAAC;AAGhI,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAA+B,MAAM,kCAAkC,CAAC"}

package/dist/nested.test.d.ts

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

package/dist/nested.test.js

@@ -0,0 +1,128 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+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";
+import { createMessagePortTransport } from "./transports/message-port-transport.js";
+var ParentService;
+(function (ParentService) {
+    ParentService.schema = {
+        type: "object",
+        properties: {
+            root: { type: "observe", value: { type: "number" } },
+            child: {
+                type: "object",
+                properties: {
+                    value: { type: "observe", value: { type: "number" } },
+                    add: { type: "function", signature: { parameters: [{ type: "number" }, { type: "number" }], returns: { type: "promise", value: { type: "number" } } } },
+                    stream: { type: "function", signature: { parameters: [{ type: "number" }], returns: { type: "generator", value: { type: "number" } } } },
+                    bump: { type: "function" },
+                    deep: {
+                        type: "object",
+                        properties: {
+                            greet: { type: "function", signature: { parameters: [{ type: "string" }], returns: { type: "promise", value: { type: "string" } } } },
+                        },
+                        required: ["greet"],
+                        additionalProperties: false,
+                    },
+                },
+                required: ["value", "add", "stream", "bump", "deep"],
+                additionalProperties: false,
+            },
+        },
+        required: ["root", "child"],
+        additionalProperties: false,
+    };
+})(ParentService || (ParentService = {}));
+function makeParent(seed) {
+    const [root] = Observe.createState(seed);
+    const [value, setValue] = Observe.createState(seed * 10);
+    let current = seed * 10;
+    const stats = { streamFinally: 0 };
+    const service = {
+        serviceName: `parent-${seed}`,
+        schema: Observe.fromConstant(ParentService.schema),
+        root,
+        child: {
+            value,
+            add: async (a, b) => a + b,
+            stream: async function* (to) {
+                try {
+                    for (let i = 1; i <= to; i++)
+                        yield i;
+                }
+                finally {
+                    stats.streamFinally++;
+                }
+            },
+            bump: () => setValue((current += 1)),
+            deep: {
+                greet: async (name) => `hello ${name}`,
+            },
+        },
+    };
+    return { service, stats };
+}
+const flush = async (times = 8) => {
+    for (let i = 0; i < times; i++)
+        await new Promise((r) => setTimeout(r, 0));
+};
+describe("nested services", () => {
+    it("shims nested members on both sides and round-trips every kind", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        const host = makeParent(3);
+        ea.expose("parent", host.service, ParentService.schema);
+        const parent = eb.consume("parent", ParentService.schema);
+        // nested promise + doubly-nested promise
+        expect(await parent.child.add(2, 3)).toBe(5);
+        expect(await parent.child.deep.greet("world")).toBe("hello world");
+        // nested generator
+        const out = [];
+        for await (const n of parent.child.stream(3))
+            out.push(n);
+        expect(out).toEqual([1, 2, 3]);
+        expect(host.stats.streamFinally).toBe(1);
+        // nested observe + nested void mutation
+        const seen = [];
+        const un = parent.child.value((v) => seen.push(v));
+        await flush();
+        expect(seen).toEqual([30]); // seed*10
+        parent.child.bump();
+        await flush();
+        expect(seen).toEqual([30, 31]);
+        un();
+        // top-level observe still works alongside the nested tree
+        let rootSeen;
+        const un2 = parent.root((v) => { rootSeen = v; });
+        await flush();
+        expect(rootSeen).toBe(3);
+        un2();
+        ea.close();
+        eb.close();
+    });
+    it("rejects a nested call with invalid arguments (path-addressed validation)", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        ea.expose("parent", makeParent(1).service, ParentService.schema);
+        const parent = eb.consume("parent", ParentService.schema);
+        const untyped = parent;
+        await expect(untyped.child.add("nope", 2)).rejects.toThrowError(/invalid arguments.*parent\.child\.add/);
+        ea.close();
+        eb.close();
+    });
+    it("addresses nested members over a real MessageChannel (the iframe transport)", async () => {
+        const { port1, port2 } = new MessageChannel();
+        const ea = createRpcEndpoint(createMessagePortTransport(port1));
+        const eb = createRpcEndpoint(createMessagePortTransport(port2));
+        ea.expose("parent", makeParent(2).service, ParentService.schema);
+        const parent = eb.consume("parent", ParentService.schema);
+        expect(await parent.child.deep.greet("port")).toBe("hello port");
+        expect(await parent.child.add(20, 22)).toBe(42);
+        ea.close();
+        eb.close();
+    });
+});
+//# sourceMappingURL=nested.test.js.map

package/dist/nested.test.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,157 @@
+import type { Data } from "@adobe/data";
+import type { Schema } from "@adobe/data/schema";
+/**
+ * The wire protocol for `@adobe/data-rpc`.
+ *
+ * Every payload that crosses the boundary is `Data` (JSON + Set/Map/Blob) — never
+ * an `Observe`, `Promise`, `AsyncGenerator`, or function. The far side synthesizes
+ * equivalent-shaped members locally; only their `Data` values travel. A service
+ * gated on `AsyncDataService.IsValid` provably contains nothing else to marshal.
+ *
+ * The channel is symmetric: both endpoints originate requests. Direction is
+ * implicit in the message `kind` — the request and response kind sets are
+ * disjoint — so an `id` need only be unique per-originator. Each endpoint keeps
+ * SEPARATE caller-side and host-side pending tables; the same numeric id may be
+ * live in both directions at once with no cross-talk.
+ */
+/** Bumped when the wire shape changes incompatibly; peers exchange it in the handshake. */
+export declare const RPC_PROTOCOL_VERSION = 1;
+/**
+ * Serialized form of a thrown value. We never structured-clone the thrown value
+ * itself (that drops the subclass prototype and non-standard props); the host
+ * captures these three fields and the caller reconstructs a plain `Error`.
+ */
+export interface RpcError {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+}
+/** REQUEST kinds — always sent by the calling side toward the hosting side. */
+export type RpcRequestKind = "hello" | "get-schema" | "call" | "send" | "subscribe" | "unsubscribe" | "iterate" | "pull" | "return" | "raise";
+/** RESPONSE / announcement kinds — always sent by the hosting side toward the caller. */
+export type RpcResponseKind = "welcome" | "available" | "unavailable" | "schema" | "resolve" | "reject" | "next" | "yield" | "done" | "throw";
+export type RpcMessage = {
+    readonly kind: "hello";
+    readonly protocol: number;
+} | {
+    readonly kind: "welcome";
+    readonly protocol: number;
+} | {
+    readonly kind: "available";
+    readonly service: string;
+    readonly schema: Schema;
+} | {
+    readonly kind: "unavailable";
+    readonly service: string;
+} | {
+    readonly kind: "get-schema";
+    readonly id: number;
+    readonly service: string;
+} | {
+    readonly kind: "schema";
+    readonly id: number;
+    readonly service: string;
+    readonly schema: Schema | null;
+} | {
+    readonly kind: "call";
+    readonly id: number;
+    readonly service: string;
+    readonly path: readonly string[];
+    readonly args: readonly Data[];
+} | {
+    readonly kind: "resolve";
+    readonly id: number;
+    readonly value: Data;
+} | {
+    readonly kind: "reject";
+    readonly id: number;
+    readonly error: RpcError;
+} | {
+    readonly kind: "send";
+    readonly id: number;
+    readonly service: string;
+    readonly path: readonly string[];
+    readonly args: readonly Data[];
+} | {
+    readonly kind: "subscribe";
+    readonly id: number;
+    readonly service: string;
+    readonly path: readonly string[];
+    readonly args: readonly Data[];
+} | {
+    readonly kind: "next";
+    readonly id: number;
+    readonly value: Data;
+} | {
+    readonly kind: "unsubscribe";
+    readonly id: number;
+} | {
+    readonly kind: "iterate";
+    readonly id: number;
+    readonly service: string;
+    readonly path: readonly string[];
+    readonly args: readonly Data[];
+} | {
+    readonly kind: "pull";
+    readonly id: number;
+} | {
+    readonly kind: "yield";
+    readonly id: number;
+    readonly value: Data;
+} | {
+    readonly kind: "done";
+    readonly id: number;
+    readonly value?: Data;
+} | {
+    readonly kind: "throw";
+    readonly id: number;
+    readonly error: RpcError;
+} | {
+    readonly kind: "return";
+    readonly id: number;
+} | {
+    readonly kind: "raise";
+    readonly id: number;
+    readonly error: RpcError;
+} | {
+    readonly kind: "arg-subscribe";
+    readonly ref: number;
+    readonly sub: number;
+} | {
+    readonly kind: "arg-next";
+    readonly sub: number;
+    readonly value: Data;
+} | {
+    readonly kind: "arg-unsubscribe";
+    readonly sub: number;
+} | {
+    readonly kind: "arg-resolve";
+    readonly ref: number;
+    readonly value: Data;
+} | {
+    readonly kind: "arg-reject";
+    readonly ref: number;
+    readonly error: RpcError;
+} | {
+    readonly kind: "arg-pull";
+    readonly ref: number;
+} | {
+    readonly kind: "arg-yield";
+    readonly ref: number;
+    readonly value: Data;
+} | {
+    readonly kind: "arg-done";
+    readonly ref: number;
+    readonly value?: Data;
+} | {
+    readonly kind: "arg-throw";
+    readonly ref: number;
+    readonly error: RpcError;
+} | {
+    readonly kind: "arg-return";
+    readonly ref: number;
+} | {
+    readonly kind: "arg-raise";
+    readonly ref: number;
+    readonly error: RpcError;
+};

package/dist/protocol.js

@@ -0,0 +1,18 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * The wire protocol for `@adobe/data-rpc`.
+ *
+ * Every payload that crosses the boundary is `Data` (JSON + Set/Map/Blob) — never
+ * an `Observe`, `Promise`, `AsyncGenerator`, or function. The far side synthesizes
+ * equivalent-shaped members locally; only their `Data` values travel. A service
+ * gated on `AsyncDataService.IsValid` provably contains nothing else to marshal.
+ *
+ * The channel is symmetric: both endpoints originate requests. Direction is
+ * implicit in the message `kind` — the request and response kind sets are
+ * disjoint — so an `id` need only be unique per-originator. Each endpoint keeps
+ * SEPARATE caller-side and host-side pending tables; the same numeric id may be
+ * live in both directions at once with no cross-talk.
+ */
+/** Bumped when the wire shape changes incompatibly; peers exchange it in the handshake. */
+export const RPC_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAKvD;;;;;;;;;;;;;GAaG;AAEH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/review-fixes.test.d.ts

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