@hediet/linkrpc-cli 0.0.3-next.20261023.3 → 0.0.3-next.20261024.1

package/README.md

@@ -793,6 +793,7 @@ initial document:
 | `connection notifications [--after n] [--wait 25s] [--follow]` | Read incoming remote notifications from the broker's bounded buffer. `--follow` emits one JSON object per line and can run alongside calls. |
 | `connection destroy`                                  | Stop the configured connection broker through its local overlay. |
 | `json-rpc-stdio <serviceId> [--params <json>]`         | In the Hub profile, expose `<serviceId>::jsonRpcConnection::connectRaw` as newline-delimited JSON-RPC on stdin/stdout. Diagnostics remain on stderr. |
+| `json-rpc-export --target-endpoint <uri> --serviceId <id> --path <path> ...` | In the Hub profile, export multiple JSON-RPC factories through one authenticated raw WebSocket listener. |
 
 The inherited `--schema <path-or-url>` option also overlays static
 `hubrpc.defaults`, `hubrpc.directory`, and `hubrpc.schemas` reflection for
@@ -812,6 +813,27 @@ frame, and each remote frame is written as one JSON line:
 hub --endpoint unix:/run/hub.sock json-rpc-stdio language-server
 ```
 
+`json-rpc-export` maps multiple Hub JSON-RPC services to distinct paths on one listener:
+
+```sh
+linkrpc hub json-rpc-export \
+  --target-endpoint "listen:ws://127.0.0.1:8123" \
+  --target-token "$EXPORT_TOKEN" \
+  --target-token-query-param tkn \
+  --serviceId foo --path /foo \
+  --serviceId bar --path /bar
+```
+
+Each `--serviceId` must be followed by its `--path`; a leading slash is optional. Missing pairs, duplicate paths, and unsupported endpoints fail before connecting to the Hub. Each WebSocket client opens an independent `<serviceId>::jsonRpcConnection::connectRaw` session, including clients on the same route. Requests, responses, notifications, and server-initiated requests pass unchanged, without a `hubrpc::initialize` handshake.
+
+The nonempty export token is separate from the source Hub credentials. Clients authenticate during the WebSocket upgrade with `Authorization: Bearer <token>` or a configured query parameter. Without `--target-token-query-param`, the accepted query names are `tkn` (VS Code sends its `connectionToken` under this name) and `token`. Supplying the repeatable option replaces those defaults: for example `--target-token-query-param connectionToken --target-token-query-param api_key` accepts either custom name. Bearer headers remain accepted. Exactly one credential is required: duplicate query parameters, multiple Authorization headers, or a header combined with a recognized query parameter are rejected, even if their values match. Unrecognized parameters are not credentials.
+
+Alternatively, configure the listener token in the target URI as `listen:ws://127.0.0.1:8123?token=...`; this configuration syntax is independent of the accepted client query names. Readiness output never includes the token. Unknown routes return 404 and missing/invalid/ambiguous credentials return 401 without opening an upstream session. Anyone holding this token can access all configured routes using the export process's Hub identity; use a narrowly scoped identity and protect the token. Client credentials are consumed by the listener and never forwarded to the upstream factory.
+
+Only `listen:ws://` TCP listeners are currently supported, not named pipes or TLS listeners. Bind loopback for local use. For remote access, terminate TLS in a trusted reverse proxy rather than sending tokens over unencrypted networks. The gateway limits connections to 100, frames to 16 MiB, and pending input per client to 32 MiB / 1024 frames; slow consumers and failed upstreams close only their own connection. Factories must open within 30 seconds.
+
+The command stays in the foreground until SIGINT/SIGTERM, then closes clients and the listener. Use the existing Hub daemon/service lifecycle to supervise it; this command neither installs a service nor starts remote AHP hosts. Diagnostics and the bound address (including an assigned port when using port 0) go to stderr.
+
 ### Participant proxy
 
 `proxy` stands in for a participant on the hub: the participant is either this

package/dist/chunks/{cli-B93twHKF.js → cli-CXAAnZDA.js}

