@arcware-cloud/pixelstreaming-websdk 1.3.18 → 1.3.19

package/README.md

@@ -80,6 +80,12 @@ For more detailed examples and advanced usage, please refer to our documentation
 
 # Changelog
 
+### 1.3.19
+
+- added new configuration parameters to optionally hide AfkOverlay and to hide love letters box
+- exposing a function to clear session ID which can be called before connecting to stream to force a fresh instance
+- fixed a bug that was causing onWebsocketClosedEventHandler to fire three times. Also it now returns proper CloseEvent
+
 ### 1.3.17
 
 - added support for videos in white labelling

package/index.cjs.js

@@ -22963,6 +22963,13 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.fileDownloadCallback = null;
         this.ArcwareSection = this.configUI.buildSectionWithHeading(this.settingsPanel.settingsContentElement, "Arcware Cloud");
         this.stream = options === null || options === void 0 ? void 0 : options.stream;
+        this.baseShowAfkOverlay = this.showAfkOverlay.bind(this); // capture original
+        this.stream.config.whiteLabellingChanged.add(() => {
+            try {
+                this.syncAfkOverlayFromWhiteLabelling();
+            }
+            catch (_a) { }
+        });
         this.emitUIInteraction = this.emitUIInteraction.bind(this);
         this.adjustSettingsPanel();
         this.createAudioToggleButton();
@@ -23004,6 +23011,7 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.preventDefaultKeyboardEvents();
         this.analyticsEventCallback = this.analyticsEvent;
         this.fileDownloadCallback = this.fileDownload;
+        this.syncAfkOverlayFromWhiteLabelling();
     }
     addLoveLetterhandler() {
         var _a, _b;
@@ -23336,6 +23344,18 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
             console.error("Download failed:", err);
         }
     }
+    syncAfkOverlayFromWhiteLabelling() {
+        var _a;
+        const hide = (_a = this.stream.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideAfkOverlay;
+        if (hide) {
+            // override with noop
+            this.showAfkOverlay = (_countDown, _dismissAfk) => { };
+        }
+        else {
+            // restore original behavior
+            this.showAfkOverlay = this.baseShowAfkOverlay;
+        }
+    }
 }
 ArcwareApplication.Flags = (_a = class {
     },
@@ -23432,10 +23452,9 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
         if (!config.initialSettings.ss)
             config.initialSettings.ss = exports.DefaultUrl;
         super(config);
-        this.VERSION = "1.3.18";
+        this.VERSION = "1.3.19";
         this.whiteLabellingChanged = new EventHandler_1.EventHandler();
         this.signallingWlURL = "https://signalling-client.arcware.cloud/whiteLabel/";
-        console.log(config);
         if (config.envName) {
             this.signallingWlURL = `https://signalling-client.${config.envName}.arcware.cloud/whiteLabel/`;
         }
@@ -23496,10 +23515,8 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
                 // Only apply & emit if it actually changed
                 const prev = this.settings.whiteLabelling;
                 const next = parsed.data;
-                if (!deepEqual(prev, next)) {
-                    this.settings.whiteLabelling = next;
-                    EventHandler_1.EventHandler.Emit(this.whiteLabellingChanged, next);
-                }
+                this.settings.whiteLabelling = next;
+                EventHandler_1.EventHandler.Emit(this.whiteLabellingChanged, { next, changed: !deepEqual(prev, next) });
                 return parsed.data;
             }
             catch (_b) {
@@ -23623,8 +23640,10 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
                 loadingIconUrl: undefined,
                 splashScreenMode: undefined,
                 splashScreenPosition: undefined,
-                splashScreenBgColor: undefined
-            } }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
+                splashScreenBgColor: undefined,
+                hideLoveLetters: undefined,
+                hideAfkOverlay: undefined
+            }, fetchRemoteWhiteLabelling: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
         envName: (_a = configuration === null || configuration === void 0 ? void 0 : configuration.envName) !== null && _a !== void 0 ? _a : undefined
     });
     const PixelStreaming = new ArcwarePixelStreaming_1.ArcwarePixelStreaming(Config);
@@ -23692,23 +23711,20 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         return true;
     }
     bindTransportEvents() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d;
         const current = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport;
         if (!current || current === this._boundTransport)
             return;
-        // Unbind from previous
+        // Unbind previous
         if (this._boundTransport) {
             if (this._onWsOpen)
                 (_c = (_b = this._boundTransport).removeEventListener) === null || _c === void 0 ? void 0 : _c.call(_b, "open", this._onWsOpen);
-            if (this._onWsClose)
-                (_e = (_d = this._boundTransport).removeEventListener) === null || _e === void 0 ? void 0 : _e.call(_d, "close", this._onWsClose);
+            // ⚠️ this was the synthetic "close" before, we'll stop relying on it
         }
