@namiml/sdk-core 3.4.1 → 3.4.2-dev.202605300214

package/dist/index.cjs

@@ -96,9 +96,9 @@ exports.Capabilities = void 0;
 
 const { 
 // version — stamped by scripts/version.sh
-NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.1", 
+NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.2", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.1", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.2-dev.202605300214", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -108,7 +108,7 @@ 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", 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", 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, 
 // 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
@@ -6803,6 +6803,10 @@ const shouldLogHTTPTraffic = () => {
     const namiCommands = storageService.getNamiConfig()?.namiCommands;
     return namiCommands?.includes(exports.LOG_HTTP_TRAFFIC) ?? false;
 };
+const shouldLogStartupTelemetry = () => {
+    const namiCommands = storageService.getNamiConfig()?.namiCommands;
+    return namiCommands?.includes(exports.STARTUP_TELEMETRY) ?? false;
+};
 function tryParseJson(str) {
     const trimmed = str.trim();
     if (!trimmed.startsWith("{") && !trimmed.startsWith("["))
@@ -11929,6 +11933,123 @@ class CustomerJourneyRepository {
 }
 CustomerJourneyRepository.instance = new CustomerJourneyRepository();
 
+const PREFIX = "[NamiStartup]";
+/**
+ * Module-level singleton for startup timing instrumentation.
+ *
+ * All methods are cheap no-ops when the `startupTelemetry` namiCommand flag
+ * is absent. The flag is read once at `start()` and cached; subsequent calls
+ * to `mark()` and the span helpers use that cached boolean so the hot path
+ * never hits storage.
+ *
+ * Log format (info level via the shared logger):
+ *   [NamiStartup] phase=<name> ms=<n>
+ *   [NamiStartup] SUMMARY total_to_ready=<ms> decode=<ms> process=<ms> placements=<n>
+ */
+class StartupTelemetry {
+    constructor() {
+        this.enabled = false;
+        this.t0 = 0;
+        this.lastMark = 0;
+        // Accumulated segment durations for the SUMMARY line
+        this.decodeDuration = 0;
+        this.processDuration = 0;
+        this.placements = 0;
+        // One-shot guard: only log the very first launch lookup
+        this.firstLaunchLogged = false;
+    }
+    /**
+     * Call at the first line of configure(). Reads the feature flag once and
+     * stores t0 if the flag is on.
+     */
+    start() {
+        this.enabled = shouldLogStartupTelemetry();
+        if (!this.enabled)
+            return;
+        this.t0 = Date.now();
+        this.lastMark = this.t0;
+        this.decodeDuration = 0;
+        this.processDuration = 0;
+        this.placements = 0;
+        this.firstLaunchLogged = false;
+    }
+    /**
+     * Log a named phase checkpoint.
+     *
+     * - Emits `[NamiStartup] phase=<name> ms=<segment> [extras]`
+     * - On phase `ready`: also emits `total_to_ready=<ms>` and a SUMMARY line.
+     * - On phase `initial_config_decoded`: records the decode segment.
+     * - On phase `initial_processed`: records the process segment + placement count.
+     *
+     * @param phase  Phase key string (e.g. "initial_config_decoded").
+     * @param extras Optional key/value pairs appended to the log line.
+     */
+    mark(phase, extras) {
+        if (!this.enabled)
+            return;
+        const now = Date.now();
+        const segmentMs = now - this.lastMark;
+        this.lastMark = now;
+        // Accumulate segment durations for SUMMARY
+        if (phase === "initial_config_decoded") {
+            this.decodeDuration = segmentMs;
+        }
+        else if (phase === "initial_processed") {
+            this.processDuration = segmentMs;
+            if (extras?.count !== undefined) {
+                this.placements = extras.count;
+            }
+        }
+        const extrasStr = extras
+            ? " " + Object.entries(extras).map(([k, v]) => `${k}=${v}`).join(" ")
+            : "";
+        if (phase === "ready") {
+            const totalToReady = now - this.t0;
+            logger.info(`${PREFIX} phase=${phase} ms=${segmentMs} total_to_ready=${totalToReady}${extrasStr}`);
+            logger.info(`${PREFIX} SUMMARY total_to_ready=${totalToReady} decode=${this.decodeDuration} process=${this.processDuration} placements=${this.placements}`);
+        }
+        else {
+            logger.info(`${PREFIX} phase=${phase} ms=${segmentMs}${extrasStr}`);
+        }
+    }
+    /**
+     * Wrap the very first launch lookup call. Only the first invocation is
+     * instrumented; subsequent calls return immediately without logging.
+     *
+     * @param label  The campaign label being looked up.
+     * @param fn     The synchronous lookup function to time.
+     * @returns      The return value of `fn`.
+     */
+    firstLaunchLookup(label, fn) {
+        if (!this.enabled || this.firstLaunchLogged) {
+            return fn();
+        }
+        this.firstLaunchLogged = true;
+        const t = Date.now();
+        const result = fn();
+        const ms = Date.now() - t;
+        logger.info(`${PREFIX} phase=first_launch_lookup ms=${ms} label=${label}`);
+        return result;
+    }
+    /**
+     * Wrap the background server fetch. Logs duration and campaign count when
+     * the promise settles.
+     *
+     * @param fn  An async function that performs the server fetch.
+     * @returns   A promise that resolves/rejects with the same value as `fn`.
+     */
+    async serverFetch(fn) {
+        if (!this.enabled)
+            return fn();
+        const t = Date.now();
+        const result = await fn();
+        const ms = Date.now() - t;
+        logger.info(`${PREFIX} phase=server_fetch ms=${ms} campaigns=${result.length}`);
+        return result;
+    }
+}
+const startupTelemetry = new StartupTelemetry();
+
 class NamiRefs {
     constructor() {
         // In-memory flag for device registration failures (not persisted)
@@ -11996,7 +12117,9 @@ class NamiRefs {
             : this.initIdentifiedDevice(config);
         const splitPosition = audienceSplitPosition(deviceId);
         if (initialConfig.campaign_rules) {
-            storageService.setCampaignRules(exports.INITIAL_CAMPAIGN_RULES, mapAnonymousCampaigns(initialConfig.campaign_rules, splitPosition, currentFormFactor));
+            const mappedCampaigns = mapAnonymousCampaigns(initialConfig.campaign_rules, splitPosition, currentFormFactor);
+            storageService.setCampaignRules(exports.INITIAL_CAMPAIGN_RULES, mappedCampaigns);
+            startupTelemetry.mark("initial_processed", { count: mappedCampaigns.length });
         }
         if (deviceTask)
             await deviceTask;
@@ -12006,7 +12129,7 @@ class NamiRefs {
             ProductRepository.instance.fetchProducts(),
             CustomerJourneyRepository.instance.fetchCustomerJourneyState(),
             EntitlementRepository.instance.fetchActiveEntitlements(),
-            this.fetchCampaignsAndPaywalls(),
+            startupTelemetry.serverFetch(() => this.fetchCampaignsAndPaywalls()),
         ]).catch(async (error) => {
             if (error instanceof ConflictError) {
                 storageService.resetDevice();
@@ -12234,10 +12357,12 @@ class Nami {
      * @returns {Promise<NamiConfigurationState>}
      */
     static async configure(options) {
+        startupTelemetry.start();
         if (!options.appPlatformID) {
             throw new PlatformIDRequiredError();
         }
         this.setInitialConfig(options);
+        startupTelemetry.mark("initial_config_decoded");
         return await Nami.instance.initializeSDK(options);
     }
     static setInitialConfig(config) {
@@ -12316,6 +12441,7 @@ class Nami {
         logger.info("SDK successfully initialized!");
         const state = partialReconfig || fullReconfig ? exports.RECONFIG_SUCCESS : exports.INITIAL_SUCCESS;
         getPlatformAdapters().ui.postConfigure?.();
+        startupTelemetry.mark("ready");
         return {
             sdkInitialized: true,
             configureState: state,
@@ -12416,6 +12542,7 @@ exports.NamiFlowActionFunction = void 0;
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
+    NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
 })(exports.NamiFlowActionFunction || (exports.NamiFlowActionFunction = {}));
 const HandoffTag = {
     SEQUENCE: '__handoff_sequence__',
@@ -12999,6 +13126,16 @@ class FlowLiquidResolver {
                 const idx = screenState?.getSelectedSlideIndexForCurrentCarousel();
                 return idx != null ? `${idx + 1}` : undefined;
             }
+            case "productGroupId":
+                return PaywallState.currentProvider?.state.currentGroupId || undefined;
+            case "productGroupName": {
+                const s = PaywallState.currentProvider?.state;
+                return s?.groups?.find(g => g.id === s.currentGroupId)?.displayName ?? undefined;
+            }
+            case "productGroupRef": {
+                const s = PaywallState.currentProvider?.state;
+                return s?.groups?.find(g => g.id === s.currentGroupId)?.ref ?? undefined;
+            }
             default:
                 return undefined;
         }
@@ -13983,6 +14120,16 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(entry.id);
         }
     }
+    applyLaunchContextAttributes(attrs) {
+        if (!this.context) {
+            this.context = { customAttributes: {} };
+            new LaunchContextResolver(this.context);
+        }
+        // Guard against a runtime-supplied context that omits customAttributes
+        // (the field is required by the type but may be absent in untyped JSON).
+        this.context.customAttributes ??= {};
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14239,6 +14386,9 @@ class NamiFlow extends BasicNamiFlow {
                     this.back();
                     break;
                 case exports.NamiFlowActionFunction.NEXT:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         this.forward(action.parameters.step);
                     }
@@ -14247,6 +14397,9 @@ class NamiFlow extends BasicNamiFlow {
                     }
                     break;
                 case exports.NamiFlowActionFunction.NAVIGATE:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         if (this.previousFlowStep?.id === action.parameters.step) {
                             this.back();
@@ -14372,6 +14525,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case exports.NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes (matches the nav-action customAttributes wire shape
+                    // and the { key, value } shape used by Apple/Android/Roku). We deliberately
+                    // do NOT treat arbitrary top-level parameters as attributes, to avoid writing
+                    // reserved keys (step, delay, …) into the launch context.
+                    const params = action.parameters;
+                    if (params?.customAttributes) {
+                        this.applyLaunchContextAttributes(params.customAttributes);
+                    }
+                    else if (params?.key !== undefined && params?.value !== undefined) {
+                        this.applyLaunchContextAttributes({ [params.key]: params.value });
+                    }
+                    break;
+                }
                 default:
                     logger.warn(`Missing action handler for ${action.function}`, action);
                     break;
@@ -14599,7 +14766,7 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
             resultCallback(false, exports.LaunchCampaignError.SDK_NOT_INITIALIZED);
             throw new SDKNotInitializedError();
         }
-        const data = getPaywallDataFromLabel(value, type);
+        const data = startupTelemetry.firstLaunchLookup(value, () => getPaywallDataFromLabel(value, type));
         let paywall = data.paywall;
         const campaign = data.campaign;
         if (!campaign || (!paywall && !campaign.flow)) {
@@ -64295,6 +64462,29 @@ const convertLocale = (locale) => {
     return intlLocale.language + (intlLocale.region ?? intlLocale.script ?? '');
 };
 
+/**
+ * Coerces the four launch-context wire-format variants of a boolean —
+ * `true`, `false`, `"true"`, `"false"` — into a JS `boolean`.
+ *
+ * Returns `undefined` for everything else (case-variant strings, numbers,
+ * `null`, `undefined`, empty string, objects). Callers decide how to treat
+ * the `undefined` case; the helper deliberately does not coerce numerics or
+ * mixed-case strings so unintended truthy-by-presence behavior doesn't sneak
+ * back in.
+ */
+function coerceBooleanish(value) {
+    if (value === true || value === false) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        if (value === 'true')
+            return true;
+        if (value === 'false')
+            return false;
+    }
+    return undefined;
+}
+
 /**
  * Components that are skipped entirely (they and their subtree do not
  * contribute text to the page-level announcement).
@@ -64646,6 +64836,7 @@ exports.bestUrlCampaignMatch = bestUrlCampaignMatch;
 exports.bigintToUuid = bigintToUuid;
 exports.checkAnySkuHasPromoOffer = checkAnySkuHasPromoOffer;
 exports.checkAnySkuHasTrialOffer = checkAnySkuHasTrialOffer;
+exports.coerceBooleanish = coerceBooleanish;
 exports.convertISO8601PeriodToText = convertISO8601PeriodToText;
 exports.convertLocale = convertLocale;
 exports.convertOfferToPricingPhase = convertOfferToPricingPhase;

package/dist/index.d.ts

@@ -130,7 +130,8 @@ declare enum NamiFlowActionFunction {
     FLOW_DISABLED = "flowInteractionDisabled",
     SET_TAGS = "setTags",
     PAUSE = "flowPause",
-    RESUME = "flowResume"
+    RESUME = "flowResume",
+    SET_LAUNCH_CONTEXT = "setLaunchContext"
 }
 type NamiFlowHandoffStepHandler = (handoffTag: string, handoffData?: Record<string, any>) => void;
 type NamiFlowEventHandler = (eventHandler: Record<string, any>) => void;
@@ -1280,6 +1281,15 @@ type NamiPaywallEvent = {
     purchaseChannel?: string;
 };
 type NamiPaywallActionHandler = (event: NamiPaywallEvent) => void;
+/**
+ * Permitted value types for entries in {@link NamiPaywallLaunchContext.customAttributes}.
+ *
+ * Both native primitives and their string equivalents are accepted so integrators can
+ * pass `true`/`false` directly or `"true"`/`"false"` from a stringly-typed source
+ * (e.g. a remote-config blob). Targeting predicates treat the two wire formats
+ * identically — see `coerceBooleanish()`.
+ */
+type NamiCustomAttributeValue = string | boolean | number;
 /**
  * @type NamiPaywallLaunchContext
  * Will be used to pass custom context while launching paywall
@@ -1287,7 +1297,7 @@ type NamiPaywallActionHandler = (event: NamiPaywallEvent) => void;
 type NamiPaywallLaunchContext = {
     productGroups?: string[];
     customAttributes: {
-        [key: string]: string;
+        [key: string]: NamiCustomAttributeValue;
     };
     customObject?: {
         [key: string]: any;
@@ -1907,6 +1917,7 @@ declare class NamiFlow extends BasicNamiFlow {
         [timerId: string]: TimerState;
     };
     constructor(campaign: NamiFlowCampaign, paywall: PaywallHandle, manager: NamiFlowManager$2, context?: NamiPaywallLaunchContext);
+    private applyLaunchContextAttributes;
     private registerResolvers;
     get currentFlowStep(): NamiFlowStep | undefined;
     get nextStepAvailable(): boolean;
@@ -2555,6 +2566,7 @@ declare const EXTENDED_CLIENT_INFO_DELIMITER: string;
 declare const VALIDATE_PRODUCT_GROUPS: string;
 declare const LOG_HTTP_REQUESTS: string;
 declare const LOG_HTTP_TRAFFIC: string;
+declare const STARTUP_TELEMETRY: string;
 declare const EXTENDED_PLATFORM: string;
 declare const EXTENDED_PLATFORM_VERSION: string;
 declare const API_MAX_CALLS_LIMIT: number;
@@ -2643,6 +2655,18 @@ interface INamiRefsInstance {
  */
 declare function isAnonymousMode(): boolean;
 
+/**
+ * Coerces the four launch-context wire-format variants of a boolean —
+ * `true`, `false`, `"true"`, `"false"` — into a JS `boolean`.
+ *
+ * Returns `undefined` for everything else (case-variant strings, numbers,
+ * `null`, `undefined`, empty string, objects). Callers decide how to treat
+ * the `undefined` case; the helper deliberately does not coerce numerics or
+ * mixed-case strings so unintended truthy-by-presence behavior doesn't sneak
+ * back in.
+ */
+declare function coerceBooleanish(value: unknown): boolean | undefined;
+
 /**
  * Build the full-screen announcement string for a paywall page per the
  * TV Full-Page Announcement contract
@@ -3451,5 +3475,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_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$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, 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, 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, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, 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 { 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, 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, NamiCampaignManagerStatic, NamiCampaignSegment, NamiConfiguration, NamiConfigurationState, NamiCustomerManagerStatic, NamiEntitlement$1 as NamiEntitlement, NamiEntitlementManagerStatic, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowManagerStatic, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiInitialConfig, NamiLanguageCodes, NamiLogLevel, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPaywallManagerStatic, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchaseManagerStatic, 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 };
+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$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, 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, 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, coerceBooleanish, 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 { 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, 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, NamiCampaignManagerStatic, NamiCampaignSegment, NamiConfiguration, NamiConfigurationState, NamiCustomAttributeValue, NamiCustomerManagerStatic, NamiEntitlement$1 as NamiEntitlement, NamiEntitlementManagerStatic, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowManagerStatic, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiInitialConfig, NamiLanguageCodes, NamiLogLevel, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPaywallManagerStatic, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchaseManagerStatic, 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

@@ -94,9 +94,9 @@ var Capabilities;
 
 const { 
 // version — stamped by scripts/version.sh
-NAMI_SDK_VERSION = "3.4.1", 
+NAMI_SDK_VERSION = "3.4.2", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.1", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.2-dev.202605300214", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -106,7 +106,7 @@ 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", 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", 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, 
 // status codes
 STATUS_SUCCESS = 200, STATUS_BAD_REQUEST = 400, STATUS_NOT_FOUND = 404, STATUS_CONFLICT = 409, STATUS_INTERNAL_SERVER_ERROR = 500, 
 // configuration states
@@ -6801,6 +6801,10 @@ const shouldLogHTTPTraffic = () => {
     const namiCommands = storageService.getNamiConfig()?.namiCommands;
     return namiCommands?.includes(LOG_HTTP_TRAFFIC) ?? false;
 };
+const shouldLogStartupTelemetry = () => {
+    const namiCommands = storageService.getNamiConfig()?.namiCommands;
+    return namiCommands?.includes(STARTUP_TELEMETRY) ?? false;
+};
 function tryParseJson(str) {
     const trimmed = str.trim();
     if (!trimmed.startsWith("{") && !trimmed.startsWith("["))
@@ -11927,6 +11931,123 @@ class CustomerJourneyRepository {
 }
 CustomerJourneyRepository.instance = new CustomerJourneyRepository();
 
+const PREFIX = "[NamiStartup]";
+/**
+ * Module-level singleton for startup timing instrumentation.
+ *
+ * All methods are cheap no-ops when the `startupTelemetry` namiCommand flag
+ * is absent. The flag is read once at `start()` and cached; subsequent calls
+ * to `mark()` and the span helpers use that cached boolean so the hot path
+ * never hits storage.
+ *
+ * Log format (info level via the shared logger):
+ *   [NamiStartup] phase=<name> ms=<n>
+ *   [NamiStartup] SUMMARY total_to_ready=<ms> decode=<ms> process=<ms> placements=<n>
+ */
+class StartupTelemetry {
+    constructor() {
+        this.enabled = false;
+        this.t0 = 0;
+        this.lastMark = 0;
+        // Accumulated segment durations for the SUMMARY line
+        this.decodeDuration = 0;
+        this.processDuration = 0;
+        this.placements = 0;
+        // One-shot guard: only log the very first launch lookup
+        this.firstLaunchLogged = false;
+    }
+    /**
+     * Call at the first line of configure(). Reads the feature flag once and
+     * stores t0 if the flag is on.
+     */
+    start() {
+        this.enabled = shouldLogStartupTelemetry();
+        if (!this.enabled)
+            return;
+        this.t0 = Date.now();
+        this.lastMark = this.t0;
+        this.decodeDuration = 0;
+        this.processDuration = 0;
+        this.placements = 0;
+        this.firstLaunchLogged = false;
+    }
+    /**
+     * Log a named phase checkpoint.
+     *
+     * - Emits `[NamiStartup] phase=<name> ms=<segment> [extras]`
+     * - On phase `ready`: also emits `total_to_ready=<ms>` and a SUMMARY line.
+     * - On phase `initial_config_decoded`: records the decode segment.
+     * - On phase `initial_processed`: records the process segment + placement count.
+     *
+     * @param phase  Phase key string (e.g. "initial_config_decoded").
+     * @param extras Optional key/value pairs appended to the log line.
+     */
+    mark(phase, extras) {
+        if (!this.enabled)
+            return;
+        const now = Date.now();
+        const segmentMs = now - this.lastMark;
+        this.lastMark = now;
+        // Accumulate segment durations for SUMMARY
+        if (phase === "initial_config_decoded") {
+            this.decodeDuration = segmentMs;
+        }
+        else if (phase === "initial_processed") {
+            this.processDuration = segmentMs;
+            if (extras?.count !== undefined) {
+                this.placements = extras.count;
+            }
+        }
+        const extrasStr = extras
+            ? " " + Object.entries(extras).map(([k, v]) => `${k}=${v}`).join(" ")
+            : "";
+        if (phase === "ready") {
+            const totalToReady = now - this.t0;
+            logger.info(`${PREFIX} phase=${phase} ms=${segmentMs} total_to_ready=${totalToReady}${extrasStr}`);
+            logger.info(`${PREFIX} SUMMARY total_to_ready=${totalToReady} decode=${this.decodeDuration} process=${this.processDuration} placements=${this.placements}`);
+        }
+        else {
+            logger.info(`${PREFIX} phase=${phase} ms=${segmentMs}${extrasStr}`);
+        }
+    }
+    /**
+     * Wrap the very first launch lookup call. Only the first invocation is
+     * instrumented; subsequent calls return immediately without logging.
+     *
+     * @param label  The campaign label being looked up.
+     * @param fn     The synchronous lookup function to time.
+     * @returns      The return value of `fn`.
+     */
+    firstLaunchLookup(label, fn) {
+        if (!this.enabled || this.firstLaunchLogged) {
+            return fn();
+        }
+        this.firstLaunchLogged = true;
+        const t = Date.now();
+        const result = fn();
+        const ms = Date.now() - t;
+        logger.info(`${PREFIX} phase=first_launch_lookup ms=${ms} label=${label}`);
+        return result;
+    }
+    /**
+     * Wrap the background server fetch. Logs duration and campaign count when
+     * the promise settles.
+     *
+     * @param fn  An async function that performs the server fetch.
+     * @returns   A promise that resolves/rejects with the same value as `fn`.
+     */
+    async serverFetch(fn) {
+        if (!this.enabled)
+            return fn();
+        const t = Date.now();
+        const result = await fn();
+        const ms = Date.now() - t;
+        logger.info(`${PREFIX} phase=server_fetch ms=${ms} campaigns=${result.length}`);
+        return result;
+    }
+}
+const startupTelemetry = new StartupTelemetry();
+
 class NamiRefs {
     constructor() {
         // In-memory flag for device registration failures (not persisted)
@@ -11994,7 +12115,9 @@ class NamiRefs {
             : this.initIdentifiedDevice(config);
         const splitPosition = audienceSplitPosition(deviceId);
         if (initialConfig.campaign_rules) {
-            storageService.setCampaignRules(INITIAL_CAMPAIGN_RULES, mapAnonymousCampaigns(initialConfig.campaign_rules, splitPosition, currentFormFactor));
+            const mappedCampaigns = mapAnonymousCampaigns(initialConfig.campaign_rules, splitPosition, currentFormFactor);
+            storageService.setCampaignRules(INITIAL_CAMPAIGN_RULES, mappedCampaigns);
+            startupTelemetry.mark("initial_processed", { count: mappedCampaigns.length });
         }
         if (deviceTask)
             await deviceTask;
@@ -12004,7 +12127,7 @@ class NamiRefs {
             ProductRepository.instance.fetchProducts(),
             CustomerJourneyRepository.instance.fetchCustomerJourneyState(),
             EntitlementRepository.instance.fetchActiveEntitlements(),
-            this.fetchCampaignsAndPaywalls(),
+            startupTelemetry.serverFetch(() => this.fetchCampaignsAndPaywalls()),
         ]).catch(async (error) => {
             if (error instanceof ConflictError) {
                 storageService.resetDevice();
@@ -12232,10 +12355,12 @@ class Nami {
      * @returns {Promise<NamiConfigurationState>}
      */
     static async configure(options) {
+        startupTelemetry.start();
         if (!options.appPlatformID) {
             throw new PlatformIDRequiredError();
         }
         this.setInitialConfig(options);
+        startupTelemetry.mark("initial_config_decoded");
         return await Nami.instance.initializeSDK(options);
     }
     static setInitialConfig(config) {
@@ -12314,6 +12439,7 @@ class Nami {
         logger.info("SDK successfully initialized!");
         const state = partialReconfig || fullReconfig ? RECONFIG_SUCCESS : INITIAL_SUCCESS;
         getPlatformAdapters().ui.postConfigure?.();
+        startupTelemetry.mark("ready");
         return {
             sdkInitialized: true,
             configureState: state,
@@ -12414,6 +12540,7 @@ var NamiFlowActionFunction;
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
+    NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
 })(NamiFlowActionFunction || (NamiFlowActionFunction = {}));
 const HandoffTag = {
     SEQUENCE: '__handoff_sequence__',
@@ -12997,6 +13124,16 @@ class FlowLiquidResolver {
                 const idx = screenState?.getSelectedSlideIndexForCurrentCarousel();
                 return idx != null ? `${idx + 1}` : undefined;
             }
+            case "productGroupId":
+                return PaywallState.currentProvider?.state.currentGroupId || undefined;
+            case "productGroupName": {
+                const s = PaywallState.currentProvider?.state;
+                return s?.groups?.find(g => g.id === s.currentGroupId)?.displayName ?? undefined;
+            }
+            case "productGroupRef": {
+                const s = PaywallState.currentProvider?.state;
+                return s?.groups?.find(g => g.id === s.currentGroupId)?.ref ?? undefined;
+            }
             default:
                 return undefined;
         }
@@ -13981,6 +14118,16 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(entry.id);
         }
     }
+    applyLaunchContextAttributes(attrs) {
+        if (!this.context) {
+            this.context = { customAttributes: {} };
+            new LaunchContextResolver(this.context);
+        }
+        // Guard against a runtime-supplied context that omits customAttributes
+        // (the field is required by the type but may be absent in untyped JSON).
+        this.context.customAttributes ??= {};
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14237,6 +14384,9 @@ class NamiFlow extends BasicNamiFlow {
                     this.back();
                     break;
                 case NamiFlowActionFunction.NEXT:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         this.forward(action.parameters.step);
                     }
@@ -14245,6 +14395,9 @@ class NamiFlow extends BasicNamiFlow {
                     }
                     break;
                 case NamiFlowActionFunction.NAVIGATE:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         if (this.previousFlowStep?.id === action.parameters.step) {
                             this.back();
@@ -14370,6 +14523,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes (matches the nav-action customAttributes wire shape
+                    // and the { key, value } shape used by Apple/Android/Roku). We deliberately
+                    // do NOT treat arbitrary top-level parameters as attributes, to avoid writing
+                    // reserved keys (step, delay, …) into the launch context.
+                    const params = action.parameters;
+                    if (params?.customAttributes) {
+                        this.applyLaunchContextAttributes(params.customAttributes);
+                    }
+                    else if (params?.key !== undefined && params?.value !== undefined) {
+                        this.applyLaunchContextAttributes({ [params.key]: params.value });
+                    }
+                    break;
+                }
                 default:
                     logger.warn(`Missing action handler for ${action.function}`, action);
                     break;
@@ -14597,7 +14764,7 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
             resultCallback(false, LaunchCampaignError.SDK_NOT_INITIALIZED);
             throw new SDKNotInitializedError();
         }
-        const data = getPaywallDataFromLabel(value, type);
+        const data = startupTelemetry.firstLaunchLookup(value, () => getPaywallDataFromLabel(value, type));
         let paywall = data.paywall;
         const campaign = data.campaign;
         if (!campaign || (!paywall && !campaign.flow)) {
@@ -64293,6 +64460,29 @@ const convertLocale = (locale) => {
     return intlLocale.language + (intlLocale.region ?? intlLocale.script ?? '');
 };
 
+/**
+ * Coerces the four launch-context wire-format variants of a boolean —
+ * `true`, `false`, `"true"`, `"false"` — into a JS `boolean`.
+ *
+ * Returns `undefined` for everything else (case-variant strings, numbers,
+ * `null`, `undefined`, empty string, objects). Callers decide how to treat
+ * the `undefined` case; the helper deliberately does not coerce numerics or
+ * mixed-case strings so unintended truthy-by-presence behavior doesn't sneak
+ * back in.
+ */
+function coerceBooleanish(value) {
+    if (value === true || value === false) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        if (value === 'true')
+            return true;
+        if (value === 'false')
+            return false;
+    }
+    return undefined;
+}
+
 /**
  * Components that are skipped entirely (they and their subtree do not
  * contribute text to the page-level announcement).
@@ -64578,4 +64768,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_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$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, 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, 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, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, 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$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, 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, 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, coerceBooleanish, 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.1",
+  "version": "3.4.2-dev.202605300214",
   "description": "Platform-agnostic core for the Nami SDK — business logic, API, types, and state management",
   "type": "module",
   "main": "./dist/index.cjs",