@@ -1,4 +1,4 @@
-import { $ as requestTopologyAccess, B as proxyCommand, F as disconnectBroker, G as parseDuration, H as withStaticHubReflection, I as getBrokerStatus, L as readBrokerNotifications, M as readEndpointDiscovery, N as ContextStore, P as formatContextReference, Q as requestReflectionAccess, R as stopConnectionBroker, St as mcpForwardInterface, U as parseConnectionLimit, V as tunnelCommand, W as parseConnectionLimitMilliseconds, _t as validateValueAgainstSchema, a as resolveInvocationEndpoint, bt as parseParamOverride, c as resolveLocalEndpoint, ct as parsePrincipalSpec, dt as connectViaTransport, et as setupSigning, ft as resolveTargetEndpoint, gt as explainValidation, ht as describeSchema, i as resolveInvocationContext, it as walkHub, lt as connect, m as managedEndpointsInterface, mt as describeObjectParams, n as loadStaticHubSchema, nt as fetchSchema$1, o as resolveSigning, ot as logoutCliIdentity, pt as resolvedEndpointToConfig, q as resolveCliInvocation, r as resolveStaticHubSchemaSource, rt as findMethodInSchema, s as validationDefault, st as formatPrincipalSource, t as completeForLine, tt as fetchDefaults, ut as connectViaRootOverlay, xt as MethodRefWithOptHash, y as HubHome, yt as mergeParams, z as ConnectionBroker } from "./runComplete-C9LMCMk7.js";
+import { $ as requestTopologyAccess, B as proxyCommand, F as disconnectBroker, G as parseDuration, H as withStaticHubReflection, I as getBrokerStatus, L as readBrokerNotifications, M as readEndpointDiscovery, N as ContextStore, P as formatContextReference, Q as requestReflectionAccess, R as stopConnectionBroker, St as mcpForwardInterface, U as parseConnectionLimit, V as tunnelCommand, W as parseConnectionLimitMilliseconds, _t as validateValueAgainstSchema, a as resolveInvocationEndpoint, bt as parseParamOverride, c as resolveLocalEndpoint, ct as parsePrincipalSpec, dt as connectViaTransport, et as setupSigning, ft as resolveTargetEndpoint, gt as explainValidation, ht as describeSchema, i as resolveInvocationContext, it as walkHub, lt as connect, m as managedEndpointsInterface, mt as describeObjectParams, n as loadStaticHubSchema, nt as fetchSchema$1, o as resolveSigning, ot as logoutCliIdentity, pt as resolvedEndpointToConfig, q as resolveCliInvocation, r as resolveStaticHubSchemaSource, rt as findMethodInSchema, s as validationDefault, st as formatPrincipalSource, t as completeForLine, tt as fetchDefaults, ut as connectViaRootOverlay, xt as MethodRefWithOptHash, y as HubHome, yt as mergeParams, z as ConnectionBroker } from "./runComplete-M-eKaNkI.js";
 import { ErrorCode, INTERFACE_TEMPLATES_EXTENSION, LinkRpcConnection, RpcError, computeInterfaceHash, connectTransports, createSchemaToZod, directoryInterface, exportStaticHubSchema, generateTsContract, generateTsInterface, interfaceTemplateArgumentsEquivalent, interfaceTemplateMemberName, interfaceTemplatesEqual, isAssignable, jcsCanonicalize, matchParams, schemaToZod, validateInterfaceTemplates } from "@hediet/linkrpc";
 import { z } from "zod";
 import { WebSocketTransport, connectNdjson, connectToHub, formatEndpointUri, isHubEndpoint, openWebSocket, parseEndpointUri, runInitializeHandshake, traceMessageTransport as traceMessageTransport$1 } from "@hediet/linkrpc/node";
@@ -26,6 +26,7 @@ import { stdin, stdout } from "node:process";
 import { TrafficFlowAggregator, createTerminalConsentPrompt, formatFlowSummary } from "@hediet/linkrpc-hub";
 import { loadHubConfig, printHubConfigSchema } from "@hediet/linkrpc-hub/config-file";
 import { connectJsonRpcTransports, connectRawJsonRpcTransport, createNdjsonJsonRpcTransport, jsonRpcConnectionInterface } from "@hediet/linkrpc-infra/json-rpc";
