@namiml/sdk-core 3.4.3-dev.202606120301 → 3.4.3-dev.202606121502

package/dist/index.cjs

@@ -98,7 +98,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.3", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606120301", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606121502", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -6803,10 +6803,6 @@ 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("["))
@@ -11944,9 +11940,10 @@ 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.
+ * is absent. The flag is read once at `start()` from the namiCommands passed
+ * to the current configure() call — NOT from persisted storage, which still
+ * holds the previous run's config at that point (NAM-1876) — and cached;
+ * subsequent calls to `mark()` and the span helpers use that cached boolean.
  *
  * Log format (info level via the shared logger):
  *   [NamiStartup] phase=<name> ms=<n>
@@ -11965,11 +11962,13 @@ class StartupTelemetry {
         this.firstLaunchLogged = false;
     }
     /**
-     * Call at the first line of configure(). Reads the feature flag once and
-     * stores t0 if the flag is on.
+     * Call at the first line of configure(), passing the incoming config's
+     * namiCommands. Reads the feature flag once and stores t0 if the flag is on.
+     *
+     * @param namiCommands The `namiCommands` from the current configure() options.
      */
-    start() {
-        this.enabled = shouldLogStartupTelemetry();
+    start(namiCommands) {
+        this.enabled = namiCommands?.includes(exports.STARTUP_TELEMETRY) ?? false;
         if (!this.enabled)
             return;
         this.t0 = Date.now();
@@ -12363,7 +12362,7 @@ class Nami {
      * @returns {Promise<NamiConfigurationState>}
      */
     static async configure(options) {
-        startupTelemetry.start();
+        startupTelemetry.start(options.namiCommands);
         if (!options.appPlatformID) {
             throw new PlatformIDRequiredError();
         }
@@ -12548,6 +12547,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__',
@@ -12692,89 +12692,33 @@ class NamiConditionEvaluator {
                 return true;
             return false;
         }
-        // this.log(
-        //   `Evaluating filter: ${filter.operator} with values: ${filter.values} against resolved value: ${JSON.stringify(resolvedValue)}`
-        // );
         switch (filter.operator) {
             case FilterOperator.I_CONTAINS:
                 if (Array.isArray(resolvedValue)) {
-                    const result = filter.values.some(expected => {
-                        const expectedStr = String(expected);
-                        return resolvedValue.some(item => item.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) === 0);
-                    });
-                    // this.log(`i_contains evaluation result: ${result}`);
+                    const result = filter.values.some(expected => typeof expected === 'string' && resolvedValue.some(item => item.localeCompare(expected, undefined, { sensitivity: 'accent' }) === 0));
                     return result;
                 }
                 this.log('Resolved value is not an array of strings for i_contains.');
                 return false;
             case FilterOperator.EQUALS: {
-                const result = filter.values.some(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        // this.log(`Comparing string ${resolvedValue} == ${expected}`);
-                        return resolvedValue === expectedStr;
-                    }
-                    if (typeof resolvedValue === 'boolean') {
-                        const expectedBool = expectedStr.toLowerCase() === 'true';
-                        // this.log(`Comparing boolean ${resolvedValue} == ${expectedBool}`);
-                        return resolvedValue === expectedBool;
-                    }
-                    this.log(`Unsupported type for equals comparison: ${typeof resolvedValue}`);
-                    return false;
-                });
-                // this.log(`equals evaluation result: ${result}`);
-                return result;
+                return filter.values.some(expected => this.strictEquals(resolvedValue, expected, false));
             }
             case FilterOperator.I_EQUALS: {
-                const result = filter.values.some(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        const match = resolvedValue.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) === 0;
-                        // this.log(`Comparing string ${resolvedValue} ~= ${expected}: ${match}`);
-                        return match;
-                    }
-                    if (typeof resolvedValue === 'boolean') {
-                        const expectedBool = expectedStr.toLowerCase() === 'true';
-                        // this.log(`Comparing boolean ${resolvedValue} ~= ${expectedBool}`);
-                        return resolvedValue === expectedBool;
-                    }
-                    this.log(`Unsupported type for i_equals comparison: ${typeof resolvedValue}`);
-                    return false;
-                });
-                // this.log(`i_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.some(expected => this.strictEquals(resolvedValue, expected, true));
             }
             case FilterOperator.NOT_EQUALS: {
-                const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return resolvedValue !== expectedStr;
-                    }
-                    return true;
-                });
-                // this.log(`not_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, false));
             }
             case FilterOperator.NOT_I_EQUALS: {
-                const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return (resolvedValue.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) !== 0);
-                    }
-                    return true;
-                });
-                // this.log(`not_i_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, true));
             }
             case FilterOperator.NOT_CONTAINS: {
                 const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return !resolvedValue.includes(expectedStr);
+                    if (typeof resolvedValue === 'string' && typeof expected === 'string') {
+                        return !resolvedValue.includes(expected);
                     }
                     return true;
                 });
-                // this.log(`not_contains evaluation result: ${result}`);
                 return result;
             }
             case FilterOperator.GREATER_THAN:
