@volley/vwr-loader 1.2.0 → 1.4.0

package/dist/polyfills.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Polyfills for Chrome 68+ compatibility (Samsung/LG TVs)
+ *
+ * Import this at the top of main.ts BEFORE any other code runs.
+ * Conservative approach: polyfill all features not available in Chrome 68.
+ *
+ * ECMAScript polyfills (via core-js):
+ * - globalThis (Chrome 71)
+ * - Array.prototype.flat/flatMap (Chrome 69)
+ * - Object.fromEntries (Chrome 73)
+ * - String.prototype.matchAll (Chrome 73)
+ * - Promise.allSettled (Chrome 76)
+ * - String.prototype.replaceAll (Chrome 85)
+ * - Array.prototype.at / String.prototype.at (Chrome 92)
+ *
+ * Web API polyfills:
+ * - focus-visible (Chrome 86) - critical for TV remote navigation
+ */
+import "core-js/modules/es.global-this.js";
+import "core-js/modules/es.array.flat.js";
+import "core-js/modules/es.array.flat-map.js";
+import "core-js/modules/es.object.from-entries.js";
+import "core-js/modules/es.string.match-all.js";
+import "core-js/modules/es.promise.all-settled.js";
+import "core-js/modules/es.string.replace-all.js";
+import "core-js/modules/es.array.at.js";
+import "core-js/modules/es.string.at-alternative.js";
+import "focus-visible";
+//# sourceMappingURL=polyfills.d.ts.map

package/dist/polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.d.ts","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,mCAAmC,CAAA;AAC1C,OAAO,kCAAkC,CAAA;AACzC,OAAO,sCAAsC,CAAA;AAC7C,OAAO,2CAA2C,CAAA;AAClD,OAAO,wCAAwC,CAAA;AAC/C,OAAO,2CAA2C,CAAA;AAClD,OAAO,0CAA0C,CAAA;AACjD,OAAO,gCAAgC,CAAA;AACvC,OAAO,6CAA6C,CAAA;AAGpD,OAAO,eAAe,CAAA"}

package/dist/polyfills.js

@@ -0,0 +1,32 @@
+/**
+ * Polyfills for Chrome 68+ compatibility (Samsung/LG TVs)
+ *
+ * Import this at the top of main.ts BEFORE any other code runs.
+ * Conservative approach: polyfill all features not available in Chrome 68.
+ *
+ * ECMAScript polyfills (via core-js):
+ * - globalThis (Chrome 71)
+ * - Array.prototype.flat/flatMap (Chrome 69)
+ * - Object.fromEntries (Chrome 73)
+ * - String.prototype.matchAll (Chrome 73)
+ * - Promise.allSettled (Chrome 76)
+ * - String.prototype.replaceAll (Chrome 85)
+ * - Array.prototype.at / String.prototype.at (Chrome 92)
+ *
+ * Web API polyfills:
+ * - focus-visible (Chrome 86) - critical for TV remote navigation
+ */
+// ECMAScript polyfills via core-js
+import "core-js/modules/es.global-this.js";
+import "core-js/modules/es.array.flat.js";
+import "core-js/modules/es.array.flat-map.js";
+import "core-js/modules/es.object.from-entries.js";
+import "core-js/modules/es.string.match-all.js";
+import "core-js/modules/es.promise.all-settled.js";
+import "core-js/modules/es.string.replace-all.js";
+import "core-js/modules/es.array.at.js";
+import "core-js/modules/es.string.at-alternative.js";
+// Web API polyfills
+// focus-visible - Critical for TV remote focus rings
+import "focus-visible";
+//# sourceMappingURL=polyfills.js.map

