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

package/dist/src/campaignTouch.d.ts

@@ -0,0 +1,36 @@
+import type { CampaignTouchPayload } from './nativeSpecs/NativeAmplyModule';
+/**
+ * - `'shown'`: the campaign was shown (`CampaignShown`).
+ * - `'engaged'`: the campaign resolved `Completed` (`CampaignResolved` with `result: 'Completed'`).
+ */
+export type CampaignTouchKind = 'shown' | 'engaged';
+/**
+ * The most recent moment a campaign reached the user, as answered by `getLastCampaignTouch`.
+ *
+ * Meant for your own analytics: attach `campaignId` / `campaignName` to a purchase (or any
+ * conversion) that happens shortly after a campaign, even when it did not start from the
+ * campaign's own link.
+ */
+export type CampaignTouch = {
+    /**
+     * The id the SDK reports in `CampaignShown`. Inside an experiment that is the arm's own id —
+     * the same value `{@campaign.id}` resolves to, so it is also the right value for an explicit
+     * `amply_campaign_id` mark.
+     */
+    campaignId: string;
+    /** The campaign's name when the touch was recorded. Empty if the event carried no name. */
+    campaignName: string;
+    /** One touch per campaign: the newer of a show and a completion wins. */
+    kind: CampaignTouchKind;
+    /** When it happened, epoch milliseconds in the SDK's server-corrected clock. */
+    atMs: number;
+};
+/** Thrown (as a rejection) by `getLastCampaignTouch` for a window that is not a usable number. */
+export declare function assertValidWithinMs(withinMs: unknown): asserts withinMs is number;
+/**
+ * Narrows what the native bridge resolved to the public type. Anything it cannot read as a
+ * touch becomes null with a warning: the caller asked "was there a campaign", and a payload this
+ * bridge does not understand is not one it can vouch for.
+ */
+export declare function toCampaignTouch(payload: CampaignTouchPayload | null | undefined): CampaignTouch | null;
+//# sourceMappingURL=campaignTouch.d.ts.map

package/dist/src/campaignTouch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaignTouch.d.ts","sourceRoot":"","sources":["../../src/campaignTouch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,iCAAiC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,IAAI,EAAE,iBAAiB,CAAC;IACxB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAMjF;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,GAAG,IAAI,CAqBtG"}

package/dist/src/campaignTouch.js

@@ -0,0 +1,39 @@
+/** Thrown (as a rejection) by `getLastCampaignTouch` for a window that is not a usable number. */
+export function assertValidWithinMs(withinMs) {
+    if (typeof withinMs !== 'number' || !Number.isFinite(withinMs) || withinMs < 0) {
+        throw new RangeError(`[Amply] getLastCampaignTouch: withinMs must be a finite number >= 0, got ${String(withinMs)}`);
+    }
+}
+function toKind(raw) {
+    if (typeof raw !== 'string') {
+        return null;
+    }
+    const lowered = raw.toLowerCase();
+    return lowered === 'shown' || lowered === 'engaged' ? lowered : null;
+}
+/**
+ * Narrows what the native bridge resolved to the public type. Anything it cannot read as a
+ * touch becomes null with a warning: the caller asked "was there a campaign", and a payload this
+ * bridge does not understand is not one it can vouch for.
+ */
+export function toCampaignTouch(payload) {
+    if (payload == null) {
+        return null;
+    }
+    const kind = toKind(payload.kind);
+    const isReadable = kind !== null &&
+        typeof payload.campaignId === 'string' &&
+        payload.campaignId.length > 0 &&
+        typeof payload.atMs === 'number' &&
+        Number.isFinite(payload.atMs);
+    if (!isReadable) {
+        console.warn('[Amply] getLastCampaignTouch: ignoring an unreadable native payload', payload);
+        return null;
+    }
+    return {
+        campaignId: payload.campaignId,
+        campaignName: typeof payload.campaignName === 'string' ? payload.campaignName : '',
+        kind,
+        atMs: payload.atMs,
+    };
+}

package/dist/src/index.d.ts

@@ -1,6 +1,8 @@
 export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
 export type { FormatOptions } from './systemEventUtils';
+import type { CampaignTouch } from './campaignTouch';
+export type { CampaignTouch, CampaignTouchKind } from './campaignTouch';
 import type { CampaignResult, GateDecision, AmplyInitializationConfig as NativeInitializationConfig, DataSetSnapshot, DataSetType, DeepLinkEvent, EventRecord, LogLevel, CampaignPresentEvent, TrackEventPayload } from './nativeSpecs/NativeAmplyModule';
 /**
  * The keys from your application's page in Amply. All three are required: the SDK signs every
@@ -31,6 +33,19 @@ export declare function initialize(config: AmplyInitializationConfig): Promise<v
  * @param tag The language tag, or null to clear
  */
 export declare function setAppLanguage(tag: string | null): void;
