@namiml/sdk-core 3.4.12-dev.202609251647 → 3.4.12-dev.202609252349

package/dist/index.cjs

@@ -106,7 +106,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.12", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609251647", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609252349", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -116,7 +116,19 @@ AUTH_DEVICE: exports.AUTH_DEVICE = "nami_auth_device", NAMI_CONFIGURATION: expor
 // API settings
 API_VERSION: exports.API_VERSION = "v3", BASE_URL_PATH: exports.BASE_URL_PATH = `sdk/${exports.API_VERSION}/platform`, BASE_URL: exports.BASE_URL = "https://app.namiml.com", BASE_STAGING_URL: exports.BASE_STAGING_URL = "https://app-staging.namiml.com", CUSTOM_HOST_PREFIX: exports.CUSTOM_HOST_PREFIX = "namiAPIHost=", USE_STAGING_API: exports.USE_STAGING_API = "useStagingAPI", 
 // // extended client info
-EXTENDED_CLIENT_INFO_PREFIX: exports.EXTENDED_CLIENT_INFO_PREFIX = "extendedClientInfo", EXTENDED_CLIENT_INFO_DELIMITER: exports.EXTENDED_CLIENT_INFO_DELIMITER = ":", VALIDATE_PRODUCT_GROUPS: exports.VALIDATE_PRODUCT_GROUPS = "validateProductGroups", LOG_HTTP_REQUESTS: exports.LOG_HTTP_REQUESTS = "logHTTPRequests", LOG_HTTP_TRAFFIC: exports.LOG_HTTP_TRAFFIC = "logHTTPTraffic", API_TRAFFIC_OBSERVER: exports.API_TRAFFIC_OBSERVER = "apiTrafficObserver", STARTUP_TELEMETRY: exports.STARTUP_TELEMETRY = "startupTelemetry", EXTENDED_PLATFORM: exports.EXTENDED_PLATFORM = "extended-platform", EXTENDED_PLATFORM_VERSION: exports.EXTENDED_PLATFORM_VERSION = "extended-platform-version", API_MAX_CALLS_LIMIT: exports.API_MAX_CALLS_LIMIT = 2, API_RETRY_DELAY_SEC: exports.API_RETRY_DELAY_SEC = 2, API_TIMEOUT_LIMIT: exports.API_TIMEOUT_LIMIT = 20000, DEVICE_API_TIMEOUT_LIMIT: exports.DEVICE_API_TIMEOUT_LIMIT = 2000, 
+EXTENDED_CLIENT_INFO_PREFIX: exports.EXTENDED_CLIENT_INFO_PREFIX = "extendedClientInfo", EXTENDED_CLIENT_INFO_DELIMITER: exports.EXTENDED_CLIENT_INFO_DELIMITER = ":", VALIDATE_PRODUCT_GROUPS: exports.VALIDATE_PRODUCT_GROUPS = "validateProductGroups", LOG_HTTP_REQUESTS: exports.LOG_HTTP_REQUESTS = "logHTTPRequests", LOG_HTTP_TRAFFIC: exports.LOG_HTTP_TRAFFIC = "logHTTPTraffic", API_TRAFFIC_OBSERVER: exports.API_TRAFFIC_OBSERVER = "apiTrafficObserver", STARTUP_TELEMETRY: exports.STARTUP_TELEMETRY = "startupTelemetry", 
+// Test hook: every platform-config fetch attempt fails before the request leaves.
+// Same namiCommand as Apple's and Android's, so the shared first-run flows drive it.
+SIMULATE_CONFIG_FETCH_FAILURE: exports.SIMULATE_CONFIG_FETCH_FAILURE = "simulateConfigFetchFailure", EXTENDED_PLATFORM: exports.EXTENDED_PLATFORM = "extended-platform", EXTENDED_PLATFORM_VERSION: exports.EXTENDED_PLATFORM_VERSION = "extended-platform-version", API_MAX_CALLS_LIMIT: exports.API_MAX_CALLS_LIMIT = 2, API_RETRY_DELAY_SEC: exports.API_RETRY_DELAY_SEC = 2, API_TIMEOUT_LIMIT: exports.API_TIMEOUT_LIMIT = 20000, DEVICE_API_TIMEOUT_LIMIT: exports.DEVICE_API_TIMEOUT_LIMIT = 2000, 
+// Platform-config attempts when no initial config was supplied (Android's
+// CONFIG_MAX_ATTEMPTS; Apple's retry(maxAttempts: 3)).
+CONFIG_MAX_ATTEMPTS: exports.CONFIG_MAX_ATTEMPTS = 3, 
+// Per-attempt timeout for GET config/. Android's config client allows 5 s to connect plus 5 s
+// to read (Apple allows 30 s); three attempts keep a total outage near 30 s.
+CONFIG_API_TIMEOUT_LIMIT: exports.CONFIG_API_TIMEOUT_LIMIT = 10000, 
+// A foreground within this long of the last launch/resume run is skipped — Apple's
+// NamiStartupCoordinator.shouldRunResume window.
+RESUME_THROTTLE_MS: exports.RESUME_THROTTLE_MS = 30000, 
 // status codes
 STATUS_SUCCESS: exports.STATUS_SUCCESS = 200, STATUS_BAD_REQUEST: exports.STATUS_BAD_REQUEST = 400, STATUS_NOT_FOUND: exports.STATUS_NOT_FOUND = 404, STATUS_CONFLICT: exports.STATUS_CONFLICT = 409, STATUS_INTERNAL_SERVER_ERROR: exports.STATUS_INTERNAL_SERVER_ERROR = 500, 
 // configuration states
