@namiml/sdk-core 3.4.0-dev.202605180118 → 3.4.0-dev.202605182046

package/dist/index.cjs

@@ -98,7 +98,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605180118", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605182046", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -7404,19 +7404,34 @@ const mapAnonymousCampaigns = (campaigns, splitPosition, formFactor) => {
     });
 };
 /**
+ * Returns the combined list of API + initial-config campaigns for the current device's
+ * form factor, deduplicated by (type, value) with API entries winning on collision.
  *
- * @returns A combined list of unique campaigns based on both API and Initial, filtered by form factor.
- * This is used to get all campaigns that are applicable to the current device.
+ * Mirrors NamiCampaignManager.allCampaigns() on Apple (Set keyed on hash(value, type))
+ * and Android (.distinct() with server-first ordering). Keying on (type, value) — rather
+ * than rule UUID — ensures the same logical placement does not surface twice when the
+ * server has republished a campaign under a new rule id.
  *
- * Note: Since this function returns a unique list of campaigns, and API campaigns take precedence,
- * there may be times when API campaigns are returned that do not yet have paywalls but initial campaigns would.
+ * Note: this list reflects which placements are available, not whether they are launchable.
+ * An API entry surfaced here may reference a paywall that has not yet been published in the
+ * API response. NamiCampaignManager.launch() handles that case independently via
+ * getPaywallDataFromLabel(), which falls back to the initial-config (campaign, paywall) pair
+ * when the API pair is incomplete — matching the merged-paywall-lookup behavior on
+ * Apple and Android.
  */
 const allCampaigns = () => {
     const apiCampaigns = storageService.getCampaignRules(exports.API_CAMPAIGN_RULES) ?? [];
     const initialCampaigns = storageService.getCampaignRules(exports.INITIAL_CAMPAIGN_RULES) ?? [];
     const formFactor = getDeviceFormFactor();
     const campaigns = compact([...apiCampaigns, ...initialCampaigns]).filter((cRule) => cRule.form_factors?.some((f) => f.form_factor === formFactor));
-    return uniqBy(campaigns, "rule");
+    const seen = new Set();
+    return campaigns.filter((c) => {
+        const key = `${c.type ?? ''}::${c.value ?? ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
 };
 /**
  * Get campaigns by rule key, filtered by form factor.
@@ -13670,6 +13685,19 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(nextStep.id);
         }
     }
+    handleRemoteBack() {
+        const step = this.currentFlowStep;
+        if (step?.actions[NamiReservedActions.REMOTE_BACK]) {
+            this.triggerActions(NamiReservedActions.REMOTE_BACK);
+            return 'handler';
+        }
+        if (this.previousStepAvailable) {
+            this.back();
+            return 'back';
+        }
+        this.finished();
+        return 'dismissed';
+    }
     backToPreviousScreenStep() {
         if (this.previousFlowStep?.allow_back_to === false) {
             logger.warn(`Not allowed to go back to ${this.previousFlowStep.id}`);

package/dist/index.d.ts

@@ -113,6 +113,7 @@ declare const NamiFlowStepType: {
     readonly UNKNOWN: "unknown";
 };
 type NamiFlowStepType = (typeof NamiFlowStepType)[keyof typeof NamiFlowStepType];
+type RemoteBackOutcome = 'handler' | 'back' | 'dismissed';
 declare enum NamiFlowActionFunction {
     NAVIGATE = "flowNav",
     BACK = "flowPrev",
@@ -1429,6 +1430,7 @@ declare class NamiFlow extends BasicNamiFlow {
     finished(): void;
     back(): void;
     next(): void;
+    handleRemoteBack(): RemoteBackOutcome;
     private backToPreviousScreenStep;
     forward(stepId: string): void;
     pause(): void;
@@ -2751,12 +2753,20 @@ declare const bestUrlCampaignMatch: (incomingUrl: string, campaigns: NamiCampaig
 declare const selectSegment: (segments: NamiCampaignSegment[], splitPosition: number) => NamiCampaignSegment;
 declare const mapAnonymousCampaigns: (campaigns: NamiAnonymousCampaign[], splitPosition: number, formFactor?: TDevice) => NamiCampaign[];
 /**
+ * Returns the combined list of API + initial-config campaigns for the current device's
+ * form factor, deduplicated by (type, value) with API entries winning on collision.
  *
- * @returns A combined list of unique campaigns based on both API and Initial, filtered by form factor.
- * This is used to get all campaigns that are applicable to the current device.
+ * Mirrors NamiCampaignManager.allCampaigns() on Apple (Set keyed on hash(value, type))
+ * and Android (.distinct() with server-first ordering). Keying on (type, value) — rather
+ * than rule UUID — ensures the same logical placement does not surface twice when the
+ * server has republished a campaign under a new rule id.
  *
- * Note: Since this function returns a unique list of campaigns, and API campaigns take precedence,
- * there may be times when API campaigns are returned that do not yet have paywalls but initial campaigns would.
+ * Note: this list reflects which placements are available, not whether they are launchable.
+ * An API entry surfaced here may reference a paywall that has not yet been published in the
+ * API response. NamiCampaignManager.launch() handles that case independently via
+ * getPaywallDataFromLabel(), which falls back to the initial-config (campaign, paywall) pair
+ * when the API pair is incomplete — matching the merged-paywall-lookup behavior on
+ * Apple and Android.
  */
 declare const allCampaigns: () => NamiCampaign[];
 declare const getInitialCampaigns: () => NamiCampaign[];

package/dist/index.mjs

@@ -96,7 +96,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605180118", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.0-dev.202605182046", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -7402,19 +7402,34 @@ const mapAnonymousCampaigns = (campaigns, splitPosition, formFactor) => {
     });
 };
 /**
+ * Returns the combined list of API + initial-config campaigns for the current device's
+ * form factor, deduplicated by (type, value) with API entries winning on collision.
  *
- * @returns A combined list of unique campaigns based on both API and Initial, filtered by form factor.
- * This is used to get all campaigns that are applicable to the current device.
+ * Mirrors NamiCampaignManager.allCampaigns() on Apple (Set keyed on hash(value, type))
+ * and Android (.distinct() with server-first ordering). Keying on (type, value) — rather
+ * than rule UUID — ensures the same logical placement does not surface twice when the
+ * server has republished a campaign under a new rule id.
  *
- * Note: Since this function returns a unique list of campaigns, and API campaigns take precedence,
- * there may be times when API campaigns are returned that do not yet have paywalls but initial campaigns would.
+ * Note: this list reflects which placements are available, not whether they are launchable.
+ * An API entry surfaced here may reference a paywall that has not yet been published in the
+ * API response. NamiCampaignManager.launch() handles that case independently via
+ * getPaywallDataFromLabel(), which falls back to the initial-config (campaign, paywall) pair
+ * when the API pair is incomplete — matching the merged-paywall-lookup behavior on
+ * Apple and Android.
  */
 const allCampaigns = () => {
     const apiCampaigns = storageService.getCampaignRules(API_CAMPAIGN_RULES) ?? [];
     const initialCampaigns = storageService.getCampaignRules(INITIAL_CAMPAIGN_RULES) ?? [];
     const formFactor = getDeviceFormFactor();
     const campaigns = compact([...apiCampaigns, ...initialCampaigns]).filter((cRule) => cRule.form_factors?.some((f) => f.form_factor === formFactor));
-    return uniqBy(campaigns, "rule");
+    const seen = new Set();
+    return campaigns.filter((c) => {
+        const key = `${c.type ?? ''}::${c.value ?? ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
 };
 /**
  * Get campaigns by rule key, filtered by form factor.
@@ -13668,6 +13683,19 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(nextStep.id);
         }
     }
+    handleRemoteBack() {
+        const step = this.currentFlowStep;
+        if (step?.actions[NamiReservedActions.REMOTE_BACK]) {
+            this.triggerActions(NamiReservedActions.REMOTE_BACK);
+            return 'handler';
+        }
+        if (this.previousStepAvailable) {
+            this.back();
+            return 'back';
+        }
+        this.finished();
+        return 'dismissed';
+    }
     backToPreviousScreenStep() {
         if (this.previousFlowStep?.allow_back_to === false) {
             logger.warn(`Not allowed to go back to ${this.previousFlowStep.id}`);

package/package.json

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