clintplay-react-native 0.2.1 → 0.2.2

package/README.md

@@ -2,7 +2,7 @@
 
 Session capture SDK for React Native / Expo apps — companion to [`clintplay-sdk`](../sdk) (web). Captures lifecycle, screen dimensions, navigation, JS errors, network requests (Fetch & XHR/Axios), console output, touches (screen-relative & target-relative), and native visual wireframe replay on iOS and Android.
 
-> **Status:** `0.2.1` — Production-ready JS runtime and Native TurboModule. Supports native view hierarchy traversal on iOS (`ios/ClintplayRN.mm`) and Android (`android/.../ClintplayRNModule.kt`), visual wireframe session replay, network interception for `fetch` and `XMLHttpRequest`/Axios, automatic navigation tracking, and intelligent auto-masking for sensitive fields.
+> **Status:** `0.2.2` — Production-ready JS runtime and Native TurboModule. Supports native view hierarchy traversal on iOS (`ios/ClintplayRN.mm`) and Android (`android/.../ClintplayRNModule.kt`), visual wireframe session replay, network interception for `fetch` and `XMLHttpRequest`/Axios, automatic navigation tracking, and intelligent auto-masking for sensitive fields.
 
 ## Install
 
@@ -12,7 +12,7 @@ pnpm add clintplay-react-native
 npm install clintplay-react-native
 ```
 
-Peer deps: `react >=18`, `react-native >=0.74`. Optional peer: `@react-native-async-storage/async-storage` (enables the offline retry queue when present). Tested against Expo SDK 54 / RN 0.81 with New Architecture enabled.
+Peer deps: `react >=18`, `react-native >=0.74`. Optional peer: `@react-native-async-storage/async-storage` (enables the offline retry queue when present). Android verified on Expo SDK 57 / RN 0.86.3 with New Architecture (debug and release builds, and wireframe capture on an emulator); iOS not re-verified on that version.
 
 In your `app.json`, register the config plugin:
 

package/android/build.gradle

@@ -1,19 +1,16 @@
-buildscript {
-  // Match the consumer app's Kotlin version so we don't drag in a
-  // conflicting toolchain. Most modern Expo SDK 54 / RN 0.81 apps
-  // ship Kotlin 1.9.x.
-  ext.kotlin_version = rootProject.ext.kotlin_version ?: '1.9.24'
-
-  repositories {
-    google()
-    mavenCentral()
-  }
-  dependencies {
-    classpath "com.android.tools.build:gradle:8.6.0"
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-  }
-}
-
+// No `buildscript` block: this module is only built inside a host app, whose
+// root build.gradle already puts the Android and Kotlin Gradle plugins on the
+// classpath (bare RN and Expo templates alike). Don't read a Kotlin version from
+// `rootProject.ext` either: Expo's template defines none, and in Groovy reading
+// a missing `ext` property throws instead of returning null.
+
+// On the classpath through the host's root build.gradle (resolved by the
+// includeBuild in its settings.gradle). Runs the codegen for the
+// `codegenConfig` in package.json (`ClintplayRNSpec`): autolinking adds that
+// spec's `codegen/jni` folder to the app's CMake build and its C++
+// ModuleProvider is what binds this TurboModule to JS, so without the plugin
+// the app's CMake configure fails on a directory that was never generated.
+apply plugin: 'com.facebook.react'
 apply plugin: 'com.android.library'
 apply plugin: 'org.jetbrains.kotlin.android'
 

package/android/src/main/java/digital/clint/clintplay/ClintplayRNModule.kt

@@ -43,9 +43,11 @@ import kotlin.math.round
 // coordinate conversion, background colors, extracted text, and
 // privacy auto-masking (clintplay-mask tags, password fields, and sensitive autofill hints).
 //
-// React Native's codegen emits `NativeClintplayRNSpec` from
-// `src/spec/NativeClintplayRN.ts` at build time. The TurboReactPackage
-// in `ClintplayRNPackage.kt` routes calls here.
+// React Native's codegen emits `NativeClintplayRNSpec` and its C++ JSI glue
+// from `src/spec/NativeClintplayRN.ts` at build time. This class does not
+// extend that spec: the glue calls the methods below by name and JNI signature
+// (`()Ljava/lang/String;`), so they must match the spec by hand. The
+// TurboReactPackage in `ClintplayRNPackage.kt` routes calls here.
 @ReactModule(name = ClintplayRNModule.NAME)
 class ClintplayRNModule(reactContext: ReactApplicationContext) :
   ReactContextBaseJavaModule(reactContext), TurboModule {
@@ -326,7 +328,9 @@ class ClintplayRNModule(reactContext: ReactApplicationContext) :
 
   @ReactMethod(isBlockingSynchronousMethod = true)
   fun captureViewHierarchy(): String {
-    val activity = currentActivity ?: return FALLBACK_JSON
+    // Not the inherited `currentActivity`: since RN 0.80 that is a deprecated
+    // protected Kotlin function, which property syntax does not resolve.
+    val activity = reactApplicationContext.currentActivity ?: return FALLBACK_JSON
 
     if (activity.isFinishing || activity.isDestroyed) {
       return FALLBACK_JSON
@@ -376,7 +380,7 @@ class ClintplayRNModule(reactContext: ReactApplicationContext) :
 
   companion object {
     const val NAME = "ClintplayRN"
-    private const val VERSION = "0.2.1"
+    private const val VERSION = "0.2.2"
     private const val FALLBACK_JSON = "{\"version\":1,\"nodes\":[]}"
 
     private val NO_METHOD_SENTINEL = Any()

package/dist/index.d.mts

@@ -7,6 +7,8 @@ interface SessionState {
     startedAt: number;
     lastActivity: number;
     userId: string | null;
+    tags: Set<string>;
+    metadata: Record<string, unknown>;
 }
 declare class SessionManager {
     private state;
@@ -15,13 +17,16 @@ declare class SessionManager {
     private create;
     current(): SessionState;
     touch(): void;
+    addTag(tag: string): boolean;
+    hasTag(tag: string): boolean;
+    setMetadata(data: Record<string, unknown>): void;
     setUser(userId: string | null): boolean;
     isStale(): boolean;
     rotateIfStale(): boolean;
     reset(): void;
 }
 
-type EventType = 'meta' | 'screen' | 'lifecycle' | 'navigation' | 'touch' | 'error' | 'log' | 'identify' | 'network' | 'wireframe';
+type EventType = 'meta' | 'screen' | 'lifecycle' | 'navigation' | 'touch' | 'error' | 'log' | 'identify' | 'network' | 'wireframe' | 'metadata' | 'tag';
 interface DeviceInfo {
     platform: 'ios' | 'android' | 'web';
     osVersion?: string;
@@ -92,6 +97,18 @@ interface NetworkEvent {
     durationMs?: number;
     error?: string;
 }
+interface MetadataEvent {
+    type: 'metadata';
+    ts: number;
+    data: Record<string, unknown>;
+}
+interface TagEvent {
+    type: 'tag';
+    ts: number;
+    data: {
+        tag: string;
+    };
+}
 interface WireframeNode {
     id: number;
     type: string;
@@ -117,7 +134,7 @@ interface WireframeEvent {
     version: number;
     nodes: WireframeNode[];
 }
-type ReplayEvent = MetaEvent | ScreenEvent | LifecycleEvent | NavigationEvent | TouchEvent | ErrorEvent | LogEvent | IdentifyEvent | NetworkEvent | WireframeEvent;
+type ReplayEvent = MetaEvent | ScreenEvent | LifecycleEvent | NavigationEvent | TouchEvent | ErrorEvent | LogEvent | IdentifyEvent | NetworkEvent | WireframeEvent | MetadataEvent | TagEvent;
 interface BackendEvent {
     type: string;
     timestamp: number;
@@ -390,6 +407,13 @@ interface InternalConfig {
     debug: boolean;
     captureWireframe: boolean;
 }
+declare const METADATA_MAX_KEYS = 50;
+declare const METADATA_MAX_DEPTH = 3;
+declare const METADATA_MAX_STRING_LENGTH = 1024;
+declare const METADATA_MAX_BYTES = 8192;
+declare const TAG_MAX_LENGTH = 128;
+declare function sanitizeTag(rawTag: unknown): string | null;
+declare function sanitizeMetadata(data: unknown): Record<string, unknown> | null;
 declare function formatEventForBatch(event: ReplayEvent | BackendEvent, defaultSessionId: string): BackendEvent;
 declare function init(rawConfig: ClintplayReactNativeConfig): typeof Clintplay;
 declare function identify(userId: string | number | null, traits?: Record<string, unknown>): void;
@@ -398,6 +422,8 @@ declare function reset(options?: {
 }): void;
 declare function trackScreen(path: string, from?: string): void;
 declare function reportError(err: unknown): void;
+declare function setMetadata(data: Record<string, unknown>): void;
+declare function tag(tagName: string): void;
 declare function flush(): Promise<void>;
 declare function stop(): Promise<void>;
 declare function current(): {
@@ -423,10 +449,12 @@ declare const Clintplay: {
     reset: typeof reset;
     trackScreen: typeof trackScreen;
     reportError: typeof reportError;
+    setMetadata: typeof setMetadata;
+    tag: typeof tag;
     flush: typeof flush;
     stop: typeof stop;
     current: typeof current;
     _getState: typeof _getState;
 };
 
-export { type BackendEvent, CLINTPLAY_MASK_ID, Clintplay, ClintplayCaptureProvider, type ClintplayCaptureProviderProps, ClintplayMaskImage, type ClintplayMaskImageProps, ClintplayMaskTextInput, type ClintplayMaskTextInputProps, ClintplayMaskView, type ClintplayMaskViewProps, ClintplayNavigationTracker, type ClintplayNavigationTrackerProps, type ClintplayReactNativeConfig, type DeviceInfo, type NavigationRouteLike, type NavigationStateLike, type NavigationStateListenerCallback, type NavigationStateListenerOptions, type ReplayBatch, type ReplayEvent, SDK_VERSION, type UseClintplayNavigationOptions, type UseClintplayNavigationResult, type WireframeEvent, type WireframeNode, _resetLastTrackedRoute, createClintplayNavigationStateListener, formatEventForBatch, getActiveRouteName, init, sanitizeRoute, useClintplayNavigationTracking };
+export { type BackendEvent, CLINTPLAY_MASK_ID, Clintplay, ClintplayCaptureProvider, type ClintplayCaptureProviderProps, ClintplayMaskImage, type ClintplayMaskImageProps, ClintplayMaskTextInput, type ClintplayMaskTextInputProps, ClintplayMaskView, type ClintplayMaskViewProps, ClintplayNavigationTracker, type ClintplayNavigationTrackerProps, type ClintplayReactNativeConfig, type DeviceInfo, METADATA_MAX_BYTES, METADATA_MAX_DEPTH, METADATA_MAX_KEYS, METADATA_MAX_STRING_LENGTH, type MetadataEvent, type NavigationRouteLike, type NavigationStateLike, type NavigationStateListenerCallback, type NavigationStateListenerOptions, type ReplayBatch, type ReplayEvent, SDK_VERSION, TAG_MAX_LENGTH, type TagEvent, type UseClintplayNavigationOptions, type UseClintplayNavigationResult, type WireframeEvent, type WireframeNode, _resetLastTrackedRoute, createClintplayNavigationStateListener, formatEventForBatch, getActiveRouteName, init, sanitizeMetadata, sanitizeRoute, sanitizeTag, setMetadata, tag, useClintplayNavigationTracking };

package/dist/index.d.ts

@@ -7,6 +7,8 @@ interface SessionState {
     startedAt: number;
     lastActivity: number;
     userId: string | null;
+    tags: Set<string>;
+    metadata: Record<string, unknown>;
 }
 declare class SessionManager {
     private state;
@@ -15,13 +17,16 @@ declare class SessionManager {
     private create;
     current(): SessionState;
     touch(): void;
+    addTag(tag: string): boolean;
+    hasTag(tag: string): boolean;
+    setMetadata(data: Record<string, unknown>): void;
     setUser(userId: string | null): boolean;
     isStale(): boolean;
     rotateIfStale(): boolean;
     reset(): void;
 }
 
-type EventType = 'meta' | 'screen' | 'lifecycle' | 'navigation' | 'touch' | 'error' | 'log' | 'identify' | 'network' | 'wireframe';
+type EventType = 'meta' | 'screen' | 'lifecycle' | 'navigation' | 'touch' | 'error' | 'log' | 'identify' | 'network' | 'wireframe' | 'metadata' | 'tag';
 interface DeviceInfo {
     platform: 'ios' | 'android' | 'web';
     osVersion?: string;
@@ -92,6 +97,18 @@ interface NetworkEvent {
     durationMs?: number;
     error?: string;
 }
+interface MetadataEvent {
+    type: 'metadata';
+    ts: number;
+    data: Record<string, unknown>;
+}
+interface TagEvent {
+    type: 'tag';
+    ts: number;
+    data: {
+        tag: string;
+    };
+}
 interface WireframeNode {
     id: number;
     type: string;
@@ -117,7 +134,7 @@ interface WireframeEvent {
     version: number;
     nodes: WireframeNode[];
 }
-type ReplayEvent = MetaEvent | ScreenEvent | LifecycleEvent | NavigationEvent | TouchEvent | ErrorEvent | LogEvent | IdentifyEvent | NetworkEvent | WireframeEvent;
+type ReplayEvent = MetaEvent | ScreenEvent | LifecycleEvent | NavigationEvent | TouchEvent | ErrorEvent | LogEvent | IdentifyEvent | NetworkEvent | WireframeEvent | MetadataEvent | TagEvent;
 interface BackendEvent {
     type: string;
     timestamp: number;
@@ -390,6 +407,13 @@ interface InternalConfig {
     debug: boolean;
     captureWireframe: boolean;
 }
+declare const METADATA_MAX_KEYS = 50;
+declare const METADATA_MAX_DEPTH = 3;
+declare const METADATA_MAX_STRING_LENGTH = 1024;
+declare const METADATA_MAX_BYTES = 8192;
+declare const TAG_MAX_LENGTH = 128;
+declare function sanitizeTag(rawTag: unknown): string | null;
+declare function sanitizeMetadata(data: unknown): Record<string, unknown> | null;
 declare function formatEventForBatch(event: ReplayEvent | BackendEvent, defaultSessionId: string): BackendEvent;
 declare function init(rawConfig: ClintplayReactNativeConfig): typeof Clintplay;
 declare function identify(userId: string | number | null, traits?: Record<string, unknown>): void;
@@ -398,6 +422,8 @@ declare function reset(options?: {
 }): void;
 declare function trackScreen(path: string, from?: string): void;
 declare function reportError(err: unknown): void;
+declare function setMetadata(data: Record<string, unknown>): void;
+declare function tag(tagName: string): void;
 declare function flush(): Promise<void>;
 declare function stop(): Promise<void>;
 declare function current(): {
@@ -423,10 +449,12 @@ declare const Clintplay: {
     reset: typeof reset;
     trackScreen: typeof trackScreen;
     reportError: typeof reportError;
+    setMetadata: typeof setMetadata;
+    tag: typeof tag;
     flush: typeof flush;
     stop: typeof stop;
     current: typeof current;
     _getState: typeof _getState;
 };
 
-export { type BackendEvent, CLINTPLAY_MASK_ID, Clintplay, ClintplayCaptureProvider, type ClintplayCaptureProviderProps, ClintplayMaskImage, type ClintplayMaskImageProps, ClintplayMaskTextInput, type ClintplayMaskTextInputProps, ClintplayMaskView, type ClintplayMaskViewProps, ClintplayNavigationTracker, type ClintplayNavigationTrackerProps, type ClintplayReactNativeConfig, type DeviceInfo, type NavigationRouteLike, type NavigationStateLike, type NavigationStateListenerCallback, type NavigationStateListenerOptions, type ReplayBatch, type ReplayEvent, SDK_VERSION, type UseClintplayNavigationOptions, type UseClintplayNavigationResult, type WireframeEvent, type WireframeNode, _resetLastTrackedRoute, createClintplayNavigationStateListener, formatEventForBatch, getActiveRouteName, init, sanitizeRoute, useClintplayNavigationTracking };
+export { type BackendEvent, CLINTPLAY_MASK_ID, Clintplay, ClintplayCaptureProvider, type ClintplayCaptureProviderProps, ClintplayMaskImage, type ClintplayMaskImageProps, ClintplayMaskTextInput, type ClintplayMaskTextInputProps, ClintplayMaskView, type ClintplayMaskViewProps, ClintplayNavigationTracker, type ClintplayNavigationTrackerProps, type ClintplayReactNativeConfig, type DeviceInfo, METADATA_MAX_BYTES, METADATA_MAX_DEPTH, METADATA_MAX_KEYS, METADATA_MAX_STRING_LENGTH, type MetadataEvent, type NavigationRouteLike, type NavigationStateLike, type NavigationStateListenerCallback, type NavigationStateListenerOptions, type ReplayBatch, type ReplayEvent, SDK_VERSION, TAG_MAX_LENGTH, type TagEvent, type UseClintplayNavigationOptions, type UseClintplayNavigationResult, type WireframeEvent, type WireframeNode, _resetLastTrackedRoute, createClintplayNavigationStateListener, formatEventForBatch, getActiveRouteName, init, sanitizeMetadata, sanitizeRoute, sanitizeTag, setMetadata, tag, useClintplayNavigationTracking };

package/dist/index.js

@@ -55,7 +55,14 @@ var SessionManager = class {
   }
   create() {
     const ts = this.now();
-    return { sessionId: uuid(), startedAt: ts, lastActivity: ts, userId: null };
+    return {
+      sessionId: uuid(),
+      startedAt: ts,
+      lastActivity: ts,
+      userId: null,
+      tags: /* @__PURE__ */ new Set(),
+      metadata: {}
+    };
   }
   current() {
     return this.state;
@@ -63,6 +70,19 @@ var SessionManager = class {
   touch() {
     this.state.lastActivity = this.now();
   }
+  addTag(tag2) {
+    if (this.state.tags.has(tag2)) {
+      return false;
+    }
+    this.state.tags.add(tag2);
+    return true;
+  }
+  hasTag(tag2) {
+    return this.state.tags.has(tag2);
+  }
+  setMetadata(data) {
+    this.state.metadata = { ...this.state.metadata, ...data };
+  }
   setUser(userId) {
     const prev = this.state.userId;
     if (prev !== null && (userId === null || prev !== userId)) {
@@ -917,7 +937,7 @@ function captureViewHierarchy() {
 }
 
 // package.json
-var version = "0.2.1";
+var version = "0.2.2";
 var CLINTPLAY_MASK_ID = "clintplay-mask";
 var ClintplayMaskView = React5__default.default.forwardRef(function ClintplayMaskView2({ children, testID, ...rest }, ref) {
   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -1229,6 +1249,124 @@ function ClintplayNavigationTracker({
 // src/index.ts
 var SDK_VERSION = version;
 var state = null;
+var METADATA_MAX_KEYS = 50;
+var METADATA_MAX_DEPTH = 3;
+var METADATA_MAX_STRING_LENGTH = 1024;
+var METADATA_MAX_BYTES = 8192;
+var TAG_MAX_LENGTH = 128;
+var pendingMetadata = {};
+var pendingTags = /* @__PURE__ */ new Set();
+function sanitizeTag(rawTag) {
+  if (typeof rawTag !== "string") return null;
+  const trimmed = rawTag.trim();
+  if (trimmed.length === 0) return null;
+  const normalized = typeof trimmed.normalize === "function" ? trimmed.normalize("NFC") : trimmed;
+  return normalized.slice(0, TAG_MAX_LENGTH);
+}
+function isPlainObject(val) {
+  return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+function sanitizeMetadataValue(val, depth, seen) {
+  if (val === null || val === void 0) {
+    return val;
+  }
+  if (typeof val === "function" || typeof val === "symbol") {
+    return void 0;
+  }
+  if (typeof val === "string") {
+    return val.slice(0, METADATA_MAX_STRING_LENGTH);
+  }
+  if (typeof val === "number") {
+    return Number.isFinite(val) ? val : null;
+  }
+  if (typeof val === "boolean") {
+    return val;
+  }
+  if (typeof val === "bigint") {
+    return val.toString();
+  }
+  if (val instanceof Date) {
+    return Number.isNaN(val.getTime()) ? null : val.toISOString();
+  }
+  if (typeof val === "object") {
+    if (seen.has(val)) {
+      return "[Circular]";
+    }
+    seen.add(val);
+    try {
+      if (depth > METADATA_MAX_DEPTH) {
+        return void 0;
+      }
+      if (Array.isArray(val)) {
+        const arr = [];
+        for (const item of val) {
+          const cleaned = sanitizeMetadataValue(item, depth + 1, seen);
+          if (cleaned !== void 0) {
+            arr.push(cleaned);
+          }
+        }
+        return arr;
+      }
+      const obj = {};
+      const entries = Object.entries(val);
+      let keyCount = 0;
+      for (const [k, v] of entries) {
+        if (k === "__proto__" || k === "constructor" || k === "prototype") {
+          continue;
+        }
+        if (keyCount >= METADATA_MAX_KEYS) {
+          break;
+        }
+        const cleaned = sanitizeMetadataValue(v, depth + 1, seen);
+        if (cleaned !== void 0) {
+          obj[k] = cleaned;
+          keyCount++;
+        }
+      }
+      return obj;
+    } finally {
+      seen.delete(val);
+    }
+  }
+  return void 0;
+}
+function sanitizeMetadata(data) {
+  if (!isPlainObject(data)) {
+    return null;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  seen.add(data);
+  const result = {};
+  const entries = Object.entries(data);
+  let keyCount = 0;
+  for (const [k, v] of entries) {
+    if (k === "__proto__" || k === "constructor" || k === "prototype") {
+      continue;
+    }
+    if (keyCount >= METADATA_MAX_KEYS) {
+      break;
+    }
+    const cleaned = sanitizeMetadataValue(v, 1, seen);
+    if (cleaned !== void 0) {
+      result[k] = cleaned;
+      keyCount++;
+    }
+  }
+  try {
+    let json = JSON.stringify(result);
+    if (json.length > METADATA_MAX_BYTES) {
+      const keys = Object.keys(result);
+      while (keys.length > 0 && json.length > METADATA_MAX_BYTES) {
+        const lastKey = keys.pop();
+        delete result[lastKey];
+        json = JSON.stringify(result);
+      }
+    }
+  } catch {
+    return null;
+  }
+  return result;
+}
 function deviceInfo() {
   const os = reactNative.Platform.OS;
   const platform = os === "ios" ? "ios" : os === "android" ? "android" : "web";
@@ -1374,6 +1512,30 @@ function init(rawConfig) {
     });
   }
   pushSessionMeta(local);
+  if (Object.keys(pendingMetadata).length > 0) {
+    local.session.setMetadata(pendingMetadata);
+    if (!excluded.has("metadata")) {
+      local.buffer.push({
+        type: "metadata",
+        ts: Date.now(),
+        data: pendingMetadata
+      });
+    }
+    pendingMetadata = {};
+  }
+  if (pendingTags.size > 0) {
+    for (const t of pendingTags) {
+      local.session.addTag(t);
+      if (!excluded.has("tag")) {
+        local.buffer.push({
+          type: "tag",
+          ts: Date.now(),
+          data: { tag: t }
+        });
+      }
+    }
+    pendingTags.clear();
+  }
   recorder.start();
   local.networkInterceptor?.start();
   local.consoleInterceptor?.start();
@@ -1465,11 +1627,54 @@ function reportError(err) {
     fatal: false
   });
 }
+function setMetadata(data) {
+  const sanitized = sanitizeMetadata(data);
+  if (!sanitized || Object.keys(sanitized).length === 0) return;
+  if (!state?.active) {
+    pendingMetadata = { ...pendingMetadata, ...sanitized };
+    return;
+  }
+  state.session.setMetadata(sanitized);
+  state.session.touch();
+  if (!state.excluded.has("metadata")) {
+    state.buffer.push({
+      type: "metadata",
+      ts: Date.now(),
+      data: sanitized
+    });
+    if (state.buffer.size() >= state.config.flushSize) {
+      void flushOnce(state);
+    }
+  }
+}
+function tag(tagName) {
+  const cleaned = sanitizeTag(tagName);
+  if (!cleaned) return;
+  if (!state?.active) {
+    pendingTags.add(cleaned);
+    return;
+  }
+  if (state.session.addTag(cleaned)) {
+    state.session.touch();
+    if (!state.excluded.has("tag")) {
+      state.buffer.push({
+        type: "tag",
+        ts: Date.now(),
+        data: { tag: cleaned }
+      });
+      if (state.buffer.size() >= state.config.flushSize) {
+        void flushOnce(state);
+      }
+    }
+  }
+}
 async function flush() {
   if (!state?.active) return;
   await flushOnce(state);
 }
 async function stop() {
+  pendingMetadata = {};
+  pendingTags.clear();
   if (!state?.active) return;
   const s = state;
   s.active = false;
@@ -1499,6 +1704,8 @@ var Clintplay = {
   reset,
   trackScreen,
   reportError,
+  setMetadata,
+  tag,
   flush,
   stop,
   current,
@@ -1512,13 +1719,22 @@ exports.ClintplayMaskImage = ClintplayMaskImage;
 exports.ClintplayMaskTextInput = ClintplayMaskTextInput;
 exports.ClintplayMaskView = ClintplayMaskView;
 exports.ClintplayNavigationTracker = ClintplayNavigationTracker;
+exports.METADATA_MAX_BYTES = METADATA_MAX_BYTES;
+exports.METADATA_MAX_DEPTH = METADATA_MAX_DEPTH;
+exports.METADATA_MAX_KEYS = METADATA_MAX_KEYS;
+exports.METADATA_MAX_STRING_LENGTH = METADATA_MAX_STRING_LENGTH;
 exports.SDK_VERSION = SDK_VERSION;
+exports.TAG_MAX_LENGTH = TAG_MAX_LENGTH;
 exports._resetLastTrackedRoute = _resetLastTrackedRoute;
 exports.createClintplayNavigationStateListener = createClintplayNavigationStateListener;
 exports.formatEventForBatch = formatEventForBatch;
 exports.getActiveRouteName = getActiveRouteName;
 exports.init = init;
+exports.sanitizeMetadata = sanitizeMetadata;
 exports.sanitizeRoute = sanitizeRoute;
+exports.sanitizeTag = sanitizeTag;
+exports.setMetadata = setMetadata;
+exports.tag = tag;
 exports.useClintplayNavigationTracking = useClintplayNavigationTracking;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map