@3dsource/angular-unreal-module 0.0.146-dev.5 → 0.0.146-dev.7

package/package.json

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

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

@@ -1108,6 +1108,14 @@ declare class StreamAdoptionService {
      * 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>;
     /**
@@ -1206,6 +1214,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.
@@ -1269,6 +1288,35 @@ 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 its raw timeline (prefetch_start … ready) mostly predates this session —
+     * showing it verbatim would look identical to a non-prefetched connect. What
+     * matters is measured from the moment Angular reached the connect call
+     * (session start, == `lastMilestonePerf` here): the REAL wait until adoption,
+     * and how much the prefetch SAVED by finishing the handshake during page load.
+     *
+     * So the three phases fill exactly the `[session start → adopted]` window
+     * (split across signaling / webrtc by the prefetch's own sub-step ratio; the
+     * region was served from cache → ~0), and the savings figures ride in params:
+     *  - `prefetchConnectMs` — full handshake the prefetch measured (the cost a
+     *    cold, non-prefetched connect would pay here).
+     *  - `prefetchSavedMs` — how much of it completed before Angular was ready.
+     *  - `adoptionWaitMs` — the actual wait Angular experienced (= window).
+     *  - `adoptionOverheadMs` — gap between prefetch-ready and adoption.
+     */
+    private emitAdoptedConnection;
+    /** Emit one adopted phase with an explicit (prefetch-derived) duration and
+     *  advance `lastMilestonePerf` synthetically so the next phase chains right. */
+    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;
@@ -2581,9 +2629,29 @@ declare const initSignalling: node_modules__ngrx_store_types_ngrx_store.ActionCr
 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>;
@@ -2802,7 +2870,6 @@ declare class UnrealEffects {
     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;
-    regionTelemetryOnAdopt$: node_modules_rxjs_dist_types.Observable<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
@@ -2819,6 +2886,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>;
@@ -2875,6 +2943,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;