@namiml/sdk-core 3.4.4-dev.202606300501 → 3.4.4-dev.202606302327

package/dist/index.cjs

@@ -98,7 +98,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.4", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.4-dev.202606300501", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.4-dev.202606302327", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -12392,6 +12392,38 @@ let NamiProfileManager$1 = class NamiProfileManager {
 };
 NamiProfileManager$1.instance = new NamiProfileManager$1();
 
+/**
+ * Two-slot, session-scoped store of the most recent launches.
+ *
+ * On `record(rec)` the existing `current` slot is demoted to `previous` and
+ * `rec` becomes the new `current`. Flow conditions read `previous`, which
+ * structurally excludes the placement that is launching right now (the PPO
+ * requirement): the first launch in a session leaves `previous` undefined.
+ *
+ * State is in-memory only and cleared via `reset()` (wired into `Nami.reset()`).
+ */
+class LastLaunchStore {
+    static get shared() {
+        if (!this._shared)
+            this._shared = new LastLaunchStore();
+        return this._shared;
+    }
+    /** The Last Launch — the launch immediately before the current one. */
+    get previous() {
+        return this._previous;
+    }
+    /** Demote `current` → `previous`, then set `current` to `rec`. */
+    record(rec) {
+        this._previous = this._current;
+        this._current = rec;
+    }
+    /** Clear both slots. */
+    reset() {
+        this._current = undefined;
+        this._previous = undefined;
+    }
+}
+
 var _Nami_isInitialized;
 // NamiFlowManager is intentionally NOT imported at top level — it
 // transitively imports back to this module (`Nami` for logging), and