-        // Define (or reuse) callbacks
         if (!this._onWsOpen) {
             this._onWsOpen = () => {
                 this.flushOutbox();
                 this.attachFirstRenderedFrameOnce();
-                // no watchdog anymore
                 setTimeout(() => {
                     var _a, _b, _c;
                     if (!this.videoInitializedSent) {
@@ -23721,15 +23737,15 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
                 }, 1200);
             };
         }
-        if (!this._onWsClose) {
+        (_d = current.addEventListener) === null || _d === void 0 ? void 0 : _d.call(current, "open", this._onWsOpen);
+        // Real CloseEvent from underlying WebSocket
+        const ws = current.webSocket;
+        if (ws && !this._onWsClose) {
             this._onWsClose = (evt) => {
-                // Bubble to your public close handler
                 EventHandler_1.EventHandler.Emit(this.websocketOnCloseHandler, evt);
             };
+            ws.addEventListener("close", this._onWsClose);
         }
-        // Bind to current
-        (_f = current.addEventListener) === null || _f === void 0 ? void 0 : _f.call(current, "open", this._onWsOpen);
-        (_g = current.addEventListener) === null || _g === void 0 ? void 0 : _g.call(current, "close", this._onWsClose);
         this._boundTransport = current;
     }
     get isWsOpen() {
@@ -23752,7 +23768,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         return state !== undefined ? state : WebSocket.CLOSED;
     }
     constructor(config, overrides) {
-        var _a, _b, _c;
+        var _a, _b;
         /** As soon as upstream is fixed, we got to adjust the url building process. */
         (0, ApplyUrlHack_1.ApplyUrlHack)();
         super(config, overrides);
@@ -23786,39 +23802,44 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             this.flushOutbox();
             // no polling watchdog
         });
-        (_c = transport === null || transport === void 0 ? void 0 : transport.addEventListener) === null || _c === void 0 ? void 0 : _c.call(transport, "close", (evt) => {
-            if (this.websocketOnCloseHandler) {
-                EventHandler_1.EventHandler.Emit(this.websocketOnCloseHandler, evt);
-            }
-        });
         // Set override config.
         this.config = config;
         // Re-apply branding whenever config's WL changes
-        this.config.whiteLabellingChanged.add(() => {
+        this.config.whiteLabellingChanged.add((result) => {
+            var _a;
             try {
-                this.applyBrandingFromSettings();
+                if (result.changed)
+                    this.applyBrandingFromSettings();
+                this.config.settings.fetchRemoteWhiteLabelling = false;
+                if (!((_a = this.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideLoveLetters)) {
+                    if (!this.isProcessingQueue) {
+                        this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+                    }
+                }
             }
-            catch (_a) { }
+            catch (_b) { }
         });
         // Kick off WL fetch once (if we have a shareId); on success it will emit and re-apply
-        (() => tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                const sid = this.config.settings.shareId;
-                if (sid) {
-                    yield this.config.getWhiteLabelling(sid); // will emit if it changes
-                }
-            }
-            catch (_d) {
-                // ignore
-            }
-            finally {
-                // Make sure we paint with whatever we have initially
+        if (this.config.settings.fetchRemoteWhiteLabelling) {
+            (() => tslib_1.__awaiter(this, void 0, void 0, function* () {
                 try {
-                    this.applyBrandingFromSettings();
+                    const sid = this.config.settings.shareId;
+                    if (sid) {
+                        yield this.config.getWhiteLabelling(sid); // will emit if it changes
+                    }
                 }
-                catch (_e) { }
-            }
-        }))();
+                catch (_c) {
+                    // ignore
+                }
+                finally {
+                    // Make sure we paint with whatever we have initially
+                    try {
+                        this.applyBrandingFromSettings();
+                    }
+                    catch (_d) { }
+                }
+            }))();
+        }
         this.loveLettersList = [];
         this.microphoneOverlay = new MicrophoneOverlay_1.MicrophoneOverlay(this);
         this.diagnosticsCollector = new DiagnosticsCollector_1.DiagnosticsCollector({
@@ -23830,7 +23851,6 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         // Arm first-frame detector & watch for element swaps
         this.attachFirstRenderedFrameOnce();
         this.watchVideoElementReplacement();
-        this.wrapWebSocketOnCloseHandler();
         // Bind the event listener function to the class instance
         this.handleResolutionChange = this.handleResolutionChange.bind(this);
         // Register message handlers.
@@ -24349,10 +24369,12 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     pushLetter(letter) {
-        var _a;
+        var _a, _b;
         (_a = this === null || this === void 0 ? void 0 : this.loveLettersQueue) === null || _a === void 0 ? void 0 : _a.push(letter);
-        if (!this.isProcessingQueue) {
-            this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+        if (!((_b = this.config.settings.whiteLabelling) === null || _b === void 0 ? void 0 : _b.hideLoveLetters) && !this.config.settings.fetchRemoteWhiteLabelling) {
+            if (!this.isProcessingQueue) {
+                this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+            }
         }
     }
     processLoveLetterQueue() {
@@ -24418,13 +24440,6 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             }, 1000);
         }
     }
-    wrapWebSocketOnCloseHandler() {
-        var _a, _b;
-        let self = this;
-        (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport) === null || _b === void 0 ? void 0 : _b.addEventListener("close", (event) => {
-            EventHandler_1.EventHandler.Emit(self.websocketOnCloseHandler, event);
-        });
-    }
     onStreamingStateChange(callback) {
         var _a, _b, _c, _d;
         const videoElement = (_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement();
@@ -24614,6 +24629,9 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             s.endsWith(".ogv") ||
             s.endsWith(".m3u8"));
     }
+    static clearSessionId() {
+        window.localStorage.removeItem("pxss"); // or your actual key
+    }
 }
 exports.ArcwarePixelStreaming = ArcwarePixelStreaming;
 
@@ -24687,7 +24705,8 @@ exports.ArcwareSettingsSchema = zod_1.z.object({
         .strict()
         .optional(),
     /** Loader customization */
-    whiteLabelling: ZWhiteLabel_1.ZWhiteLabel.optional()
+    whiteLabelling: ZWhiteLabel_1.ZWhiteLabel.optional(),
+    fetchRemoteWhiteLabelling: zod_1.z.boolean().optional()
 });
 
 
