@adobe/data-rpc 0.10.11

package/dist/consume/caller-context.js

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

package/dist/consume/caller-context.js.map

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

package/dist/consume/make-generator.d.ts

@@ -0,0 +1,16 @@
+import type { Data } from "@adobe/data";
+import type { Schema } from "@adobe/data/schema";
+import type { CallerContext } from "./caller-context.js";
+/**
+ * Projects a remote async-generator member, strictly pull-based: the host does
+ * not advance until this side asks. The first `next()` sends `iterate` (once),
+ * then every `next()` sends one `pull` and awaits the matching
+ * `yield`/`done`/`throw`. Early `return()` / `await using` disposal sends
+ * `return`; a thrown `throw(e)` injects `raise` so the host generator's `finally`
+ * runs. Once terminated it never resurrects (mirrors the local lazy generator).
+ *
+ * If the endpoint closes mid-stream the pending pull resolves `done` and further
+ * `next()` calls return `done` — a graceful end (an `Observe`/generator has no
+ * error channel guaranteed across a dropped transport).
+ */
+export declare function makeGenerator(ctx: CallerContext, service: string, path: readonly string[], args: readonly unknown[], params?: readonly Schema[]): AsyncGenerator<Data>;

package/dist/consume/make-generator.js

@@ -0,0 +1,75 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { marshalError } from "../host/marshal-error.js";
+/**
+ * Projects a remote async-generator member, strictly pull-based: the host does
+ * not advance until this side asks. The first `next()` sends `iterate` (once),
+ * then every `next()` sends one `pull` and awaits the matching
+ * `yield`/`done`/`throw`. Early `return()` / `await using` disposal sends
+ * `return`; a thrown `throw(e)` injects `raise` so the host generator's `finally`
+ * runs. Once terminated it never resurrects (mirrors the local lazy generator).
+ *
+ * If the endpoint closes mid-stream the pending pull resolves `done` and further
+ * `next()` calls return `done` — a graceful end (an `Observe`/generator has no
+ * error channel guaranteed across a dropped transport).
+ */
+export function makeGenerator(ctx, service, path, args, params) {
+    const id = ctx.nextId();
+    const slot = { pulls: [] };
+    ctx.callerGens.set(id, slot);
+    let started = false;
+    let finished = false;
+    const finish = () => {
+        finished = true;
+        ctx.callerGens.delete(id);
+        ctx.releaseArgRefs(id);
+    };
+    const gen = {
+        async next() {
+            if (finished || ctx.isClosed()) {
+                finish();
+                return { done: true, value: undefined };
+            }
+            if (!started) {
+                started = true;
+                ctx.send({ kind: "iterate", id, service, path, args: ctx.marshalArgs(args, params, id) });
+            }
+            ctx.send({ kind: "pull", id });
+            const result = await new Promise((res) => slot.pulls.push(res));
+            if ("error" in result) {
+                finish();
+                throw result.error;
+            }
+            if (result.done) {
+                finish();
+                return { done: true, value: result.value };
+            }
+            return { done: false, value: result.value };
+        },
+        async return(value) {
+            if (!finished) {
+                const wasStarted = started;
+                finish();
+                if (wasStarted)
+                    ctx.send({ kind: "return", id });
+            }
+            return { done: true, value: value };
+        },
+        async throw(error) {
+            if (!finished) {
+                const wasStarted = started;
+                finish();
+                if (wasStarted)
+                    ctx.send({ kind: "raise", id, error: marshalError(error) });
+            }
+            throw error;
+        },
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+        async [Symbol.asyncDispose]() {
+            await gen.return(undefined);
+        },
+    };
+    return gen;
+}
+//# sourceMappingURL=make-generator.js.map

package/dist/consume/make-generator.js.map

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

package/dist/consume/make-observe.d.ts