@@ -58033,27 +58045,125 @@ class PaywallRepository {
 PaywallRepository.instance = new PaywallRepository();
 
 class ConfigRepository {
+    /**
+     * One `GET config/` attempt. Persists the config on success and throws on any failure —
+     * a non-2xx or a transport error alike. `withRetry`'s own retries are turned off, so the
+     * attempt count belongs to {@link fetchConfigForStartup} alone.
+     */
     async fetchConfig() {
-        let data;
-        try {
-            data = await NamiAPI.instance.fetchAPI("config/");
-            ;
-        }
-        catch (error) {
-            data = storageService.getAppConfig(exports.API_CONFIG)
-                || storageService.getAppConfig(exports.INITIAL_APP_CONFIG);
-            if (!data) {
-                logger.error(handleErrors(error.status, "config/"));
-                throw error;
-            }
+        // Thrown from *inside* the attempt on purpose, like Apple's and Android's: the ladder then
+        // treats it exactly as a real 500, which is the whole point of the mock.
+        if (storageService.getNamiConfig()?.namiCommands?.includes(exports.SIMULATE_CONFIG_FETCH_FAILURE)) {
+            throw new RetryLimitExceededError(exports.STATUS_INTERNAL_SERVER_ERROR, exports.SIMULATE_CONFIG_FETCH_FAILURE);
         }
-        if (data) {
+        const platformId = storageService.getNamiConfig()?.appPlatformID;
+        const data = await NamiAPI.instance.fetchAPI("config/", exports.CONFIG_API_TIMEOUT_LIMIT, 0);
+        // A late answer (the startup await gave up on it) must not overwrite another platform's
+        // config after a reset or a platform-switching reconfigure.
+        if (storageService.getNamiConfig()?.appPlatformID === platformId) {
             storageService.setAppConfig(exports.API_CONFIG, data);
         }
+        else {
+            logger.debug("Discarding an app config response for a platform that is no longer configured");
+        }
         return data;
     }
+    /**
+     * The startup platform-config step, converged on Apple's `NamiPlatformConfigService.fetch` and
+     * Android's `fetchAppConfigOnce` (NAM-4470, NAM-4589):
+     *
+     * | case | outcome |
+     * |---|---|
+     * | an initial config was supplied | NOT awaited: one attempt runs in the background and stores the config when it lands; usable |
+     * | no initial config, success, capabilities include `sdk` | usable |
+     * | no initial config, success, capabilities lack `sdk` | not usable |
+     * | no initial config, failure | {@link CONFIG_MAX_ATTEMPTS} attempts of up to {@link CONFIG_API_TIMEOUT_LIMIT} each, then usable only if a config is cached (and grants `sdk`) |
+     *
+     * The two fallbacks are consulted at two different points, deliberately. An initial config
+     * decides the case *before* any request: startup does not wait on the network at all, since the
+     * initial config is what makes the SDK ready without it (Apple: "Initial config is available.
+     * Skipping retry."). The config cached by a previous launch is consulted only *after* the
+     * retries run out. A stored `INITIAL_APP_CONFIG` is not that cache.
+     *
+     * One check does apply with an initial config, because it costs no wait: a cached config that
+     * withholds `sdk` still stops startup, as Apple's cache load re-applies `updateSdkFlags`.
+     * Without it a kill switch could never reach an app that ships an initial config — the
+     * background fetch lands after startup has already run, so it takes effect from the next launch.
+     *
+     * A `404` is treated as any other 4xx, matching Apple's effective behaviour (its dedicated 404
+     * branch is unreachable, NAM-4471) and Android's.
+     *
+     * @param hasInitialConfig whether the host passed an `initialConfig` that decoded to content.
+     */
+    async fetchConfigForStartup(hasInitialConfig) {
+        if (hasInitialConfig)
+            return this.startupOnInitialConfig();
+        const maxAttempts = exports.CONFIG_MAX_ATTEMPTS;
+        let lastError;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            if (attempt > 1) {
+                logger.debug(`Retrying app config fetch (attempt ${attempt} of ${maxAttempts})`);
+            }
+            try {
+                return outcomeOf(await this.fetchConfig());
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        const cached = storageService.getAppConfig(exports.API_CONFIG);
+        if (cached) {
+            // A cached kill switch still holds: Apple re-applies `updateSdkFlags` when it loads the
+            // cached config, so one that withheld `sdk` keeps the SDK disabled through an outage.
+            if (!grantsSdk(cached)) {
+                return { usable: false, reason: "the cached app config does not grant the 'sdk' capability" };
+            }
+            logger.info(`App config fetch failed after ${maxAttempts} attempts - continuing on the cached config`);
+            return { usable: true };
+        }
+        return {
+            usable: false,
+            reason: `app config fetch failed after ${maxAttempts} attempts (${describeFailure(lastError)}) ` +
+                "and no initial or cached config is available",
+        };
+    }
+    /**
+     * The initial-config case: nothing is awaited. The cached kill switch is a storage read; the
+     * config request is left running and persists its answer (`fetchConfig`) when it lands.
+     */
+    startupOnInitialConfig() {
+        // Read before the request can land, so this launch is judged on what the last one stored.
+        const cached = storageService.getAppConfig(exports.API_CONFIG);
+        // Issued even when the cache holds a kill switch: that is how a LIFTED kill switch reaches
+        // the next launch.
+        this.fetchConfig().then((config) => {
+            if (!grantsSdk(config)) {
+                logger.warn("App config does not grant the 'sdk' capability - it takes effect from the next launch");
+            }
+        }, (error) => {
+            logger.info(`App config fetch failed (${describeFailure(error)}). Initial config is available. Skipping retry.`);
+        });
+        if (cached && !grantsSdk(cached)) {
+            return { usable: false, reason: "the cached app config does not grant the 'sdk' capability" };
+        }
+        return { usable: true };
+    }
 }
 ConfigRepository.instance = new ConfigRepository();
+function outcomeOf(config) {
+    return grantsSdk(config)
+        ? { usable: true }
+        : { usable: false, reason: "app config does not grant the 'sdk' capability" };
+}
+function grantsSdk(config) {
+    return config.capabilities?.includes(exports.Capabilities.SDK) ?? false;
+}
+function describeFailure(error) {
+    const status = error?.status;
+    if (typeof status === "number")
+        return `HTTP ${status}`;
+    return error instanceof Error ? error.message : String(error);
+}
 
 // Global reference to avoid circular imports
 let namiRefsInstance = null;
@@ -61597,6 +61707,15 @@ class NamiRefs {
         this.inMemoryAnonymousMode = false;
         // Captured before device registration; true only on genuine fresh installs
         this.isFirstSession = false;
+        // Set when the platform-config step leaves no usable config (see isStartupDisabled)
+        this.startupDisabled = false;
+        // Whether this configure() supplied an initial config (the config ladder's early exit)
+        this.hasInitialConfig = false;
+        // Resume bookkeeping: the configuration startup last ran with, when it (or a resume) last
+        // ran, and whether one is running now.
+        this.lastConfig = null;
+        this.lastStartupRunAt = 0;
+        this.startupInFlight = false;
         // Register this instance to avoid circular dependency issues
         setNamiRefsInstance(this);
     }
@@ -61614,13 +61733,101 @@ class NamiRefs {
     getIsFirstSession() {
         return this.isFirstSession;
     }
+    /**
+     * True when the platform-config step found no usable config and startup stopped after it —
+     * the equivalent of Apple's `sdkEnabled = false` and Android's `NamiRefs.startupDisabled`.
+     * Like both, it gates only the startup sequence, nothing else.
+     */
+    isStartupDisabled() {
+        return this.startupDisabled;
+    }
     async init(config) {
         this.isFirstSession = storageService.getDevice() === null && !storageService.getAnonymousMode();
+        // Cleared per configure so a transient failure cannot disable a later run.
+        this.startupDisabled = false;
+        // `Nami.configure` has already normalised a missing or undecodable initialConfig to `{}`,
+        // so "has content" is Apple's `initialConfig != nil`.
+        this.hasInitialConfig = Object.keys(config.initialConfig ?? {}).length > 0;
         this.setInitialValues(config);
-        ConfigRepository.instance.fetchConfig();
+        this.lastConfig = config;
+        this.lastStartupRunAt = Date.now();
+        this.startupInFlight = true;
+        try {
+            if (!(await this.fetchPlatformConfig()))
+                return;
+            await this.runStartupAfterConfig(config);
+        }
+        finally {
+            this.startupInFlight = false;
+        }
+    }
+    /**
+     * The app returned to the foreground. Re-reads the platform config, as Apple's `.appResume`
+     * and Android's `onAppComesFromBackground` do, so a config change — the `sdk` kill switch
+     * included — reaches a long-lived tab or app without a cold start.
+     *
+     * - Skipped within {@link RESUME_THROTTLE_MS} of the last launch/resume, and while one is
+     *   still running.
+     * - When the launch had **stopped** for want of a config and one is now usable, the rest of
+     *   startup runs — the steps an Apple resume re-runs because the launch never executed them.
+     * - Otherwise this is a config refresh only. Apple and Android also re-run device, campaigns,
+     *   profile, products and the session start on resume; core does not yet, and has no
+     *   session end on background for a second session start to pair with (NAM-4623).
+     */
+    async resume() {
+        if (!this.lastConfig || this.startupInFlight)
+            return;
+        if (Date.now() - this.lastStartupRunAt < exports.RESUME_THROTTLE_MS) {
+            logger.debug("Resuming too quickly to call the service.");
+            return;
+        }
+        const config = this.lastConfig;
+        const wasStopped = this.startupDisabled;
+        this.lastStartupRunAt = Date.now();
+        this.startupInFlight = true;
+        this.startupDisabled = false;
+        try {
+            if (!(await this.fetchPlatformConfig()) || !wasStopped)
+                return;
+            logger.info("Usable app config on resume - completing the startup that stopped at launch");
+            await this.runStartupAfterConfig(config);
+        }
+        catch (error) {
+            logger.warn(`Resume refresh failed: ${error}`);
+        }
+        finally {
+            this.startupInFlight = false;
+        }
+    }
+    /** Everything startup runs once the platform-config step has found a usable config. */
+    async runStartupAfterConfig(config) {
         await this.initAndFetchRequiredData(config);
         SessionService.instance.startSession();
     }
+    /** Forgets the configuration a resume would run against; called by `Nami.reset()`. */
+    clearResumeState() {
+        this.lastConfig = null;
+        this.lastStartupRunAt = 0;
+        this.startupDisabled = false;
+    }
+    /**
+     * The platform-config startup step, ahead of device registration — the position it holds on
+     * Apple (`.fetchPlatformConfig`) and Android (`fetchAppConfigOnce`) (NAM-4464, NAM-4589).
+     * Without an initial config it is awaited, so everything downstream — `campaign_cache_ttl`
+     * included — is evaluated against the config it leaves in storage. With one it resolves at
+     * once and the request finishes in the background (see `fetchConfigForStartup`).
+     *
+     * @returns false when there is no usable config, in which case startup must stop.
+     */
+    async fetchPlatformConfig() {
+        const outcome = await ConfigRepository.instance.fetchConfigForStartup(this.hasInitialConfig);
+        if (!outcome.usable) {
+            this.startupDisabled = true;
+            logger.error(`Nami startup stopped: ${outcome.reason}`);
+            return false;
+        }
+        return true;
+    }
     setInitialValues(config) {
         const baseConfig = { ...config };
         delete baseConfig.initialConfig;
@@ -61881,7 +62088,7 @@ class LastLaunchStore {
     }
 }
 
-var _Nami_isInitialized;
+var _Nami_isInitialized, _Nami_removeForegroundListener;
 // 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
@@ -61889,6 +62096,7 @@ var _Nami_isInitialized;
 class Nami {
     constructor() {
         _Nami_isInitialized.set(this, false);
+        _Nami_removeForegroundListener.set(this, null);
         this.maxLogging = false;
     }
     get isInitialized() {
@@ -61912,9 +62120,13 @@ class Nami {
      * integrating app, consistent with the Apple and Android SDKs.
      */
     static async reset() {
+        var _a;
         storageService.clearAll();
         clearInMemoryAnonymousMode();
         __classPrivateFieldSet(Nami.instance, _Nami_isInitialized, false, "f");
+        __classPrivateFieldGet((_a = Nami.instance), _Nami_removeForegroundListener, "f")?.call(_a);
+        __classPrivateFieldSet(Nami.instance, _Nami_removeForegroundListener, null, "f");
+        NamiRefs.instance.clearResumeState();
         // In-memory singleton state that previously survived reset and
         // bled into the next configure() cycle.
         NamiProfileManager$1.instance.setExternalId(undefined);
@@ -61977,6 +62189,18 @@ class Nami {
         }
         config.initialConfig = {};
     }
+    /**
+     * Subscribes the resume config refresh to the host's foreground signal, once per process —
+     * a reconfigure must not stack a second listener (the Android defect NAM-4541 fixed).
+     * Registered before startup runs; `resume()` itself skips while startup is in flight.
+     */
+    listenForAppForeground() {
+        if (__classPrivateFieldGet(this, _Nami_removeForegroundListener, "f"))
+            return;
+        __classPrivateFieldSet(this, _Nami_removeForegroundListener, getPlatformAdapters().device.onAppForeground?.(() => {
+            void NamiRefs.instance.resume();
+        }) ?? null, "f");
+    }
     async initializeSDK(config) {
         let fullReconfig = false;
         let partialReconfig = false;
@@ -62017,6 +62241,7 @@ class Nami {
         // configure SDK with new config
         __classPrivateFieldSet(this, _Nami_isInitialized, true, "f");
         NamiAPI.configure(config);
+        this.listenForAppForeground();
         await NamiRefs.instance.init(config);
         logger.info("SDK successfully initialized!");
         const state = partialReconfig || fullReconfig ? exports.RECONFIG_SUCCESS : exports.INITIAL_SUCCESS;
@@ -62028,7 +62253,7 @@ class Nami {
         };
     }
 }
-_Nami_isInitialized = new WeakMap();
+_Nami_isInitialized = new WeakMap(), _Nami_removeForegroundListener = new WeakMap();
 Nami.instance = new Nami();
 
 const VALID_STYLES = new Set(['fullscreen', 'sheet', 'compact_sheet', 'modal']);

package/dist/index.d.ts

@@ -65,6 +65,13 @@ interface IDeviceAdapter {
     generateUUID(): string;
     getScreenInfo(): ScreenInfo;
     getLanguage(): string;
+    /**
+     * Calls `listener` each time the app returns to the foreground — a browser tab becoming
+     * visible, a React Native app going `active` — and returns a function that stops listening.
+     * Drives core's resume config refresh (NAM-4589). Optional: a host with no foreground
+     * concept (the CLI) omits it and simply never resumes.
+     */
+    onAppForeground?(listener: () => void): () => void;
 }
 
 interface FormFactor {
@@ -2122,6 +2129,12 @@ declare class Nami {
      */
     static configure(options: NamiConfiguration): Promise<NamiConfigurationState>;
     private static setInitialConfig;
+    /**
+     * Subscribes the resume config refresh to the host's foreground signal, once per process —
+     * a reconfigure must not stack a second listener (the Android defect NAM-4541 fixed).
+     * Registered before startup runs; `resume()` itself skips while startup is in flight.
+     */
+    private listenForAppForeground;
     private initializeSDK;
 }
 
@@ -3183,12 +3196,16 @@ declare const LOG_HTTP_REQUESTS: string;
 declare const LOG_HTTP_TRAFFIC: string;
 declare const API_TRAFFIC_OBSERVER: string;
 declare const STARTUP_TELEMETRY: string;
+declare const SIMULATE_CONFIG_FETCH_FAILURE: string;
 declare const EXTENDED_PLATFORM: string;
 declare const EXTENDED_PLATFORM_VERSION: string;
 declare const API_MAX_CALLS_LIMIT: number;
 declare const API_RETRY_DELAY_SEC: number;
 declare const API_TIMEOUT_LIMIT: number;
 declare const DEVICE_API_TIMEOUT_LIMIT: number;
+declare const CONFIG_MAX_ATTEMPTS: number;
+declare const CONFIG_API_TIMEOUT_LIMIT: number;
+declare const RESUME_THROTTLE_MS: number;
 declare const STATUS_SUCCESS: number;
 declare const STATUS_BAD_REQUEST: number;
 declare const STATUS_NOT_FOUND: number;
@@ -3392,12 +3409,51 @@ declare class NamiRefs {
     static instance: NamiRefs;
     private inMemoryAnonymousMode;
     private isFirstSession;
+    private startupDisabled;
+    private hasInitialConfig;
+    private lastConfig;
+    private lastStartupRunAt;
+    private startupInFlight;
     constructor();
     setInMemoryAnonymousMode(enabled: boolean): void;
     isInMemoryAnonymousMode(): boolean;
     isAnonymousMode(): boolean;
     getIsFirstSession(): boolean;
+    /**
+     * True when the platform-config step found no usable config and startup stopped after it —
+     * the equivalent of Apple's `sdkEnabled = false` and Android's `NamiRefs.startupDisabled`.
+     * Like both, it gates only the startup sequence, nothing else.
+     */
+    isStartupDisabled(): boolean;
     init(config: NamiConfiguration): Promise<void>;
+    /**
+     * The app returned to the foreground. Re-reads the platform config, as Apple's `.appResume`
+     * and Android's `onAppComesFromBackground` do, so a config change — the `sdk` kill switch
+     * included — reaches a long-lived tab or app without a cold start.
+     *
+     * - Skipped within {@link RESUME_THROTTLE_MS} of the last launch/resume, and while one is
+     *   still running.
+     * - When the launch had **stopped** for want of a config and one is now usable, the rest of
+     *   startup runs — the steps an Apple resume re-runs because the launch never executed them.
+     * - Otherwise this is a config refresh only. Apple and Android also re-run device, campaigns,
+     *   profile, products and the session start on resume; core does not yet, and has no
+     *   session end on background for a second session start to pair with (NAM-4623).
+     */
+    resume(): Promise<void>;
+    /** Everything startup runs once the platform-config step has found a usable config. */
+    private runStartupAfterConfig;
+    /** Forgets the configuration a resume would run against; called by `Nami.reset()`. */
+    clearResumeState(): void;
+    /**
+     * The platform-config startup step, ahead of device registration — the position it holds on
+     * Apple (`.fetchPlatformConfig`) and Android (`fetchAppConfigOnce`) (NAM-4464, NAM-4589).
+     * Without an initial config it is awaited, so everything downstream — `campaign_cache_ttl`
+     * included — is evaluated against the config it leaves in storage. With one it resolves at
+     * once and the request finishes in the background (see `fetchConfigForStartup`).
+     *
+     * @returns false when there is no usable config, in which case startup must stop.
+     */
+    private fetchPlatformConfig;
     private setInitialValues;
     private initAnonymousDevice;
     private initIdentifiedDevice;
@@ -3602,9 +3658,56 @@ declare class CampaignRuleRepository {
     private fallbackData;
 }
 
+/**
+ * Whether startup may continue past the platform-config step; `reason` explains a `false`.
+ * A plain shape rather than a discriminated union: core does not compile with
+ * `strictNullChecks`, so a union on `usable` would not narrow.
+ */
+type ConfigStartupOutcome = {
+    usable: boolean;
+    reason?: string;
+};
 declare class ConfigRepository {
     static instance: ConfigRepository;
-    fetchConfig(): Promise<IConfig | null>;
+    /**
+     * One `GET config/` attempt. Persists the config on success and throws on any failure —
+     * a non-2xx or a transport error alike. `withRetry`'s own retries are turned off, so the
+     * attempt count belongs to {@link fetchConfigForStartup} alone.
+     */
+    fetchConfig(): Promise<IConfig>;
+    /**
+     * The startup platform-config step, converged on Apple's `NamiPlatformConfigService.fetch` and
+     * Android's `fetchAppConfigOnce` (NAM-4470, NAM-4589):
+     *
+     * | case | outcome |
+     * |---|---|
+     * | an initial config was supplied | NOT awaited: one attempt runs in the background and stores the config when it lands; usable |
+     * | no initial config, success, capabilities include `sdk` | usable |
+     * | no initial config, success, capabilities lack `sdk` | not usable |
+     * | no initial config, failure | {@link CONFIG_MAX_ATTEMPTS} attempts of up to {@link CONFIG_API_TIMEOUT_LIMIT} each, then usable only if a config is cached (and grants `sdk`) |
+     *
+     * The two fallbacks are consulted at two different points, deliberately. An initial config
+     * decides the case *before* any request: startup does not wait on the network at all, since the
+     * initial config is what makes the SDK ready without it (Apple: "Initial config is available.
+     * Skipping retry."). The config cached by a previous launch is consulted only *after* the
+     * retries run out. A stored `INITIAL_APP_CONFIG` is not that cache.
+     *
+     * One check does apply with an initial config, because it costs no wait: a cached config that
+     * withholds `sdk` still stops startup, as Apple's cache load re-applies `updateSdkFlags`.
+     * Without it a kill switch could never reach an app that ships an initial config — the
+     * background fetch lands after startup has already run, so it takes effect from the next launch.
+     *
+     * A `404` is treated as any other 4xx, matching Apple's effective behaviour (its dedicated 404
+     * branch is unreachable, NAM-4471) and Android's.
+     *
+     * @param hasInitialConfig whether the host passed an `initialConfig` that decoded to content.
+     */
+    fetchConfigForStartup(hasInitialConfig: boolean): Promise<ConfigStartupOutcome>;
+    /**
+     * The initial-config case: nothing is awaited. The cached kill switch is a storage read; the
+     * config request is left running and persists its answer (`fetchConfig`) when it lands.
+     */
+    private startupOnInitialConfig;
 }
 
 declare class CustomerJourneyRepository {
@@ -4117,5 +4220,5 @@ declare namespace internal {
   };
 }
 
-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_TRAFFIC_OBSERVER, 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, DEFAULT_JOURNEY_SETTINGS, 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$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$2 as 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, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, 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, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
+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_TRAFFIC_OBSERVER, 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, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, 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$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$2 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, 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, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
 export type { AccountStateHandler$1 as AccountStateHandler, AlignmentType, AmazonProduct, ApiResponse, AppleProduct, AvailableCampaignsResponseHandler, BorderLocationType, BorderSideType, Callback$1 as Callback, CloseHandler, CustomerJourneyState, DeepLinkUrlHandler, Device, DevicePayload, DeviceProfile, DirectionType, ExtendedPlatformInfo, FlexDirectionObject, FlowNavigationOptions, FontCollection, FontDetails, FormFactor, FormFieldValidator, GoogleProduct, IConfig, IDeviceAdapter, IEntitlements$1 as IEntitlements, IPaywall, IPlatformAdapters, IProductsWithComponents, IPurchaseAdapter, ISkuMenu, IStorageAdapter, IUIAdapter, Impression, InitialConfig, InitialConfigCompressed, InitiateStateGroup, JourneySettings, LoginResponse, NamiAPITrafficKind, NamiAPITrafficObserver, NamiAPITrafficRecord, NamiAnimation, NamiAnimationObjectSpec, NamiAnimationSpec, NamiAnonymousCampaign, NamiAppSuppliedVideoDetails, NamiCampaign, NamiCampaignManagerStatic, NamiCampaignSegment, NamiCompletionResult, NamiConfiguration, NamiConfigurationState, NamiCustomAttributeValue, NamiCustomerManagerStatic, NamiEntitlement$1 as NamiEntitlement, NamiEntitlementManagerStatic, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowCompletionCondition, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowManagerStatic, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiHandoffAttributeValue, NamiHandoffComplete, NamiHandoffOutcome, NamiHandoffTagValue, NamiInitialConfig, NamiKnownHandoffTag, NamiLanguageCodes, NamiLogLevel, NamiLoginSuccess, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPaywallManagerStatic, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchaseManagerStatic, NamiPurchaseSuccess, NamiPurchasesState, NamiSKU, NamiSKUType, NamiSubscriptionInterval, NamiSubscriptionPeriod, NamiUserDataEnvelope, 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, TSlot, TSlotGroupSelector, TSpacerComponent, TStack, TSvgImageComponent, TSymbolComponent, TTestObject, TTextComponent, TTextInputComponent, TTextInputType, TTextLikeComponent, TTextListComponent, TTimelineRail, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };

package/dist/index.mjs

@@ -104,7 +104,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.12", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609251647", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.12-dev.202609252349", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -114,7 +114,19 @@ AUTH_DEVICE = "nami_auth_device", NAMI_CONFIGURATION = "nami_configuration", NAM
 // API settings
 API_VERSION = "v3", BASE_URL_PATH = `sdk/${API_VERSION}/platform`, BASE_URL = "https://app.namiml.com", BASE_STAGING_URL = "https://app-staging.namiml.com", CUSTOM_HOST_PREFIX = "namiAPIHost=", USE_STAGING_API = "useStagingAPI", 
 // // extended client info
-EXTENDED_CLIENT_INFO_PREFIX = "extendedClientInfo", EXTENDED_CLIENT_INFO_DELIMITER = ":", VALIDATE_PRODUCT_GROUPS = "validateProductGroups", LOG_HTTP_REQUESTS = "logHTTPRequests", LOG_HTTP_TRAFFIC = "logHTTPTraffic", API_TRAFFIC_OBSERVER = "apiTrafficObserver", STARTUP_TELEMETRY = "startupTelemetry", EXTENDED_PLATFORM = "extended-platform", EXTENDED_PLATFORM_VERSION = "extended-platform-version", API_MAX_CALLS_LIMIT = 2, API_RETRY_DELAY_SEC = 2, API_TIMEOUT_LIMIT = 20000, DEVICE_API_TIMEOUT_LIMIT = 2000, 
+EXTENDED_CLIENT_INFO_PREFIX = "extendedClientInfo", EXTENDED_CLIENT_INFO_DELIMITER = ":", VALIDATE_PRODUCT_GROUPS = "validateProductGroups", LOG_HTTP_REQUESTS = "logHTTPRequests", LOG_HTTP_TRAFFIC = "logHTTPTraffic", API_TRAFFIC_OBSERVER = "apiTrafficObserver", STARTUP_TELEMETRY = "startupTelemetry", 
+// Test hook: every platform-config fetch attempt fails before the request leaves.
+// Same namiCommand as Apple's and Android's, so the shared first-run flows drive it.
+SIMULATE_CONFIG_FETCH_FAILURE = "simulateConfigFetchFailure", EXTENDED_PLATFORM = "extended-platform", EXTENDED_PLATFORM_VERSION = "extended-platform-version", API_MAX_CALLS_LIMIT = 2, API_RETRY_DELAY_SEC = 2, API_TIMEOUT_LIMIT = 20000, DEVICE_API_TIMEOUT_LIMIT = 2000, 
+// Platform-config attempts when no initial config was supplied (Android's
+// CONFIG_MAX_ATTEMPTS; Apple's retry(maxAttempts: 3)).
+CONFIG_MAX_ATTEMPTS = 3, 
+// Per-attempt timeout for GET config/. Android's config client allows 5 s to connect plus 5 s
+// to read (Apple allows 30 s); three attempts keep a total outage near 30 s.
+CONFIG_API_TIMEOUT_LIMIT = 10000, 
+// A foreground within this long of the last launch/resume run is skipped — Apple's
+// NamiStartupCoordinator.shouldRunResume window.
+RESUME_THROTTLE_MS = 30000, 
 // status codes
 STATUS_SUCCESS = 200, STATUS_BAD_REQUEST = 400, STATUS_NOT_FOUND = 404, STATUS_CONFLICT = 409, STATUS_INTERNAL_SERVER_ERROR = 500, 
 // configuration states
@@ -58031,27 +58043,125 @@ class PaywallRepository {
 PaywallRepository.instance = new PaywallRepository();
 
 class ConfigRepository {
+    /**
+     * One `GET config/` attempt. Persists the config on success and throws on any failure —
+     * a non-2xx or a transport error alike. `withRetry`'s own retries are turned off, so the
+     * attempt count belongs to {@link fetchConfigForStartup} alone.
+     */
     async fetchConfig() {
-        let data;
-        try {
-            data = await NamiAPI.instance.fetchAPI("config/");
-            ;
-        }
-        catch (error) {
-            data = storageService.getAppConfig(API_CONFIG)
-                || storageService.getAppConfig(INITIAL_APP_CONFIG);
-            if (!data) {
-                logger.error(handleErrors(error.status, "config/"));
-                throw error;
-            }
+        // Thrown from *inside* the attempt on purpose, like Apple's and Android's: the ladder then
+        // treats it exactly as a real 500, which is the whole point of the mock.
+        if (storageService.getNamiConfig()?.namiCommands?.includes(SIMULATE_CONFIG_FETCH_FAILURE)) {
+            throw new RetryLimitExceededError(STATUS_INTERNAL_SERVER_ERROR, SIMULATE_CONFIG_FETCH_FAILURE);
         }
-        if (data) {
+        const platformId = storageService.getNamiConfig()?.appPlatformID;
+        const data = await NamiAPI.instance.fetchAPI("config/", CONFIG_API_TIMEOUT_LIMIT, 0);
+        // A late answer (the startup await gave up on it) must not overwrite another platform's
+        // config after a reset or a platform-switching reconfigure.
+        if (storageService.getNamiConfig()?.appPlatformID === platformId) {
             storageService.setAppConfig(API_CONFIG, data);
         }
+        else {
+            logger.debug("Discarding an app config response for a platform that is no longer configured");
+        }
         return data;
     }
+    /**
+     * The startup platform-config step, converged on Apple's `NamiPlatformConfigService.fetch` and
+     * Android's `fetchAppConfigOnce` (NAM-4470, NAM-4589):
+     *
+     * | case | outcome |
+     * |---|---|
+     * | an initial config was supplied | NOT awaited: one attempt runs in the background and stores the config when it lands; usable |
+     * | no initial config, success, capabilities include `sdk` | usable |
+     * | no initial config, success, capabilities lack `sdk` | not usable |
+     * | no initial config, failure | {@link CONFIG_MAX_ATTEMPTS} attempts of up to {@link CONFIG_API_TIMEOUT_LIMIT} each, then usable only if a config is cached (and grants `sdk`) |
+     *
+     * The two fallbacks are consulted at two different points, deliberately. An initial config
+     * decides the case *before* any request: startup does not wait on the network at all, since the
+     * initial config is what makes the SDK ready without it (Apple: "Initial config is available.
+     * Skipping retry."). The config cached by a previous launch is consulted only *after* the
+     * retries run out. A stored `INITIAL_APP_CONFIG` is not that cache.
+     *
+     * One check does apply with an initial config, because it costs no wait: a cached config that
+     * withholds `sdk` still stops startup, as Apple's cache load re-applies `updateSdkFlags`.
+     * Without it a kill switch could never reach an app that ships an initial config — the
+     * background fetch lands after startup has already run, so it takes effect from the next launch.
+     *
+     * A `404` is treated as any other 4xx, matching Apple's effective behaviour (its dedicated 404
+     * branch is unreachable, NAM-4471) and Android's.
+     *
+     * @param hasInitialConfig whether the host passed an `initialConfig` that decoded to content.
+     */
+    async fetchConfigForStartup(hasInitialConfig) {
+        if (hasInitialConfig)
+            return this.startupOnInitialConfig();
+        const maxAttempts = CONFIG_MAX_ATTEMPTS;
+        let lastError;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            if (attempt > 1) {
+                logger.debug(`Retrying app config fetch (attempt ${attempt} of ${maxAttempts})`);
+            }
+            try {
+                return outcomeOf(await this.fetchConfig());
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        const cached = storageService.getAppConfig(API_CONFIG);
+        if (cached) {
+            // A cached kill switch still holds: Apple re-applies `updateSdkFlags` when it loads the
+            // cached config, so one that withheld `sdk` keeps the SDK disabled through an outage.
+            if (!grantsSdk(cached)) {
+                return { usable: false, reason: "the cached app config does not grant the 'sdk' capability" };
+            }
+            logger.info(`App config fetch failed after ${maxAttempts} attempts - continuing on the cached config`);
+            return { usable: true };
+        }
+        return {
+            usable: false,
+            reason: `app config fetch failed after ${maxAttempts} attempts (${describeFailure(lastError)}) ` +
+                "and no initial or cached config is available",
+        };
+    }
+    /**
+     * The initial-config case: nothing is awaited. The cached kill switch is a storage read; the
+     * config request is left running and persists its answer (`fetchConfig`) when it lands.
+     */
+    startupOnInitialConfig() {
+        // Read before the request can land, so this launch is judged on what the last one stored.
+        const cached = storageService.getAppConfig(API_CONFIG);
+        // Issued even when the cache holds a kill switch: that is how a LIFTED kill switch reaches
+        // the next launch.
+        this.fetchConfig().then((config) => {
+            if (!grantsSdk(config)) {
+                logger.warn("App config does not grant the 'sdk' capability - it takes effect from the next launch");
+            }
+        }, (error) => {
+            logger.info(`App config fetch failed (${describeFailure(error)}). Initial config is available. Skipping retry.`);
+        });
+        if (cached && !grantsSdk(cached)) {
+            return { usable: false, reason: "the cached app config does not grant the 'sdk' capability" };
+        }
+        return { usable: true };
+    }
 }
 ConfigRepository.instance = new ConfigRepository();
+function outcomeOf(config) {
+    return grantsSdk(config)
+        ? { usable: true }
+        : { usable: false, reason: "app config does not grant the 'sdk' capability" };
+}
+function grantsSdk(config) {
+    return config.capabilities?.includes(Capabilities.SDK) ?? false;
+}
+function describeFailure(error) {
+    const status = error?.status;
+    if (typeof status === "number")
+        return `HTTP ${status}`;
+    return error instanceof Error ? error.message : String(error);
+}
 
 // Global reference to avoid circular imports
 let namiRefsInstance = null;
@@ -61595,6 +61705,15 @@ class NamiRefs {
         this.inMemoryAnonymousMode = false;
         // Captured before device registration; true only on genuine fresh installs
         this.isFirstSession = false;
+        // Set when the platform-config step leaves no usable config (see isStartupDisabled)
+        this.startupDisabled = false;
+        // Whether this configure() supplied an initial config (the config ladder's early exit)
+        this.hasInitialConfig = false;
+        // Resume bookkeeping: the configuration startup last ran with, when it (or a resume) last
+        // ran, and whether one is running now.
+        this.lastConfig = null;
+        this.lastStartupRunAt = 0;
+        this.startupInFlight = false;
         // Register this instance to avoid circular dependency issues
         setNamiRefsInstance(this);
     }
@@ -61612,13 +61731,101 @@ class NamiRefs {
     getIsFirstSession() {
         return this.isFirstSession;
     }
+    /**
+     * True when the platform-config step found no usable config and startup stopped after it —
+     * the equivalent of Apple's `sdkEnabled = false` and Android's `NamiRefs.startupDisabled`.
+     * Like both, it gates only the startup sequence, nothing else.
+     */
+    isStartupDisabled() {
+        return this.startupDisabled;
+    }
     async init(config) {
         this.isFirstSession = storageService.getDevice() === null && !storageService.getAnonymousMode();
+        // Cleared per configure so a transient failure cannot disable a later run.
+        this.startupDisabled = false;
+        // `Nami.configure` has already normalised a missing or undecodable initialConfig to `{}`,
+        // so "has content" is Apple's `initialConfig != nil`.
+        this.hasInitialConfig = Object.keys(config.initialConfig ?? {}).length > 0;
         this.setInitialValues(config);
-        ConfigRepository.instance.fetchConfig();
+        this.lastConfig = config;
+        this.lastStartupRunAt = Date.now();
+        this.startupInFlight = true;
+        try {
+            if (!(await this.fetchPlatformConfig()))
+                return;
+            await this.runStartupAfterConfig(config);
+        }
+        finally {
+            this.startupInFlight = false;
+        }
+    }
+    /**
+     * The app returned to the foreground. Re-reads the platform config, as Apple's `.appResume`
+     * and Android's `onAppComesFromBackground` do, so a config change — the `sdk` kill switch
+     * included — reaches a long-lived tab or app without a cold start.
+     *
+     * - Skipped within {@link RESUME_THROTTLE_MS} of the last launch/resume, and while one is
+     *   still running.
+     * - When the launch had **stopped** for want of a config and one is now usable, the rest of
+     *   startup runs — the steps an Apple resume re-runs because the launch never executed them.
+     * - Otherwise this is a config refresh only. Apple and Android also re-run device, campaigns,
+     *   profile, products and the session start on resume; core does not yet, and has no
+     *   session end on background for a second session start to pair with (NAM-4623).
+     */
+    async resume() {
+        if (!this.lastConfig || this.startupInFlight)
+            return;
+        if (Date.now() - this.lastStartupRunAt < RESUME_THROTTLE_MS) {
+            logger.debug("Resuming too quickly to call the service.");
+            return;
+        }
+        const config = this.lastConfig;
+        const wasStopped = this.startupDisabled;
+        this.lastStartupRunAt = Date.now();
+        this.startupInFlight = true;
+        this.startupDisabled = false;
+        try {
+            if (!(await this.fetchPlatformConfig()) || !wasStopped)
+                return;
+            logger.info("Usable app config on resume - completing the startup that stopped at launch");
+            await this.runStartupAfterConfig(config);
+        }
+        catch (error) {
+            logger.warn(`Resume refresh failed: ${error}`);
+        }
+        finally {
+            this.startupInFlight = false;
+        }
+    }
+    /** Everything startup runs once the platform-config step has found a usable config. */
+    async runStartupAfterConfig(config) {
         await this.initAndFetchRequiredData(config);
         SessionService.instance.startSession();
     }
+    /** Forgets the configuration a resume would run against; called by `Nami.reset()`. */
+    clearResumeState() {
+        this.lastConfig = null;
+        this.lastStartupRunAt = 0;
+        this.startupDisabled = false;
+    }
+    /**
+     * The platform-config startup step, ahead of device registration — the position it holds on
+     * Apple (`.fetchPlatformConfig`) and Android (`fetchAppConfigOnce`) (NAM-4464, NAM-4589).
+     * Without an initial config it is awaited, so everything downstream — `campaign_cache_ttl`
+     * included — is evaluated against the config it leaves in storage. With one it resolves at
+     * once and the request finishes in the background (see `fetchConfigForStartup`).
+     *
+     * @returns false when there is no usable config, in which case startup must stop.
+     */
+    async fetchPlatformConfig() {
+        const outcome = await ConfigRepository.instance.fetchConfigForStartup(this.hasInitialConfig);
+        if (!outcome.usable) {
+            this.startupDisabled = true;
+            logger.error(`Nami startup stopped: ${outcome.reason}`);
+            return false;
+        }
+        return true;
+    }
     setInitialValues(config) {
         const baseConfig = { ...config };
         delete baseConfig.initialConfig;
@@ -61879,7 +62086,7 @@ class LastLaunchStore {
     }
 }
 
-var _Nami_isInitialized;
+var _Nami_isInitialized, _Nami_removeForegroundListener;
 // 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
@@ -61887,6 +62094,7 @@ var _Nami_isInitialized;
 class Nami {
     constructor() {
         _Nami_isInitialized.set(this, false);
+        _Nami_removeForegroundListener.set(this, null);
         this.maxLogging = false;
     }
     get isInitialized() {
@@ -61910,9 +62118,13 @@ class Nami {
      * integrating app, consistent with the Apple and Android SDKs.
      */
     static async reset() {
+        var _a;
         storageService.clearAll();
         clearInMemoryAnonymousMode();
         __classPrivateFieldSet(Nami.instance, _Nami_isInitialized, false, "f");
+        __classPrivateFieldGet((_a = Nami.instance), _Nami_removeForegroundListener, "f")?.call(_a);
+        __classPrivateFieldSet(Nami.instance, _Nami_removeForegroundListener, null, "f");
+        NamiRefs.instance.clearResumeState();
         // In-memory singleton state that previously survived reset and
         // bled into the next configure() cycle.
         NamiProfileManager$1.instance.setExternalId(undefined);
@@ -61975,6 +62187,18 @@ class Nami {
         }
         config.initialConfig = {};
     }
+    /**
+     * Subscribes the resume config refresh to the host's foreground signal, once per process —
+     * a reconfigure must not stack a second listener (the Android defect NAM-4541 fixed).
+     * Registered before startup runs; `resume()` itself skips while startup is in flight.
+     */
+    listenForAppForeground() {
+        if (__classPrivateFieldGet(this, _Nami_removeForegroundListener, "f"))
+            return;
+        __classPrivateFieldSet(this, _Nami_removeForegroundListener, getPlatformAdapters().device.onAppForeground?.(() => {
+            void NamiRefs.instance.resume();
+        }) ?? null, "f");
+    }
     async initializeSDK(config) {
         let fullReconfig = false;
         let partialReconfig = false;
@@ -62015,6 +62239,7 @@ class Nami {
         // configure SDK with new config
         __classPrivateFieldSet(this, _Nami_isInitialized, true, "f");
         NamiAPI.configure(config);
+        this.listenForAppForeground();
         await NamiRefs.instance.init(config);
         logger.info("SDK successfully initialized!");
         const state = partialReconfig || fullReconfig ? RECONFIG_SUCCESS : INITIAL_SUCCESS;
@@ -62026,7 +62251,7 @@ class Nami {
         };
     }
 }
-_Nami_isInitialized = new WeakMap();
+_Nami_isInitialized = new WeakMap(), _Nami_removeForegroundListener = new WeakMap();
 Nami.instance = new Nami();
 
 const VALID_STYLES = new Set(['fullscreen', 'sheet', 'compact_sheet', 'modal']);
@@ -65996,4 +66221,4 @@ var internal = /*#__PURE__*/Object.freeze({
     NamiPurchaseManager: NamiPurchaseManager
 });
 
-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_TRAFFIC_OBSERVER, 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, DEFAULT_JOURNEY_SETTINGS, 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$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$1 as 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, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, 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, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
+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_TRAFFIC_OBSERVER, 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, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, 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$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$1 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SessionService, SimpleEventTarget, StorageService, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, 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, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };

package/package.json

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