@@ -25507,7 +25526,9 @@ exports.ZWhiteLabel = zod_1.z
     splashScreenUrl: ImageUrl.optional(),
     splashScreenMode: zod_1.z.enum(["contain", "cover", "stretch", "repeat"]).optional(),
     splashScreenPosition: zod_1.z.string().optional(),
-    splashScreenBgColor: zod_1.z.string().optional()
+    splashScreenBgColor: zod_1.z.string().optional(),
+    hideLoveLetters: zod_1.z.boolean().optional(),
+    hideAfkOverlay: zod_1.z.boolean().optional()
 })
     .strict();
 

package/index.esm.js

@@ -22964,6 +22964,13 @@ class ArcwareApplication extends _epicgames_ps_lib_pixelstreamingfrontend_ui_ue5
         this.fileDownloadCallback = null;
         this.ArcwareSection = this.configUI.buildSectionWithHeading(this.settingsPanel.settingsContentElement, "Arcware Cloud");
         this.stream = options === null || options === void 0 ? void 0 : options.stream;
+        this.baseShowAfkOverlay = this.showAfkOverlay.bind(this); // capture original
+        this.stream.config.whiteLabellingChanged.add(() => {
+            try {
+                this.syncAfkOverlayFromWhiteLabelling();
+            }
+            catch (_a) { }
+        });
         this.emitUIInteraction = this.emitUIInteraction.bind(this);
         this.adjustSettingsPanel();
         this.createAudioToggleButton();
@@ -23005,6 +23012,7 @@ class ArcwareApplication extends _epicgames_ps_lib_pixelstreamingfrontend_ui_ue5
         this.preventDefaultKeyboardEvents();
         this.analyticsEventCallback = this.analyticsEvent;
         this.fileDownloadCallback = this.fileDownload;
+        this.syncAfkOverlayFromWhiteLabelling();
     }
     addLoveLetterhandler() {
         var _a, _b;
@@ -23337,6 +23345,18 @@ class ArcwareApplication extends _epicgames_ps_lib_pixelstreamingfrontend_ui_ue5
             console.error("Download failed:", err);
         }
     }
+    syncAfkOverlayFromWhiteLabelling() {
+        var _a;
+        const hide = (_a = this.stream.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideAfkOverlay;
+        if (hide) {
+            // override with noop
+            this.showAfkOverlay = (_countDown, _dismissAfk) => { };
+        }
+        else {
+            // restore original behavior
+            this.showAfkOverlay = this.baseShowAfkOverlay;
+        }
+    }
 }
 ArcwareApplication.Flags = (_a = class {
     },
@@ -23444,10 +23464,9 @@ class ArcwareConfig extends _epicgames_ps_lib_pixelstreamingfrontend_ue5_5__WEBP
         if (!config.initialSettings.ss)
             config.initialSettings.ss = DefaultUrl;
         super(config);
-        this.VERSION = "1.3.18";
+        this.VERSION = "1.3.19";
         this.whiteLabellingChanged = new _domain_EventHandler__WEBPACK_IMPORTED_MODULE_7__.EventHandler();
         this.signallingWlURL = "https://signalling-client.arcware.cloud/whiteLabel/";
-        console.log(config);
         if (config.envName) {
             this.signallingWlURL = `https://signalling-client.${config.envName}.arcware.cloud/whiteLabel/`;
         }
@@ -23508,10 +23527,8 @@ class ArcwareConfig extends _epicgames_ps_lib_pixelstreamingfrontend_ue5_5__WEBP
                 // Only apply & emit if it actually changed
                 const prev = this.settings.whiteLabelling;
                 const next = parsed.data;
-                if (!deepEqual(prev, next)) {
-                    this.settings.whiteLabelling = next;
-                    _domain_EventHandler__WEBPACK_IMPORTED_MODULE_7__.EventHandler.Emit(this.whiteLabellingChanged, next);
-                }
+                this.settings.whiteLabelling = next;
+                _domain_EventHandler__WEBPACK_IMPORTED_MODULE_7__.EventHandler.Emit(this.whiteLabellingChanged, { next, changed: !deepEqual(prev, next) });
                 return parsed.data;
             }
             catch (_b) {
@@ -23638,8 +23655,10 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
                 loadingIconUrl: undefined,
                 splashScreenMode: undefined,
                 splashScreenPosition: undefined,
-                splashScreenBgColor: undefined
-            } }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
+                splashScreenBgColor: undefined,
+                hideLoveLetters: undefined,
+                hideAfkOverlay: undefined
+            }, fetchRemoteWhiteLabelling: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
         envName: (_a = configuration === null || configuration === void 0 ? void 0 : configuration.envName) !== null && _a !== void 0 ? _a : undefined
     });
     const PixelStreaming = new _ArcwarePixelStreaming__WEBPACK_IMPORTED_MODULE_1__.ArcwarePixelStreaming(Config);
@@ -23722,23 +23741,20 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         return true;
     }
     bindTransportEvents() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d;
         const current = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport;
         if (!current || current === this._boundTransport)
             return;
