@monterosa/sdk-identify-kit 2.0.0-rc.3 → 2.0.0-rc.5

package/dist/index.cjs

@@ -2,9 +2,9 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var sdkCore = require('@monterosa/sdk-core');
 var sdkUtil = require('@monterosa/sdk-util');
 var sdkLauncherKit = require('@monterosa/sdk-launcher-kit');
+var sdkCore = require('@monterosa/sdk-core');
 var sdkConnectKit = require('@monterosa/sdk-connect-kit');
 var sdkInteractInterop = require('@monterosa/sdk-interact-interop');
 
@@ -24,10 +24,8 @@ var IdentifyEvent;
     IdentifyEvent["StateUpdated"] = "state_updated";
     IdentifyEvent["LoginRequested"] = "login_requested";
     IdentifyEvent["LogoutRequested"] = "logout_requested";
-    IdentifyEvent["SignatureUpdated"] = "signature_updated";
-    IdentifyEvent["UserdataUpdated"] = "userdata_updated";
     IdentifyEvent["CredentialsUpdated"] = "credentials_updated";
-    IdentifyEvent["EnmasseLogin"] = "enmasse_login";
+    IdentifyEvent["LoginPolicyUpdated"] = "login_policy_updated";
 })(IdentifyEvent || (IdentifyEvent = {}));
 /**
  * Defines a set of error codes that may be encountered when using the
@@ -40,8 +38,6 @@ var IdentifyEvent;
  * } catch (err) {
  *   if (err.code === IdentifyError.NoCredentials) {
  *     // handle missing credentials error
- *   } else if (err.code === IdentifyError.NotInitialised) {
- *     // handle initialization error
  *   } else {
  *     // handle other error types
  *   }
@@ -71,10 +67,6 @@ exports.IdentifyError = void 0;
      * or have expired.
      */
     IdentifyError["NoCredentials"] = "no_credentials";
-    /**
-     * Indicates the IdentifyKit has not been initialised properly.
-     */
-    IdentifyError["NotInitialised"] = "not_initialised";
     /**
      * Indicates an error occurred in the parent app.
      */
