@3dsource/angular-unreal-module 0.0.167 → 0.0.168

package/package.json

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

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

@@ -716,6 +716,12 @@ interface BootstrapInfo {
  *  `track()`; the server buckets files under `data/<userId>/<sessionId>`. */
 interface TelemetryEventEnvelope {
     readonly userId: string;
+    /**
+     * The stream's connection id (`selectCirrusConnectionId`) — the id Cirrus
+     * runs this player under, shown as "Connection Id" in the debug overlay. Falls
+     * back to a locally generated uuid only when the attempt never got one.
+     * Stamped centrally by `track()`, so the value the emitters pass is ignored.
+     */
     readonly sessionId: string;
 }
 /** Lifecycle events additionally carry a phase-local `duration` — ms since
@@ -1640,6 +1646,8 @@ declare class StreamStatusTelemetryService2 {
     /** Streamer identity for the adopted signaling phase params. */
     private readonly ssData$;
     private readonly awsInstance$;
+    /** The session's connection id — shipped as `sessionId` on every event. */
+    private readonly connectionId$;
     private session;
     /**
      * Whether a session has already started during the current page lifetime.
@@ -1687,6 +1695,15 @@ declare class StreamStatusTelemetryService2 {
     private init;
     private startSession;
     private endSession;
+    /**
+     * Adopt the stream's connection id as this session's wire id and release the
+     * queue. The id becomes a file name on the collector, so anything that isn't
+     * a plain `[A-Za-z0-9_-]{1,64}` token is rejected (the collector answers 400
+     * to those — that would drop the whole session) and the local uuid is kept.
+     */
+    private resolveWireId;
+    /** Emit every queued event under `sessionId`, in emission order. */
+    private flushOutbox;
     /**
      * Emit a lifecycle event with a `duration` field — ms between the
      * previous lifecycle event and now (phase-local, NOT anchor-relative).
@@ -1728,7 +1745,9 @@ declare class StreamStatusTelemetryService2 {
      */
     private emitAdoptedPhase;
     /** Streamer identity params for the adopted signaling phase — mirrors the
-     *  `ssinfo-received` closer's shape (client / instanceName / …ssData). */
+     *  `ssinfo-received` closer's shape (client / instanceName / …ssData /
+     *  connectionId). For an adopted stream `ssData` is the one the prefetch
+     *  captured and `streamAdopted` hydrated into the store. */
     private adoptedSignalingParams;
     /** Read the region-ping cache the prefetch reused (localStorage), so the
      *  adopted region phase can still report the winning region + samples. */
@@ -1774,7 +1793,15 @@ declare class StreamStatusTelemetryService2 {
      */
     private collectResourceTotals;
     private aggregate;
+    /**
+     * Ship one event — or queue it when the session id isn't resolved yet.
+     *
+     * `sessionId` written by the callers is the local fallback; the value that
+     * goes on the wire is always the resolved one ({@link SessionState.wireId}),
+     * stamped here so every event of a session shares a single id.
+     */
     private track;
+    private emit;
     static ɵfac: i0.ɵɵFactoryDeclaration<StreamStatusTelemetryService2, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<StreamStatusTelemetryService2>;
 }
@@ -3258,7 +3285,21 @@ declare const selectIsExistMatchUrls: _ngrx_store.MemoizedSelector<Record<string
 declare const selectIsAutostart: _ngrx_store.MemoizedSelector<Record<string, any>, boolean, (s1: _3dsource_angular_unreal_module.StreamConfig) => boolean>;
 declare const selectShowReconnectPopup: _ngrx_store.MemoizedSelector<Record<string, any>, boolean, (s1: boolean, s2: boolean) => boolean>;
 declare const selectShowLoader: _ngrx_store.MemoizedSelector<Record<string, any>, boolean, (s1: boolean, s2: boolean) => boolean>;
-declare const selectSignalingParameters: _ngrx_store.MemoizedSelector<Record<string, any>, string, (s1: _3dsource_angular_unreal_module.SignalingData | null, s2: _3dsource_angular_unreal_module.AwsInstance) => string>;
+/**
+ * The connection id of the current stream session.
+ *
+ * The id is issued on the Cirrus side and reaches us either as the
+ * orchestration's `streamRequestId` (polling response / `instanceReserved` /
+ * `instanceReady`) or, when the backend issues none, in the `ssInfo` message
+ * once Cirrus generated it itself. Inside the player it is ONE value —
+ * `connectionId` — and this selector is where the two arrival paths collapse
+ * into it. It names the session everywhere: the debug overlay ("Connection Id")
+ * and the stream telemetry's `sessionId`.
+ *
+ * Also 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>;
+declare const selectSignalingParameters: _ngrx_store.MemoizedSelector<Record<string, any>, string, (s1: _3dsource_angular_unreal_module.SignalingData | null, s2: _3dsource_angular_unreal_module.AwsInstance, s3: string | undefined) => string>;
 declare const selectClientAndViewIds: _ngrx_store.MemoizedSelector<Record<string, any>, {
     clientId: string | null;
     viewId: string | null;
@@ -3280,19 +3321,6 @@ 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>;
-/**
- * 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;