package/dist/polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.js","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,mCAAmC;AACnC,OAAO,mCAAmC,CAAA;AAC1C,OAAO,kCAAkC,CAAA;AACzC,OAAO,sCAAsC,CAAA;AAC7C,OAAO,2CAA2C,CAAA;AAClD,OAAO,wCAAwC,CAAA;AAC/C,OAAO,2CAA2C,CAAA;AAClD,OAAO,0CAA0C,CAAA;AACjD,OAAO,gCAAgC,CAAA;AACvC,OAAO,6CAA6C,CAAA;AACpD,oBAAoB;AACpB,qDAAqD;AACrD,OAAO,eAAe,CAAA"}

package/dist/types.d.ts

@@ -64,12 +64,16 @@ declare global {
             fetchAppInfo?: (callback: (appInfo?: {
                 version?: string;
             }) => void) => void;
+            platformBack?: () => void;
         };
         tizen?: {
             application?: {
                 getAppInfo: () => {
                     version?: string;
                 };
+                getCurrentApplication: () => {
+                    exit: () => void;
+                };
             };
         };
     }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAChD,aAAa,CAAC,EAAE;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,iBAAiB,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;CACJ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,SAAS,CAAC,EAAE;YACR,OAAO,CAAC,EAAE;gBACN,UAAU,CAAC,EAAE;oBACT,aAAa,IAAI,OAAO,CAAC;wBACrB,WAAW,CAAC,EAAE,MAAM,CAAA;wBACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;qBACrB,CAAC,CAAA;oBACF,YAAY,IAAI,OAAO,CAAC;wBACpB,SAAS,CAAC,EAAE,MAAM,CAAA;wBAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;qBACrB,CAAC,CAAA;oBACF,4BAA4B,IAAI,OAAO,CAAC;wBACpC,WAAW,CAAC,EAAE,MAAM,CAAA;qBACvB,CAAC,CAAA;oBACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;iBACrB,CAAA;gBACD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;aACrB,CAAA;YACD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SACrB,CAAA;QACD,OAAO,CAAC,EAAE;YACN,WAAW,CAAC,EAAE;gBACV,OAAO,EAAE,MAAM,MAAM,CAAA;aACxB,CAAA;SACJ,CAAA;QACD,KAAK,CAAC,EAAE;YACJ,OAAO,CAAC,EAAE;gBACN,OAAO,EAAE,CACL,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;oBACL,MAAM,CAAC,EAAE,MAAM,CAAA;oBACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;oBACpC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;oBAClD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;wBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;qBAAE,KAAK,IAAI,CAAA;oBACnD,SAAS,CAAC,EAAE,OAAO,CAAA;iBACtB,KACA;oBACD,MAAM,EAAE,MAAM,IAAI,CAAA;iBACrB,CAAA;aACJ,CAAA;YACD,YAAY,CAAC,EAAE,CACX,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,KAAK,IAAI,KACjD,IAAI,CAAA;SACZ,CAAA;QACD,KAAK,CAAC,EAAE;YACJ,WAAW,CAAC,EAAE;gBACV,UAAU,EAAE,MAAM;oBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aACzC,CAAA;SACJ,CAAA;KACJ;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;IACF,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,MAAM;IAChD,aAAa,CAAC,EAAE;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;IACD,iBAAiB,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;KACzB,CAAA;CACJ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,SAAS,CAAC,EAAE;YACR,OAAO,CAAC,EAAE;gBACN,UAAU,CAAC,EAAE;oBACT,aAAa,IAAI,OAAO,CAAC;wBACrB,WAAW,CAAC,EAAE,MAAM,CAAA;wBACpB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;qBACrB,CAAC,CAAA;oBACF,YAAY,IAAI,OAAO,CAAC;wBACpB,SAAS,CAAC,EAAE,MAAM,CAAA;wBAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;qBACrB,CAAC,CAAA;oBACF,4BAA4B,IAAI,OAAO,CAAC;wBACpC,WAAW,CAAC,EAAE,MAAM,CAAA;qBACvB,CAAC,CAAA;oBACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;iBACrB,CAAA;gBACD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;aACrB,CAAA;YACD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SACrB,CAAA;QACD,OAAO,CAAC,EAAE;YACN,WAAW,CAAC,EAAE;gBACV,OAAO,EAAE,MAAM,MAAM,CAAA;aACxB,CAAA;SACJ,CAAA;QACD,KAAK,CAAC,EAAE;YACJ,OAAO,CAAC,EAAE;gBACN,OAAO,EAAE,CACL,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;oBACL,MAAM,CAAC,EAAE,MAAM,CAAA;oBACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;oBACpC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAA;oBAClD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE;wBAAE,SAAS,CAAC,EAAE,MAAM,CAAA;qBAAE,KAAK,IAAI,CAAA;oBACnD,SAAS,CAAC,EAAE,OAAO,CAAA;iBACtB,KACA;oBACD,MAAM,EAAE,MAAM,IAAI,CAAA;iBACrB,CAAA;aACJ,CAAA;YACD,YAAY,CAAC,EAAE,CACX,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;gBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;aAAE,KAAK,IAAI,KACjD,IAAI,CAAA;YACT,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;SAC5B,CAAA;QACD,KAAK,CAAC,EAAE;YACJ,WAAW,CAAC,EAAE;gBACV,UAAU,EAAE,MAAM;oBAAE,OAAO,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;gBACtC,qBAAqB,EAAE,MAAM;oBACzB,IAAI,EAAE,MAAM,IAAI,CAAA;iBACnB,CAAA;aACJ,CAAA;SACJ,CAAA;KACJ;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,KAAK,CAAC;QACX,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,OAAO,CAAC,EAAE,MAAM,CAAA;KACnB,CAAC,CAAA;IACF,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@volley/vwr-loader",
