@namiml/sdk-core 3.4.3-dev.202606180014 → 3.4.3-dev.202606181527

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.202606180014", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606181527", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -3193,6 +3193,22 @@ class StorageService {
             .filter(key => key.includes(exports.CUSTOMER_ATTRIBUTES_KEY_PREFIX))
             .map(key => key.replace(exports.CUSTOMER_ATTRIBUTES_KEY_PREFIX, ""));
     }
+    /**
+     * All persisted customer attributes as a `{ key: value }` map. Used to seed
+     * `PaywallState.customer` when a paywall screen initializes, so attributes set
+     * on an earlier flow screen (e.g. via setTagsFromForm) are available to the
+     * `${customer.x}` smart-text resolver on subsequent screens.
+     */
+    getAllCustomerAttributesMap() {
+        const out = {};
+        this.getAllCustomerAttributesKeys().forEach((key) => {
+            const value = this.getCustomerAttribute(key);
+            if (value !== null && value !== undefined) {
+                out[key] = String(value);
+            }
+        });
+        return out;
+    }
     clearCustomerAttribute(attribute) {
         const key = exports.CUSTOMER_ATTRIBUTES_KEY_PREFIX + attribute;
         const itemExists = this.getItem(key);
@@ -11317,6 +11333,8 @@ const initialState = {
     groups: [],
     selectedProducts: {},
     formStates: {},
+    formFieldErrors: {},
+    formFieldValidators: {},
     timerStates: {},
     currentPage: 'page1',
     pageHistory: ['page1'],
@@ -11419,6 +11437,11 @@ class PaywallState extends SimpleEventTarget {
         this.state = cloneDeep(initialState);
         const profile = storageService.getNamiProfile();
         this.state.isLoggedIn = !!profile?.externalId;
+        // Seed customer attributes persisted on earlier screens (e.g. via
+        // setTagsFromForm / setTags) so `${customer.x}` smart text resolves on every
+        // flow screen — each screen builds a fresh provider, so without this the
+        // value captured on page 1 would be invisible on page 2.
+        this.state.customer = { ...this.state.customer, ...storageService.getAllCustomerAttributesMap() };
         this.setPaywall(paywall, context, campaign);
         this.subscribers = new Set();
     }
@@ -11456,6 +11479,41 @@ class PaywallState extends SimpleEventTarget {
     setFormState(formId, state) {
         this.setState({ ...this.state, formStates: { ...this.state.formStates, [formId]: state } });
     }
+    /**
+     * Register the validator for a text-input field (keyed by formId). Used by the
+     * implicit form-submit gate in NamiFlow.triggerActions and by the web element
+     * when it mounts.
+     */
+    registerFormFieldValidator(formId, validator) {
+        this.setState({
+            ...this.state,
+            formFieldValidators: { ...this.state.formFieldValidators, [formId]: validator },
+        });
+    }
+    getFormFieldValidators() {
+        return this.state.formFieldValidators;
+    }
+    /**
+     * Replace the full set of field errors (formId → message). The gate writes the
+     * result of validateForm here; an empty map clears all errors.
+     */
+    setFormFieldErrors(errors) {
+        this.setState({ ...this.state, formFieldErrors: { ...errors } });
+    }
+    setFormFieldError(formId, message) {
+        this.setState({
+            ...this.state,
+            formFieldErrors: { ...this.state.formFieldErrors, [formId]: message },
+        });
+    }
+    clearFormFieldError(formId) {
+        const nextErrors = { ...this.state.formFieldErrors };
+        delete nextErrors[formId];
+        this.setState({ ...this.state, formFieldErrors: nextErrors });
+    }
+    getFormFieldErrors() {
+        return this.state.formFieldErrors;
+    }
     setTimerState(timerId, remainingSeconds, savedAt, hasEmittedCompletion) {
         this.setState({
             ...this.state,
@@ -11674,7 +11732,12 @@ class PaywallState extends SimpleEventTarget {
         this.emitEvent('user-interaction-changed', { enabled });
     }
     setUserTags(tags) {
-        this.setState({ ...this.state, userTags: { ...this.state.userTags, ...tags } });
+        // User tags ARE customer attributes for personalization — they must land in
+        // `state.customer`, the store the `${customer.x}` smart-text resolver reads
+        // (see valueFromSmartText: replacements.customer = state.customer). Writing a
+        // separate `state.userTags` (read nowhere) meant setTags / setTagsFromForm
+        // values never reached `${customer.firstName}` on a subsequent flow page.
+        this.setState({ ...this.state, customer: { ...this.state.customer, ...tags } });
     }
     setCurrentSlideIndex(index) {
         this.setState({ ...this.state, currentSlideIndex: index });
@@ -12551,6 +12614,7 @@ exports.NamiFlowActionFunction = void 0;
     NamiFlowActionFunction["FLOW_ENABLED"] = "flowInteractionEnabled";
     NamiFlowActionFunction["FLOW_DISABLED"] = "flowInteractionDisabled";
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
+    NamiFlowActionFunction["SET_TAGS_FROM_FORM"] = "setTagsFromForm";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
     NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
@@ -13077,6 +13141,42 @@ class URLParams {
 URLParams._instance = null;
 const getUrlParams = () => URLParams.instance.params;
 
+/**
+ * Coerce a single form-state value to the string form used by tags / customer
+ * attributes / `{{ form.x }}` interpolation. Shared by the `setTagsFromForm`
+ * flow action and FlowLiquidResolver so they stay in lockstep.
+ *
+ * Rules (order matters — Boolean is checked before number):
+ *  - `null` / `undefined` → skip (returns `undefined`)
+ *  - empty string `""` → skip
+ *  - `false` → "false", `true` → "true" (booleans are kept)
+ *  - `0` → "0" (zero is kept)
+ *  - integral number → no trailing ".0" (e.g. 3 → "3", 3.5 → "3.5")
+ *  - everything else → String(value)
+ */
+function formTagValue(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (value === '') {
+        return undefined;
+    }
+    // Boolean BEFORE number: typeof true !== 'number', but be explicit so the
+    // intent (and the false→"false" / true→"true" mapping) is unmistakable.
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            return undefined;
+        }
+        // JS `String` already renders integers without a trailing ".0"
+        // (3 → "3", 3.5 → "3.5"), which is exactly the contract we want.
+        return String(value);
+    }
+    return String(value);
+}
+
 const LIQUID_VAR_REGEX = /\{\{\s*([^}]+?)\s*\}\}/g;
 /**
  * Resolver for liquid-style flow variables, without requiring namespace prefixes.
@@ -13101,6 +13201,13 @@ class FlowLiquidResolver {
             }
             return undefined;
         }
+        // Handle form field paths: {{ form.fieldId }} reads the live form state and
+        // coerces it through the same helper used by setTagsFromForm.
+        if (key.startsWith("form.")) {
+            const fieldId = key.substring("form.".length);
+            const value = PaywallState.currentProvider?.state.formStates[fieldId];
+            return formTagValue(value);
+        }
         switch (key) {
             case "campaignId":
                 return screenState?.campaign?.rule;
@@ -14102,6 +14209,67 @@ let NamiCustomerManager$2 = class NamiCustomerManager {
 };
 NamiCustomerManager$2.instance = new NamiCustomerManager$2();
 
+/**
+ * Pure, platform-agnostic text-input validation. Shared by the flow submit gate
+ * (sdk/core) and the web Lit element (sdk/web). The rules are identical to the
+ * Apple (NAM-1142) and Android (NAM-1143) ports.
+ */
+const DEFAULT_MESSAGES = {
+    required: 'This field is required',
+    email: 'Please enter a valid email address',
+    name: 'Please enter at least 2 characters',
+};
+/**
+ * An email must contain an `@` and a domain with a dot, e.g. `a@b.co`.
+ * `a@b` (no dotted domain) and `nope` (no `@`) are invalid.
+ */
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Validate a single field. Returns `undefined` when valid, otherwise a default
+ * error message for the failing rule. Callers that want author-supplied text
+ * should use {@link validateForm}.
+ *
+ * Rules:
+ *  - required && blank → invalid
+ *  - email && non-blank && not email-format → invalid
+ *  - name && non-blank && len < 2 → invalid
+ *  - freeText → only the required rule applies
+ */
+function validateTextInput(type, required, value) {
+    const text = typeof value === 'string' ? value : value == null ? '' : String(value);
+    const trimmed = text.trim();
+    if (required && trimmed.length === 0) {
+        return DEFAULT_MESSAGES.required;
+    }
+    if (trimmed.length === 0) {
+        // Blank optional value: no format rule applies.
+        return undefined;
+    }
+    if (type === 'email' && !EMAIL_REGEX.test(trimmed)) {
+        return DEFAULT_MESSAGES.email;
+    }
+    if (type === 'name' && trimmed.length < 2) {
+        return DEFAULT_MESSAGES.name;
+    }
+    return undefined;
+}
+/**
+ * Validate every registered field against the current form state. Returns a map
+ * of `formId → error message` for invalid fields only (valid fields are omitted).
+ * The validator's own `message` is preferred; otherwise the per-rule default
+ * from {@link validateTextInput} is used.
+ */
+function validateForm(validators, formStates) {
+    const errors = {};
+    for (const [formId, validator] of Object.entries(validators)) {
+        const defaultError = validateTextInput(validator.type, validator.required, formStates[formId]);
+        if (defaultError !== undefined) {
+            errors[formId] = validator.message ?? defaultError;
+        }
+    }
+    return errors;
+}
+
 class BasicNamiFlow {
     constructor(flowObject = {}) {
         this.id = flowObject.id ?? '';
@@ -14333,12 +14501,40 @@ class NamiFlow extends BasicNamiFlow {
         }
         return lifecycles;
     }
+    /**
+     * A lifecycle chain is a "form submit" if any phase (before/action/after) runs
+     * one of the advancing functions: setTagsFromForm, flowNext, or flowNav. The
+     * POC submit buttons use flowNext/flowNav (no dedicated submit action), so the
+     * gate keys off these. Close/dismiss/back/pause are deliberately excluded —
+     * they must never be blocked by validation. Mirrors Apple
+     * NamiFlowControl.isFormSubmitLifecycle / Android NamiFlow.isFormSubmitLifecycle.
+     */
+    isFormSubmitLifecycle(lifecycles) {
+        const submitFns = [
+            exports.NamiFlowActionFunction.SET_TAGS_FROM_FORM,
+            exports.NamiFlowActionFunction.NEXT,
+            exports.NamiFlowActionFunction.NAVIGATE,
+        ];
+        return lifecycles.some(cycle => [cycle.before, cycle.action, cycle.after].some(actions => actions?.some(action => submitFns.includes(action.function))));
+    }
     triggerActions(actionId, component, data) {
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
         this.flowLog(`triggerActions(${actionId}) — step=${this.currentFlowStep?.id}, isPaused=${this.isPaused}`);
         this.currentButton = component;
+        // Implicit form-submit validation gate (the NAM-1143 on-device lesson).
+        // When this action advances the flow and validators are registered, validate
+        // first; write the errors and halt the chain if any field is invalid.
+        const validators = PaywallState.currentProvider?.state.formFieldValidators ?? {};
+        if (this.isFormSubmitLifecycle(lifecycles) && Object.keys(validators).length) {
+            const errors = validateForm(validators, this.getFormData());
+            PaywallState.currentProvider?.setFormFieldErrors(errors);
+            if (Object.keys(errors).length) {
+                this.flowLog(`triggerActions(${actionId}) — HALTED by form validation: ${JSON.stringify(errors)}`);
+                return;
+            }
+        }
         this.executeFullLifecycles(lifecycles, data);
     }
     executeFullLifecycles(lifecycles, data) {
@@ -14545,6 +14741,22 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case exports.NamiFlowActionFunction.SET_TAGS_FROM_FORM: {
+                    const formData = this.getFormData();
+                    const tags = {};
+                    Object.entries(formData).forEach(([key, raw]) => {
+                        const value = formTagValue(raw);
+                        if (value === undefined) {
+                            return; // skip null / "" (false and 0 are kept by formTagValue)
+                        }
+                        tags[key] = value;
+                        NamiCustomerManager$2.setCustomerAttribute(key, value);
+                    });
+                    if (Object.keys(tags).length) {
+                        PaywallState.setUserTags(tags);
+                    }
+                    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
@@ -64908,4 +65120,6 @@ exports.tryParseB64Gzip = tryParseB64Gzip;
 exports.tryParseJson = tryParseJson;
 exports.updateRelatedSKUsForNamiEntitlement = updateRelatedSKUsForNamiEntitlement;
 exports.uuidFromSplitPosition = uuidFromSplitPosition;
+exports.validateForm = validateForm;
 exports.validateMinSDKVersion = validateMinSDKVersion;
+exports.validateTextInput = validateTextInput;

package/dist/index.d.ts

@@ -133,6 +133,7 @@ declare enum NamiFlowActionFunction {
     FLOW_ENABLED = "flowInteractionEnabled",
     FLOW_DISABLED = "flowInteractionDisabled",
     SET_TAGS = "setTags",
+    SET_TAGS_FROM_FORM = "setTagsFromForm",
     PAUSE = "flowPause",
     RESUME = "flowResume",
     SET_LAUNCH_CONTEXT = "setLaunchContext"
@@ -553,6 +554,36 @@ type TToggleButtonComponent = TBaseComponent & {
     mode?: "radio" | "toggle";
     value?: string;
 };
+type TTextInputComponent = TBaseComponent & {
+    component: "textInput";
+    type?: "name" | "email";
+    formId: string;
+    /** Required flag — the real (misspelled) wire key. `required` never populates. */
+    reqed?: boolean;
+    validateOn?: "submit" | "change";
+    placeholderText?: string;
+    placeholderFontColor?: string;
+    labelText?: string;
+    labelPosition?: "top" | "none";
+    labelFontColor?: string;
+    labelFontName?: string;
+    labelFontSize?: number | string;
+    validationMessage?: string;
+    validationTextFontColor?: string;
+    validationTextFontName?: string;
+    validationTextFontSize?: number | string;
+    fontColor?: string;
+    fontName?: string;
+    fontSize?: number | string;
+    errorBorderColor?: string;
+    errorBorderWidth?: number | string;
+    errorBorderRadius?: number | string;
+    innerTopPadding?: number | string;
+    innerBottomPadding?: number | string;
+    innerLeftPadding?: number | string;
+    innerRightPadding?: number | string;
+    showPrefixIcon?: boolean;
+};
 type TCountdownTimerTextComponent = TBaseComponent & {
     component: "countdownTimerText";
     mode?: "duration" | "targetDateTime";
@@ -885,7 +916,7 @@ interface TBaseComponent {
     hidden?: boolean;
     animation?: NamiAnimationSpec;
 }
-type TComponent = TButtonContainer | TContainer | TTextListComponent | TTextComponent | TSpacerComponent | TImageComponent | TSvgImageComponent | TSymbolComponent | TCarouselContainer | TProductContainer | TFlexProductContainer | TStack | TConditionalComponent | TSegmentPicker | TSegmentPickerItem | TVideoComponent | TCollapseContainer | TResponsiveGrid | TRepeatingGrid | TVolumeButton | TPlayPauseButton | TQRCodeComponent | TToggleSwitch | TRadioButton | TProgressIndicatorComponent | TToggleButtonComponent | TCountdownTimerTextComponent | TProgressBarComponent;
+type TComponent = TButtonContainer | TContainer | TTextListComponent | TTextComponent | TSpacerComponent | TImageComponent | TSvgImageComponent | TSymbolComponent | TCarouselContainer | TProductContainer | TFlexProductContainer | TStack | TConditionalComponent | TSegmentPicker | TSegmentPickerItem | TVideoComponent | TCollapseContainer | TResponsiveGrid | TRepeatingGrid | TVolumeButton | TPlayPauseButton | TQRCodeComponent | TToggleSwitch | TRadioButton | TProgressIndicatorComponent | TToggleButtonComponent | TCountdownTimerTextComponent | TTextInputComponent | TProgressBarComponent;
 type DirectionType = "vertical" | "horizontal";
 type AlignmentType = "center" | "right" | "left" | "top" | "bottom";
 type BorderLocationType = "upperLeft" | "upperRight" | "lowerLeft" | "lowerRight";
@@ -1490,6 +1521,38 @@ type NamiPurchaseDetails = {
 
 type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
 
+/**
+ * Pure, platform-agnostic text-input validation. Shared by the flow submit gate
+ * (sdk/core) and the web Lit element (sdk/web). The rules are identical to the
+ * Apple (NAM-1142) and Android (NAM-1143) ports.
+ */
+type TTextInputType = 'name' | 'email' | 'freeText';
+interface FormFieldValidator {
+    type: TTextInputType;
+    required: boolean;
+    /** Author-supplied error text; preferred over the per-rule default. */
+    message?: string;
+}
+/**
+ * Validate a single field. Returns `undefined` when valid, otherwise a default
+ * error message for the failing rule. Callers that want author-supplied text
+ * should use {@link validateForm}.
+ *
+ * Rules:
+ *  - required && blank → invalid
+ *  - email && non-blank && not email-format → invalid
+ *  - name && non-blank && len < 2 → invalid
+ *  - freeText → only the required rule applies
+ */
+declare function validateTextInput(type: TTextInputType, required: boolean, value: unknown): string | undefined;
+/**
+ * Validate every registered field against the current form state. Returns a map
+ * of `formId → error message` for invalid fields only (valid fields are omitted).
+ * The validator's own `message` is preferred; otherwise the per-rule default
+ * from {@link validateTextInput} is used.
+ */
+declare function validateForm(validators: Record<string, FormFieldValidator>, formStates: Record<string, unknown>): Record<string, string>;
+
 type NamiPresentationStyle = 'fullscreen' | 'sheet' | 'compact_sheet' | 'modal';
 declare function getEffectiveWebStyle(style: NamiPresentationStyle | undefined | null): NamiPresentationStyle;
 type TPaywallContext = TInitialState & {
@@ -1528,6 +1591,12 @@ type TPaywallContext = TInitialState & {
     formStates: {
         [formId: string]: boolean | string;
     };
+    formFieldErrors: {
+        [formId: string]: string;
+    };
+    formFieldValidators: {
+        [formId: string]: FormFieldValidator;
+    };
     timerStates: {
         [timerId: string]: TimerState;
     };
@@ -1959,6 +2028,15 @@ declare class NamiFlow extends BasicNamiFlow {
     resumeFromPause(): void;
     executeLifecycle(step: NamiFlowStep, key: string, data?: Record<string, any>): void;
     private lifecycles;
+    /**
+     * A lifecycle chain is a "form submit" if any phase (before/action/after) runs
+     * one of the advancing functions: setTagsFromForm, flowNext, or flowNav. The
+     * POC submit buttons use flowNext/flowNav (no dedicated submit action), so the
+     * gate keys off these. Close/dismiss/back/pause are deliberately excluded —
+     * they must never be blocked by validation. Mirrors Apple
+     * NamiFlowControl.isFormSubmitLifecycle / Android NamiFlow.isFormSubmitLifecycle.
+     */
+    isFormSubmitLifecycle(lifecycles: NamiFlowOn[]): boolean;
     triggerActions(actionId: string, component?: any, data?: Record<string, any>): void;
     executeFullLifecycles(lifecycles: NamiFlowOn[], data?: Record<string, any>): void;
     triggerBeforeActions(actionId: string, component?: any, data?: Record<string, any>): void;
@@ -2026,6 +2104,27 @@ declare class PaywallState extends SimpleEventTarget {
     getProductDetails(): NamiProductDetails[];
     setCurrentGroupData(currentGroupId: string, currentGroupName: string): void;
     setFormState(formId: string, state: boolean | string): void;
+    /**
+     * Register the validator for a text-input field (keyed by formId). Used by the
+     * implicit form-submit gate in NamiFlow.triggerActions and by the web element
+     * when it mounts.
+     */
+    registerFormFieldValidator(formId: string, validator: FormFieldValidator): void;
+    getFormFieldValidators(): {
+        [formId: string]: FormFieldValidator;
+    };
+    /**
+     * Replace the full set of field errors (formId → message). The gate writes the
+     * result of validateForm here; an empty map clears all errors.
+     */
+    setFormFieldErrors(errors: {
+        [formId: string]: string;
+    }): void;
+    setFormFieldError(formId: string, message: string): void;
+    clearFormFieldError(formId: string): void;
+    getFormFieldErrors(): {
+        [formId: string]: string;
+    };
     setTimerState(timerId: string, remainingSeconds: number, savedAt: number, hasEmittedCompletion: boolean): void;
     getTimerState(timerId: string): TimerState | undefined;
     getCurrentGroupId(): string;
@@ -2422,6 +2521,15 @@ declare class StorageService {
     getCustomerAttribute<T>(attribute: string): T | null;
     getAllCustomerAttributes(): string[];
     getAllCustomerAttributesKeys(): string[];
+    /**
+     * All persisted customer attributes as a `{ key: value }` map. Used to seed
+     * `PaywallState.customer` when a paywall screen initializes, so attributes set
+     * on an earlier flow screen (e.g. via setTagsFromForm) are available to the
+     * `${customer.x}` smart-text resolver on subsequent screens.
+     */
+    getAllCustomerAttributesMap(): {
+        [key: string]: string;
+    };
     clearCustomerAttribute(attribute: string): boolean;
     clearAllCustomerAttributes(): void;
     setNamiProfile(profileData: NamiProfile): void;
@@ -3489,5 +3597,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, 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, 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 };
+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, validateForm, validateMinSDKVersion, validateTextInput };
+export type { AccountStateHandler$1 as AccountStateHandler, AlignmentType, AmazonProduct, ApiResponse, AppleProduct, AvailableCampaignsResponseHandler, BorderLocationType, BorderSideType, Callback$1 as Callback, CloseHandler, CustomerJourneyState, DeepLinkUrlHandler, Device, DevicePayload, DeviceProfile, DirectionType, ExtendedPlatformInfo, FlexDirectionObject, FlowNavigationOptions, FontCollection, FontDetails, FormFactor, FormFieldValidator, GoogleProduct, IConfig, IDeviceAdapter, IEntitlements$1 as IEntitlements, IPaywall, IPlatformAdapters, IProductsWithComponents, IPurchaseAdapter, ISkuMenu, IStorageAdapter, IUIAdapter, Impression, InitialConfig, InitialConfigCompressed, InitiateStateGroup, 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, TTextInputComponent, TTextInputType, 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.202606180014", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.3-dev.202606181527", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -3191,6 +3191,22 @@ class StorageService {
             .filter(key => key.includes(CUSTOMER_ATTRIBUTES_KEY_PREFIX))
             .map(key => key.replace(CUSTOMER_ATTRIBUTES_KEY_PREFIX, ""));
     }
+    /**
+     * All persisted customer attributes as a `{ key: value }` map. Used to seed
+     * `PaywallState.customer` when a paywall screen initializes, so attributes set
+     * on an earlier flow screen (e.g. via setTagsFromForm) are available to the
+     * `${customer.x}` smart-text resolver on subsequent screens.
+     */
+    getAllCustomerAttributesMap() {
+        const out = {};
+        this.getAllCustomerAttributesKeys().forEach((key) => {
+            const value = this.getCustomerAttribute(key);
+            if (value !== null && value !== undefined) {
+                out[key] = String(value);
+            }
+        });
+        return out;
+    }
     clearCustomerAttribute(attribute) {
         const key = CUSTOMER_ATTRIBUTES_KEY_PREFIX + attribute;
         const itemExists = this.getItem(key);
@@ -11315,6 +11331,8 @@ const initialState = {
     groups: [],
     selectedProducts: {},
     formStates: {},
+    formFieldErrors: {},
+    formFieldValidators: {},
     timerStates: {},
     currentPage: 'page1',
     pageHistory: ['page1'],
@@ -11417,6 +11435,11 @@ class PaywallState extends SimpleEventTarget {
         this.state = cloneDeep(initialState);
         const profile = storageService.getNamiProfile();
         this.state.isLoggedIn = !!profile?.externalId;
+        // Seed customer attributes persisted on earlier screens (e.g. via
+        // setTagsFromForm / setTags) so `${customer.x}` smart text resolves on every
+        // flow screen — each screen builds a fresh provider, so without this the
+        // value captured on page 1 would be invisible on page 2.
+        this.state.customer = { ...this.state.customer, ...storageService.getAllCustomerAttributesMap() };
         this.setPaywall(paywall, context, campaign);
         this.subscribers = new Set();
     }
@@ -11454,6 +11477,41 @@ class PaywallState extends SimpleEventTarget {
     setFormState(formId, state) {
         this.setState({ ...this.state, formStates: { ...this.state.formStates, [formId]: state } });
     }
+    /**
+     * Register the validator for a text-input field (keyed by formId). Used by the
+     * implicit form-submit gate in NamiFlow.triggerActions and by the web element
+     * when it mounts.
+     */
+    registerFormFieldValidator(formId, validator) {
+        this.setState({
+            ...this.state,
+            formFieldValidators: { ...this.state.formFieldValidators, [formId]: validator },
+        });
+    }
+    getFormFieldValidators() {
+        return this.state.formFieldValidators;
+    }
+    /**
+     * Replace the full set of field errors (formId → message). The gate writes the
+     * result of validateForm here; an empty map clears all errors.
+     */
+    setFormFieldErrors(errors) {
+        this.setState({ ...this.state, formFieldErrors: { ...errors } });
+    }
+    setFormFieldError(formId, message) {
+        this.setState({
+            ...this.state,
+            formFieldErrors: { ...this.state.formFieldErrors, [formId]: message },
+        });
+    }
+    clearFormFieldError(formId) {
+        const nextErrors = { ...this.state.formFieldErrors };
+        delete nextErrors[formId];
+        this.setState({ ...this.state, formFieldErrors: nextErrors });
+    }
+    getFormFieldErrors() {
+        return this.state.formFieldErrors;
+    }
     setTimerState(timerId, remainingSeconds, savedAt, hasEmittedCompletion) {
         this.setState({
             ...this.state,
@@ -11672,7 +11730,12 @@ class PaywallState extends SimpleEventTarget {
         this.emitEvent('user-interaction-changed', { enabled });
     }
     setUserTags(tags) {
-        this.setState({ ...this.state, userTags: { ...this.state.userTags, ...tags } });
+        // User tags ARE customer attributes for personalization — they must land in
+        // `state.customer`, the store the `${customer.x}` smart-text resolver reads
+        // (see valueFromSmartText: replacements.customer = state.customer). Writing a
+        // separate `state.userTags` (read nowhere) meant setTags / setTagsFromForm
+        // values never reached `${customer.firstName}` on a subsequent flow page.
+        this.setState({ ...this.state, customer: { ...this.state.customer, ...tags } });
     }
     setCurrentSlideIndex(index) {
         this.setState({ ...this.state, currentSlideIndex: index });
@@ -12549,6 +12612,7 @@ var NamiFlowActionFunction;
     NamiFlowActionFunction["FLOW_ENABLED"] = "flowInteractionEnabled";
     NamiFlowActionFunction["FLOW_DISABLED"] = "flowInteractionDisabled";
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
+    NamiFlowActionFunction["SET_TAGS_FROM_FORM"] = "setTagsFromForm";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
     NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
@@ -13075,6 +13139,42 @@ class URLParams {
 URLParams._instance = null;
 const getUrlParams = () => URLParams.instance.params;
 
+/**
+ * Coerce a single form-state value to the string form used by tags / customer
+ * attributes / `{{ form.x }}` interpolation. Shared by the `setTagsFromForm`
+ * flow action and FlowLiquidResolver so they stay in lockstep.
+ *
+ * Rules (order matters — Boolean is checked before number):
+ *  - `null` / `undefined` → skip (returns `undefined`)
+ *  - empty string `""` → skip
+ *  - `false` → "false", `true` → "true" (booleans are kept)
+ *  - `0` → "0" (zero is kept)
+ *  - integral number → no trailing ".0" (e.g. 3 → "3", 3.5 → "3.5")
+ *  - everything else → String(value)
+ */
+function formTagValue(value) {
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    if (value === '') {
+        return undefined;
+    }
+    // Boolean BEFORE number: typeof true !== 'number', but be explicit so the
+    // intent (and the false→"false" / true→"true" mapping) is unmistakable.
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            return undefined;
+        }
+        // JS `String` already renders integers without a trailing ".0"
+        // (3 → "3", 3.5 → "3.5"), which is exactly the contract we want.
+        return String(value);
+    }
+    return String(value);
+}
+
 const LIQUID_VAR_REGEX = /\{\{\s*([^}]+?)\s*\}\}/g;
 /**
  * Resolver for liquid-style flow variables, without requiring namespace prefixes.
@@ -13099,6 +13199,13 @@ class FlowLiquidResolver {
             }
             return undefined;
         }
+        // Handle form field paths: {{ form.fieldId }} reads the live form state and
+        // coerces it through the same helper used by setTagsFromForm.
+        if (key.startsWith("form.")) {
+            const fieldId = key.substring("form.".length);
+            const value = PaywallState.currentProvider?.state.formStates[fieldId];
+            return formTagValue(value);
+        }
         switch (key) {
             case "campaignId":
                 return screenState?.campaign?.rule;
@@ -14100,6 +14207,67 @@ let NamiCustomerManager$2 = class NamiCustomerManager {
 };
 NamiCustomerManager$2.instance = new NamiCustomerManager$2();
 
+/**
+ * Pure, platform-agnostic text-input validation. Shared by the flow submit gate
+ * (sdk/core) and the web Lit element (sdk/web). The rules are identical to the
+ * Apple (NAM-1142) and Android (NAM-1143) ports.
+ */
+const DEFAULT_MESSAGES = {
+    required: 'This field is required',
+    email: 'Please enter a valid email address',
+    name: 'Please enter at least 2 characters',
+};
+/**
+ * An email must contain an `@` and a domain with a dot, e.g. `a@b.co`.
+ * `a@b` (no dotted domain) and `nope` (no `@`) are invalid.
+ */
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Validate a single field. Returns `undefined` when valid, otherwise a default
+ * error message for the failing rule. Callers that want author-supplied text
+ * should use {@link validateForm}.
+ *
+ * Rules:
+ *  - required && blank → invalid
+ *  - email && non-blank && not email-format → invalid
+ *  - name && non-blank && len < 2 → invalid
+ *  - freeText → only the required rule applies
+ */
+function validateTextInput(type, required, value) {
+    const text = typeof value === 'string' ? value : value == null ? '' : String(value);
+    const trimmed = text.trim();
+    if (required && trimmed.length === 0) {
+        return DEFAULT_MESSAGES.required;
+    }
+    if (trimmed.length === 0) {
+        // Blank optional value: no format rule applies.
+        return undefined;
+    }
+    if (type === 'email' && !EMAIL_REGEX.test(trimmed)) {
+        return DEFAULT_MESSAGES.email;
+    }
+    if (type === 'name' && trimmed.length < 2) {
+        return DEFAULT_MESSAGES.name;
+    }
+    return undefined;
+}
+/**
+ * Validate every registered field against the current form state. Returns a map
+ * of `formId → error message` for invalid fields only (valid fields are omitted).
+ * The validator's own `message` is preferred; otherwise the per-rule default
+ * from {@link validateTextInput} is used.
+ */
+function validateForm(validators, formStates) {
+    const errors = {};
+    for (const [formId, validator] of Object.entries(validators)) {
+        const defaultError = validateTextInput(validator.type, validator.required, formStates[formId]);
+        if (defaultError !== undefined) {
+            errors[formId] = validator.message ?? defaultError;
+        }
+    }
+    return errors;
+}
+
 class BasicNamiFlow {
     constructor(flowObject = {}) {
         this.id = flowObject.id ?? '';
@@ -14331,12 +14499,40 @@ class NamiFlow extends BasicNamiFlow {
         }
         return lifecycles;
     }
+    /**
+     * A lifecycle chain is a "form submit" if any phase (before/action/after) runs
+     * one of the advancing functions: setTagsFromForm, flowNext, or flowNav. The
+     * POC submit buttons use flowNext/flowNav (no dedicated submit action), so the
+     * gate keys off these. Close/dismiss/back/pause are deliberately excluded —
+     * they must never be blocked by validation. Mirrors Apple
+     * NamiFlowControl.isFormSubmitLifecycle / Android NamiFlow.isFormSubmitLifecycle.
+     */
+    isFormSubmitLifecycle(lifecycles) {
+        const submitFns = [
+            NamiFlowActionFunction.SET_TAGS_FROM_FORM,
+            NamiFlowActionFunction.NEXT,
+            NamiFlowActionFunction.NAVIGATE,
+        ];
+        return lifecycles.some(cycle => [cycle.before, cycle.action, cycle.after].some(actions => actions?.some(action => submitFns.includes(action.function))));
+    }
     triggerActions(actionId, component, data) {
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
         this.flowLog(`triggerActions(${actionId}) — step=${this.currentFlowStep?.id}, isPaused=${this.isPaused}`);
         this.currentButton = component;
+        // Implicit form-submit validation gate (the NAM-1143 on-device lesson).
+        // When this action advances the flow and validators are registered, validate
+        // first; write the errors and halt the chain if any field is invalid.
+        const validators = PaywallState.currentProvider?.state.formFieldValidators ?? {};
+        if (this.isFormSubmitLifecycle(lifecycles) && Object.keys(validators).length) {
+            const errors = validateForm(validators, this.getFormData());
+            PaywallState.currentProvider?.setFormFieldErrors(errors);
+            if (Object.keys(errors).length) {
+                this.flowLog(`triggerActions(${actionId}) — HALTED by form validation: ${JSON.stringify(errors)}`);
+                return;
+            }
+        }
         this.executeFullLifecycles(lifecycles, data);
     }
     executeFullLifecycles(lifecycles, data) {
@@ -14543,6 +14739,22 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case NamiFlowActionFunction.SET_TAGS_FROM_FORM: {
+                    const formData = this.getFormData();
+                    const tags = {};
+                    Object.entries(formData).forEach(([key, raw]) => {
+                        const value = formTagValue(raw);
+                        if (value === undefined) {
+                            return; // skip null / "" (false and 0 are kept by formTagValue)
+                        }
+                        tags[key] = value;
+                        NamiCustomerManager$2.setCustomerAttribute(key, value);
+                    });
+                    if (Object.keys(tags).length) {
+                        PaywallState.setUserTags(tags);
+                    }
+                    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
@@ -64765,4 +64977,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, 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 { 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, 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, validateForm, validateMinSDKVersion, validateTextInput };

package/package.json

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