-        // Unbind from previous
+        // Unbind previous
         if (this._boundTransport) {
             if (this._onWsOpen)
                 (_c = (_b = this._boundTransport).removeEventListener) === null || _c === void 0 ? void 0 : _c.call(_b, "open", this._onWsOpen);
-            if (this._onWsClose)
-                (_e = (_d = this._boundTransport).removeEventListener) === null || _e === void 0 ? void 0 : _e.call(_d, "close", this._onWsClose);
+            // ⚠️ this was the synthetic "close" before, we'll stop relying on it
         }
-        // Define (or reuse) callbacks
         if (!this._onWsOpen) {
             this._onWsOpen = () => {
                 this.flushOutbox();
                 this.attachFirstRenderedFrameOnce();
-                // no watchdog anymore
                 setTimeout(() => {
                     var _a, _b, _c;
                     if (!this.videoInitializedSent) {
@@ -23751,15 +23767,15 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
                 }, 1200);
             };
         }
-        if (!this._onWsClose) {
+        (_d = current.addEventListener) === null || _d === void 0 ? void 0 : _d.call(current, "open", this._onWsOpen);
+        // Real CloseEvent from underlying WebSocket
+        const ws = current.webSocket;
+        if (ws && !this._onWsClose) {
             this._onWsClose = (evt) => {
-                // Bubble to your public close handler
                 _domain_EventHandler__WEBPACK_IMPORTED_MODULE_5__.EventHandler.Emit(this.websocketOnCloseHandler, evt);
             };
+            ws.addEventListener("close", this._onWsClose);
         }
-        // Bind to current
-        (_f = current.addEventListener) === null || _f === void 0 ? void 0 : _f.call(current, "open", this._onWsOpen);
-        (_g = current.addEventListener) === null || _g === void 0 ? void 0 : _g.call(current, "close", this._onWsClose);
         this._boundTransport = current;
     }
     get isWsOpen() {
@@ -23782,7 +23798,7 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         return state !== undefined ? state : WebSocket.CLOSED;
     }
     constructor(config, overrides) {
-        var _a, _b, _c;
+        var _a, _b;
         /** As soon as upstream is fixed, we got to adjust the url building process. */
         (0,_ApplyUrlHack__WEBPACK_IMPORTED_MODULE_6__.ApplyUrlHack)();
         super(config, overrides);
@@ -23816,39 +23832,44 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
             this.flushOutbox();
             // no polling watchdog
         });
-        (_c = transport === null || transport === void 0 ? void 0 : transport.addEventListener) === null || _c === void 0 ? void 0 : _c.call(transport, "close", (evt) => {
-            if (this.websocketOnCloseHandler) {
-                _domain_EventHandler__WEBPACK_IMPORTED_MODULE_5__.EventHandler.Emit(this.websocketOnCloseHandler, evt);
-            }
-        });
         // Set override config.
         this.config = config;
         // Re-apply branding whenever config's WL changes
-        this.config.whiteLabellingChanged.add(() => {
+        this.config.whiteLabellingChanged.add((result) => {
+            var _a;
             try {
-                this.applyBrandingFromSettings();
+                if (result.changed)
+                    this.applyBrandingFromSettings();
+                this.config.settings.fetchRemoteWhiteLabelling = false;
+                if (!((_a = this.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideLoveLetters)) {
+                    if (!this.isProcessingQueue) {
+                        this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+                    }
+                }
             }
-            catch (_a) { }
+            catch (_b) { }
         });
         // Kick off WL fetch once (if we have a shareId); on success it will emit and re-apply
-        (() => (0,tslib__WEBPACK_IMPORTED_MODULE_7__.__awaiter)(this, void 0, void 0, function* () {
-            try {
-                const sid = this.config.settings.shareId;
-                if (sid) {
-                    yield this.config.getWhiteLabelling(sid); // will emit if it changes
-                }
-            }
-            catch (_d) {
-                // ignore
-            }
-            finally {
-                // Make sure we paint with whatever we have initially
+        if (this.config.settings.fetchRemoteWhiteLabelling) {
+            (() => (0,tslib__WEBPACK_IMPORTED_MODULE_7__.__awaiter)(this, void 0, void 0, function* () {
                 try {
-                    this.applyBrandingFromSettings();
+                    const sid = this.config.settings.shareId;
+                    if (sid) {
+                        yield this.config.getWhiteLabelling(sid); // will emit if it changes
+                    }
                 }
-                catch (_e) { }
-            }
-        }))();
+                catch (_c) {
+                    // ignore
+                }
+                finally {
+                    // Make sure we paint with whatever we have initially
+                    try {
+                        this.applyBrandingFromSettings();
+                    }
+                    catch (_d) { }
+                }
+            }))();
+        }
         this.loveLettersList = [];
         this.microphoneOverlay = new _ui_MicrophoneOverlay__WEBPACK_IMPORTED_MODULE_8__.MicrophoneOverlay(this);
         this.diagnosticsCollector = new _features_DiagnosticsCollector__WEBPACK_IMPORTED_MODULE_3__.DiagnosticsCollector({
@@ -23860,7 +23881,6 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         // Arm first-frame detector & watch for element swaps
         this.attachFirstRenderedFrameOnce();
         this.watchVideoElementReplacement();
-        this.wrapWebSocketOnCloseHandler();
         // Bind the event listener function to the class instance
         this.handleResolutionChange = this.handleResolutionChange.bind(this);
         // Register message handlers.
@@ -24379,10 +24399,12 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
         }
     }
     pushLetter(letter) {
-        var _a;
+        var _a, _b;
         (_a = this === null || this === void 0 ? void 0 : this.loveLettersQueue) === null || _a === void 0 ? void 0 : _a.push(letter);
-        if (!this.isProcessingQueue) {
-            this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+        if (!((_b = this.config.settings.whiteLabelling) === null || _b === void 0 ? void 0 : _b.hideLoveLetters) && !this.config.settings.fetchRemoteWhiteLabelling) {
+            if (!this.isProcessingQueue) {
+                this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+            }
         }
     }
     processLoveLetterQueue() {
@@ -24448,13 +24470,6 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
             }, 1000);
         }
     }
-    wrapWebSocketOnCloseHandler() {
-        var _a, _b;
-        let self = this;
-        (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport) === null || _b === void 0 ? void 0 : _b.addEventListener("close", (event) => {
-            _domain_EventHandler__WEBPACK_IMPORTED_MODULE_5__.EventHandler.Emit(self.websocketOnCloseHandler, event);
-        });
-    }
     onStreamingStateChange(callback) {
         var _a, _b, _c, _d;
         const videoElement = (_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement();
@@ -24644,6 +24659,9 @@ class ArcwarePixelStreaming extends _epicgames_ps_lib_pixelstreamingfrontend_ue5
             s.endsWith(".ogv") ||
             s.endsWith(".m3u8"));
     }
+    static clearSessionId() {
+        window.localStorage.removeItem("pxss"); // or your actual key
+    }
 }
 
 
