@adobe/data-rpc 0.10.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Adobe, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# @adobe/data-rpc
+
+Schema-driven, **bidirectional** projection of `@adobe/data` async data services
+across a boundary — an iframe, a Worker, a `MessagePort`, anything with a
+message channel. Each side can both **expose** its own services and **consume**
+the peer's, over a single connection.
+
+## The core idea
+
+An `AsyncDataService` is fully described by a pure-JSON `Schema`, and every one
+of its members is one of five shapes:
+
+| member | schema | wire behavior |
+| --- | --- | --- |
+| `Observe<Data>` | `observe` | subscribe → streamed `Data` values |
+| `(...Data[]) => Observe<Data>` | `function` / `observe` | args + subscribe → streamed `Data` |
+| `(...Data[]) => Promise<Data \| void>` | `function` / `promise` | request → one `Data` reply |
+| `(...Data[]) => AsyncGenerator<Data>` | `function` / `generator` | pull-based stream of `Data` |
+| `(...Data[]) => void` | `function` (no `returns`) | fire-and-forget |
+
+**Only `Data` ever crosses the wire.** We never serialize an `Observe`,
+`Promise`, `AsyncGenerator`, or function. The consuming side *synthesizes* an
+equivalent-shaped service locally whose members are thin wrappers translating
+to/from `Data`-only messages. Gating `expose` on `AsyncDataService.IsValid`
+guarantees there is nothing but `Data` to marshal (an `Observe` is a function,
+so higher-order nesting is rejected at compile time).
+
+**Nested services** work too: a member whose schema is a child object with its
+own member `properties` is shimmed recursively on both sides (to any depth), and
+each leaf is addressed by its full path from the service root — so
+`remote.child.deep.greet(name)` round-trips exactly like a top-level member.
+
+**Constructor-typed arguments** (`Observe`, `Promise`, `AsyncGenerator`) work too,
+in reverse: one passed as — or nested inside — a call argument is a channel from
+the *caller* to the *callee*. The caller sends a ref instead of the value and
+services it over a reverse channel (an `Observe` streams on subscribe; a `Promise`
+settles once; an `AsyncGenerator` is pulled by the callee); the callee reconstructs
+a local value. For example, all of these round-trip:
+
+```ts
+display(foo: { alpha: Observe<number>; beta: Observe<string> }): Observe<string>
+awaitAndDouble(p: Promise<number>): Promise<number>
+sumStream(nums: AsyncGenerator<number>): Promise<number>
+```
+
+Describe such an argument with the matching `observe`/`promise`/`generator` schema
+at that position. Providers are released when the owning call/subscription ends and
+on endpoint close (a promise/generator arg consumed after its call has returned is
+cancelled). Function/callback arguments are not supported, and a `void` member
+cannot take constructor-typed arguments (it has no completion signal to release
+them) — doing so throws.
+
+## Define a service
+
+A projected service is an ordinary `@adobe/data` `AsyncDataService`: an interface
+of the five member shapes above, plus a sideloaded `Schema` that describes it
+exactly. The schema is the single source of truth — it drives the wrapping on
+both sides.
+
+```ts
+import type { Observe } from "@adobe/data/observe";
+import { type Schema } from "@adobe/data/schema";
+import { AsyncDataService, type Service } from "@adobe/data/service";
+import type { Assert } from "@adobe/data/types";
+
+export interface CounterService extends Service {
+  count: Observe<number>;                 // observe
+  add: (n: number) => Promise<number>;    // promise
+  reset: () => void;                      // void
+}
+
+export namespace CounterService {
+  export const schema = {
+    type: "object",
+    properties: {
+      count: { type: "observe", value: { type: "number" } },
+      add: { type: "function", signature: { parameters: [{ type: "number" }], returns: { type: "promise", value: { type: "number" } } } },
+      reset: { type: "function" },
+    },
+    required: ["count", "add", "reset"],
+    additionalProperties: false,
+  } as const satisfies Schema;
+}
+
+// Compile-time guard: the schema describes the service exactly (only Data crosses).
+type _Check = Assert<AsyncDataService.IsValidWithCompleteSchema<CounterService, typeof CounterService.schema>>;
+```
+
+## Usage
+
+```ts
+import { createRpcEndpoint, createMessagePortTransport } from "@adobe/data-rpc";
+
+// Each side over one MessagePort:
+const endpoint = createRpcEndpoint(createMessagePortTransport(port));
+
+// Expose a local service (schema must exactly describe it — compile-time checked):
+endpoint.expose("clock", myClockService, ClockService.schema);
+
+// Consume the peer's service with a compile-time schema → fully typed, sync:
+const remote = endpoint.consume("weather", WeatherService.schema);
+remote.temperature((t) => render(t));         // observe
+const forecast = await remote.forecast("NYC"); // promise
+for await (const d of remote.days(7)) { … }    // generator (pull-based)
+remote.refresh();                              // void
+
+// …or fetch the schema at runtime (resolves once the peer exposes it):
+const remote2 = await endpoint.consume("weather");
+```
+
+### iframe handshake
+
+The main frame hands the iframe one end of a `MessageChannel`, then both switch
+to a `MessagePort` transport:
+
+```ts
+const channel = new MessageChannel();
+iframe.addEventListener("load", () =>
+  iframe.contentWindow!.postMessage({ type: "port" }, origin, [channel.port2]),
+);
+const endpoint = createRpcEndpoint(createMessagePortTransport(channel.port1));
+```
+
+See the `data-rpc-iframe` sample for a complete main + sub frame demonstrating
+all four kinds in both directions.
+
+## Transports
+
+- `createMessagePortTransport(port)` — the primary iframe/worker transport.
+- `createWindowTransport(target, { allowedOrigins, targetOrigin? })` — `window.postMessage`,
+  for the initial port handoff, with origin allowlisting. `targetOrigin` is inferred
+  when there is exactly one allowed origin; otherwise it must be given explicitly
+  (outbound never defaults to `"*"`).
+- `createRpcLoopbackTransport()` — in-process pair for tests and single-process demos.
+
+`RpcTransport` is a small `send`/`onMessage`/`onClose`/`close` interface; bring
+your own for any other channel.
+
+## Trust (v1)
+
+Transport-level: origin allowlisting on the window transport, and the host only
+dispatches to explicitly `expose`d services. Incoming `Data` arguments are
+validated against `signature.parameters` before dispatch. A `canInvoke(service,
+member)` seam (default allow) is where per-member policy — e.g.
+`Schema.resolveExternalInvocation` — drops in later.
+
+## Semantics & limitations
+
+- **Observe first value is asynchronous** (a round-trip), unlike a local
+  `Observe.fromConstant`/`createState` which notifies synchronously.
+- **Generators are strictly pull-based** — the host advances one value per
+  `next()`; no unbounded buffering.
+- **Errors** are marshaled as `{ name, message, stack }` and reconstructed as a
+  plain `Error`; the remote subclass is not preserved. A throw in a `void`
+  handler has no wire channel — it is routed to the endpoint's `onError`.
+- **On close**, pending promise calls reject, consumed generators end, and all
+  host subscriptions/generators are released. A dropped subscription has no error
+  channel through `Observe<Data>`.
+- **Reconnection is out of scope** for v1 — a closed port ends all subscriptions.

