@3dsource/angular-unreal-module 0.0.148-dev.2 → 0.0.149-dev.0

package/js/perf-longtask.js

@@ -0,0 +1 @@
+"use strict";(()=>{"use strict";if(window.__streamPerf)return;const t=1e3,e=window.__streamPerf={longTasks:[],supported:!1};try{new PerformanceObserver(o=>{for(const r of o.getEntries()){if(e.longTasks.length>=t)break;e.longTasks.push({start:Math.round(r.startTime),dur:Math.round(r.duration)})}}).observe({type:"longtask",buffered:!0}),e.supported=!0}catch{}})();

package/js/stream-prefetch.js

@@ -0,0 +1,4 @@
+"use strict";(()=>{"use strict";const f="metabox-configurator",m=/metabox-configurator\/(modular|basic)\/([^/?#]+)/i,g="3dsource:region-ping",k="assets/config.json",w="42e01f";function l(){return typeof crypto!="undefined"&&crypto.randomUUID?crypto.randomUUID():"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,o=>{const t=Math.random()*16|0;return(o==="x"?t:t&3|8).toString(16)})}function I(o){return o.replace("http://","ws://").replace("https://","wss://")}const h="[stream-prefetch]",s=(...o)=>console.log(h,...o),c=(...o)=>console.warn(h,...o),u=(...o)=>console.error(h,...o);class y{constructor(){const t=document.currentScript||(()=>{const n=document.getElementsByTagName("script");return n[n.length-1]})(),e=t&&t.dataset||{};this.configUrl=e.configUrl||k,this.fallbackPollingUrl=e.fallbackUrl||"",this.skipRouteCheck=this.boolOr(e.skipRouteCheck,!1),this.config={ws_timeout:this.numberOr(e.wsTimeout,6e3),poll_timeout:this.numberOr(e.pollTimeout,4e3)};const i=new URLSearchParams(window.location.search);this.forceTURN=i.has("ForceTURN"),this.forceMaxBundle=i.has("ForceMaxBundle"),this.forceMonoAudio=i.has("forceMono"),this.ids={clientId:l(),viewId:l(),correlationId:l()},this.context=null,this.environmentId=void 0,this.orchestrationType="",this.region="",this.requireEnvironmentId=!0,this.pc=null,this.dc=null,this.stream=null,this.ws=null,this.remoteDescriptionSet=!1,this.iceBuffer=[],this.wsTimeoutId=null,this.settled=!1}run(){if(typeof window=="undefined"||!("WebSocket"in window)||!("RTCPeerConnection"in window))return;if(this.skipRouteCheck){this.context={},this.requireEnvironmentId=!1,c("skipRouteCheck=true \u2014 ignoring URL gate, route, context and environmentId; using fallback polling"),this.publishParked("connecting"),this.connect().catch(e=>this.fail("exception",e));return}if(window.location.href.indexOf(f)===-1){s("skip \u2014 URL does not contain gate",`"${f}"`);return}const t=this.parseConfiguratorUrl();t?(this.context={id:t.contextId,data:{configuratorId:t.configuratorId}},this.requireEnvironmentId=!0,s("start",{contextId:t.contextId,configuratorId:t.configuratorId,ids:this.ids})):(this.context={},this.requireEnvironmentId=!1,c("URL is not a configurator route \u2014 prefetching with empty context {} and no required environmentId",window.location.pathname)),this.publishParked("connecting"),this.connect().catch(e=>this.fail("exception",e))}parseConfiguratorUrl(){const t=window.location.pathname.match(m);return t?{contextId:t[1].toLowerCase()==="modular"?"metaboxModularConfigurator":"metaboxBasicConfigurator",configuratorId:decodeURIComponent(t[2])}:null}connect(){return this.mark("prefetch_start"),this.region=this.readRegion()||"",s("region from cache:",this.region||"(none)"),(this.skipRouteCheck?Promise.resolve(null):this.fetchConfig()).then(e=>{let i;if(e)i=this.chooseEndpoint(e);else if(this.fallbackPollingUrl)c("no app config \u2014 falling back to polling",this.fallbackPollingUrl),i={type:"polling",url:this.fallbackPollingUrl,environmentId:""},this.requireEnvironmentId=!1;else{this.fail("no-config");return}if(!i){this.fail("no-endpoint");return}if(s("endpoint chosen",{type:i.type,url:i.url,environmentId:i.environmentId}),this.requireEnvironmentId&&!i.environmentId){this.fail("no-environment-id");return}this.orchestrationType=i.type,this.environmentId=i.environmentId||void 0;const n=this.adaptUrlToRegion(i.url);return(i.type==="polling"?this.pollOrchestration(n):Promise.resolve(n)).then(a=>{if(!a){this.fail("no-ws-url");return}return this.parked.machineId=a,s("opening socket",a),this.openSocket(a)})})}fetchConfig(){const t=new URL(this.configUrl,window.location.origin).href;return this.fetchWithTimeout(t,{credentials:"omit"},this.config.poll_timeout).then(e=>e.ok?e.json().catch(()=>null):null).catch(()=>null)}chooseEndpoint(t){const e=t.newSignalling,i=this.firstVersionUrl(e&&e.versions);if(i&&/^wss?:\/\//i.test(i))return{type:"direct",url:i,environmentId:e&&e.environmentId||""};const n=t.signalling,r=this.firstVersionUrl(n&&n.versions);return r?(this.requireEnvironmentId=!1,{type:"polling",url:r,environmentId:n&&n.environmentId||""}):null}firstVersionUrl(t){if(!t||typeof t!="object")return"";for(const e of Object.keys(t))if(t[e])return t[e];return""}pollOrchestration(t){const e=`${t}${this.ids.clientId}/${this.ids.viewId}`;return this.fetchWithTimeout(e,{credentials:"omit"},this.config.poll_timeout).then(i=>i.ok?i.json().catch(()=>({})):null).then(i=>i&&i.signallingServer?I(`${window.location.protocol}//${i.signallingServer}`):null).catch(()=>null)}adaptUrlToRegion(t){return this.region&&t.indexOf(":region")===-1?t.replace(/signallingserver/gi,`signallingserver/region:${this.region}`):t}openSocket(t){const e=new WebSocket(t);e.binaryType="arraybuffer",this.ws=e,this.parked.ws=e,this.wsTimeoutId=setTimeout(()=>{e.readyState!==WebSocket.OPEN&&this.fail("ws-timeout")},this.config.ws_timeout),e.onopen=()=>{clearTimeout(this.wsTimeoutId),this.mark("ws_open"),s("WS open \u2192 sending requestStream",{environmentId:this.environmentId,region:this.region,context:this.context}),this.sendRequestStream()},e.onmessage=i=>this.onWsMessage(i),e.onerror=i=>{u("WS error",i),this.fail("ws-error")},e.onclose=i=>{!this.settled&&this.parked.state!=="ready"&&(c("WS closed before ready",{code:i&&i.code}),this.fail("ws-closed"))}}sendRequestStream(){this.send({type:"requestStream",correlationId:this.ids.correlationId,payload:{region:this.region,environmentId:this.environmentId,context:this.context}})}onWsMessage(t){let e;try{const i=typeof t.data=="string"?t.data:null;if(i===null)return;e=JSON.parse(i)}catch{return}switch(s("WS \u2190",e.type),e.type){case"ssInfo":this.parked.ssData=e.data;break;case"config":this.onConfig(e);break;case"offer":this.onOffer(e);break;case"answer":this.onAnswer(e);break;case"iceCandidate":this.onIceCandidate(e.candidate);break;case"ping":this.send({type:"pong",source:"front"});break;case"streamerDisconnected":case"playerDisconnected":this.fail("streamer-disconnected");break;case"error":this.fail("orchestration-error");break;default:break}}onConfig(t){if(this.pc)return;const e=Object.assign({},t.peerConnectionOptions);this.forceTURN&&(e.iceTransportPolicy="relay"),e.bundlePolicy=this.forceMaxBundle?"max-bundle":"balanced",e.iceCandidatePoolSize=1,this.parked.config=e;const i=new RTCPeerConnection(e);this.pc=i,this.parked.pc=i,s("PeerConnection created from config"),i.onicecandidate=n=>{n.candidate&&this.send({type:"iceCandidate",candidate:n.candidate})},i.ondatachannel=n=>this.wireDataChannel(n.channel),i.ontrack=n=>{n.track&&n.track.kind==="video"&&n.streams[0]&&(s("video track received"),this.stream=n.streams[0],this.parked.stream=this.stream,this.maybeReady())}}onOffer(t){return this.pc?(this.remoteDescriptionSet=!1,this.iceBuffer.length=0,this.pc.setRemoteDescription(t).then(()=>(this.remoteDescriptionSet=!0,this.flushIce(),this.pc.createAnswer())).then(e=>(e.sdp=this.mungeSDP(e.sdp||""),this.pc.setLocalDescription(e).then(()=>{s("WS \u2192 answer sent"),this.send(e)}))).catch(e=>this.fail("offer-failed",e))):Promise.resolve()}onAnswer(t){return this.pc?this.pc.setRemoteDescription(t).then(()=>{this.remoteDescriptionSet=!0,this.flushIce()}).catch(e=>this.fail("answer-failed",e)):Promise.resolve()}onIceCandidate(t){t&&(this.forceTURN&&String(t.candidate).indexOf("relay")<0||(this.remoteDescriptionSet&&this.pc?this.pc.addIceCandidate(t).catch(()=>{}):this.iceBuffer.push(t)))}flushIce(){for(const t of this.iceBuffer)this.pc.addIceCandidate(t).catch(()=>{});this.iceBuffer.length=0}wireDataChannel(t){t.binaryType="arraybuffer",this.dc=t,this.parked.dc=t,t.onmessage=e=>{this.parked.dcBuffer.push(e.data)},t.onopen=()=>{s("DataChannel open"),this.mark("dc_open"),this.maybeReady()},t.onclose=()=>{!this.settled&&this.parked.state!=="ready"&&(c("DataChannel closed before ready"),this.fail("dc-closed"))},t.readyState==="open"&&this.maybeReady()}maybeReady(){this.settled||!this.dc||this.dc.readyState!=="open"||this.stream&&(this.settled=!0,this.mark("ready"),this.parked.state="ready",s("READY \u2014 parked on window.__stream",this.parked.timings),this.fireSettled())}publishParked(t){const e=this;this.parked={state:t,pc:null,dc:null,stream:null,ws:null,ssData:void 0,machineId:void 0,config:void 0,ids:this.ids,dcBuffer:[],timings:{},adopt(){return e.clearTimers(),this.state="adopted",this},onSettled(i){if(typeof i=="function"){if(this.state!=="connecting"){const n=this.state;Promise.resolve().then(()=>i(n));return}e.settledCb=i}}},window.__stream=this.parked}fireSettled(){const t=this.settledCb;if(t){this.settledCb=null;try{t(this.parked.state)}catch{}}}clearTimers(){this.wsTimeoutId&&(clearTimeout(this.wsTimeoutId),this.wsTimeoutId=null)}fail(t,e){if(!(this.parked&&(this.parked.state==="adopted"||this.parked.state==="failed"))){u("FAILED:",t,e||""),this.settled=!0,this.clearTimers();try{this.dc&&this.dc.close()}catch{}try{this.pc&&this.pc.close()}catch{}try{this.ws&&this.ws.close()}catch{}this.parked&&(this.parked.state="failed",this.parked.failReason=t,e&&(this.parked.failError=String(e&&e.message||e)),this.fireSettled())}}mungeSDP(t){let e=this.prioritizeH264Profile(t,w);e=e.replace(/(a=fmtp:\d+ .*level-asymmetry-allowed=.*)\r\n/gm,`$1;x-google-start-bitrate=10000;x-google-max-bitrate=100000\r
+`);let i="maxaveragebitrate=510000;";return i+=this.forceMonoAudio?"stereo=0;":"stereo=1;",i+="useinbandfec=1",e=e.replace("useinbandfec=1",i),e}prioritizeH264Profile(t,e){const i=t.split(`\r
+`),n=[];for(const r of i)if(r.startsWith("a=fmtp:")&&r.toLowerCase().includes(`profile-level-id=${e}`)){const a=r.split(":")[1]&&r.split(":")[1].split(" ")[0];a&&n.push(a)}return n.length===0?t:i.map(r=>{if(!r.startsWith("m=video"))return r;const a=r.split(" "),x=a.slice(0,3),p=a.slice(3),b=[...n.filter(d=>p.includes(d)),...p.filter(d=>!n.includes(d))];return[...x,...b].join(" ")}).join(`\r
+`)}send(t){const e=typeof t=="string"?t:JSON.stringify(t);if(this.ws&&this.ws.readyState===WebSocket.OPEN)try{this.ws.send(e)}catch{}}mark(t){this.parked&&(this.parked.timings[t]=performance.now())}readRegion(){try{const t=localStorage.getItem(g);if(!t)return null;const e=JSON.parse(t);return!e||typeof e.region_code!="string"||typeof e.ts!="number"||Date.now()-e.ts>=2592e6?null:e.region_code}catch{return null}}fetchWithTimeout(t,e,i){const n=new AbortController;e.signal=n.signal;const r=setTimeout(()=>n.abort(),i);return fetch(t,e).finally(()=>clearTimeout(r))}numberOr(t,e){const i=Number(t);return t!=null&&t!==""&&!Number.isNaN(i)?i:e}boolOr(t,e){return t==="true"||t===""?!0:t==="false"?!1:e}}new y().run()})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3dsource/angular-unreal-module",
-  "version": "0.0.148-dev.2",
+  "version": "0.0.149-dev.0",
   "description": "Unreal module for connect with unreal engine stream",
   "keywords": [
     "3dsource",

package/types/3dsource-angular-unreal-module.d.ts

@@ -231,18 +231,6 @@ interface FreezeFrameMessage {
     progress: number | null;
 }
 
-interface ReconnectConfig {
-    /** Enable auto-reconnection when WebRTC or DataChannel connection is lost. Default: true */
-    enabled?: boolean;
-    /** Maximum number of reconnection attempts before giving up. Default: 3 */
-    maxAttempts?: number;
-    /** Delay in milliseconds between reconnection attempts. Default: 1000 */
-    delayMs?: number;
-    /** Reconnect on ICE connection failure (disconnected/failed state). Default: true */
-    onIceFailure?: boolean;
-    /** Reconnect on DataChannel close. Default: true */
-    onDataChannelClose?: boolean;
-}
 interface UnrealInitialConfig {
     playwright?: boolean;
     customErrorsEndpoint?: string;
@@ -253,8 +241,74 @@ interface UnrealInitialConfig {
     streamTelemetryV2Url?: string;
     fpsMonitor?: boolean;
     autoHighResolution?: boolean;
-    /** Configuration for auto-reconnection behavior */
-    reconnect?: ReconnectConfig;
+}
+
+interface SignalingData {
+    instanceType: string;
+    branchInfo: string;
+    cirrusVersion: string;
+    streamerVersion: string;
+    streamPath: string;
+    streamApp: string;
+    connectionId: string;
+}
+
+/**
+ * Live WebRTC connection parked on `window.__stream` by the `stream-prefetch.js`
+ * head-script, ready for the Angular services to ADOPT instead of building a
+ * connection from scratch. The shape is the handoff contract between that
+ * framework-free script and {@link StreamAdoptionService} — keep the two in sync.
+ */
+interface ParkedStream {
+    state: 'connecting' | 'ready' | 'failed' | 'adopted';
+    pc?: RTCPeerConnection;
+    dc?: RTCDataChannel;
+    /** video(+audio) MediaStream from the `track` event */
+    stream?: MediaStream;
+    /** live signalling socket (handshake already done, `requestStream` sent) */
+    ws?: WebSocket;
+    /** `data` from the streamer's `ssInfo` message — received before adoption */
+    ssData?: SignalingData;
+    /** = resolved wsUrl of the winning machine */
+    machineId?: string;
+    /** `peerConnectionOptions` the machine sent in its `config` message */
+    config?: RTCConfiguration;
+    /** ids the script generated; Angular reuses them (no regeneration) */
+    ids: {
+        clientId: string;
+        viewId: string;
+        correlationId: string;
+    };
+    /** DataChannel messages received before adoption, replayed on adopt */
+    dcBuffer: ArrayBuffer[];
+    /** `performance.now()` marks for the prefetch waterfall (telemetry) */
+    timings: Record<string, number>;
+    failReason?: string;
+    failError?: string;
+    /** Stops the script's watchdog and flips state to `adopted`. */
+    adopt: () => ParkedStream;
+    /**
+     * Register a one-shot callback fired the instant the stream settles
+     * (`ready`/`failed`); fires on the next microtask if already settled. This is
+     * how {@link StreamAdoptionService} adopts event-driven (no polling) — the
+     * head-script must provide it.
+     */
+    onSettled: (cb: (state: ParkedStream['state']) => void) => void;
+}
+declare global {
+    interface Window {
+        __stream?: ParkedStream;
+        /** Main-thread long-task log collected by the optional `perf-longtask.js`
+         *  head-script from page start. Read once at adoption to attribute the
+         *  boot gap. `start`/`dur` are ms in the page `performance.now()` timebase. */
+        __streamPerf?: {
+            longTasks: {
+                start: number;
+                dur: number;
+            }[];
+            supported: boolean;
+        };
+    }
 }
 
 declare const SpecialKeyCodes: {
@@ -364,11 +418,11 @@ declare const REGION_PING_CACHE_TTL_MS: number;
 declare const REGION_PING_ACCURATE_SAMPLES = 3;
 declare const REGION_PING_WARMUP_DEADLINE_MS = 1500;
 declare const REGION_PING_BACKGROUND_REFRESH_DELAY_MS = 5000;
-declare const DEFAULT_RECONNECT_ENABLED = true;
-declare const DEFAULT_RECONNECT_MAX_ATTEMPTS = 3;
-declare const DEFAULT_RECONNECT_DELAY_MS = 1000;
-declare const DEFAULT_RECONNECT_ON_ICE_FAILURE = true;
-declare const DEFAULT_RECONNECT_ON_DATACHANNEL_CLOSE = true;
+declare const RECONNECT_CONFIG: {
+    readonly enabled: true;
+    readonly maxAttempts: 3;
+    readonly delayMs: 1000;
+};
 declare const UnrealStatusMessage: {
     readonly CONNECTING_TO_SESSION: "Connecting to session.";
     readonly STARTING_YOUR_SESSION: "Starting your session";
@@ -381,16 +435,6 @@ interface InputProps {
 
 type Quality = 'lime' | 'red' | 'orange';
 
-interface SignalingData {
-    instanceType: string;
-    branchInfo: string;
-    cirrusVersion: string;
-    streamerVersion: string;
-    streamPath: string;
-    streamApp: string;
-    connectionId: string;
-}
-
 declare const OrchestrationMessageTypes: {
     readonly ping: "ping";
     readonly error: "error";
@@ -879,8 +923,15 @@ declare class RegionsPingService {
      * entry is well-formed and still within {@link REGION_PING_CACHE_TTL_MS}.
      * All access is guarded — `localStorage` can throw (private mode, disabled
      * storage) or be absent (non-browser).
+     *
+     * Public so adopted connections (which skip `getFastest`) can replay the
+     * region-resolving telemetry phase from the same cached winner — see
+     * `UnrealEffects.regionTelemetryOnAdopt$`.
      */
-    private readCachedWinner;
+    readCachedWinner(): {
+        region_code: string;
+        result: number[];
+    } | null;
     private writeCachedWinner;
     /**
      * Accurate, OFF-critical-path refresh of the region cache. Mirrors the
@@ -1002,6 +1053,15 @@ declare class SignallingService extends SubService {
     private pollLoop;
     private connectToCirrus;
     private addWsHandlers;
+    /**
+     * Adopt a live signalling socket opened by the `stream-prefetch.js`
+     * head-script. The socket is already OPEN and `requestStream` was already
+     * sent, so — unlike {@link addWsHandlers} — we attach message/close/error
+     * handlers but deliberately skip {@link OnOpenHandler} (which would
+     * `setCirrusConnected` + re-`sendRequestStream`). Reuses the head-script's
+     * `correlationId` so subsequent correlated messages line up.
+     */
+    adoptSocket(ws: WebSocket, correlationId: string): void;
     private showStatusMessage;
     /**
      * Close the connection with the signaling server
@@ -1021,6 +1081,64 @@ declare class SignallingService extends SubService {
     static ɵprov: i0.ɵɵInjectableDeclaration<SignallingService>;
 }
 
+/**
+ * Adopts a WebRTC connection prefetched by the `stream-prefetch.js` head-script
+ * and parked on `window.__stream`, instead of running `connectToSignaling` from
+ * scratch. Called from the same seam where signalling normally starts
+ * (`connectToSignaling$` effect); if there is nothing ready to adopt it returns
+ * `false` and the caller falls back to the normal connect — strictly additive.
+ */
+declare class StreamAdoptionService {
+    private readonly store;
+    private readonly signalling;
+    private readonly webRtc;
+    /**
+     * Decide adoption, WAITING for an in-flight prefetch instead of racing it.
+     *
+     * - nothing parked → emit `false` at once (caller connects normally).
+     * - already settled (`ready`/`failed`/`adopted`) → adopt-if-ready at once.
+     * - still `connecting` → wait for the script's `onSettled` callback and
+     *   adopt-if-ready the instant it fires (event-driven, zero polling latency).
+     *
+     * Deliberately NO time budget: for DIRECT orchestration the prefetch holds
+     * the socket open while the orchestrator provisions a machine, which can take
+     * minutes (150–200s+). A fixed deadline would make Angular give up and open a
+     * second connection mid-provisioning — exactly the race/orphan this avoids.
+     * The wait is bounded by liveness instead: the script flips the parked state
+     * to `failed` on a dead socket (`ws.onclose`/`onerror`), and the caller wraps
+     * this in `takeUntil(abortEstablishingConnection)`, so a route change / teardown
+     * cancels it. Emits exactly once. Cancelling runs no adoption — which is what
+     * stops a fast route-switch from starting overlapping connections.
+     *
+     * Wrapped in `defer` so the `tryAdopt()` side effect (which dispatches
+     * `streamAdopted`) runs at SUBSCRIPTION time, not when the observable is
+     * built. The effect prepends `startWith(setEstablishingConnection(true))`,
+     * which starts the telemetry session and subscribes its phase catalog; that
+     * must happen BEFORE `streamAdopted` → `regionTelemetryOnAdopt$` replays
+     * `regionResolved`, or the region phase fires into a session that doesn't
+     * exist yet and is lost. `defer` guarantees that ordering.
+     */
+    awaitAndAdopt$(): Observable<boolean>;
+    /**
+     * Event-driven wait: the script fires `onSettled` the instant it parks
+     * `ready`/`failed`, so we adopt with zero polling lag. Emits exactly once.
+     *
+     * No timer/budget by design: an indefinitely `connecting` stream is valid
+     * (DIRECT orchestration holds the socket open for minutes while it
+     * provisions), and every terminal state — including a dead socket — flips to
+     * `ready`/`failed` and fires the hook. Teardown (route change → unsubscribe)
+     * sets `done`, so a late callback after cancel can't trigger a stray adoption.
+     */
+    private awaitSettled$;
+    /**
+     * @returns `true` if a ready parked stream was adopted (caller must NOT
+     *          start a fresh connection), `false` otherwise.
+     */
+    tryAdopt(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StreamAdoptionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<StreamAdoptionService>;
+}
+
 declare class StreamStatusTelemetryService extends SubService {
     private readonly videoService;
     private readonly unrealConfig;
@@ -1108,6 +1226,17 @@ declare class StreamStatusTelemetryService2 {
     private readonly disconnectReason$;
     private readonly errorMessage$;
     private readonly viewPortReady$;
+    /**
+     * Synchronous adoption flag. The `streamAdopted` reducer sets it BEFORE any
+     * action subscriber runs, so the connection-phase closers (which fire inside
+     * the same dispatch, e.g. `ssinfo-received` off the `ssData` state change)
+     * can read it and defer to the prefetch-timed attribution emitted by
+     * {@link emitAdoptedConnection} instead of recording the live wall-clock.
+     */
+    private readonly adopted$;
+    /** Streamer identity for the adopted signaling phase params. */
+    private readonly ssData$;
+    private readonly awsInstance$;
     private session;
     /**
      * Whether a session has already started during the current page lifetime.
@@ -1171,6 +1300,36 @@ declare class StreamStatusTelemetryService2 {
      * are derived from neighbor phases.
      */
     private emitPhaseEnded;
+    /**
+     * Emit the region / signaling / webrtc phases for an ADOPTED connection.
+     *
+     * The prefetch script established the connection in PARALLEL with page load,
+     * so the phases are positioned at their real (anchor-relative) spans — shifted
+     * LEFT to overlap the HTML-loading / route-idle rows — rather than sequentially
+     * after them. That's the whole point of the prefetch: the handshake already
+     * happened while the page was loading. Each phase ships:
+     *  - `duration` — the real sub-step time the prefetch spent.
+     *  - `spanStartMs` — anchor-relative start, so the viewer left-shifts the bar.
+     *  - `adoptionAtMs` — where Angular took over (the next phase, Unreal
+     *    communication, resumes here on the sequential timeline).
+     *  - savings params: `prefetchConnectMs` (full handshake), `prefetchSavedMs`
+     *    (done before Angular was ready), `adoptionWaitMs` (real connect→adopted
+     *    wait), `adoptionOverheadMs` (prefetch-ready → adopted gap).
+     */
+    private emitAdoptedConnection;
+    /**
+     * Emit one adopted phase positioned at its real `spanStartMs` (left-shifted
+     * to overlap page load) with its real prefetch `duration`. `prefetched`,
+     * `spanStartMs` and `adoptionAtMs` ride as top-level wire fields the viewer
+     * uses to lay the bar out; the rest become display params.
+     */
+    private emitAdoptedPhase;
+    /** Streamer identity params for the adopted signaling phase — mirrors the
+     *  `ssinfo-received` closer's shape (client / instanceName / …ssData). */
+    private adoptedSignalingParams;
+    /** Read the region-ping cache the prefetch reused (localStorage), so the
+     *  adopted region phase can still report the winning region + samples. */
+    private readRegionCache;
     private handleWindow;
     private evaluateAnomalies;
     private updateMaxFpsTarget;
@@ -1399,6 +1558,16 @@ declare class WebRtcPlayerService extends SubService {
      * @returns true if reconnection was initiated, false if signaling is not connected
      */
     reconnectPeer(): boolean;
+    /**
+     * Adopt a fully-negotiated connection prefetched by `stream-prefetch.js`:
+     * take ownership of its PeerConnection, DataChannel and media stream instead
+     * of running the handshake. The head-script attached property-based handlers
+     * (`pc.onicecandidate`, `dc.onmessage`, …) and buffered inbound DC messages;
+     * here we detach those, wire our own (addEventListener-based) handlers, replay
+     * the buffer in order, then drive `onDataChannelConnected` manually because the
+     * DataChannel is already open (its `open` event won't fire again).
+     */
+    adopt(pc: RTCPeerConnection, dc: RTCDataChannel, stream: MediaStream, config: RTCConfiguration, dcBuffer: ArrayBuffer[]): void;
     private setConfig;
     private handlePeerConnectionEvents;
     private setupTransceiversAsync;
@@ -2460,6 +2629,44 @@ declare const showUnrealErrorMessage: node_modules__ngrx_store_types_ngrx_store.
     error?: string;
 } & node_modules__ngrx_store_types_ngrx_store.Action<string>>;
 declare const initSignalling: node_modules__ngrx_store_types_ngrx_store.ActionCreator<string, () => node_modules__ngrx_store_types_ngrx_store.Action<string>>;
+/**
+ * Dispatched when a prefetched connection parked on `window.__stream` by the
+ * `stream-prefetch.js` head-script is adopted instead of opening a fresh
+ * `connectToSignaling`. Marks cirrus connected and records the adopted machine
+ * in one transaction; the data channel / app-init chain then proceeds via
+ * `dataChannelConnected` dispatched from `WebRtcPlayerService`.
+ *
+ * Deliberately does NOT touch `streamClientCompanyId` / `streamViewId`: the host
+ * app (e.g. metabox) sets those authoritatively from its own data before
+ * `initSignalling`, and the prefetch script's ids are connection-internal only.
+ */
+declare const streamAdopted: node_modules__ngrx_store_types_ngrx_store.ActionCreator<string, (props: {
+    machineId: string | null;
+    ssData: SignalingData | null;
+    /**
+     * `performance.now()` marks the prefetch script recorded while it
+     * established the connection (`prefetch_start` / `ws_open` / `dc_open` /
+     * `ready`), on the page navigation timeline. The telemetry service uses
+     * them to attribute the signaling / webrtc phase durations to the time the
+     * prefetch actually spent — instead of dumping the whole pre-adoption wait
+     * onto whichever phase closer happens to fire first. `null` when adopting a
+     * stream that carried no timings.
+     */
+    timings: Record<string, number> | null;
+}) => {
+    machineId: string | null;
+    ssData: SignalingData | null;
+    /**
+     * `performance.now()` marks the prefetch script recorded while it
+     * established the connection (`prefetch_start` / `ws_open` / `dc_open` /
+     * `ready`), on the page navigation timeline. The telemetry service uses
+     * them to attribute the signaling / webrtc phase durations to the time the
+     * prefetch actually spent — instead of dumping the whole pre-adoption wait
+     * onto whichever phase closer happens to fire first. `null` when adopting a
+     * stream that carried no timings.
+     */
+    timings: Record<string, number> | null;
+} & node_modules__ngrx_store_types_ngrx_store.Action<string>>;
 declare const startStream: node_modules__ngrx_store_types_ngrx_store.ActionCreator<string, (props: {
     config: Partial<StreamConfig>;
 }) => {
@@ -2556,11 +2763,11 @@ declare class UnrealEffects {
     private readonly commandTelemetryService;
     private readonly regionsPingService;
     private readonly signallingService;
+    private readonly streamAdoptionService;
     private readonly videoService;
     private readonly unrealCallbackService;
     private dataChannelConnectionTimeout;
     private connectionCompleted$;
-    private reconnectConfig;
     destroyConnections$: node_modules_rxjs_dist_types.Observable<{
         reason: _3dsource_angular_unreal_module.DisconnectReasonType;
     } & node_modules__ngrx_store_types_ngrx_store.Action<string>> & node_modules__ngrx_effects_types_ngrx_effects.CreateEffectMetadata;
@@ -2628,8 +2835,8 @@ declare class UnrealEffects {
      * Effect: `handleDataChannelClosed$`
      *
      * Triggers peer reconnection when DataChannel closes unexpectedly.
-     * Only triggers if reconnection is enabled, onDataChannelClose is true,
-     * and the signaling WebSocket is still connected.
+     * Only triggers if reconnection is enabled and the signaling WebSocket
+     * is still connected.
      */
     handleDataChannelClosed$: node_modules_rxjs_dist_types.Observable<{
         attempt: number;
@@ -2674,7 +2881,9 @@ declare class UnrealEffects {
         id: string;
         now: number;
     } & node_modules__ngrx_store_types_ngrx_store.Action<string>> & node_modules__ngrx_effects_types_ngrx_effects.CreateEffectMetadata;
-    connectToSignaling$: node_modules_rxjs_dist_types.Observable<WebSocket> & node_modules__ngrx_effects_types_ngrx_effects.CreateEffectMetadata;
+    connectToSignaling$: node_modules_rxjs_dist_types.Observable<{
+        value: boolean;
+    } & node_modules__ngrx_store_types_ngrx_store.Action<string>> & node_modules__ngrx_effects_types_ngrx_effects.CreateEffectMetadata;
     private canPeerReconnect;
     /**
      * Either schedules the next peer-reconnect attempt or gives up with the
@@ -2691,6 +2900,7 @@ declare const unrealFeature: {
     name: "unrealFeature";
     reducer: node_modules__ngrx_store_types_ngrx_store.ActionReducer<_3dsource_angular_unreal_module.UnrealState, node_modules__ngrx_store_types_ngrx_store.Action<string>>;
     selectUnrealFeatureState: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, _3dsource_angular_unreal_module.UnrealState, (featureState: _3dsource_angular_unreal_module.UnrealState) => _3dsource_angular_unreal_module.UnrealState>;
+    selectAdopted: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, boolean, (featureState: _3dsource_angular_unreal_module.UnrealState) => boolean>;
     selectFreezeFrame: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, _3dsource_angular_unreal_module.FreezeFrameMessage, (featureState: _3dsource_angular_unreal_module.UnrealState) => _3dsource_angular_unreal_module.FreezeFrameMessage>;
     selectIsVideoPlaying: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, boolean, (featureState: _3dsource_angular_unreal_module.UnrealState) => boolean>;
     selectStatusMessage: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, string | null, (featureState: _3dsource_angular_unreal_module.UnrealState) => string | null>;
@@ -2747,6 +2957,13 @@ interface UnrealState {
     isAfkTimerVisible: boolean;
     afkCountdown: number;
     cirrusConnected: boolean;
+    /**
+     * True once a prefetched connection has been adopted (`streamAdopted`).
+     * Read synchronously by the telemetry service so the connection-phase
+     * closers know to defer to the prefetch-timed attribution instead of the
+     * live-event one. Reset on every fresh attempt / disconnect.
+     */
+    adopted: boolean;
     viewportReady: boolean;
     freezeFrameFromVideo: FreezeFrameMessage;
     freezeFrame: FreezeFrameMessage;
@@ -2832,5 +3049,5 @@ declare const selectUserInactivityDetected: node_modules__ngrx_store_types_ngrx_
 /** Used by external consumers (e.g., metabox). Do not remove. */
 declare const selectIsVideoPlayingAndDataChannelConnected: node_modules__ngrx_store_types_ngrx_store.MemoizedSelector<Record<string, any>, boolean, (s1: boolean, s2: boolean) => boolean>;
 
-export { AFKService, AUTO_HIGH_RESOLUTION_IDLE_MS, AfkTimeoutModalComponent, AggregatorService, AnalyticsService, AnswerHandler, CommandTelemetryService, ConfigHandler, ConsoleExtensionsService, ControlScheme, DATA_CHANNEL_CONNECTION_TIMEOUT, DEBOUNCE_TO_MANY_RESIZE_CALLS, DEFAULT_AFK_TIMEOUT, DEFAULT_AFK_TIMEOUT_PERIOD, DEFAULT_RECONNECT_DELAY_MS, DEFAULT_RECONNECT_ENABLED, DEFAULT_RECONNECT_MAX_ATTEMPTS, DEFAULT_RECONNECT_ON_DATACHANNEL_CLOSE, DEFAULT_RECONNECT_ON_ICE_FAILURE, DESTROY_DISCONNECT_REASONS, DataFlowMonitor, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, FileHandlerService, FileReceiverService, FilterSettingsComponent, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, INNER_RETRY_LIMIT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, KalmanFilter1D, LatencyTimings, LoadingProgressService, LowBandwidthDetectorComponent, LowBandwidthModalComponent, MINIMAL_FPS, MIN_CONTAINER_SIZE, MessageType, MouseButton, MouseButtonsMask, OUTER_RETRY_DELAY, OnCloseHandler, OnErrorHandler, OnMessageHandler, OnOpenHandler, OrchestrationMessageTypes, POLLING_TIME, PingHandler, PlayerCountHandler, REGION_PING_ACCURATE_SAMPLES, REGION_PING_BACKGROUND_REFRESH_DELAY_MS, REGION_PING_CACHE_KEY, REGION_PING_CACHE_TTL_MS, REGION_PING_WARMUP_DEADLINE_MS, RegionsPingService, SAME_SIZE_THRESHOLD, SCREEN_LOCKER_CONTAINER_ID, SIGNALLING_PERCENT_VALUE, SSInfoHandler, STREAMING_AUDIO_ID, STREAMING_VIDEO_ID, SafePipe, SignallingService, SpecialKeyCodes, StatGraphComponent, StreamStatusTelemetryService, StreamStatusTelemetryService2, SubService, ToClientMessage, UNREAL_CONFIG, UnrealCallbackService, UnrealCommunicatorService, UnrealEffects, UnrealSceneComponent, UnrealStatusMessage, VideoService, VideoStatsComponent, WSCloseCode_CIRRUS_ABNORMAL_CLOSURE, WSCloseCode_CIRRUS_MAX_PLAYERS_ERROR, WSCloseCode_CIRRUS_PLAYER_DISCONNECTED, WSCloseCode_CIRRUS_STREAMER_KIKED_PLAYER, WSCloseCode_FORCE_CIRRUS_CLOSE, WSCloseCode_NORMAL_AFK_TIMEOUT, WSCloseCode_NORMAL_CLOSURE, WSCloseCode_NORMAL_MANUAL_DISCONNECT, WSCloseCode_UNKNOWN, WSCloseCodes, WS_OPEN_STATE, WS_RETRY_PER_INSTANCE, WS_TIMEOUT, WebRtcPlayerService, WebrtcErrorModalComponent, abortEstablishingConnection, answerSent, changeStatusMainVideoOnScene, changeStreamResolutionAction, commandCompleted, commandStarted, dataChannelConnected, dataChannelReady, decodeData, destroyRemoteConnections, destroyUnrealScene, disconnectStream, dispatchResize, dropConnection, dropDC, dropPC, floatToPercents, floatToSmoothPercents, forceResizeViewport, fromResizeObserver, getActiveUrl, getImageFromVideoStream, getResizeStudioValues, getResizeValuesUniversal, getRtcErrorMessage, iceConnectionFailed, initSignalling, instanceReady, keepMaxUntilReset, makeEven, pollingEnded, pollingStarted, provideUnrealModule, provideUnrealState, qpToQuality, reconnectPeer, reconnectPeerFailed, reconnectPeerSuccess, regionPingFetchEnd, regionPingFetchStart, regionResolved, resetAfk, resetConfig, resetDataChannelForReconnect, resetIntroSrc, resetUserInactivityTimeout, resetWarnTimeout, saveAnalyticsEvent, selectCirrusConnectionId, selectClientAndViewIds, selectCommandProgress, selectFreezeFrameCombinedDataUrl, selectFreezeFrameDataUrl, selectFreezeFrameDataUrlFromVideo, selectFreezeFrameProgressMessageFromVideo, selectIsAutostart, selectIsExistMatchUrls, selectIsFreezeFrameLoading, selectIsFullyConnected, selectIsLoaderScreenVisible, selectIsVideoPlayingAndDataChannelConnected, selectShowLoader, selectShowReconnectPopup, selectSignalingParameters, selectStreamConfig, selectTotalProgress, selectUserInactivityDetected, selectWarnTimeout, setAfkTimerCountdown, setAfkTimerHide, setAfkTimerVisible, setAwsInstance, setCirrusConnected, setCirrusDisconnected, setConfig, setEstablishingConnection, setFreezeFrame, setFreezeFrameFromVideo, setIntroImageSrc, setIntroVideoSrc, setLoadingImageSrc, setLoopBackCommandIsCompleted, setMaxFps, setOrchestrationContext, setOrchestrationMessage, setOrchestrationParameters, setOrchestrationProgress, setSignalingName, setStatusMessage, setStatusPercentSignallingServer, setStreamClientCompanyId, setStreamViewId, setUnrealPlaywrightConfig, setUserInactivityTimeout, setViewportNotReady, setViewportReady, showLoadingProgress, showResumeStreamPopup, showUnrealErrorMessage, showUserInactivityTimeoutPopup, signalingRetryAttempted, smoothTransition, startStream, trackMixpanelEvent, trackTelemetryData, uint8ToBase64, unrealCommandCallback, unrealFeature, unrealReducer, updateCirrusInfo, videoAdaptedToContainer, videoStreamInitialized };
-export type { AggregatedStat, AnySignalingMessage, AwsInstance, CandidateMessage, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, DataFlowCheckResult, DisconnectReasonType, EmittedMilestone, EventId, ForceClientDisconnect, FreezeFrameMessage, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, PhaseOverlay, PhaseParam, PingMessage, PlayerCountMessage, PollingOrchestrationMessage, Quality, ReceivedFile, ReconnectConfig, RequestStream, SSInfo, SelectedIceCandidatePair, SignalingData, SignalingMessageHandler, SignalingMessageMap, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamerListMessage, TelemetryType, UnknownFields, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealInitialConfig, UnrealState, WSCloseCodesValues, streamPreparedForUserInteractionMessage };
+export { AFKService, AUTO_HIGH_RESOLUTION_IDLE_MS, AfkTimeoutModalComponent, AggregatorService, AnalyticsService, AnswerHandler, CommandTelemetryService, ConfigHandler, ConsoleExtensionsService, ControlScheme, DATA_CHANNEL_CONNECTION_TIMEOUT, DEBOUNCE_TO_MANY_RESIZE_CALLS, DEFAULT_AFK_TIMEOUT, DEFAULT_AFK_TIMEOUT_PERIOD, DESTROY_DISCONNECT_REASONS, DataFlowMonitor, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, FileHandlerService, FileReceiverService, FilterSettingsComponent, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, INNER_RETRY_LIMIT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, KalmanFilter1D, LatencyTimings, LoadingProgressService, LowBandwidthDetectorComponent, LowBandwidthModalComponent, MINIMAL_FPS, MIN_CONTAINER_SIZE, MessageType, MouseButton, MouseButtonsMask, OUTER_RETRY_DELAY, OnCloseHandler, OnErrorHandler, OnMessageHandler, OnOpenHandler, OrchestrationMessageTypes, POLLING_TIME, PingHandler, PlayerCountHandler, RECONNECT_CONFIG, REGION_PING_ACCURATE_SAMPLES, REGION_PING_BACKGROUND_REFRESH_DELAY_MS, REGION_PING_CACHE_KEY, REGION_PING_CACHE_TTL_MS, REGION_PING_WARMUP_DEADLINE_MS, RegionsPingService, SAME_SIZE_THRESHOLD, SCREEN_LOCKER_CONTAINER_ID, SIGNALLING_PERCENT_VALUE, SSInfoHandler, STREAMING_AUDIO_ID, STREAMING_VIDEO_ID, SafePipe, SignallingService, SpecialKeyCodes, StatGraphComponent, StreamAdoptionService, StreamStatusTelemetryService, StreamStatusTelemetryService2, SubService, ToClientMessage, UNREAL_CONFIG, UnrealCallbackService, UnrealCommunicatorService, UnrealEffects, UnrealSceneComponent, UnrealStatusMessage, VideoService, VideoStatsComponent, WSCloseCode_CIRRUS_ABNORMAL_CLOSURE, WSCloseCode_CIRRUS_MAX_PLAYERS_ERROR, WSCloseCode_CIRRUS_PLAYER_DISCONNECTED, WSCloseCode_CIRRUS_STREAMER_KIKED_PLAYER, WSCloseCode_FORCE_CIRRUS_CLOSE, WSCloseCode_NORMAL_AFK_TIMEOUT, WSCloseCode_NORMAL_CLOSURE, WSCloseCode_NORMAL_MANUAL_DISCONNECT, WSCloseCode_UNKNOWN, WSCloseCodes, WS_OPEN_STATE, WS_RETRY_PER_INSTANCE, WS_TIMEOUT, WebRtcPlayerService, WebrtcErrorModalComponent, abortEstablishingConnection, answerSent, changeStatusMainVideoOnScene, changeStreamResolutionAction, commandCompleted, commandStarted, dataChannelConnected, dataChannelReady, decodeData, destroyRemoteConnections, destroyUnrealScene, disconnectStream, dispatchResize, dropConnection, dropDC, dropPC, floatToPercents, floatToSmoothPercents, forceResizeViewport, fromResizeObserver, getActiveUrl, getImageFromVideoStream, getResizeStudioValues, getResizeValuesUniversal, getRtcErrorMessage, iceConnectionFailed, initSignalling, instanceReady, keepMaxUntilReset, makeEven, pollingEnded, pollingStarted, provideUnrealModule, provideUnrealState, qpToQuality, reconnectPeer, reconnectPeerFailed, reconnectPeerSuccess, regionPingFetchEnd, regionPingFetchStart, regionResolved, resetAfk, resetConfig, resetDataChannelForReconnect, resetIntroSrc, resetUserInactivityTimeout, resetWarnTimeout, saveAnalyticsEvent, selectCirrusConnectionId, selectClientAndViewIds, selectCommandProgress, selectFreezeFrameCombinedDataUrl, selectFreezeFrameDataUrl, selectFreezeFrameDataUrlFromVideo, selectFreezeFrameProgressMessageFromVideo, selectIsAutostart, selectIsExistMatchUrls, selectIsFreezeFrameLoading, selectIsFullyConnected, selectIsLoaderScreenVisible, selectIsVideoPlayingAndDataChannelConnected, selectShowLoader, selectShowReconnectPopup, selectSignalingParameters, selectStreamConfig, selectTotalProgress, selectUserInactivityDetected, selectWarnTimeout, setAfkTimerCountdown, setAfkTimerHide, setAfkTimerVisible, setAwsInstance, setCirrusConnected, setCirrusDisconnected, setConfig, setEstablishingConnection, setFreezeFrame, setFreezeFrameFromVideo, setIntroImageSrc, setIntroVideoSrc, setLoadingImageSrc, setLoopBackCommandIsCompleted, setMaxFps, setOrchestrationContext, setOrchestrationMessage, setOrchestrationParameters, setOrchestrationProgress, setSignalingName, setStatusMessage, setStatusPercentSignallingServer, setStreamClientCompanyId, setStreamViewId, setUnrealPlaywrightConfig, setUserInactivityTimeout, setViewportNotReady, setViewportReady, showLoadingProgress, showResumeStreamPopup, showUnrealErrorMessage, showUserInactivityTimeoutPopup, signalingRetryAttempted, smoothTransition, startStream, streamAdopted, trackMixpanelEvent, trackTelemetryData, uint8ToBase64, unrealCommandCallback, unrealFeature, unrealReducer, updateCirrusInfo, videoAdaptedToContainer, videoStreamInitialized };
+export type { AggregatedStat, AnySignalingMessage, AwsInstance, CandidateMessage, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, DataFlowCheckResult, DisconnectReasonType, EmittedMilestone, EventId, ForceClientDisconnect, FreezeFrameMessage, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, ParkedStream, PhaseOverlay, PhaseParam, PingMessage, PlayerCountMessage, PollingOrchestrationMessage, Quality, ReceivedFile, RequestStream, SSInfo, SelectedIceCandidatePair, SignalingData, SignalingMessageHandler, SignalingMessageMap, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamerListMessage, TelemetryType, UnknownFields, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealInitialConfig, UnrealState, WSCloseCodesValues, streamPreparedForUserInteractionMessage };