localpreview 0.2.4 → 0.2.6

package/dist/capture-route.d.ts

@@ -26,6 +26,7 @@ export type ResolvedRoute = {
     readonly kind: "capture";
     readonly target: TunnelTarget;
 } | {
+    readonly capturePath: ParsedCapturePath;
     readonly kind: "invalid-capture";
     readonly message: string;
 } | {

package/dist/capture-route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-route.d.ts","sourceRoot":"","sources":["../src/capture-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,sBAAsB,GACvB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,sBA+CtD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,QAAQ,iBAAiB,KAAG,MAC6B,CAAC;AAEvG,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MACA,CAAC;AAE1D,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEN,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,eAAe,YAAY,EAC3B,UAAU,aAAa,CAAC,aAAa,CAAC,KACrC,aAyBF,CAAC"}
+{"version":3,"file":"capture-route.d.ts","sourceRoot":"","sources":["../src/capture-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,mBAAmB,4BAA4B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;CAC7C,CAAC;AAEF,KAAK,sBAAsB,GACvB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,KAAG,sBA+CtD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,4BAA4B,GAAI,QAAQ,iBAAiB,KAAG,MAC6B,CAAC;AAEvG,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MACA,CAAC;AAE1D,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,GACD;IACE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEN,qFAAqF;AACrF,eAAO,MAAM,YAAY,GACvB,aAAa,MAAM,EACnB,eAAe,YAAY,EAC3B,UAAU,aAAa,CAAC,aAAa,CAAC,KACrC,aA0BF,CAAC"}

package/dist/capture-route.js

@@ -59,6 +59,7 @@ export const resolveRoute = (requestPath, primaryTarget, captures) => {
     const capture = findCapture(captures, parsed.hostname, parsed.port);
     if (capture === undefined) {
         return {
+            capturePath: parsed,
             kind: "invalid-capture",
             message: `Capture route is not allowlisted: ${parsed.hostname}:${parsed.port}.`,
         };

package/dist/capture-shim.d.ts

@@ -1,8 +1,12 @@
 import type { CaptureTarget } from "@localpreview/protocol";
 import { encodeCaptureHostname } from "./capture-route.js";
 export { encodeCaptureHostname };
+type CaptureShimPrimaryTarget = {
+    readonly hostname: string;
+    readonly port: number;
+};
 /** Generates the inline browser shim injected into proxied HTML responses. */
-export declare const buildCaptureShimScript: (captures: ReadonlyArray<CaptureTarget>) => string;
+export declare const buildCaptureShimScript: (primary: CaptureShimPrimaryTarget, captures: ReadonlyArray<CaptureTarget>) => string;
 /** Injects the capture shim into an HTML document string. */
 export declare const injectCaptureShim: (html: string, shimScript: string) => string;
 /** Returns true when the response looks like HTML suitable for shim injection. */

package/dist/capture-shim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-shim.d.ts","sourceRoot":"","sources":["../src/capture-shim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAuB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,GAAI,UAAU,aAAa,CAAC,aAAa,CAAC,KAAG,MAU/E,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAY,MAAM,KAAG,MAcpE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,GAAG,IAAI,KAAG,OACa,CAAC;AAE1E,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,GACrC,SAAS,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAChD,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9B,CAAC;AAEL,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,GAAI,QAAQ;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC,KAAG,MAAkE,CAAC"}
+{"version":3,"file":"capture-shim.d.ts","sourceRoot":"","sources":["../src/capture-shim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAuB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,GACjC,SAAS,wBAAwB,EACjC,UAAU,aAAa,CAAC,aAAa,CAAC,KACrC,MAWF,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,YAAY,MAAM,KAAG,MAcpE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,GAAG,IAAI,KAAG,OACa,CAAC;AAE1E,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,GACrC,SAAS,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAChD,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAI9B,CAAC;AAEL,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,GAAI,QAAQ;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC,KAAG,MAAkE,CAAC"}

package/dist/capture-shim.js

@@ -1,15 +1,16 @@
 import { CAPTURE_PATH_PREFIX, encodeCaptureHostname } from "./capture-route.js";
 export { encodeCaptureHostname };
 /** Generates the inline browser shim injected into proxied HTML responses. */
-export const buildCaptureShimScript = (captures) => {
+export const buildCaptureShimScript = (primary, captures) => {
     const config = JSON.stringify({
         captures: captures.map((capture) => ({
             hostname: capture.hostname,
             port: capture.port,
         })),
         prefix: CAPTURE_PATH_PREFIX,
+        primary,
     });
-    return `(function(){var cfg=${config};var caps=cfg.captures;var prefix=cfg.prefix;function normHost(h){return h==="::1"?"[::1]":h.toLowerCase();}function matchesCapture(url){var host=normHost(url.hostname);var port=url.port?Number(url.port):(url.protocol==="https:"?443:80);for(var i=0;i<caps.length;i++){var cap=caps[i];if(normHost(cap.hostname)===host&&cap.port===port){return true;}}return false;}function rewriteUrl(input){var url=new URL(input,window.location.href);if(!matchesCapture(url)){return input;}var proto=url.protocol.replace(":","");var host=encodeURIComponent(normHost(url.hostname));var path=url.pathname+url.search;return prefix+"/"+proto+"/"+host+"/"+url.port+path;}function warnUnsupported(api,url){console.error("[localpreview] "+api+" to captured local backend is not supported in v1: "+url+". Use fetch/XHR or run localpreview connect for that service directly.");}var origFetch=window.fetch;window.fetch=function(input,init){try{var url=typeof input==="string"?input:input instanceof URL?input.href:input.url;if(typeof url==="string"&&/^https?:\\/\\//.test(url)){var rewritten=rewriteUrl(url);if(rewritten!==url){return origFetch.call(this,rewritten,init);}}}catch(e){}return origFetch.call(this,input,init);};if(typeof XMLHttpRequest!=="undefined"){var origOpen=XMLHttpRequest.prototype.open;XMLHttpRequest.prototype.open=function(method,url){try{if(typeof url==="string"&&/^https?:\\/\\//.test(url)){var rewritten=rewriteUrl(url);if(rewritten!==url){return origOpen.call(this,method,rewritten);}}}catch(e){}return origOpen.apply(this,arguments);};}if(typeof window.WebSocket!=="undefined"){var OrigWebSocket=window.WebSocket;window.WebSocket=function(url,protocols){try{var parsed=new URL(url,window.location.href);if(matchesCapture(parsed)){warnUnsupported("WebSocket",url);throw new Error("LocalPreview does not proxy WebSocket connections to captured backends in v1.");}}catch(e){if(e instanceof Error&&e.message.indexOf("LocalPreview")!==-1){throw e;}}return protocols===undefined?new OrigWebSocket(url):new OrigWebSocket(url,protocols);};if(OrigWebSocket.prototype){window.WebSocket.prototype=OrigWebSocket.prototype;}}if(typeof window.EventSource!=="undefined"){var OrigEventSource=window.EventSource;window.EventSource=function(url,init){try{var parsed=new URL(url,window.location.href);if(matchesCapture(parsed)){warnUnsupported("EventSource",url);throw new Error("LocalPreview does not proxy EventSource connections to captured backends in v1.");}}catch(e){if(e instanceof Error&&e.message.indexOf("LocalPreview")!==-1){throw e;}}return init===undefined?new OrigEventSource(url):new OrigEventSource(url,init);};if(OrigEventSource.prototype){window.EventSource.prototype=OrigEventSource.prototype;}}})();`;
+    return `(function(){var cfg=${config};var caps=cfg.captures;var primary=cfg.primary;var prefix=cfg.prefix;var eventsPath="/__localpreview/events";var reported={};function normHost(h){return h==="::1"?"[::1]":h.toLowerCase();}function isLoopbackHost(h){var lower=normHost(h);if(lower==="localhost"||lower==="127.0.0.1"||lower==="[::1]")return true;return lower.endsWith(".localhost");}function loopbackGroup(h){var lower=normHost(h);if(lower==="localhost"||lower==="127.0.0.1"||lower==="[::1]")return "__loopback__";return lower;}function sameLoopbackPort(host,port,otherHost,otherPort){return port===otherPort&&loopbackGroup(host)===loopbackGroup(otherHost);}function dedupeKey(proto,host,port){var group=loopbackGroup(host);return proto+"://"+(group==="__loopback__"?group:normHost(host))+":"+port;}function urlPort(url){return url.port?Number(url.port):(url.protocol==="https:"||url.protocol==="wss:"?443:80);}function matchesCapture(url){var host=normHost(url.hostname);var port=urlPort(url);for(var i=0;i<caps.length;i++){var cap=caps[i];if(sameLoopbackPort(host,port,cap.hostname,cap.port))return true;}return false;}function isPrimaryPort(url){return sameLoopbackPort(url.hostname,urlPort(url),primary.hostname,primary.port);}function isAllowlisted(url){return matchesCapture(url)||isPrimaryPort(url);}function reportMissing(url,transport,method){try{if(!isLoopbackHost(url.hostname))return;if(isAllowlisted(url))return;var proto=url.protocol.replace(":","");if(proto!=="http"&&proto!=="https"&&proto!=="ws"&&proto!=="wss")return;var host=normHost(url.hostname);var port=urlPort(url);var key=dedupeKey(proto,host,port);if(reported[key])return;reported[key]=true;var payload={protocol:proto,hostname:host,port:port,transport:transport};if(typeof method==="string"&&method){payload.method=method;}var body=JSON.stringify({type:"missing-capture",payload:payload});if(typeof navigator!=="undefined"&&navigator.sendBeacon){navigator.sendBeacon(eventsPath,body);}else{fetch(eventsPath,{method:"POST",body:body,keepalive:true});}}catch(e){}}function rewriteUrl(input){var url=new URL(input,window.location.href);if(!matchesCapture(url)){return input;}var proto=url.protocol.replace(":","");var host=encodeURIComponent(normHost(url.hostname));var path=url.pathname+url.search;return prefix+"/"+proto+"/"+host+"/"+url.port+path;}function warnUnsupported(api,url){console.error("[localpreview] "+api+" to captured local backend is not supported in v1: "+url+". Use fetch/XHR or run localpreview connect for that service directly.");}function fetchMethod(input,init){if(init&&typeof init==="object"&&typeof init.method==="string")return init.method.toUpperCase();if(typeof Request!=="undefined"&&input instanceof Request)return input.method.toUpperCase();return "GET";}var origFetch=window.fetch;window.fetch=function(input,init){try{var url=typeof input==="string"?input:input instanceof URL?input.href:input.url;if(typeof url==="string"&&/^https?:\\/\\//.test(url)){var parsed=new URL(url,window.location.href);reportMissing(parsed,"fetch",fetchMethod(input,init));var rewritten=rewriteUrl(url);if(rewritten!==url){return origFetch.call(this,rewritten,init);}}}catch(e){}return origFetch.call(this,input,init);};if(typeof XMLHttpRequest!=="undefined"){var origOpen=XMLHttpRequest.prototype.open;XMLHttpRequest.prototype.open=function(method,url){try{if(typeof url==="string"&&/^https?:\\/\\//.test(url)){var parsed=new URL(url,window.location.href);reportMissing(parsed,"xhr",typeof method==="string"?method.toUpperCase():undefined);var rewritten=rewriteUrl(url);if(rewritten!==url){return origOpen.call(this,method,rewritten);}}}catch(e){}return origOpen.apply(this,arguments);};}if(typeof window.WebSocket!=="undefined"){var OrigWebSocket=window.WebSocket;window.WebSocket=function(url,protocols){try{var parsed=new URL(url,window.location.href);reportMissing(parsed,"websocket");if(matchesCapture(parsed)){warnUnsupported("WebSocket",url);throw new Error("LocalPreview does not proxy WebSocket connections to captured backends in v1.");}}catch(e){if(e instanceof Error&&e.message.indexOf("LocalPreview")!==-1){throw e;}}return protocols===undefined?new OrigWebSocket(url):new OrigWebSocket(url,protocols);};if(OrigWebSocket.prototype){window.WebSocket.prototype=OrigWebSocket.prototype;}}if(typeof window.EventSource!=="undefined"){var OrigEventSource=window.EventSource;window.EventSource=function(url,init){try{var parsed=new URL(url,window.location.href);reportMissing(parsed,"eventsource");if(matchesCapture(parsed)){warnUnsupported("EventSource",url);throw new Error("LocalPreview does not proxy EventSource connections to captured backends in v1.");}}catch(e){if(e instanceof Error&&e.message.indexOf("LocalPreview")!==-1){throw e;}}return init===undefined?new OrigEventSource(url):new OrigEventSource(url,init);};if(OrigEventSource.prototype){window.EventSource.prototype=OrigEventSource.prototype;}}})();`;
 };
 /** Injects the capture shim into an HTML document string. */
 export const injectCaptureShim = (html, shimScript) => {

package/dist/cli-ui.d.ts

@@ -6,8 +6,22 @@ export declare const formatCliError: (message: string) => string;
 export declare const formatStatus: (message: string) => string;
 export declare const formatRelayReconnect: (message: string) => string;
 export declare const formatRequestOutbound: (method: string, path: string) => string;
+export declare const formatCapturedRequestOutbound: (method: string, targetUrl: string) => string;
 export declare const formatRequestInbound: (status: number, path: string, durationMs: number) => string;
+export declare const formatCapturedRequestInbound: (status: number, targetUrl: string, durationMs: number) => string;
+export declare const formatMissingCaptureWarning: (options: {
+    readonly origin: string;
+    readonly method?: string;
+    readonly suggestedCommand: string;
+    readonly transport?: string;
+}) => string;
 export declare const formatRequestError: (path: string, message: string) => string;
+export declare const formatInvalidCaptureRouteError: (options: {
+    readonly hostname: string;
+    readonly method: string;
+    readonly path: string;
+    readonly port: number;
+}) => string;
 export declare const removedAdminTokenFlagMessage: () => string;
 export declare const adminTokenRequiredMessage: () => string;
 export type HelpRenderOptions = {

package/dist/cli-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-ui.d.ts","sourceRoot":"","sources":["../src/cli-ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,wBAAwB,CAAC;AAIlF,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,OAGzE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MAQ/C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAQhD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAM9C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MACT,CAAC;AAE/C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MASpE,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,YAAY,MAAM,KACjB,MAWF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MASlE,CAAC;AAKF,eAAO,MAAM,4BAA4B,QAAO,MAA0C,CAAC;AAE3F,eAAO,MAAM,yBAAyB,QAAO,MACkD,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,CAAC;AAiDF,eAAO,MAAM,gBAAgB,GAAI,UAAS,iBAAsB,KAAG,MASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,MAuBjC,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,UAAS,iBAAsB,KAAG,MAmCjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,UAAS,iBAAsB,KAAG,MAiChE,CAAC;AAaF,eAAO,MAAM,uBAAuB,GAAI,UAAU,mBAAmB,KAAG,MA0DvE,CAAC;AAwCF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,GAAG,SAAS,KAAG,MA0BlE,CAAC"}
+{"version":3,"file":"cli-ui.d.ts","sourceRoot":"","sources":["../src/cli-ui.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,wBAAwB,CAAC;AAIlF,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,OAGzE,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MAQ/C,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAQhD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAM9C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MACT,CAAC;AAE/C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,KAAG,MASpE,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,MAUjF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,YAAY,MAAM,KAAG,MAgBvF,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,KACjB,MAiBF,CAAC;AAIF,eAAO,MAAM,2BAA2B,GAAI,SAAS;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,KAAG,MAiBH,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MASlE,CAAC;AAEF,eAAO,MAAM,8BAA8B,GAAI,SAAS;IACtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KAAG,MAaH,CAAC;AAKF,eAAO,MAAM,4BAA4B,QAAO,MAA0C,CAAC;AAE3F,eAAO,MAAM,yBAAyB,QAAO,MACkD,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,CAAC;AAiDF,eAAO,MAAM,gBAAgB,GAAI,UAAS,iBAAsB,KAAG,MASlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,MAuBjC,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,UAAS,iBAAsB,KAAG,MA+BjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,UAAS,iBAAsB,KAAG,MA+BhE,CAAC;AAcF,eAAO,MAAM,uBAAuB,GAAI,UAAU,mBAAmB,KAAG,MAkEvE,CAAC;AAyCF,eAAO,MAAM,gBAAgB,GAAI,aAAa,MAAM,GAAG,SAAS,KAAG,MA0BlE,CAAC"}

package/dist/cli-ui.js

@@ -35,15 +35,58 @@ export const formatRequestOutbound = (method, path) => {
     }
     return `${pc.dim(arrow)} ${pc.bold(method)} ${path}`;
 };
+export const formatCapturedRequestOutbound = (method, targetUrl) => {
+    const arrow = "→";
+    const label = "CAPTURED";
+    const line = `${arrow} ${label} ${method} ${targetUrl}`;
+    if (!pc.isColorSupported) {
+        return line;
+    }
+    return `${pc.dim(arrow)} ${formatCaptureBadge(label)} ${pc.bold(method)} ${targetUrl}`;
+};
 export const formatRequestInbound = (status, path, durationMs) => {
     const arrow = "←";
     const line = `${arrow} ${status} ${path} ${durationMs}ms`;
     if (!pc.isColorSupported) {
         return line;
     }
-    const statusText = status >= 500 ? pc.red(String(status)) : status >= 400 ? pc.yellow(String(status)) : pc.green(String(status));
+    const statusText = status >= 500
+        ? pc.red(String(status))
+        : status >= 400
+            ? pc.yellow(String(status))
+            : pc.green(String(status));
     return `${pc.dim(arrow)} ${statusText} ${path} ${pc.dim(`${durationMs}ms`)}`;
 };
+export const formatCapturedRequestInbound = (status, targetUrl, durationMs) => {
+    const arrow = "←";
+    const label = "CAPTURED";
+    const line = `${arrow} ${label} ${status} ${targetUrl} ${durationMs}ms`;
+    if (!pc.isColorSupported) {
+        return line;
+    }
+    const statusText = status >= 500
+        ? pc.red(String(status))
+        : status >= 400
+            ? pc.yellow(String(status))
+            : pc.green(String(status));
+    return `${pc.dim(arrow)} ${formatCaptureBadge(label)} ${statusText} ${targetUrl} ${pc.dim(`${durationMs}ms`)}`;
+};
+const formatCaptureBadge = (label) => pc.yellow(pc.dim(` ${label} `));
+export const formatMissingCaptureWarning = (options) => {
+    const transportNote = options.transport === "websocket" || options.transport === "eventsource"
+        ? " WebSocket/EventSource may still fail in preview."
+        : "";
+    const arrow = "←";
+    const requestLabel = options.method ?? options.transport ?? "request";
+    const lines = [
+        `${arrow} ${requestLabel} ${options.origin}`,
+        `  Browser tried to reach uncaptured loopback backend ${options.origin}. Restart with: ${options.suggestedCommand}.${transportNote}`,
+    ];
+    if (!pc.isColorSupported) {
+        return lines.join("\n");
+    }
+    return lines.map((line) => pc.red(line)).join("\n");
+};
 export const formatRequestError = (path, message) => {
     const arrow = "←";
     const line = `${arrow} error ${path} ${message}`;
@@ -52,6 +95,18 @@ export const formatRequestError = (path, message) => {
     }
     return `${pc.dim(arrow)} ${pc.red("error")} ${path} ${pc.red(message)}`;
 };
+export const formatInvalidCaptureRouteError = (options) => {
+    const arrow = "←";
+    const origin = `${options.hostname}:${options.port}`;
+    const lines = [
+        `${arrow} ${options.method} ${options.path}`,
+        `  Browser tried to reach blocked loopback backend ${origin}. Allow it with --capture ${origin}.`,
+    ];
+    if (!pc.isColorSupported) {
+        return lines.join("\n");
+    }
+    return lines.map((line) => pc.red(line)).join("\n");
+};
 const REMOVED_ADMIN_TOKEN_FLAG_MESSAGE = "The --admin-token flag was removed. Set the LOCALPREVIEW_ADMIN_TOKEN environment variable instead.";
 export const removedAdminTokenFlagMessage = () => REMOVED_ADMIN_TOKEN_FLAG_MESSAGE;
 export const adminTokenRequiredMessage = () => `Admin commands require ${ADMIN_TOKEN_ENV}. Export it in your shell, then rerun the command.`;
@@ -126,11 +181,7 @@ export const renderConnectHelp = () => joinLines([
 export const renderCleanHelp = (options = {}) => {
     const env = options.env ?? process.env;
     if (!hasAdminTokenInEnv(env)) {
-        return joinLines([
-            renderGlobalHelp(options),
-            "",
-            adminTokenRequiredMessage(),
-        ]);
+        return joinLines([renderGlobalHelp(options), "", adminTokenRequiredMessage()]);
     }
     return joinLines([
         heading("localpreview clean — admin subdomain cleanup"),
@@ -160,11 +211,7 @@ export const renderCleanHelp = (options = {}) => {
 export const renderListHelp = (options = {}) => {
     const env = options.env ?? process.env;
     if (!hasAdminTokenInEnv(env)) {
-        return joinLines([
-            renderGlobalHelp(options),
-            "",
-            adminTokenRequiredMessage(),
-        ]);
+        return joinLines([renderGlobalHelp(options), "", adminTokenRequiredMessage()]);
     }
     return joinLines([
         heading("localpreview list — inspect tunnel inventory"),
@@ -191,6 +238,7 @@ export const renderListHelp = (options = {}) => {
 };
 const LIST_COLUMNS = [
     "kind",
+    "state",
     "subdomain",
     "tunnel",
     "age",
@@ -242,6 +290,7 @@ export const formatListTunnelsOutput = (response) => {
 };
 const formatListTunnelRow = (item) => [
     formatListItemKind(item.kind),
+    item.status ?? "-",
     item.subdomain ?? "-",
     formatShortId(item.tunnelId),
     formatCompactAge(item.activeForMs),

package/dist/command.d.ts

@@ -2,4 +2,5 @@ import { Effect } from "effect";
 import { CliUsageError, type CliRuntimeError } from "./errors.js";
 export declare const runCli: (argv: ReadonlyArray<string>) => Effect.Effect<void, CliRuntimeError | CliUsageError>;
 export declare const normalizeCliArgs: (argv: ReadonlyArray<string>) => ReadonlyArray<string>;
+export declare const buildConnectOriginalArgv: (argv: ReadonlyArray<string>, legacy: boolean) => ReadonlyArray<string>;
 //# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAkBxD,OAAO,EAAE,aAAa,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAwChF,eAAO,MAAM,MAAM,GACjB,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAmBrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,aAAa,CAAC,MAAM,CAC1C,CAAC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAuBxD,OAAO,EAAE,aAAa,EAAgB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAyChF,eAAO,MAAM,MAAM,GACjB,MAAM,aAAa,CAAC,MAAM,CAAC,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,CAmBrD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,aAAa,CAAC,MAAM,CAC1C,CAAC;AAE1C,eAAO,MAAM,wBAAwB,GACnC,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,QAAQ,OAAO,KACd,aAAa,CAAC,MAAM,CAAmE,CAAC"}

package/dist/command.js

@@ -1,7 +1,7 @@
 import { formatCaptureOrigin, parseCaptureHostPort, parseTarget, validateRequestedSubdomain, } from "@localpreview/protocol";
 import { Console, Effect, Layer, Option } from "effect";
-import { adminTokenRequiredMessage, formatStatus, formatWarning, formatListTunnelsOutput, renderCleanHelp, renderConnectHelp, renderGlobalHelp, renderListHelp, removedAdminTokenFlagMessage, } from "./cli-ui.js";
-import { CliConfig, CliConfigLive, LOCAL_CONTROL_PLANE_URL, normalizeControlPlaneUrl } from "./config.js";
+import { adminTokenRequiredMessage, formatWarning, formatListTunnelsOutput, renderCleanHelp, renderConnectHelp, renderGlobalHelp, renderListHelp, removedAdminTokenFlagMessage, } from "./cli-ui.js";
+import { CliConfig, CliConfigLive, LOCAL_CONTROL_PLANE_PUBLIC_HOST, LOCAL_CONTROL_PLANE_URL, normalizeControlPlaneUrl, } from "./config.js";
 import { ControlPlaneClient, ControlPlaneClientLive, } from "./control-plane.js";
 import { CliUsageError, errorMessage } from "./errors.js";
 import { LocalProxyLive } from "./local-proxy.js";
@@ -20,9 +20,10 @@ export const runCli = (argv) => {
     if (!parsed.ok) {
         return Effect.fail(new CliUsageError({ message: parsed.message }));
     }
-    return runSubcommand(parsed.command);
+    return runSubcommand(parsed.command, normalized);
 };
 export const normalizeCliArgs = (argv) => argv[0] === "--" ? argv.slice(1) : argv;
+export const buildConnectOriginalArgv = (argv, legacy) => (legacy ? argv : argv[0] === "connect" ? argv.slice(1) : argv);
 const hasHelpFlag = (argv) => argv.includes("--help") || argv.includes("-h");
 const resolveHelpKind = (argv) => {
     if (argv.length === 0) {
@@ -177,6 +178,7 @@ const parseConnectArgs = (argv) => {
         config: {
             captures,
             controlPlane: toOption(controlPlane),
+            localMode: usedLocalControlPlane,
             requestedName: toOption(requestedName),
             target,
         },
@@ -439,10 +441,10 @@ const readRequiredOptionValue = (argv, index, option) => {
     };
 };
 const toOption = (value) => value === undefined ? Option.none() : Option.some(value);
-const runSubcommand = (command) => {
+const runSubcommand = (command, originalArgv) => {
     const controlPlane = Option.getOrUndefined(command.config.controlPlane);
     const effect = command.kind === "connect"
-        ? runConnect(command.config, command.legacy)
+        ? runConnect(command.config, command.legacy, originalArgv)
         : command.kind === "clean"
             ? runClean(command.config)
             : runList(command.config);
@@ -455,7 +457,7 @@ const makeCommandLayer = (input) => {
     const RelayLive = RelayClientLive.pipe(Layer.provide(Layer.mergeAll(ConfigLive, ProxyLive)));
     return Layer.mergeAll(ConfigLive, ControlPlaneClientLive, ProxyLive, RelayLive);
 };
-const runConnect = (config, legacy) => Effect.scoped(Effect.gen(function* () {
+const runConnect = (config, legacy, originalArgv) => Effect.scoped(Effect.gen(function* () {
     if (legacy) {
         yield* Console.error(formatWarning("`localpreview <target>` is deprecated. Use `localpreview connect <target>`."));
     }
@@ -467,14 +469,18 @@ const runConnect = (config, legacy) => Effect.scoped(Effect.gen(function* () {
     const controlPlane = yield* ControlPlaneClient;
     const relay = yield* RelayClient;
     const cliConfig = yield* CliConfig;
-    const tunnel = yield* Effect.acquireRelease(controlPlane.createTunnel(cliConfig.controlPlaneUrl, requestedSubdomain === undefined ? {} : { requestedSubdomain }), (tunnel) => closeTunnelBestEffort(controlPlane, cliConfig.controlPlaneUrl, tunnel));
-    yield* Console.log(formatStatus(`Tunnel ready: ${tunnel.publicUrl}`));
-    yield* Console.log(formatStatus(`Forwarding to ${target.target.protocol}://${target.target.hostname}:${target.target.port}`));
+    const tunnel = yield* Effect.acquireRelease(controlPlane.createTunnel(cliConfig.controlPlaneUrl, {
+        ...(config.localMode ? { publicHost: LOCAL_CONTROL_PLANE_PUBLIC_HOST } : {}),
+        ...(requestedSubdomain === undefined ? {} : { requestedSubdomain }),
+    }), (tunnel) => closeTunnelBestEffort(controlPlane, cliConfig.controlPlaneUrl, tunnel));
     if (config.captures.length > 0) {
         const origins = config.captures.map((capture) => formatCaptureOrigin(capture)).join(", ");
         yield* Console.error(formatWarning(`Captured local backends (${origins}) are exposed through this preview URL. Anyone with the link can reach them.`));
     }
-    yield* relay.connectAndServe(tunnel, target.target, config.captures);
+    yield* relay.connectAndServe(tunnel, target.target, config.captures, {
+        legacy,
+        originalArgv: buildConnectOriginalArgv(originalArgv, legacy),
+    });
 }));
 const validateRequestedName = (value) => Option.match(value, {
     onNone: () => Effect.succeed(undefined),

package/dist/config.d.ts

@@ -4,6 +4,7 @@ export type CliConfigShape = {
     readonly controlPlaneUrl: string;
     readonly maxInFlightRequests: number;
     readonly relayConnectTimeoutMs: number;
+    readonly relayReadyTimeoutMs: number;
     readonly requestBodyLimitBytes: number;
     readonly requestTimeoutMs: number;
     readonly responseBodyLimitBytes: number;
@@ -13,7 +14,8 @@ declare const CliConfig_base: Context.ServiceClass<CliConfig, "CliConfig", CliCo
 export declare class CliConfig extends CliConfig_base {
 }
 export declare const PUBLIC_CONTROL_PLANE_URL = "https://localpreview.dev";
-export declare const LOCAL_CONTROL_PLANE_URL = "http://localhost:3000";
+export declare const LOCAL_CONTROL_PLANE_URL = "http://127.0.0.1:3000";
+export declare const LOCAL_CONTROL_PLANE_PUBLIC_HOST = "localhost:3000";
 export type NormalizeControlPlaneUrlResult = {
     readonly ok: true;
     readonly url: string;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC,CAAC;;AAEF,qBAAa,SAAU,SAAQ,cAAyD;CAAG;AAE3F,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,8BA4DxD,CAAC;AA2BF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,cAkBH,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,yCAAmD,CAAC;AAWrD,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAA4C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC,CAAC;;AAEF,qBAAa,SAAU,SAAQ,cAAyD;CAAG;AAE3F,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,+BAA+B,mBAAmB,CAAC;AAEhE,MAAM,MAAM,8BAA8B,GACtC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,GAAI,OAAO,MAAM,KAAG,8BA4DxD,CAAC;AA2BF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,cAmBH,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,yCAAmD,CAAC;AAWrD,eAAO,MAAM,aAAa,GAAI,OAAO;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAClC,KAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAA4C,CAAC"}

package/dist/config.js

@@ -3,7 +3,8 @@ import { Context, Effect, Layer } from "effect";
 export class CliConfig extends Context.Service()("CliConfig") {
 }
 export const PUBLIC_CONTROL_PLANE_URL = LOCALPREVIEW_PUBLIC_ORIGIN;
-export const LOCAL_CONTROL_PLANE_URL = "http://localhost:3000";
+export const LOCAL_CONTROL_PLANE_URL = "http://127.0.0.1:3000";
+export const LOCAL_CONTROL_PLANE_PUBLIC_HOST = "localhost:3000";
 /** Normalizes and validates a control-plane base URL from `--control-plane`. */
 export const normalizeControlPlaneUrl = (value) => {
     let parsed;
@@ -84,6 +85,7 @@ export const makeCliConfig = (input) => {
         controlPlaneUrl,
         maxInFlightRequests: readNumber(env.LOCALPREVIEW_MAX_IN_FLIGHT_REQUESTS, 100),
         relayConnectTimeoutMs: readNumber(env.LOCALPREVIEW_RELAY_CONNECT_TIMEOUT_MS, 10_000),
+        relayReadyTimeoutMs: readNumber(env.LOCALPREVIEW_RELAY_READY_TIMEOUT_MS, 60_000),
         requestBodyLimitBytes: readNumber(env.LOCALPREVIEW_REQUEST_BODY_LIMIT_BYTES, 10 * 1024 * 1024),
         requestTimeoutMs: readNumber(env.LOCALPREVIEW_REQUEST_TIMEOUT_MS, 30_000),
         responseBodyLimitBytes: readNumber(env.LOCALPREVIEW_RESPONSE_BODY_LIMIT_BYTES, 50 * 1024 * 1024),

package/dist/control-plane.d.ts

@@ -1,4 +1,4 @@
-import { type CreateTunnelResponse, type ListTunnelsResponse } from "@localpreview/protocol";
+import { type CreateTunnelRequest, type CreateTunnelResponse, type ListTunnelsResponse } from "@localpreview/protocol";
 import { Context, Effect, Layer } from "effect";
 import { ControlPlaneError } from "./errors.js";
 export type ControlPlaneClientShape = {
@@ -12,9 +12,7 @@ export type ControlPlaneClientShape = {
         readonly subdomain: string;
     }) => Effect.Effect<CleanSubdomainResponse, ControlPlaneError>;
     readonly closeTunnel: (controlPlaneUrl: string, tunnel: Pick<CreateTunnelResponse, "clientToken" | "tunnelId">) => Effect.Effect<void, ControlPlaneError>;
-    readonly createTunnel: (controlPlaneUrl: string, body: {
-        readonly requestedSubdomain?: string;
-    }) => Effect.Effect<CreateTunnelResponse, ControlPlaneError>;
+    readonly createTunnel: (controlPlaneUrl: string, body: CreateTunnelRequest) => Effect.Effect<CreateTunnelResponse, ControlPlaneError>;
     readonly listTunnels: (controlPlaneUrl: string, input: {
         readonly adminToken: string;
         readonly limit: number;
@@ -47,9 +45,7 @@ declare const ControlPlaneClient_base: Context.ServiceClass<ControlPlaneClient,
 export declare class ControlPlaneClient extends ControlPlaneClient_base {
 }
 export declare const ControlPlaneClientLive: Layer.Layer<ControlPlaneClient, never, never>;
-export declare const createTunnel: (controlPlaneUrl: string, body: {
-    readonly requestedSubdomain?: string;
-}) => Promise<CreateTunnelResponse>;
+export declare const createTunnel: (controlPlaneUrl: string, body: CreateTunnelRequest) => Promise<CreateTunnelResponse>;
 export declare const closeTunnel: (controlPlaneUrl: string, tunnel: Pick<CreateTunnelResponse, "clientToken" | "tunnelId">) => Promise<void>;
 export declare const cleanSubdomain: (controlPlaneUrl: string, input: {
     readonly adminToken: string;

package/dist/control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAEzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,KACE,MAAM,CAAC,MAAM,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE,CACvB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KACE,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,CACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,UAAU,CAAC,KAC3D,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,CACrB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE;QACJ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,KACE,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,CACpB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE;QACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,KACE,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;YAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;YAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;SAC5B,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;;AAEF,qBAAa,kBAAmB,SAAQ,uBAGf;CAAG;AAE5B,eAAO,MAAM,sBAAsB,+CAYjC,CAAC;AAEH,eAAO,MAAM,YAAY,GACvB,iBAAiB,MAAM,EACvB,MAAM;IACJ,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,KACA,OAAO,CAAC,oBAAoB,CAAiE,CAAC;AAEjG,eAAO,MAAM,WAAW,GACtB,iBAAiB,MAAM,EACvB,QAAQ,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,UAAU,CAAC,KAC7D,OAAO,CAAC,IAAI,CAAkE,CAAC;AAElF,eAAO,MAAM,cAAc,GACzB,iBAAiB,MAAM,EACvB,OAAO;IACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,KACA,OAAO,CAAC,sBAAsB,CACgC,CAAC;AAElE,eAAO,MAAM,kBAAkB,GAC7B,iBAAiB,MAAM,EACvB,OAAO;IACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,KACA,OAAO,CAAC,0BAA0B,CACgC,CAAC;AAEtE,eAAO,MAAM,WAAW,GACtB,iBAAiB,MAAM,EACvB,OAAO;IACL,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,KACA,OAAO,CAAC,mBAAmB,CAAiE,CAAC"}
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../src/control-plane.ts"],"names":[],"mappings":"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"}

package/dist/control-plane.js

@@ -1,5 +1,6 @@
 import { LOCALPREVIEW_ADMIN_TOKEN_HEADER, LOCALPREVIEW_ERROR_CODES, LOCALPREVIEW_PROTOCOL_VERSION, LOCALPREVIEW_RELAY_SNAPSHOT_VERSION, } from "@localpreview/protocol";
 import { Context, Effect, Layer, Schedule } from "effect";
+import { LOCAL_CONTROL_PLANE_URL } from "./config.js";
 import { ControlPlaneError } from "./errors.js";
 export class ControlPlaneClient extends Context.Service()("ControlPlaneClient") {
 }
@@ -20,8 +21,9 @@ export const cleanAllSubdomains = (controlPlaneUrl, input) => Effect.runPromise(
 export const listTunnels = (controlPlaneUrl, input) => Effect.runPromise(listTunnelsEffect(controlPlaneUrl, input));
 const createTunnelEffect = (controlPlaneUrl, body) => Effect.promise(async () => {
     let response;
+    const createTunnelUrl = new URL("/api/tunnels", controlPlaneUrl);
     try {
-        response = await fetch(new URL("/api/tunnels", controlPlaneUrl), {
+        response = await fetch(createTunnelUrl, {
             body: JSON.stringify(body),
             headers: {
                 "content-type": "application/json",
@@ -33,7 +35,7 @@ const createTunnelEffect = (controlPlaneUrl, body) => Effect.promise(async () =>
         throw new ControlPlaneError({
             message: [
                 `Could not reach localpreview control-plane at ${controlPlaneUrl}.`,
-                'Use "-l" or "--local" as shorthand for --control-plane http://localhost:3000.',
+                `Use "-l" or "--local" as shorthand for --control-plane ${LOCAL_CONTROL_PLANE_URL}.`,
             ].join("\n"),
             retryable: false,
         });

package/dist/errors.d.ts

@@ -39,6 +39,10 @@ declare const LocalRequestError_base: new <A extends Record<string, any> = {}>(a
     readonly _tag: "LocalRequestError";
 } & Readonly<A>;
 export declare class LocalRequestError extends LocalRequestError_base<{
+    readonly invalidCapture?: {
+        readonly hostname: string;
+        readonly port: number;
+    };
     readonly message: string;
     readonly requestId: string;
 }> {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,aAAc,SAAQ,mBAAkC;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;CAAG;;;;AAEL,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;CAAG;;;;AAEL,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;AAEL,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAM7C,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAEA,qBAAa,aAAc,SAAQ,mBAAkC;IACnE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;CAAG;;;;AAEL,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;CAAG;;;;AAEL,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;;;;AAEL,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;CAAG;AAEL,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAM7C,CAAC"}

package/dist/local-proxy.d.ts

@@ -5,6 +5,9 @@ import { CliConfig } from "./config.js";
 import { RelayProtocolError } from "./errors.js";
 export type ProxySession = {
     readonly captures: ReadonlyArray<CaptureTarget>;
+    readonly legacy: boolean;
+    readonly originalArgv: ReadonlyArray<string>;
+    readonly reportedMissingCaptures: Set<string>;
     readonly target: TunnelTarget;
 };
 export type LocalProxyShape = {

package/dist/local-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-proxy.d.ts","sourceRoot":"","sources":["../src/local-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAW,OAAO,EAAE,MAAM,EAAS,KAAK,EAAO,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAchC,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAEL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;;AAEF,qBAAa,UAAW,SAAQ,eAA4D;CAAG;AAE/F,eAAO,MAAM,cAAc,2CAU1B,CAAC;AAgVF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,MAqC5E,CAAC;AA0BF,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,WAqB7D,CAAC"}
+{"version":3,"file":"local-proxy.d.ts","sourceRoot":"","sources":["../src/local-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAW,OAAO,EAAE,MAAM,EAAS,KAAK,EAAO,MAAM,QAAQ,CAAC;AACrE,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AA8BhC,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAEL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,aAAa,EAAE,CACtB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;;AAEF,qBAAa,UAAW,SAAQ,eAA4D;CAAG;AAE/F,eAAO,MAAM,cAAc,2CAU1B,CAAC;AA6aF,eAAO,MAAM,uBAAuB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,MAqC5E,CAAC;AA0CF,eAAO,MAAM,0BAA0B,GAAI,SAAS,OAAO,KAAG,WAqB7D,CAAC"}

package/dist/local-proxy.js

@@ -2,7 +2,8 @@ import { decodeServerRelayMessage, encodeRelayMessage, filterEndToEndHeaderPairs
 import { Console, Context, Effect, Fiber, Layer, Ref } from "effect";
 import { buildCaptureCookiePathPrefix, resolveRoute, } from "./capture-route.js";
 import { buildCaptureShimScript, buildFrontendOrigin, injectCaptureShim, isHtmlResponse, stripContentSecurityPolicy, } from "./capture-shim.js";
-import { formatRequestError, formatRequestInbound, formatRequestOutbound } from "./cli-ui.js";
+import { formatCapturedRequestInbound, formatCapturedRequestOutbound, formatInvalidCaptureRouteError, formatMissingCaptureWarning, formatRequestError, formatRequestInbound, formatRequestOutbound, } from "./cli-ui.js";
+import { buildSuggestedCaptureCommand, formatMissingCaptureOrigin, isLocalPreviewEventsPath, missingCaptureDedupeKey, parseMissingCaptureEvent, shouldReportMissingCapture, } from "./missing-capture.js";
 import { CliConfig } from "./config.js";
 import { LocalRequestError, RelayProtocolError, RequestLimitError, errorMessage, } from "./errors.js";
 export class LocalProxy extends Context.Service()("LocalProxy") {
@@ -24,7 +25,7 @@ const handleMessage = (config, requests, socket, session, input) => Effect.gen(f
     const message = decoded.message;
     switch (message.type) {
         case "request-start":
-            return yield* handleRequestStart(config, requests, socket, message);
+            return yield* handleRequestStart(config, requests, socket, session, message);
         case "request-chunk":
             return yield* handleRequestChunk(config, requests, socket, message);
         case "request-end":
@@ -33,7 +34,7 @@ const handleMessage = (config, requests, socket, session, input) => Effect.gen(f
             return yield* handleCancel(requests, message.requestId);
     }
 });
-const handleRequestStart = (config, requests, socket, message) => Effect.gen(function* () {
+const handleRequestStart = (config, requests, socket, session, message) => Effect.gen(function* () {
     const current = yield* Ref.get(requests);
     if (current.size >= config.maxInFlightRequests) {
         yield* send(socket, {
@@ -52,7 +53,16 @@ const handleRequestStart = (config, requests, socket, message) => Effect.gen(fun
         totalBytes: 0,
     });
     yield* Ref.set(requests, next);
-    yield* Console.log(formatRequestOutbound(message.method, logPath(message.path)));
+    if (shouldLogOutboundRequest(message.method, message.path)) {
+        const route = resolveRoute(message.path, session.target, session.captures);
+        const displayPath = route.kind === "capture"
+            ? formatCaptureTargetUrl(route.capturePath)
+            : logPath(message.path);
+        const line = route.kind === "capture"
+            ? formatCapturedRequestOutbound(message.method, displayPath)
+            : formatRequestOutbound(message.method, displayPath);
+        yield* Console.log(line);
+    }
 });
 const handleRequestChunk = (config, requests, socket, message) => Effect.gen(function* () {
     const current = yield* Ref.get(requests);
@@ -95,7 +105,7 @@ const handleRequestEnd = (config, requests, socket, session, message) => Effect.
         message: error.message,
         requestId: message.requestId,
         type: "response-error",
-    }).pipe(Effect.andThen(Console.log(formatRequestError(logPath(request.path), error.message))))), Effect.ensuring(Ref.update(requests, (map) => {
+    }).pipe(Effect.andThen(Console.log(formatProxyRequestError(request, error))))), Effect.ensuring(Ref.update(requests, (map) => {
         const next = new Map(map);
         next.delete(message.requestId);
         return next;
@@ -115,9 +125,18 @@ const handleCancel = (requests, requestId) => Effect.gen(function* () {
     yield* Ref.set(requests, next);
 });
 const proxyRequest = (config, socket, session, requestId, request) => Effect.gen(function* () {
+    if (request.method === "POST" && isLocalPreviewEventsPath(request.path)) {
+        yield* handleMissingCaptureEvent(session, request);
+        yield* sendEventsResponse(socket, requestId);
+        return;
+    }
     const route = resolveRoute(request.path, session.target, session.captures);
     if (route.kind === "invalid-capture") {
         return yield* Effect.fail(new LocalRequestError({
+            invalidCapture: {
+                hostname: route.capturePath.hostname,
+                port: route.capturePath.port,
+            },
             message: route.message,
             requestId,
         }));
@@ -170,12 +189,10 @@ const proxyRequest = (config, socket, session, requestId, request) => Effect.gen
         }));
     }
     const contentType = response.headers.get("content-type");
-    const shouldInjectShim = route.kind === "primary" &&
-        session.captures.length > 0 &&
-        isHtmlResponse(contentType);
+    const shouldInjectShim = route.kind === "primary" && isHtmlResponse(contentType);
     if (shouldInjectShim) {
         const html = responseBody.toString("utf8");
-        const shimScript = buildCaptureShimScript(session.captures);
+        const shimScript = buildCaptureShimScript(session.target, session.captures);
         responseBody = Buffer.from(injectCaptureShim(html, shimScript), "utf8");
     }
     let responseHeaders = filterLocalResponseHeaders(response.headers);
@@ -203,7 +220,54 @@ const proxyRequest = (config, socket, session, requestId, request) => Effect.gen
         requestId,
         type: "response-end",
     });
-    yield* Console.log(formatRequestInbound(response.status, logPath(request.path), Date.now() - startedAt));
+    const displayPath = route.kind === "capture" ? formatCaptureTargetUrl(route.capturePath) : logPath(request.path);
+    const line = route.kind === "capture"
+        ? formatCapturedRequestInbound(response.status, displayPath, Date.now() - startedAt)
+        : formatRequestInbound(response.status, displayPath, Date.now() - startedAt);
+    yield* Console.log(line);
+});
+const handleMissingCaptureEvent = (session, request) => Effect.gen(function* () {
+    const bodyText = Buffer.concat(request.chunks).toString("utf8");
+    if (bodyText.length === 0) {
+        return;
+    }
+    let parsedBody;
+    try {
+        parsedBody = JSON.parse(bodyText);
+    }
+    catch {
+        return;
+    }
+    const event = parseMissingCaptureEvent(parsedBody);
+    if (event === undefined ||
+        !shouldReportMissingCapture(event, session.target, session.captures)) {
+        return;
+    }
+    const dedupeKey = missingCaptureDedupeKey(event.payload.protocol, event.payload.hostname, event.payload.port);
+    if (session.reportedMissingCaptures.has(dedupeKey)) {
+        return;
+    }
+    session.reportedMissingCaptures.add(dedupeKey);
+    const origin = formatMissingCaptureOrigin(event.payload.protocol, event.payload.hostname, event.payload.port);
+    const suggestedCommand = buildSuggestedCaptureCommand(session.originalArgv, session.legacy, session.captures, event.payload.hostname, event.payload.port);
+    yield* Console.error(formatMissingCaptureWarning({
+        ...(event.payload.method === undefined ? {} : { method: event.payload.method }),
+        origin,
+        suggestedCommand,
+        transport: event.payload.transport,
+    }));
+});
+const sendEventsResponse = (socket, requestId) => Effect.gen(function* () {
+    yield* send(socket, {
+        headers: [],
+        requestId,
+        status: 204,
+        type: "response-start",
+    });
+    yield* send(socket, {
+        requestId,
+        type: "response-end",
+    });
 });
 const rewriteCaptureResponseHeaders = (headers, capturePath) => {
     const pathPrefix = buildCaptureCookiePathPrefix(capturePath);
@@ -250,6 +314,17 @@ const sendRequestError = (socket, requestId, error) => send(socket, {
     requestId,
     type: "response-error",
 });
+const formatProxyRequestError = (request, error) => {
+    if (error instanceof LocalRequestError && error.invalidCapture !== undefined) {
+        return formatInvalidCaptureRouteError({
+            hostname: error.invalidCapture.hostname,
+            method: request.method,
+            path: request.path,
+            port: error.invalidCapture.port,
+        });
+    }
+    return formatRequestError(logPath(request.path), error.message);
+};
 const send = (socket, message) => Effect.sync(() => {
     if (socket.readyState === socket.OPEN) {
         socket.send(encodeRelayMessage(message));
@@ -283,4 +358,6 @@ const logPath = (path) => {
         return path.split("?")[0] ?? path;
     }
 };
+const formatCaptureTargetUrl = (capturePath) => `${capturePath.protocol}://${capturePath.hostname}:${capturePath.port}${capturePath.path}`;
+const shouldLogOutboundRequest = (method, path) => !(method === "POST" && isLocalPreviewEventsPath(path));
 const timeoutFail = (millis, error) => (effect) => Effect.raceFirst(effect, Effect.sleep(`${millis} millis`).pipe(Effect.andThen(Effect.fail(error))));

package/dist/missing-capture.d.ts

@@ -0,0 +1,44 @@
+import { type CaptureTarget, type TunnelTarget } from "@localpreview/protocol";
+export declare const LOCALPREVIEW_EVENTS_PATH = "/__localpreview/events";
+export type MissingCaptureTransport = "fetch" | "xhr" | "websocket" | "eventsource";
+export type MissingCaptureProtocol = "http" | "https" | "ws" | "wss";
+export type MissingCaptureEvent = {
+    readonly type: "missing-capture";
+    readonly payload: {
+        readonly protocol: "http" | "https" | "ws" | "wss";
+        readonly hostname: string;
+        readonly method?: string;
+        readonly port: number;
+        readonly transport: MissingCaptureTransport;
+    };
+};
+export type MissingCaptureEventInput = {
+    readonly hostname: string;
+    readonly method?: string;
+    readonly port: number;
+    readonly protocol: string;
+    readonly transport: string;
+};
+/** Canonical loopback group for localhost / 127.0.0.1 / [::1] equivalence. */
+export declare const loopbackGroup: (hostname: string) => string;
+/** Returns true when two loopback endpoints share host equivalence and port. */
+export declare const sameLoopbackEndpoint: (leftHost: string, leftPort: number, rightHost: string, rightPort: number) => boolean;
+/** Returns true when the endpoint matches the primary tunnel target port. */
+export declare const isPrimaryTargetPort: (primaryTarget: Pick<TunnelTarget, "hostname" | "port">, hostname: string, port: number) => boolean;
+/** Returns true when the endpoint is already allowlisted via --capture. */
+export declare const isCapturedEndpoint: (captures: ReadonlyArray<CaptureTarget>, hostname: string, port: number) => boolean;
+/** Formats a missing-capture origin as protocol://hostname:port. */
+export declare const formatMissingCaptureOrigin: (protocol: MissingCaptureEvent["payload"]["protocol"], hostname: string, port: number) => string;
+/** Dedupe key for one missing-capture report per protocol://hostname:port. */
+export declare const missingCaptureDedupeKey: (protocol: MissingCaptureEvent["payload"]["protocol"], hostname: string, port: number) => string;
+/** Returns true when the request targets the internal events route. */
+export declare const isLocalPreviewEventsPath: (requestPath: string) => boolean;
+/** Strictly validates a parsed missing-capture event body. */
+export declare const parseMissingCaptureEvent: (body: unknown) => MissingCaptureEvent | undefined;
+/** Builds a restart command preserving the original argv and appending --capture. */
+export declare const buildSuggestedCaptureCommand: (originalArgv: ReadonlyArray<string>, legacy: boolean, captures: ReadonlyArray<CaptureTarget>, hostname: string, port: number) => string;
+/** Returns true when a missing-capture event should produce a CLI warning. */
+export declare const shouldReportMissingCapture: (event: MissingCaptureEvent, primaryTarget: Pick<TunnelTarget, "hostname" | "port">, captures: ReadonlyArray<CaptureTarget>) => boolean;
+/** Formats a capture target for inclusion in warning text. */
+export declare const formatMissingCaptureTarget: (capture: CaptureTarget) => string;
+//# sourceMappingURL=missing-capture.d.ts.map

package/dist/missing-capture.d.ts.map

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

package/dist/missing-capture.js

@@ -0,0 +1,128 @@
+import { formatCaptureOrigin, isLoopbackHost, normalizeLoopbackHostname, } from "@localpreview/protocol";
+export const LOCALPREVIEW_EVENTS_PATH = "/__localpreview/events";
+const MISSING_CAPTURE_PROTOCOLS = new Set(["http", "https", "ws", "wss"]);
+const MISSING_CAPTURE_TRANSPORTS = new Set(["fetch", "xhr", "websocket", "eventsource"]);
+const isMissingCaptureProtocol = (value) => MISSING_CAPTURE_PROTOCOLS.has(value);
+const isMissingCaptureTransport = (value) => MISSING_CAPTURE_TRANSPORTS.has(value);
+/** Canonical loopback group for localhost / 127.0.0.1 / [::1] equivalence. */
+export const loopbackGroup = (hostname) => {
+    const normalized = normalizeLoopbackHostname(hostname);
+    if (normalized === "localhost" ||
+        normalized === "127.0.0.1" ||
+        normalized === "[::1]") {
+        return "__loopback__";
+    }
+    return normalized;
+};
+/** Returns true when two loopback endpoints share host equivalence and port. */
+export const sameLoopbackEndpoint = (leftHost, leftPort, rightHost, rightPort) => leftPort === rightPort && loopbackGroup(leftHost) === loopbackGroup(rightHost);
+/** Returns true when the endpoint matches the primary tunnel target port. */
+export const isPrimaryTargetPort = (primaryTarget, hostname, port) => sameLoopbackEndpoint(primaryTarget.hostname, primaryTarget.port, hostname, port);
+/** Returns true when the endpoint is already allowlisted via --capture. */
+export const isCapturedEndpoint = (captures, hostname, port) => captures.some((capture) => sameLoopbackEndpoint(capture.hostname, capture.port, hostname, port));
+/** Formats a missing-capture origin as protocol://hostname:port. */
+export const formatMissingCaptureOrigin = (protocol, hostname, port) => `${protocol}://${hostname}:${port}`;
+/** Dedupe key for one missing-capture report per protocol://hostname:port. */
+export const missingCaptureDedupeKey = (protocol, hostname, port) => {
+    const group = loopbackGroup(hostname);
+    const hostKey = group === "__loopback__" ? group : normalizeLoopbackHostname(hostname);
+    return `${protocol}://${hostKey}:${port}`;
+};
+/** Returns true when the request targets the internal events route. */
+export const isLocalPreviewEventsPath = (requestPath) => {
+    const pathname = requestPath.split("?")[0] ?? requestPath;
+    return pathname === LOCALPREVIEW_EVENTS_PATH;
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const normalizeHttpMethod = (value) => {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const method = value.trim().toUpperCase();
+    return /^[!#$%&'*+\-.^_`|~0-9A-Z]+$/.test(method) ? method : undefined;
+};
+/** Strictly validates a parsed missing-capture event body. */
+export const parseMissingCaptureEvent = (body) => {
+    if (!isRecord(body) || body.type !== "missing-capture" || !isRecord(body.payload)) {
+        return undefined;
+    }
+    const { payload } = body;
+    if (typeof payload.protocol !== "string" ||
+        typeof payload.hostname !== "string" ||
+        typeof payload.port !== "number" ||
+        typeof payload.transport !== "string") {
+        return undefined;
+    }
+    if (!isMissingCaptureProtocol(payload.protocol) ||
+        !isMissingCaptureTransport(payload.transport) ||
+        !Number.isInteger(payload.port) ||
+        payload.port < 1 ||
+        payload.port > 65_535 ||
+        !isLoopbackHost(payload.hostname)) {
+        return undefined;
+    }
+    const method = payload.method === undefined ? undefined : normalizeHttpMethod(payload.method);
+    if (payload.method !== undefined && method === undefined) {
+        return undefined;
+    }
+    return {
+        type: "missing-capture",
+        payload: {
+            hostname: normalizeLoopbackHostname(payload.hostname),
+            ...(method === undefined ? {} : { method }),
+            port: payload.port,
+            protocol: payload.protocol,
+            transport: payload.transport,
+        },
+    };
+};
+const formatCaptureFlagValue = (hostname, port) => hostname.includes(":") ? `[${hostname}]:${port}` : `${hostname}:${port}`;
+const captureFlagExists = (argv, captures, hostname, port) => {
+    if (isCapturedEndpoint(captures, hostname, port)) {
+        return true;
+    }
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg !== "--capture") {
+            continue;
+        }
+        const value = argv[index + 1];
+        if (value === undefined) {
+            continue;
+        }
+        const separator = value.lastIndexOf(":");
+        if (separator <= 0) {
+            continue;
+        }
+        const captureHost = value.startsWith("[")
+            ? value.slice(0, value.indexOf("]") + 1)
+            : value.slice(0, separator);
+        const capturePort = Number(value.slice(separator + 1));
+        if (sameLoopbackEndpoint(captureHost, capturePort, hostname, port)) {
+            return true;
+        }
+    }
+    return false;
+};
+/** Builds a restart command preserving the original argv and appending --capture. */
+export const buildSuggestedCaptureCommand = (originalArgv, legacy, captures, hostname, port) => {
+    const nextArgv = [...originalArgv];
+    if (!captureFlagExists(nextArgv, captures, hostname, port)) {
+        nextArgv.push("--capture", formatCaptureFlagValue(hostname, port));
+    }
+    const commandPrefix = legacy ? "localpreview" : "localpreview connect";
+    return `${commandPrefix} ${nextArgv.join(" ")}`.trim();
+};
+/** Returns true when a missing-capture event should produce a CLI warning. */
+export const shouldReportMissingCapture = (event, primaryTarget, captures) => {
+    const { hostname, port } = event.payload;
+    if (isPrimaryTargetPort(primaryTarget, hostname, port)) {
+        return false;
+    }
+    if (isCapturedEndpoint(captures, hostname, port)) {
+        return false;
+    }
+    return true;
+};
+/** Formats a capture target for inclusion in warning text. */
+export const formatMissingCaptureTarget = (capture) => formatCaptureOrigin(capture);

package/dist/relay-client.d.ts

@@ -1,15 +1,24 @@
-import type { CaptureTarget, CreateTunnelResponse, TunnelTarget } from "@localpreview/protocol";
-import { Context, Effect, Layer } from "effect";
+import { type CaptureTarget, type CreateTunnelResponse, type TunnelTarget } from "@localpreview/protocol";
+import { Context, Deferred, Effect, Layer } from "effect";
 import { CliConfig } from "./config.js";
 import { RelayConnectionError, RelayProtocolError } from "./errors.js";
 import { LocalProxy } from "./local-proxy.js";
 export type RelayClientShape = {
-    readonly connectAndServe: (tunnel: CreateTunnelResponse, target: TunnelTarget, captures: ReadonlyArray<CaptureTarget>) => Effect.Effect<void, RelayConnectionError | RelayProtocolError>;
+    readonly connectAndServe: (tunnel: CreateTunnelResponse, target: TunnelTarget, captures: ReadonlyArray<CaptureTarget>, sessionMetadata: RelaySessionMetadata) => Effect.Effect<void, RelayConnectionError | RelayProtocolError>;
+};
+export type RelaySessionMetadata = {
+    readonly legacy: boolean;
+    readonly originalArgv: ReadonlyArray<string>;
 };
 declare const RelayClient_base: Context.ServiceClass<RelayClient, "RelayClient", RelayClientShape>;
 export declare class RelayClient extends RelayClient_base {
 }
 export declare const RelayClientLive: Layer.Layer<RelayClient, never, CliConfig | LocalProxy>;
+export declare const waitForTunnelReady: (input: {
+    readonly ready: Deferred.Deferred<void, RelayConnectionError>;
+    readonly terminatedBeforeReady: Deferred.Deferred<void, RelayConnectionError>;
+    readonly timeoutMs: number;
+}) => Effect.Effect<void, RelayConnectionError>;
 export declare const isRetryableCloseCode: (code: number) => boolean;
 export {};
 //# sourceMappingURL=relay-client.d.ts.map

package/dist/relay-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay-client.d.ts","sourceRoot":"","sources":["../src/relay-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAW,OAAO,EAAY,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,eAAe,EAAE,CACxB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,KACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;CACrE,CAAC;;AAEF,qBAAa,WAAY,SAAQ,gBAA+D;CAAG;AAEnG,eAAO,MAAM,eAAe,yDAU3B,CAAC;AA6LF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OAAwB,CAAC"}
+{"version":3,"file":"relay-client.d.ts","sourceRoot":"","sources":["../src/relay-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACpI,OAAO,EAAW,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,UAAU,EAAwB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,eAAe,EAAE,CACxB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,EACtC,eAAe,EAAE,oBAAoB,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;;AAEF,qBAAa,WAAY,SAAQ,gBAA+D;CAAG;AAEnG,eAAO,MAAM,eAAe,yDAU3B,CAAC;AA0OF,eAAO,MAAM,kBAAkB,GAAI,OAAO;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC9D,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,KAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAczC,CAAC;AAEJ,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OAAwB,CAAC"}

package/dist/relay-client.js

@@ -1,3 +1,4 @@
+import { decodeServerRelayMessage } from "@localpreview/protocol";
 import { Console, Context, Deferred, Effect, Layer, Schedule } from "effect";
 import WebSocket from "ws";
 import { formatRelayReconnect, formatStatus } from "./cli-ui.js";
@@ -10,23 +11,32 @@ export const RelayClientLive = Layer.effect(RelayClient)(Effect.gen(function* ()
     const config = yield* CliConfig;
     const localProxy = yield* LocalProxy;
     return {
-        connectAndServe: (tunnel, target, captures) => connectAndServe(config, localProxy, tunnel, target, captures),
+        connectAndServe: (tunnel, target, captures, sessionMetadata) => connectAndServe(config, localProxy, tunnel, target, captures, sessionMetadata),
     };
 }));
-const connectAndServe = (config, localProxy, tunnel, target, captures) => serveWithReconnect(config, localProxy, tunnel, target, captures);
-const serveWithReconnect = (config, localProxy, tunnel, target, captures) => serveOnce(config, localProxy, tunnel, target, captures).pipe(Effect.catch((error) => {
+const connectAndServe = (config, localProxy, tunnel, target, captures, sessionMetadata) => serveWithReconnect(config, localProxy, tunnel, target, captures, sessionMetadata);
+const serveWithReconnect = (config, localProxy, tunnel, target, captures, sessionMetadata) => serveOnce(config, localProxy, tunnel, target, captures, sessionMetadata).pipe(Effect.catch((error) => {
     if (error instanceof RelayConnectionError && error.retryable === true) {
-        return Console.error(formatRelayReconnect(error.message)).pipe(Effect.andThen(Effect.sleep("1 second")), Effect.andThen(serveWithReconnect(config, localProxy, tunnel, target, captures)));
+        return Console.error(formatRelayReconnect(error.message)).pipe(Effect.andThen(Effect.sleep("1 second")), Effect.andThen(serveWithReconnect(config, localProxy, tunnel, target, captures, sessionMetadata)));
     }
     return Effect.fail(error);
 }));
-const serveOnce = (config, localProxy, tunnel, target, captures) => Effect.gen(function* () {
+const serveOnce = (config, localProxy, tunnel, target, captures, sessionMetadata) => Effect.gen(function* () {
     const socket = yield* openSocket(tunnel).pipe(Effect.retry({
         schedule: Schedule.recurs(Math.ceil(config.relayConnectTimeoutMs / 250)),
     }));
     yield* Console.log(formatStatus("Connected to relay."));
-    const session = { captures, target };
+    const session = {
+        captures,
+        legacy: sessionMetadata.legacy,
+        originalArgv: sessionMetadata.originalArgv,
+        reportedMissingCaptures: new Set(),
+        target,
+    };
     const done = yield* Deferred.make();
+    const ready = yield* Deferred.make();
+    const terminatedBeforeReady = yield* Deferred.make();
+    let tunnelReady = false;
     const handleSignal = () => {
         socket.close(1000, "Interrupted");
         Effect.runFork(Deferred.succeed(done, undefined));
@@ -36,6 +46,14 @@ const serveOnce = (config, localProxy, tunnel, target, captures) => Effect.gen(f
             process.once("SIGINT", handleSignal);
             process.once("SIGTERM", handleSignal);
             socket.on("message", (data) => {
+                const decoded = decodeServerRelayMessage(data.toString());
+                if (decoded.ok &&
+                    decoded.message.type === "tunnel-ready" &&
+                    decoded.message.tunnelId === tunnel.tunnelId) {
+                    tunnelReady = true;
+                    Effect.runFork(Deferred.succeed(ready, undefined));
+                    return;
+                }
                 const effect = localProxy.handleMessage(socket, session, data.toString()).pipe(Effect.catch((error) => Effect.gen(function* () {
                     socket.close(1002, error.message);
                     yield* Deferred.fail(done, error);
@@ -43,19 +61,23 @@ const serveOnce = (config, localProxy, tunnel, target, captures) => Effect.gen(f
                 Effect.runFork(effect);
             });
             socket.on("error", (error) => {
-                Effect.runFork(Deferred.fail(done, new RelayConnectionError({
+                const relayError = new RelayConnectionError({
                     message: error.message,
-                })));
+                });
+                Effect.runFork(Deferred.fail(done, relayError).pipe(Effect.andThen(Deferred.fail(terminatedBeforeReady, relayError))));
             });
             socket.on("close", (code, reason) => {
+                const relayError = new RelayConnectionError({
+                    message: tunnelReady
+                        ? `Relay connection closed (${code}): ${reason.toString()}`
+                        : `Relay connection closed before tunnel-ready (${code}): ${reason.toString()}`,
+                    retryable: isRetryableCloseCode(code),
+                });
                 if (code === 1000 || code === 1001) {
-                    Effect.runFork(Deferred.succeed(done, undefined));
+                    Effect.runFork(Deferred.fail(terminatedBeforeReady, relayError).pipe(Effect.andThen(Deferred.succeed(done, undefined))));
                     return;
                 }
-                Effect.runFork(Deferred.fail(done, new RelayConnectionError({
-                    message: `Relay connection closed (${code}): ${reason.toString()}`,
-                    retryable: isRetryableCloseCode(code),
-                })));
+                Effect.runFork(Deferred.fail(done, relayError).pipe(Effect.andThen(Deferred.fail(terminatedBeforeReady, relayError))));
             });
         }), () => Effect.sync(() => {
             process.off("SIGINT", handleSignal);
@@ -64,6 +86,13 @@ const serveOnce = (config, localProxy, tunnel, target, captures) => Effect.gen(f
                 socket.close(1000, "Closing");
             }
         }));
+        yield* waitForTunnelReady({
+            ready,
+            terminatedBeforeReady,
+            timeoutMs: config.relayReadyTimeoutMs,
+        });
+        yield* Console.log(formatStatus(`Tunnel ready: ${tunnel.publicUrl}`));
+        yield* Console.log(formatStatus(`Forwarding to ${target.protocol}://${target.hostname}:${target.port}`));
         yield* Deferred.await(done);
     }));
 });
@@ -114,4 +143,10 @@ const openSocket = (tunnel) => Effect.callback((resume) => {
 }).pipe(Effect.mapError((error) => new RelayConnectionError({
     message: errorMessage(error),
 })));
+export const waitForTunnelReady = (input) => Effect.raceFirst(Deferred.await(input.ready), Deferred.await(input.terminatedBeforeReady)).pipe(Effect.timeoutOrElse({
+    duration: `${input.timeoutMs} millis`,
+    orElse: () => Effect.fail(new RelayConnectionError({
+        message: "Timed out waiting for relay tunnel-ready acknowledgement.",
+    })),
+}));
 export const isRetryableCloseCode = (code) => code === 1006;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "localpreview",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "bin": {
     "localpreview": "./dist/index.js"
   },
@@ -15,7 +15,7 @@
     "effect": "beta",
     "picocolors": "^1.1.1",
     "ws": "latest",
-    "@localpreview/protocol": "0.2.2"
+    "@localpreview/protocol": "0.2.3"
   },
   "devDependencies": {
     "@effect/vitest": "beta",