-    "version": "1.2.0",
+    "version": "1.4.0",
     "type": "module",
     "description": "Vite-based VWR loader for all Volley platforms",
     "main": "dist/index.js",
@@ -36,7 +36,9 @@
         "@datadog/browser-rum": "^6.25.2",
         "@volley/logger": "^1.4.1",
         "commander": "^12.0.0",
+        "core-js": "^3.45.0",
         "dotenv": "^16.0.0",
+        "focus-visible": "^5.2.1",
         "fs-extra": "^11.0.0",
         "uuid": "^11.1.0",
         "vite": "^5.0.0"

package/src/exitHandler.test.ts

@@ -0,0 +1,179 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"
+
+import { exitIfBackNavigation, setupLGBackButtonHandler } from "./exitHandler"
+
+describe("exitHandler", () => {
+    beforeEach(() => {
+        vi.clearAllMocks()
+    })
+
+    afterEach(() => {
+        vi.restoreAllMocks()
+    })
+
+    describe("exitIfBackNavigation", () => {
+        it("should not exit when navigation type is not back_forward", () => {
+            vi.spyOn(performance, "getEntriesByType").mockReturnValue([
+                { type: "navigate" } as PerformanceNavigationTiming,
+            ])
+
+            const mockExit = vi.fn()
+            window.tizen = {
+                application: {
+                    getAppInfo: () => ({ version: "1.0.0" }),
+                    getCurrentApplication: () => ({ exit: mockExit }),
+                },
+            }
+
+            exitIfBackNavigation("SAMSUNG_TV")
+
+            expect(mockExit).not.toHaveBeenCalled()
+        })
+
+        it("should exit Samsung app when back_forward detected", () => {
+            vi.spyOn(performance, "getEntriesByType").mockReturnValue([
+                { type: "back_forward" } as PerformanceNavigationTiming,
+            ])
+
+            const mockExit = vi.fn()
+            window.tizen = {
+                application: {
+                    getAppInfo: () => ({ version: "1.0.0" }),
+                    getCurrentApplication: () => ({ exit: mockExit }),
+                },
+            }
+
+            exitIfBackNavigation("SAMSUNG_TV")
+
+            expect(mockExit).toHaveBeenCalled()
+        })
+
+        it("should close window for LG app when back_forward detected", () => {
+            vi.spyOn(performance, "getEntriesByType").mockReturnValue([
+                { type: "back_forward" } as PerformanceNavigationTiming,
+            ])
+
+            const mockClose = vi.fn()
+            vi.spyOn(window, "close").mockImplementation(mockClose)
+
+            exitIfBackNavigation("LG_TV")
+
+            expect(mockClose).toHaveBeenCalled()
+        })
+
+        it("should not exit when no navigation entries exist", () => {
+            vi.spyOn(performance, "getEntriesByType").mockReturnValue([])
+
+            const mockClose = vi.fn()
+            vi.spyOn(window, "close").mockImplementation(mockClose)
+
+            exitIfBackNavigation("LG_TV")
+
+            expect(mockClose).not.toHaveBeenCalled()
+        })
+
+        it("should handle errors gracefully", () => {
+            vi.spyOn(performance, "getEntriesByType").mockImplementation(() => {
+                throw new Error("Performance API not available")
+            })
+
+            // Should not throw
+            expect(() => exitIfBackNavigation("SAMSUNG_TV")).not.toThrow()
+        })
+
+        it("should handle platforms without specific exit behavior", () => {
+            vi.spyOn(performance, "getEntriesByType").mockReturnValue([
+                { type: "back_forward" } as PerformanceNavigationTiming,
+            ])
+
+            // Fire TV doesn't have platform-specific exit - just logs
+            expect(() => exitIfBackNavigation("FIRE_TV")).not.toThrow()
+        })
+    })
+
+    describe("setupLGBackButtonHandler", () => {
+        const LG_BACK_KEYCODE = 461
+
+        it("should call webOS.platformBack when back button is pressed", () => {
+            const mockPlatformBack = vi.fn()
+            window.webOS = { platformBack: mockPlatformBack }
+
+            const cleanup = setupLGBackButtonHandler()
+
+            // Simulate LG back button press
+            const event = new KeyboardEvent("keydown", {
+                keyCode: LG_BACK_KEYCODE,
+            })
+            document.dispatchEvent(event)
+
+            expect(mockPlatformBack).toHaveBeenCalled()
+
+            cleanup()
+        })
+
+        it("should fall back to window.close when platformBack is not available", () => {
+            window.webOS = {} // No platformBack
+            const mockClose = vi.fn()
+            vi.spyOn(window, "close").mockImplementation(mockClose)
+
+            const cleanup = setupLGBackButtonHandler()
+
+            const event = new KeyboardEvent("keydown", {
+                keyCode: LG_BACK_KEYCODE,
+            })
+            document.dispatchEvent(event)
+
+            expect(mockClose).toHaveBeenCalled()
+
+            cleanup()
+        })
+
+        it("should not trigger on other key presses", () => {
+            const mockPlatformBack = vi.fn()
+            window.webOS = { platformBack: mockPlatformBack }
+
+            const cleanup = setupLGBackButtonHandler()
+
+            // Simulate a different key press (Enter = 13)
+            const event = new KeyboardEvent("keydown", { keyCode: 13 })
+            document.dispatchEvent(event)
+
+            expect(mockPlatformBack).not.toHaveBeenCalled()
+
+            cleanup()
+        })
+
+        it("should remove event listener when cleanup is called", () => {
+            const mockPlatformBack = vi.fn()
+            window.webOS = { platformBack: mockPlatformBack }
+
+            const cleanup = setupLGBackButtonHandler()
+            cleanup()
+
+            // Simulate back button press after cleanup
+            const event = new KeyboardEvent("keydown", {
+                keyCode: LG_BACK_KEYCODE,
+            })
+            document.dispatchEvent(event)
+
+            expect(mockPlatformBack).not.toHaveBeenCalled()
+        })
+
+        it("should handle missing webOS object gracefully", () => {
+            window.webOS = undefined
+            const mockClose = vi.fn()
+            vi.spyOn(window, "close").mockImplementation(mockClose)
+
+            const cleanup = setupLGBackButtonHandler()
+
+            const event = new KeyboardEvent("keydown", {
+                keyCode: LG_BACK_KEYCODE,
+            })
+            document.dispatchEvent(event)
+
+            expect(mockClose).toHaveBeenCalled()
+
+            cleanup()
+        })
+    })
+})