@@ -24719,7 +24737,8 @@ const ArcwareSettingsSchema = zod__WEBPACK_IMPORTED_MODULE_2__.z.object({
         .strict()
         .optional(),
     /** Loader customization */
-    whiteLabelling: _features_ZWhiteLabel__WEBPACK_IMPORTED_MODULE_1__.ZWhiteLabel.optional()
+    whiteLabelling: _features_ZWhiteLabel__WEBPACK_IMPORTED_MODULE_1__.ZWhiteLabel.optional(),
+    fetchRemoteWhiteLabelling: zod__WEBPACK_IMPORTED_MODULE_2__.z.boolean().optional()
 });
 
 
@@ -25548,7 +25567,9 @@ const ZWhiteLabel = zod__WEBPACK_IMPORTED_MODULE_0__.z.object({
     splashScreenUrl: ImageUrl.optional(),
     splashScreenMode: zod__WEBPACK_IMPORTED_MODULE_0__.z["enum"](["contain", "cover", "stretch", "repeat"]).optional(),
     splashScreenPosition: zod__WEBPACK_IMPORTED_MODULE_0__.z.string().optional(),
-    splashScreenBgColor: zod__WEBPACK_IMPORTED_MODULE_0__.z.string().optional()
+    splashScreenBgColor: zod__WEBPACK_IMPORTED_MODULE_0__.z.string().optional(),
+    hideLoveLetters: zod__WEBPACK_IMPORTED_MODULE_0__.z.boolean().optional(),
+    hideAfkOverlay: zod__WEBPACK_IMPORTED_MODULE_0__.z.boolean().optional()
 })
     .strict();
 

package/index.umd.js

@@ -22973,6 +22973,13 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.fileDownloadCallback = null;
         this.ArcwareSection = this.configUI.buildSectionWithHeading(this.settingsPanel.settingsContentElement, "Arcware Cloud");
         this.stream = options === null || options === void 0 ? void 0 : options.stream;
+        this.baseShowAfkOverlay = this.showAfkOverlay.bind(this); // capture original
+        this.stream.config.whiteLabellingChanged.add(() => {
+            try {
+                this.syncAfkOverlayFromWhiteLabelling();
+            }
+            catch (_a) { }
+        });
         this.emitUIInteraction = this.emitUIInteraction.bind(this);
         this.adjustSettingsPanel();
         this.createAudioToggleButton();
@@ -23014,6 +23021,7 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
         this.preventDefaultKeyboardEvents();
         this.analyticsEventCallback = this.analyticsEvent;
         this.fileDownloadCallback = this.fileDownload;
+        this.syncAfkOverlayFromWhiteLabelling();
     }
     addLoveLetterhandler() {
         var _a, _b;
@@ -23346,6 +23354,18 @@ class ArcwareApplication extends lib_pixelstreamingfrontend_ui_ue5_5_1.Applicati
             console.error("Download failed:", err);
         }
     }
