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

package/dist/bridge.d.ts

@@ -6,12 +6,17 @@
  *
  * More details on the license can be found at https://www.monterosa.co/sdk/license
  */
-import { Experience } from '@monterosa/sdk-launcher-kit';
-import { IdentifyKit } from './types';
+import { Experience, ExperienceState, Message } from '@monterosa/sdk-launcher-kit';
 /**
+ * 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
  */
-export declare function parentMessagesHook(identify: IdentifyKit): () => void;
+export declare function handleParentMessage(message: Message): void;
 /**
  * @internal
  */
@@ -20,3 +25,7 @@ export declare function handleExperienceEmbedded(experience: Experience): void;
  * @internal
  */
 export declare function handleExperienceUnmounted(experience: Experience): void;
+/**
+ * @internal
+ */
+export declare function handleExperienceStateChange(experience: Experience, state: ExperienceState): void;

package/dist/credentials_store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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
+ */
+import { Emitter, Unsubscribe } from '@monterosa/sdk-util';
+import { Credentials } from './types';
+/**
+ * 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
+ */
+export declare class CredentialsStore extends Emitter {
+    private static instance;
+    private _credentials;
+    private constructor();
+    static getInstance(): CredentialsStore;
+    get credentials(): Credentials | null;
+    set credentials(next: Credentials | null);
+    subscribe(handler: (value: Credentials | null) => void): Unsubscribe;
+    reset(): void;
+}

package/dist/identify.d.ts

@@ -8,30 +8,24 @@
  */
 import { MonterosaSdk } from '@monterosa/sdk-core';
 import { Emitter } from '@monterosa/sdk-util';
-import { IdentifyKit, IdentifyOptions, LoginState, Credentials, Signature, UserData } from './types';
-export default class Identify extends Emitter implements IdentifyKit {
+import { IdentifyKit, IdentifyOptions, LoginState, Signature, UserData } from './types';
+export declare class Identify extends Emitter implements IdentifyKit {
     sdk: MonterosaSdk;
-    private wasLoggedIn;
+    wasLoggedIn: boolean;
     private host?;
     private readonly _options;
-    private _credentials;
     private _signature;
     private _userData;
     private signatureExpireTimeout;
-    private userDataExpireTimeout;
     _state: LoginState;
-    constructor(sdk: MonterosaSdk, options?: IdentifyOptions);
+    constructor(sdk: MonterosaSdk, options?: Partial<IdentifyOptions>);
     private static fetchIdentifyHost;
     get state(): LoginState;
     set state(state: LoginState);
     get options(): IdentifyOptions;
     set signature(signature: Signature | null);
     get signature(): Signature | null;
-    set credentials(credentials: Credentials | null);
-    get credentials(): Credentials | null;
     set userData(data: UserData | null);
     get userData(): UserData | null;
-    get shouldLoginOnReconnect(): boolean;
-    reset(): void;
     getUrl(path?: string): Promise<string>;
 }

package/dist/identify_options.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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
+ */
+import { IdentifyOptions } from './types';
+/**
+ * Resolves partial identify options against defaults.
+ *
+ * Used by `getIdentify` (app-side) to ensure identify keys never diverge
+ * for the same logical inputs.
+ *
+ * @internal
+ */
+export declare function resolveIdentifyOptions(options?: Partial<IdentifyOptions>): IdentifyOptions;
+/**
+ * Deterministic identify key for memoisation.
+ *
+ * Includes the full identity tuple: `(host, projectId, strategy,
+ * provider, version)`. `loginPolicy` is intentionally excluded —
+ * behaviour is not identity-defining.
+ *
+ * @internal
+ */
+export declare function identifyKey(host: string, projectId: string, options: IdentifyOptions): string;

package/dist/identify_url.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @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
+ */
+import { IdentifyContext } from './types';
+/**
+ * Resolve the identify backend host for `(host, projectId)`, cached so
+ * repeated requests don't re-fetch listings.
+ *
+ * @internal
+ */
+export declare function fetchIdentifyHost(host: string, projectId: string): Promise<string>;
+/**
+ * Build an identify backend URL from a wire context — no `Identify`
+ * instance required. Used by bridge handlers at intermediate levels that
+ * relay requests on behalf of a child without materialising a local
+ * identify.
+ *
+ * @internal
+ */
+export declare function buildIdentifyUrl(context: IdentifyContext, path?: string): Promise<string>;

package/dist/identity_options.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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
+ */
+import { IdentifyOptions, ResolvedIdentityOptions } from './types';
+export type { ResolvedIdentityOptions };
+/**
+ * Resolves partial identify options against defaults.
+ *
+ * Used by both `getIdentify` (app-side) and the bridge handler
+ * (parent-side, when reacting to request context) to ensure
+ * identity keys never diverge for the same logical inputs.
+ *
+ * @internal
+ */
+export declare function resolveIdentityOptions(options?: IdentifyOptions): ResolvedIdentityOptions;
+/**
+ * Deterministic identity key for memoisation.
+ *
+ * Includes only the auth-related fields that define an "identity":
+ * `(projectId, strategy, provider, version)`. `deviceId` and
+ * `loginPolicy` are intentionally excluded — they are session-level
+ * and behaviour-level respectively, not identity-defining.
+ *
+ * @internal
+ */
+export declare function identityKey(projectId: string, options: ResolvedIdentityOptions): string;