@amplytools/react-native-amply-sdk 0.14.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.14.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
 
@@ -75,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.14.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()
@@ -199,6 +210,8 @@ class AmplyModule(reactContext: ReactApplicationContext) :
     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)
@@ -427,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 ->
@@ -530,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()
@@ -74,6 +82,9 @@ interface AmplyClient {
 
   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()
@@ -400,6 +423,12 @@ class DefaultAmplyClient(
     }
   }
 
+  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

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);
@@ -94,6 +98,10 @@ public abstract class NativeAmplyModuleSpec extends ReactContextBaseJavaModule i
   @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);
@@ -72,6 +77,11 @@ static facebook::jsi::Value __hostFunction_NativeAmplyModuleSpecJSI_setAppLangua
   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);
@@ -122,10 +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

@@ -1,43 +1,2 @@
-/**
- * `setAppLanguage` and the `appLanguage` initialization option.
- *
- * The SDK treats both as one setting with "last write wins": `appLanguage` in the config is the
- * same as calling `setAppLanguage` at initialization. The native bridges cannot honour that order
- * on their own for a call made BEFORE `initialize` — they buffer it and replay it after the SDK is
- * built, which would let an earlier call overwrite the later config value. So the JS layer parks a
- * pre-init call itself and folds it into the config it hands to native.
- *
- * Each test loads a fresh copy of the module: the parked value is module state, and leaking it
- * from one test into the next would make every ordering assertion here meaningless.
- */
-type AmplyModule = typeof import('../index');
-declare function createNativeModule(): {
-    initialize: jest.Mock<Promise<void>, [], any>;
-    isInitialized: jest.Mock<boolean, [], any>;
-    setAppLanguage: jest.Mock<any, any, any>;
-    setUserId: jest.Mock<any, any, any>;
-    addListener: jest.Mock<any, any, any>;
-    removeListeners: jest.Mock<any, any, any>;
-    onSystemEvent: jest.Mock<{
-        remove: jest.Mock<any, any, any>;
-    }, [], any>;
-    onDeepLink: jest.Mock<{
-        remove: jest.Mock<any, any, any>;
-    }, [], any>;
-    onCampaignPresent: jest.Mock<{
-        remove: jest.Mock<any, any, any>;
-    }, [], any>;
-    /** Test-only: pretend the SDK is (or is not) up without going through initialize. */
-    setInitialized(value: boolean): void;
-};
-type NativeModuleMock = ReturnType<typeof createNativeModule>;
-declare const KEYS: {
-    appId: string;
-    apiKeyPublic: string;
-    apiKeySecret: string;
-};
-declare function load(): {
-    Amply: AmplyModule;
-    native: NativeModuleMock;
-};
+export {};
 //# sourceMappingURL=appLanguage.test.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"appLanguage.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/appLanguage.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,KAAK,WAAW,GAAG,cAAc,UAAU,CAAC,CAAC;AAE7C,iBAAS,kBAAkB;;;;;;;;;;;;;;;;IAcvB,qFAAqF;0BAC/D,OAAO;EAIhC;AAED,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,QAAA,MAAM,IAAI;;;;CAAgE,CAAC;AAE3E,iBAAS,IAAI,IAAI;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAC,CAU9D"}
