@amplytools/react-native-amply-sdk 0.13.0 → 0.15.0

package/AmplyReactNative.podspec

@@ -22,7 +22,7 @@ Pod::Spec.new do |s|
   s.dependency 'React-RCTFabric'
 
   # Amply KMP SDK from CocoaPods
-  s.dependency 'AmplySDK', '~> 0.13.0'
+  s.dependency 'AmplySDK', '~> 0.15.0'
 
   s.libraries = 'c++'
   s.pod_target_xcconfig = {

package/README.md

@@ -13,6 +13,7 @@ React Native TurboModule bridge for the Amply SDK. Enables event tracking, deepl
 | Debug/Logging | ✅ | Android, iOS |
 | Custom properties | ✅ | Android, iOS |
 | User identification | ✅ | Android, iOS |
+| Last campaign touch (attribution in your analytics) | ✅ | Android, iOS |
 
 ## Requirements
 
@@ -60,6 +61,12 @@ await Amply.track({
 // Identify users
 Amply.setUserId('user-123');
 
+// If your app picks its UI language itself (an in-app picker, i18next, …), tell Amply,
+// so campaigns show in that language. Any common format: 'pt_BR', 'pt-BR', 'zh-TW', 'fr'.
+// Persisted across launches; pass null to go back to following the device.
+// Can also be given up front: Amply.initialize({ ..., appLanguage: 'pt_BR' }).
+Amply.setAppLanguage('pt_BR'); // e.g. i18next's i18n.language
+
 // Set custom properties for targeting
 Amply.setCustomProperties({ plan: 'premium', onboarded: true });
 
@@ -69,6 +76,46 @@ const unsubscribe = await Amply.addDeepLinkListener((event) => {
 });
 ```
 
+### Debug launch
+
+Amply can open a campaign on a real device from a link or QR code made in the dashboard, so you
+can click through it inside your app. The link uses your app's URL scheme, so the app has to pass
+incoming links to Amply:
+
+```typescript
+import {Linking} from 'react-native';
+import Amply from '@amplytools/react-native-amply-sdk';
+
+const forward = (url: string | null) => {
+  if (url && Amply.handleUrl(url)) {
+    return; // an Amply link: Amply took it, do not route it
+  }
+  // ...your own link handling
+};
+
+Linking.getInitialURL().then(forward);
+Linking.addEventListener('url', ({url}) => forward(url));
+```
+
+`handleUrl` returns `true` when Amply recognised the link as its own, and `false` for any other
+link (it never throws). It is fine to call it before `initialize` finishes, as on a cold start: an Amply link that arrives early is held (the newest one) and opened as soon as `initialize` succeeds; it is dropped if `initialize` fails. A
+campaign launched this way is not counted in statistics.
+
+With Expo Router, links are routed before your code sees them, so forward only from
+`app/+native-intent.tsx` (and do not also forward with `Linking` above). An Amply link reaches the
+SDK instead of the not-found screen, and every other link is routed as usual:
+
+```typescript
+import Amply from '@amplytools/react-native-amply-sdk';
+
+export function redirectSystemPath({path}: {path: string; initial: boolean}) {
+  if (Amply.handleUrl(path)) {
+    return '/'; // an Amply link: Amply took it
+  }
+  return path;
+}
+```
+
 ### About the keys
 
 `apiKeySecret` ships inside your app: the SDK signs every request with it on the device. Keep it

package/android/build.gradle

@@ -15,7 +15,7 @@ buildscript {
 apply plugin: 'com.android.library'
 apply plugin: 'org.jetbrains.kotlin.android'
 
-def amplySdkVersion = project.findProperty('amplySdkVersion') ?: System.getenv('AMPLY_SDK_VERSION') ?: '0.13.0'
+def amplySdkVersion = project.findProperty('amplySdkVersion') ?: System.getenv('AMPLY_SDK_VERSION') ?: '0.15.0'
 group = 'tools.amply'
 version = amplySdkVersion
 

package/android/src/main/java/tools/amply/sdk/reactnative/AmplyModule.kt

@@ -5,6 +5,7 @@ import tools.amply.sdk.reactnative.core.AmplyClient
 import tools.amply.sdk.reactnative.core.DefaultAmplyClient
 import tools.amply.sdk.reactnative.core.GateDecision
 import tools.amply.sdk.reactnative.model.AmplyInitializationOptions
+import tools.amply.sdk.reactnative.model.CampaignTouchPayload
 import tools.amply.sdk.reactnative.model.DataSetType
 import tools.amply.sdk.reactnative.model.DataSetType.EventParam
 import tools.amply.sdk.reactnative.model.DataSetType.Events
@@ -153,6 +154,16 @@ class AmplyModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun getLastCampaignTouch(withinMs: Double, promise: Promise) {
+    scope.launch {
+      try {
+        promise.resolve(client.getLastCampaignTouch(withinMs.toLong())?.toWritableMap())
+      } catch (throwable: Throwable) {
+        promise.reject(CAMPAIGN_TOUCH_ERROR, throwable)
+      }
+    }
+  }
+
   override fun getDataSetSnapshot(type: ReadableMap, promise: Promise) {
     val datasetType = try {
       type.toDataSetType()
@@ -195,6 +206,12 @@ class AmplyModule(reactContext: ReactApplicationContext) :
     client.setUserId(userId)
   }
 
+  override fun setAppLanguage(tag: String?) {
+    client.setAppLanguage(tag)
+  }
+
+  override fun handleUrl(url: String): Boolean = client.handleUrl(url)
+
   override fun setLogLevel(level: String) {
     val newLevel = LogLevel.fromString(level)
     client.setLogLevel(newLevel)
@@ -354,6 +371,9 @@ class AmplyModule(reactContext: ReactApplicationContext) :
     val defaultConfig = if (hasKey("defaultConfig")) getString("defaultConfig") else null
     val debug = if (hasKey("debug")) getBoolean("debug") else null
     val logLevel = if (hasKey("logLevel")) LogLevel.fromString(getString("logLevel")) else null
+    // Blank names no language: left out rather than handed to the SDK to be warned about.
+    val appLanguage = (if (hasKey("appLanguage")) getString("appLanguage") else null)
+      ?.takeIf { it.isNotBlank() }
 
     return AmplyInitializationOptions(
       appId = appId,
@@ -365,6 +385,7 @@ class AmplyModule(reactContext: ReactApplicationContext) :
       defaultConfig = defaultConfig,
       debug = debug,
       logLevel = logLevel,
+      appLanguage = appLanguage,
     )
   }
 
@@ -419,6 +440,14 @@ class AmplyModule(reactContext: ReactApplicationContext) :
       putMap("properties", properties.toWritableMap())
     }
 
+  private fun CampaignTouchPayload.toWritableMap(): WritableMap =
+    Arguments.createMap().apply {
+      putString("campaignId", campaignId)
+      putString("campaignName", campaignName)
+      putString("kind", kind)
+      putDouble("atMs", atMs.toDouble())
+    }
+
   private fun List<EventEnvelope>.toWritableArray(): WritableArray {
     val array = Arguments.createArray()
     forEach { event ->
@@ -522,6 +551,7 @@ class AmplyModule(reactContext: ReactApplicationContext) :
     private const val ARGUMENT_ERROR = "AMP_INVALID_ARGUMENT"
     private const val TRACK_ERROR = "AMP_TRACK_FAILED"
     private const val EVENTS_ERROR = "AMP_EVENTS_FAILED"
+    private const val CAMPAIGN_TOUCH_ERROR = "AMP_CAMPAIGN_TOUCH_FAILED"
     private const val DATASET_ERROR = "AMP_DATASET_FAILED"
     private const val CUSTOM_PROP_ERROR = "AMP_CUSTOM_PROP_FAILED"
   }

package/android/src/main/java/tools/amply/sdk/reactnative/core/AmplyClient.kt

@@ -2,6 +2,7 @@ package tools.amply.sdk.reactnative.core
 
 import android.app.Activity
 import tools.amply.sdk.reactnative.model.AmplyInitializationOptions
+import tools.amply.sdk.reactnative.model.CampaignTouchPayload
 import tools.amply.sdk.reactnative.model.DataSetType
 import tools.amply.sdk.reactnative.model.DeepLinkPayload
 import tools.amply.sdk.reactnative.model.EventEnvelope
@@ -65,6 +66,13 @@ interface AmplyClient {
 
   suspend fun getRecentEvents(limit: Int): List<EventEnvelope>
 
+  /**
+   * The SDK's `getLastCampaignTouch(withinMs)`: the newest campaign touch at most [withinMs] ago
+   * (clamped by the SDK to [0, 30 days]). Null when there is none, and also before
+   * initialisation — the SDK answers null there rather than throwing, and so does the bridge.
+   */
+  suspend fun getLastCampaignTouch(withinMs: Long): CampaignTouchPayload?
+
   suspend fun getDataSetSnapshot(type: DataSetType): Map<String, Any?>
 
   fun registerDeepLinkListener()
@@ -72,6 +80,11 @@ interface AmplyClient {
 
   fun setUserId(userId: String?)
 
+  fun setAppLanguage(tag: String?)
+
+  /** True when the SDK recognised [url] as its own and took it over; false otherwise or when not initialised. */
+  fun handleUrl(url: String): Boolean
+
   fun setLogLevel(level: LogLevel)
   fun getLogLevel(): LogLevel
 

package/android/src/main/java/tools/amply/sdk/reactnative/core/DefaultAmplyClient.kt

@@ -5,6 +5,7 @@ import android.app.Application
 import android.os.Handler
 import android.os.Looper
 import tools.amply.sdk.reactnative.model.AmplyInitializationOptions
+import tools.amply.sdk.reactnative.model.CampaignTouchPayload
 import tools.amply.sdk.reactnative.model.DataSetType
 import tools.amply.sdk.reactnative.model.DeepLinkPayload
 import tools.amply.sdk.reactnative.model.EventEnvelope
@@ -30,6 +31,8 @@ import tools.amply.sdk.actions.CampaignPresenter
 import tools.amply.sdk.actions.CampaignResolution
 import tools.amply.sdk.actions.CampaignResult
 import tools.amply.sdk.actions.DeepLinkListener
+import tools.amply.sdk.campaigns.CampaignTouch
+import tools.amply.sdk.campaigns.CampaignTouchKind
 import tools.amply.sdk.core.GateDecision as KmpGateDecision
 import tools.amply.sdk.core.ProceedReason as KmpProceedReason
 import tools.amply.sdk.config.AmplyConfig
@@ -291,6 +294,26 @@ class DefaultAmplyClient(
     }
   }
 
+  override suspend fun getLastCampaignTouch(withinMs: Long): CampaignTouchPayload? {
+    // Not requireInstance(): "not initialised" is an answer here (null), as it is in the SDK.
+    val instance = amplyInstance ?: return null
+    return withContext(Dispatchers.IO) {
+      instance.getLastCampaignTouch(withinMs)?.toPayload()
+    }
+  }
+
+  private fun CampaignTouch.toPayload(): CampaignTouchPayload = CampaignTouchPayload(
+    campaignId = campaignId,
+    campaignName = campaignName,
+    // Exhaustive on purpose: a kind added to the SDK must fail this build, not reach JS as a
+    // value the TS type does not admit.
+    kind = when (kind) {
+      CampaignTouchKind.SHOWN -> "shown"
+      CampaignTouchKind.ENGAGED -> "engaged"
+    },
+    atMs = atMs,
+  )
+
   override suspend fun getDataSetSnapshot(type: DataSetType): Map<String, Any?> {
     val instance = requireInstance()
     val nativeType = type.toNativeDataSetType()
@@ -385,6 +408,27 @@ class DefaultAmplyClient(
     }
   }
 
+  override fun setAppLanguage(tag: String?) {
+    // Buffered like setUserId. The JS layer already holds a pre-init call and folds it into the
+    // config, so this only catches a call that reaches native before the instance exists anyway.
+    synchronized(propertyLock) {
+      val instance = amplyInstance
+      if (instance != null) {
+        instance.setAppLanguage(tag)
+        android.util.Log.i("AmplyReactNative", "App language set to: ${tag ?: "<null>"}")
+      } else {
+        android.util.Log.i("AmplyReactNative", "Buffering setAppLanguage until init")
+        pendingPropertyOps.add { it.setAppLanguage(tag) }
+      }
+    }
+  }
+
+  override fun handleUrl(url: String): Boolean {
+    // Not buffered: a link is only meaningful to a live SDK, and the answer is needed right now.
+    val instance = amplyInstance ?: return false
+    return instance.handleUrl(url)
+  }
+
   override fun setCustomProperty(key: String, value: Any) {
     synchronized(propertyLock) {
       val instance = amplyInstance
@@ -534,6 +578,8 @@ class DefaultAmplyClient(
         }
       }
       options.defaultConfig?.let { defaultConfig = it }
+      // Same as setAppLanguage at init; the SDK applies it while building the instance.
+      options.appLanguage?.let { appLanguage = it }
     }
   }
 

package/android/src/main/java/tools/amply/sdk/reactnative/model/AmplyInitializationOptions.kt

@@ -35,6 +35,8 @@ data class AmplyInitializationOptions(
   val defaultConfig: String?,
   val debug: Boolean?,
   val logLevel: LogLevel?,
+  /** The app's UI language, any common tag format. Same as setAppLanguage at init. */
+  val appLanguage: String? = null,
 ) {
     /**
      * Get the effective log level, resolving debug vs logLevel precedence.

package/android/src/main/java/tools/amply/sdk/reactnative/model/CampaignTouchPayload.kt

@@ -0,0 +1,12 @@
+package tools.amply.sdk.reactnative.model
+
+/**
+ * The bridge's copy of the SDK's `CampaignTouch`, with [kind] already in its JS spelling
+ * (`"shown"` / `"engaged"`).
+ */
+data class CampaignTouchPayload(
+  val campaignId: String,
+  val campaignName: String,
+  val kind: String,
+  val atMs: Long,
+)

package/android/src/newarch/java/tools/amply/sdk/reactnative/NativeAmplyModuleSpec.java

@@ -78,6 +78,10 @@ public abstract class NativeAmplyModuleSpec extends ReactContextBaseJavaModule i
   @DoNotStrip
   public abstract void getRecentEvents(double limit, Promise promise);
 
+  @ReactMethod
+  @DoNotStrip
+  public abstract void getLastCampaignTouch(double withinMs, Promise promise);
+
   @ReactMethod
   @DoNotStrip
   public abstract void getDataSetSnapshot(ReadableMap type, Promise promise);
@@ -90,6 +94,14 @@ public abstract class NativeAmplyModuleSpec extends ReactContextBaseJavaModule i
   @DoNotStrip
   public abstract void setUserId(@Nullable String userId);
 
+  @ReactMethod
+  @DoNotStrip
+  public abstract void setAppLanguage(@Nullable String tag);
+
+  @ReactMethod(isBlockingSynchronousMethod = true)
+  @DoNotStrip
+  public abstract boolean handleUrl(String url);
+
   @ReactMethod
   @DoNotStrip
   public abstract void setLogLevel(String level);

package/android/src/newarch/jni/AmplyReactNative-generated.cpp

@@ -52,6 +52,11 @@ static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_getRecentEve
   return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "getRecentEvents", "(DLcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
 }
 
+static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_getLastCampaignTouch(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "getLastCampaignTouch", "(DLcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
+}
+
 static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_getDataSetSnapshot(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
   static jmethodID cachedMethodId = nullptr;
   return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, PromiseKind, "getDataSetSnapshot", "(Lcom/facebook/react/bridge/ReadableMap;Lcom/facebook/react/bridge/Promise;)V", args, count, cachedMethodId);
@@ -67,6 +72,16 @@ static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_setUserId(fa
   return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "setUserId", "(Ljava/lang/String;)V", args, count, cachedMethodId);
 }
 
+static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_setAppLanguage(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "setAppLanguage", "(Ljava/lang/String;)V", args, count, cachedMethodId);
+}
+
+static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_handleUrl(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
+  static jmethodID cachedMethodId = nullptr;
+  return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, BooleanKind, "handleUrl", "(Ljava/lang/String;)Z", args, count, cachedMethodId);
+}
+
 static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_setLogLevel(facebook::jsi::Runtime& rt, TurboModule &turboModule, const facebook::jsi::Value* args, size_t count) {
   static jmethodID cachedMethodId = nullptr;
   return static_cast<JavaTurboModule &>(turboModule).invokeJavaMethod(rt, VoidKind, "setLogLevel", "(Ljava/lang/String;)V", args, count, cachedMethodId);
@@ -117,9 +132,12 @@ NativeAmplyModuleSpecJSI::NativeAmplyModuleSpecJSI(const JavaTurboModule::InitPa
   methodMap_["registerGate"] = MethodMetadata {3, __hostFunction_NativeAmplyModuleSpecJSI_registerGate};
   methodMap_["unregisterGate"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_unregisterGate};
   methodMap_["getRecentEvents"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_getRecentEvents};
+  methodMap_["getLastCampaignTouch"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_getLastCampaignTouch};
   methodMap_["getDataSetSnapshot"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_getDataSetSnapshot};
   methodMap_["registerDeepLinkListener"] = MethodMetadata {0, __hostFunction_NativeAmplyModuleSpecJSI_registerDeepLinkListener};
   methodMap_["setUserId"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_setUserId};
+  methodMap_["setAppLanguage"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_setAppLanguage};
+  methodMap_["handleUrl"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_handleUrl};
   methodMap_["setLogLevel"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_setLogLevel};
   methodMap_["getLogLevel"] = MethodMetadata {0, __hostFunction_NativeAmplyModuleSpecJSI_getLogLevel};
   methodMap_["setCustomProperties"] = MethodMetadata {1, __hostFunction_NativeAmplyModuleSpecJSI_setCustomProperties};

package/dist/src/__tests__/appLanguage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=appLanguage.test.d.ts.map

package/dist/src/__tests__/appLanguage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appLanguage.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/appLanguage.test.ts"],"names":[],"mappings":"AAySA,OAAO,EAAE,CAAC"}

package/dist/src/__tests__/appLanguage.test.js

@@ -0,0 +1,211 @@
+function createNativeModule() {
+    let initialized = false;
+    return {
+        initialize: jest.fn(async () => {
+            initialized = true;
+        }),
+        isInitialized: jest.fn(() => initialized),
+        setAppLanguage: jest.fn(),
+        setUserId: jest.fn(),
+        addListener: jest.fn(),
+        removeListeners: jest.fn(),
+        onSystemEvent: jest.fn(() => ({ remove: jest.fn() })),
+        onDeepLink: jest.fn(() => ({ remove: jest.fn() })),
+        onCampaignPresent: jest.fn(() => ({ remove: jest.fn() })),
+        /** Test-only: pretend the SDK is (or is not) up without going through initialize. */
+        setInitialized(value) {
+            initialized = value;
+        },
+    };
+}
+const KEYS = { appId: 'id', apiKeyPublic: 'public', apiKeySecret: 'secret' };
+function load() {
+    let Amply;
+    const native = createNativeModule();
+    jest.isolateModules(() => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('../nativeModule').__setNativeModule(native);
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        Amply = require('../index');
+    });
+    return { Amply, native };
+}
+describe('setAppLanguage after initialization', () => {
+    it.each(['pt_BR', 'zh-TW', 'FR', 'Français'])('forwards %p to the native SDK verbatim — parsing and the warning for junk are the SDK’s job', tag => {
+        const { Amply, native } = load();
+        native.setInitialized(true);
+        Amply.setAppLanguage(tag);
+        expect(native.setAppLanguage).toHaveBeenCalledTimes(1);
+        expect(native.setAppLanguage).toHaveBeenCalledWith(tag);
+    });
+    it('forwards null, which returns the SDK to automatic detection', () => {
+        const { Amply, native } = load();
+        native.setInitialized(true);
+        Amply.setAppLanguage(null);
+        expect(native.setAppLanguage).toHaveBeenCalledWith(null);
+    });
+    it('is on the default export as well', () => {
+        const { Amply, native } = load();
+        native.setInitialized(true);
+        Amply.default.setAppLanguage('de');
+        expect(native.setAppLanguage).toHaveBeenCalledWith('de');
+    });
+});
+describe('appLanguage in the initialization config', () => {
+    it('is passed through to the native initialize', async () => {
+        const { Amply, native } = load();
+        await Amply.initialize({ ...KEYS, appLanguage: 'pt_BR' });
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'pt_BR' }));
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+    });
+    it('is left out of the native config when the caller did not give one', async () => {
+        const { Amply, native } = load();
+        await Amply.initialize(KEYS);
+        const [config] = native.initialize.mock.calls[0];
+        expect(config).not.toHaveProperty('appLanguage');
+    });
+});
+describe('setAppLanguage before initialization', () => {
+    it('is not sent to a native SDK that is not up yet', () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+    });
+    it('reaches the SDK as the config appLanguage when initialize names none', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        await Amply.initialize(KEYS);
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'fr' }));
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+    });
+    it('keeps only the last of several calls', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        Amply.setAppLanguage('de');
+        await Amply.initialize(KEYS);
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'de' }));
+    });
+    it('loses to an appLanguage given to the later initialize call', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        await Amply.initialize({ ...KEYS, appLanguage: 'de' });
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'de' }));
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+    });
+    it('wins over a blank appLanguage in the config, which names no language', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        await Amply.initialize({ ...KEYS, appLanguage: '  ' });
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'fr' }));
+    });
+    // null cannot travel in the config — there it means "leave the setting alone" — so a parked
+    // clear is applied as a call once the SDK is up.
+    it('applies a parked null right after initialization', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage(null);
+        await Amply.initialize(KEYS);
+        const [config] = native.initialize.mock.calls[0];
+        expect(config).not.toHaveProperty('appLanguage');
+        expect(native.setAppLanguage).toHaveBeenCalledTimes(1);
+        expect(native.setAppLanguage).toHaveBeenCalledWith(null);
+    });
+    it('drops a parked null when the later initialize names a language', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage(null);
+        await Amply.initialize({ ...KEYS, appLanguage: 'de' });
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'de' }));
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+    });
+    it('survives an initialize that fails, and is used by the retry', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('fr');
+        native.initialize.mockImplementationOnce(async () => {
+            throw new Error('AMP_INIT_FAILED');
+        });
+        await expect(Amply.initialize(KEYS)).rejects.toThrow('AMP_INIT_FAILED');
+        await Amply.initialize(KEYS);
+        expect(native.initialize).toHaveBeenLastCalledWith(expect.objectContaining({ appLanguage: 'fr' }));
+    });
+    it('survives an initialize rejected for a missing key', async () => {
+        const { Amply, native } = load();
+        const error = jest.spyOn(console, 'error').mockImplementation(() => { });
+        Amply.setAppLanguage('fr');
+        await expect(Amply.initialize({ ...KEYS, apiKeySecret: '' })).rejects.toMatchObject({
+            code: 'AMP_INVALID_CONFIG',
+        });
+        await Amply.initialize(KEYS);
+        expect(native.initialize).toHaveBeenCalledTimes(1);
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'fr' }));
+        error.mockRestore();
+    });
+});
+describe('setAppLanguage while initialize is in flight', () => {
+    it('is applied after initialization, so it wins over the config value it came after', async () => {
+        const { Amply, native } = load();
+        let finishInit;
+        native.initialize.mockImplementationOnce(() => new Promise(resolve => {
+            finishInit = () => {
+                native.setInitialized(true);
+                resolve();
+            };
+        }));
+        const init = Amply.initialize({ ...KEYS, appLanguage: 'de' });
+        Amply.setAppLanguage('fr');
+        expect(native.setAppLanguage).not.toHaveBeenCalled();
+        finishInit();
+        await init;
+        expect(native.initialize).toHaveBeenCalledWith(expect.objectContaining({ appLanguage: 'de' }));
+        expect(native.setAppLanguage).toHaveBeenCalledTimes(1);
+        expect(native.setAppLanguage).toHaveBeenCalledWith('fr');
+    });
+    // The native SDK reports itself up before the initialize promise settles, so a call made in
+    // that window goes straight through. A value held from before initialize is older than it and
+    // must not be replayed over it when the promise finally resolves.
+    function hangInitialize(native) {
+        const control = { comeUp: () => { }, resolve: () => { }, reject: (_error) => { } };
+        native.initialize.mockImplementationOnce(() => new Promise((resolve, reject) => {
+            control.comeUp = () => native.setInitialized(true);
+            control.resolve = resolve;
+            control.reject = reject;
+        }));
+        return control;
+    }
+    it('does not replay an older held null over a call the SDK already received', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage(null);
+        const init = hangInitialize(native);
+        const pending = Amply.initialize(KEYS);
+        init.comeUp();
+        Amply.setAppLanguage('fr');
+        init.resolve();
+        await pending;
+        expect(native.setAppLanguage.mock.calls).toEqual([['fr']]);
+    });
+    it('does not replay an older held tag over a call the SDK already received', async () => {
+        const { Amply, native } = load();
+        const init = hangInitialize(native);
+        const pending = Amply.initialize(KEYS);
+        Amply.setAppLanguage('de');
+        init.comeUp();
+        Amply.setAppLanguage('fr');
+        init.resolve();
+        await pending;
+        expect(native.setAppLanguage.mock.calls).toEqual([['fr']]);
+    });
+    it('does not hand a superseded held tag to the retry of a failed initialize', async () => {
+        const { Amply, native } = load();
+        Amply.setAppLanguage('de');
+        const init = hangInitialize(native);
+        const pending = Amply.initialize(KEYS);
+        init.comeUp();
+        Amply.setAppLanguage('fr');
+        init.reject(new Error('AMP_INIT_FAILED'));
+        await expect(pending).rejects.toThrow('AMP_INIT_FAILED');
+        native.setInitialized(false);
+        await Amply.initialize(KEYS);
+        const [retryConfig] = native.initialize.mock.calls[1];
+        expect(retryConfig).not.toHaveProperty('appLanguage');
+        expect(native.setAppLanguage.mock.calls).toEqual([['fr']]);
+    });
+});
+export {};

package/dist/src/__tests__/handleUrl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handleUrl.test.d.ts.map

package/dist/src/__tests__/handleUrl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleUrl.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/handleUrl.test.ts"],"names":[],"mappings":"AA0JA,OAAO,EAAE,CAAC"}