+    syncAfkOverlayFromWhiteLabelling() {
+        var _a;
+        const hide = (_a = this.stream.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideAfkOverlay;
+        if (hide) {
+            // override with noop
+            this.showAfkOverlay = (_countDown, _dismissAfk) => { };
+        }
+        else {
+            // restore original behavior
+            this.showAfkOverlay = this.baseShowAfkOverlay;
+        }
+    }
 }
 ArcwareApplication.Flags = (_a = class {
     },
@@ -23442,10 +23462,9 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
         if (!config.initialSettings.ss)
             config.initialSettings.ss = exports.DefaultUrl;
         super(config);
-        this.VERSION = "1.3.18";
+        this.VERSION = "1.3.19";
         this.whiteLabellingChanged = new EventHandler_1.EventHandler();
         this.signallingWlURL = "https://signalling-client.arcware.cloud/whiteLabel/";
-        console.log(config);
         if (config.envName) {
             this.signallingWlURL = `https://signalling-client.${config.envName}.arcware.cloud/whiteLabel/`;
         }
@@ -23506,10 +23525,8 @@ class ArcwareConfig extends lib_pixelstreamingfrontend_ue5_5_1.Config {
                 // Only apply & emit if it actually changed
                 const prev = this.settings.whiteLabelling;
                 const next = parsed.data;
-                if (!deepEqual(prev, next)) {
-                    this.settings.whiteLabelling = next;
-                    EventHandler_1.EventHandler.Emit(this.whiteLabellingChanged, next);
-                }
+                this.settings.whiteLabelling = next;
+                EventHandler_1.EventHandler.Emit(this.whiteLabellingChanged, { next, changed: !deepEqual(prev, next) });
                 return parsed.data;
             }
             catch (_b) {
@@ -23633,8 +23650,10 @@ function ArcwareInit({ shareId, projectId }, configuration, forceRefresh = false
                 loadingIconUrl: undefined,
                 splashScreenMode: undefined,
                 splashScreenPosition: undefined,
-                splashScreenBgColor: undefined
-            } }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
+                splashScreenBgColor: undefined,
+                hideLoveLetters: undefined,
+                hideAfkOverlay: undefined
+            }, fetchRemoteWhiteLabelling: undefined }, configuration === null || configuration === void 0 ? void 0 : configuration.settings),
         envName: (_a = configuration === null || configuration === void 0 ? void 0 : configuration.envName) !== null && _a !== void 0 ? _a : undefined
     });
     const PixelStreaming = new ArcwarePixelStreaming_1.ArcwarePixelStreaming(Config);
@@ -23702,23 +23721,20 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         return true;
     }
     bindTransportEvents() {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d;
         const current = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport;
         if (!current || current === this._boundTransport)
             return;
-        // Unbind from previous
+        // Unbind previous
         if (this._boundTransport) {
             if (this._onWsOpen)
                 (_c = (_b = this._boundTransport).removeEventListener) === null || _c === void 0 ? void 0 : _c.call(_b, "open", this._onWsOpen);
-            if (this._onWsClose)
-                (_e = (_d = this._boundTransport).removeEventListener) === null || _e === void 0 ? void 0 : _e.call(_d, "close", this._onWsClose);
+            // ⚠️ this was the synthetic "close" before, we'll stop relying on it
         }
-        // Define (or reuse) callbacks
         if (!this._onWsOpen) {
             this._onWsOpen = () => {
                 this.flushOutbox();
                 this.attachFirstRenderedFrameOnce();
-                // no watchdog anymore
                 setTimeout(() => {
                     var _a, _b, _c;
                     if (!this.videoInitializedSent) {
@@ -23731,15 +23747,15 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
                 }, 1200);
             };
         }
-        if (!this._onWsClose) {
+        (_d = current.addEventListener) === null || _d === void 0 ? void 0 : _d.call(current, "open", this._onWsOpen);
+        // Real CloseEvent from underlying WebSocket
+        const ws = current.webSocket;
+        if (ws && !this._onWsClose) {
             this._onWsClose = (evt) => {
-                // Bubble to your public close handler
                 EventHandler_1.EventHandler.Emit(this.websocketOnCloseHandler, evt);
             };
+            ws.addEventListener("close", this._onWsClose);
         }
-        // Bind to current
-        (_f = current.addEventListener) === null || _f === void 0 ? void 0 : _f.call(current, "open", this._onWsOpen);
-        (_g = current.addEventListener) === null || _g === void 0 ? void 0 : _g.call(current, "close", this._onWsClose);
         this._boundTransport = current;
     }
     get isWsOpen() {
@@ -23762,7 +23778,7 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         return state !== undefined ? state : WebSocket.CLOSED;
     }
     constructor(config, overrides) {
-        var _a, _b, _c;
+        var _a, _b;
         /** As soon as upstream is fixed, we got to adjust the url building process. */
         (0, ApplyUrlHack_1.ApplyUrlHack)();
         super(config, overrides);
@@ -23796,39 +23812,44 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             this.flushOutbox();
             // no polling watchdog
         });
-        (_c = transport === null || transport === void 0 ? void 0 : transport.addEventListener) === null || _c === void 0 ? void 0 : _c.call(transport, "close", (evt) => {
-            if (this.websocketOnCloseHandler) {
-                EventHandler_1.EventHandler.Emit(this.websocketOnCloseHandler, evt);
-            }
-        });
         // Set override config.
         this.config = config;
         // Re-apply branding whenever config's WL changes
-        this.config.whiteLabellingChanged.add(() => {
+        this.config.whiteLabellingChanged.add((result) => {
+            var _a;
             try {
-                this.applyBrandingFromSettings();
+                if (result.changed)
+                    this.applyBrandingFromSettings();
+                this.config.settings.fetchRemoteWhiteLabelling = false;
+                if (!((_a = this.config.settings.whiteLabelling) === null || _a === void 0 ? void 0 : _a.hideLoveLetters)) {
+                    if (!this.isProcessingQueue) {
+                        this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+                    }
+                }
             }
-            catch (_a) { }
+            catch (_b) { }
         });
         // Kick off WL fetch once (if we have a shareId); on success it will emit and re-apply
-        (() => tslib_1.__awaiter(this, void 0, void 0, function* () {
-            try {
-                const sid = this.config.settings.shareId;
-                if (sid) {
-                    yield this.config.getWhiteLabelling(sid); // will emit if it changes
-                }
-            }
-            catch (_d) {
-                // ignore
-            }
-            finally {
-                // Make sure we paint with whatever we have initially
+        if (this.config.settings.fetchRemoteWhiteLabelling) {
+            (() => tslib_1.__awaiter(this, void 0, void 0, function* () {
                 try {
-                    this.applyBrandingFromSettings();
+                    const sid = this.config.settings.shareId;
+                    if (sid) {
+                        yield this.config.getWhiteLabelling(sid); // will emit if it changes
+                    }
                 }
-                catch (_e) { }
-            }
-        }))();
+                catch (_c) {
+                    // ignore
+                }
+                finally {
+                    // Make sure we paint with whatever we have initially
+                    try {
+                        this.applyBrandingFromSettings();
+                    }
+                    catch (_d) { }
+                }
+            }))();
+        }
         this.loveLettersList = [];
         this.microphoneOverlay = new MicrophoneOverlay_1.MicrophoneOverlay(this);
         this.diagnosticsCollector = new DiagnosticsCollector_1.DiagnosticsCollector({
@@ -23840,7 +23861,6 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         // Arm first-frame detector & watch for element swaps
         this.attachFirstRenderedFrameOnce();
         this.watchVideoElementReplacement();
-        this.wrapWebSocketOnCloseHandler();
         // Bind the event listener function to the class instance
         this.handleResolutionChange = this.handleResolutionChange.bind(this);
         // Register message handlers.
@@ -24359,10 +24379,12 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
         }
     }
     pushLetter(letter) {
-        var _a;
+        var _a, _b;
         (_a = this === null || this === void 0 ? void 0 : this.loveLettersQueue) === null || _a === void 0 ? void 0 : _a.push(letter);
-        if (!this.isProcessingQueue) {
-            this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+        if (!((_b = this.config.settings.whiteLabelling) === null || _b === void 0 ? void 0 : _b.hideLoveLetters) && !this.config.settings.fetchRemoteWhiteLabelling) {
+            if (!this.isProcessingQueue) {
+                this === null || this === void 0 ? void 0 : this.processLoveLetterQueue();
+            }
         }
     }
     processLoveLetterQueue() {
@@ -24428,13 +24450,6 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             }, 1000);
         }
     }
-    wrapWebSocketOnCloseHandler() {
-        var _a, _b;
-        let self = this;
-        (_b = (_a = this.webRtcController) === null || _a === void 0 ? void 0 : _a.transport) === null || _b === void 0 ? void 0 : _b.addEventListener("close", (event) => {
-            EventHandler_1.EventHandler.Emit(self.websocketOnCloseHandler, event);
-        });
-    }
     onStreamingStateChange(callback) {
         var _a, _b, _c, _d;
         const videoElement = (_b = (_a = this === null || this === void 0 ? void 0 : this.webRtcController) === null || _a === void 0 ? void 0 : _a.videoPlayer) === null || _b === void 0 ? void 0 : _b.getVideoElement();
@@ -24624,6 +24639,9 @@ class ArcwarePixelStreaming extends lib_pixelstreamingfrontend_ue5_5_1.PixelStre
             s.endsWith(".ogv") ||
             s.endsWith(".m3u8"));
     }