+{"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

@@ -1,4 +1,3 @@
-"use strict";
 function createNativeModule() {
     let initialized = false;
     return {
@@ -209,3 +208,4 @@ describe('setAppLanguage while initialize is in flight', () => {
         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"}

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

@@ -0,0 +1,114 @@
+function loadWith(native) {
+    // Absent isInitialized means "SDK up" for the plain pass-through tests below.
+    const withState = { isInitialized: () => true, ...native };
+    let Amply;
+    jest.isolateModules(() => {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('../nativeModule').__setNativeModule(withState);
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        Amply = require('../index');
+    });
+    return Amply;
+}
+const DEBUG_URL = 'myapp://amply-debug/campaign?t=abc';
+describe('handleUrl', () => {
+    it('passes the DEBUG_URL to the native module and returns its answer', () => {
+        const handleUrl = jest.fn(() => true);
+        const Amply = loadWith({ handleUrl });
+        expect(Amply.handleUrl(DEBUG_URL)).toBe(true);
+        expect(handleUrl).toHaveBeenCalledWith(DEBUG_URL);
+    });
+    it('returns false when the native module does not recognise the DEBUG_URL', () => {
+        const Amply = loadWith({ handleUrl: jest.fn(() => false) });
+        expect(Amply.handleUrl('myapp://settings')).toBe(false);
+    });
+    it('returns false without throwing when the native module has no handleUrl', () => {
+        const Amply = loadWith({});
+        expect(Amply.handleUrl(DEBUG_URL)).toBe(false);
+    });
+    it('returns false without throwing when the native call throws', () => {
+        const Amply = loadWith({
+            handleUrl: jest.fn(() => {
+                throw new Error('boom');
+            }),
+        });
+        expect(Amply.handleUrl(DEBUG_URL)).toBe(false);
+    });
+    it('returns false for a non-string DEBUG_URL', () => {
+        const handleUrl = jest.fn(() => true);
+        const Amply = loadWith({ handleUrl });
+        expect(Amply.handleUrl(null)).toBe(false);
+        expect(handleUrl).not.toHaveBeenCalled();
+    });
+    it('is on the default export', () => {
+        const Amply = loadWith({ handleUrl: jest.fn(() => true) });
+        expect(Amply.default.handleUrl(DEBUG_URL)).toBe(true);
+    });
+});
+describe('handleUrl before initialize', () => {
+    function loadUninitialised(initialize) {
+        let up = false;
+        const handleUrl = jest.fn(() => true);
+        const native = {
+            handleUrl,
+            isInitialized: jest.fn(() => up),
+            initialize: jest.fn(initialize !== null && initialize !== void 0 ? initialize : (async () => {
+                up = true;
+            })),
+            addListener: jest.fn(),
+            removeListeners: jest.fn(),
+        };
+        return { Amply: loadWith(native), handleUrl };
+    }
+    const KEYS = { appId: 'id', apiKeyPublic: 'public', apiKeySecret: 'secret' };
+    it('parks a debug link, returns true and does not call native', () => {
+        const { Amply, handleUrl } = loadUninitialised();
+        expect(Amply.handleUrl(DEBUG_URL)).toBe(true);
+        expect(handleUrl).not.toHaveBeenCalled();
+    });
+    it('replays the parked link to native once after initialize', async () => {
+        const { Amply, handleUrl } = loadUninitialised();
+        Amply.handleUrl(DEBUG_URL);
+        await Amply.initialize(KEYS);
+        expect(handleUrl).toHaveBeenCalledTimes(1);
+        expect(handleUrl).toHaveBeenCalledWith(DEBUG_URL);
+    });
+    it('replays only the newer of two parked links', async () => {
+        const { Amply, handleUrl } = loadUninitialised();
+        Amply.handleUrl('myapp://amply-debug/campaign?t=old');
+        Amply.handleUrl('myapp://amply-debug/campaign?t=new');
+        await Amply.initialize(KEYS);
+        expect(handleUrl).toHaveBeenCalledTimes(1);
+        expect(handleUrl).toHaveBeenCalledWith('myapp://amply-debug/campaign?t=new');
+    });
+    it('does not park a non-debug link', async () => {
+        const { Amply, handleUrl } = loadUninitialised();
+        expect(Amply.handleUrl('myapp://settings')).toBe(false);
+        await Amply.initialize(KEYS);
+        expect(handleUrl).not.toHaveBeenCalled();
+    });
+    it('drops the parked link when initialize fails', async () => {
+        const { Amply, handleUrl } = loadUninitialised(async () => {
+            throw new Error('init failed');
+        });
+        Amply.handleUrl(DEBUG_URL);
+        await expect(Amply.initialize(KEYS)).rejects.toThrow('init failed');
+        expect(handleUrl).not.toHaveBeenCalled();
+    });
+    it.each([
+        '',
+        'not a url',
+        'myapp://amply-debug/campaign',
+        'myapp://amply-debug/campaign?t=',
+        'myapp://amply-debug/other?t=abc',
+        'myapp://other/campaign?t=abc',
+        'amply-debug/campaign?t=abc',
+        '://amply-debug/campaign?t=abc',
+    ])('returns false without throwing for %p', async (url) => {
+        const { Amply, handleUrl } = loadUninitialised();
+        expect(Amply.handleUrl(url)).toBe(false);
+        await Amply.initialize(KEYS);
+        expect(handleUrl).not.toHaveBeenCalled();
+    });
+});
+export {};

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

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

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

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

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

@@ -0,0 +1,119 @@
+import * as Amply from '../index';
+import { __setNativeModule } from '../nativeModule';
+const mockNativeModule = {
+    isInitialized: jest.fn(() => true),
+    getLastCampaignTouch: jest.fn(),
+};
+const ONE_HOUR_MS = 60 * 60 * 1000;
+describe('getLastCampaignTouch', () => {
+    let warn;
+    beforeEach(() => {
+        __setNativeModule(mockNativeModule);
+        warn = jest.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        warn.mockRestore();
+        jest.clearAllMocks();
+        __setNativeModule(null);
+    });
+    it('passes withinMs through to the native module and returns the touch', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce({
+            campaignId: 'cmp_1',
+            campaignName: 'Spring offer',
+            kind: 'shown',
+            atMs: 1760000000000,
+        });
+        const touch = await Amply.getLastCampaignTouch(ONE_HOUR_MS);
+        expect(mockNativeModule.getLastCampaignTouch).toHaveBeenCalledWith(ONE_HOUR_MS);
+        expect(touch).toEqual({
+            campaignId: 'cmp_1',
+            campaignName: 'Spring offer',
+            kind: 'shown',
+            atMs: 1760000000000,
+        });
+    });
+    it('is exposed on the default export too', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(null);
+        await expect(Amply.default.getLastCampaignTouch(0)).resolves.toBeNull();
+    });
+    it('resolves null when the native side has no touch', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(null);
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toBeNull();
+    });
+    it('resolves null when the native side resolves undefined', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(undefined);
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toBeNull();
+    });
+    it.each([
+        ['shown', 'shown'],
+        ['engaged', 'engaged'],
+        ['SHOWN', 'shown'],
+        ['ENGAGED', 'engaged'],
+    ])('maps native kind %s to %s', async (nativeKind, expected) => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce({
+            campaignId: 'cmp_1',
+            campaignName: 'Spring offer',
+            kind: nativeKind,
+            atMs: 1,
+        });
+        const touch = await Amply.getLastCampaignTouch(ONE_HOUR_MS);
+        expect(touch === null || touch === void 0 ? void 0 : touch.kind).toBe(expected);
+    });
+    it('resolves null and warns for a kind this bridge does not know', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce({
+            campaignId: 'cmp_1',
+            campaignName: 'Spring offer',
+            kind: 'clicked',
+            atMs: 1,
+        });
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toBeNull();
+        expect(warn).toHaveBeenCalledWith(expect.stringContaining('getLastCampaignTouch'), expect.anything());
+    });
+    it.each([
+        ['a missing campaignId', { campaignName: 'x', kind: 'shown', atMs: 1 }],
+        ['a non-numeric atMs', { campaignId: 'c', campaignName: 'x', kind: 'shown', atMs: '1' }],
+    ])('resolves null for a payload with %s', async (_label, payload) => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(payload);
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toBeNull();
+    });
+    it('keeps an empty campaign name rather than dropping the touch', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce({
+            campaignId: 'cmp_1',
+            campaignName: '',
+            kind: 'engaged',
+            atMs: 5,
+        });
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toEqual({
+            campaignId: 'cmp_1',
+            campaignName: '',
+            kind: 'engaged',
+            atMs: 5,
+        });
+    });
+    it('resolves null instead of rejecting when the native call fails', async () => {
+        mockNativeModule.getLastCampaignTouch.mockRejectedValueOnce(new Error('bridge gone'));
+        await expect(Amply.getLastCampaignTouch(ONE_HOUR_MS)).resolves.toBeNull();
+        expect(warn).toHaveBeenCalled();
+    });
+    it('accepts zero', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(null);
+        await Amply.getLastCampaignTouch(0);
+        expect(mockNativeModule.getLastCampaignTouch).toHaveBeenCalledWith(0);
+    });
+    it('leaves a large window to the native clamp', async () => {
+        mockNativeModule.getLastCampaignTouch.mockResolvedValueOnce(null);
+        const ninetyDaysMs = 90 * 24 * ONE_HOUR_MS;
+        await Amply.getLastCampaignTouch(ninetyDaysMs);
+        expect(mockNativeModule.getLastCampaignTouch).toHaveBeenCalledWith(ninetyDaysMs);
+    });
+    it.each([
+        ['negative', -1],
+        ['NaN', Number.NaN],
+        ['Infinity', Number.POSITIVE_INFINITY],
+        ['a string', '3600000'],
+        ['undefined', undefined],
+    ])('rejects with a RangeError for %s and never calls native', async (_label, value) => {
+        await expect(Amply.getLastCampaignTouch(value)).rejects.toBeInstanceOf(RangeError);
+        expect(mockNativeModule.getLastCampaignTouch).not.toHaveBeenCalled();
+    });
+});

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

@@ -29,6 +29,22 @@ describe('formatSystemEventLabel', () => {
             });
             expect(formatSystemEventLabel(event)).toBe('Campaign shown (abc) via click');
         });
+        it('names the campaign in CampaignShown when the SDK sends campaignName', () => {
+            const event = makeEvent('CampaignShown', {
+                campaignId: 'abc',
+                campaignName: 'Spring offer',
+                source: 'click',
+            });
+            expect(formatSystemEventLabel(event)).toBe('Campaign shown "Spring offer" (abc) via click');
+        });
+        it('ignores an empty campaignName in CampaignShown', () => {
+            const event = makeEvent('CampaignShown', {
+                campaignId: 'abc',
+                campaignName: '',
+                source: 'click',
+            });
+            expect(formatSystemEventLabel(event)).toBe('Campaign shown (abc) via click');
+        });
         it('formats EventTriggered with source event', () => {
             const event = makeEvent('EventTriggered', { sourceEvent: 'purchase' });
             expect(formatSystemEventLabel(event)).toBe('Event triggered (purchase)');