@@ -0,0 +1,16 @@
+import type { Data } from "@adobe/data";
+import type { Observe } from "@adobe/data/observe";
+import type { Schema } from "@adobe/data/schema";
+import type { CallerContext } from "./caller-context.js";
+/**
+ * A local `Observe<Data>` that projects a remote observe member. On subscribe it
+ * allocates an id, marshals any observe-bearing args, registers the `notify`, and
+ * sends `subscribe`; each remote `next` for that id is routed back to `notify` by
+ * the endpoint. Unsubscribing deletes the id (so any `next` still in flight is
+ * dropped), sends `unsubscribe`, and releases any arg-observe providers.
+ *
+ * Unlike a local `Observe` (e.g. `Observe.fromConstant`, which notifies
+ * synchronously on subscribe), the FIRST value here necessarily arrives
+ * asynchronously — it is a round-trip over the transport.
+ */
+export declare function makeObserve(ctx: CallerContext, service: string, path: readonly string[], args: readonly unknown[], params?: readonly Schema[]): Observe<Data>;

package/dist/consume/make-observe.js

@@ -0,0 +1,29 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * A local `Observe<Data>` that projects a remote observe member. On subscribe it
+ * allocates an id, marshals any observe-bearing args, registers the `notify`, and
+ * sends `subscribe`; each remote `next` for that id is routed back to `notify` by
+ * the endpoint. Unsubscribing deletes the id (so any `next` still in flight is
+ * dropped), sends `unsubscribe`, and releases any arg-observe providers.
+ *
+ * Unlike a local `Observe` (e.g. `Observe.fromConstant`, which notifies
+ * synchronously on subscribe), the FIRST value here necessarily arrives
+ * asynchronously — it is a round-trip over the transport.
+ */
+export function makeObserve(ctx, service, path, args, params) {
+    return (notify) => {
+        if (ctx.isClosed())
+            return () => undefined;
+        const id = ctx.nextId();
+        const wireArgs = ctx.marshalArgs(args, params, id);
+        ctx.callerSubs.set(id, notify);
+        ctx.send({ kind: "subscribe", id, service, path, args: wireArgs });
+        return () => {
+            if (ctx.callerSubs.delete(id)) {
+                ctx.send({ kind: "unsubscribe", id });
+            }
+            ctx.releaseArgRefs(id);
+        };
+    };
+}
+//# sourceMappingURL=make-observe.js.map

package/dist/consume/make-observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-observe.js","sourceRoot":"","sources":["../../src/consume/make-observe.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAOvD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACvB,GAAkB,EAClB,OAAe,EACf,IAAuB,EACvB,IAAwB,EACxB,MAA0B;IAE1B,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,IAAI,GAAG,CAAC,QAAQ,EAAE;YAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnE,OAAO,GAAG,EAAE;YACR,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}

package/dist/consume/make-promise.d.ts

@@ -0,0 +1,12 @@
+import type { Data } from "@adobe/data";
+import type { Schema } from "@adobe/data/schema";
+import type { CallerContext } from "./caller-context.js";
+/**
+ * Projects a remote promise member: allocates an id, marshals any observe-bearing
+ * args, registers a pending slot, and sends `call`; the endpoint settles the slot
+ * from the matching `resolve`/`reject` and releases the arg-observe providers.
+ * When `defaultTimeoutMs` is set, a timer rejects the call (and releases providers)
+ * if no reply arrives — the host still runs to completion, but a wedged transport
+ * no longer hangs forever.
+ */
+export declare function makePromise(ctx: CallerContext, service: string, path: readonly string[], args: readonly unknown[], params?: readonly Schema[]): Promise<Data>;

package/dist/consume/make-promise.js

@@ -0,0 +1,32 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Projects a remote promise member: allocates an id, marshals any observe-bearing
+ * args, registers a pending slot, and sends `call`; the endpoint settles the slot
+ * from the matching `resolve`/`reject` and releases the arg-observe providers.
+ * When `defaultTimeoutMs` is set, a timer rejects the call (and releases providers)
+ * if no reply arrives — the host still runs to completion, but a wedged transport
+ * no longer hangs forever.
+ */
+export function makePromise(ctx, service, path, args, params) {
+    const label = `${service}.${path.join(".")}`;
+    return new Promise((resolve, reject) => {
+        if (ctx.isClosed()) {
+            reject(new Error(`rpc endpoint is closed (${label})`));
+            return;
+        }
+        const id = ctx.nextId();
+        const wireArgs = ctx.marshalArgs(args, params, id);
+        const slot = { resolve, reject };
+        if (ctx.defaultTimeoutMs !== undefined) {
+            slot.timer = setTimeout(() => {
+                if (ctx.callPending.delete(id)) {
+                    ctx.releaseArgRefs(id);
+                    reject(new Error(`rpc call ${label} timed out after ${ctx.defaultTimeoutMs}ms`));
+                }
+            }, ctx.defaultTimeoutMs);
+        }
+        ctx.callPending.set(id, slot);
+        ctx.send({ kind: "call", id, service, path, args: wireArgs });
+    });
+}
+//# sourceMappingURL=make-promise.js.map

