@adobe/data-rpc 0.10.11

package/dist/create-endpoint.js

@@ -0,0 +1,462 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { marshalArgsWith, unmarshalArgsWith } from "./arg-marshal.js";
+import { reconstructError } from "./consume/reconstruct-error.js";
+import { marshalError } from "./host/marshal-error.js";
+import { synthesizeService } from "./consume/synthesize-service.js";
+import { handleHostRequest } from "./host/register-service.js";
+import { createIdAllocator } from "./id.js";
+import { RPC_PROTOCOL_VERSION } from "./protocol.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 function createRpcEndpoint(transport, options = {}) {
+    const nextId = createIdAllocator();
+    const canInvoke = options.canInvoke ?? (() => true);
+    const onError = options.onError ?? ((error) => console.error("[data-rpc]", error));
+    let closed = false;
+    const send = (msg) => {
+        if (!closed)
+            transport.send(msg);
+    };
+    // ---- argument-constructor state (REVERSE channel: an Observe/Promise/
+    //      AsyncGenerator passed as/inside a call argument is serviced from THIS
+    //      side, as caller, and reconstructed on THIS side, as callee) ----
+    // Caller role — providers we service on the peer's demand, keyed by our ref:
+    const argObserveProviders = new Map();
+    const argObserveSubs = new Map(); // sub → callee's live subscription
+    const argPromiseProviders = new Set(); // refs whose promise is still pending
+    const argGenProviders = new Map();
+    const callArgRefs = new Map(); // opId → arg refs to release when the op ends
+    // Callee role — local reconstructions of the peer's arg constructors, keyed by ref:
+    const hostArgObserveSubs = new Map(); // sub → our notify for a remote arg observe
+    const argPromiseWaiters = new Map();
+    const argGenSlots = new Map();
+    const trackRef = (opId, ref) => {
+        let refs = callArgRefs.get(opId);
+        if (refs === undefined) {
+            refs = new Set();
+            callArgRefs.set(opId, refs);
+        }
+        refs.add(ref);
+    };
+    const marshalArgs = (args, params, opId) => marshalArgsWith(args, params, {
+        observe: (obs) => {
+            const ref = nextId();
+            argObserveProviders.set(ref, obs);
+            trackRef(opId, ref);
+            return ref;
+        },
+        promise: (promise) => {
+            const ref = nextId();
+            argPromiseProviders.add(ref);
+            trackRef(opId, ref);
+            void promise.then((value) => { if (argPromiseProviders.delete(ref))
+                send({ kind: "arg-resolve", ref, value: value === undefined ? null : value }); }, (error) => { if (argPromiseProviders.delete(ref))
+                send({ kind: "arg-reject", ref, error: marshalError(error) }); });
+            return ref;
+        },
+        generator: (generator) => {
+            const ref = nextId();
+            argGenProviders.set(ref, generator);
+            trackRef(opId, ref);
+            return ref;
+        },
+    });
+    const releaseArgRefs = (opId) => {
+        const refs = callArgRefs.get(opId);
+        if (refs === undefined)
+            return;
+        callArgRefs.delete(opId);
+        for (const ref of refs) {
+            argObserveProviders.delete(ref);
+            for (const [sub, entry] of argObserveSubs) {
+                if (entry.ref === ref) {
+                    entry.unobserve();
+                    argObserveSubs.delete(sub);
+                }
+            }
+            // A still-pending promise arg is cancelled on the callee so its `await`
+            // can't hang after we stop servicing the ref.
+            if (argPromiseProviders.delete(ref)) {
+                send({ kind: "arg-reject", ref, error: { name: "RpcError", message: "data-rpc: argument cancelled — call completed" } });
+            }
+            const gen = argGenProviders.get(ref);
+            if (gen !== undefined) {
+                argGenProviders.delete(ref);
+                void gen.return(undefined).catch(() => undefined);
+                // Any later `arg-pull` for this ref is answered `arg-done` (below).
+            }
+        }
+    };
+    // Callee-role reconstruction of a remote arg-generator: pull-based, keyed by ref.
+    const makeArgGenerator = (ref) => {
+        const slot = { pulls: [] };
+        argGenSlots.set(ref, slot);
+        let finished = false;
+        const finish = () => {
+            finished = true;
+            argGenSlots.delete(ref);
+        };
+        const gen = {
+            async next() {
+                if (finished || closed) {
+                    finish();
+                    return { done: true, value: undefined };
+                }
+                send({ kind: "arg-pull", ref });
+                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) {
+                    finish();
+                    send({ kind: "arg-return", ref });
+                }
+                return { done: true, value: value };
+            },
+            async throw(error) {
+                if (!finished) {
+                    finish();
+                    send({ kind: "arg-raise", ref, error: marshalError(error) });
+                }
+                throw error;
+            },
+            [Symbol.asyncIterator]() { return this; },
+            async [Symbol.asyncDispose]() { await gen.return(undefined); },
+        };
+        return gen;
+    };
+    const unmarshalArgs = (args, params) => unmarshalArgsWith(args, params, {
+        observe: (ref) => (notify) => {
+            const sub = nextId();
+            hostArgObserveSubs.set(sub, notify);
+            send({ kind: "arg-subscribe", ref, sub });
+            return () => {
+                if (hostArgObserveSubs.delete(sub))
+                    send({ kind: "arg-unsubscribe", sub });
+            };
+        },
+        promise: (ref) => {
+            const promise = new Promise((resolve, reject) => argPromiseWaiters.set(ref, { resolve, reject }));
+            // Suppress an unhandledRejection if the member never awaits this arg
+            // (a rejection/cancellation still surfaces to any real `await`).
+            promise.catch(() => undefined);
+            return promise;
+        },
+        generator: (ref) => makeArgGenerator(ref),
+    });
+    // ---- host-side state (keyed by the REMOTE caller's id) ----
+    const exposed = new Map();
+    const hostSubs = new Map();
+    const hostGens = new Map();
+    const hostCtx = { send, exposed, hostSubs, hostGens, canInvoke, onError, unmarshalArgs };
+    // ---- caller-side state (keyed by a LOCAL id) ----
+    const callPending = new Map();
+    const callerSubs = new Map();
+    const callerGens = new Map();
+    const schemaPending = new Map();
+    const availableSchemas = new Map();
+    const awaiting = new Map();
+    const callerCtx = {
+        send,
+        nextId,
+        callPending,
+        callerSubs,
+        callerGens,
+        defaultTimeoutMs: options.defaultTimeoutMs,
+        isClosed: () => closed,
+        marshalArgs,
+        releaseArgRefs,
+    };
+    const flushAwaiting = (name, schema) => {
+        const waiters = awaiting.get(name);
+        if (waiters === undefined)
+            return;
+        awaiting.delete(name);
+        for (const w of waiters)
+            w(schema);
+    };
+    // ---- dispatcher ----
+    const unMessage = transport.onMessage((msg) => {
+        switch (msg.kind) {
+            case "hello": {
+                send({ kind: "welcome", protocol: RPC_PROTOCOL_VERSION });
+                // Re-announce everything already exposed for a peer that connected late.
+                for (const [name, ex] of exposed)
+                    send({ kind: "available", service: name, schema: ex.schema });
+                return;
+            }
+            case "welcome": {
+                if (msg.protocol !== RPC_PROTOCOL_VERSION) {
+                    onError(new Error(`data-rpc protocol mismatch: local ${RPC_PROTOCOL_VERSION}, peer ${msg.protocol}`));
+                }
+                return;
+            }
+            case "available": {
+                availableSchemas.set(msg.service, msg.schema);
+                flushAwaiting(msg.service, msg.schema);
+                return;
+            }
+            case "unavailable": {
+                availableSchemas.delete(msg.service);
+                return;
+            }
+            case "schema": {
+                const waiter = schemaPending.get(msg.id);
+                if (waiter !== undefined) {
+                    schemaPending.delete(msg.id);
+                    waiter(msg.schema);
+                }
+                return;
+            }
+            case "resolve": {
+                const slot = callPending.get(msg.id);
+                if (slot !== undefined) {
+                    if (slot.timer !== undefined)
+                        clearTimeout(slot.timer);
+                    callPending.delete(msg.id);
+                    releaseArgRefs(msg.id);
+                    slot.resolve(msg.value);
+                }
+                return;
+            }
+            case "reject": {
+                const slot = callPending.get(msg.id);
+                if (slot !== undefined) {
+                    if (slot.timer !== undefined)
+                        clearTimeout(slot.timer);
+                    callPending.delete(msg.id);
+                    releaseArgRefs(msg.id);
+                    slot.reject(reconstructError(msg.error));
+                }
+                return;
+            }
+            case "next": {
+                callerSubs.get(msg.id)?.(msg.value);
+                return;
+            }
+            case "yield":
+            case "done":
+            case "throw": {
+                const slot = callerGens.get(msg.id);
+                const resolvePull = slot?.pulls.shift();
+                if (resolvePull === undefined)
+                    return;
+                if (msg.kind === "yield")
+                    resolvePull({ done: false, value: msg.value });
+                else if (msg.kind === "done")
+                    resolvePull({ done: true, value: msg.value });
+                else
+                    resolvePull({ error: reconstructError(msg.error) });
+                return;
+            }
+            // ---- reverse channel: argument observes ----
+            case "arg-subscribe": {
+                // We are the CALLER: the callee wants to observe an arg we sent.
+                const provider = argObserveProviders.get(msg.ref);
+                if (provider === undefined)
+                    return; // ref already released / unknown
+                const unobserve = provider((value) => send({ kind: "arg-next", sub: msg.sub, value }));
+                argObserveSubs.set(msg.sub, { unobserve, ref: msg.ref });
+                return;
+            }
+            case "arg-next": {
+                // We are the CALLEE: a value arrived for a remote arg observe we subscribed to.
+                hostArgObserveSubs.get(msg.sub)?.(msg.value);
+                return;
+            }
+            case "arg-unsubscribe": {
+                // We are the CALLER: the callee unsubscribed from an arg observe.
+                const entry = argObserveSubs.get(msg.sub);
+                if (entry !== undefined) {
+                    entry.unobserve();
+                    argObserveSubs.delete(msg.sub);
+                }
+                return;
+            }
+            // ---- reverse channel: argument promises ----
+            case "arg-resolve": {
+                // We are the CALLEE: a remote arg promise settled.
+                const waiter = argPromiseWaiters.get(msg.ref);
+                if (waiter !== undefined) {
+                    argPromiseWaiters.delete(msg.ref);
+                    waiter.resolve(msg.value);
+                }
+                return;
+            }
+            case "arg-reject": {
+                const waiter = argPromiseWaiters.get(msg.ref);
+                if (waiter !== undefined) {
+                    argPromiseWaiters.delete(msg.ref);
+                    waiter.reject(reconstructError(msg.error));
+                }
+                return;
+            }
+            // ---- reverse channel: argument generators ----
+            case "arg-pull": {
+                // We are the CALLER: the callee pulled the next value from an arg generator.
+                const gen = argGenProviders.get(msg.ref);
+                if (gen === undefined) {
+                    // Provider released (op completed) or unknown — tell the callee it's done
+                    // so its `for await` terminates instead of hanging.
+                    send({ kind: "arg-done", ref: msg.ref });
+                    return;
+                }
+                gen.next().then((result) => {
+                    if (result.done) {
+                        argGenProviders.delete(msg.ref);
+                        send({ kind: "arg-done", ref: msg.ref, value: result.value ?? undefined });
+                    }
+                    else {
+                        send({ kind: "arg-yield", ref: msg.ref, value: result.value });
+                    }
+                }, (error) => {
+                    argGenProviders.delete(msg.ref);
+                    send({ kind: "arg-throw", ref: msg.ref, error: marshalError(error) });
+                });
+                return;
+            }
+            case "arg-yield":
+            case "arg-done":
+            case "arg-throw": {
+                // We are the CALLEE: a pull on a remote arg generator was answered.
+                const slot = argGenSlots.get(msg.ref);
+                const resolvePull = slot?.pulls.shift();
+                if (resolvePull === undefined)
+                    return;
+                if (msg.kind === "arg-yield")
+                    resolvePull({ done: false, value: msg.value });
+                else if (msg.kind === "arg-done")
+                    resolvePull({ done: true, value: msg.value });
+                else
+                    resolvePull({ error: reconstructError(msg.error) });
+                return;
+            }
+            case "arg-return": {
+                // We are the CALLER: the callee ended an arg generator early.
+                const gen = argGenProviders.get(msg.ref);
+                argGenProviders.delete(msg.ref);
+                void gen?.return(undefined).catch((error) => onError(error));
+                return;
+            }
+            case "arg-raise": {
+                const gen = argGenProviders.get(msg.ref);
+                argGenProviders.delete(msg.ref);
+                void gen?.throw(reconstructError(msg.error)).catch(() => undefined);
+                return;
+            }
+            default:
+                // A request kind — route to the host side.
+                handleHostRequest(hostCtx, msg);
+                return;
+        }
+    });
+    const teardown = () => {
+        if (closed)
+            return;
+        closed = true;
+        // Caller side: pending calls reject; observes drop (no error channel);
+        // generators end gracefully (pending pulls resolve `done`).
+        for (const [, slot] of callPending) {
+            if (slot.timer !== undefined)
+                clearTimeout(slot.timer);
+            slot.reject(new Error("data-rpc endpoint closed"));
+        }
+        callPending.clear();
+        callerSubs.clear();
+        for (const [, slot] of callerGens) {
+            for (const resolvePull of slot.pulls.splice(0))
+                resolvePull({ done: true, value: undefined });
+        }
+        callerGens.clear();
+        for (const [, waiter] of schemaPending)
+            waiter(null);
+        schemaPending.clear();
+        awaiting.clear();
+        // Host side: release every subscription and generator.
+        for (const [, unobserve] of hostSubs)
+            unobserve();
+        hostSubs.clear();
+        for (const [, gen] of hostGens)
+            void gen.return(undefined).catch(() => undefined);
+        hostGens.clear();
+        // Reverse channel: release every arg-constructor provider and reconstruction.
+        for (const [, entry] of argObserveSubs)
+            entry.unobserve();
+        argObserveSubs.clear();
+        argObserveProviders.clear();
+        argPromiseProviders.clear();
+        for (const [, gen] of argGenProviders)
+            void gen.return(undefined).catch(() => undefined);
+        argGenProviders.clear();
+        callArgRefs.clear();
+        hostArgObserveSubs.clear();
+        for (const [, waiter] of argPromiseWaiters)
+            waiter.reject(new Error("data-rpc endpoint closed"));
+        argPromiseWaiters.clear();
+        for (const [, slot] of argGenSlots) {
+            for (const resolvePull of slot.pulls.splice(0))
+                resolvePull({ done: true, value: undefined });
+        }
+        argGenSlots.clear();
+        unMessage();
+    };
+    transport.onClose(teardown);
+    // Initiate the handshake.
+    send({ kind: "hello", protocol: RPC_PROTOCOL_VERSION });
+    const expose = (name, service, schema) => {
+        // The type gate proves `schema` exactly describes `service`; store the plain schema.
+        const plainSchema = schema;
+        exposed.set(name, { service, schema: plainSchema });
+        send({ kind: "available", service: name, schema: plainSchema });
+        return () => {
+            if (exposed.delete(name))
+                send({ kind: "unavailable", service: name });
+        };
+    };
+    // Single implementation backing both `consume` overloads.
+    function consume(name, schema) {
+        if (schema !== undefined) {
+            return synthesizeService(callerCtx, name, schema);
+        }
+        const known = availableSchemas.get(name);
+        if (known !== undefined) {
+            return Promise.resolve(synthesizeService(callerCtx, name, known));
+        }
+        return new Promise((resolve) => {
+            const waiters = awaiting.get(name) ?? [];
+            waiters.push((s) => resolve(synthesizeService(callerCtx, name, s)));
+            awaiting.set(name, waiters);
+            // Proactively fetch in case the service is exposed but we missed the
+            // announcement (e.g. we connected after it was exposed).
+            const id = nextId();
+            schemaPending.set(id, (s) => {
+                if (s !== null) {
+                    availableSchemas.set(name, s);
+                    flushAwaiting(name, s);
+                }
+                // s === null: not yet exposed — keep waiting for a future `available`.
+            });
+            send({ kind: "get-schema", id, service: name });
+        });
+    }
+    return {
+        expose,
+        consume: consume,
+        close() {
+            teardown();
+            transport.close();
+        },
+    };
+}
+//# sourceMappingURL=create-endpoint.js.map