package/dist/arg-async.test.d.ts

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

package/dist/arg-async.test.js

@@ -0,0 +1,147 @@
+// © 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 AsyncArgService;
+(function (AsyncArgService) {
+    const promiseNum = { type: "promise", value: { type: "number" } };
+    const genNum = { type: "generator", value: { type: "number" } };
+    AsyncArgService.schema = {
+        type: "object",
+        properties: {
+            awaitAndDouble: { type: "function", signature: { parameters: [promiseNum], returns: promiseNum } },
+            sumStream: { type: "function", signature: { parameters: [genNum], returns: promiseNum } },
+            first: { type: "function", signature: { parameters: [genNum], returns: promiseNum } },
+            combine: {
+                type: "function",
+                signature: {
+                    parameters: [
+                        {
+                            type: "object",
+                            properties: { label: { type: "promise", value: { type: "string" } }, nums: genNum },
+                            required: ["label", "nums"],
+                            additionalProperties: false,
+                        },
+                    ],
+                    returns: { type: "promise", value: { type: "string" } },
+                },
+            },
+        },
+        required: ["awaitAndDouble", "sumStream", "first", "combine"],
+        additionalProperties: false,
+    };
+})(AsyncArgService || (AsyncArgService = {}));
+function makeAsyncArg() {
+    return {
+        serviceName: "async-arg",
+        schema: Observe.fromConstant(AsyncArgService.schema),
+        awaitAndDouble: async (p) => (await p) * 2,
+        sumStream: async (g) => {
+            let sum = 0;
+            for await (const n of g)
+                sum += n;
+            return sum;
+        },
+        first: async (g) => {
+            for await (const n of g)
+                return n; // early exit → the arg generator's return() runs
+            return -1;
+        },
+        combine: async (foo) => {
+            const label = await foo.label;
+            let sum = 0;
+            for await (const n of foo.nums)
+                sum += n;
+            return `${label}:${sum}`;
+        },
+    };
+}
+const flush = async (times = 10) => {
+    for (let i = 0; i < times; i++)
+        await new Promise((r) => setTimeout(r, 0));
+};
+function setup() {
+    const { a, b } = createRpcLoopbackTransport();
+    const ea = createRpcEndpoint(a);
+    const eb = createRpcEndpoint(b);
+    ea.expose("async", makeAsyncArg(), AsyncArgService.schema);
+    const svc = eb.consume("async", AsyncArgService.schema);
+    return { ea, eb, svc };
+}
+describe("Promise arguments", () => {
+    it("resolves a promise argument from the caller", async () => {
+        const { ea, eb, svc } = setup();
+        expect(await svc.awaitAndDouble(Promise.resolve(21))).toBe(42);
+        ea.close();
+        eb.close();
+    });
+    it("propagates a rejected promise argument", async () => {
+        const { ea, eb, svc } = setup();
+        await expect(svc.awaitAndDouble(Promise.reject(new Error("bad input")))).rejects.toThrowError("bad input");
+        ea.close();
+        eb.close();
+    });
+});
+describe("AsyncGenerator arguments", () => {
+    it("streams a generator argument from the caller (host consumes fully)", async () => {
+        const { ea, eb, svc } = setup();
+        async function* nums() {
+            yield 1;
+            yield 2;
+            yield 3;
+        }
+        expect(await svc.sumStream(nums())).toBe(6);
+        ea.close();
+        eb.close();
+    });
+    it("runs the caller generator's finally when the host ends it early", async () => {
+        const { ea, eb, svc } = setup();
+        let ranFinally = false;
+        async function* provider() {
+            try {
+                yield 10;
+                yield 20;
+                yield 30;
+            }
+            finally {
+                ranFinally = true;
+            }
+        }
+        expect(await svc.first(provider())).toBe(10);
+        await flush();
+        expect(ranFinally).toBe(true); // host's early return propagated back to the caller
+        ea.close();
+        eb.close();
+    });
+});
+describe("mixed constructor arguments in a nested object", () => {
+    it("services a Promise and an AsyncGenerator inside one object argument", async () => {
+        const { ea, eb, svc } = setup();
+        async function* nums() {
+            yield 4;
+            yield 5;
+        }
+        const result = await svc.combine({ label: Promise.resolve("total"), nums: nums() });
+        expect(result).toBe("total:9");
+        ea.close();
+        eb.close();
+    });
+    it("works over a real MessageChannel", async () => {
+        const { port1, port2 } = new MessageChannel();
+        const ea = createRpcEndpoint(createMessagePortTransport(port1));
+        const eb = createRpcEndpoint(createMessagePortTransport(port2));
+        ea.expose("async", makeAsyncArg(), AsyncArgService.schema);
+        const svc = eb.consume("async", AsyncArgService.schema);
+        async function* nums() {
+            yield 7;
+            yield 8;
+        }
+        expect(await svc.awaitAndDouble(Promise.resolve(5))).toBe(10);
+        expect(await svc.sumStream(nums())).toBe(15);
+        ea.close();
+        eb.close();
+    });
+});
+//# sourceMappingURL=arg-async.test.js.map

