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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3dsource/angular-unreal-module",
-  "version": "0.0.161",
+  "version": "0.0.162",
   "description": "Angular integration for Unreal Engine Pixel Streaming",
   "keywords": [
     "3dsource",

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

@@ -1246,9 +1246,11 @@ declare class RegionsPingService {
      * 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
+     * Public so adopted connections (which skip `getFastest`) can still report a
      * region-resolving telemetry phase from the same cached winner — see
-     * `UnrealEffects.regionTelemetryOnAdopt$`.
+     * `StreamStatusTelemetryService2.emitAdoptedConnection`. Returns `null` when
+     * the region-ping prefetch never ran or its cache expired; that phase then
+     * carries no region and no ping samples.
      */
     readCachedWinner(): {
         region_code: string;
@@ -1339,6 +1341,16 @@ declare class SignallingService extends SubService {
      * retry which re-pings the region.
      */
     private connectAttempt;
+    /**
+     * Status message for the connect branch. It does NOT dispatch
+     * `setEstablishingConnection` — `UnrealEffects.connectToSignaling$` already
+     * emits that once per logical attempt via `startWith(...)`, covering BOTH
+     * branches (prefetch adoption and a fresh connect). Dispatching it here as
+     * well fired the boundary twice on every cold start, and since
+     * `StreamStatusTelemetryService2` starts a session on that boundary, the
+     * first session was killed 2 ms in as `restart` — losing the only honest
+     * page-load measurement and the prefetch adoption with it.
+     */
     protected startEstablishingConnection(): void;
     private adaptUrlsToRegion;
     /**
@@ -1476,11 +1488,12 @@ declare class StreamAdoptionService {
      *
      * 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.
+     * built. The effect prepends `startWith(setEstablishingConnection(true))` —
+     * the single dispatch site for that boundary — which starts the telemetry
+     * session and subscribes its phase catalog; that must happen BEFORE
+     * `streamAdopted`, or `emitAdoptedConnection` fires into a session that does
+     * not exist yet and the whole connection waterfall is lost. `defer`
+     * guarantees that ordering.
      */
     awaitAndAdopt$(): Observable<boolean>;
     /**