+    static clearSessionId() {
+        window.localStorage.removeItem("pxss"); // or your actual key
+    }
 }
 exports.ArcwarePixelStreaming = ArcwarePixelStreaming;
 
@@ -24697,7 +24715,8 @@ exports.ArcwareSettingsSchema = zod_1.z.object({
         .strict()
         .optional(),
     /** Loader customization */
-    whiteLabelling: ZWhiteLabel_1.ZWhiteLabel.optional()
+    whiteLabelling: ZWhiteLabel_1.ZWhiteLabel.optional(),
+    fetchRemoteWhiteLabelling: zod_1.z.boolean().optional()
 });
 
 
@@ -25517,7 +25536,9 @@ exports.ZWhiteLabel = zod_1.z
     splashScreenUrl: ImageUrl.optional(),
     splashScreenMode: zod_1.z.enum(["contain", "cover", "stretch", "repeat"]).optional(),
     splashScreenPosition: zod_1.z.string().optional(),
-    splashScreenBgColor: zod_1.z.string().optional()
+    splashScreenBgColor: zod_1.z.string().optional(),
+    hideLoveLetters: zod_1.z.boolean().optional(),
+    hideAfkOverlay: zod_1.z.boolean().optional()
 })
     .strict();
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@arcware-cloud/pixelstreaming-websdk",
   "description": "WebSDK for easy implementation of pixel streaming with Arcware Cloud Services. Heavily based on the '@epicgames-ps' library.",
-  "version": "1.3.18",
+  "version": "1.3.19",
   "type": "commonjs",
   "main": "./index.umd.js",
-  "module": "./index.umd.js",
+  "module": "./index.esm.js",
   "types": "./types/index.d.ts",
   "keywords": [
     "arcware",
@@ -20,8 +20,9 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@epicgames-ps/lib-pixelstreamingcommon-ue5.5": "^0.3.1",
-    "@epicgames-ps/lib-pixelstreamingfrontend-ue5.5": "^1.2.1",
-    "@epicgames-ps/lib-pixelstreamingfrontend-ui-ue5.5": "^1.3.1"
+    "@epicgames-ps/lib-pixelstreamingcommon-ue5.5": "^0.3.2",
+    "@epicgames-ps/lib-pixelstreamingfrontend-ue5.5": "^1.2.4",
+    "@epicgames-ps/lib-pixelstreamingfrontend-ui-ue5.5": "^1.3.1",
+    "zod": "^3.21.4"
   }
 }