@@ -99,7 +91,6 @@ const IdentifyErrorMessages = {
     [exports.IdentifyError.ExtensionApiError]: (error) => `Identify extension API returned an error: ${error}`,
     [exports.IdentifyError.ExtensionNotSetup]: () => 'Identify extension is not set up for this project',
     [exports.IdentifyError.NoCredentials]: () => 'Identify credentials are not set',
-    [exports.IdentifyError.NotInitialised]: () => 'Identify instance is not initialised',
     [exports.IdentifyError.ParentAppError]: (error) => `Parent application error: ${error}`,
     [exports.IdentifyError.UnexpectedState]: (state) => `Unexpected LoginState: ${state}`,
     [exports.IdentifyError.NoParentApplication]: () => 'No parent application available for delegation',
@@ -111,14 +102,9 @@ var IdentifyAction;
     IdentifyAction["Logout"] = "identifyLogout";
     IdentifyAction["RequestLogin"] = "identifyRequestLogin";
     IdentifyAction["RequestLogout"] = "identifyRequestLogout";
-    IdentifyAction["GetUserData"] = "identifyGetUserData";
-    IdentifyAction["GetSessionSignature"] = "identifyGetSessionSignature";
+    IdentifyAction["GetCredentials"] = "identifyGetCredentials";
     IdentifyAction["SetCredentials"] = "identifySetCredentials";
     IdentifyAction["ClearCredentials"] = "identifyClearCredentials";
-    IdentifyAction["OnStateUpdated"] = "identifyOnStateUpdated";
-    IdentifyAction["OnCredentialsUpdated"] = "identifyOnCredentialsUpdated";
-    IdentifyAction["OnUserDataUpdated"] = "identifyOnUserDataUpdated";
-    IdentifyAction["OnSessionSignatureUpdated"] = "identifyOnSessionSignatureUpdated";
 })(IdentifyAction || (IdentifyAction = {}));
 
 /**
@@ -145,13 +131,12 @@ class Identify extends sdkUtil.Emitter {
         super();
         this.sdk = sdk;
         this.wasLoggedIn = false;
-        this._credentials = null;
         this._signature = null;
         this._userData = null;
         this._state = {
             state: 'logged_out',
         };
-        this._options = Object.assign({ strategy: 'email', deviceId: sdkCore.getDeviceId(), version: 1, loginPolicy: 'disabled' }, options);
+        this._options = Object.assign({ strategy: 'email', version: 1 }, options);
     }
     static async fetchIdentifyHost(host, projectId) {
         var _a, _b;
@@ -174,12 +159,13 @@ class Identify extends sdkUtil.Emitter {
             case 'logged_in':
                 this.wasLoggedIn = true;
                 break;
-            case 'logged_out':
             case 'error':
                 this.wasLoggedIn = false;
                 break;
+            case 'logged_out':
             case 'pending':
-                // preserve wasLoggedIn value during transitional state
+                // preserve wasLoggedIn — these states reflect transient transport
+                // state, not a deliberate logout (credentials are the gate for that)
                 break;
             default: {
                 // Exhaustiveness check: TypeScript errors if a new state is added
@@ -207,53 +193,29 @@ class Identify extends sdkUtil.Emitter {
                 this.signature = null;
             }, SIGNATURE_TTL);
         }
-        this.emit(IdentifyEvent.SignatureUpdated, this.signature);
     }
     get signature() {
         return this._signature;
     }
-    set credentials(credentials) {
-        if (this._credentials === credentials) {
-            return;
-        }
-        this._credentials = credentials;
-        this.emit(IdentifyEvent.CredentialsUpdated, credentials);
-    }
-    get credentials() {
-        return this._credentials;
-    }
     set userData(data) {
         if (this._userData === data) {
             return;
         }
         this._userData = data;
-        clearTimeout(this.userDataExpireTimeout);
-        this.emit(IdentifyEvent.UserdataUpdated, data);
     }
     get userData() {
         return this._userData;
     }
-    get shouldLoginOnReconnect() {
-        return (this.wasLoggedIn &&
-            this.options.loginPolicy === 'auto' &&
-            this.credentials !== null);
-    }
-    reset() {
-        this.credentials = null;
-        this.userData = null;
-        this.signature = null;
-        this.wasLoggedIn = false;
-    }
     async getUrl(path = '') {
-        const { options: { host, projectId }, } = this.sdk;
+        const { host, projectId } = this.sdk.options;
         if (this.host === undefined) {
             this.host = await Identify.fetchIdentifyHost(host, projectId);
         }
         const url = new URL(this.host);
-        const { version, deviceId, strategy, provider } = this._options;
+        const { version, strategy, provider } = this._options;
         url.pathname = `/v${version}${path}`;
         url.searchParams.set('projectId', projectId);
-        url.searchParams.set('deviceId', deviceId);
+        url.searchParams.set('deviceId', sdkCore.getDeviceId());
         url.searchParams.set('strategy', strategy);
         if (provider !== undefined) {
             url.searchParams.set('provider', provider);
@@ -288,6 +250,101 @@ function deleteExperience(experience) {
     }
 }
 
+/**
+ * @license
+ * @monterosa/sdk-identify-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Locally-owned login policy.
+ *
+ * Defaults to `'disabled'`. Set via the public `setLoginPolicy`. Never
+ * propagated across the wire — each level owns its own policy.
+ *
+ * @internal
+ */
+class LoginPolicyStore extends sdkUtil.Emitter {
+    constructor() {
+        super();
+        this._policy = 'disabled';
+    }
+    static getInstance() {
+        if (!LoginPolicyStore.instance) {
+            LoginPolicyStore.instance = new LoginPolicyStore();
+        }
+        return LoginPolicyStore.instance;
+    }
+    get policy() {
+        return this._policy;
+    }
+    set policy(next) {
+        if (this._policy === next) {
+            return;
+        }
+        this._policy = next;
+        this.emit(IdentifyEvent.LoginPolicyUpdated, next);
+    }
+    subscribe(handler) {
+        return sdkUtil.subscribe(this, IdentifyEvent.LoginPolicyUpdated, handler);
+    }
+    reset() {
+        this._policy = 'disabled';
+        this.off(IdentifyEvent.LoginPolicyUpdated);
+    }
+}
+
+/**
+ * @license
+ * @monterosa/sdk-identify-kit
+ *
+ * Copyright © 2026 Monterosa Productions Limited. All rights reserved.
+ *
+ * More details on the license can be found at https://www.monterosa.co/sdk/license
+ */
+/**
+ * Root-owned credentials store.
+ *
+ * Single source of truth at the root of an integration; an internal
+ * mirror at every other level, kept in sync via `Login` / `Logout`
+ * broadcasts. Not exposed publicly — public access flows through
+ * `setCredentials` / `getCredentials` / `clearCredentials` and
+ * `onCredentialsUpdated`.
+ *
+ * @internal
+ */
+class CredentialsStore extends sdkUtil.Emitter {
+    constructor() {
+        super();
+        this._credentials = null;
+    }
+    static getInstance() {
+        if (!CredentialsStore.instance) {
+            CredentialsStore.instance = new CredentialsStore();
+        }
+        return CredentialsStore.instance;
+    }
+    get credentials() {
+        return this._credentials;
+    }
+    set credentials(next) {
+        if (this._credentials === next) {
+            return;
+        }
+        this._credentials = next;
+        this.emit(IdentifyEvent.CredentialsUpdated, next);
+    }
+    subscribe(handler) {
+        return sdkUtil.subscribe(this, IdentifyEvent.CredentialsUpdated, handler);
+    }
+    reset() {
+        this._credentials = null;
+        this.off(IdentifyEvent.CredentialsUpdated);
+    }
+}
+
 /**
  * @license
  * identify-kit
@@ -296,8 +353,78 @@ function deleteExperience(experience) {
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
+const loginPolicyStore = LoginPolicyStore.getInstance();
+const credentialsStore = CredentialsStore.getInstance();
+/**
+ * @internal
+ */
 const identifyKits = new Map();