package/dist/create-endpoint.js.map

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

package/dist/endpoint.d.ts

@@ -0,0 +1,64 @@
+import { Schema } from "@adobe/data/schema";
+import { type Service } from "@adobe/data/service";
+import type { EquivalentTypes } from "@adobe/data/types";
+/**
+ * The `expose` gate: the schema must describe the service's members EXACTLY
+ * (same shape as `createLazy`'s check). This is what keeps the wire `Data`-only —
+ * describe members with `Data` leaves plus the `observe`/`promise`/`generator`/
+ * `function` constructors (an `Observe` argument is shimmed via the reverse
+ * channel; a genuinely non-`Data` leaf like `Response` would throw when marshaled).
+ */
+type SchemaDescribesService<T extends Service, S extends Schema> = EquivalentTypes<Schema.ToType<S>, Omit<T, keyof Service>>;
+/** Options for {@link createRpcEndpoint}. */
+export interface RpcEndpointOptions {
+    /**
+     * Authorization seam — return `false` to refuse a member call from the peer.
+     * Defaults to allow-all. This is where per-member policy (e.g.
+     * `Schema.resolveExternalInvocation`) drops in; it is SEPARATE from the
+     * argument validation the host always performs against `signature.parameters`.
+     */
+    readonly canInvoke?: (service: string, member: string) => boolean;
+    /**
+     * If set, a consumed promise call rejects after this many ms with no reply,
+     * so a wedged (but not closed) transport can't hang a call forever.
+     */
+    readonly defaultTimeoutMs?: number;
+    /**
+     * Receives errors that have no wire channel back to the caller — a throw in a
+     * host `void` handler, a refused/failed `subscribe`, or a generator cleanup
+     * failure. Defaults to `console.error`.
+     */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * A bidirectional RPC endpoint over one transport. Each endpoint can both
+ * `expose` local services to the peer and `consume` the peer's services; the
+ * channel is symmetric.
+ */
+export interface RpcEndpoint {
+    /**
+     * Expose a local service to the peer. The `schema` must be a valid
+     * `AsyncDataService` schema that EXACTLY describes `service` — this is what
+     * guarantees only `Data` ever crosses the wire; a mismatch is a compile
+     * error carrying an `__rpcError` marker. Returns a teardown that stops new
+     * calls (and announces the service unavailable).
+     */
+    expose<T extends Service, const S extends Schema>(name: string, service: T, schema: S & (SchemaDescribesService<T, S> extends true ? unknown : {
+        readonly __rpcError: "data-rpc: schema must describe the service exactly (Data leaves + observe/promise/generator/function constructors)";
+    })): () => void;
+    /**
+     * Consume a peer service using a compile-time schema constant — returns a
+     * fully-typed projected service synchronously. The returned type reflects
+     * `Schema.ToType<S>` (deep-readonly, defaults widened), not necessarily the
+     * peer's hand-authored interface.
+     */
+    consume<const S extends Schema>(name: string, schema: S): Schema.ToType<S> & Service;
+    /**
+     * Consume a peer service whose schema is fetched at runtime — resolves once
+     * the peer has exposed it (safe to call before the peer exposes).
+     */
+    consume(name: string): Promise<Service>;
+    /** Tear down the endpoint: reject pending calls, end subscriptions/generators, close the transport. */
+    close(): void;
+}
+export {};

package/dist/endpoint.js

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

package/dist/endpoint.js.map

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

package/dist/host/host-context.d.ts

@@ -0,0 +1,28 @@
+import type { Data } from "@adobe/data";
+import type { Unobserve } from "@adobe/data/observe";
+import type { Schema } from "@adobe/data/schema";
+import type { Service } from "@adobe/data/service";
+import type { RpcMessage } from "../protocol.js";
+/** One exposed service and the schema that describes (and validates) its surface. */
+export interface ExposedService {
+    readonly service: Service;
+    readonly schema: Schema;
+}
+/**
+ * The host-side surface the request handler operates on. `hostSubs`/`hostGens`
+ * are keyed by the REMOTE caller's id (separate from the local caller tables),
+ * so the same numeric id can be live in both directions without collision.
+ */
+export interface HostContext {
+    readonly send: (msg: RpcMessage) => void;
+    readonly exposed: Map<string, ExposedService>;
+    readonly hostSubs: Map<number, Unobserve>;
+    readonly hostGens: Map<number, AsyncGenerator<Data>>;
+    readonly canInvoke: (service: string, member: string) => boolean;
+    readonly onError: (error: unknown) => void;
+    /**
+     * Transform incoming args: reconstruct any arg-observe ref (guided by
+     * `params`) into a local `Observe` that pulls values back from the caller.
+     */
+    readonly unmarshalArgs: (args: readonly Data[], params: readonly Schema[] | undefined) => unknown[];
+}

package/dist/host/host-context.js

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

package/dist/host/host-context.js.map

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

package/dist/host/marshal-error.d.ts

@@ -0,0 +1,8 @@
+import type { RpcError } from "../protocol.js";
+/**
+ * Serialize a thrown value into the three wire-safe fields of {@link RpcError}.
+ * We never structured-clone the thrown value itself — that would drop its
+ * subclass prototype and any non-standard properties, and a non-`Error` throw
+ * (a string, an object) may not clone at all.
+ */
+export declare function marshalError(error: unknown): RpcError;

package/dist/host/marshal-error.js

@@ -0,0 +1,15 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Serialize a thrown value into the three wire-safe fields of {@link RpcError}.
+ * We never structured-clone the thrown value itself — that would drop its
+ * subclass prototype and any non-standard properties, and a non-`Error` throw
+ * (a string, an object) may not clone at all.
+ */
+export function marshalError(error) {
+    if (error instanceof Error) {
+        return { name: error.name, message: error.message, stack: error.stack };
+    }
+    // Non-Error throws (strings, plain objects): stringify into `message`.
+    return { name: "Error", message: typeof error === "string" ? error : String(error) };
+}
+//# sourceMappingURL=marshal-error.js.map

package/dist/host/marshal-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marshal-error.js","sourceRoot":"","sources":["../../src/host/marshal-error.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC5E,CAAC;IACD,uEAAuE;IACvE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACzF,CAAC"}

package/dist/host/register-service.d.ts

@@ -0,0 +1,10 @@
+import type { RpcMessage } from "../protocol.js";
+import type { HostContext } from "./host-context.js";
+/**
+ * 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 declare function handleHostRequest(ctx: HostContext, msg: RpcMessage): boolean;