package/types/lib/ArcwareApplication.d.ts

@@ -5,6 +5,7 @@ export declare class ArcwareApplication extends Application {
         new (): {};
         noSession: "noSession";
     };
+    private baseShowAfkOverlay;
     stream: ArcwarePixelStreaming;
     private videoElementParent;
     private parentElement;
@@ -49,4 +50,5 @@ export declare class ArcwareApplication extends Application {
     private addTextToConnectOverlay;
     analyticsEvent(response: unknown): void;
     private fileDownload;
+    private syncAfkOverlayFromWhiteLabelling;
 }

package/types/lib/ArcwareConfig.d.ts

@@ -29,14 +29,10 @@ export declare class ArcwareConfig extends Config {
     readonly session: Session;
     readonly settings: Settings;
     private _initialSettings;
-    readonly VERSION = "1.3.18";
+    readonly VERSION = "1.3.19";
     readonly whiteLabellingChanged: EventHandler<{
-        loadingIconUrl?: string;
-        loadingIconFadeMs?: number;
-        splashScreenUrl?: string;
-        splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
-        splashScreenPosition?: string;
-        splashScreenBgColor?: string;
+        next: WhiteLabel;
+        changed: boolean;
     }>;
     private signallingWlURL;
     constructor(config: ArcwareConfigParams);

package/types/lib/ArcwarePixelStreaming.d.ts

@@ -125,7 +125,6 @@ export declare class ArcwarePixelStreaming extends PixelStreaming {
     toggleAudio(videoElement: HTMLVideoElement, enabled: boolean): void;
     private createMicrophoneOverlay;
     toggleMic(enable: boolean, isDefault: boolean): void;
-    private wrapWebSocketOnCloseHandler;
     onStreamingStateChange(callback: (isStreaming: boolean) => void): void;
     private removeXRIconIfDisabled;
     private injectCustomUI;
@@ -135,5 +134,6 @@ export declare class ArcwarePixelStreaming extends PixelStreaming {
     private upsertSplashVideo;
     private hideSplashVideo;
     private isVideoUrl;
+    static clearSessionId(): void;
 }
 export {};

package/types/lib/domain/ArcwareSettingsSchema.d.ts

@@ -140,6 +140,8 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
         splashScreenMode: z.ZodOptional<z.ZodEnum<["contain", "cover", "stretch", "repeat"]>>;
         splashScreenPosition: z.ZodOptional<z.ZodString>;
         splashScreenBgColor: z.ZodOptional<z.ZodString>;
+        hideLoveLetters: z.ZodOptional<z.ZodBoolean>;
+        hideAfkOverlay: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         loadingIconUrl?: string;
         loadingIconFadeMs?: number;
@@ -147,6 +149,8 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
         splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
         splashScreenPosition?: string;
         splashScreenBgColor?: string;
+        hideLoveLetters?: boolean;
+        hideAfkOverlay?: boolean;
     }, {
         loadingIconUrl?: string;
         loadingIconFadeMs?: number;
@@ -154,7 +158,10 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
         splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
         splashScreenPosition?: string;
         splashScreenBgColor?: string;
+        hideLoveLetters?: boolean;
+        hideAfkOverlay?: boolean;
     }>>;
+    fetchRemoteWhiteLabelling: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     session?: string;
     token?: string;
@@ -207,7 +214,10 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
         splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
         splashScreenPosition?: string;
         splashScreenBgColor?: string;
+        hideLoveLetters?: boolean;
+        hideAfkOverlay?: boolean;
     };
+    fetchRemoteWhiteLabelling?: boolean;
 }, {
     session?: string;
     token?: string;
@@ -260,6 +270,9 @@ export declare const ArcwareSettingsSchema: z.ZodObject<{
         splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
         splashScreenPosition?: string;
         splashScreenBgColor?: string;
+        hideLoveLetters?: boolean;
+        hideAfkOverlay?: boolean;
     };
+    fetchRemoteWhiteLabelling?: boolean;
 }>;
 export type Settings = z.infer<typeof ArcwareSettingsSchema>;

package/types/lib/features/ZWhiteLabel.d.ts

@@ -7,6 +7,8 @@ export declare const ZWhiteLabel: z.ZodObject<{
     splashScreenMode: z.ZodOptional<z.ZodEnum<["contain", "cover", "stretch", "repeat"]>>;
     splashScreenPosition: z.ZodOptional<z.ZodString>;
     splashScreenBgColor: z.ZodOptional<z.ZodString>;
+    hideLoveLetters: z.ZodOptional<z.ZodBoolean>;
+    hideAfkOverlay: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     loadingIconUrl?: string;
     loadingIconFadeMs?: number;
@@ -14,6 +16,8 @@ export declare const ZWhiteLabel: z.ZodObject<{
     splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
     splashScreenPosition?: string;
     splashScreenBgColor?: string;
+    hideLoveLetters?: boolean;
+    hideAfkOverlay?: boolean;
 }, {
     loadingIconUrl?: string;
     loadingIconFadeMs?: number;
@@ -21,5 +25,7 @@ export declare const ZWhiteLabel: z.ZodObject<{
     splashScreenMode?: "repeat" | "contain" | "cover" | "stretch";
     splashScreenPosition?: string;
     splashScreenBgColor?: string;
+    hideLoveLetters?: boolean;
+    hideAfkOverlay?: boolean;
 }>;
 export type WhiteLabel = z.infer<typeof ZWhiteLabel>;