@namiml/sdk-core 3.4.1-dev.202605270014 → 3.4.1-dev.202605272004

package/dist/index.cjs

@@ -98,7 +98,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.4.1", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.1-dev.202605270014", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.4.1-dev.202605272004", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -12412,6 +12412,7 @@ exports.NamiFlowActionFunction = void 0;
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
+    NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
 })(exports.NamiFlowActionFunction || (exports.NamiFlowActionFunction = {}));
 const HandoffTag = {
     SEQUENCE: '__handoff_sequence__',
@@ -13950,6 +13951,16 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(entry.id);
         }
     }
+    applyLaunchContextAttributes(attrs) {
+        if (!this.context) {
+            this.context = { customAttributes: {} };
+            new LaunchContextResolver(this.context);
+        }
+        // Guard against a runtime-supplied context that omits customAttributes
+        // (the field is required by the type but may be absent in untyped JSON).
+        this.context.customAttributes ??= {};
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14206,6 +14217,9 @@ class NamiFlow extends BasicNamiFlow {
                     this.back();
                     break;
                 case exports.NamiFlowActionFunction.NEXT:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         this.forward(action.parameters.step);
                     }
@@ -14214,6 +14228,9 @@ class NamiFlow extends BasicNamiFlow {
                     }
                     break;
                 case exports.NamiFlowActionFunction.NAVIGATE:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         if (this.previousFlowStep?.id === action.parameters.step) {
                             this.back();
@@ -14339,6 +14356,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case exports.NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes (matches the nav-action customAttributes wire shape
+                    // and the { key, value } shape used by Apple/Android/Roku). We deliberately
+                    // do NOT treat arbitrary top-level parameters as attributes, to avoid writing
+                    // reserved keys (step, delay, …) into the launch context.
+                    const params = action.parameters;
+                    if (params?.customAttributes) {
+                        this.applyLaunchContextAttributes(params.customAttributes);
+                    }
+                    else if (params?.key !== undefined && params?.value !== undefined) {
+                        this.applyLaunchContextAttributes({ [params.key]: params.value });
+                    }
+                    break;
+                }
                 default:
                     logger.warn(`Missing action handler for ${action.function}`, action);
                     break;

package/dist/index.d.ts

@@ -130,7 +130,8 @@ declare enum NamiFlowActionFunction {
     FLOW_DISABLED = "flowInteractionDisabled",
     SET_TAGS = "setTags",
     PAUSE = "flowPause",
-    RESUME = "flowResume"
+    RESUME = "flowResume",
+    SET_LAUNCH_CONTEXT = "setLaunchContext"
 }
 type NamiFlowHandoffStepHandler = (handoffTag: string, handoffData?: Record<string, any>) => void;
 type NamiFlowEventHandler = (eventHandler: Record<string, any>) => void;
@@ -1429,6 +1430,7 @@ declare class NamiFlow extends BasicNamiFlow {
         [timerId: string]: TimerState;
     };
     constructor(campaign: NamiFlowCampaign, paywall: PaywallHandle, manager: NamiFlowManager, context?: NamiPaywallLaunchContext);
+    private applyLaunchContextAttributes;
     private registerResolvers;
     get currentFlowStep(): NamiFlowStep | undefined;
     get nextStepAvailable(): boolean;

package/dist/index.mjs

@@ -96,7 +96,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.4.1", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.4.1-dev.202605270014", 
+NAMI_SDK_PACKAGE_VERSION = "3.4.1-dev.202605272004", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -12410,6 +12410,7 @@ var NamiFlowActionFunction;
     NamiFlowActionFunction["SET_TAGS"] = "setTags";
     NamiFlowActionFunction["PAUSE"] = "flowPause";
     NamiFlowActionFunction["RESUME"] = "flowResume";
+    NamiFlowActionFunction["SET_LAUNCH_CONTEXT"] = "setLaunchContext";
 })(NamiFlowActionFunction || (NamiFlowActionFunction = {}));
 const HandoffTag = {
     SEQUENCE: '__handoff_sequence__',
@@ -13948,6 +13949,16 @@ class NamiFlow extends BasicNamiFlow {
             this.forward(entry.id);
         }
     }
+    applyLaunchContextAttributes(attrs) {
+        if (!this.context) {
+            this.context = { customAttributes: {} };
+            new LaunchContextResolver(this.context);
+        }
+        // Guard against a runtime-supplied context that omits customAttributes
+        // (the field is required by the type but may be absent in untyped JSON).
+        this.context.customAttributes ??= {};
+        Object.assign(this.context.customAttributes, attrs);
+    }
     registerResolvers(context) {
         if (context) {
             new LaunchContextResolver(context);
@@ -14204,6 +14215,9 @@ class NamiFlow extends BasicNamiFlow {
                     this.back();
                     break;
                 case NamiFlowActionFunction.NEXT:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         this.forward(action.parameters.step);
                     }
@@ -14212,6 +14226,9 @@ class NamiFlow extends BasicNamiFlow {
                     }
                     break;
                 case NamiFlowActionFunction.NAVIGATE:
+                    if (action.parameters?.customAttributes) {
+                        this.applyLaunchContextAttributes(action.parameters.customAttributes);
+                    }
                     if (action.parameters?.step) {
                         if (this.previousFlowStep?.id === action.parameters.step) {
                             this.back();
@@ -14337,6 +14354,20 @@ class NamiFlow extends BasicNamiFlow {
                         });
                     }
                     break;
+                case NamiFlowActionFunction.SET_LAUNCH_CONTEXT: {
+                    // Two supported shapes (matches the nav-action customAttributes wire shape
+                    // and the { key, value } shape used by Apple/Android/Roku). We deliberately
+                    // do NOT treat arbitrary top-level parameters as attributes, to avoid writing
+                    // reserved keys (step, delay, …) into the launch context.
+                    const params = action.parameters;
+                    if (params?.customAttributes) {
+                        this.applyLaunchContextAttributes(params.customAttributes);
+                    }
+                    else if (params?.key !== undefined && params?.value !== undefined) {
+                        this.applyLaunchContextAttributes({ [params.key]: params.value });
+                    }
+                    break;
+                }
                 default:
                     logger.warn(`Missing action handler for ${action.function}`, action);
                     break;

package/package.json

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