package/src/exitHandler.ts

@@ -0,0 +1,125 @@
+/**
+ * Back button / exit handling for vwr-loader.
+ *
+ * This is a safety net for when VWR fails to load and user presses back.
+ * When VWR loads successfully, it handles exit behavior itself.
+ */
+
+import { logger } from "./logger"
+
+/** LG webOS back button keycode */
+const LG_BACK_KEYCODE = 461
+
+/**
+ * Exit the app if the page was loaded via back/forward navigation.
+ *
+ * This is a safety net for Samsung/LG TVs: if VWR failed to load and user
+ * pressed back, they'd land on the loader again. This detects that and exits.
+ *
+ * Note: On LG TV with disableBackHistoryAPI: true, this won't trigger
+ * because the platform doesn't automatically navigate back. Use
+ * setupLGBackButtonHandler() for LG back button support.
+ */
+export function exitIfBackNavigation(platform: Platform): void {
+    try {
+        const navEntries = performance.getEntriesByType("navigation")
+        const navEntry = navEntries[0] as
+            | PerformanceNavigationTiming
+            | undefined
+
+        if (navEntry?.type === "back_forward") {
+            logger.info(
+                { platform, navigationType: navEntry.type },
+                "[Shell] Back navigation detected, exiting app"
+            )
+            exitApp(platform)
+        }
+    } catch (error) {
+        // Performance API may not be available on all platforms
+        logger.warn({ error }, "[Shell] Could not check navigation type")
+    }
+}
+
+/**
+ * Set up LG back button (keycode 461) handler.
+ *
+ * On LG TV with disableBackHistoryAPI: true in appinfo.json, the platform
+ * doesn't automatically handle the back button. This sets up a keydown
+ * listener to call webOS.platformBack() which shows the system exit popup
+ * on webOS 6.0+ or launches Home on older versions.
+ *
+ * Once VWR loads successfully, call the returned cleanup function - VWR/PSDK
+ * will take over back button handling with its own custom modal.
+ *
+ * @returns Cleanup function to remove the listener
+ */
+export function setupLGBackButtonHandler(): () => void {
+    const handleKeyDown = (event: KeyboardEvent): void => {
+        if (event.keyCode === LG_BACK_KEYCODE) {
+            logger.info(
+                "[Shell] LG back button pressed, triggering platform exit"
+            )
+
+            if (window.webOS?.platformBack) {
+                window.webOS.platformBack()
+            } else {
+                logger.warn(
+                    "[Shell] webOS.platformBack not available, using window.close"
+                )
+                window.close()
+            }
+        }
+    }
+
+    document.addEventListener("keydown", handleKeyDown)
+    logger.info("[Shell] LG back button handler registered")
+
+    return () => {
+        document.removeEventListener("keydown", handleKeyDown)
+        logger.info("[Shell] LG back button handler removed")
+    }
+}
+
+/**
+ * Exit the app using platform-specific methods.
+ *
+ * @param platform - Platform identifier
+ */
+function exitApp(platform: Platform): void {
+    switch (platform) {
+        case "SAMSUNG_TV":
+            exitSamsungApp()
+            break
+        case "LG_TV":
+            exitLGAppViaBackNavigation()
+            break
+        // Fire TV and mobile apps handle exit at the native layer
+        // Web doesn't have a meaningful "exit" concept
+        default:
+            logger.info({ platform }, "[Shell] No platform-specific exit")
+    }
+}
+
+function exitSamsungApp(): void {
+    try {
+        if (window.tizen?.application?.getCurrentApplication) {
+            window.tizen.application.getCurrentApplication().exit()
+        } else {
+            logger.warn("[Shell] Tizen exit API not available")
+        }
+    } catch (error) {
+        logger.error({ error }, "[Shell] Failed to exit Samsung app")
+    }
+}
+
+/**
+ * Exit LG app when back navigation is detected.
+ * Uses window.close() for immediate exit since user already navigated back.
+ */
+function exitLGAppViaBackNavigation(): void {
+    try {
+        window.close()
+    } catch (error) {
+        logger.error({ error }, "[Shell] Failed to exit LG app")
+    }
+}