package/dist/consume/make-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-promise.js","sourceRoot":"","sources":["../../src/consume/make-promise.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAMvD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACvB,GAAkB,EAClB,OAAe,EACf,IAAuB,EACvB,IAAwB,EACxB,MAA0B;IAE1B,MAAM,KAAK,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,KAAK,GAAG,CAAC,CAAC,CAAC;YACvD,OAAO;QACX,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3C,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzB,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC7B,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBACvB,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,oBAAoB,GAAG,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC;gBACrF,CAAC;YACL,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/consume/make-void.d.ts

@@ -0,0 +1,12 @@
+import type { Schema } from "@adobe/data/schema";
+import type { CallerContext } from "./caller-context.js";
+/**
+ * Projects a remote void member: fire-and-forget `send`, no reply. A throw inside
+ * the host handler has no wire channel back here — it is routed to the host
+ * endpoint's `onError`.
+ *
+ * NOTE: observe-bearing arguments to a void member cannot be released (there is
+ * no completion signal), so their providers live until the endpoint closes.
+ * Prefer a promise/observe/generator member when passing observe arguments.
+ */
+export declare function makeVoid(ctx: CallerContext, service: string, path: readonly string[], args: readonly unknown[], params?: readonly Schema[]): void;

package/dist/consume/make-void.js

@@ -0,0 +1,17 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Projects a remote void member: fire-and-forget `send`, no reply. A throw inside
+ * the host handler has no wire channel back here — it is routed to the host
+ * endpoint's `onError`.
+ *
+ * NOTE: observe-bearing arguments to a void member cannot be released (there is
+ * no completion signal), so their providers live until the endpoint closes.
+ * Prefer a promise/observe/generator member when passing observe arguments.
+ */
+export function makeVoid(ctx, service, path, args, params) {
+    if (ctx.isClosed())
+        return;
+    const id = ctx.nextId();
+    ctx.send({ kind: "send", id, service, path, args: ctx.marshalArgs(args, params, id) });
+}
+//# sourceMappingURL=make-void.js.map

package/dist/consume/make-void.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-void.js","sourceRoot":"","sources":["../../src/consume/make-void.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAKvD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CACpB,GAAkB,EAClB,OAAe,EACf,IAAuB,EACvB,IAAwB,EACxB,MAA0B;IAE1B,IAAI,GAAG,CAAC,QAAQ,EAAE;QAAE,OAAO;IAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IACxB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/consume/reconstruct-error.d.ts

@@ -0,0 +1,7 @@
+import type { RpcError } from "../protocol.js";
+/**
+ * Rebuild a local `Error` from a wire {@link RpcError}. The result is always a
+ * plain `Error` (the remote subclass is not reconstructable); `name` and the
+ * remote `stack` are preserved so logs point back at the true origin.
+ */
+export declare function reconstructError(error: RpcError): Error;

package/dist/consume/reconstruct-error.js

@@ -0,0 +1,14 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Rebuild a local `Error` from a wire {@link RpcError}. The result is always a
+ * plain `Error` (the remote subclass is not reconstructable); `name` and the
+ * remote `stack` are preserved so logs point back at the true origin.
+ */
+export function reconstructError(error) {
+    const e = new Error(error.message);
+    e.name = error.name;
+    if (error.stack !== undefined)
+        e.stack = error.stack;
+    return e;
+}
+//# sourceMappingURL=reconstruct-error.js.map

package/dist/consume/reconstruct-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconstruct-error.js","sourceRoot":"","sources":["../../src/consume/reconstruct-error.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC5C,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACrD,OAAO,CAAC,CAAC;AACb,CAAC"}