@@ -12803,6 +12747,21 @@ class NamiConditionEvaluator {
                 return false;
         }
     }
+    /** Type-strict equality: string↔string (optionally case-insensitive), boolean↔boolean, or number↔number. */
+    strictEquals(resolved, expected, caseInsensitive) {
+        if (typeof resolved === 'string' && typeof expected === 'string') {
+            return caseInsensitive
+                ? resolved.localeCompare(expected, undefined, { sensitivity: 'accent' }) === 0
+                : resolved === expected;
+        }
+        if (typeof resolved === 'boolean' && typeof expected === 'boolean') {
+            return resolved === expected;
+        }
+        if (typeof resolved === 'number' && typeof expected === 'number') {
+            return resolved === expected;
+        }
+        return false;
+    }
     resolve(identifier) {
         const exact = this.resolveRaw(identifier);
         if (exact !== undefined) {
@@ -12865,7 +12824,6 @@ class NamiConditionEvaluator {
                 }
                 break;
             default:
-                // this.log(`Unsupported property: .${property}`);
                 return undefined;
         }
         this.log(`Could not extract .${property} from type ${typeof baseValue}`);
@@ -14172,6 +14130,17 @@ 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 ??= {};
+        // New values win: merge attrs over existing entries.
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14428,6 +14397,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);
                     }
@@ -14436,6 +14408,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();
@@ -14561,6 +14536,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case exports.NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes: { customAttributes: {...} } (nav-action wire shape)
+                    // and { key, value } (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;

package/dist/index.d.ts

@@ -102,7 +102,7 @@ type FilterOperator = (typeof FilterOperator)[keyof typeof FilterOperator];
 interface NamiConditionFilter {
     identifier: string;
     operator: FilterOperator;
-    values: (string | number)[];
+    values: (string | boolean | number)[];
 }
 interface NamiConditions {
     filter?: NamiConditionFilter[];
@@ -134,7 +134,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;
@@ -1303,6 +1304,14 @@ type NamiPaywallEvent = {
     purchaseChannel?: string;
 };
 type NamiPaywallActionHandler = (event: NamiPaywallEvent) => void;
+/**
+ * Permitted value types for entries in {@link NamiPaywallLaunchContext.customAttributes}.
+ *
+ * Values are matched strictly by type: the string "true" and the boolean true are
+ * distinct values that never compare equal. A key present with any non-null value —
+ * including false or "false" — is considered "set".
+ */
+type NamiCustomAttributeValue = string | boolean | number;
 /**
  * @type NamiPaywallLaunchContext
  * Will be used to pass custom context while launching paywall
@@ -1310,7 +1319,7 @@ type NamiPaywallActionHandler = (event: NamiPaywallEvent) => void;
 type NamiPaywallLaunchContext = {
     productGroups?: string[];
     customAttributes: {
-        [key: string]: string;
+        [key: string]: NamiCustomAttributeValue;
     };
     customObject?: {
         [key: string]: any;
@@ -1930,6 +1939,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;
@@ -3062,6 +3072,8 @@ declare class NamiConditionEvaluator {
     evaluate(conditions: NamiConditions): boolean;
     evaluateOrdered(conditions?: NamiConditions): boolean;
     private evaluateFilter;
+    /** Type-strict equality: string↔string (optionally case-insensitive), boolean↔boolean, or number↔number. */
+    private strictEquals;
     private resolve;
     private resolveRaw;
     private extractProperty;
@@ -3476,4 +3488,4 @@ 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, 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, 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, TTimelineRail, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };
+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, TTimelineRail, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };

package/dist/index.mjs