-const identifyHooks = [];
+/**
+ * Emitter for identify request events that are not tied to a specific
+ * identify instance (login / logout requests).
+ *
+ * @internal
+ */
+const requestsEmitter = new sdkUtil.Emitter();
+/**
+ * Read the current locally-owned login policy.
+ *
+ * Returns `'disabled'` by default.
+ *
+ * @internal
+ */
+function getLoginPolicy() {
+    return loginPolicyStore.policy;
+}
+/**
+ * Set the login policy.
+ *
+ * - `'auto'`: the SDK automatically logs the user in whenever
+ *   credentials are available.
+ * - `'disabled'`: credentials are tracked but no automatic login is
+ *   attempted.
+ *
+ * Each level of a multi-level integration owns its own policy; the
+ * value is never propagated to embedded experiences. Idempotent:
+ * setting the same policy is a no-op.
+ *
+ * @param policy - `'auto'` or `'disabled'`.
+ */
+function setLoginPolicy(policy) {
+    if (loginPolicyStore.policy === policy) {
+        return;
+    }
+    loginPolicyStore.policy = policy;
+    if (policy !== 'auto') {
+        return;
+    }
+    // On transition to 'auto': if credentials are currently set (typical
+    // after the non-root module-load pull, or after a setCredentials at
+    // the root, or after an upstream Login broadcast has cascaded down),
+    // enqueue a login task for each existing identify. If no credentials
+    // are set, do nothing — a future credentials arrival via `applyLogin`
+    // will trigger the login under this new policy.
+    const { credentials } = credentialsStore;
+    if (credentials === null) {
+        return;
+    }
+    for (const identify of identifyKits.values()) {
+        enqueueLogin(identify, credentials);
+    }
+}
+/**
+ * Whether the user should be auto-logged in on reconnect.
+ *
+ * True when the user was previously logged in, the policy is `'auto'`,
+ * and credentials are available on the identify instance.
+ *
+ * @internal
+ */
+function shouldLoginOnReconnect(identify) {
+    return (identify.wasLoggedIn &&
+        getLoginPolicy() === 'auto' &&
+        credentialsStore.credentials !== null);
+}
 /**
  * @internal
  */