+/**
+ * Hand an incoming URL to Amply. Call it for every link your app is opened with — cold start
+ * and while running — before your own routing; when it returns `true` Amply recognised the
+ * link as its own and took it over, so your app should not route it.
+ *
+ * Safe to call before {@link initialize}, which is how a cold-start link arrives: an Amply debug
+ * link is held (the newest one) and opened once initialization succeeds, and `true` is returned.
+ *
+ * Synchronous. Returns `false` for any other URL, for a non-string, and when the installed
+ * native SDK predates this method; it never throws.
+ * @param url The full incoming URL
+ */
+export declare function handleUrl(url: string): boolean;
 /**
  * Set the user ID for analytics. Pass null to clear.
  * @param userId The user ID to set, or null to clear
@@ -145,6 +160,24 @@ export declare function trackGated(event: string, properties?: Record<string, un
  */
 export declare function registerGate(baseUrl: string, presenter: GatePresenter, opts?: RegisterGateOptions): Promise<() => void>;
 export declare function getRecentEvents(limit: number): Promise<EventRecord[]>;
+/**
+ * The campaign the user was most recently touched by — shown, or completed — at most `withinMs`
+ * ago, or `null` if there was none.
+ *
+ * Use it to attribute a purchase (or any conversion) in your own analytics to the campaign that
+ * preceded it, including one made from somewhere other than the campaign's link:
+ *
+ * ```ts
+ * const touch = await Amply.getLastCampaignTouch(30 * 60 * 1000);
+ * analytics.track('Purchase', {sku, amply_campaign_id: touch?.campaignId});
+ * ```
+ *
+ * One touch per campaign, the newer of a show and a completion. `withinMs` is inclusive and
+ * capped at 30 days by the SDK. Resolves `null` before {@link initialize}, while the SDK's storage
+ * is off, and if the native call fails — it rejects only for a `withinMs` that is not a finite
+ * number >= 0, which is a bug at the call site.
+ */
+export declare function getLastCampaignTouch(withinMs: number): Promise<CampaignTouch | null>;
 export declare function getDataSetSnapshot(type: DataSetType): Promise<DataSetSnapshot>;
 export declare function addDeepLinkListener(listener: (event: DeepLinkEvent) => void): Promise<() => void>;
 export declare function addSystemEventListener(listener: (event: EventRecord) => void): Promise<() => void>;