+import { startJsonRpcWebSocketExport, validateJsonRpcExport } from "@hediet/linkrpc-infra/json-rpc/node";
 import { GRAPH_INTERFACE_TAG, IMMUTABLE_GRAPH_INTERFACE_ID, ROOT_WATCH_INTERFACE_ID, evaluateGraphPresentation, graphPresentationInterface, graphPresentationSchema, isGraphRef, standardGraphRuntimeOptions, validateGraphInterfaceSchema } from "@hediet/linkrpc-infra/graph";
 import React from "react";
 import { Box, Text, measureElement, render } from "ink";
@@ -406,7 +407,7 @@ function contextNamespace(reference) {
 async function useLocalManagement(start, action) {
 	const home = HubHome.resolve();
 	if (start) {
-		const { startDaemon, nodeDaemonLaunch } = await import("./src-CCyOTeN5.js");
+		const { startDaemon, nodeDaemonLaunch } = await import("./src-yrqRWXzG.js");
 		if (await startDaemon({
 			home,
 			launch: nodeDaemonLaunch(home)
@@ -426,7 +427,7 @@ async function useLocalManagement(start, action) {
 	}
 }
 async function restartLocalDaemon() {
-	const { startDaemon, stopDaemon, nodeDaemonLaunch } = await import("./src-CCyOTeN5.js");
+	const { startDaemon, stopDaemon, nodeDaemonLaunch } = await import("./src-yrqRWXzG.js");
 	const home = HubHome.resolve();
 	process.stderr.write("Restarting the local Hub daemon: clients will disconnect and managed workloads will stop. OS autostart settings are unchanged.\n");
 	await stopDaemon(home);
@@ -3510,6 +3511,36 @@ async function jsonRpcStdioCommand(options) {
 	stdio.close("closed");
 }
 //#endregion
+//#region src/commands/jsonRpcExport.ts
+/** Preserve option order so a missing path cannot shift subsequent service mappings. */
+var JsonRpcExportRoutes = class {
+	_routes = [];
+	_pendingService;
+	serviceId(value) {
+		if (this._pendingService !== void 0) throw new Error("Each --serviceId must be followed by --path.");
+		this._pendingService = value;
+	}
+	path(value) {
+		if (this._pendingService === void 0) throw new Error("--path must follow --serviceId.");
+		this._routes.push({
+			serviceId: this._pendingService,
+			path: value.startsWith("/") ? value : `/${value}`
+		});
+		this._pendingService = void 0;
+	}
+	getRoutes() {
+		if (this._pendingService !== void 0) throw new Error("Each --serviceId must be followed by --path.");
+		return this._routes;
+	}
+};
+async function jsonRpcExportCommand(options) {
+	const connection = new LinkRpcConnection(options.local.rpcChannel);
+	return startJsonRpcWebSocketExport({
+		...options,
+		openTransport: (serviceId, signal) => connectRawJsonRpcTransport(connection.service(serviceId).get(jsonRpcConnectionInterface), void 0, signal)
+	});
+}
+//#endregion
 //#region ../../node_modules/.pnpm/@vscode+observables@0.1.1-0/node_modules/@vscode/observables/dist/observableInternal/logging/logging.js
 let globalObservableLogger;
 function addLogger(logger) {
@@ -8953,6 +8984,40 @@ Batch options:
 		});
 	});
 	if (profile === "hub") {
+		const exportRoutes = new JsonRpcExportRoutes();
+		program.command("json-rpc-export").description("Export Hub JSON-RPC services through one authenticated raw WebSocket listener.").requiredOption("--target-endpoint <uri>", "Listener URI, e.g. listen:ws://127.0.0.1:8123").option("--target-token <token>", "Local client authentication token (or put token in target URI)").option("--target-token-query-param <name>", "Accepted token query parameter (repeatable; replaces defaults tkn and token)", collectOption).option("--serviceId <id>", "Begin a route; follow each occurrence with --path", (value) => {
+			exportRoutes.serviceId(value);
+			return value;
+		}).option("--path <path>", "Path for the preceding service ID; repeat pairs for multiple routes", (value) => {
+			exportRoutes.path(value);
+			return value;
+		}).action(async (opts) => {
+			const options = {
+				targetEndpoint: opts.targetEndpoint,
+				token: opts.targetToken,
+				tokenQueryParameters: opts.targetTokenQueryParam,
+				routes: exportRoutes.getRoutes()
+			};
+			validateJsonRpcExport(options);
+			const localEp = needEndpoint(endpoint);
+			const local = await connect(localEp, wireLog("hub"));
+			try {
+				reportIdentity(await setupSigning(local.channel, local.signing, getPrincipalSpec(), { negotiateHubCaps: isHubEndpoint(localEp) }));
+				const server = await jsonRpcExportCommand({
+					...options,
+					local,
+					onError: (error) => process.stderr.write(`linkrpc: ${error.message}\n`)
+				});
+				try {
+					process.stderr.write(`linkrpc: JSON-RPC export listening at ${server.endpoint}\n`);
+					await _untilSignalled();
+				} finally {
+					await server.close();
+				}
+			} finally {
+				local.close();
+			}
+		});
 		program.command("json-rpc-stdio <serviceId>").description("Expose <serviceId>::jsonRpcConnection::connectRaw as a newline-delimited JSON-RPC endpoint on this process's stdin/stdout.").option("--params <json>", "JSON value passed to the remote transport factory").action(async (serviceId, opts) => {
 			const localEp = needEndpoint(endpoint);
 			let params;
@@ -9017,11 +9082,16 @@ Batch options:
 			const remote = await connectTargetEndpoint(targetEp, serviceId);
 			try {
 				reportIdentity(await setupSigning(local.channel, local.signing, getPrincipalSpec(), { negotiateHubCaps: isHubEndpoint(localEp) }));
+				const lost = Promise.race([local.closed.then(() => "source"), remote.closed.then(() => "target")]).then((side) => {
+					process.stderr.write(`linkrpc: tunnel: the ${side} connection closed\n`);
+					process.exitCode = 1;
+				});
 				await tunnelCommand({
 					serviceId,
 					local,
 					remote,
-					bidi: cmdOpts.bidi
+					bidi: cmdOpts.bidi,
+					stop: Promise.race([lost, _untilSignalled()])
 				});
 			} finally {
 				remote.close();
@@ -9048,10 +9118,10 @@ Batch options:
 				const principal = typeof cmdOpts.signAs === "string" ? parsePrincipalSpec(cmdOpts.signAs) : getPrincipalSpec();
 				reportIdentity(await setupSigning(hub.channel, hub.signing, principal, { negotiateHubCaps: isHubEndpoint(localEp) }));
 			}
-			const participant = targetEp === void 0 ? await connectStdioParticipant() : {
-				connection: await connectTargetEndpoint(targetEp, cmdOpts.claim ?? ""),
-				closed: void 0
-			};
+			const participant = targetEp === void 0 ? await connectStdioParticipant() : await connectTargetEndpoint(targetEp, cmdOpts.claim ?? "").then((connection) => ({
+				connection,
+				closed: connection.closed
+			}));
 			try {
 				await proxyCommand({
 					hub,
@@ -9186,7 +9256,7 @@ Batch options:
 				process.once("SIGINT", onSignal);
 				process.once("SIGTERM", onSignal);
 				try {
-					const { runApprovalUi } = await import("./runApprovalUi-CNp2DhKG.js");
+					const { runApprovalUi } = await import("./runApprovalUi-BdPp7WNP.js");
 					await runApprovalUi({
 						client,
 						signal: stop.signal
@@ -9201,7 +9271,7 @@ Batch options:
 	registerViewCommands(program, (action) => withChannel(endpoint, getPrincipalSpec(), action));
 	program.command("ui").description("Launch the terminal UI (form-based browser of services + methods).").action(async () => {
 		const acquired = await acquireConnection(endpoint);
-		const { runUi } = await import("./runUi-B4rV3ZfF.js");
+		const { runUi } = await import("./runUi-Deeox_Ef.js");
 		try {
 			await runUi({
 				endpoint: acquired.ep,
@@ -9737,4 +9807,4 @@ function safeJson(value) {
 //#endregion
 export { formatCondition as _, formatCommandLegend as a, targetId as b, safeTerminalText as c, ObservablePromise as d, observableValue as f, resolveViewTarget as g, Disposable as h, dispatchHostKey as i, approvalDetailLines as l, derived as m, views as n, hostCommands as o, autorun as p, ViewFrame as r, matchesKey as s, runCli as t, ObservableLazyPromise as u, interfaceTarget as v, matchesTarget as y };
 
-//# sourceMappingURL=cli-B93twHKF.js.map
+//# sourceMappingURL=cli-CXAAnZDA.js.map