package/dist/consume/synthesize-service.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from "@adobe/data/schema";
+import { type Service } from "@adobe/data/service";
+import type { CallerContext } from "./caller-context.js";
+/**
+ * Builds an equivalent-shaped local service from a peer service's schema. The
+ * `schema` slot republishes the schema as a constant observable, so the projected
+ * service is introspectable exactly like any other. Nested services are shimmed
+ * on both sides so their members are reachable transparently.
+ */
+export declare function synthesizeService(ctx: CallerContext, name: string, schema: Schema): Service;

package/dist/consume/synthesize-service.js

@@ -0,0 +1,77 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Observe } from "@adobe/data/observe";
+import { AsyncDataService } from "@adobe/data/service";
+import { isPureDataSchema } from "../arg-marshal.js";
+import { makeObserve } from "./make-observe.js";
+import { makePromise } from "./make-promise.js";
+import { makeGenerator } from "./make-generator.js";
+import { makeVoid } from "./make-void.js";
+/**
+ * Recursively shim a service's members from its schema. Each described member is
+ * either a LEAF (`observe`/`function`, classified with the same `memberKind` the
+ * local lazy wrapper uses and wrapped to forward over the transport) or a NESTED
+ * service (a child `object` schema with its own `properties`), which is shimmed
+ * as a matching nested object. Every leaf is addressed by its full `path` from
+ * the service root, so nested members round-trip exactly like top-level ones.
+ */
+function buildMembers(ctx, service, properties, path) {
+    const out = {};
+    for (const [key, member] of Object.entries(properties)) {
+        const memberPath = [...path, key];
+        if (member.type === "observe" || member.type === "function") {
+            const kind = AsyncDataService.memberKind(member);
+            const params = member.signature?.parameters;
+            switch (kind) {
+                case "observe":
+                    out[key] = makeObserve(ctx, service, memberPath, []);
+                    break;
+                case "fn:observe":
+                    out[key] = (...args) => makeObserve(ctx, service, memberPath, args, params);
+                    break;
+                case "fn:promise":
+                    out[key] = (...args) => makePromise(ctx, service, memberPath, args, params);
+                    break;
+                case "fn:generator":
+                    out[key] = (...args) => makeGenerator(ctx, service, memberPath, args, params);
+                    break;
+                case "fn:void":
+                    // A void member has no completion signal, so it can't release
+                    // arg-constructor providers — reject them rather than leak.
+                    if ((params ?? []).some((p) => !isPureDataSchema(p))) {
+                        const label = memberPath.join(".");
+                        out[key] = () => {
+                            throw new Error(`data-rpc: void member "${label}" cannot take Observe/Promise/AsyncGenerator arguments — use a promise/observe/generator member`);
+                        };
+                    }
+                    else {
+                        out[key] = (...args) => makeVoid(ctx, service, memberPath, args, params);
+                    }
+                    break;
+            }
+        }
+        else if (member.type === "object" || member.properties !== undefined) {
+            // Nested service — shim its members recursively under the extended path.
+            out[key] = buildMembers(ctx, service, member.properties ?? {}, memberPath);
+        }
+        else {
+            // Not a leaf and not a container — let memberKind raise the precise error.
+            AsyncDataService.memberKind(member);
+        }
+    }
+    return out;
+}
+/**
+ * Builds an equivalent-shaped local service from a peer service's schema. The
+ * `schema` slot republishes the schema as a constant observable, so the projected
+ * service is introspectable exactly like any other. Nested services are shimmed
+ * on both sides so their members are reachable transparently.
+ */
+export function synthesizeService(ctx, name, schema) {
+    const service = {
+        serviceName: `rpc:${name}`,
+        schema: Observe.fromConstant(schema),
+        ...buildMembers(ctx, name, schema.properties ?? {}, []),
+    };
+    return service;
+}
+//# sourceMappingURL=synthesize-service.js.map

package/dist/consume/synthesize-service.js.map

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

package/dist/create-endpoint.d.ts

@@ -0,0 +1,8 @@
+import type { RpcEndpoint, RpcEndpointOptions } from "./endpoint.js";
+import type { RpcTransport } from "./transport.js";
+/**
+ * Create a bidirectional RPC endpoint over `transport`. Sends a `hello`
+ * handshake immediately; re-announces exposed services whenever the peer says
+ * `hello`, so services exposed before the peer connected are still discovered.
+ */
+export declare function createRpcEndpoint(transport: RpcTransport, options?: RpcEndpointOptions): RpcEndpoint;