@namiml/sdk-core 3.4.10-dev.202608230430 → 3.4.10-dev.202608232056

package/dist/index.cjs

@@ -106,7 +106,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.10", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.10-dev.202608230430", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.10-dev.202608232056", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -59057,6 +59057,7 @@ const getProductDetailHandlers = (product, referenceId, skus = []) => ({
     periodInMonthsAbbrev: () => getDurationInMonths(product, false, true, false, true),
     periodly: () => convertISO8601PeriodToPeriodly(getStandardBillingPeriod(product)),
     iso_subscription_duration: () => getISOSubscriptionDuration(product),
+    bill_term: () => getBillTerm(product),
     invalid: () => false,
     unavailable: () => false,
 });
@@ -59216,6 +59217,21 @@ const getIntroductoryPhase = (product, referenceId) => {
     }
     return convertOfferToPricingPhase(offer, product.subscription_period);
 };
+// Analytics-stable bill-term names keyed by normalized ISO 8601 duration.
+// Deliberately NOT localized (unlike `periodly`) — these land in analytics
+// payloads via `{{ sku.bill_term }}`, where values must be stable per NAM-3429.
+const BILL_TERM_BY_ISO_DURATION = {
+    P1D: "daily",
+    P1W: "weekly",
+    P1M: "monthly",
+    P3M: "quarterly",
+    P6M: "semiannual",
+    P1Y: "annual",
+};
+const getBillTerm = (product) => {
+    const iso = getISOSubscriptionDuration(product);
+    return (iso && BILL_TERM_BY_ISO_DURATION[iso]) || null;
+};
 const getISOSubscriptionDuration = (product) => {
     // ["P1W", "P4W", "P1M", "P2M", "P3M", "P4M", "P6M", "P8M", "P1Y"]
     // P7D => P1W
@@ -60812,6 +60828,22 @@ class PaywallState extends SimpleEventTarget {
     selectedProducts() {
         return this.state.selectedProducts;
     }
+    /**
+     * NAM-3606: removes the group's focus-driven selection so no product condition
+     * matches — Apple parity with `PaywallState.setFocusedSku(nil)` clearing when the
+     * group toggle gains focus on television. Routes through `setSelectedProducts` so
+     * `state.sku` recomputes and subscribers re-render. No-op when the group has no
+     * selection, keeping repeated toggle focusin events from emitting redundant state.
+     */
+    clearSelectedProduct(groupId) {
+        const current = this.state.selectedProducts || {};
+        if (!groupId || current[groupId] == null) {
+            return;
+        }
+        const next = { ...current };
+        delete next[groupId];
+        this.setSelectedProducts(next);
+    }
     setPaywall(paywall, context, campaign) {
         let state = {
             ...this.state,
@@ -62594,6 +62626,34 @@ class FlowLiquidResolver {
             const value = PaywallState.currentProvider?.state.formStates[fieldId];
             return formTagValue(value);
         }
+        // Purchased-SKU context (NAM-3965): {{ sku.* }} resolves against the SKU
+        // captured by the raise's `__buy_sku__` trigger — deliberately NOT the
+        // selected SKU, so cart-add analytics report what was actually bought.
+        // Unset until a buy action fires (token blanks, matching other platforms).
+        if (key.startsWith("sku.")) {
+            const purchased = flow?.purchasedSku;
+            if (!purchased)
+                return undefined;
+            const leaf = key.substring("sku.".length);
+            switch (leaf) {
+                case "sku_ref_id":
+                    return purchased.skuRefId;
+                case "name":
+                    // Control Center reference name; the store title stays reachable as
+                    // {{ sku.title }} via the product-detail table below.
+                    return purchased.name;
+                // SKUs can grant several entitlements; the scalar contract takes the
+                // first in payload order (NAM-3429).
+                case "entitlement_ref_id":
+                    return purchased.entitlements[0]?.entitlement_ref_id ?? "";
+                case "entitlement_name":
+                    return purchased.entitlements[0]?.name ?? "";
+                default: {
+                    const value = getProductDetail(leaf, purchased.productDetails);
+                    return value != null ? String(value) : undefined;
+                }
+            }
+        }
         switch (key) {
             case "campaignId":
                 return screenState?.campaign?.rule;
@@ -64050,6 +64110,27 @@ function validateForm(validators, formStates) {
 
 /** Form field key convention for grouped handoffs: `<tag>::<payloadKey>`. */
 const HANDOFF_GROUP_KEY = /^([^:]+)::(.+)$/;
+/**
+ * Web buttons hand the flow a public `NamiSKU` (`skuId`/`productDetails`) while
+ * Expo hands the wire `PaywallSKU` (`sku_ref_id`/`product_details`); collapse
+ * both onto one shape so `{{ sku.* }}` resolves identically on every platform.
+ */
+function normalizePurchasedSku(sku) {
+    if ('sku_ref_id' in sku) {
+        return {
+            skuRefId: sku.sku_ref_id,
+            name: sku.name,
+            entitlements: Array.isArray(sku.entitlements) ? sku.entitlements : [],
+            productDetails: sku.product_details ?? null,
+        };
+    }
+    return {
+        skuRefId: sku.skuId,
+        name: sku.name,
+        entitlements: Array.isArray(sku.entitlements) ? sku.entitlements : [],
+        productDetails: sku.productDetails ?? null,
+    };
+}
 class BasicNamiFlow {
     constructor(flowObject = {}) {
         this.id = flowObject.id ?? '';
@@ -64418,7 +64499,19 @@ class NamiFlow extends BasicNamiFlow {
         ];
         return lifecycles.some(cycle => [cycle.before, cycle.action, cycle.after].some(actions => actions?.some(action => submitFns.includes(action.function))));
     }
+    /**
+     * Stash the SKU carried by a `__buy_sku__` trigger so `{{ sku.* }}` resolves
+     * in this and later lifecycles of the raise. Runs before the lifecycle
+     * lookup: a buy tap should update the context even when the current step
+     * has no `__buy_sku__` lifecycles of its own.
+     */
+    captureBuySkuData(actionId, data) {
+        if (actionId === NamiReservedActions.BUY_SKU && data?.sku) {
+            this.purchasedSku = normalizePurchasedSku(data.sku);
+        }
+    }
     triggerActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
@@ -64450,6 +64543,7 @@ class NamiFlow extends BasicNamiFlow {
         }
     }
     triggerBeforeActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
@@ -64459,6 +64553,7 @@ class NamiFlow extends BasicNamiFlow {
         }
     }
     triggerAfterActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;

package/dist/index.d.ts

@@ -2264,6 +2264,16 @@ declare class NamiFlowManager$2 {
     static getCurrentFlowStepAutoAdvanceDelay(): number | null;
 }
 
+/**
+ * Normalized SKU captured when a `__buy_sku__` trigger hands the flow a SKU,
+ * resolvable for the rest of the raise via `{{ sku.* }}` (NAM-3965).
+ */
+interface PurchasedSkuContext {
+    skuRefId?: string;
+    name?: string;
+    entitlements: IEntitlements$1[];
+    productDetails?: NamiProductDetails | null;
+}
 declare class BasicNamiFlow implements NamiFlowObjectDTO {
     id: string;
     name: string;
@@ -2316,6 +2326,13 @@ declare class NamiFlow extends BasicNamiFlow {
         login?: Record<string, NamiHandoffAttributeValue>;
         permissions: Record<string, boolean>;
     };
+    /**
+     * SKU handed to the flow by the most recent `__buy_sku__` trigger, exposed
+     * to flow-event Liquid as `{{ sku.* }}` (NAM-3965). Kept for the rest of the
+     * raise so `__purchase_success__` lifecycles — which carry no data on any
+     * platform — still resolve it; dies with the flow instance.
+     */
+    purchasedSku?: PurchasedSkuContext;
     /**
      * Per-raise flow-completion tracking (NAM-1545). Bound to the impression
      * of the current screen's raise; one completion result per impression
@@ -2387,6 +2404,13 @@ declare class NamiFlow extends BasicNamiFlow {
      * NamiFlowControl.isFormSubmitLifecycle / Android NamiFlow.isFormSubmitLifecycle.
      */
     isFormSubmitLifecycle(lifecycles: NamiFlowOn[]): boolean;
+    /**
+     * Stash the SKU carried by a `__buy_sku__` trigger so `{{ sku.* }}` resolves
+     * in this and later lifecycles of the raise. Runs before the lifecycle
+     * lookup: a buy tap should update the context even when the current step
+     * has no `__buy_sku__` lifecycles of its own.
+     */
+    private captureBuySkuData;
     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;
@@ -2503,6 +2527,14 @@ declare class PaywallState extends SimpleEventTarget {
     selectedProducts(): {
         [currentGroupId: string]: string | null;
     };
+    /**
+     * NAM-3606: removes the group's focus-driven selection so no product condition
+     * matches — Apple parity with `PaywallState.setFocusedSku(nil)` clearing when the
+     * group toggle gains focus on television. Routes through `setSelectedProducts` so
+     * `state.sku` recomputes and subscribers re-render. No-op when the group has no
+     * selection, keeping repeated toggle focusin events from emitting redundant state.
+     */
+    clearSelectedProduct(groupId: string): void;
     setPaywall(paywall: IPaywall, context: NamiPaywallLaunchContext, campaign: NamiCampaign): void;
     getSelectedPaywall(): IPaywall | undefined;
     getSelectedCampaign(): NamiCampaign | undefined;

package/dist/index.mjs

@@ -104,7 +104,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.10", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.10-dev.202608230430", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.10-dev.202608232056", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -59055,6 +59055,7 @@ const getProductDetailHandlers = (product, referenceId, skus = []) => ({
     periodInMonthsAbbrev: () => getDurationInMonths(product, false, true, false, true),
     periodly: () => convertISO8601PeriodToPeriodly(getStandardBillingPeriod(product)),
     iso_subscription_duration: () => getISOSubscriptionDuration(product),
+    bill_term: () => getBillTerm(product),
     invalid: () => false,
     unavailable: () => false,
 });
@@ -59214,6 +59215,21 @@ const getIntroductoryPhase = (product, referenceId) => {
     }
     return convertOfferToPricingPhase(offer, product.subscription_period);
 };
+// Analytics-stable bill-term names keyed by normalized ISO 8601 duration.
+// Deliberately NOT localized (unlike `periodly`) — these land in analytics
+// payloads via `{{ sku.bill_term }}`, where values must be stable per NAM-3429.
+const BILL_TERM_BY_ISO_DURATION = {
+    P1D: "daily",
+    P1W: "weekly",
+    P1M: "monthly",
+    P3M: "quarterly",
+    P6M: "semiannual",
+    P1Y: "annual",
+};
+const getBillTerm = (product) => {
+    const iso = getISOSubscriptionDuration(product);
+    return (iso && BILL_TERM_BY_ISO_DURATION[iso]) || null;
+};
 const getISOSubscriptionDuration = (product) => {
     // ["P1W", "P4W", "P1M", "P2M", "P3M", "P4M", "P6M", "P8M", "P1Y"]
     // P7D => P1W
@@ -60810,6 +60826,22 @@ class PaywallState extends SimpleEventTarget {
     selectedProducts() {
         return this.state.selectedProducts;
     }
+    /**
+     * NAM-3606: removes the group's focus-driven selection so no product condition
+     * matches — Apple parity with `PaywallState.setFocusedSku(nil)` clearing when the
+     * group toggle gains focus on television. Routes through `setSelectedProducts` so
+     * `state.sku` recomputes and subscribers re-render. No-op when the group has no
+     * selection, keeping repeated toggle focusin events from emitting redundant state.
+     */
+    clearSelectedProduct(groupId) {
+        const current = this.state.selectedProducts || {};
+        if (!groupId || current[groupId] == null) {
+            return;
+        }
+        const next = { ...current };
+        delete next[groupId];
+        this.setSelectedProducts(next);
+    }
     setPaywall(paywall, context, campaign) {
         let state = {
             ...this.state,
@@ -62592,6 +62624,34 @@ class FlowLiquidResolver {
             const value = PaywallState.currentProvider?.state.formStates[fieldId];
             return formTagValue(value);
         }
+        // Purchased-SKU context (NAM-3965): {{ sku.* }} resolves against the SKU
+        // captured by the raise's `__buy_sku__` trigger — deliberately NOT the
+        // selected SKU, so cart-add analytics report what was actually bought.
+        // Unset until a buy action fires (token blanks, matching other platforms).
+        if (key.startsWith("sku.")) {
+            const purchased = flow?.purchasedSku;
+            if (!purchased)
+                return undefined;
+            const leaf = key.substring("sku.".length);
+            switch (leaf) {
+                case "sku_ref_id":
+                    return purchased.skuRefId;
+                case "name":
+                    // Control Center reference name; the store title stays reachable as
+                    // {{ sku.title }} via the product-detail table below.
+                    return purchased.name;
+                // SKUs can grant several entitlements; the scalar contract takes the
+                // first in payload order (NAM-3429).
+                case "entitlement_ref_id":
+                    return purchased.entitlements[0]?.entitlement_ref_id ?? "";
+                case "entitlement_name":
+                    return purchased.entitlements[0]?.name ?? "";
+                default: {
+                    const value = getProductDetail(leaf, purchased.productDetails);
+                    return value != null ? String(value) : undefined;
+                }
+            }
+        }
         switch (key) {
             case "campaignId":
                 return screenState?.campaign?.rule;
@@ -64048,6 +64108,27 @@ function validateForm(validators, formStates) {
 
 /** Form field key convention for grouped handoffs: `<tag>::<payloadKey>`. */
 const HANDOFF_GROUP_KEY = /^([^:]+)::(.+)$/;
+/**
+ * Web buttons hand the flow a public `NamiSKU` (`skuId`/`productDetails`) while
+ * Expo hands the wire `PaywallSKU` (`sku_ref_id`/`product_details`); collapse
+ * both onto one shape so `{{ sku.* }}` resolves identically on every platform.
+ */
+function normalizePurchasedSku(sku) {
+    if ('sku_ref_id' in sku) {
+        return {
+            skuRefId: sku.sku_ref_id,
+            name: sku.name,
+            entitlements: Array.isArray(sku.entitlements) ? sku.entitlements : [],
+            productDetails: sku.product_details ?? null,
+        };
+    }
+    return {
+        skuRefId: sku.skuId,
+        name: sku.name,
+        entitlements: Array.isArray(sku.entitlements) ? sku.entitlements : [],
+        productDetails: sku.productDetails ?? null,
+    };
+}
 class BasicNamiFlow {
     constructor(flowObject = {}) {
         this.id = flowObject.id ?? '';
@@ -64416,7 +64497,19 @@ class NamiFlow extends BasicNamiFlow {
         ];
         return lifecycles.some(cycle => [cycle.before, cycle.action, cycle.after].some(actions => actions?.some(action => submitFns.includes(action.function))));
     }
+    /**
+     * Stash the SKU carried by a `__buy_sku__` trigger so `{{ sku.* }}` resolves
+     * in this and later lifecycles of the raise. Runs before the lifecycle
+     * lookup: a buy tap should update the context even when the current step
+     * has no `__buy_sku__` lifecycles of its own.
+     */
+    captureBuySkuData(actionId, data) {
+        if (actionId === NamiReservedActions.BUY_SKU && data?.sku) {
+            this.purchasedSku = normalizePurchasedSku(data.sku);
+        }
+    }
     triggerActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
@@ -64448,6 +64541,7 @@ class NamiFlow extends BasicNamiFlow {
         }
     }
     triggerBeforeActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;
@@ -64457,6 +64551,7 @@ class NamiFlow extends BasicNamiFlow {
         }
     }
     triggerAfterActions(actionId, component, data) {
+        this.captureBuySkuData(actionId, data);
         const lifecycles = this.lifecycles(actionId);
         if (!lifecycles)
             return;

package/package.json

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