package/src/loadVwr.ts

@@ -298,6 +298,7 @@ async function initializeVwr(rum: DatadogRum | undefined) {
         await vwr.init(
             {
                 hubUrl: vwrConfig.hubUrl,
+                launchUrl: vwrConfig.launchUrl,
                 platform: PLATFORM,
                 stage: ENVIRONMENT,
                 appVersion: shellVersion,

package/src/main.test.ts

@@ -70,7 +70,7 @@ describe("main.ts fallback behavior", () => {
             })
 
             expect(mockLocationHref).toHaveBeenCalledWith(
-                "https://hub.example.com/?volley_platform=FIRE_TV"
+                "https://hub.example.com/?volley_platform=FIRE_TV&version=unknown"
             )
             expect(logger.info).toHaveBeenCalledWith(
                 expect.objectContaining({
@@ -117,7 +117,7 @@ describe("main.ts fallback behavior", () => {
             })
 
             expect(mockLocationHref).toHaveBeenCalledWith(
-                "https://hub.example.com/?volley_platform=FIRE_TV"
+                "https://hub.example.com/?volley_platform=FIRE_TV&version=unknown"
             )
         })
 
@@ -134,7 +134,7 @@ describe("main.ts fallback behavior", () => {
             })
 
             expect(mockLocationHref).toHaveBeenCalledWith(
-                "https://hub.example.com/?volley_platform=FIRE_TV"
+                "https://hub.example.com/?volley_platform=FIRE_TV&version=unknown"
             )
         })
 
@@ -150,7 +150,7 @@ describe("main.ts fallback behavior", () => {
             // Verify error was logged (exact format depends on error type)
             expect(logger.error).toHaveBeenCalled()
             expect(mockLocationHref).toHaveBeenCalledWith(
-                "https://hub.example.com/?volley_platform=FIRE_TV"
+                "https://hub.example.com/?volley_platform=FIRE_TV&version=unknown"
             )
         })
     })

