@namiml/sdk-core 3.4.0-dev.202605190929 → 3.4.0-dev.202605191752

package/dist/index.cjs

@@ -98,7 +98,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605190929", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605191752", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -6927,6 +6927,21 @@ class NamiAPI {
         this.baseURL = getBaseUrl(config.namiCommands);
         this.platformID = config.appPlatformID;
     }
+    /**
+     * Clear cached baseURL and platformID so the next `configure()` call
+     * re-derives them from fresh storage. Called from `Nami.reset()`.
+     *
+     * Without this, the NamiAPI singleton holds the previous lifecycle's
+     * platform/base URL even after storage has been wiped — any in-flight
+     * or queued request after reset would hit the old endpoint.
+     */
+    static reset() {
+        this.instance.reset();
+    }
+    reset() {
+        this.baseURL = undefined;
+        this.platformID = undefined;
+    }
     async login(externalId) {
         if (!externalId) {
             throw new ExternalIDRequiredError();
@@ -8000,6 +8015,18 @@ class CampaignRuleRepository {
         this.disableCampaignUpdates = namiCommands.includes("disableCampaignUpdates");
         this.useLegacyPaywallFetch = namiCommands.includes("useLegacyPaywallFetch");
     }
+    /**
+     * Reset the singleton's configured state. Called from `Nami.reset()`
+     * so the previous lifecycle's split position and namiCommands flags
+     * don't leak into the next configure() cycle. The form factor reverts
+     * to the platform's natural value via `getDeviceFormFactor()`.
+     */
+    reset() {
+        this.currentFormFactor = getDeviceFormFactor();
+        this.splitPosition = undefined;
+        this.disableCampaignUpdates = false;
+        this.useLegacyPaywallFetch = false;
+    }
     async fetchCampaignRules(paywalls) {
         // get deviceId
         const authDevice = storageService.getDevice();
@@ -11310,6 +11337,15 @@ class PaywallState extends SimpleEventTarget {
     static remove(provider) {
         this.providers = this.providers.filter(p => p !== provider);
     }
+    /**
+     * Clear the static `providers` array. Called from `Nami.reset()` so
+     * orphaned PaywallState instances from a previous SDK lifecycle don't
+     * receive customer-attribute / login / product-detail updates intended
+     * for the next configure() cycle.
+     */
+    static reset() {
+        this.providers = [];
+    }
     static get currentProvider() {
         return PaywallState.providers[0];
     }
@@ -12063,7 +12099,87 @@ function isEqual(objA, objB) {
     return isEqual$1(normA, normB);
 }
 
+class NamiProfileManager {
+    constructor() {
+        this.load();
+    }
+    setExternalId(externalId) {
+        this.externalId = externalId;
+        return this;
+    }
+    getExternalId() {
+        return this.externalId;
+    }
+    isLoggedIn() {
+        return !!this.externalId;
+    }
+    save() {
+        if (this.externalId) {
+            storageService.setNamiProfile({
+                externalId: this.externalId,
+            });
+        }
+        else {
+            storageService.removeNamiProfile();
+        }
+        return this;
+    }
+    load() {
+        const profile = storageService.getNamiProfile();
+        if (profile) {
+            this.externalId = profile.externalId;
+        }
+        PaywallState.setIsLoggedIn(!!this.externalId);
+    }
+    /**
+     * Update local profile state for login: persist the external id and flip the
+     * logged-in flag in PaywallState. No network I/O — pair with `loginRemote`
+     * to perform the actual API call. Used by the async login/logout fast path.
+     */
+    loginLocal(externalId) {
+        this.setExternalId(externalId).save();
+        PaywallState.setIsLoggedIn(true);
+    }
+    /**
+     * Perform the login network call only. If the server returns a different
+     * `external_id` than the locally stored value, reconcile it into local state.
+     */
+    async loginRemote(externalId) {
+        const loginData = await NamiAPI.instance.login(externalId);
+        if (loginData.external_id && loginData.external_id !== this.externalId) {
+            this.setExternalId(loginData.external_id).save();
+        }
+    }
+    /**
+     * Update local profile state for logout: clear the external id, persist,
+     * and flip the logged-in flag in PaywallState. Used by the async fast path.
+     */
+    logoutLocal() {
+        this.setExternalId(undefined).save();
+        PaywallState.setIsLoggedIn(false);
+    }
+    /**
+     * Perform the logout network call only.
+     */
+    async logoutRemote() {
+        await NamiAPI.instance.logout();
+    }
+    async login(externalId) {
+        this.loginLocal(externalId);
+        await this.loginRemote(externalId);
+    }
+    async logout() {
+        this.logoutLocal();
+        await this.logoutRemote();
+    }
+}
+NamiProfileManager.instance = new NamiProfileManager();
+
 var _Nami_isInitialized;
+// NamiFlowManager is intentionally NOT imported at top level — it
+// transitively imports back to this module (`Nami` for logging), and
+// pulling it in here causes a load-order cycle that breaks tests
+// importing `ConditionalEvaluator`. It's loaded lazily inside `reset()`.
 class Nami {
     constructor() {
         _Nami_isInitialized.set(this, false);
@@ -12080,13 +12196,32 @@ class Nami {
     }
     /**
      * Clear all locally persisted SDK state (device ID, customer attributes,
-     * campaigns/paywalls/products caches, session, and anonymous-mode flags).
-     * After reset, the next configure() call regenerates the device ID.
+     * campaigns/paywalls/products caches, session, and anonymous-mode flags)
+     * AND the in-memory state held by module-level singletons so the next
+     * configure() call starts from a truly clean slate.
+     *
+     * Host-registered handler refs (flow event/handoff handlers, customer
+     * journey/account state handlers, purchase complete handler) are
+     * intentionally preserved across reset — they're owned by the
+     * integrating app, consistent with the Apple and Android SDKs.
      */
     static async reset() {
         storageService.clearAll();
         clearInMemoryAnonymousMode();
         __classPrivateFieldSet(Nami.instance, _Nami_isInitialized, false, "f");
+        // In-memory singleton state that previously survived reset and
+        // bled into the next configure() cycle.
+        NamiProfileManager.instance.setExternalId(undefined);
+        PaywallState.reset();
+        NamiAPI.reset();
+        CampaignRuleRepository.instance.reset();
+        // Lazy import to avoid a load-order cycle (NamiFlowManager imports
+        // back to this module for `Nami.instance.maxLogging`).
+        const { NamiFlowManager } = await Promise.resolve().then(function () { return NamiFlowManager$1; });
+        NamiFlowManager.reset();
+        // Give platform adapters a chance to drop their own state
+        // (e.g. Expo's UI adapter holds listener refs from PaywallView).
+        getPlatformAdapters().ui.onReset?.();
     }
     /**
      * Configures and initializes the SDK.
@@ -12963,57 +13098,6 @@ class PlacementLabelResolver extends BaseNamespaceResolver {
     }
 }
 
-class NamiProfileManager {
-    constructor() {
-        this.load();
-    }
-    setExternalId(externalId) {
-        this.externalId = externalId;
-        return this;
-    }
-    getExternalId() {
-        return this.externalId;
-    }
-    isLoggedIn() {
-        return !!this.externalId;
-    }
-    save() {
-        if (this.externalId) {
-            storageService.setNamiProfile({
-                externalId: this.externalId,
-            });
-        }
-        else {
-            storageService.removeNamiProfile();
-        }
-        return this;
-    }
-    load() {
-        const profile = storageService.getNamiProfile();
-        if (profile) {
-            this.externalId = profile.externalId;
-        }
-        PaywallState.setIsLoggedIn(!!this.externalId);
-    }
-    async login(externalId) {
-        const loginData = await NamiAPI.instance.login(externalId);
-        if (loginData.external_id) {
-            PaywallState.setIsLoggedIn(true);
-        }
-        this
-            .setExternalId(loginData.external_id)
-            .save();
-    }
-    async logout() {
-        await NamiAPI.instance.logout();
-        PaywallState.setIsLoggedIn(false);
-        this
-            .setExternalId(undefined)
-            .save();
-    }
-}
-NamiProfileManager.instance = new NamiProfileManager();
-
 /**
  * Represents the possible account actions states that can be returned by callback registered from
  * [NamiCustomerManager.registerAccountStateHandler]
@@ -13046,6 +13130,23 @@ class NamiFlowManager {
         this.lastAnimatedFlowProgress = new Map();
         this.navGraphCache = new WeakMap();
     }
+    /**
+     * Clear flow data state. Called from `Nami.reset()`.
+     *
+     * Resets the active flow, openness flag, animation progress, and the
+     * nav-graph cache. Host-registered handler refs (`handoffStepHandler`,
+     * `eventHandler`) are intentionally preserved across reset — they're
+     * owned by the integrating app via `registerStepHandoff()` /
+     * `registerEventHandler()`, consistent with how Apple/Android handle
+     * host callbacks across reset.
+     */
+    static reset() {
+        const i = NamiFlowManager.instance;
+        i.currentFlow = undefined;
+        i.flowOpen = false;
+        i.lastAnimatedFlowProgress = new Map();
+        i.navGraphCache = new WeakMap();
+    }
     static registerStepHandoff(handoffStepHandler) {
         this.instance.handoffStepHandler = handoffStepHandler;
     }
@@ -13329,6 +13430,26 @@ class NamiFlowManager {
     }
 }
 
+var NamiFlowManager$1 = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    NamiFlowManager: NamiFlowManager
+});
+
+const SHOULD_SHOW_LOADING_INDICATOR = false;
+const DISABLE_ASYNC_LOGIN_LOGOUT = "disableAsyncLoginLogout";
+/**
+ * Returns true when `disableAsyncLoginLogout` appears in the active `namiCommands` list,
+ * meaning login/logout should await the underlying API call before notifying handlers.
+ *
+ * Default behavior (flag absent) is the async/fast path: update local state and notify
+ * handlers immediately while dispatching the API call as fire-and-forget.
+ *
+ * Internal feature flag — opt-out via `Nami.configure({ namiCommands: [...] })`.
+ */
+const isAsyncLoginLogoutDisabled = () => {
+    return storageService.getNamiConfig()?.namiCommands?.includes(DISABLE_ASYNC_LOGIN_LOGOUT) ?? false;
+};
+
 /**
  * @class NamiCustomerManager
  * Provides methods for managing customer-related functionality.
@@ -13390,6 +13511,30 @@ class NamiCustomerManager {
             this.invokeStateHandler(exports.AccountStateAction.LOGIN, false, error);
             throw error;
         }
+        if (!isAsyncLoginLogoutDisabled()) {
+            // Default sync/fast path: update local state, notify handlers, and fire
+            // lifecycle immediately. Dispatch the underlying API call and entitlement
+            // refresh fire-and-forget — failures are logged but do not surface.
+            NamiProfileManager.instance.loginLocal(externalId);
+            this.invokeStateHandler(exports.AccountStateAction.LOGIN, true);
+            if (NamiFlowManager.instance.flowOpen) {
+                const currentFlow = NamiFlowManager.instance.currentFlow;
+                const currentStep = currentFlow?.currentFlowStep;
+                if (currentStep) {
+                    if (Nami.instance.maxLogging) {
+                        logger.debug(`[NamiCustomerManager] async login success — triggering __login_success__ on step ${currentStep.id}`);
+                    }
+                    currentFlow.executeLifecycle(currentStep, NamiReservedActions.LOGIN_SUCCESS);
+                }
+            }
+            void NamiProfileManager.instance.loginRemote(externalId).catch((err) => {
+                logger.error('[NamiCustomerManager] async login API failed', err);
+            });
+            void EntitlementRepository.instance.fetchActiveEntitlements().catch((err) => {
+                logger.error('[NamiCustomerManager] async login entitlement refresh failed', err);
+            });
+            return;
+        }
         try {
             await NamiProfileManager.instance.login(externalId);
             await EntitlementRepository.instance.fetchActiveEntitlements();
@@ -13435,6 +13580,30 @@ class NamiCustomerManager {
             this.invokeStateHandler(exports.AccountStateAction.LOGOUT, false, error);
             throw error;
         }
+        if (!isAsyncLoginLogoutDisabled()) {
+            // Default sync/fast path: clear local state, notify handlers, and fire
+            // lifecycle immediately. Dispatch the underlying API call and entitlement
+            // refresh fire-and-forget — failures are logged but do not surface.
+            NamiProfileManager.instance.logoutLocal();
+            this.invokeStateHandler(exports.AccountStateAction.LOGOUT, true);
+            if (NamiFlowManager.instance.flowOpen) {
+                const currentFlow = NamiFlowManager.instance.currentFlow;
+                const currentStep = currentFlow?.currentFlowStep;
+                if (currentStep) {
+                    if (Nami.instance.maxLogging) {
+                        logger.debug(`[NamiCustomerManager] async logout success — triggering __logout_success__ on step ${currentStep.id}`);
+                    }
+                    currentFlow.executeLifecycle(currentStep, NamiReservedActions.LOGOUT_SUCCESS);
+                }
+            }
+            void NamiProfileManager.instance.logoutRemote().catch((err) => {
+                logger.error('[NamiCustomerManager] async logout API failed', err);
+            });
+            void EntitlementRepository.instance.fetchActiveEntitlements().catch((err) => {
+                logger.error('[NamiCustomerManager] async logout entitlement refresh failed', err);
+            });
+            return;
+        }
         try {
             await NamiProfileManager.instance.logout();
             await EntitlementRepository.instance.fetchActiveEntitlements();
@@ -14869,8 +15038,6 @@ exports.CampaignRuleConversionEventType = void 0;
     CampaignRuleConversionEventType["IN_APP"] = "in_app";
 })(exports.CampaignRuleConversionEventType || (exports.CampaignRuleConversionEventType = {}));
 
-const SHOULD_SHOW_LOADING_INDICATOR = false;
-
 function parseToSemver(versionString) {
     const [semVer, major, minor, patch, prerelease, buildmetadata] = versionString.match(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/) ?? [];
     return {
@@ -64345,6 +64512,7 @@ exports.ClientError = ClientError;
 exports.ConfigRepository = ConfigRepository;
 exports.ConflictError = ConflictError;
 exports.CustomerJourneyRepository = CustomerJourneyRepository;
+exports.DISABLE_ASYNC_LOGIN_LOGOUT = DISABLE_ASYNC_LOGIN_LOGOUT;
 exports.DeviceIDRequiredError = DeviceIDRequiredError;
 exports.DeviceRepository = DeviceRepository;
 exports.EntitlementRepository = EntitlementRepository;

package/dist/index.d.ts

@@ -1458,6 +1458,17 @@ declare class NamiFlowManager {
     private lastAnimatedFlowProgress;
     private navGraphCache;
     private constructor();
+    /**
+     * Clear flow data state. Called from `Nami.reset()`.
+     *
+     * Resets the active flow, openness flag, animation progress, and the
+     * nav-graph cache. Host-registered handler refs (`handoffStepHandler`,
+     * `eventHandler`) are intentionally preserved across reset — they're
+     * owned by the integrating app via `registerStepHandoff()` /
+     * `registerEventHandler()`, consistent with how Apple/Android handle
+     * host callbacks across reset.
+     */
+    static reset(): void;
     handoffStepHandler?: NamiFlowHandoffStepHandler;
     static registerStepHandoff(handoffStepHandler?: NamiFlowHandoffStepHandler): void;
     eventHandler?: NamiFlowEventHandler;
@@ -1827,6 +1838,13 @@ interface IUIAdapter {
     flowNavigateToScreen(paywall: IPaywall, options: FlowNavigationOptions): void;
     /** Called after SDK configuration completes — used for platform-specific post-init setup */
     postConfigure?(): void;
+    /**
+     * Called from `Nami.reset()` so the adapter can drop any platform-specific
+     * state that survives the storage wipe (e.g. listener references on the
+     * Expo UI bridge, mounted paywall handles, etc.). Optional — adapters
+     * with no platform-specific state should leave this unset.
+     */
+    onReset?(): void;
 }
 
 interface PurchaseContext {
@@ -1871,8 +1889,14 @@ declare class Nami {
     static sdkPackageVersion(): string;
     /**
      * Clear all locally persisted SDK state (device ID, customer attributes,
-     * campaigns/paywalls/products caches, session, and anonymous-mode flags).
-     * After reset, the next configure() call regenerates the device ID.
+     * campaigns/paywalls/products caches, session, and anonymous-mode flags)
+     * AND the in-memory state held by module-level singletons so the next
+     * configure() call starts from a truly clean slate.
+     *
+     * Host-registered handler refs (flow event/handoff handlers, customer
+     * journey/account state handlers, purchase complete handler) are
+     * intentionally preserved across reset — they're owned by the
+     * integrating app, consistent with the Apple and Android SDKs.
      */
     static reset(): Promise<void>;
     /**
@@ -2133,6 +2157,26 @@ declare class NamiProfileManager {
     isLoggedIn(): boolean;
     private save;
     private load;
+    /**
+     * Update local profile state for login: persist the external id and flip the
+     * logged-in flag in PaywallState. No network I/O — pair with `loginRemote`
+     * to perform the actual API call. Used by the async login/logout fast path.
+     */
+    loginLocal(externalId: string): void;
+    /**
+     * Perform the login network call only. If the server returns a different
+     * `external_id` than the locally stored value, reconcile it into local state.
+     */
+    loginRemote(externalId: string): Promise<void>;
+    /**
+     * Update local profile state for logout: clear the external id, persist,
+     * and flip the logged-in flag in PaywallState. Used by the async fast path.
+     */
+    logoutLocal(): void;
+    /**
+     * Perform the logout network call only.
+     */
+    logoutRemote(): Promise<void>;
     login(externalId: string): Promise<void>;
     logout(): Promise<void>;
 }
@@ -2307,6 +2351,13 @@ declare class PaywallState extends SimpleEventTarget {
     filteredSkuMenus: ISkuMenu[];
     static create(paywall: IPaywall, context: NamiPaywallLaunchContext, campaign: NamiCampaign): PaywallState;
     static remove(provider: PaywallState): void;
+    /**
+     * Clear the static `providers` array. Called from `Nami.reset()` so
+     * orphaned PaywallState instances from a previous SDK lifecycle don't
+     * receive customer-attribute / login / product-detail updates intended
+     * for the next configure() cycle.
+     */
+    static reset(): void;
     static get currentProvider(): PaywallState | undefined;
     static setCustomerAttribute(attributes: {
         [key: string]: string;
@@ -2607,6 +2658,7 @@ declare const LIQUID_VARIABLE_REGEX: RegExp;
 declare const NAMI_STORAGE_KEYS: readonly string[];
 
 declare const SHOULD_SHOW_LOADING_INDICATOR = false;
+declare const DISABLE_ASYNC_LOGIN_LOGOUT = "disableAsyncLoginLogout";
 
 declare const getBaseUrl: (namiCommands?: string[]) => string;
 declare const getExtendedClientInfo: (namiCommands: string[]) => ExtendedPlatformInfo;
@@ -2714,6 +2766,16 @@ declare class NamiAPI {
     constructor();
     static configure(config: NamiConfiguration): void;
     protected configure(config: NamiConfiguration): void;
+    /**
+     * Clear cached baseURL and platformID so the next `configure()` call
+     * re-derives them from fresh storage. Called from `Nami.reset()`.
+     *
+     * Without this, the NamiAPI singleton holds the previous lifecycle's
+     * platform/base URL even after storage has been wiped — any in-flight
+     * or queued request after reset would hit the old endpoint.
+     */
+    static reset(): void;
+    protected reset(): void;
     login(externalId: string): Promise<LoginResponse>;
     logout(): Promise<Record<string, never>>;
     startSession(sessionStartTime: Date): Promise<void>;
@@ -2927,6 +2989,13 @@ declare class CampaignRuleRepository {
     static instance: CampaignRuleRepository;
     constructor();
     configure(formFactor: TDevice, splitPosition: number, namiCommands?: string[]): void;
+    /**
+     * Reset the singleton's configured state. Called from `Nami.reset()`
+     * so the previous lifecycle's split position and namiCommands flags
+     * don't leak into the next configure() cycle. The form factor reverts
+     * to the platform's natural value via `getDeviceFormFactor()`.
+     */
+    reset(): void;
     fetchCampaignRules(paywalls: IPaywall[]): Promise<NamiCampaign[]>;
     static extractPaywallUrls(campaigns: NamiCampaign[]): string[];
     static hasPaywallUrls(campaigns: NamiCampaign[]): boolean;
@@ -3082,5 +3151,5 @@ declare const getBillingPeriodNumber: (billingPeriod: string) => number;
 declare const formattedPrice: (price: number) => number;
 declare function toDouble(num: number): number;
 
-export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_NOT_AVAILABLE, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager, NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiProfileManager, NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseToSemver, postConversion, productDetail, registerPlatformAdapters, registerPurchaseAdapter, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateMinSDKVersion };
+export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_NOT_AVAILABLE, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager, NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiProfileManager, NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseToSemver, postConversion, productDetail, registerPlatformAdapters, registerPurchaseAdapter, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateMinSDKVersion };
 export type { AlignmentType, AmazonProduct, ApiResponse, AppleProduct, AvailableCampaignsResponseHandler, BorderLocationType, BorderSideType, Callback$1 as Callback, CloseHandler, CustomerJourneyState, DeepLinkUrlHandler, Device, DevicePayload, DeviceProfile, DirectionType, ExtendedPlatformInfo, FlexDirectionObject, FlowNavigationOptions, FontCollection, FontDetails, FormFactor, GoogleProduct, IConfig, IDeviceAdapter, IEntitlements$1 as IEntitlements, IPaywall, IPlatformAdapters, IProductsWithComponents, IPurchaseAdapter, ISkuMenu, IStorageAdapter, IUIAdapter, Impression, InitialConfig, InitialConfigCompressed, InitiateStateGroup, LoginResponse, NamiAnimation, NamiAnimationObjectSpec, NamiAnimationSpec, NamiAnonymousCampaign, NamiAppSuppliedVideoDetails, NamiCampaign, NamiCampaignSegment, NamiConfiguration, NamiConfigurationState, NamiEntitlement$1 as NamiEntitlement, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiInitialConfig, NamiLanguageCodes, NamiLogLevel, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchasesState, NamiSKU, NamiSKUType, NamiSubscriptionInterval, NamiSubscriptionPeriod, None, NoneSpec, PaywallActionEvent, PaywallHandle, PaywallResultHandler, PaywallSKU, PricingPhase, ProductGroup, Pulse, PulseSpec, PurchaseContext, PurchaseResult, PurchaseValidationRequest, SKU, SKUActionHandler, ScreenInfo, Session, TBaseComponent, TButtonContainer, TCarouselContainer, TCarouselSlide, TCarouselSlidesState, TCollapseContainer, TComponent, TConditionalAttributes, TConditionalComponent, TContainer, TContainerPosition, TCountdownTimerTextComponent, TDevice, TDisabledButton, TField, TFieldSettings, TFlexProductContainer, THeaderFooter, TImageComponent, TInitialState, TMediaTypes, TOffer, TPages, TPaywallContext, TPaywallLaunchContext, TPaywallMedia, TPaywallTemplate, TPlayPauseButton, TProductContainer, TProductGroup, TProgressBarComponent, TProgressIndicatorComponent, TQRCodeComponent, TRadioButton, TRepeatingGrid, TResponsiveGrid, TSegmentPicker, TSegmentPickerItem, TSemverObj, TSpacerComponent, TStack, TSvgImageComponent, TSymbolComponent, TTestObject, TTextComponent, TTextLikeComponent, TTextListComponent, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };

package/dist/index.mjs

@@ -96,7 +96,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605190929", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605191752", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -6925,6 +6925,21 @@ class NamiAPI {
         this.baseURL = getBaseUrl(config.namiCommands);
         this.platformID = config.appPlatformID;
     }
+    /**
+     * Clear cached baseURL and platformID so the next `configure()` call
+     * re-derives them from fresh storage. Called from `Nami.reset()`.
+     *
+     * Without this, the NamiAPI singleton holds the previous lifecycle's
+     * platform/base URL even after storage has been wiped — any in-flight
+     * or queued request after reset would hit the old endpoint.
+     */
+    static reset() {
+        this.instance.reset();
+    }
+    reset() {
+        this.baseURL = undefined;
+        this.platformID = undefined;
+    }
     async login(externalId) {
         if (!externalId) {
             throw new ExternalIDRequiredError();
@@ -7998,6 +8013,18 @@ class CampaignRuleRepository {
         this.disableCampaignUpdates = namiCommands.includes("disableCampaignUpdates");
         this.useLegacyPaywallFetch = namiCommands.includes("useLegacyPaywallFetch");
     }
+    /**
+     * Reset the singleton's configured state. Called from `Nami.reset()`
+     * so the previous lifecycle's split position and namiCommands flags
+     * don't leak into the next configure() cycle. The form factor reverts
+     * to the platform's natural value via `getDeviceFormFactor()`.
+     */
+    reset() {
+        this.currentFormFactor = getDeviceFormFactor();
+        this.splitPosition = undefined;
+        this.disableCampaignUpdates = false;
+        this.useLegacyPaywallFetch = false;
+    }
     async fetchCampaignRules(paywalls) {
         // get deviceId
         const authDevice = storageService.getDevice();
@@ -11308,6 +11335,15 @@ class PaywallState extends SimpleEventTarget {
     static remove(provider) {
         this.providers = this.providers.filter(p => p !== provider);
     }
+    /**
+     * Clear the static `providers` array. Called from `Nami.reset()` so
+     * orphaned PaywallState instances from a previous SDK lifecycle don't
+     * receive customer-attribute / login / product-detail updates intended
+     * for the next configure() cycle.
+     */
+    static reset() {
+        this.providers = [];
+    }
     static get currentProvider() {
         return PaywallState.providers[0];
     }
@@ -12061,7 +12097,87 @@ function isEqual(objA, objB) {
     return isEqual$1(normA, normB);
 }
 
+class NamiProfileManager {
+    constructor() {
+        this.load();
+    }
+    setExternalId(externalId) {
+        this.externalId = externalId;
+        return this;
+    }
+    getExternalId() {
+        return this.externalId;
+    }
+    isLoggedIn() {
+        return !!this.externalId;
+    }
+    save() {
+        if (this.externalId) {
+            storageService.setNamiProfile({
+                externalId: this.externalId,
+            });
+        }
+        else {
+            storageService.removeNamiProfile();
+        }
+        return this;
+    }
+    load() {
+        const profile = storageService.getNamiProfile();
+        if (profile) {
+            this.externalId = profile.externalId;
+        }
+        PaywallState.setIsLoggedIn(!!this.externalId);
+    }
+    /**
+     * Update local profile state for login: persist the external id and flip the
+     * logged-in flag in PaywallState. No network I/O — pair with `loginRemote`
+     * to perform the actual API call. Used by the async login/logout fast path.
+     */
+    loginLocal(externalId) {
+        this.setExternalId(externalId).save();
+        PaywallState.setIsLoggedIn(true);
+    }
+    /**
+     * Perform the login network call only. If the server returns a different
+     * `external_id` than the locally stored value, reconcile it into local state.
+     */
+    async loginRemote(externalId) {
+        const loginData = await NamiAPI.instance.login(externalId);
+        if (loginData.external_id && loginData.external_id !== this.externalId) {
+            this.setExternalId(loginData.external_id).save();
+        }
+    }
+    /**
+     * Update local profile state for logout: clear the external id, persist,
+     * and flip the logged-in flag in PaywallState. Used by the async fast path.
+     */
+    logoutLocal() {
+        this.setExternalId(undefined).save();
+        PaywallState.setIsLoggedIn(false);
+    }
+    /**
+     * Perform the logout network call only.
+     */
+    async logoutRemote() {
+        await NamiAPI.instance.logout();
+    }
+    async login(externalId) {
+        this.loginLocal(externalId);
+        await this.loginRemote(externalId);
+    }
+    async logout() {
+        this.logoutLocal();
+        await this.logoutRemote();
+    }
+}
+NamiProfileManager.instance = new NamiProfileManager();
+
 var _Nami_isInitialized;
+// NamiFlowManager is intentionally NOT imported at top level — it
+// transitively imports back to this module (`Nami` for logging), and
+// pulling it in here causes a load-order cycle that breaks tests
+// importing `ConditionalEvaluator`. It's loaded lazily inside `reset()`.
 class Nami {
     constructor() {
         _Nami_isInitialized.set(this, false);
@@ -12078,13 +12194,32 @@ class Nami {
     }
     /**
      * Clear all locally persisted SDK state (device ID, customer attributes,
-     * campaigns/paywalls/products caches, session, and anonymous-mode flags).
-     * After reset, the next configure() call regenerates the device ID.
+     * campaigns/paywalls/products caches, session, and anonymous-mode flags)
+     * AND the in-memory state held by module-level singletons so the next
+     * configure() call starts from a truly clean slate.
+     *
+     * Host-registered handler refs (flow event/handoff handlers, customer
+     * journey/account state handlers, purchase complete handler) are
+     * intentionally preserved across reset — they're owned by the
+     * integrating app, consistent with the Apple and Android SDKs.
      */
     static async reset() {
         storageService.clearAll();
         clearInMemoryAnonymousMode();
         __classPrivateFieldSet(Nami.instance, _Nami_isInitialized, false, "f");
+        // In-memory singleton state that previously survived reset and
+        // bled into the next configure() cycle.
+        NamiProfileManager.instance.setExternalId(undefined);
+        PaywallState.reset();
+        NamiAPI.reset();
+        CampaignRuleRepository.instance.reset();
+        // Lazy import to avoid a load-order cycle (NamiFlowManager imports
+        // back to this module for `Nami.instance.maxLogging`).
+        const { NamiFlowManager } = await Promise.resolve().then(function () { return NamiFlowManager$1; });
+        NamiFlowManager.reset();
+        // Give platform adapters a chance to drop their own state
+        // (e.g. Expo's UI adapter holds listener refs from PaywallView).
+        getPlatformAdapters().ui.onReset?.();
     }
     /**
      * Configures and initializes the SDK.
@@ -12961,57 +13096,6 @@ class PlacementLabelResolver extends BaseNamespaceResolver {
     }
 }
 
-class NamiProfileManager {
-    constructor() {
-        this.load();
-    }
-    setExternalId(externalId) {
-        this.externalId = externalId;
-        return this;
-    }
-    getExternalId() {
-        return this.externalId;
-    }
-    isLoggedIn() {
-        return !!this.externalId;
-    }
-    save() {
-        if (this.externalId) {
-            storageService.setNamiProfile({
-                externalId: this.externalId,
-            });
-        }
-        else {
-            storageService.removeNamiProfile();
-        }
-        return this;
-    }
-    load() {
-        const profile = storageService.getNamiProfile();
-        if (profile) {
-            this.externalId = profile.externalId;
-        }
-        PaywallState.setIsLoggedIn(!!this.externalId);
-    }
-    async login(externalId) {
-        const loginData = await NamiAPI.instance.login(externalId);
-        if (loginData.external_id) {
-            PaywallState.setIsLoggedIn(true);
-        }
-        this
-            .setExternalId(loginData.external_id)
-            .save();
-    }
-    async logout() {
-        await NamiAPI.instance.logout();
-        PaywallState.setIsLoggedIn(false);
-        this
-            .setExternalId(undefined)
-            .save();
-    }
-}
-NamiProfileManager.instance = new NamiProfileManager();
-
 /**
  * Represents the possible account actions states that can be returned by callback registered from
  * [NamiCustomerManager.registerAccountStateHandler]
@@ -13044,6 +13128,23 @@ class NamiFlowManager {
         this.lastAnimatedFlowProgress = new Map();
         this.navGraphCache = new WeakMap();
     }
+    /**
+     * Clear flow data state. Called from `Nami.reset()`.
+     *
+     * Resets the active flow, openness flag, animation progress, and the
+     * nav-graph cache. Host-registered handler refs (`handoffStepHandler`,
+     * `eventHandler`) are intentionally preserved across reset — they're
+     * owned by the integrating app via `registerStepHandoff()` /
+     * `registerEventHandler()`, consistent with how Apple/Android handle
+     * host callbacks across reset.
+     */
+    static reset() {
+        const i = NamiFlowManager.instance;
+        i.currentFlow = undefined;
+        i.flowOpen = false;
+        i.lastAnimatedFlowProgress = new Map();
+        i.navGraphCache = new WeakMap();
+    }
     static registerStepHandoff(handoffStepHandler) {
         this.instance.handoffStepHandler = handoffStepHandler;
     }
@@ -13327,6 +13428,26 @@ class NamiFlowManager {
     }
 }
 
+var NamiFlowManager$1 = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    NamiFlowManager: NamiFlowManager
+});
+
+const SHOULD_SHOW_LOADING_INDICATOR = false;
+const DISABLE_ASYNC_LOGIN_LOGOUT = "disableAsyncLoginLogout";
+/**
+ * Returns true when `disableAsyncLoginLogout` appears in the active `namiCommands` list,
+ * meaning login/logout should await the underlying API call before notifying handlers.
+ *
+ * Default behavior (flag absent) is the async/fast path: update local state and notify
+ * handlers immediately while dispatching the API call as fire-and-forget.
+ *
+ * Internal feature flag — opt-out via `Nami.configure({ namiCommands: [...] })`.
+ */
+const isAsyncLoginLogoutDisabled = () => {
+    return storageService.getNamiConfig()?.namiCommands?.includes(DISABLE_ASYNC_LOGIN_LOGOUT) ?? false;
+};
+
 /**
  * @class NamiCustomerManager
  * Provides methods for managing customer-related functionality.
@@ -13388,6 +13509,30 @@ class NamiCustomerManager {
             this.invokeStateHandler(AccountStateAction.LOGIN, false, error);
             throw error;
         }
+        if (!isAsyncLoginLogoutDisabled()) {
+            // Default sync/fast path: update local state, notify handlers, and fire
+            // lifecycle immediately. Dispatch the underlying API call and entitlement
+            // refresh fire-and-forget — failures are logged but do not surface.
+            NamiProfileManager.instance.loginLocal(externalId);
+            this.invokeStateHandler(AccountStateAction.LOGIN, true);
+            if (NamiFlowManager.instance.flowOpen) {
+                const currentFlow = NamiFlowManager.instance.currentFlow;
+                const currentStep = currentFlow?.currentFlowStep;
+                if (currentStep) {
+                    if (Nami.instance.maxLogging) {
+                        logger.debug(`[NamiCustomerManager] async login success — triggering __login_success__ on step ${currentStep.id}`);
+                    }
+                    currentFlow.executeLifecycle(currentStep, NamiReservedActions.LOGIN_SUCCESS);
+                }
+            }
+            void NamiProfileManager.instance.loginRemote(externalId).catch((err) => {
+                logger.error('[NamiCustomerManager] async login API failed', err);
+            });
+            void EntitlementRepository.instance.fetchActiveEntitlements().catch((err) => {
+                logger.error('[NamiCustomerManager] async login entitlement refresh failed', err);
+            });
+            return;
+        }
         try {
             await NamiProfileManager.instance.login(externalId);
             await EntitlementRepository.instance.fetchActiveEntitlements();
@@ -13433,6 +13578,30 @@ class NamiCustomerManager {
             this.invokeStateHandler(AccountStateAction.LOGOUT, false, error);
             throw error;
         }
+        if (!isAsyncLoginLogoutDisabled()) {
+            // Default sync/fast path: clear local state, notify handlers, and fire
+            // lifecycle immediately. Dispatch the underlying API call and entitlement
+            // refresh fire-and-forget — failures are logged but do not surface.
+            NamiProfileManager.instance.logoutLocal();
+            this.invokeStateHandler(AccountStateAction.LOGOUT, true);
+            if (NamiFlowManager.instance.flowOpen) {
+                const currentFlow = NamiFlowManager.instance.currentFlow;
+                const currentStep = currentFlow?.currentFlowStep;
+                if (currentStep) {
+                    if (Nami.instance.maxLogging) {
+                        logger.debug(`[NamiCustomerManager] async logout success — triggering __logout_success__ on step ${currentStep.id}`);
+                    }
+                    currentFlow.executeLifecycle(currentStep, NamiReservedActions.LOGOUT_SUCCESS);
+                }
+            }
+            void NamiProfileManager.instance.logoutRemote().catch((err) => {
+                logger.error('[NamiCustomerManager] async logout API failed', err);
+            });
+            void EntitlementRepository.instance.fetchActiveEntitlements().catch((err) => {
+                logger.error('[NamiCustomerManager] async logout entitlement refresh failed', err);
+            });
+            return;
+        }
         try {
             await NamiProfileManager.instance.logout();
             await EntitlementRepository.instance.fetchActiveEntitlements();
@@ -14867,8 +15036,6 @@ var CampaignRuleConversionEventType;
     CampaignRuleConversionEventType["IN_APP"] = "in_app";
 })(CampaignRuleConversionEventType || (CampaignRuleConversionEventType = {}));
 
-const SHOULD_SHOW_LOADING_INDICATOR = false;
-
 function parseToSemver(versionString) {
     const [semVer, major, minor, patch, prerelease, buildmetadata] = versionString.match(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/) ?? [];
     return {
@@ -64328,4 +64495,4 @@ function namiBuySKU(skuRefId) {
     return result;
 }
 
-export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_NOT_AVAILABLE, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager, NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiProfileManager, NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseToSemver, postConversion, productDetail, registerPlatformAdapters, registerPurchaseAdapter, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateMinSDKVersion };
+export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_NOT_AVAILABLE, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager, NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiProfileManager, NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseToSemver, postConversion, productDetail, registerPlatformAdapters, registerPurchaseAdapter, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateMinSDKVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namiml/sdk-core",
-  "version": "3.4.0-dev.202605190929",
+  "version": "3.4.0-dev.202605191752",
   "description": "Platform-agnostic core for the Nami SDK — business logic, API, types, and state management",
   "type": "module",
   "main": "./dist/index.cjs",