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

package/src/index.ts

@@ -3,6 +3,9 @@ import {addSystemEventListenerRaw, addSystemEventListener as addSystemEventListe
 export {useAmplySystemEvents} from './hooks/useAmplySystemEvents';
 export {formatSystemEventLabel} from './systemEventUtils';
 export type {FormatOptions} from './systemEventUtils';
+import {assertValidWithinMs, toCampaignTouch} from './campaignTouch';
+import type {CampaignTouch} from './campaignTouch';
+export type {CampaignTouch, CampaignTouchKind} from './campaignTouch';
 import type {
   CampaignResult,
   GateDecision,
@@ -238,6 +241,9 @@ export async function initialize(config: AmplyInitializationConfig): Promise<voi
   try {
     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;
@@ -251,6 +257,7 @@ export async function initialize(config: AmplyInitializationConfig): Promise<voi
     getNativeModule().setAppLanguage(null);
   }
   flushParkedAppLanguage();
+  flushParkedDebugUrl();
   // Anything the host registered before this point was parked rather than lost.
   replayPendingRegistrations();
 }
@@ -334,6 +341,92 @@ export function setAppLanguage(tag: string | null): void {
   parkedAppLanguage = {tag, seq: languageWriteSeq};
 }
 
+/** A debug link that arrived before the SDK was up. At most one: a newer link replaces it. */
+let parkedDebugUrl: string | null = 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: string): boolean {
+  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(): void {
+  const url = parkedDebugUrl;
+  parkedDebugUrl = null;
+  if (url == null) {
+    return;
+  }
+  try {
+    getNativeModule().handleUrl?.(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: string): boolean {
+  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
@@ -612,6 +705,35 @@ export async function getRecentEvents(limit: number): Promise<EventRecord[]> {
   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: number): Promise<CampaignTouch | null> {
+  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: DataSetType): Promise<DataSetSnapshot> {
   return getNativeModule().getDataSetSnapshot(type);
 }
@@ -733,6 +855,7 @@ export default {
   trackGated,
   registerGate,
   getRecentEvents,
+  getLastCampaignTouch,
   getDataSetSnapshot,
   addDeepLinkListener,
   addSystemEventListener,
@@ -740,6 +863,7 @@ export default {
   removeAllListeners,
   setUserId,
   setAppLanguage,
+  handleUrl,
   setLogLevel,
   getLogLevel,
   setCustomProperty,

package/src/nativeSpecs/NativeAmplyModule.ts

@@ -69,8 +69,24 @@ export type EventRecord = {
   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 = {
@@ -201,6 +217,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;
   /**
@@ -214,6 +236,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/src/systemEventUtils.ts

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

package/dist/index.js

@@ -1,272 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  addDeepLinkListener: () => addDeepLinkListener,
-  addSystemEventListener: () => addSystemEventListener2,
-  addSystemEventsListener: () => addSystemEventsListener,
-  default: () => src_default,
-  formatSystemEventLabel: () => formatSystemEventLabel,
-  getDataSetSnapshot: () => getDataSetSnapshot,
-  getRecentEvents: () => getRecentEvents,
-  initialize: () => initialize,
-  isInitialized: () => isInitialized,
-  removeAllListeners: () => removeAllListeners,
-  systemEvents: () => systemEvents,
-  track: () => track,
-  useAmplySystemEvents: () => useAmplySystemEvents
-});
-module.exports = __toCommonJS(src_exports);
-
-// src/nativeModule.ts
-var import_react_native = require("react-native");
-var MODULE_NAME = "Amply";
-var cachedModule = null;
-var attemptedTurboLookup = false;
-var resolvedTurboModule = null;
-function loadModule() {
-  const globalWithTurbo = globalThis;
-  if (globalWithTurbo.__turboModuleProxy != null) {
-    if (!attemptedTurboLookup) {
-      attemptedTurboLookup = true;
-      try {
-        resolvedTurboModule = import_react_native.TurboModuleRegistry.getEnforcing(MODULE_NAME);
-      } catch (error) {
-        resolvedTurboModule = null;
-        if (__DEV__) {
-          console.warn(
-            "[Amply] TurboModule lookup failed; falling back to legacy NativeModules. " + (error instanceof Error ? error.message : String(error))
-          );
-        }
-      }
-    }
-    if (resolvedTurboModule) {
-      return resolvedTurboModule;
-    }
-  }
-  const legacyModule = import_react_native.NativeModules[MODULE_NAME];
-  if (legacyModule) {
-    return legacyModule;
-  }
-  return null;
-}
-function getNativeModule() {
-  if (cachedModule) {
-    return cachedModule;
-  }
-  const module2 = loadModule();
-  if (!module2) {
-    throw new Error(
-      `Amply native module '${MODULE_NAME}' not found. Ensure the module is properly linked and new architecture is enabled.`
-    );
-  }
-  cachedModule = module2;
-  return cachedModule;
-}
-var nativeModule_default = getNativeModule;
-
-// src/systemEvents.ts
-async function addSystemEventListener(listener) {
-  const subscription = nativeModule_default().onSystemEvent(listener);
-  return () => {
-    var _a;
-    return (_a = subscription == null ? void 0 : subscription.remove) == null ? void 0 : _a.call(subscription);
-  };
-}
-
-// src/hooks/useAmplySystemEvents.ts
-var import_react = require("react");
-function useAmplySystemEvents(options = {}) {
-  const { maxEntries = 50, dedupe = true, onEvent } = options;
-  const [events, setEvents] = (0, import_react.useState)([]);
-  const seenKeysRef = (0, import_react.useRef)(/* @__PURE__ */ new Set());
-  const handlerRef = (0, import_react.useRef)(onEvent);
-  (0, import_react.useEffect)(() => {
-    handlerRef.current = onEvent;
-  }, [onEvent]);
-  (0, import_react.useEffect)(() => {
-    let unsubscribe;
-    let isMounted = true;
-    addSystemEventListener((event) => {
-      var _a;
-      if (!isMounted) {
-        return;
-      }
-      if (dedupe) {
-        const key = `${event.name}-${event.timestamp}`;
-        if (seenKeysRef.current.has(key)) {
-          return;
-        }
-        seenKeysRef.current.add(key);
-      }
-      (_a = handlerRef.current) == null ? void 0 : _a.call(handlerRef, event);
-      setEvents((prev) => {
-        const next = [...prev, event];
-        if (next.length > maxEntries) {
-          next.splice(0, next.length - maxEntries);
-        }
-        return next;
-      });
-    }).then((unsub) => {
-      if (!isMounted) {
-        unsub();
-      } else {
-        unsubscribe = unsub;
-      }
-    }).catch((error) => {
-      console.warn("[Amply] system event listener error", error);
-    });
-    return () => {
-      isMounted = false;
-      unsubscribe == null ? void 0 : unsubscribe();
-    };
-  }, [dedupe, maxEntries]);
-  const reset = (0, import_react.useCallback)(() => {
-    seenKeysRef.current.clear();
-    setEvents([]);
-  }, []);
-  return { events, reset };
-}
-
-// src/systemEventUtils.ts
-var DEFAULT_LABELS = {
-  SdkInitialized: "SDK initialized",
-  ConfigFetchStarted: "Config fetch started",
-  ConfigFetchFinished: "Config fetch finished",
-  SessionStarted: "Session started",
-  SessionFinished: "Session finished",
-  CampaignShown: "Campaign shown",
-  EventTriggered: "Event triggered",
-  CampaignStarted: "Campaign processing started",
-  CampaignFinished: "Campaign finished"
-};
-function formatSystemEventLabel(event) {
-  var _a, _b;
-  if (event.name === "CampaignShown") {
-    const campaignId = event.properties.campaignId;
-    const source = event.properties.source;
-    return `Campaign shown${campaignId ? ` (${campaignId})` : ""}${source ? ` via ${source}` : ""}`;
-  }
-  if (event.name === "EventTriggered") {
-    const source = event.properties.sourceEvent;
-    return source ? `Event triggered (${source})` : (_a = DEFAULT_LABELS[event.name]) != null ? _a : event.name;
-  }
-  if (event.name === "ConfigFetchFinished") {
-    const success = event.properties.success;
-    const campaignCount = event.properties.campaignCount;
-    const countLabel = typeof campaignCount === "number" ? ` (${campaignCount} campaigns)` : "";
-    return success === false ? "Config fetch failed" : `Config fetch finished${countLabel}`;
-  }
-  return (_b = DEFAULT_LABELS[event.name]) != null ? _b : `System event ${event.name}`;
-}
-
-// src/index.ts
-var deepLinkRegistered = false;
-var deepLinkSubscriptions = /* @__PURE__ */ new Set();
-async function ensureDeepLinkRegistration() {
-  if (!deepLinkRegistered) {
-    console.log("[Amply] Calling registerDeepLinkListener on native module");
-    nativeModule_default().registerDeepLinkListener();
-    deepLinkRegistered = true;
-    console.log("[Amply] registerDeepLinkListener completed");
-  }
-}
-function trackDeepLinkSubscription(subscription) {
-  let removed = false;
-  const unsubscribe = () => {
-    var _a;
-    if (removed) {
-      return;
-    }
-    removed = true;
-    (_a = subscription == null ? void 0 : subscription.remove) == null ? void 0 : _a.call(subscription);
-    deepLinkSubscriptions.delete(unsubscribe);
-  };
-  deepLinkSubscriptions.add(unsubscribe);
-  return unsubscribe;
-}
-async function initialize(config) {
-  await nativeModule_default().initialize(config);
-}
-function isInitialized() {
-  return nativeModule_default().isInitialized();
-}
-async function track(payload) {
-  await nativeModule_default().track(payload);
-}
-async function getRecentEvents(limit) {
-  return nativeModule_default().getRecentEvents(limit);
-}
-async function getDataSetSnapshot(type) {
-  return nativeModule_default().getDataSetSnapshot(type);
-}
-async function addDeepLinkListener(listener) {
-  await ensureDeepLinkRegistration();
-  const subscription = nativeModule_default().onDeepLink(listener);
-  return trackDeepLinkSubscription(subscription);
-}
-async function addSystemEventListener2(listener) {
-  return addSystemEventListener(listener);
-}
-function removeAllListeners() {
-  deepLinkSubscriptions.forEach((unsubscribe) => {
-    try {
-      unsubscribe();
-    } catch (error) {
-      console.warn("[Amply] Failed to remove deep link listener", error);
-    }
-  });
-  deepLinkSubscriptions.clear();
-}
-function addSystemEventsListener(listener) {
-  return addSystemEventListener2(listener);
-}
-var systemEvents = {
-  addListener: addSystemEventsListener
-};
-var src_default = {
-  initialize,
-  isInitialized,
-  track,
-  getRecentEvents,
-  getDataSetSnapshot,
-  addDeepLinkListener,
-  addSystemEventListener: addSystemEventListener2,
-  addSystemEventsListener,
-  removeAllListeners,
-  systemEvents
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  addDeepLinkListener,
-  addSystemEventListener,
-  addSystemEventsListener,
-  formatSystemEventLabel,
-  getDataSetSnapshot,
-  getRecentEvents,
-  initialize,
-  isInitialized,
-  removeAllListeners,
-  systemEvents,
-  track,
-  useAmplySystemEvents
-});
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts","../src/nativeModule.ts","../src/systemEvents.ts","../src/hooks/useAmplySystemEvents.ts","../src/systemEventUtils.ts"],"sourcesContent":["import getNativeModule from './nativeModule';\nimport {addSystemEventListener as addSystemEventListenerInternal} from './systemEvents';\nexport {useAmplySystemEvents} from './hooks/useAmplySystemEvents';\nexport {formatSystemEventLabel} from './systemEventUtils';\nimport type {\n  AmplyInitializationConfig,\n  DataSetSnapshot,\n  DataSetType,\n  DeepLinkEvent,\n  EventRecord,\n  TrackEventPayload,\n} from './nativeSpecs/NativeAmplyModule';\n\nlet deepLinkRegistered = false;\nconst deepLinkSubscriptions = new Set<() => void>();\n\nasync function ensureDeepLinkRegistration(): Promise<void> {\n  if (!deepLinkRegistered) {\n    console.log('[Amply] Calling registerDeepLinkListener on native module');\n    getNativeModule().registerDeepLinkListener();\n    deepLinkRegistered = true;\n    console.log('[Amply] registerDeepLinkListener completed');\n  }\n}\n\nfunction trackDeepLinkSubscription(subscription?: {remove?: () => void}): () => void {\n  let removed = false;\n  const unsubscribe = () => {\n    if (removed) {\n      return;\n    }\n    removed = true;\n    subscription?.remove?.();\n    deepLinkSubscriptions.delete(unsubscribe);\n  };\n  deepLinkSubscriptions.add(unsubscribe);\n  return unsubscribe;\n}\n\nexport async function initialize(config: AmplyInitializationConfig): Promise<void> {\n  await getNativeModule().initialize(config);\n}\n\nexport function isInitialized(): boolean {\n  return getNativeModule().isInitialized();\n}\n\nexport async function track(payload: TrackEventPayload): Promise<void> {\n  await getNativeModule().track(payload);\n}\n\nexport async function getRecentEvents(limit: number): Promise<EventRecord[]> {\n  return getNativeModule().getRecentEvents(limit);\n}\n\nexport async function getDataSetSnapshot(type: DataSetType): Promise<DataSetSnapshot> {\n  return getNativeModule().getDataSetSnapshot(type);\n}\n\nexport async function addDeepLinkListener(\n  listener: (event: DeepLinkEvent) => void\n): Promise<() => void> {\n  await ensureDeepLinkRegistration();\n  const subscription = getNativeModule().onDeepLink(listener);\n  return trackDeepLinkSubscription(subscription);\n}\n\nexport async function addSystemEventListener(\n  listener: (event: EventRecord) => void\n): Promise<() => void> {\n  return addSystemEventListenerInternal(listener);\n}\n\nexport function removeAllListeners(): void {\n  deepLinkSubscriptions.forEach(unsubscribe => {\n    try {\n      unsubscribe();\n    } catch (error) {\n      console.warn('[Amply] Failed to remove deep link listener', error);\n    }\n  });\n  deepLinkSubscriptions.clear();\n}\n\nexport type {\n  AmplyInitializationConfig,\n  DataSetSnapshot,\n  DataSetType,\n  DeepLinkEvent,\n  EventRecord,\n  TrackEventPayload,\n};\n\nexport function addSystemEventsListener(\n  listener: (event: EventRecord) => void,\n): Promise<() => void> {\n  return addSystemEventListener(listener);\n}\n\nexport const systemEvents = {\n  addListener: addSystemEventsListener,\n};\n\nexport default {\n  initialize,\n  isInitialized,\n  track,\n  getRecentEvents,\n  getDataSetSnapshot,\n  addDeepLinkListener,\n  addSystemEventListener,\n  addSystemEventsListener,\n  removeAllListeners,\n  systemEvents,\n};\n","import {NativeModules, TurboModuleRegistry} from 'react-native';\nimport type {Spec} from './nativeSpecs/NativeAmplyModule';\n\nconst MODULE_NAME = 'Amply';\n\nlet cachedModule: Spec | null = null;\nlet attemptedTurboLookup = false;\nlet resolvedTurboModule: Spec | null = null;\n\nfunction loadModule(): Spec | null {\n  const globalWithTurbo = globalThis as typeof globalThis & {\n    __turboModuleProxy?: unknown;\n  };\n\n  if (globalWithTurbo.__turboModuleProxy != null) {\n    if (!attemptedTurboLookup) {\n      attemptedTurboLookup = true;\n      try {\n        resolvedTurboModule = TurboModuleRegistry.getEnforcing<Spec>(MODULE_NAME);\n      } catch (error) {\n        resolvedTurboModule = null;\n        if (__DEV__) {\n          console.warn(\n            \"[Amply] TurboModule lookup failed; falling back to legacy NativeModules. \" +\n              (error instanceof Error ? error.message : String(error))\n          );\n        }\n      }\n    }\n    if (resolvedTurboModule) {\n      return resolvedTurboModule;\n    }\n  }\n\n  const legacyModule = NativeModules[MODULE_NAME] as Spec | undefined;\n  if (legacyModule) {\n    return legacyModule;\n  }\n\n  return null;\n}\n\nexport function getNativeModule(): Spec {\n  if (cachedModule) {\n    return cachedModule;\n  }\n\n  const module = loadModule();\n  if (!module) {\n    throw new Error(\n      `Amply native module '${MODULE_NAME}' not found. ` +\n        'Ensure the module is properly linked and new architecture is enabled.'\n    );\n  }\n\n  cachedModule = module;\n  return cachedModule;\n}\n\n// Testing hook to override the resolved native module.\nexport function __setNativeModule(mock: Spec | null): void {\n  cachedModule = mock;\n}\n\nexport default getNativeModule;\n","import getNativeModule from './nativeModule';\nimport type {SystemEventPayload} from './nativeSpecs/NativeAmplyModule';\n\nexport async function addSystemEventListener(\n  listener: (event: SystemEventPayload) => void,\n): Promise<() => void> {\n  const subscription = getNativeModule().onSystemEvent(listener);\n  return () => subscription?.remove?.();\n}\n\nexport const systemEvents = {\n  addListener: addSystemEventListener,\n};\n","import {useCallback, useEffect, useRef, useState} from 'react';\nimport type {EventRecord} from '../nativeSpecs/NativeAmplyModule';\nimport {addSystemEventListener} from '../systemEvents';\n\nexport type UseAmplySystemEventsOptions = {\n  maxEntries?: number;\n  dedupe?: boolean;\n  onEvent?: (event: EventRecord) => void;\n};\n\nexport type UseAmplySystemEventsResult = {\n  events: EventRecord[];\n  reset: () => void;\n};\n\nexport function useAmplySystemEvents(\n  options: UseAmplySystemEventsOptions = {},\n): UseAmplySystemEventsResult {\n  const {maxEntries = 50, dedupe = true, onEvent} = options;\n  const [events, setEvents] = useState<EventRecord[]>([]);\n  const seenKeysRef = useRef<Set<string>>(new Set());\n  const handlerRef = useRef<typeof onEvent>(onEvent);\n\n  useEffect(() => {\n    handlerRef.current = onEvent;\n  }, [onEvent]);\n\n  useEffect(() => {\n    let unsubscribe: (() => void) | undefined;\n    let isMounted = true;\n\n    addSystemEventListener(event => {\n      if (!isMounted) {\n        return;\n      }\n      if (dedupe) {\n        const key = `${event.name}-${event.timestamp}`;\n        if (seenKeysRef.current.has(key)) {\n          return;\n        }\n        seenKeysRef.current.add(key);\n      }\n      handlerRef.current?.(event);\n      setEvents(prev => {\n        const next = [...prev, event];\n        if (next.length > maxEntries) {\n          next.splice(0, next.length - maxEntries);\n        }\n        return next;\n      });\n    })\n      .then(unsub => {\n        if (!isMounted) {\n          unsub();\n        } else {\n          unsubscribe = unsub;\n        }\n      })\n      .catch(error => {\n        console.warn('[Amply] system event listener error', error);\n      });\n\n    return () => {\n      isMounted = false;\n      unsubscribe?.();\n    };\n  }, [dedupe, maxEntries]);\n\n  const reset = useCallback(() => {\n    seenKeysRef.current.clear();\n    setEvents([]);\n  }, []);\n\n  return {events, reset};\n}\n","import type {EventRecord} from './nativeSpecs/NativeAmplyModule';\n\nconst DEFAULT_LABELS: Record<string, string> = {\n  SdkInitialized: 'SDK initialized',\n  ConfigFetchStarted: 'Config fetch started',\n  ConfigFetchFinished: 'Config fetch finished',\n  SessionStarted: 'Session started',\n  SessionFinished: 'Session finished',\n  CampaignShown: 'Campaign shown',\n  EventTriggered: 'Event triggered',\n  CampaignStarted: 'Campaign processing started',\n  CampaignFinished: 'Campaign finished',\n};\n\nexport function formatSystemEventLabel(event: EventRecord): string {\n  if (event.name === 'CampaignShown') {\n    const campaignId = event.properties.campaignId as string | undefined;\n    const source = event.properties.source as string | undefined;\n    return `Campaign shown${campaignId ? ` (${campaignId})` : ''}${\n      source ? ` via ${source}` : ''\n    }`;\n  }\n  if (event.name === 'EventTriggered') {\n    const source = event.properties.sourceEvent as string | undefined;\n    return source ? `Event triggered (${source})` : DEFAULT_LABELS[event.name] ?? event.name;\n  }\n  if (event.name === 'ConfigFetchFinished') {\n    const success = event.properties.success as boolean | undefined;\n    const campaignCount = event.properties.campaignCount as number | undefined;\n    const countLabel =\n      typeof campaignCount === 'number' ? ` (${campaignCount} campaigns)` : '';\n    return success === false ? 'Config fetch failed' : `Config fetch finished${countLabel}`;\n  }\n  return DEFAULT_LABELS[event.name] ?? `System event ${event.name}`;\n}\n"],"mappings":"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","names":["addSystemEventListener","module","addSystemEventListener"]}