@@ -192,6 +225,7 @@ declare const _default: {
     trackGated: typeof trackGated;
     registerGate: typeof registerGate;
     getRecentEvents: typeof getRecentEvents;
+    getLastCampaignTouch: typeof getLastCampaignTouch;
     getDataSetSnapshot: typeof getDataSetSnapshot;
     addDeepLinkListener: typeof addDeepLinkListener;
     addSystemEventListener: typeof addSystemEventListener;
@@ -199,6 +233,7 @@ declare const _default: {
     removeAllListeners: typeof removeAllListeners;
     setUserId: typeof setUserId;
     setAppLanguage: typeof setAppLanguage;
+    handleUrl: typeof handleUrl;
     setLogLevel: typeof setLogLevel;
     getLogLevel: typeof getLogLevel;
     setCustomProperty: typeof setCustomProperty;

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -2,6 +2,7 @@ import getNativeModule from './nativeModule';
 import { addSystemEventListenerRaw, addSystemEventListener as addSystemEventListenerInternal } from './systemEvents';
 export { useAmplySystemEvents } from './hooks/useAmplySystemEvents';
 export { formatSystemEventLabel } from './systemEventUtils';
+import { assertValidWithinMs, toCampaignTouch } from './campaignTouch';
 const REQUIRED_KEYS = ['appId', 'apiKeyPublic', 'apiKeySecret'];
 /** Rejection raised by {@link initialize} for a config the SDK cannot start with. */
 export class AmplyConfigError extends Error {
@@ -193,6 +194,9 @@ export async function initialize(config) {
         await getNativeModule().initialize(withParkedAppLanguage(config, parked));
     }
     catch (error) {
+        // A debug link parked for a failed start has nothing to open; replaying it later would
+        // surprise a retry that the user did not scan for.
+        parkedDebugUrl = null;
         // Nothing reached the SDK, so the call still has to — unless a newer one replaced it.
         if (parkedAppLanguage == null && isLatestLanguageWrite(parked)) {
             parkedAppLanguage = parked;
@@ -206,6 +210,7 @@ export async function initialize(config) {
         getNativeModule().setAppLanguage(null);
     }
     flushParkedAppLanguage();
+    flushParkedDebugUrl();
     // Anything the host registered before this point was parked rather than lost.
     replayPendingRegistrations();
 }
@@ -266,6 +271,90 @@ export function setAppLanguage(tag) {
     }
     parkedAppLanguage = { tag, seq: languageWriteSeq };
 }
+/** A debug link that arrived before the SDK was up. At most one: a newer link replaces it. */
+let parkedDebugUrl = null;
+const URL_SCHEME_PREFIX = /^[A-Za-z][A-Za-z0-9+.-]*:\/\//;
+const DEBUG_LINK_HOST = 'amply-debug';
+const DEBUG_LINK_PATH = '/campaign';
+const DEBUG_LINK_TOKEN_PARAM = 't';
+/**
+ * True for `<any scheme>://amply-debug/campaign?t=<non-empty>`. Parsed by hand, without decoding,
+ * so a malformed string is just "not a debug link" and can never throw.
+ */
+function isDebugLink(url) {
+    const scheme = URL_SCHEME_PREFIX.exec(url);
+    if (scheme == null) {
+        return false;
+    }
+    const rest = url.slice(scheme[0].length).split('#')[0];
+    const queryStart = rest.indexOf('?');
+    if (queryStart < 0) {
+        return false;
+    }
+    const target = rest.slice(0, queryStart);
+    const slash = target.indexOf('/');
+    if (slash < 0 || target.slice(0, slash) !== DEBUG_LINK_HOST) {
+        return false;
+    }
+    if (target.slice(slash).replace(/\/+$/, '') !== DEBUG_LINK_PATH) {
+        return false;
+    }
+    return rest
+        .slice(queryStart + 1)
+        .split('&')
+        .some(pair => {
+        const eq = pair.indexOf('=');
+        return eq > 0 && pair.slice(0, eq) === DEBUG_LINK_TOKEN_PARAM && eq < pair.length - 1;
+    });
+}
+function flushParkedDebugUrl() {
+    var _a, _b;
+    const url = parkedDebugUrl;
+    parkedDebugUrl = null;
+    if (url == null) {
+        return;
+    }
+    try {
+        (_b = (_a = getNativeModule()).handleUrl) === null || _b === void 0 ? void 0 : _b.call(_a, url);
+    }
+    catch (error) {
+        console.warn('[Amply] Failed to replay a debug link parked until initialize', error);
+    }
+}
+/**
+ * Hand an incoming URL to Amply. Call it for every link your app is opened with — cold start
+ * and while running — before your own routing; when it returns `true` Amply recognised the
+ * link as its own and took it over, so your app should not route it.
+ *
+ * Safe to call before {@link initialize}, which is how a cold-start link arrives: an Amply debug
+ * link is held (the newest one) and opened once initialization succeeds, and `true` is returned.
+ *
+ * Synchronous. Returns `false` for any other URL, for a non-string, and when the installed
+ * native SDK predates this method; it never throws.
+ * @param url The full incoming URL
+ */
+export function handleUrl(url) {
+    if (typeof url !== 'string') {
+        return false;
+    }
+    try {
+        if (!isSdkUp()) {
+            if (!isDebugLink(url)) {
+                return false;
+            }
+            parkedDebugUrl = url;
+            return true;
+        }
+        const nativeModule = getNativeModule();
+        if (typeof nativeModule.handleUrl !== 'function') {
+            return false;
+        }
+        return nativeModule.handleUrl(url) === true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Set the user ID for analytics. Pass null to clear.
  * @param userId The user ID to set, or null to clear
@@ -462,6 +551,35 @@ export async function registerGate(baseUrl, presenter, opts) {
 export async function getRecentEvents(limit) {
     return getNativeModule().getRecentEvents(limit);
 }
+/**
+ * The campaign the user was most recently touched by — shown, or completed — at most `withinMs`
+ * ago, or `null` if there was none.
+ *
+ * Use it to attribute a purchase (or any conversion) in your own analytics to the campaign that
+ * preceded it, including one made from somewhere other than the campaign's link:
+ *
+ * ```ts
+ * const touch = await Amply.getLastCampaignTouch(30 * 60 * 1000);
+ * analytics.track('Purchase', {sku, amply_campaign_id: touch?.campaignId});
+ * ```
+ *
+ * One touch per campaign, the newer of a show and a completion. `withinMs` is inclusive and
+ * capped at 30 days by the SDK. Resolves `null` before {@link initialize}, while the SDK's storage
+ * is off, and if the native call fails — it rejects only for a `withinMs` that is not a finite
+ * number >= 0, which is a bug at the call site.
+ */
+export async function getLastCampaignTouch(withinMs) {
+    assertValidWithinMs(withinMs);
+    try {
+        return toCampaignTouch(await getNativeModule().getLastCampaignTouch(withinMs));
+    }
+    catch (error) {
+        // The SDK answers null for every state it can be in; a rejection here is the bridge itself
+        // failing, and an analytics lookup must never break the purchase flow that asked.
+        console.warn('[Amply] getLastCampaignTouch failed; resolving null', error);
+        return null;
+    }
+}
 export async function getDataSetSnapshot(type) {
     return getNativeModule().getDataSetSnapshot(type);
 }
@@ -552,6 +670,7 @@ export default {
     trackGated,
     registerGate,
     getRecentEvents,
+    getLastCampaignTouch,
     getDataSetSnapshot,
     addDeepLinkListener,
     addSystemEventListener,
@@ -559,6 +678,7 @@ export default {
     removeAllListeners,
     setUserId,
     setAppLanguage,
+    handleUrl,
     setLogLevel,
     getLogLevel,
     setCustomProperty,

package/dist/src/nativeSpecs/NativeAmplyModule.d.ts

@@ -63,7 +63,22 @@ export type EventRecord = {
     timestamp: number;
     properties: JsonMap;
 };
+/**
+ * A system event from the SDK. `CampaignShown` and `CampaignResolved` carry `campaignId` and,
+ * from SDK 0.15.0, `campaignName` in `properties`.
+ */
 export type SystemEventPayload = EventRecord;
+/**
+ * Wire shape of a campaign touch as the native bridges send it. `kind` is `'shown'` or
+ * `'engaged'`; the public `CampaignTouch` type narrows it. Kept a plain string here so the
+ * codegen contract does not change if the SDK ever adds a kind.
+ */
+export type CampaignTouchPayload = {
+    campaignId: string;
+    campaignName: string;
+    kind: string;
+    atMs: number;
+};
 export type TriggeredEventCountStrategy = 'global' | 'session';
 export type TriggeredEventParam = {
     name: string;
@@ -195,6 +210,12 @@ export interface Spec extends TurboModule {
      */
     unregisterGate(baseUrl: string): void;
     getRecentEvents(limit: number): Promise<EventRecord[]>;
+    /**
+     * The campaign the user was most recently touched by (shown, or completed) at most `withinMs`
+     * ago, or null. Never rejects for "not initialised" — that resolves null, as in the SDK.
+     * `withinMs` is clamped natively to [0, 30 days].
+     */
+    getLastCampaignTouch(withinMs: number): Promise<CampaignTouchPayload | null>;
     getDataSetSnapshot(type: DataSetType): Promise<DataSetSnapshot>;
     registerDeepLinkListener(): void;
     /**
@@ -208,6 +229,13 @@ export interface Spec extends TurboModule {
      * @param tag The language tag, or null to clear
      */
     setAppLanguage(tag: string | null): void;
+    /**
+     * Hand an incoming URL to the SDK. Returns true when the SDK recognised it as its own
+     * (a test-launch link) and took it over; false for any other URL, or when the SDK is not
+     * initialized.
+     * @param url The full incoming URL
+     */
+    handleUrl(url: string): boolean;
     /**
      * Set the log level at runtime.
      * @param level The log level to set

package/dist/src/nativeSpecs/NativeAmplyModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAmplyModule.d.ts","sourceRoot":"","sources":["../../../src/nativeSpecs/NativeAmplyModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NativeAmplyModule.d.ts","sourceRoot":"","sources":["../../../src/nativeSpecs/NativeAmplyModule.ts"],"names":[],"mappings":"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"}

package/dist/src/systemEventUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"systemEventUtils.d.ts","sourceRoot":"","sources":["../../src/systemEventUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAYjE,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAqCR"}
+{"version":3,"file":"systemEventUtils.d.ts","sourceRoot":"","sources":["../../src/systemEventUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,iCAAiC,CAAC;AAYjE,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAuCR"}

package/dist/src/systemEventUtils.js

@@ -16,8 +16,10 @@ export function formatSystemEventLabel(event, options = {}) {
     }
     if (event.name === 'CampaignShown') {
         const campaignId = event.properties.campaignId;
+        // Sent by SDK 0.15.0 and later (on CampaignShown and CampaignResolved alike).
+        const campaignName = event.properties.campaignName;
         const source = event.properties.source;
-        return `Campaign shown${campaignId ? ` (${campaignId})` : ''}${source ? ` via ${source}` : ''}`;
+        return `Campaign shown${campaignName ? ` "${campaignName}"` : ''}${campaignId ? ` (${campaignId})` : ''}${source ? ` via ${source}` : ''}`;
     }
     if (event.name === 'EventTriggered') {
         const source = event.properties.sourceEvent;