@@ -334,17 +461,13 @@ async function api(url, token, method = 'GET') {
 /**
  * @internal
  */
-async function parentAppRequest(identify, action, payload) {
-    var _a;
+async function sendParentRequest(action, payload) {
     const parentApp = sdkLauncherKit.getParentApplication();
     if (parentApp === null) {
         throw sdkUtil.createError(exports.IdentifyError.NoParentApplication, IdentifyErrorMessages);
     }
-    const { host, projectId } = identify.sdk.options;
-    // Preserve existing origin (relay) or set from current context (source)
-    const origin = (_a = payload === null || payload === void 0 ? void 0 : payload.origin) !== null && _a !== void 0 ? _a : { host, projectId };
     try {
-        const response = await sdkLauncherKit.sendSdkRequest(parentApp, action, Object.assign(Object.assign({}, payload), { origin }));
+        const response = await sdkLauncherKit.sendSdkRequest(parentApp, action, payload);
         const { error, data } = response.payload;
         if (error !== undefined) {
             throw sdkUtil.createError(exports.IdentifyError.ParentAppError, IdentifyErrorMessages, error);
@@ -360,12 +483,6 @@ async function parentAppRequest(identify, action, payload) {
         throw err;
     }
 }
-/**
- * @internal
- */
-function registerIdentifyHook(hook) {
-    identifyHooks.push(hook);
-}
 /**
  * @internal
  */
@@ -389,6 +506,9 @@ const logoutWithRetry = sdkUtil.withRetryAsync(logout);
  * @internal
  */
 async function loginTask(identify, credentials) {
+    if (identify.state.state === 'logged_in') {
+        return;
+    }
     try {
         identify.state = {
             state: 'pending',
@@ -402,6 +522,11 @@ async function loginTask(identify, credentials) {
         }
     }
     catch (err) {
+        // Abandon any pending login/logout/sync tasks on failure — letting
+        // them run after an error would put the user in an inconsistent
+        // state. Note: this also drops tasks for unrelated identifies that
+        // share the queue; acceptable because the typical runtime has one
+        // identify per project.
         taskQueue.clear();
         identify.state = {
             state: 'error',
@@ -414,6 +539,9 @@ async function loginTask(identify, credentials) {
  * @internal
  */
 async function logoutTask(identify) {
+    if (identify.state.state === 'logged_out') {
+        return;
+    }
     try {
         identify.state = {
             state: 'pending',
@@ -427,6 +555,8 @@ async function logoutTask(identify) {
         }
     }
     catch (err) {
+        // Abandon any pending login/logout/sync tasks on failure — see
+        // `loginTask` for the rationale.
         taskQueue.clear();
         identify.state = {
             state: 'error',
@@ -436,15 +566,55 @@ async function logoutTask(identify) {
     }
 }
 /**
+ * Enqueue a `loginTask` for the given identify when `policy === 'auto'`.
+ * The downstream `Login` broadcast is emitted by {@link applyLogin}.
+ *
  * @internal
  */
 function enqueueLogin(identify, credentials, prioritise = false) {
-    if (identify.options.loginPolicy === 'auto') {
-        if (prioritise) {
-            taskQueue.enqueueFront(() => loginTask(identify, credentials));
-        }
-        else {
-            taskQueue.enqueue(() => loginTask(identify, credentials));
+    if (getLoginPolicy() !== 'auto') {
+        return;
+    }
+    if (prioritise) {
+        taskQueue.enqueueFront(() => loginTask(identify, credentials));
+    }
+    else {
+        taskQueue.enqueue(() => loginTask(identify, credentials));
+    }
+}
+/**
+ * Reset the identify's identity-derived caches and enqueue a `logoutTask`
+ * when `policy === 'auto'`.
+ *
+ * @internal
+ */
+function enqueueLogout(identify) {
+    identify.userData = null;
+    identify.signature = null;
+    if (getLoginPolicy() !== 'auto') {
+        return;
+    }
+    taskQueue.enqueue(() => logoutTask(identify));
+}
+/**
+ * Apply new credentials at this level: update the current credentials,
+ * enqueue a `loginTask` for every existing identify on the null-to-set
+ * transition, and broadcast `Login` downstream to every embedded
+ * experience.
+ *
+ * Idempotent on token refresh: re-setting when credentials are already
+ * present updates the value and broadcasts, but does not re-enqueue
+ * logins (their `loginTask` would short-circuit on
+ * `state === 'logged_in'` anyway).
+ *
+ * @internal
+ */
+function applyLogin(credentials) {
+    const shouldLogin = credentialsStore.credentials === null;
+    credentialsStore.credentials = credentials;
+    if (shouldLogin) {
+        for (const identify of identifyKits.values()) {
+            enqueueLogin(identify, credentials);
         }
     }
     for (const experience of getExperiences()) {
@@ -452,14 +622,50 @@ function enqueueLogin(identify, credentials, prioritise = false) {
     }
 }
 /**
+ * Clear credentials at this level: clear the current credentials,
+ * enqueue a `logoutTask` for every existing identify on the
+ * set-to-null transition, and broadcast `Logout` downstream to every
+ * embedded experience.
+ *
  * @internal
  */
-function enqueueLogout(identify) {
-    if (identify.options.loginPolicy === 'auto') {
-        taskQueue.enqueue(() => logoutTask(identify));
+function applyLogout() {
+    const shouldLogout = credentialsStore.credentials !== null;
+    credentialsStore.credentials = null;
+    if (shouldLogout) {
+        for (const identify of identifyKits.values()) {
+            enqueueLogout(identify);
+        }
     }
     for (const experience of getExperiences()) {
-        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.Logout);
+        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.Logout, {});
+    }
+}
+/**
+ * Pull state from the parent application and apply locally.
+ *
+ * Fires once at non-root bridge module load, regardless of
+ * `loginPolicy` — token presence is the customer-side sign-in state and
+ * must mirror upstream whether or not we choose to validate against
+ * Enmasse. Best-effort: a missing or non-identify-kit parent silently
+ * resolves with no change to the current credentials.
+ *
+ * Uses {@link applyLogin} so the update cascades downstream to this
+ * level's own embedded experiences and per-identify loginTasks are
+ * enqueued under `loginPolicy === 'auto'`.
+ *
+ * @internal
+ */
+async function pullStateFromParent() {
+    let credentials;
+    try {
+        credentials = await getCredentials();
+    }
+    catch (_a) {
+        return;
+    }
+    if (credentials !== null) {
+        applyLogin(credentials);
     }
 }
 function getIdentify(sdkOrOptions, options) {
@@ -491,94 +697,92 @@ function getIdentify(sdkOrOptions, options) {
         sdk = sdkCore.getSdk();
         identifyOptions = {};
     }
-    const { options: { projectId }, } = sdk;
+    const { projectId } = sdk.options;
     if (identifyKits.has(projectId)) {
         return identifyKits.get(projectId);
     }
     const identify = new Identify(sdk, identifyOptions);
-    for (const hook of identifyHooks) {
-        hook(identify);
-    }
     watchConnectionStatus(identify);
     identifyKits.set(projectId, identify);
     return identify;
 }
 /**
- * A function that requests a user login via the `IdentifyKit` of the Monterosa SDK.
+ * Request a user login.
+ *
+ * When called from an embedded experience, the request is relayed to
+ * the parent application — the host that owns the auth UI handles it.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, requestLogin } from '@monterosa/sdk-identify-kit';
+ * import { requestLogin } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
  * try {
- *   const identify = getIdentify();
- *
- *   await requestLogin(identify);
- *
+ *   await requestLogin();
  *   console.log('Login request successful');
  * } catch (err) {
- *   console.error('Error requesting login:', error.message)
+ *   console.error('Error requesting login:', err.message)
  * }
  * ```
  *
- * @remarks
- * - If the app is running within a third-party application that uses
- *   the Monterosa SDK, the function delegates to the parent app
- *   to handle the login process.
- *
- * @param identify - An instance of the `IdentifyKit` class used for user
- *   identification.
- * @returns A Promise that resolves with `void` when the login request
- *   is completed.
+ * @returns A Promise that resolves once the login request has been
+ *   delivered.
  */
-async function requestLogin(identify) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        await parentAppRequest(identify, IdentifyAction.RequestLogin);
+async function requestLogin() {
+    if (sdkLauncherKit.getParentApplication() !== null) {
+        await sendParentRequest(IdentifyAction.RequestLogin);
         return;
     }
-    identify.emit(IdentifyEvent.LoginRequested);
+    requestsEmitter.emit(IdentifyEvent.LoginRequested);
 }
 /**
- * A function that requests a user login via the `IdentifyKit` of the Space.
+ * Read the current credentials.
+ *
+ * When called from an embedded experience, fetches the credentials
+ * from the parent application so the caller always sees the
+ * authoritative value.
+ *
+ * @returns A Promise that resolves to the current credentials, or
+ *   `null` if none are set.
+ */
+async function getCredentials() {
+    if (sdkLauncherKit.getParentApplication() === null) {
+        return credentialsStore.credentials;
+    }
+    return sendParentRequest(IdentifyAction.GetCredentials);
+}
+/**
+ * Request a user logout.
+ *
+ * When called from an embedded experience, the request is relayed to
+ * the parent application — the host that owns the auth UI handles it.
  *
  * @example
  * ```javascript
- * import { getSpace } from '@monterosa/sdk-core';
- * import { getIdentify, requestLogout } from '@monterosa/sdk-identify-kit';
+ * import { configure } from '@monterosa/sdk-core';
+ * import { requestLogout } from '@monterosa/sdk-identify-kit';
  *
- * const space = getSpace('host', 'space-id');
- * const identify = getIdentify(space);
+ * configure({ host: '...', projectId: '...' });
  *
  * try {
- *   await requestLogout(identify);
- *
+ *   await requestLogout();
  *   console.log('Logout request successful');
  * } catch (err) {
- *   console.error('Error requesting logout:', error.message)
+ *   console.error('Error requesting logout:', err.message)
  * }
  * ```
  *
- * @remarks
- * - If the app is running within a third-party application that uses
- *   the Space, the function delegates to the parent app
- *   to handle the logout process.
- *
- * @param identify - An instance of the `IdentifyKit` class used for user
- *   identification.
- * @returns A Promise that resolves with `void` when the logout request
- *   is completed.
+ * @returns A Promise that resolves once the logout request has been
+ *   delivered.
  */
-async function requestLogout(identify) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        await parentAppRequest(identify, IdentifyAction.RequestLogout);
+async function requestLogout() {
+    if (sdkLauncherKit.getParentApplication() !== null) {
+        await sendParentRequest(IdentifyAction.RequestLogout);
         return;
     }
-    identify.emit(IdentifyEvent.LogoutRequested);
+    requestsEmitter.emit(IdentifyEvent.LogoutRequested);
 }
 /**
  * @internal
@@ -597,11 +801,6 @@ async function requestLogout(identify) {
  * @returns A Promise that resolves to a `Signature` object.
  */
 async function getSessionSignature(identify, credentials) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        const signature = await parentAppRequest(identify, IdentifyAction.GetSessionSignature, credentials);
-        return signature;
-    }
     if (identify.signature !== null) {
         return identify.signature;
     }
@@ -612,148 +811,118 @@ async function getSessionSignature(identify, credentials) {
     return signature;
 }
 /**
- * A memoized version of the `getSessionSignature` function.
+ * @internal
+ *
+ * A memoized version of the `getSessionSignature` function. Memo key is
+ * the credentials token, so both leaf-side and bridge-side callers share
+ * the same cache for the same token.
  */
 const getSessionSignatureMemoized = sdkUtil.memoizePromise(getSessionSignature, (identify, credentials) => credentials.token, {
     clearOnResolve: true,
     clearOnReject: true,
 });
 /**
- * The function that takes an instance of `IdentifyKit` as its argument and
- * returns a Promise that resolves to a key-value object representing user data.
+ * Fetch user data for the given credentials.
+ *
+ * Credentials are required explicitly. Obtain a value via
+ * {@link getCredentials} or the {@link onCredentialsUpdated} callback.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, getUserData } from '@monterosa/sdk-identify-kit';
+ * import {
+ *   getIdentify,
+ *   getUserData,
+ *   getCredentials,
+ * } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
  * const identify = getIdentify();
- * const userData = await getUserData(identify);
+ * const credentials = await getCredentials();
  *
- * console.log('User data:', userData);
+ * if (credentials !== null) {
+ *   const userData = await getUserData(identify, credentials);
+ *   console.log('User data:', userData);
+ * }
  * ```
  *
  * @remarks
- * - If the app is running within a third-party application that uses
- *   the Monterosa SDK, the function delegates to the parent app
- *   to get user data.
- *
- * - If the request is successful, the function resolves with a key-value object
- *   representing user data. If not, a `MonterosaError` is thrown.
- *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @returns A Promise that resolves to a key-value object representing user data.
- *   The structure and content of the user data object depend on the identify
- *   service provider and may vary. It typically contains information about the user,
- *   but the specific fields are determined by the Identify service provider.
+ * Cached after the first successful fetch and reset when credentials
+ * are cleared.
+ *
+ * @param identify - The IdentifyKit instance.
+ * @param credentials - The user's authentication credentials.
+ * @returns A Promise that resolves to a key-value object of user data.
+ *   The structure depends on the identify service provider.
  */
-async function getUserData(identify) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        const userData = await parentAppRequest(identify, IdentifyAction.GetUserData);
-        return userData;
-    }
-    // Return cached user data if available
+async function getUserData(identify, credentials) {
     if (identify.userData !== null) {
         return identify.userData;
     }
-    if (identify.credentials === null) {
-        throw sdkUtil.createError(exports.IdentifyError.NoCredentials, IdentifyErrorMessages);
-    }
     const url = await identify.getUrl('/user');
-    const { data } = await api(url, identify.credentials.token);
+    const { data } = await api(url, credentials.token);
     identify.userData = data;
     return data;
 }
 /**
- * Sets the user's authentication credentials.
+ * Set the user's authentication credentials.
+ *
+ * The credentials become the active credentials for the entire
+ * integration. When called from an embedded experience, the call is
+ * relayed to the parent application so that every level of the
+ * integration sees the new value.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, setCredentials } from '@monterosa/sdk-identify-kit';
+ * import { setCredentials } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
- * const credentials = { token: 'abc123' };
- * const identify = getIdentify();
- *
- * await setCredentials(identify, credentials)
+ * await setCredentials({ token: 'abc123' });
  * ```
  *
- * @remarks
- * - If the app is running within a third-party application that uses
- *   the Monterosa SDK, the function delegates to the parent app
- *   to set user credentials.
- *
- * - If the request is successful, the function resolves to `void`.
- *   If not, a `MonterosaError` is thrown.
- *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param credentials - An object representing the user's authentication
- *   credentials.
- * @returns A Promise that resolves to `void`.
+ * @param credentials - The user's authentication credentials.
+ * @returns A Promise that resolves once the credentials have been
+ *   applied.
  */
-async function setCredentials(identify, credentials) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        await parentAppRequest(identify, IdentifyAction.SetCredentials, credentials);
+async function setCredentials(credentials) {
+    if (sdkLauncherKit.getParentApplication() !== null) {
+        await sendParentRequest(IdentifyAction.SetCredentials, credentials);
         return;
     }
-    const shouldLogin = identify.credentials === null;
-    identify.credentials = credentials;
-    if (shouldLogin) {
-        enqueueLogin(identify, credentials);
-    }
+    applyLogin(credentials);
 }
 /**
- * Clears the user's authentication credentials.
+ * Clear the user's authentication credentials.
+ *
+ * When called from an embedded experience, the call is relayed to the
+ * parent application so that every level of the integration is
+ * cleared.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, clearCredentials } from '@monterosa/sdk-identify-kit';
+ * import { clearCredentials } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
- * const identify = getIdentify();
- *
- * await clearCredentials(identify);
+ * await clearCredentials();
  * ```
  *
- * @remarks
- * - If the app is running within a third-party application that uses
- *   the Monterosa SDK, the function delegates to the parent app
- *   to clear user credentials.
- *
- * - If the request is successful, the function resolves to `void`.
- *   If not, a `MonterosaError` is thrown.
- *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @returns A Promise that resolves to `void`.
+ * @returns A Promise that resolves once the credentials have been
+ *   cleared.
  */
-async function clearCredentials(identify) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp !== null) {
-        await parentAppRequest(identify, IdentifyAction.ClearCredentials);
+async function clearCredentials() {
+    if (sdkLauncherKit.getParentApplication() !== null) {
+        await sendParentRequest(IdentifyAction.ClearCredentials);
         return;
     }
-    const shouldLogout = identify.credentials !== null;
-    identify.credentials = null;
-    identify.userData = null;
-    identify.signature = null;
-    if (shouldLogout) {
-        enqueueLogout(identify);
-    }
+    applyLogout();
 }
 /**
- * Registers a callback function that will be called whenever the `LoginState`
- * object associated with the `IdentifyKit` instance is updated.
+ * Register a callback for `LoginState` updates on the given identify.
  *
  * @example
  * ```javascript
@@ -767,203 +936,97 @@ async function clearCredentials(identify) {
  * const unsubscribe = onStateUpdated(identify, (state) => {
  *   console.log("State updated:", state);
  * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
  * ```
  *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will be
- *   called with the updated `LoginState` object as its only argument.
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
+ * @param identify - The IdentifyKit instance.
+ * @param callback - Called with the updated `LoginState`.
+ * @returns An `Unsubscribe` function.
  */
 function onStateUpdated(identify, callback) {
     return sdkUtil.subscribe(identify, IdentifyEvent.StateUpdated, callback);
 }
 /**
- * Registers a callback function that will be called whenever the `Credentials`
- * object associated with the `IdentifyKit` instance is updated.
+ * Register a callback for updates to the current credentials.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, onCredentialsUpdated } from '@monterosa/sdk-identify-kit';
+ * import { onCredentialsUpdated } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
- * const identify = getIdentify();
- *
- * const unsubscribe = onCredentialsUpdated(identify, (credentials) => {
+ * const unsubscribe = onCredentialsUpdated((credentials) => {
  *   if (credentials !== null) {
  *     console.log("Credentials updated:", credentials);
  *   } else {
  *     console.log("Credentials cleared.");
  *   }
  * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
  * ```
  *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will be
- *   called with the updated `Credentials` object as its only argument.
- *   If the value `null` is received, it indicates that the signature has
- *   been cleared
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
+ * @param callback - Called with the updated `Credentials`, or `null`
+ *   when credentials are cleared.
+ * @returns An `Unsubscribe` function.
  */
-function onCredentialsUpdated(identify, callback) {
-    return sdkUtil.subscribe(identify, IdentifyEvent.CredentialsUpdated, callback);
+function onCredentialsUpdated(callback) {
+    return credentialsStore.subscribe(callback);
 }
 /**
- * Registers a callback function that will be called whenever the `Signature`
- * object associated with the `IdentifyKit` instance is updated.
+ * Register a callback for login requests.
  *
- * @example
- * ```javascript
- * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, onSignatureUpdated } from '@monterosa/sdk-identify-kit';
- *
- * configure({ host: '...', projectId: '...' });
- *
- * const identify = getIdentify();
- *
- * const unsubscribe = onSignatureUpdated(identify, (signature) => {
- *   if (signature !== null) {
- *     console.log("Signature updated:", signature);
- *   } else {
- *     console.log("Signature cleared.");
- *   }
- * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
- * ```
- *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will be
- *   called with the updated `Signature` object as its only argument.
- *   If the value `null` is received, it indicates that the signature has
- *   been cleared
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
- */
-function onSignatureUpdated(identify, callback) {
-    return sdkUtil.subscribe(identify, IdentifyEvent.SignatureUpdated, callback);
-}
-/**
- * Registers a callback function that will be called whenever the `UserData`
- * object associated with the `IdentifyKit` instance is updated.
+ * Fires when {@link requestLogin} is called at this level — whether by
+ * local code or relayed up from an embedded experience.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, onUserDataUpdated } from '@monterosa/sdk-identify-kit';
+ * import { onLoginRequestedByExperience } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
- * const identify = getIdentify();
- *
- * const unsubscribe = onUserDataUpdated(identify, (userData) => {
- *   if (userData !== null) {
- *     console.log("User's data updated:", userData);
- *   } else {
- *     console.log("User's data cleared.");
- *   }
+ * const unsubscribe = onLoginRequestedByExperience(() => {
+ *   showLoginForm();
  * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
  * ```
  *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will be
- *   called with the updated `UserData` object as its only argument.
- *   If the value `null` is received, it indicates that the user's data has
- *   been cleared
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
+ * @param callback - Called when a login is requested.
+ * @returns An `Unsubscribe` function.
  */
-function onUserDataUpdated(identify, callback) {
-    return sdkUtil.subscribe(identify, IdentifyEvent.UserdataUpdated, callback);
+function onLoginRequestedByExperience(callback) {
+    return sdkUtil.subscribe(requestsEmitter, IdentifyEvent.LoginRequested, callback);
 }
 /**
- * Registers a callback function that will be called when a login is requested
- * by an Experience.
+ * Register a callback for logout requests.
+ *
+ * Fires when {@link requestLogout} is called at this level — whether
+ * by local code or relayed up from an embedded experience.
  *
  * @example
  * ```javascript
  * import { configure } from '@monterosa/sdk-core';
- * import { getIdentify, onLoginRequestedByExperience } from '@monterosa/sdk-identify-kit';
+ * import { onLogoutRequestedByExperience } from '@monterosa/sdk-identify-kit';
  *
  * configure({ host: '...', projectId: '...' });
  *
- * const identify = getIdentify();
- *
- * const unsubscribe = onLoginRequestedByExperience(identify, () => {
- *   showLoginForm();
- * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
- * ```
- *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will
- *   be called when a login is requested by an Experience.
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
- */
-function onLoginRequestedByExperience(identify, callback) {
-    return sdkUtil.subscribe(identify, IdentifyEvent.LoginRequested, callback);
-}
-/**
- * Registers a callback function that will be called when a logout is requested
- * by an Experience.
- *
- * @example
- * ```javascript
- * import { getSpace } from '@monterosa/sdk-core';
- * import { getIdentify, onLogoutRequestedByExperience } from '@monterosa/sdk-identify-kit';
- *
- * const space = getSpace('host', 'space-id');
- * const identify = getIdentify(space);
- *
- * const unsubscribe = onLogoutRequestedByExperience(identify, () => {
- *   // logout requested by experience
- *   // perform logout from Auth service
+ * const unsubscribe = onLogoutRequestedByExperience(() => {
+ *   // perform logout from auth service
  * });
- *
- * // Call unsubscribe() to unregister the callback function
- * // unsubscribe();
  * ```
  *
- * @param identify - An instance of `IdentifyKit` that provides the user
- *   identification functionality.
- * @param callback - The callback function to register. This function will
- *   be called when a logout is requested by an Experience.
- * @returns An `Unsubscribe` function that can be called to unregister
- *   the callback function.
+ * @param callback - Called when a logout is requested.
+ * @returns An `Unsubscribe` function.
  */
-function onLogoutRequestedByExperience(identify, callback) {
-    return sdkUtil.subscribe(identify, IdentifyEvent.LogoutRequested, callback);
+function onLogoutRequestedByExperience(callback) {
+    return sdkUtil.subscribe(requestsEmitter, IdentifyEvent.LogoutRequested, callback);
 }
 /**
- *
  * @internal
  */
 async function watchConnectionStatus(identify) {
     const conn = await sdkConnectKit.getConnect(identify.sdk.options.host);
     sdkConnectKit.onConnected(conn, () => {
-        if (identify.shouldLoginOnReconnect) {
-            enqueueLogin(identify, identify.credentials, true);
+        if (shouldLoginOnReconnect(identify)) {
+            enqueueLogin(identify, credentialsStore.credentials, true);
         }
         taskQueue.resume();
     });
@@ -1000,115 +1063,59 @@ async function watchConnectionStatus(identify) {
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
 /**
+ * Process an incoming `Login` / `Logout` broadcast from the parent
+ * application. Updates the local current credentials, enqueues login/logout
+ * for every existing identify, and forwards the broadcast downstream to
+ * this level's own embedded experiences — the mechanism that cascades a
+ * root-level `setCredentials` through every nested experience.
+ *
  * @internal
  */
-function parentMessagesHook(identify) {
-    const parentApp = sdkLauncherKit.getParentApplication();
-    if (parentApp === null) {
-        return () => { };
-    }
-    return sdkLauncherKit.onSdkMessage(parentApp, async (message) => {
-        switch (message.action) {
-            case IdentifyAction.OnCredentialsUpdated: {
-                identify.credentials = message.payload.data;
-                break;
-            }
-            case IdentifyAction.OnSessionSignatureUpdated: {
-                identify.signature = message.payload.data;
-                break;
-            }
-            case IdentifyAction.OnUserDataUpdated: {
-                identify.userData = message.payload.data;
-                break;
-            }
-            case IdentifyAction.Login: {
-                enqueueLogin(identify, message.payload);
-                break;
-            }
-            case IdentifyAction.Logout: {
-                enqueueLogout(identify);
-                break;
-            }
+function handleParentMessage(message) {
+    switch (message.action) {
+        case IdentifyAction.Login: {
+            applyLogin(message.payload);
+            break;
         }
-    });
-}
-/**
- * Finds an existing SDK with matching projectId, or creates a new one.
- */
-function getOrConfigureSdk(host, projectId) {
-    const existingSdk = sdkCore.getSdks().find((sdk) => sdk.options.projectId === projectId);
-    return existingSdk !== null && existingSdk !== void 0 ? existingSdk : sdkCore.configure({ host, projectId }, projectId);
+        case IdentifyAction.Logout: {
+            applyLogout();
+            break;
+        }
+    }
 }
 /**
  * @internal
  */
 function handleExperienceEmbedded(experience) {
-    const identify = getIdentify(experience.sdk);
-    // Send login action with current credentials to the new experience if available.
-    // The bridge queues this message until the experience is initialised.
-    if (identify.credentials) {
-        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.Login, identify.credentials);
-    }
-    const credentialsUpdatedUnsub = onCredentialsUpdated(identify, (data) => {
-        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.OnCredentialsUpdated, {
-            data,
-        });
-    });
-    const signatureUpdatedUnsub = onSignatureUpdated(identify, (data) => {
-        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.OnSessionSignatureUpdated, {
-            data,
-        });
-    });
-    const userDataUpdatedUnsub = onUserDataUpdated(identify, (data) => {
-        sdkLauncherKit.sendSdkMessage(experience, IdentifyAction.OnUserDataUpdated, {
-            data,
-        });
-    });
     const sdkMessageUnsub = sdkLauncherKit.onSdkMessage(experience, async (message) => {
         if (!Object.values(IdentifyAction).includes(message.action)) {
             return;
         }
-        // Extract origin context from payload if available.
-        // New clients include origin (host, projectId) to ensure correct project context
-        // in multilevel integrations. Old clients don't send origin, so we fall back
-        // to the experience's SDK to maintain backward compatibility.
-        const { origin } = message.payload;
-        const originSdk = origin
-            ? getOrConfigureSdk(origin.host, origin.projectId)
-            : experience.sdk;
-        const originIdentify = getIdentify(originSdk);
         const respond = (payload) => sdkLauncherKit.respondToSdkMessage(experience, message, payload);
         try {
             switch (message.action) {
                 case IdentifyAction.RequestLogin: {
-                    await requestLogin(originIdentify);
+                    await requestLogin();
                     respond();
                     break;
                 }
                 case IdentifyAction.RequestLogout: {
-                    await requestLogout(identify);
+                    await requestLogout();
                     respond();
                     break;
                 }
-                case IdentifyAction.GetUserData: {
-                    const data = await getUserData(identify);
+                case IdentifyAction.GetCredentials: {
+                    const data = await getCredentials();
                     respond({ data });
                     break;
                 }
-                case IdentifyAction.GetSessionSignature: {
-                    const signature = await getSessionSignatureMemoized(identify, message.payload);
-                    respond({ data: signature });
-                    break;
-                }
                 case IdentifyAction.SetCredentials: {
-                    await setCredentials(originIdentify, {
-                        token: message.payload.token,
-                    });
+                    await setCredentials(message.payload);
                     respond();
                     break;
                 }
                 case IdentifyAction.ClearCredentials: {
-                    await clearCredentials(identify);
+                    await clearCredentials();
                     respond();
                     break;
                 }
@@ -1120,12 +1127,7 @@ function handleExperienceEmbedded(experience) {
             });
         }
     });
-    addExperience(experience, [
-        credentialsUpdatedUnsub,
-        signatureUpdatedUnsub,
-        userDataUpdatedUnsub,
-        sdkMessageUnsub,
-    ]);
+    addExperience(experience, [sdkMessageUnsub]);
 }
 /**
  * @internal
@@ -1133,26 +1135,42 @@ function handleExperienceEmbedded(experience) {
 function handleExperienceUnmounted(experience) {
     deleteExperience(experience);
 }
-sdkLauncherKit.onStateChanged((experience, state) => {
+/**
+ * @internal
+ */
+function handleExperienceStateChange(experience, state) {
     if (state === 'mounted') {
         handleExperienceEmbedded(experience);
+        return;
     }
-    else if (state === 'unmounted') {
+    if (state === 'unmounted') {
         handleExperienceUnmounted(experience);
     }
-});
-registerIdentifyHook(parentMessagesHook);
+}
+function subscribeToExperienceLifecycle() {
+    sdkLauncherKit.onStateChanged(handleExperienceStateChange);
+}
+function connectToParentApplication() {
+    const parentApp = sdkLauncherKit.getParentApplication();
+    if (parentApp === null) {
+        return;
+    }
+    sdkLauncherKit.onSdkMessage(parentApp, handleParentMessage);
+    pullStateFromParent();
+}
+subscribeToExperienceLifecycle();
+connectToParentApplication();
 
 exports.clearCredentials = clearCredentials;
+exports.getCredentials = getCredentials;
 exports.getIdentify = getIdentify;
 exports.getUserData = getUserData;
 exports.onCredentialsUpdated = onCredentialsUpdated;
 exports.onLoginRequestedByExperience = onLoginRequestedByExperience;
 exports.onLogoutRequestedByExperience = onLogoutRequestedByExperience;
-exports.onSignatureUpdated = onSignatureUpdated;
 exports.onStateUpdated = onStateUpdated;
-exports.onUserDataUpdated = onUserDataUpdated;
 exports.requestLogin = requestLogin;
 exports.requestLogout = requestLogout;
 exports.setCredentials = setCredentials;
+exports.setLoginPolicy = setLoginPolicy;
 //# sourceMappingURL=index.cjs.map