package/dist/arg-async.test.js.map

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

package/dist/arg-marshal.d.ts

@@ -0,0 +1,34 @@
+import type { Data } from "@adobe/data";
+import type { Observe } from "@adobe/data/observe";
+import type { Schema } from "@adobe/data/schema";
+/**
+ * Constructor-typed values (`Observe`/`Promise`/`AsyncGenerator`) passed as — or
+ * nested inside — a call argument flow the "wrong" way: from the CALLER to the
+ * CALLEE. They can't be cloned onto the wire, so the caller replaces each with a
+ * numeric ref and services it over a reverse channel; the callee reconstructs a
+ * local value from the ref. These pure walkers find the constructor positions in
+ * an argument using its parameter schema and delegate to the caller's handlers.
+ *
+ * Only `Data` ever crosses; the constructor's payload values are themselves
+ * `Data`. Function (callback) arguments are not supported.
+ */
+export interface MarshalHandlers {
+    readonly observe: (obs: Observe<Data>) => number;
+    readonly promise: (promise: Promise<Data>) => number;
+    readonly generator: (generator: AsyncGenerator<Data>) => number;
+}
+export interface UnmarshalHandlers {
+    readonly observe: (ref: number) => Observe<Data>;
+    readonly promise: (ref: number) => Promise<Data>;
+    readonly generator: (ref: number) => AsyncGenerator<Data>;
+}
+/** Replace every constructor-typed position in `value` (guided by `schema`) with a ref. */
+export declare function marshalArgValue(value: unknown, schema: Schema, h: MarshalHandlers): Data;
+/** Reconstruct every constructor-typed position (a ref) in `value` into a local value. */
+export declare function unmarshalArgValue(value: unknown, schema: Schema, h: UnmarshalHandlers): unknown;
+/** Map each argument through the marshaller using its parameter schema. */
+export declare function marshalArgsWith(args: readonly unknown[], params: readonly Schema[] | undefined, h: MarshalHandlers): Data[];
+/** Map each argument through the unmarshaller using its parameter schema. */
+export declare function unmarshalArgsWith(args: readonly Data[], params: readonly Schema[] | undefined, h: UnmarshalHandlers): unknown[];
+/** True if the schema tree contains no type-constructor (observe/promise/generator/function). */
+export declare function isPureDataSchema(schema: Schema): boolean;