@@ -12432,6 +12464,7 @@ class Nami {
         PaywallState.reset();
         NamiAPI.reset();
         CampaignRuleRepository.instance.reset();
+        LastLaunchStore.shared.reset();
         // Lazy import to avoid a load-order cycle (NamiFlowManager imports
         // back to this module for `Nami.instance.maxLogging`).
         const { NamiFlowManager } = await Promise.resolve().then(function () { return NamiFlowManager$3; });
@@ -12732,6 +12765,7 @@ const FilterOperator = {
     NOT_EQUALS: 'not_equals',
     NOT_I_EQUALS: 'not_i_equals',
     NOT_CONTAINS: 'not_contains',
+    CONTAINS: 'contains',
     SET: 'set',
     NOT_SET: 'not_set',
     GREATER_THAN: 'greater_than',
@@ -12864,14 +12898,24 @@ class NamiConditionEvaluator {
             case FilterOperator.NOT_I_EQUALS: {
                 return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, true));
             }
+            case FilterOperator.CONTAINS: {
+                // Array (tags): ANY-match by exact membership. String: case-sensitive substring.
+                // `includes` covers both (Array.prototype.includes / String.prototype.includes).
+                if (Array.isArray(resolvedValue) || typeof resolvedValue === 'string') {
+                    return filter.values.some(expected => typeof expected === 'string' && resolvedValue.includes(expected));
+                }
+                return false;
+            }
             case FilterOperator.NOT_CONTAINS: {
-                const result = filter.values.every(expected => {
+                if (Array.isArray(resolvedValue)) {
+                    return filter.values.every(expected => !(typeof expected === 'string' && resolvedValue.includes(expected)));
+                }
+                return filter.values.every(expected => {
                     if (typeof resolvedValue === 'string' && typeof expected === 'string') {
                         return !resolvedValue.includes(expected);
                     }
                     return true;
                 });
-                return result;
             }
             case FilterOperator.GREATER_THAN:
             case FilterOperator.GREATER_THAN_OR_EQUAL_TO:
@@ -13016,14 +13060,22 @@ class BaseNamespaceResolver {
 
 // import { logger } from "../../services/logger.service";
 class LaunchContextResolver extends BaseNamespaceResolver {
-    constructor(context) {
+    constructor(context, campaign) {
         super();
         this.namespace = 'LaunchContext';
         this.context = context;
+        this.campaign = campaign;
         this.register();
     }
     resolveValue(keyPath) {
         // logger.debug('[LaunchContextResolver]', 'Resolving keyPath', keyPath);
+        // Current-launch placement metadata sourced from the launching campaign.
+        if (keyPath === 'placement') {
+            return this.campaign?.value ?? undefined;
+        }
+        if (keyPath === 'tags') {
+            return this.campaign?.placement_tags ?? undefined;
+        }
         if (keyPath.startsWith('customAttributes.')) {
             const innerPath = keyPath.substring('customAttributes.'.length);
             return this.resolveKeyPath(innerPath, this.context.customAttributes);
@@ -13446,6 +13498,50 @@ class PlacementLabelResolver extends BaseNamespaceResolver {
     }
 }
 
+/**
+ * Resolves flow conditions against the *previous* launch (the "Last Launch"),
+ * exposed under the `LastLaunchContext` namespace (NAM-1937):
+ *
+ *   - `LastLaunchContext.placement`            → previous launch's placement label
+ *   - `LastLaunchContext.tags`                 → previous launch's placement tags
+ *   - `LastLaunchContext.customAttributes.<k>` → a custom attribute from the previous launch
+ *
+ * When there is no previous launch (first launch of the session), every key
+ * resolves to `undefined`. The condition evaluator's existing null-state
+ * handling then makes `equals`/`set` false and `not_set` true — so the
+ * resolver deliberately does not special-case any operator.
+ */
+class LastLaunchContextResolver extends BaseNamespaceResolver {
+    constructor() {
+        super(...arguments);
+        this.namespace = "LastLaunchContext";
+    }
+    // Exposed publicly so callers register explicitly (consistent with how this
+    // resolver is wired from NamiFlow and exercised in tests). Unlike the other
+    // resolvers it does not auto-register from its constructor because it reads
+    // live store state rather than capturing per-launch context.
+    register() {
+        super.register();
+    }
+    resolveValue(keyPath) {
+        const previous = LastLaunchStore.shared.previous;
+        if (!previous) {
+            return undefined;
+        }
+        if (keyPath === "placement") {
+            return previous.placementLabel;
+        }
+        if (keyPath === "tags") {
+            return previous.tags;
+        }
+        if (keyPath.startsWith("customAttributes.")) {
+            const innerPath = keyPath.substring("customAttributes.".length);
+            return this.resolveKeyPath(innerPath, previous.customAttributes);
+        }
+        return undefined;
+    }
+}
+
 /**
  * Represents the possible account actions states that can be returned by callback registered from
  * [NamiCustomerManager.registerAccountStateHandler]
@@ -14749,7 +14845,7 @@ class NamiFlow extends BasicNamiFlow {
     applyLaunchContextAttributes(attrs) {
         if (!this.context) {
             this.context = { customAttributes: {} };
-            new LaunchContextResolver(this.context);
+            new LaunchContextResolver(this.context, this.campaign);
         }
         // Guard against a runtime-supplied context that omits customAttributes
         // (the field is required by the type but may be absent in untyped JSON).
@@ -14759,12 +14855,13 @@ class NamiFlow extends BasicNamiFlow {
     }
     registerResolvers(context) {
         if (context) {
-            new LaunchContextResolver(context);
+            new LaunchContextResolver(context, this.campaign);
         }
         new DeviceResolver();
         new URLParamsResolver();
         new FormStateResolver();
         new PlacementLabelResolver(this.campaign);
+        new LastLaunchContextResolver().register();
         NamiConditionEvaluator.shared.registerNamespaceResolver('Flow', (identifier) => {
             switch (identifier) {
                 case 'Flow.stepcrumbs':
@@ -15617,7 +15714,11 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
         const data = startupTelemetry.firstLaunchLookup(value, () => getPaywallDataFromLabel(value, type));
         let paywall = data.paywall;
         const campaign = data.campaign;
-        if (!campaign || (!paywall && !campaign.flow)) {
+        // Captured before the degenerate branch below clobbers `paywall` to `{}`,
+        // so a not-found launch is correctly distinguishable from a real one when
+        // deciding whether to record into LastLaunchStore (NAM-1937).
+        const campaignNotFound = !campaign || (!paywall && !campaign.flow);
+        if (campaignNotFound) {
             let error;
             if (!label && !withUrl) {
                 error = exports.LaunchCampaignError.DEFAULT_CAMPAIGN_NOT_FOUND;
@@ -15668,6 +15769,23 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
             resultCallback(false, exports.LaunchCampaignError.FLOW_SCREEN_DATA_UNAVILABLE);
             throw new FlowScreensNotAvailableError();
         }
+        // Record this launch into the two-slot Last Launch store BEFORE the flow
+        // resolvers read it. The just-launched placement becomes `current`; the
+        // prior launch is demoted to `previous`, which flow conditions read via
+        // the LastLaunchContext namespace (NAM-1937).
+        //
+        // Only record when a real placement is actually being launched. The
+        // not-found/degenerate path above sets `paywall = {}` and falls through
+        // (the throw is commented out); recording there would store a bogus
+        // failed-launch record AND demote the real `current`, breaking the
+        // two-slot/PPO guarantee for the next real launch.
+        if (!campaignNotFound) {
+            LastLaunchStore.shared.record({
+                placementLabel: campaign?.value ?? value ?? "",
+                tags: campaign?.placement_tags ?? [],
+                customAttributes: (context?.customAttributes ?? {}),
+            });
+        }
         const component = getPlatformAdapters().ui.createPaywall(type, value, context);
         // Generate and store launch ID for successful campaign launch
         const launchId = generateUUID();

package/dist/index.d.ts

@@ -91,6 +91,7 @@ declare const FilterOperator: {
     readonly NOT_EQUALS: "not_equals";
     readonly NOT_I_EQUALS: "not_i_equals";
     readonly NOT_CONTAINS: "not_contains";
+    readonly CONTAINS: "contains";
     readonly SET: "set";
     readonly NOT_SET: "not_set";
     readonly GREATER_THAN: "greater_than";
@@ -1055,6 +1056,7 @@ interface NamiCampaign {
     page_urls?: Record<string, string> | null;
     type: string | NamiCampaignRuleType;
     value?: string | null;
+    placement_tags?: string[];
     form_factors: FormFactor[];
     external_segment: string | null;
     conversion_event_type?: CampaignRuleConversionEventType | null;
@@ -1486,6 +1488,10 @@ type TResponsiveGrid = TBaseComponent & {
     groupBy?: string;
     groupHeaderTemplate?: TComponent;
     timeline?: TTimelineRail;
+    /** Flat lists only (no groupBy): render at most the first N eligible items. Ignored when groupBy is present. */
+    max?: number;
+    /** Grouped lists only (groupBy present): render at most the first N eligible items per group. Ignored when groupBy is absent. */
+    groupMax?: number;
 };
 type TRepeatingGrid = TBaseComponent & {
     component: "repeatingGrid";
@@ -1499,6 +1505,10 @@ type TRepeatingGrid = TBaseComponent & {
     itemAlignment?: string;
     groupBy?: string;
     groupHeaderTemplate?: TComponent;
+    /** Flat lists only (no groupBy): render at most the first N eligible items. Ignored when groupBy is present. */
+    max?: number;
+    /** Grouped lists only (groupBy present): render at most the first N eligible items per group. Ignored when groupBy is absent. */
+    groupMax?: number;
 };
 type TToggleSwitch = TBaseComponent & {
     component: 'toggleSwitch';
@@ -3505,7 +3515,8 @@ declare abstract class BaseNamespaceResolver {
 declare class LaunchContextResolver extends BaseNamespaceResolver {
     protected readonly namespace = "LaunchContext";
     private context;
-    constructor(context: NamiPaywallLaunchContext);
+    private campaign?;
+    constructor(context: NamiPaywallLaunchContext, campaign?: NamiCampaign);
     protected resolveValue(keyPath: string): any;
 }
 

package/dist/index.mjs

@@ -96,7 +96,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.4", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.4-dev.202606300501", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.4-dev.202606302327", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -12390,6 +12390,38 @@ let NamiProfileManager$1 = class NamiProfileManager {
 };
 NamiProfileManager$1.instance = new NamiProfileManager$1();
 
+/**
+ * Two-slot, session-scoped store of the most recent launches.
+ *
+ * On `record(rec)` the existing `current` slot is demoted to `previous` and
+ * `rec` becomes the new `current`. Flow conditions read `previous`, which
+ * structurally excludes the placement that is launching right now (the PPO
+ * requirement): the first launch in a session leaves `previous` undefined.
+ *
+ * State is in-memory only and cleared via `reset()` (wired into `Nami.reset()`).
+ */
+class LastLaunchStore {
+    static get shared() {
+        if (!this._shared)
+            this._shared = new LastLaunchStore();
+        return this._shared;
+    }
+    /** The Last Launch — the launch immediately before the current one. */
+    get previous() {
+        return this._previous;
+    }
+    /** Demote `current` → `previous`, then set `current` to `rec`. */
+    record(rec) {
+        this._previous = this._current;
+        this._current = rec;
+    }
+    /** Clear both slots. */
+    reset() {
+        this._current = undefined;
+        this._previous = undefined;
+    }
+}
+
 var _Nami_isInitialized;
 // NamiFlowManager is intentionally NOT imported at top level — it
 // transitively imports back to this module (`Nami` for logging), and
@@ -12430,6 +12462,7 @@ class Nami {
         PaywallState.reset();
         NamiAPI.reset();
         CampaignRuleRepository.instance.reset();
+        LastLaunchStore.shared.reset();
         // Lazy import to avoid a load-order cycle (NamiFlowManager imports
         // back to this module for `Nami.instance.maxLogging`).
         const { NamiFlowManager } = await Promise.resolve().then(function () { return NamiFlowManager$3; });
@@ -12730,6 +12763,7 @@ const FilterOperator = {
     NOT_EQUALS: 'not_equals',
     NOT_I_EQUALS: 'not_i_equals',
     NOT_CONTAINS: 'not_contains',
+    CONTAINS: 'contains',
     SET: 'set',
     NOT_SET: 'not_set',
     GREATER_THAN: 'greater_than',
@@ -12862,14 +12896,24 @@ class NamiConditionEvaluator {
             case FilterOperator.NOT_I_EQUALS: {
                 return filter.values.every(expected => !this.strictEquals(resolvedValue, expected, true));
             }
+            case FilterOperator.CONTAINS: {
+                // Array (tags): ANY-match by exact membership. String: case-sensitive substring.
+                // `includes` covers both (Array.prototype.includes / String.prototype.includes).
+                if (Array.isArray(resolvedValue) || typeof resolvedValue === 'string') {
+                    return filter.values.some(expected => typeof expected === 'string' && resolvedValue.includes(expected));
+                }
+                return false;
+            }
             case FilterOperator.NOT_CONTAINS: {
-                const result = filter.values.every(expected => {
+                if (Array.isArray(resolvedValue)) {
+                    return filter.values.every(expected => !(typeof expected === 'string' && resolvedValue.includes(expected)));
+                }
+                return filter.values.every(expected => {
                     if (typeof resolvedValue === 'string' && typeof expected === 'string') {
                         return !resolvedValue.includes(expected);
                     }
                     return true;
                 });
-                return result;
             }
             case FilterOperator.GREATER_THAN:
             case FilterOperator.GREATER_THAN_OR_EQUAL_TO:
@@ -13014,14 +13058,22 @@ class BaseNamespaceResolver {
 
 // import { logger } from "../../services/logger.service";
 class LaunchContextResolver extends BaseNamespaceResolver {
-    constructor(context) {
+    constructor(context, campaign) {
         super();
         this.namespace = 'LaunchContext';
         this.context = context;
+        this.campaign = campaign;
         this.register();
     }
     resolveValue(keyPath) {
         // logger.debug('[LaunchContextResolver]', 'Resolving keyPath', keyPath);
+        // Current-launch placement metadata sourced from the launching campaign.
+        if (keyPath === 'placement') {
+            return this.campaign?.value ?? undefined;
+        }
+        if (keyPath === 'tags') {
+            return this.campaign?.placement_tags ?? undefined;
+        }
         if (keyPath.startsWith('customAttributes.')) {
             const innerPath = keyPath.substring('customAttributes.'.length);
             return this.resolveKeyPath(innerPath, this.context.customAttributes);
@@ -13444,6 +13496,50 @@ class PlacementLabelResolver extends BaseNamespaceResolver {
     }
 }
 
+/**
+ * Resolves flow conditions against the *previous* launch (the "Last Launch"),
+ * exposed under the `LastLaunchContext` namespace (NAM-1937):
+ *
+ *   - `LastLaunchContext.placement`            → previous launch's placement label
+ *   - `LastLaunchContext.tags`                 → previous launch's placement tags
+ *   - `LastLaunchContext.customAttributes.<k>` → a custom attribute from the previous launch
+ *
+ * When there is no previous launch (first launch of the session), every key
+ * resolves to `undefined`. The condition evaluator's existing null-state
+ * handling then makes `equals`/`set` false and `not_set` true — so the
+ * resolver deliberately does not special-case any operator.
+ */
+class LastLaunchContextResolver extends BaseNamespaceResolver {
+    constructor() {
+        super(...arguments);
+        this.namespace = "LastLaunchContext";
+    }
+    // Exposed publicly so callers register explicitly (consistent with how this
+    // resolver is wired from NamiFlow and exercised in tests). Unlike the other
+    // resolvers it does not auto-register from its constructor because it reads
+    // live store state rather than capturing per-launch context.
+    register() {
+        super.register();
+    }
+    resolveValue(keyPath) {
+        const previous = LastLaunchStore.shared.previous;
+        if (!previous) {
+            return undefined;
+        }
+        if (keyPath === "placement") {
+            return previous.placementLabel;
+        }
+        if (keyPath === "tags") {
+            return previous.tags;
+        }
+        if (keyPath.startsWith("customAttributes.")) {
+            const innerPath = keyPath.substring("customAttributes.".length);
+            return this.resolveKeyPath(innerPath, previous.customAttributes);
+        }
+        return undefined;
+    }
+}
+
 /**
  * Represents the possible account actions states that can be returned by callback registered from
  * [NamiCustomerManager.registerAccountStateHandler]
@@ -14747,7 +14843,7 @@ class NamiFlow extends BasicNamiFlow {
     applyLaunchContextAttributes(attrs) {
         if (!this.context) {
             this.context = { customAttributes: {} };
-            new LaunchContextResolver(this.context);
+            new LaunchContextResolver(this.context, this.campaign);
         }
         // Guard against a runtime-supplied context that omits customAttributes
         // (the field is required by the type but may be absent in untyped JSON).
@@ -14757,12 +14853,13 @@ class NamiFlow extends BasicNamiFlow {
     }
     registerResolvers(context) {
         if (context) {
-            new LaunchContextResolver(context);
+            new LaunchContextResolver(context, this.campaign);
         }
         new DeviceResolver();
         new URLParamsResolver();
         new FormStateResolver();
         new PlacementLabelResolver(this.campaign);
+        new LastLaunchContextResolver().register();
         NamiConditionEvaluator.shared.registerNamespaceResolver('Flow', (identifier) => {
             switch (identifier) {
                 case 'Flow.stepcrumbs':
@@ -15615,7 +15712,11 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
         const data = startupTelemetry.firstLaunchLookup(value, () => getPaywallDataFromLabel(value, type));
         let paywall = data.paywall;
         const campaign = data.campaign;
-        if (!campaign || (!paywall && !campaign.flow)) {
+        // Captured before the degenerate branch below clobbers `paywall` to `{}`,
+        // so a not-found launch is correctly distinguishable from a real one when
+        // deciding whether to record into LastLaunchStore (NAM-1937).
+        const campaignNotFound = !campaign || (!paywall && !campaign.flow);
+        if (campaignNotFound) {
             let error;
             if (!label && !withUrl) {
                 error = LaunchCampaignError.DEFAULT_CAMPAIGN_NOT_FOUND;
@@ -15666,6 +15767,23 @@ let NamiCampaignManager$2 = class NamiCampaignManager {
             resultCallback(false, LaunchCampaignError.FLOW_SCREEN_DATA_UNAVILABLE);
             throw new FlowScreensNotAvailableError();
         }
+        // Record this launch into the two-slot Last Launch store BEFORE the flow
+        // resolvers read it. The just-launched placement becomes `current`; the
+        // prior launch is demoted to `previous`, which flow conditions read via
+        // the LastLaunchContext namespace (NAM-1937).
+        //
+        // Only record when a real placement is actually being launched. The
+        // not-found/degenerate path above sets `paywall = {}` and falls through
+        // (the throw is commented out); recording there would store a bogus
+        // failed-launch record AND demote the real `current`, breaking the
+        // two-slot/PPO guarantee for the next real launch.
+        if (!campaignNotFound) {
+            LastLaunchStore.shared.record({
+                placementLabel: campaign?.value ?? value ?? "",
+                tags: campaign?.placement_tags ?? [],
+                customAttributes: (context?.customAttributes ?? {}),
+            });
+        }
         const component = getPlatformAdapters().ui.createPaywall(type, value, context);
         // Generate and store launch ID for successful campaign launch
         const launchId = generateUUID();

package/package.json

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