@vizbeetv/homesso-sdk-qa 1.0.3 → 1.0.5

package/es6/index.cjs

@@ -404,16 +404,16 @@ class Logger {
 const logger = new Logger();
 
 const LOG_TAG$1 = 'VizbeeHomeSSOManager';
-/* eslint-disable @typescript-eslint/no-explicit-any */
 class VizbeeMetricsManager {
     constructor() {
-        var _a, _b, _c;
+        var _a, _b;
+        this.metricsManager = null;
         this.senderInfo = null;
         this.getSignInInfo = () => __awaiter(this, void 0, void 0, function* () { return []; });
-        if ((_c = (_b = (_a = window === null || window === void 0 ? void 0 : window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.analytics) === null || _c === void 0 ? void 0 : _c.AnalyticsProvider) {
+        const vizbee = window === null || window === void 0 ? void 0 : window.vizbee;
+        if ((_b = (_a = vizbee === null || vizbee === void 0 ? void 0 : vizbee.continuity) === null || _a === void 0 ? void 0 : _a.analytics) === null || _b === void 0 ? void 0 : _b.AnalyticsProvider) {
             this.metricsManager =
-                new window.vizbee.continuity.analytics.AnalyticsProvider();
-            // Create a wrapper with 'provider' property
+                new vizbee.continuity.analytics.AnalyticsProvider();
             const attributesProvider = {
                 getAttributes: () => this.getAttributes(),
             };
@@ -441,7 +441,8 @@ class VizbeeMetricsManager {
         this.metricsManager.logMetrics(event, attributesToBeSent);
     }
     setCustomAttributes(customAttributes) {
-        this.metricsManager.setCustomAttributes(customAttributes);
+        var _a;
+        (_a = this.metricsManager) === null || _a === void 0 ? void 0 : _a.setCustomAttributes(customAttributes);
     }
     getAttributes() {
         return this.createAttributesJson();
@@ -481,7 +482,7 @@ class VizbeeMetricsManager {
         var _a, _b, _c, _d;
         const attributes = {};
         attributes[VizbeeMetricsConstants.METRICS_ATTR_SCREEN_HOMESSO_SDK_VERSION] =
-            '1.0.1';
+            '1.0.5';
         attributes['REMOTE_FRIENDLY_NAME'] = (_a = this.senderInfo) === null || _a === void 0 ? void 0 : _a.friendlyName;
         attributes['REMOTE_DEVICE_ID'] = (_b = this.senderInfo) === null || _b === void 0 ? void 0 : _b.deviceId;
         attributes['REMOTE_DEVICE_TYPE'] = (_c = this.senderInfo) === null || _c === void 0 ? void 0 : _c.deviceType;
@@ -514,15 +515,24 @@ const VizbeeConstants = {
     // SDK events types
     VIZBEE_SESSION_READY: 'vizbee-bicast-session-ready',
 };
+/**
+ * Numeric session states reported by the Continuity SDK's bicast session manager.
+ * Mirrors SessionState in the VTV SDK — defined here so HomeSSO has no magic numbers.
+ */
+const VizbeeSessionState = {
+    NOT_CONNECTED: 1,
+    CONNECTING: 2,
+    CONNECTED: 3,
+};
 // Enum for sign in states
-var VizbeeSignInState;
+exports.VizbeeSignInState = void 0;
 (function (VizbeeSignInState) {
     VizbeeSignInState["SIGN_IN_NOT_STARTED"] = "not_started";
     VizbeeSignInState["SIGN_IN_IN_PROGRESS"] = "in_progress";
     VizbeeSignInState["SIGN_IN_COMPLETED"] = "completed";
     VizbeeSignInState["SIGN_IN_FAILED"] = "failed";
     VizbeeSignInState["SIGN_IN_CANCELLED"] = "cancelled";
-})(VizbeeSignInState || (VizbeeSignInState = {}));
+})(exports.VizbeeSignInState || (exports.VizbeeSignInState = {}));
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
 // Base abstract class for sign in status
@@ -547,7 +557,7 @@ class ProgressStatus extends VizbeeSignInStatus {
         this.customData = customData;
     }
     getState() {
-        return VizbeeSignInState.SIGN_IN_IN_PROGRESS;
+        return exports.VizbeeSignInState.SIGN_IN_IN_PROGRESS;
     }
 }
 // Success status class
@@ -559,7 +569,7 @@ class SuccessStatus extends VizbeeSignInStatus {
         this.customData = customData;
     }
     getState() {
-        return VizbeeSignInState.SIGN_IN_COMPLETED;
+        return exports.VizbeeSignInState.SIGN_IN_COMPLETED;
     }
 }
 // Failure status class
@@ -574,8 +584,8 @@ class FailureStatus extends VizbeeSignInStatus {
     }
     getState() {
         return this.isCancelled
-            ? VizbeeSignInState.SIGN_IN_CANCELLED
-            : VizbeeSignInState.SIGN_IN_FAILED;
+            ? exports.VizbeeSignInState.SIGN_IN_CANCELLED
+            : exports.VizbeeSignInState.SIGN_IN_FAILED;
     }
 }
 
@@ -586,12 +596,12 @@ class FailureStatus extends VizbeeSignInStatus {
 /**
  * Enum defining the different types of sign-in modals available in the system
  */
-var SignInModalType;
+exports.SignInModalType = void 0;
 (function (SignInModalType) {
     SignInModalType["INFORMATION"] = "information";
     SignInModalType["PROGRESS"] = "progress";
     SignInModalType["SUCCESS"] = "success";
-})(SignInModalType || (SignInModalType = {}));
+})(exports.SignInModalType || (exports.SignInModalType = {}));
 /**
  * Default theme configuration with basic color scheme
  */
@@ -1229,7 +1239,11 @@ class VizbeeSnackbar {
     }
 }
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * @fileoverview Manages Single Sign-On (SSO) functionality for Vizbee home devices.
+ * Handles communication between mobile and TV devices for authentication purposes.
+ * @module VizbeeHomeSSOManager
+ */
 const LOG_TAG = 'VizbeeHomeSSOManager';
 /**
  * Manages Single Sign-On (SSO) functionality between mobile and TV devices in the Vizbee ecosystem.
@@ -1261,8 +1275,14 @@ class VizbeeHomeSSOManager {
         this.isScreenSignedIn = false;
         /** @internal Tracks if sign-in process is currently active */
         this.isSignInInProgress = false;
+        /**
+         * @internal Tracks which modal is currently shown so the same progress modal
+         * is not re-shown (snackbar.show() hides + re-mounts, which would flicker).
+         */
+        this.shownModal = 'none';
         /** @internal Information about the sender device */
         this.senderInfo = null;
+        this.signInHandler = null;
         /**
          * Modal display preferences for the SSO UI
          * @public
@@ -1415,12 +1435,11 @@ class VizbeeHomeSSOManager {
         var _a, _b;
         try {
             logger.info(`[${LOG_TAG}][initializeVizbeeSession] - Initializing Vizbee session`);
-            // Check if vizbee and continuity exist before accessing xmessages
-            if (!((_b = (_a = window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.xmessages)) {
+            const xmessages = (_b = (_a = window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.xmessages;
+            if (!xmessages) {
                 throw new Error('Vizbee continuity or xmessages not initialized');
             }
-            // Access VizbeeBicastSessionManager directly from the existing object
-            const sessionManager = new window.vizbee.continuity.xmessages.VizbeeBicastSessionManager();
+            const sessionManager = new xmessages.VizbeeBicastSessionManager();
             if (!sessionManager) {
                 throw new Error('Session manager initialization failed');
             }
@@ -1429,7 +1448,7 @@ class VizbeeHomeSSOManager {
             sessionManager.addSessionStateListener({
                 onSessionStateChanged: (state) => {
                     logger.info(`[${LOG_TAG}][onSessionStateChanged] - Session state changed:`, state);
-                    if (state === 3) {
+                    if (state === VizbeeSessionState.CONNECTED) {
                         this.vizbeeSession = sessionManager.getSession();
                         this.vizbeeMessagingClient =
                             this.vizbeeSession.getMessagingClient();
@@ -1481,6 +1500,8 @@ class VizbeeHomeSSOManager {
             if (yield this.shouldIgnoreSignInRequest()) {
                 return;
             }
+            this.isSignInInProgress = true;
+            this.updateProgressUI();
             const signInInfo = {
                 isSignedIn: this.isRemoteSignedIn,
                 signInType: signInType,
@@ -1521,9 +1542,9 @@ class VizbeeHomeSSOManager {
                 const attributes = yield ((_b = (_a = this.vizbeeMetricsManager) === null || _a === void 0 ? void 0 : _a.getAttributes) === null || _b === void 0 ? void 0 : _b.call(_a));
                 const signInInfoList = attributes === null || attributes === void 0 ? void 0 : attributes['SCREEN_HOMESSO_USER_INFO'];
                 logger.info(`[${LOG_TAG}][isUserAlreadySignedIn] - signInInfoList`, signInInfoList);
-                const tvSignInInfo = signInInfoList.find((info) => info.user_login_type === signInType);
+                const tvSignInInfo = signInInfoList === null || signInInfoList === void 0 ? void 0 : signInInfoList.find((info) => info.user_login_type === signInType);
                 logger.debug(`[${LOG_TAG}][isUserAlreadySignedIn] - TV sign in status fetched:`, tvSignInInfo);
-                return tvSignInInfo === null || tvSignInInfo === void 0 ? void 0 : tvSignInInfo.user_is_signed_in;
+                return (tvSignInInfo === null || tvSignInInfo === void 0 ? void 0 : tvSignInInfo.user_is_signed_in) === true;
             }
             catch (error) {
                 logger.warn(`[${LOG_TAG}][isUserAlreadySignedIn] - Error checking sign-in status:`, error);
@@ -1563,12 +1584,14 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     sendStatusToSender(status) {
-        const signInStatus = this.serializeStatus(status);
-        const data = {
-            [VizbeeConstants.KEY_SUB_TYPE]: VizbeeConstants.EVENT_SUBTYPE_SIGN_IN_STATUS,
-            [VizbeeConstants.KEY_SIGN_IN_STATUS]: signInStatus,
-        };
-        this.vizbeeMessagingClient.send(data, VizbeeConstants.EVENT_SSO_NAME);
+        return __awaiter(this, void 0, void 0, function* () {
+            const signInStatus = this.serializeStatus(status);
+            const data = {
+                [VizbeeConstants.KEY_SUB_TYPE]: VizbeeConstants.EVENT_SUBTYPE_SIGN_IN_STATUS,
+                [VizbeeConstants.KEY_SIGN_IN_STATUS]: signInStatus,
+            };
+            yield this.vizbeeMessagingClient.send(data, VizbeeConstants.EVENT_SSO_NAME);
+        });
     }
     /**
      * Serializes status objects for transmission to mobile device
@@ -1578,16 +1601,7 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     serializeStatus(status) {
-        if (status instanceof ProgressStatus) {
-            return status.serialize();
-        }
-        else if (status instanceof SuccessStatus) {
-            return status.serialize();
-        }
-        else if (status instanceof FailureStatus) {
-            return status.serialize();
-        }
-        return null;
+        return status.serialize();
     }
     /**
      * Updates UI for sign-in progress state
@@ -1596,6 +1610,12 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     updateProgressUI() {
+        const targetModal = this.isRemoteSignedIn ? 'progress' : 'informational';
+        // Avoid re-showing the same modal
+        if (this.shownModal === targetModal) {
+            return;
+        }
+        this.shownModal = targetModal;
         if (!this.isRemoteSignedIn) {
             const modalOptions = this.vizbeeHomeSSOUIManager.getInformationalSignInModalConfig();
             this.snackbar.show(modalOptions);
@@ -1617,6 +1637,7 @@ class VizbeeHomeSSOManager {
         // themed/localized like the informational and progress modals.
         this.vizbeeHomeSSOUIManager.setSuccessSignInModalConfig({ duration: 10000 });
         const modalOptions = this.vizbeeHomeSSOUIManager.getSuccessSignInModalConfig();
+        this.shownModal = 'success';
         this.snackbar.show(modalOptions);
     }
     /**
@@ -1626,6 +1647,7 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     updateFailureUI() {
+        this.shownModal = 'none';
         this.snackbar.hide();
     }
 }
@@ -1696,6 +1718,8 @@ const init = () => {
     }
 };
 const setupHomeSSO = () => {
+    if (!window.vizbee)
+        return;
     window.vizbee.homesso = {
         HomeSSOContext: HomeSSOContext,
         messages: {
@@ -1707,7 +1731,7 @@ const setupHomeSSO = () => {
         // Replaced at build time with package.json's version by
         // @rollup/plugin-replace (same token the metrics manager uses), so
         // integrators can read the loaded SDK version off the namespace.
-        VERSION: '1.0.1',
+        VERSION: '1.0.5',
     };
     window.dispatchEvent(new Event('VIZBEE_HOMESSO_READY'));
 };

package/es6/index.mjs

@@ -400,16 +400,16 @@ class Logger {
 const logger = new Logger();
 
 const LOG_TAG$1 = 'VizbeeHomeSSOManager';
-/* eslint-disable @typescript-eslint/no-explicit-any */
 class VizbeeMetricsManager {
     constructor() {
-        var _a, _b, _c;
+        var _a, _b;
+        this.metricsManager = null;
         this.senderInfo = null;
         this.getSignInInfo = () => __awaiter(this, void 0, void 0, function* () { return []; });
-        if ((_c = (_b = (_a = window === null || window === void 0 ? void 0 : window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.analytics) === null || _c === void 0 ? void 0 : _c.AnalyticsProvider) {
+        const vizbee = window === null || window === void 0 ? void 0 : window.vizbee;
+        if ((_b = (_a = vizbee === null || vizbee === void 0 ? void 0 : vizbee.continuity) === null || _a === void 0 ? void 0 : _a.analytics) === null || _b === void 0 ? void 0 : _b.AnalyticsProvider) {
             this.metricsManager =
-                new window.vizbee.continuity.analytics.AnalyticsProvider();
-            // Create a wrapper with 'provider' property
+                new vizbee.continuity.analytics.AnalyticsProvider();
             const attributesProvider = {
                 getAttributes: () => this.getAttributes(),
             };
@@ -437,7 +437,8 @@ class VizbeeMetricsManager {
         this.metricsManager.logMetrics(event, attributesToBeSent);
     }
     setCustomAttributes(customAttributes) {
-        this.metricsManager.setCustomAttributes(customAttributes);
+        var _a;
+        (_a = this.metricsManager) === null || _a === void 0 ? void 0 : _a.setCustomAttributes(customAttributes);
     }
     getAttributes() {
         return this.createAttributesJson();
@@ -477,7 +478,7 @@ class VizbeeMetricsManager {
         var _a, _b, _c, _d;
         const attributes = {};
         attributes[VizbeeMetricsConstants.METRICS_ATTR_SCREEN_HOMESSO_SDK_VERSION] =
-            '1.0.1';
+            '1.0.5';
         attributes['REMOTE_FRIENDLY_NAME'] = (_a = this.senderInfo) === null || _a === void 0 ? void 0 : _a.friendlyName;
         attributes['REMOTE_DEVICE_ID'] = (_b = this.senderInfo) === null || _b === void 0 ? void 0 : _b.deviceId;
         attributes['REMOTE_DEVICE_TYPE'] = (_c = this.senderInfo) === null || _c === void 0 ? void 0 : _c.deviceType;
@@ -510,6 +511,15 @@ const VizbeeConstants = {
     // SDK events types
     VIZBEE_SESSION_READY: 'vizbee-bicast-session-ready',
 };
+/**
+ * Numeric session states reported by the Continuity SDK's bicast session manager.
+ * Mirrors SessionState in the VTV SDK — defined here so HomeSSO has no magic numbers.
+ */
+const VizbeeSessionState = {
+    NOT_CONNECTED: 1,
+    CONNECTING: 2,
+    CONNECTED: 3,
+};
 // Enum for sign in states
 var VizbeeSignInState;
 (function (VizbeeSignInState) {
@@ -1225,7 +1235,11 @@ class VizbeeSnackbar {
     }
 }
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * @fileoverview Manages Single Sign-On (SSO) functionality for Vizbee home devices.
+ * Handles communication between mobile and TV devices for authentication purposes.
+ * @module VizbeeHomeSSOManager
+ */
 const LOG_TAG = 'VizbeeHomeSSOManager';
 /**
  * Manages Single Sign-On (SSO) functionality between mobile and TV devices in the Vizbee ecosystem.
@@ -1257,8 +1271,14 @@ class VizbeeHomeSSOManager {
         this.isScreenSignedIn = false;
         /** @internal Tracks if sign-in process is currently active */
         this.isSignInInProgress = false;
+        /**
+         * @internal Tracks which modal is currently shown so the same progress modal
+         * is not re-shown (snackbar.show() hides + re-mounts, which would flicker).
+         */
+        this.shownModal = 'none';
         /** @internal Information about the sender device */
         this.senderInfo = null;
+        this.signInHandler = null;
         /**
          * Modal display preferences for the SSO UI
          * @public
@@ -1411,12 +1431,11 @@ class VizbeeHomeSSOManager {
         var _a, _b;
         try {
             logger.info(`[${LOG_TAG}][initializeVizbeeSession] - Initializing Vizbee session`);
-            // Check if vizbee and continuity exist before accessing xmessages
-            if (!((_b = (_a = window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.xmessages)) {
+            const xmessages = (_b = (_a = window.vizbee) === null || _a === void 0 ? void 0 : _a.continuity) === null || _b === void 0 ? void 0 : _b.xmessages;
+            if (!xmessages) {
                 throw new Error('Vizbee continuity or xmessages not initialized');
             }
-            // Access VizbeeBicastSessionManager directly from the existing object
-            const sessionManager = new window.vizbee.continuity.xmessages.VizbeeBicastSessionManager();
+            const sessionManager = new xmessages.VizbeeBicastSessionManager();
             if (!sessionManager) {
                 throw new Error('Session manager initialization failed');
             }
@@ -1425,7 +1444,7 @@ class VizbeeHomeSSOManager {
             sessionManager.addSessionStateListener({
                 onSessionStateChanged: (state) => {
                     logger.info(`[${LOG_TAG}][onSessionStateChanged] - Session state changed:`, state);
-                    if (state === 3) {
+                    if (state === VizbeeSessionState.CONNECTED) {
                         this.vizbeeSession = sessionManager.getSession();
                         this.vizbeeMessagingClient =
                             this.vizbeeSession.getMessagingClient();
@@ -1477,6 +1496,8 @@ class VizbeeHomeSSOManager {
             if (yield this.shouldIgnoreSignInRequest()) {
                 return;
             }
+            this.isSignInInProgress = true;
+            this.updateProgressUI();
             const signInInfo = {
                 isSignedIn: this.isRemoteSignedIn,
                 signInType: signInType,
@@ -1517,9 +1538,9 @@ class VizbeeHomeSSOManager {
                 const attributes = yield ((_b = (_a = this.vizbeeMetricsManager) === null || _a === void 0 ? void 0 : _a.getAttributes) === null || _b === void 0 ? void 0 : _b.call(_a));
                 const signInInfoList = attributes === null || attributes === void 0 ? void 0 : attributes['SCREEN_HOMESSO_USER_INFO'];
                 logger.info(`[${LOG_TAG}][isUserAlreadySignedIn] - signInInfoList`, signInInfoList);
-                const tvSignInInfo = signInInfoList.find((info) => info.user_login_type === signInType);
+                const tvSignInInfo = signInInfoList === null || signInInfoList === void 0 ? void 0 : signInInfoList.find((info) => info.user_login_type === signInType);
                 logger.debug(`[${LOG_TAG}][isUserAlreadySignedIn] - TV sign in status fetched:`, tvSignInInfo);
-                return tvSignInInfo === null || tvSignInInfo === void 0 ? void 0 : tvSignInInfo.user_is_signed_in;
+                return (tvSignInInfo === null || tvSignInInfo === void 0 ? void 0 : tvSignInInfo.user_is_signed_in) === true;
             }
             catch (error) {
                 logger.warn(`[${LOG_TAG}][isUserAlreadySignedIn] - Error checking sign-in status:`, error);
@@ -1559,12 +1580,14 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     sendStatusToSender(status) {
-        const signInStatus = this.serializeStatus(status);
-        const data = {
-            [VizbeeConstants.KEY_SUB_TYPE]: VizbeeConstants.EVENT_SUBTYPE_SIGN_IN_STATUS,
-            [VizbeeConstants.KEY_SIGN_IN_STATUS]: signInStatus,
-        };
-        this.vizbeeMessagingClient.send(data, VizbeeConstants.EVENT_SSO_NAME);
+        return __awaiter(this, void 0, void 0, function* () {
+            const signInStatus = this.serializeStatus(status);
+            const data = {
+                [VizbeeConstants.KEY_SUB_TYPE]: VizbeeConstants.EVENT_SUBTYPE_SIGN_IN_STATUS,
+                [VizbeeConstants.KEY_SIGN_IN_STATUS]: signInStatus,
+            };
+            yield this.vizbeeMessagingClient.send(data, VizbeeConstants.EVENT_SSO_NAME);
+        });
     }
     /**
      * Serializes status objects for transmission to mobile device
@@ -1574,16 +1597,7 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     serializeStatus(status) {
-        if (status instanceof ProgressStatus) {
-            return status.serialize();
-        }
-        else if (status instanceof SuccessStatus) {
-            return status.serialize();
-        }
-        else if (status instanceof FailureStatus) {
-            return status.serialize();
-        }
-        return null;
+        return status.serialize();
     }
     /**
      * Updates UI for sign-in progress state
@@ -1592,6 +1606,12 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     updateProgressUI() {
+        const targetModal = this.isRemoteSignedIn ? 'progress' : 'informational';
+        // Avoid re-showing the same modal
+        if (this.shownModal === targetModal) {
+            return;
+        }
+        this.shownModal = targetModal;
         if (!this.isRemoteSignedIn) {
             const modalOptions = this.vizbeeHomeSSOUIManager.getInformationalSignInModalConfig();
             this.snackbar.show(modalOptions);
@@ -1613,6 +1633,7 @@ class VizbeeHomeSSOManager {
         // themed/localized like the informational and progress modals.
         this.vizbeeHomeSSOUIManager.setSuccessSignInModalConfig({ duration: 10000 });
         const modalOptions = this.vizbeeHomeSSOUIManager.getSuccessSignInModalConfig();
+        this.shownModal = 'success';
         this.snackbar.show(modalOptions);
     }
     /**
@@ -1622,6 +1643,7 @@ class VizbeeHomeSSOManager {
      * @internal
      */
     updateFailureUI() {
+        this.shownModal = 'none';
         this.snackbar.hide();
     }
 }
@@ -1692,6 +1714,8 @@ const init = () => {
     }
 };
 const setupHomeSSO = () => {
+    if (!window.vizbee)
+        return;
     window.vizbee.homesso = {
         HomeSSOContext: HomeSSOContext,
         messages: {
@@ -1703,10 +1727,10 @@ const setupHomeSSO = () => {
         // Replaced at build time with package.json's version by
         // @rollup/plugin-replace (same token the metrics manager uses), so
         // integrators can read the loaded SDK version off the namespace.
-        VERSION: '1.0.1',
+        VERSION: '1.0.5',
     };
     window.dispatchEvent(new Event('VIZBEE_HOMESSO_READY'));
 };
 init();
 
-export { FailureStatus, HomeSSOContext, LogLevel, ProgressStatus, SuccessStatus, UNKNOWN_VALUE, VizbeeHomeSSOManager, VizbeeHomeSSOUIManager };
+export { FailureStatus, HomeSSOContext, LogLevel, ProgressStatus, SignInModalType, SuccessStatus, UNKNOWN_VALUE, VizbeeHomeSSOManager, VizbeeHomeSSOUIManager, VizbeeSignInState };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizbeetv/homesso-sdk-qa",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "TV app authentication library (QA)",
   "main": "./es5/index.cjs",
   "module": "./es5/index.mjs",

package/types/VizbeeHomeSSOManager.d.ts

@@ -1,6 +1,11 @@
+/**
+ * @fileoverview Manages Single Sign-On (SSO) functionality for Vizbee home devices.
+ * Handles communication between mobile and TV devices for authentication purposes.
+ * @module VizbeeHomeSSOManager
+ */
 import { VizbeeSignInInfo } from './model/VizbeeSignInInfo';
 import { FailureStatus, ProgressStatus, SuccessStatus } from './model/VizbeeSignInStatus';
-import { MessagePayload, VizbeeModalPreferences, VizbeeSignInStatusCallback } from './types';
+import { IVizbeeSignInInfo, StatusCallback, VizbeeModalPreferences, VizbeeSignInStatusCallback } from './types';
 /**
  * Manages Single Sign-On (SSO) functionality between mobile and TV devices in the Vizbee ecosystem.
  * Implements singleton pattern for global state management.
@@ -32,6 +37,11 @@ export declare class VizbeeHomeSSOManager implements VizbeeSignInStatusCallback
     private isScreenSignedIn;
     /** @internal Tracks if sign-in process is currently active */
     private isSignInInProgress;
+    /**
+     * @internal Tracks which modal is currently shown so the same progress modal
+     * is not re-shown (snackbar.show() hides + re-mounts, which would flicker).
+     */
+    private shownModal;
     /** @internal UI manager instance for handling SSO-related displays */
     private vizbeeHomeSSOUIManager;
     /** @internal Snackbar instance for showing notifications */
@@ -68,7 +78,7 @@ export declare class VizbeeHomeSSOManager implements VizbeeSignInStatusCallback
      * @param handler - Callback function to process sign-in information and provide status updates
      * @public
      */
-    setSignInHandler(handler: (signInInfo: MessagePayload, statusCallback: (signInStatus: ProgressStatus | SuccessStatus | FailureStatus) => void) => void): void;
+    setSignInHandler(handler: (signInInfo: IVizbeeSignInInfo, statusCallback: StatusCallback) => void): void;
     /**
      * Sets the callback for retrieving sign-in information
      *

package/types/index.d.ts

@@ -1,6 +1,5 @@
 import { VizbeeHomeSSOManager } from './VizbeeHomeSSOManager';
 import { ProgressStatus, SuccessStatus, FailureStatus } from './model/VizbeeSignInStatus';
-import { IVizbeeAnalyticsProvider, IVizbeeXMessages } from './types';
 import { VizbeeHomeSSOUIManager } from './ui/VizbeeHomeSSOUIManager';
 import { LogLevel } from './utils/Logger';
 /**
@@ -30,34 +29,59 @@ declare class HomeSSOContext {
     enableLogger(enable: boolean): void;
     setLoggerLevel(level: LogLevel): void;
 }
+/**
+ * Augmentable global interface for window.vizbee.
+ *
+ * Each Vizbee SDK package re-opens this interface to add only its own slice.
+ * TypeScript merges all augmentations so the full window.vizbee shape is
+ * available to consumers without any one package overriding another's types.
+ *
+ * - HomeSSO SDK adds:     `homesso`
+ * - Continuity SDK adds:  `continuity` (augment this interface in your project)
+ *
+ * Consumer bridging example (add to your project's global.d.ts):
+ * @example
+ * ```ts
+ * import type { ContinuityFramework } from '@vizbee/sdk/lg'; // or xbox, etc.
+ * declare global {
+ *   interface VizbeeNamespace {
+ *     continuity: ContinuityFramework;
+ *   }
+ * }
+ * ```
+ */
 declare global {
+    interface VizbeeNamespace {
+        homesso: HomeSSONamespace;
+    }
     interface Window {
-        vizbee: {
-            continuity?: {
-                xmessages: IVizbeeXMessages;
-                analytics: {
-                    AnalyticsProvider: new () => IVizbeeAnalyticsProvider;
-                };
-            };
-            homesso: {
-                HomeSSOContext: typeof HomeSSOContext;
-                messages: {
-                    ProgressStatus: typeof ProgressStatus;
-                    SuccessStatus: typeof SuccessStatus;
-                    FailureStatus: typeof FailureStatus;
-                };
-                LoggerLevel: typeof LogLevel;
-                VERSION: string;
-            };
-        };
+        vizbee?: VizbeeNamespace;
     }
 }
+/**
+ * The shape HomeSSO SDK adds to window.vizbee.homesso.
+ * Export this so consumers can reference it when augmenting VizbeeSDK or
+ * VizbeeNamespace in their own global declarations.
+ */
+export type HomeSSONamespace = {
+    HomeSSOContext: typeof HomeSSOContext;
+    messages: {
+        ProgressStatus: typeof ProgressStatus;
+        SuccessStatus: typeof SuccessStatus;
+        FailureStatus: typeof FailureStatus;
+    };
+    LoggerLevel: typeof LogLevel;
+    VERSION: string;
+};
 export { HomeSSOContext };
 export { ProgressStatus, SuccessStatus, FailureStatus } from './model/VizbeeSignInStatus';
 export { LogLevel } from './utils/Logger';
+export { VizbeeSignInState } from './utils/constants';
 export { VizbeeHomeSSOManager } from './VizbeeHomeSSOManager';
 export { VizbeeHomeSSOUIManager } from './ui/VizbeeHomeSSOUIManager';
+export { SignInModalType } from './ui/VizbeeHomeSSOUIConfig';
 export { UNKNOWN_VALUE } from './model/VizbeeSignInInfo';
-export type { VizbeeSignInInfo } from './model/VizbeeSignInInfo';
-export type { VizbeeSignInStatusCallback, IVizbeeAnalyticsProvider, IVizbeeXMessages, IVizbeeMessagingClient, IVizbeeSession, IVizbeeBicastSessionManager, ISessionStateListener, MessagePayload, VizbeeSenderDevice, } from './types';
-export type { VizbeeHomeSSOTheme, CommonModalPreferenceOptions, InformationalSignInPreferenceOptions, ProgressSignInPreferenceOptions, SuccessSignInPreferenceOptions, } from './ui/VizbeeHomeSSOUIConfig';
+export type { VizbeeSignInInfo, ISignInInfo } from './model/VizbeeSignInInfo';
+export type { VizbeeSignInStatusCallback, IVizbeeSignInInfo, StatusCallback, IVizbeeAnalyticsProvider, IVizbeeXMessages, IVizbeeMessagingClient, IVizbeeSession, IVizbeeBicastSessionManager, ISessionStateListener, MessagePayload, VizbeeSenderDevice, } from './types';
+export type { SnackbarPosition, ModalDirection } from './ui/VizbeeSnackBar';
+export type { VizbeeHomeSSOTheme, CommonModalPreferenceOptions, InformationalSignInPreferenceOptions, ProgressSignInPreferenceOptions, SuccessSignInPreferenceOptions, VizbeeHomeSSOUIConfig, VizbeeHomeSSODefaultConfig, InformationalSignInPreferenceConfig, ProgressSignInPreferenceConfig, SuccessSignInPreferenceConfig, } from './ui/VizbeeHomeSSOUIConfig';

package/types/metrics/VizbeeMetricsManager.d.ts

@@ -6,9 +6,9 @@ export declare class VizbeeMetricsManager implements IVizbeeAttributesProvider {
     senderInfo: SenderInfo | null;
     getSignInInfo: () => Promise<VizbeeSignInInfo[]>;
     constructor();
-    log(event: string, attributes: Record<string, any>, bypassAttributeProviders?: boolean): void;
-    setCustomAttributes(customAttributes: Record<string, any>): void;
-    getAttributes(): Promise<Record<string, any>>;
+    log(event: string, attributes: Record<string, unknown>, bypassAttributeProviders?: boolean): void;
+    setCustomAttributes(customAttributes: Record<string, unknown>): void;
+    getAttributes(): Promise<Record<string, unknown>>;
     private createAttributesJson;
     private createUserInfoObject;
     private addDefaultAttributes;

package/types/model/VizbeeSenderSignInInfo.d.ts

@@ -15,6 +15,6 @@ export interface SenderInfo {
 export interface VizbeeSenderSignInInfo {
     isSignedIn: boolean;
     signInType: string;
-    customData: Record<string, any>;
+    customData: Record<string, unknown>;
     senderInfo: SenderInfo | null;
 }

package/types/model/VizbeeSignInInfo.d.ts

@@ -1,11 +1,18 @@
 export declare const UNKNOWN_VALUE = "UNKNOWN";
+/**
+ * Sign-in state of the TV app user, returned by the getter registered via
+ * VizbeeHomeSSOManager.setSignInInfoGetter(). The SDK uses this to decide
+ * whether to skip or proceed with a sign-in request from a mobile sender.
+ */
 export interface VizbeeSignInInfo {
     userLoginType: string;
     isSignedIn: boolean;
-    userLogin: string;
+    userLogin?: string;
     userName?: string;
     userSubscriptionType?: string;
     userSubscriptionValue?: string;
     userSubscriptionRenewalType?: string;
-    userAdditionalInfo?: Record<string, any>;
+    userAdditionalInfo?: Record<string, unknown>;
 }
+/** Canonical interface alias — prefer this name in new integrations. */
+export type ISignInInfo = VizbeeSignInInfo;