package/dist/arg-marshal.js

@@ -0,0 +1,90 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Refs travel as a one-key tagged envelope so a literal value at a constructor
+// position (a caller type violation) can never be mistaken for a ref.
+const REF_KEY = "$rpcRef";
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isRefEnvelope(value) {
+    return isPlainObject(value) && typeof value[REF_KEY] === "number";
+}
+function isThenable(value) {
+    return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+function isAsyncIterable(value) {
+    return value !== null && typeof value === "object" && typeof value[Symbol.asyncIterator] === "function";
+}
+/** Replace every constructor-typed position in `value` (guided by `schema`) with a ref. */
+export function marshalArgValue(value, schema, h) {
+    if (schema.type === "observe")
+        return typeof value === "function" ? { [REF_KEY]: h.observe(value) } : value;
+    if (schema.type === "promise")
+        return isThenable(value) ? { [REF_KEY]: h.promise(value) } : value;
+    if (schema.type === "generator")
+        return isAsyncIterable(value) ? { [REF_KEY]: h.generator(value) } : value;
+    if ((schema.type === "object" || schema.properties !== undefined) && isPlainObject(value)) {
+        const props = schema.properties ?? {};
+        const out = { ...value };
+        for (const [key, childSchema] of Object.entries(props)) {
+            if (key in value)
+                out[key] = marshalArgValue(value[key], childSchema, h);
+        }
+        return out;
+    }
+    if ((schema.type === "array" || schema.items !== undefined) && Array.isArray(value) && schema.items !== undefined) {
+        const items = schema.items;
+        return value.map((v) => marshalArgValue(v, items, h));
+    }
+    return value;
+}
+/** Reconstruct every constructor-typed position (a ref) in `value` into a local value. */
+export function unmarshalArgValue(value, schema, h) {
+    if (schema.type === "observe")
+        return isRefEnvelope(value) ? h.observe(value[REF_KEY]) : value;
+    if (schema.type === "promise")
+        return isRefEnvelope(value) ? h.promise(value[REF_KEY]) : value;
+    if (schema.type === "generator")
+        return isRefEnvelope(value) ? h.generator(value[REF_KEY]) : value;
+    if ((schema.type === "object" || schema.properties !== undefined) && isPlainObject(value)) {
+        const props = schema.properties ?? {};
+        const out = { ...value };
+        for (const [key, childSchema] of Object.entries(props)) {
+            if (key in value)
+                out[key] = unmarshalArgValue(value[key], childSchema, h);
+        }
+        return out;
+    }
+    if ((schema.type === "array" || schema.items !== undefined) && Array.isArray(value) && schema.items !== undefined) {
+        const items = schema.items;
+        return value.map((v) => unmarshalArgValue(v, items, h));
+    }
+    return value;
+}
+/** Map each argument through the marshaller using its parameter schema. */
+export function marshalArgsWith(args, params, h) {
+    if (params === undefined)
+        return args;
+    return args.map((arg, i) => (params[i] === undefined ? arg : marshalArgValue(arg, params[i], h)));
+}
+/** Map each argument through the unmarshaller using its parameter schema. */
+export function unmarshalArgsWith(args, params, h) {
+    if (params === undefined)
+        return args;
+    return args.map((arg, i) => (params[i] === undefined ? arg : unmarshalArgValue(arg, params[i], h)));
+}
+/** True if the schema tree contains no type-constructor (observe/promise/generator/function). */
+export function isPureDataSchema(schema) {
+    if (schema.type === "observe" || schema.type === "promise" || schema.type === "generator" || schema.type === "function") {
+        return false;
+    }
+    if (schema.properties !== undefined) {
+        for (const child of Object.values(schema.properties)) {
+            if (!isPureDataSchema(child))
+                return false;
+        }
+    }
+    if (schema.items !== undefined && !isPureDataSchema(schema.items))
+        return false;
+    return true;
+}
+//# sourceMappingURL=arg-marshal.js.map

package/dist/arg-marshal.js.map

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

package/dist/arg-observe.test.d.ts

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

package/dist/arg-observe.test.js

@@ -0,0 +1,114 @@
+// © 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 DisplayService;
+(function (DisplayService) {
+    DisplayService.schema = {
+        type: "object",
+        properties: {
+            display: {
+                type: "function",
+                signature: {
+                    parameters: [
+                        {
+                            type: "object",
+                            properties: {
+                                alpha: { type: "observe", value: { type: "number" } },
+                                beta: { type: "observe", value: { type: "string" } },
+                            },
+                            required: ["alpha", "beta"],
+                            additionalProperties: false,
+                        },
+                    ],
+                    returns: { type: "observe", value: { type: "string" } },
+                },
+            },
+        },
+        required: ["display"],
+        additionalProperties: false,
+    };
+})(DisplayService || (DisplayService = {}));
+// The callee combines the two caller-side observes into a derived string observe.
+function makeDisplay() {
+    return {
+        serviceName: "display",
+        schema: Observe.fromConstant(DisplayService.schema),
+        display: (foo) => Observe.withMap(Observe.fromProperties({ a: foo.alpha, b: foo.beta }), ({ a, b }) => `${b}=${a}`),
+    };
+}
+const flush = async (times = 10) => {
+    for (let i = 0; i < times; i++)
+        await new Promise((r) => setTimeout(r, 0));
+};
+/** A value observe that also counts how many active subscriptions it has. */
+function tracked(initial) {
+    const [raw, set] = Observe.createState(initial);
+    let active = 0;
+    const observe = (notify) => {
+        active++;
+        const un = raw(notify);
+        return () => {
+            active--;
+            un();
+        };
+    };
+    return { observe, set, active: () => active };
+}
+describe("observe values as named object arguments", () => {
+    it("streams caller-side arg observes to the callee and reacts to updates", async () => {
+        const { a, b } = createRpcLoopbackTransport();
+        const ea = createRpcEndpoint(a);
+        const eb = createRpcEndpoint(b);
+        ea.expose("display", makeDisplay(), DisplayService.schema);
+        const svc = eb.consume("display", DisplayService.schema);
+        const alpha = tracked(1);
+        const beta = tracked("x");
+        const seen = [];
+        const un = svc.display({ alpha: alpha.observe, beta: beta.observe })((v) => seen.push(v));
+        await flush();
+        expect(seen.at(-1)).toBe("x=1");
+        expect(alpha.active()).toBe(1); // callee subscribed back to the caller's arg observe
+        expect(beta.active()).toBe(1);
+        alpha.set(2);
+        await flush();
+        expect(seen.at(-1)).toBe("x=2");
+        beta.set("y");
+        await flush();
+        expect(seen.at(-1)).toBe("y=2");
+        // Unsubscribing the returned observe tears down the reverse subscriptions too.
+        un();
+        await flush();
+        expect(alpha.active()).toBe(0);
+        expect(beta.active()).toBe(0);
+        const count = seen.length;
+        alpha.set(99);
+        await flush();
+        expect(seen.length).toBe(count); // no further values after teardown
+        ea.close();
+        eb.close();
+    });
+    it("works over a real MessageChannel and releases providers on channel close", async () => {
+        const { port1, port2 } = new MessageChannel();
+        const ea = createRpcEndpoint(createMessagePortTransport(port1));
+        const eb = createRpcEndpoint(createMessagePortTransport(port2));
+        ea.expose("display", makeDisplay(), DisplayService.schema);
+        const svc = eb.consume("display", DisplayService.schema);
+        const alpha = tracked(10);
+        const beta = tracked("v");
+        const seen = [];
+        svc.display({ alpha: alpha.observe, beta: beta.observe })((v) => seen.push(v));
+        await flush();
+        expect(seen.at(-1)).toBe("v=10");
+        expect(alpha.active()).toBe(1);
+        // Closing the consuming endpoint releases the callee's reverse subscriptions.
+        eb.close();
+        await flush();
+        expect(alpha.active()).toBe(0);
+        expect(beta.active()).toBe(0);
+        ea.close();
+    });
+});
+//# sourceMappingURL=arg-observe.test.js.map

package/dist/arg-observe.test.js.map

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

package/dist/consume/caller-context.d.ts

@@ -0,0 +1,47 @@
+import type { Data } from "@adobe/data";
+import type { Notify } from "@adobe/data/observe";
+import type { Schema } from "@adobe/data/schema";
+import type { RpcMessage } from "../protocol.js";
+/** One in-flight promise call, awaiting a `resolve`/`reject` for its id. */
+export interface CallSlot {
+    readonly resolve: (value: Data) => void;
+    readonly reject: (error: unknown) => void;
+    timer?: ReturnType<typeof setTimeout>;
+}
+/** The result delivered to one awaited generator `pull`. */
+export type PullResult = {
+    readonly done: false;
+    readonly value: Data;
+} | {
+    readonly done: true;
+    readonly value: Data | undefined;
+} | {
+    readonly error: Error;
+};
+/** One live consumed generator: a FIFO of pull resolvers awaiting yield/done/throw. */
+export interface CallerGenSlot {
+    readonly pulls: Array<(result: PullResult) => void>;
+}
+/**
+ * The caller-side surface the consume wrappers write into. The endpoint owns
+ * these tables and settles them from incoming response messages; the wrappers
+ * only allocate an id, register a slot, and send a request. All tables are keyed
+ * by a LOCAL id — unique per-originator, separate from the host-side tables.
+ */
+export interface CallerContext {
+    readonly send: (msg: RpcMessage) => void;
+    readonly nextId: () => number;
+    readonly callPending: Map<number, CallSlot>;
+    readonly callerSubs: Map<number, Notify<Data>>;
+    readonly callerGens: Map<number, CallerGenSlot>;
+    readonly defaultTimeoutMs?: number;
+    readonly isClosed: () => boolean;
+    /**
+     * Transform outgoing args: replace any `Observe` (guided by `params`) with a
+     * ref the caller streams back on demand, tracked under `opId` for cleanup.
+     * Returns wire-safe `Data` args.
+     */
+    readonly marshalArgs: (args: readonly unknown[], params: readonly Schema[] | undefined, opId: number) => Data[];
+    /** Release the arg-observe providers registered for `opId` (call/subscription done). */
+    readonly releaseArgRefs: (opId: number) => void;
+}