@@ -96,7 +96,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.3", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606120301", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606121502", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -6801,10 +6801,6 @@ 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("["))
@@ -11942,9 +11938,10 @@ 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.
+ * is absent. The flag is read once at `start()` from the namiCommands passed
+ * to the current configure() call — NOT from persisted storage, which still
+ * holds the previous run's config at that point (NAM-1876) — and cached;
+ * subsequent calls to `mark()` and the span helpers use that cached boolean.
  *
  * Log format (info level via the shared logger):
  *   [NamiStartup] phase=<name> ms=<n>
@@ -11963,11 +11960,13 @@ class StartupTelemetry {
         this.firstLaunchLogged = false;
     }
     /**
-     * Call at the first line of configure(). Reads the feature flag once and
-     * stores t0 if the flag is on.
+     * Call at the first line of configure(), passing the incoming config's
+     * namiCommands. Reads the feature flag once and stores t0 if the flag is on.
+     *
+     * @param namiCommands The `namiCommands` from the current configure() options.
      */
-    start() {
-        this.enabled = shouldLogStartupTelemetry();
+    start(namiCommands) {
+        this.enabled = namiCommands?.includes(STARTUP_TELEMETRY) ?? false;
         if (!this.enabled)
             return;
         this.t0 = Date.now();
@@ -12361,7 +12360,7 @@ class Nami {
      * @returns {Promise<NamiConfigurationState>}
      */
     static async configure(options) {
-        startupTelemetry.start();
+        startupTelemetry.start(options.namiCommands);
         if (!options.appPlatformID) {
             throw new PlatformIDRequiredError();
         }
@@ -12546,6 +12545,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__',
@@ -12690,89 +12690,33 @@ class NamiConditionEvaluator {
                 return true;
             return false;
         }
-        // this.log(
-        //   `Evaluating filter: ${filter.operator} with values: ${filter.values} against resolved value: ${JSON.stringify(resolvedValue)}`
-        // );
         switch (filter.operator) {
             case FilterOperator.I_CONTAINS:
                 if (Array.isArray(resolvedValue)) {
-                    const result = filter.values.some(expected => {
-                        const expectedStr = String(expected);
-                        return resolvedValue.some(item => item.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) === 0);
-                    });
-                    // this.log(`i_contains evaluation result: ${result}`);
+                    const result = filter.values.some(expected => typeof expected === 'string' && resolvedValue.some(item => item.localeCompare(expected, undefined, { sensitivity: 'accent' }) === 0));
                     return result;
                 }
                 this.log('Resolved value is not an array of strings for i_contains.');
                 return false;
             case FilterOperator.EQUALS: {
-                const result = filter.values.some(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        // this.log(`Comparing string ${resolvedValue} == ${expected}`);
-                        return resolvedValue === expectedStr;
-                    }
-                    if (typeof resolvedValue === 'boolean') {
-                        const expectedBool = expectedStr.toLowerCase() === 'true';
-                        // this.log(`Comparing boolean ${resolvedValue} == ${expectedBool}`);
-                        return resolvedValue === expectedBool;
-                    }
-                    this.log(`Unsupported type for equals comparison: ${typeof resolvedValue}`);
-                    return false;
-                });
-                // this.log(`equals evaluation result: ${result}`);
-                return result;
+                return filter.values.some(expected => this.strictEquals(resolvedValue, expected, false));
             }
             case FilterOperator.I_EQUALS: {
-                const result = filter.values.some(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        const match = resolvedValue.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) === 0;
-                        // this.log(`Comparing string ${resolvedValue} ~= ${expected}: ${match}`);
-                        return match;
-                    }
-                    if (typeof resolvedValue === 'boolean') {
-                        const expectedBool = expectedStr.toLowerCase() === 'true';
-                        // this.log(`Comparing boolean ${resolvedValue} ~= ${expectedBool}`);
-                        return resolvedValue === expectedBool;
-                    }
-                    this.log(`Unsupported type for i_equals comparison: ${typeof resolvedValue}`);
-                    return false;
-                });
-                // this.log(`i_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.some(expected => this.strictEquals(resolvedValue, expected, true));
             }
             case FilterOperator.NOT_EQUALS: {
-                const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return resolvedValue !== expectedStr;
-                    }
-                    return true;
-                });
-                // this.log(`not_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, false));
             }
             case FilterOperator.NOT_I_EQUALS: {
-                const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return (resolvedValue.localeCompare(expectedStr, undefined, { sensitivity: 'accent' }) !== 0);
-                    }
-                    return true;
-                });
-                // this.log(`not_i_equals evaluation result: ${result}`);
-                return result;
+                return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, true));
             }
             case FilterOperator.NOT_CONTAINS: {
                 const result = filter.values.every(expected => {
-                    const expectedStr = String(expected);
-                    if (typeof resolvedValue === 'string') {
-                        return !resolvedValue.includes(expectedStr);
+                    if (typeof resolvedValue === 'string' && typeof expected === 'string') {
+                        return !resolvedValue.includes(expected);
                     }
                     return true;
                 });
-                // this.log(`not_contains evaluation result: ${result}`);
                 return result;
             }
             case FilterOperator.GREATER_THAN:
@@ -12801,6 +12745,21 @@ class NamiConditionEvaluator {
                 return false;
         }
     }
+    /** Type-strict equality: string↔string (optionally case-insensitive), boolean↔boolean, or number↔number. */
+    strictEquals(resolved, expected, caseInsensitive) {
+        if (typeof resolved === 'string' && typeof expected === 'string') {
+            return caseInsensitive
+                ? resolved.localeCompare(expected, undefined, { sensitivity: 'accent' }) === 0
+                : resolved === expected;
+        }
+        if (typeof resolved === 'boolean' && typeof expected === 'boolean') {
+            return resolved === expected;
+        }
+        if (typeof resolved === 'number' && typeof expected === 'number') {
+            return resolved === expected;
+        }
+        return false;
+    }
     resolve(identifier) {
         const exact = this.resolveRaw(identifier);
         if (exact !== undefined) {
@@ -12863,7 +12822,6 @@ class NamiConditionEvaluator {
                 }
                 break;
             default:
-                // this.log(`Unsupported property: .${property}`);
                 return undefined;
         }
         this.log(`Could not extract .${property} from type ${typeof baseValue}`);
@@ -14170,6 +14128,17 @@ 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 ??= {};
+        // New values win: merge attrs over existing entries.
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14426,6 +14395,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);
                     }
@@ -14434,6 +14406,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();
@@ -14559,6 +14534,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes: { customAttributes: {...} } (nav-action wire shape)
+                    // and { key, value } (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;

package/package.json

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