package/src/main.ts

@@ -1,5 +1,9 @@
+// Load polyfills FIRST before any other code
+import "./polyfills"
+
 import { initRumGlobal } from "./datadog"
 import { InitializationError, isVWRInitializationError } from "./errors"
+import { exitIfBackNavigation, setupLGBackButtonHandler } from "./exitHandler"
 import { loadVwr } from "./loadVwr"
 import { logger } from "./logger"
 
@@ -42,6 +46,10 @@ function handleInitializationError(error: unknown) {
 }
 
 async function init() {
+    // Exit app if user pressed back - safety net for Samsung/LG TVs
+    // when VWR fails to load and user navigates back to loader
+    exitIfBackNavigation(PLATFORM)
+
     // Initialize Datadog RUM early (if credentials provided)
     // For mobile webviews with WebViewTracking.enable(), events are
     // automatically forwarded to the mobile app's RUM session
@@ -53,9 +61,21 @@ async function init() {
         service: "vwr-loader",
     })
 
+    // Set up LG back button handler while loader is active.
+    // On LG with disableBackHistoryAPI: true, the platform doesn't handle back automatically.
+    // Once VWR loads, it will take over with PSDK's custom exit modal.
+    let cleanupLGBackHandler: (() => void) | undefined
+    if (PLATFORM === "LG_TV") {
+        cleanupLGBackHandler = setupLGBackButtonHandler()
+    }
+
     try {
         await loadVwr(rum)
+        // VWR loaded successfully - remove our back handler, PSDK takes over
+        cleanupLGBackHandler?.()
     } catch (error) {
+        // Keep LG back handler active during fallback - it will handle exit
+        // if user presses back on the Hub page and navigates back here
         try {
             handleInitializationError(error)
         } finally {
@@ -79,6 +99,10 @@ async function init() {
             } else {
                 fallbackUrl = new URL(HUB_URL)
                 fallbackUrl.searchParams.set("volley_platform", PLATFORM)
+                fallbackUrl.searchParams.set(
+                    "version",
+                    SHELL_VERSION ?? "unknown"
+                )
 
                 logger.info(
                     {

package/src/polyfills.ts

@@ -0,0 +1,32 @@
+/**
+ * Polyfills for Chrome 68+ compatibility (Samsung/LG TVs)
+ *
+ * Import this at the top of main.ts BEFORE any other code runs.
+ * Conservative approach: polyfill all features not available in Chrome 68.
+ *
+ * ECMAScript polyfills (via core-js):
+ * - globalThis (Chrome 71)
+ * - Array.prototype.flat/flatMap (Chrome 69)
+ * - Object.fromEntries (Chrome 73)
+ * - String.prototype.matchAll (Chrome 73)
+ * - Promise.allSettled (Chrome 76)
+ * - String.prototype.replaceAll (Chrome 85)
+ * - Array.prototype.at / String.prototype.at (Chrome 92)
+ *
+ * Web API polyfills:
+ * - focus-visible (Chrome 86) - critical for TV remote navigation
+ */
+
+// ECMAScript polyfills via core-js
+import "core-js/modules/es.global-this.js"
+import "core-js/modules/es.array.flat.js"
+import "core-js/modules/es.array.flat-map.js"
+import "core-js/modules/es.object.from-entries.js"
+import "core-js/modules/es.string.match-all.js"
+import "core-js/modules/es.promise.all-settled.js"
+import "core-js/modules/es.string.replace-all.js"
+import "core-js/modules/es.array.at.js"
+import "core-js/modules/es.string.at-alternative.js"
+// Web API polyfills
+// focus-visible - Critical for TV remote focus rings
+import "focus-visible"

package/src/types.ts

@@ -67,10 +67,14 @@ declare global {
             fetchAppInfo?: (
                 callback: (appInfo?: { version?: string }) => void
             ) => void
+            platformBack?: () => void
         }
         tizen?: {
             application?: {
                 getAppInfo: () => { version?: string }
+                getCurrentApplication: () => {
+                    exit: () => void
+                }
             }
         }
     }

package/src/vite-env.d.ts

@@ -1,10 +1,22 @@
+/**
+ * Supported platform identifiers.
+ * These must be uppercase - invalid values will cause build-time TypeScript errors.
+ */
+type Platform =
+    | "FIRE_TV"
+    | "SAMSUNG_TV"
+    | "LG_TV"
+    | "ANDROID_MOBILE"
+    | "IOS_MOBILE"
+    | "WEB"
+
 interface ImportMetaEnv {
     readonly VITE_HUB_URL: string
     readonly VITE_VWR_URL: string
     readonly VITE_LAUNCH_URL: string
     readonly VITE_AMPLITUDE_DEPLOYMENT_KEY: string
     readonly VITE_ENVIRONMENT: string
-    readonly VITE_PLATFORM: string
+    readonly VITE_PLATFORM: Platform
     readonly VITE_SHELL_VERSION: string
     readonly VITE_CONFIG_URL: string
     readonly VITE_CONFIG_FILE: string