@3dsource/angular-unreal-module 0.0.162 → 0.0.164

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

@@ -338,11 +338,17 @@ interface ParkedStream {
     machineId?: string;
     /** `peerConnectionOptions` the machine sent in its `config` message */
     config?: RTCConfiguration;
-    /** ids the script generated; Angular reuses them (no regeneration) */
+    /**
+     * ids the script generated; Angular reuses them (no regeneration).
+     * `streamRequestId` is the exception — it is NOT generated but read from the
+     * polling response and passed to Cirrus on the upgrade URL; empty when the
+     * backend didn't issue one.
+     */
     ids: {
         clientId: string;
         viewId: string;
         correlationId: string;
+        streamRequestId?: string;
     };
     /** DataChannel messages received before adoption, replayed on adopt */
     dcBuffer: ArrayBuffer[];
@@ -374,7 +380,6 @@ interface InputProps {
 type Quality = 'lime' | 'red' | 'orange';
 
 declare const OrchestrationMessageTypes: {
-    readonly ping: "ping";
     readonly error: "error";
     readonly offer: "offer";
     readonly answer: "answer";
@@ -388,8 +393,6 @@ declare const OrchestrationMessageTypes: {
     readonly instanceReady: "instanceReady";
     readonly p2pEstablished: "p2pEstablished";
     readonly instanceReserved: "instanceReserved";
-    readonly playerDisconnected: "playerDisconnected";
-    readonly streamerDisconnected: "streamerDisconnected";
     readonly interruptClientStream: "interruptClientStream";
 };
 interface InstanceReady extends MessageBase {
@@ -445,11 +448,6 @@ interface CandidateMessage extends MessageBase {
     type: 'iceCandidate';
     candidate: RTCIceCandidate;
 }
-interface PingMessage extends MessageBase {
-    type: 'ping';
-    playerId: string;
-    appConnectionCounter: number;
-}
 type UnknownFields = Record<string, unknown>;
 interface InterruptClientStream extends MessageBase {
     type: 'interruptClientStream';
@@ -458,10 +456,6 @@ interface InterruptClientStream extends MessageBase {
         environmentId: string;
     };
 }
-interface ForceClientDisconnect extends MessageBase {
-    type: 'streamerDisconnected' | 'playerDisconnected';
-    connectionId: string;
-}
 interface ListStreamersMessage extends MessageBase {
     type: 'listStreamers';
     correlationId: string;
@@ -530,7 +524,6 @@ interface MetaboxCustomApplicationContext {
 }
 type StreamRequestContext = MetaboxStudioContext | MetaboxProductContext | CustomApplicationContext | MetaboxCustomApplicationContext | MetaboxEnvironmentContext | MetaboxBasicConfiguratorContext | MetaboxModularConfiguratorContext;
 interface SignalingMessageMap {
-    [OrchestrationMessageTypes.ping]: PingMessage;
     [OrchestrationMessageTypes.offer]: RTCSessionDescriptionInit;
     [OrchestrationMessageTypes.error]: OrchestrationErrorMessage;
     [OrchestrationMessageTypes.ssInfo]: SSInfo;
@@ -544,8 +537,6 @@ interface SignalingMessageMap {
     [OrchestrationMessageTypes.listStreamers]: ListStreamersMessage;
     [OrchestrationMessageTypes.p2pEstablished]: P2PEstablishedMessage;
     [OrchestrationMessageTypes.instanceReserved]: InstanceReserved;
-    [OrchestrationMessageTypes.playerDisconnected]: ForceClientDisconnect;
-    [OrchestrationMessageTypes.streamerDisconnected]: ForceClientDisconnect;
     [OrchestrationMessageTypes.interruptClientStream]: InterruptClientStream;
 }
 type OrchestrationMessageType = keyof SignalingMessageMap;
@@ -554,6 +545,12 @@ type SignalingMessageHandler<T extends keyof SignalingMessageMap> = (msg: Signal
 interface PollingOrchestrationMessage {
     mm_message?: string;
     signallingServer?: string;
+    /**
+     * Connection id issued by the orchestration for this stream request. Kept
+     * internally as `connectionId` and handed to Cirrus on the WS upgrade URL.
+     * Absent on older backends — Cirrus then generates one itself.
+     */
+    streamRequestId?: string;
     error?: string;
     info?: {
         age: number | null;
@@ -877,11 +874,29 @@ interface InboundVideoStats extends RTCInboundRtpStreamStats {
     receiveToCompositeMs: number;
     bitrate: number;
 }
+/**
+ * Which orchestration transport was asked for the Cirrus endpoint:
+ *  - `polling` — HTTP orchestration poll (`requestCirrusViaPolling`)
+ *  - `socket`  — orchestration control socket + `instanceReady`
+ *                (`requestCirrusViaSocket`)
+ *
+ * Undefined when nothing was requested at all — a `ws://` URL that already points
+ * at Cirrus (`requestCirrusDirect`, dev/playwright) or an adopted prefetched
+ * stream. Those are not request kinds, they are the absence of a request.
+ *
+ * Replaces the previous hostname sniffing (`/^wss:\/\/orchestration-websocket/`)
+ * in `selectTotalProgress` — the flow is now stated, not guessed.
+ */
+type CirrusRequestKind = 'polling' | 'socket';
 interface AwsInstance {
     /**
-     * WebSocket URL for connecting to the Cirrus (polling mode) or Orchestration (direct mode).
+     * WebSocket URL of the CIRRUS the player connects to. In the socket flow
+     * this is the stream machine's `originInstanceUri`, NOT the orchestration
+     * URL (the control socket is tracked separately by `SignallingService`).
      */
     wsUrl: string | null;
+    /** See {@link CirrusRequestKind}. */
+    kind?: CirrusRequestKind;
     pollingUrl: string | null;
     instanceName: string | null;
     /**
@@ -924,6 +939,7 @@ declare const POLLING_TIME = 4000;
 declare const INNER_RETRY_LIMIT = 3;
 declare const OUTER_RETRY_DELAY: number;
 declare const WS_RETRY_PER_INSTANCE = 1;
+declare const INSTANCE_READY_TIMEOUT = 180000;
 declare const WS_OPEN_STATE = 1;
 declare const DEFAULT_AFK_TIMEOUT_PERIOD = 15;
 declare const DEFAULT_AFK_TIMEOUT = 300;
@@ -1320,13 +1336,18 @@ declare class SignallingService extends SubService {
     onConfig$: Subject<ConfigMessage>;
     onWebRtcIce$: Subject<RTCIceCandidate>;
     onWebRtcAnswer$: Subject<RTCSessionDescriptionInit | null>;
+    onInstanceReady$: Subject<{
+        instanceId: string;
+        originInstanceId: string;
+        ipAddress: string;
+        streamRequestId: string;
+        originInstanceUri: string;
+    }>;
     abort$: Observable<_ngrx_store.Action<string>>;
     private ws;
-    private streamWs;
-    private streamMachineConnected;
-    private streamMachineRetryCount;
-    private streamWsSub?;
+    private controlWs;
     orchestrationRetrySub?: Subscription;
+    orchestrationRetryCount: number;
     private wsMsgHandlers;
     protected correlationId: string;
     constructor();
@@ -1334,7 +1355,7 @@ declare class SignallingService extends SubService {
     connectToSignaling(urlList: string[]): Observable<WebSocket>;
     /**
      * One inner cycle: rotate `urlGen` over the pool, resolve via
-     * {@link getAwsInstance}, open WS via {@link connectToCirrus},
+     * {@link requestCirrus}, open WS via {@link connectToCirrus},
      * retry up to {@link INNER_RETRY_LIMIT} on any hard failure. The
      * urlGen lives in this closure so retries advance through the
      * pool. Exhaustion bubbles to {@link connectToSignaling}'s outer
@@ -1354,17 +1375,37 @@ declare class SignallingService extends SubService {
     protected startEstablishingConnection(): void;
     private adaptUrlsToRegion;
     /**
-     * Resolve one URL to an `AwsInstance`. Dispatches to
-     * {@link directWsInstance} for `ws://` / `wss://` URLs, otherwise
-     * to {@link pollOrchestration}.
+     * Ask the orchestration for a Cirrus to connect to. All three
+     * implementations answer the same question — "which Cirrus, and with which
+     * `streamRequestId`?" — and emit ONE `AwsInstance` whose `wsUrl` is a Cirrus
+     * address. What differs is only how the answer is obtained and therefore how
+     * it can fail:
+     *
+     * | Method                     | Transport            | Fails on                       |
+     * | -------------------------- | -------------------- | ------------------------------ |
+     * | {@link requestCirrusViaPolling} | HTTP poll loop  | HTTP 4xx (dead URL)            |
+     * | {@link requestCirrusViaSocket}  | control WS      | socket drop / no `instanceReady` in {@link INSTANCE_READY_TIMEOUT} |
+     * | {@link requestCirrusDirect}     | none (dev)      | never — nothing is requested   |
+     *
+     * Whatever they return goes through the SAME downstream in
+     * {@link connectAttempt}: `setAwsInstance` → `connectToCirrus` → the WS-only
+     * and URL-rotating retry tiers. A failure inside any of them is just an
+     * error on this observable, so those tiers handle it uniformly.
+     */
+    private requestCirrus;
+    /** True when `requestStream` can be composed → new orchestration. */
+    private hasOrchestrationContext;
+    /**
+     * Wait until `clientId` and `viewId` are known — every request method needs
+     * them before it may talk to the backend.
      */
-    private getAwsInstance;
+    private waitForClientAndViewIds;
     /**
-     * Direct `ws://` / `wss://` short-circuit — no HTTP orchestration.
-     * Waits for `clientId` and `viewId` to be truthy in the store, then
-     * emits a `Direct Connection` `AwsInstance` and completes.
+     * Direct `ws://` / `wss://` short-circuit — no orchestration at all, the URL
+     * already points at Cirrus. Dev/playwright convenience, hence no
+     * `kind`: nothing was requested.
      */
-    private directWsInstance;
+    private requestCirrusDirect;
     /**
      * HTTP-orchestration path. Brackets {@link pollLoop} with the
      * `pollingStarted`/`pollingEnded` actions and the `EXT-getSignaling`
@@ -1372,7 +1413,34 @@ declare class SignallingService extends SubService {
      * last response captured in the closure). Maps the final ready
      * response to an `AwsInstance`.
      */
-    private pollOrchestration;
+    private requestCirrusViaPolling;
+    /**
+     * WS-orchestration path — the socket-transport twin of
+     * {@link requestCirrusViaPolling}. Opens the control socket, sends
+     * `requestStream` and waits for `instanceReady`, whose `originInstanceUri`
+     * IS the Cirrus address.
+     *
+     * Failure modes are handled here so they surface as a plain error and reach
+     * `connectAttempt`'s retry tiers (previously this branch lived outside them
+     * and a dead control socket silently hung the session):
+     *  - control socket closes/errors before `instanceReady` → error
+     *  - no `instanceReady` within {@link INSTANCE_READY_TIMEOUT} → error
+     *
+     * The control socket lives exactly as long as this wait — see
+     * {@link awaitInstanceReady}.
+     */
+    private requestCirrusViaSocket;
+    /**
+     * Send `requestStream` on the freshly opened control socket and resolve with
+     * the machine coordinates from `instanceReady`.
+     *
+     * The socket lives exactly as long as this wait: its close/error are HARD
+     * failures of the request, and on resolution it is closed with every handler
+     * detached (the backend does not use it after the handover). So the control
+     * socket has no post-handover state at all — nothing that could report a stale
+     * "disconnect" against a live stream.
+     */
+    private awaitInstanceReady;
     /**
      * Poll the SAME `url` until ready, or until HTTP 4xx says the URL
      * is dead.
@@ -1390,9 +1458,12 @@ declare class SignallingService extends SubService {
      */
     private pollLoop;
     private connectToCirrus;
+    /**
+     * Handlers for the CIRRUS socket — the only long-lived socket. Its close/error
+     * are real stream events (`setCirrusDisconnected` / `dropConnection`), unlike
+     * the control socket's, which never outlives {@link awaitInstanceReady}.
+     */
     private addWsHandlers;
-    private onOrchestrationClose;
-    private onOrchestrationError;
     /**
      * Adopt a live signalling socket opened by the `stream-prefetch.js`
      * head-script. The socket is already OPEN and `requestStream` was already
@@ -1402,54 +1473,53 @@ declare class SignallingService extends SubService {
      * `correlationId` so subsequent correlated messages line up.
      */
     adoptSocket(ws: WebSocket, correlationId: string): void;
-    /**
-     * Open the SECOND socket, directly to the stream machine's Cirrus
-     * (`originInstanceUri` from `instanceReady`). The whole WebRTC signalling
-     * (config/offer/answer/iceCandidate/ping) flows over this socket; the
-     * orchestration socket (`this.ws`) stays open for control/lifecycle.
-     *
-     * "Just connect" — nothing is sent on open (the machine is already reserved
-     * for this session): Cirrus pushes `config` and Unreal sends the `offer`.
-     */
-    connectToStreamMachine(originInstanceUri: string): void;
-    /**
-     * The stream-machine (Cirrus) connection failed. Re-request a machine over
-     * the still-open orchestration socket: orchestration issues a new
-     * streamRequestId and a fresh `instanceReady(originInstanceUri)`, which calls
-     * {@link connectToStreamMachine} again on a different machine. Bounded by
-     * {@link INNER_RETRY_LIMIT}; on exhaustion the stream is dropped.
-     */
-    private retryStreamMachine;
-    private addStreamWsHandlers;
-    private teardownStreamWs;
     private showStatusMessage;
     /**
-     * Close the connection with the signaling server
-     * @param data
+     * Close everything: the Cirrus socket AND the orchestration control socket.
+     * Used on abort/teardown. A new connection attempt inside a live cycle uses
+     * {@link closeCirrus} instead, so it does not kill the control socket that
+     * produced the address it is about to connect to.
      */
     close(data: CloseReason): void;
+    /** Close only the Cirrus signalling socket. */
+    private closeCirrus;
+    private teardownControlWs;
     private teardownSocket;
-    send(data: AnySignalingMessage): void;
     /**
-     * Send player signalling (offer/answer/iceCandidate/pong/p2pEstablished/
-     * subscribe) over the ACTIVE signalling socket: the stream-machine socket in
-     * the new flow (once connected), or the orchestration/relay socket in the old
-     * polling flow (where there is no separate stream socket).
+     * Player signalling (offer/answer/iceCandidate/pong/p2pEstablished/subscribe)
+     * — always the Cirrus socket, in every flow.
      */
-    sendPlayerSignal(data: AnySignalingMessage): void;
+    send(data: AnySignalingMessage): void;
+    /** Orchestration control messages (`requestStream`) — the control socket. */
+    sendToOrchestration(data: AnySignalingMessage): void;
     private sendTo;
     protected handleMessage(msg: MessageBase): void;
-    private setHandlersFromStream;
+    /**
+     * One handler map shared by both sockets — `handleMessage` dispatches purely by
+     * message type. Which socket a type can arrive on is fixed, so registration is
+     * split by origin: {@link setOrchestrationHandlers} (control socket) and
+     * {@link setStreamHandlers} (Cirrus).
+     *
+     * Keepalive is deliberately absent: both servers ping at the WS **protocol**
+     * level (`ws.ping()`), which the browser answers on its own — the page never
+     * sees a ping and must never reply with an application-level `pong`. An
+     * unregistered type is dropped silently by `handleMessage`, so a `ping` from a
+     * not-yet-updated backend is simply ignored.
+     */
+    private setMessageHandlers;
+    /**
+     * Messages from the ORCHESTRATION control socket. Only reachable during the
+     * provisioning wait — `requestCirrusViaSocket` closes that socket the moment
+     * `instanceReady` lands.
+     */
+    private setOrchestrationHandlers;
+    /** Messages from the CIRRUS socket — the actual stream signalling. */
+    private setStreamHandlers;
     protected sendRequestStream(): void;
     /**
-     * Check if the ACTIVE player-signalling socket is open and ready. Mirrors
-     * {@link sendPlayerSignal}'s socket choice so peer-reconnect gating is correct
-     * in both flows:
-     *  - NEW flow (`streamMachineConnected`): the stream-machine socket
-     *    (`streamWs`). The orchestration socket (`this.ws`) is intentionally
-     *    closed after occupancy, so checking it would wrongly report "not
-     *    connected" and block reconnect.
-     *  - OLD polling flow: the single relay socket (`this.ws`) — unchanged.
+     * Is the player-signalling socket open? Always the Cirrus socket — the
+     * control socket's state is irrelevant to the stream (orchestration closes it
+     * once the instance is occupied), so it must not be part of this gate.
      */
     isConnected(): boolean;
     private getRegion;
@@ -2304,8 +2374,6 @@ declare function InstanceReadyHandler(this: SignallingService, msg: InstanceRead
 
 declare function InstanceReservedHandler(this: SignallingService, msg: InstanceReserved): void;
 
-declare function PingHandler(this: SignallingService): void;
-
 declare function PlayerCountHandler(this: SignallingService, msg: PlayerCountMessage): void;
 
 declare function SSInfoHandler(this: SignallingService, msg: SSInfo): null;
@@ -2316,6 +2384,14 @@ declare function OnErrorHandler(this: SignallingService, e: Event): void;
 
 declare function OnMessageHandler(this: SignallingService, e: MessageEvent<string | Blob>): void;
 
+/**
+ * Open handler of the CIRRUS socket only (`addWsHandlers`), so
+ * `setCirrusConnected` now means what it says. It used to also send
+ * `requestStream` here, which made the flag fire on the orchestration control
+ * socket — a whole provisioning wait (`eta`, ~150 s) before any Cirrus existed.
+ * `requestStream` belongs to the control socket and is sent by
+ * `requestCirrusViaSocket`.
+ */
 declare function OnOpenHandler(this: SignallingService): void;
 
 /**
@@ -2568,10 +2644,34 @@ declare const setAwsInstance: _ngrx_store.ActionCreator<string, (props: {
     wsUrl: string | null;
     pollingUrl: string | null;
     instanceName: string | null;
+    /**
+     * Connection id issued by the orchestration in the polling response. Kept
+     * internally as `connectionId` (see `selectCirrusConnectionId`). Undefined
+     * in the new-orchestration flow, where it arrives later via
+     * `instanceReserved` → {@link setOrchestrationParameters}.
+     */
+    streamRequestId?: string;
+    /**
+     * Which request method produced this endpoint. Stated by the service instead
+     * of being guessed downstream from the URL's hostname.
+     */
+    kind?: CirrusRequestKind;
 }) => {
     wsUrl: string | null;
     pollingUrl: string | null;
     instanceName: string | null;
+    /**
+     * Connection id issued by the orchestration in the polling response. Kept
+     * internally as `connectionId` (see `selectCirrusConnectionId`). Undefined
+     * in the new-orchestration flow, where it arrives later via
+     * `instanceReserved` → {@link setOrchestrationParameters}.
+     */
+    streamRequestId?: string;
+    /**
+     * Which request method produced this endpoint. Stated by the service instead
+     * of being guessed downstream from the URL's hostname.
+     */
+    kind?: CirrusRequestKind;
 } & _ngrx_store.Action<string>>;
 declare const setStatusMessage: _ngrx_store.ActionCreator<string, (props: {
     statusMessage: string | null;
@@ -2811,6 +2911,12 @@ declare const initSignalling: _ngrx_store.ActionCreator<string, () => _ngrx_stor
 declare const streamAdopted: _ngrx_store.ActionCreator<string, (props: {
     machineId: string | null;
     ssData: SignalingData | null;
+    /**
+     * Orchestration-issued connection id the prefetch script read from the
+     * polling response and already passed to Cirrus. Kept internally as
+     * `connectionId` (see `selectCirrusConnectionId`).
+     */
+    streamRequestId: string | null;
     /**
      * `performance.now()` marks the prefetch script recorded while it
      * established the connection (`prefetch_start` / `ws_open` / `dc_open` /
@@ -2824,6 +2930,12 @@ declare const streamAdopted: _ngrx_store.ActionCreator<string, (props: {
 }) => {
     machineId: string | null;
     ssData: SignalingData | null;
+    /**
+     * Orchestration-issued connection id the prefetch script read from the
+     * polling response and already passed to Cirrus. Kept internally as
+     * `connectionId` (see `selectCirrusConnectionId`).
+     */
+    streamRequestId: string | null;
     /**
      * `performance.now()` marks the prefetch script recorded while it
      * established the connection (`prefetch_start` / `ws_open` / `dc_open` /
@@ -2936,23 +3048,23 @@ declare class UnrealEffects {
     private readonly unrealCallbackService;
     private dataChannelConnectionTimeout;
     private connectionCompleted$;
-    destroyConnections$: rxjs.Observable<{
+    destroyConnections$: Observable<{
         reason: _3dsource_angular_unreal_module.DisconnectReasonType;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    refreshRegionCache$: rxjs.Observable<{
+    refreshRegionCache$: Observable<{
         region_code: string;
         result: number[];
     } | null> & _ngrx_effects.CreateEffectMetadata;
-    abortEstablishingConnection$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    resetAfk$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    iframeMessaging$: rxjs.Observable<string | null> & _ngrx_effects.CreateEffectMetadata;
-    setSignalingTo100$: rxjs.Observable<{
+    abortEstablishingConnection$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    resetAfk$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    iframeMessaging$: Observable<string | null> & _ngrx_effects.CreateEffectMetadata;
+    setSignalingTo100$: Observable<{
         percent: number | null;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    setOrchestrationParameters$: rxjs.Observable<{
+    setOrchestrationParameters$: Observable<{
         progressComplete: number;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    setDataChannelTimeoutCheck$: rxjs.Observable<{
+    setDataChannelTimeoutCheck$: Observable<{
         reason: _3dsource_angular_unreal_module.DisconnectReasonType;
         message: string;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
@@ -2971,11 +3083,11 @@ declare class UnrealEffects {
      * Without this effect, the order of these events may cause
      * a visible flicker (video flashing to black).
      */
-    forceViewportNotReady$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    resetCirrusOnDestroy$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    destroyRemoteConnections$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    destroyConnectionAndRestart$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    showUnrealError$: rxjs.Observable<{
+    forceViewportNotReady$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    resetCirrusOnDestroy$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    destroyRemoteConnections$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    destroyConnectionAndRestart$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    showUnrealError$: Observable<{
         code: number | null;
         error?: string;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
@@ -2995,11 +3107,11 @@ declare class UnrealEffects {
      * cirrus drop, a scene destroy, or the start of a peer reconnect (which is
      * where the pre-existing `isReconnecting` filter hands over).
      */
-    unrealReceiverReady$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    initAppByDataChannelReady$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    setViewportReadyBySetLoopBackCommandIsCompleted$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    startStream$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    resetAfkOnPausedVideoInit$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    unrealReceiverReady$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    initAppByDataChannelReady$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    setViewportReadyBySetLoopBackCommandIsCompleted$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    startStream$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    resetAfkOnPausedVideoInit$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     /**
      * Effect: `disconnectReasonHandling$`
      *
@@ -3012,7 +3124,7 @@ declare class UnrealEffects {
      * Skip `DataChannelClosed` when peer reconnection can handle it — that
      * path is owned by `handleDataChannelClosed$` instead.
      */
-    disconnectReasonHandling$: rxjs.Observable<{
+    disconnectReasonHandling$: Observable<{
         reason: _3dsource_angular_unreal_module.DisconnectReasonType;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     /**
@@ -3022,25 +3134,25 @@ declare class UnrealEffects {
      * Only triggers if reconnection is enabled and the signaling WebSocket
      * is still connected.
      */
-    handleDataChannelClosed$: rxjs.Observable<{
+    handleDataChannelClosed$: Observable<{
         attempt: number;
         maxAttempts: number;
         delay?: number;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    webrtcErrorModalComponent$: rxjs.Observable<false> & _ngrx_effects.CreateEffectMetadata;
+    webrtcErrorModalComponent$: Observable<false> & _ngrx_effects.CreateEffectMetadata;
     /**
      * Effect: `resetStateForPeerReconnect$`
      *
      * Resets the data channel state when peer reconnection starts.
      */
-    resetStateForPeerReconnect$: rxjs.Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
+    resetStateForPeerReconnect$: Observable<_ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     /**
      * Effect: `executePeerReconnect$`
      *
      * Executes the actual peer reconnection attempt.
      * This only re-establishes the WebRTC connection, not the signaling.
      */
-    executePeerReconnect$: rxjs.Observable<_ngrx_store.Action<string> | ({
+    executePeerReconnect$: Observable<_ngrx_store.Action<string> | ({
         attempt: number;
         maxAttempts: number;
         delay?: number;
@@ -3053,19 +3165,19 @@ declare class UnrealEffects {
      * Handles the case when all peer reconnection attempts have failed.
      * Falls back to full disconnection which may trigger full reconnection.
      */
-    handlePeerReconnectFailed$: rxjs.Observable<{
+    handlePeerReconnectFailed$: Observable<{
         reason: _3dsource_angular_unreal_module.DisconnectReasonType;
         message: string;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    setMaxFps$: rxjs.Observable<{
+    setMaxFps$: Observable<{
         maxFps: number;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    sendStatisticsToUnreal$: rxjs.Observable<Object> & _ngrx_effects.CreateEffectMetadata;
-    listenUnrealCallbackByInitSignalling$: rxjs.Observable<{
+    sendStatisticsToUnreal$: Observable<Object> & _ngrx_effects.CreateEffectMetadata;
+    listenUnrealCallbackByInitSignalling$: Observable<{
         id: string;
         now: number;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
-    connectToSignaling$: rxjs.Observable<{
+    connectToSignaling$: Observable<{
         value: boolean;
     } & _ngrx_store.Action<string>> & _ngrx_effects.CreateEffectMetadata;
     private canPeerReconnect;
@@ -3220,8 +3332,19 @@ declare const selectIsLoaderScreenVisible: _ngrx_store.MemoizedSelector<Record<s
  * producing a small visual step that indicates the WS handshake succeeded.
  */
 declare const selectTotalProgress: _ngrx_store.MemoizedSelector<Record<string, any>, number, (s1: number | null, s2: number, s3: _3dsource_angular_unreal_module.AwsInstance, s4: boolean) => number>;
-/** Used by external consumers (e.g., metabox). Do not remove. */
-declare const selectCirrusConnectionId: _ngrx_store.MemoizedSelector<Record<string, any>, string | undefined, (s1: _3dsource_angular_unreal_module.SignalingData | null) => string | undefined>;
+/**
+ * The connection id of the current stream session.
+ *
+ * Primary source is the orchestration, which issues it as `streamRequestId` —
+ * in the polling response (legacy flow) or in `instanceReserved`/`instanceReady`
+ * (new orchestration) — and the browser hands it to Cirrus on the WS upgrade
+ * URL. `ssData.connectionId` (the `ssInfo` message) is the fallback for
+ * backends that don't issue one yet: Cirrus then generates it itself and
+ * reports it back here.
+ *
+ * Used by external consumers (e.g., metabox). Do not remove.
+ */
+declare const selectCirrusConnectionId: _ngrx_store.MemoizedSelector<Record<string, any>, string | undefined, (s1: _3dsource_angular_unreal_module.AwsInstance, s2: _3dsource_angular_unreal_module.SignalingData | null) => string | undefined>;
 /** Used by external consumers (e.g., metabox). Do not remove. */
 declare const selectUserInactivityDetected: _ngrx_store.MemoizedSelector<Record<string, any>, {
     remainingSecondsToDisconnect: number;
@@ -3233,5 +3356,5 @@ declare const selectUserInactivityDetected: _ngrx_store.MemoizedSelector<Record<
 /** Used by external consumers (e.g., metabox). Do not remove. */
 declare const selectIsVideoPlayingAndDataChannelConnected: _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, DESTROY_DISCONNECT_REASONS, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, FileHandlerService, FileReceiverService, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, INNER_RETRY_LIMIT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, LatencyTimings, LoadingProgressService, 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, BootstrapInfo, CandidateMessage, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, DisconnectReasonType, EmittedMilestone, EventId, ForceClientDisconnect, FpsLowData, FreezeFrameMessage, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, ParkedStream, PhaseEndedData, PhaseOverlay, PhaseParam, PingMessage, PlayerCountMessage, PollingOrchestrationMessage, Quality, QualityAnomalyData, ReceivedFile, RequestStream, ResourceBucket, ResourceTotals, SSInfo, SampleData, SelectedIceCandidatePair, SessionEndReason, SessionEndedData, SessionStartedData, SignalingData, SignalingMessageHandler, SignalingMessageMap, SignalingRetryData, SignalingRetryKind, SlowResource, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamTelemetryEvent, StreamTelemetryEventMap, StreamTelemetryEventName, StreamTelemetryLifecycleData, StreamTelemetryLifecycleEventName, StreamTelemetryTrackData, StreamerListMessage, TelemetryEventEnvelope, TelemetryLifecycleEnvelope, TelemetryType, UnknownFields, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealInitialConfig, UnrealState, WSCloseCodesValues, WindowAggregate };
+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, DevModeService, DisconnectReason, FULL_HD_HEIGHT, FULL_HD_WIDTH, FileHandlerService, FileReceiverService, FpsMonitorService, FreezeFrameComponent, FreezeFrameService, INNER_RETRY_LIMIT, INSTANCE_READY_TIMEOUT, IceCandidateHandler, ImageLoadingSrcComponent, InputOptions, InputService, InstanceReadyHandler, InstanceReservedHandler, IntroSrcComponent, LatencyTimings, LoadingProgressService, MINIMAL_FPS, MIN_CONTAINER_SIZE, MessageType, MouseButton, MouseButtonsMask, OUTER_RETRY_DELAY, OnCloseHandler, OnErrorHandler, OnMessageHandler, OnOpenHandler, OrchestrationMessageTypes, POLLING_TIME, 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, BootstrapInfo, CandidateMessage, CirrusRequestKind, CloseReason, CommandInProgress, ConfigMessage, ConnectionError, ControlSchemeValues, DisconnectReasonType, EmittedMilestone, EventId, FpsLowData, FreezeFrameMessage, InboundVideoStats, InputProps, InstanceReady, InstanceReserved, InterruptClientStream, ListStreamersMessage, MessageBase, MessageTypeValues, OrchestrationErrorMessage, OrchestrationMessageType, P2PEstablishedMessage, ParkedStream, PhaseEndedData, PhaseOverlay, PhaseParam, PlayerCountMessage, PollingOrchestrationMessage, Quality, QualityAnomalyData, ReceivedFile, RequestStream, ResourceBucket, ResourceTotals, SSInfo, SampleData, SelectedIceCandidatePair, SessionEndReason, SessionEndedData, SessionStartedData, SignalingData, SignalingMessageHandler, SignalingMessageMap, SignalingRetryData, SignalingRetryKind, SlowResource, StreamConfig, StreamRequestContext, StreamResolutionProps, StreamTelemetryEvent, StreamTelemetryEventMap, StreamTelemetryEventName, StreamTelemetryLifecycleData, StreamTelemetryLifecycleEventName, StreamTelemetryTrackData, StreamerListMessage, TelemetryEventEnvelope, TelemetryLifecycleEnvelope, TelemetryType, UnknownFields, UnrealCallbackDescriptor, UnrealCallbackEventMap, UnrealCallbackJson, UnrealCallbackJsonWrapped, UnrealInitialConfig, UnrealState, WSCloseCodesValues, WindowAggregate };