@luciq/react-native 19.0.0-286-SNAPSHOT → 19.1.0

package/src/modules/SessionReplay.ts

@@ -1,5 +1,6 @@
 import { NativeSessionReplay, NativeEvents, emitter } from '../native/NativeSessionReplay';
 import type { SessionMetadata } from '../models/SessionMetadata';
+import type { CapturingMode, ScreenshotQuality } from '../utils/Enums';
 /**
  * Enables or disables Session Replay for your Luciq integration.
  *
@@ -13,7 +14,6 @@ import type { SessionMetadata } from '../models/SessionMetadata';
  * ```
  */
 export const setEnabled = (isEnabled: boolean) => {
-  console.log('[LCQ-RN] SessionReplay.setEnabled called', { isEnabled });
   NativeSessionReplay.setEnabled(isEnabled);
 };
 
@@ -30,7 +30,6 @@ export const setEnabled = (isEnabled: boolean) => {
  * ```
  */
 export const setNetworkLogsEnabled = (isEnabled: boolean) => {
-  console.log('[LCQ-RN] SessionReplay.setNetworkLogsEnabled called', { isEnabled });
   NativeSessionReplay.setNetworkLogsEnabled(isEnabled);
 };
 
@@ -47,7 +46,6 @@ export const setNetworkLogsEnabled = (isEnabled: boolean) => {
  * ```
  */
 export const setLuciqLogsEnabled = (isEnabled: boolean) => {
-  console.log('[LCQ-RN] SessionReplay.setLuciqLogsEnabled called', { isEnabled });
   NativeSessionReplay.setLuciqLogsEnabled(isEnabled);
 };
 
@@ -64,7 +62,6 @@ export const setLuciqLogsEnabled = (isEnabled: boolean) => {
  * ```
  */
 export const setUserStepsEnabled = (isEnabled: boolean) => {
-  console.log('[LCQ-RN] SessionReplay.setUserStepsEnabled called', { isEnabled });
   NativeSessionReplay.setUserStepsEnabled(isEnabled);
 };
 
@@ -77,7 +74,6 @@ export const setUserStepsEnabled = (isEnabled: boolean) => {
  * ```
  */
 export const getSessionReplayLink = async (): Promise<string> => {
-  console.log('[LCQ-RN] SessionReplay.getSessionReplayLink called');
   return NativeSessionReplay.getSessionReplayLink();
 };
 
@@ -99,7 +95,6 @@ export const getSessionReplayLink = async (): Promise<string> => {
 export const setSyncCallback = async (
   handler: (payload: SessionMetadata) => boolean,
 ): Promise<void> => {
-  console.log('[LCQ-RN] SessionReplay.setSyncCallback called');
   emitter.addListener(NativeEvents.SESSION_REPLAY_ON_SYNC_CALLBACK_INVOCATION, (payload) => {
     const result = handler(payload);
     const shouldSync = Boolean(result);
@@ -115,3 +110,65 @@ export const setSyncCallback = async (
 
   return NativeSessionReplay.setSyncCallback();
 };
+
+/**
+ * Sets the capturing mode for Session Replay screenshots.
+ *
+ * - `navigation`: Captures screenshots only when users navigate between screens (default).
+ * - `interactions`: Captures screenshots on screen navigation and user interactions.
+ * - `frequency`: Captures screenshots at a fixed time interval for video-like playback.
+ *
+ * Note: Should be called before SDK initialization for best results.
+ *
+ * @param mode The capturing mode to use.
+ *
+ * @example
+ * ```ts
+ * import { CapturingMode } from '@luciq/react-native';
+ *
+ * SessionReplay.setCapturingMode(CapturingMode.frequency);
+ * ```
+ */
+export const setCapturingMode = (mode: CapturingMode) => {
+  NativeSessionReplay.setCapturingMode(mode);
+};
+
+/**
+ * Sets the visual quality of captured Session Replay screenshots.
+ *
+ * - `high`: 50% WebP compression - Best visual quality (~62 screenshots per session).
+ * - `normal`: 25% WebP compression - Balanced quality and storage (~104 screenshots per session, default).
+ * - `greyscale`: Grayscale + 25% WebP compression - Maximum storage efficiency (~130 screenshots per session).
+ *
+ * @param quality The screenshot quality profile to use.
+ *
+ * @example
+ * ```ts
+ * import { ScreenshotQuality } from '@luciq/react-native';
+ *
+ * SessionReplay.setScreenshotQuality(ScreenshotQuality.high);
+ * ```
+ */
+export const setScreenshotQuality = (quality: ScreenshotQuality) => {
+  NativeSessionReplay.setScreenshotQuality(quality);
+};
+
+/**
+ * Sets the capture interval for Session Replay when using frequency capturing mode.
+ *
+ * This determines how often screenshots are captured when `CapturingMode.frequency` is set.
+ *
+ * @param intervalMs Time between captures in milliseconds. Minimum: 500ms, Default: 1000ms.
+ *
+ * @example
+ * ```ts
+ * // Capture every 500ms (2 FPS)
+ * SessionReplay.setScreenshotCaptureInterval(500);
+ *
+ * // Capture every 2 seconds
+ * SessionReplay.setScreenshotCaptureInterval(2000);
+ * ```
+ */
+export const setScreenshotCaptureInterval = (intervalMs: number) => {
+  NativeSessionReplay.setScreenshotCaptureInterval(intervalMs);
+};

package/src/modules/Surveys.ts

@@ -15,7 +15,6 @@ export type { Survey };
  * @param isEnabled A boolean to set whether Luciq Surveys is enabled or disabled.
  */
 export const setEnabled = (isEnabled: boolean) => {
-  console.log('[LCQ-RN] Surveys.setEnabled called', { isEnabled });
   NativeSurveys.setEnabled(isEnabled);
 };
 
@@ -26,7 +25,6 @@ export const setEnabled = (isEnabled: boolean) => {
  * in the current session.
  */
 export const showSurveyIfAvailable = () => {
-  console.log('[LCQ-RN] Surveys.showSurveyIfAvailable called');
   NativeSurveys.showSurveysIfAvailable();
 };
 
@@ -34,7 +32,6 @@ export const showSurveyIfAvailable = () => {
  * Returns an array containing the available surveys.
  */
 export const getAvailableSurveys = async (): Promise<Survey[] | null> => {
-  console.log('[LCQ-RN] Surveys.getAvailableSurveys called');
   const surveys = await NativeSurveys.getAvailableSurveys();
 
   return surveys;
@@ -46,7 +43,6 @@ export const getAvailableSurveys = async (): Promise<Survey[] | null> => {
  *                                surveys auto showing are enabled or not.
  */
 export const setAutoShowingEnabled = (autoShowingSurveysEnabled: boolean) => {
-  console.log('[LCQ-RN] Surveys.setAutoShowingEnabled called', { autoShowingSurveysEnabled });
   NativeSurveys.setAutoShowingEnabled(autoShowingSurveysEnabled);
 };
 
@@ -58,7 +54,6 @@ export const setAutoShowingEnabled = (autoShowingSurveysEnabled: boolean) => {
  * presenting the survey's UI.
  */
 export const setOnShowHandler = (onShowHandler: () => void) => {
-  console.log('[LCQ-RN] Surveys.setOnShowHandler called');
   emitter.addListener(NativeEvents.WILL_SHOW_SURVEY_HANDLER, onShowHandler);
   NativeSurveys.setOnShowHandler(onShowHandler);
 };
@@ -71,7 +66,6 @@ export const setOnShowHandler = (onShowHandler: () => void) => {
  * the survey's UI is dismissed.
  */
 export const setOnDismissHandler = (onDismissHandler: () => void) => {
-  console.log('[LCQ-RN] Surveys.setOnDismissHandler called');
   emitter.addListener(NativeEvents.DID_DISMISS_SURVEY_HANDLER, onDismissHandler);
   NativeSurveys.setOnDismissHandler(onDismissHandler);
 };
@@ -84,7 +78,6 @@ export const setOnDismissHandler = (onDismissHandler: () => void) => {
  *
  */
 export const showSurvey = (surveyToken: string) => {
-  console.log('[LCQ-RN] Surveys.showSurvey called', { surveyToken });
   NativeSurveys.showSurvey(surveyToken);
 };
 
@@ -96,7 +89,6 @@ export const showSurvey = (surveyToken: string) => {
  *
  */
 export const hasRespondedToSurvey = async (surveyToken: string): Promise<boolean | null> => {
-  console.log('[LCQ-RN] Surveys.hasRespondedToSurvey called', { surveyToken });
   const hasResponded = await NativeSurveys.hasRespondedToSurvey(surveyToken);
 
   return hasResponded;
@@ -109,7 +101,6 @@ export const hasRespondedToSurvey = async (surveyToken: string): Promise<boolean
  *                                welcome screen should show.
  */
 export const setShouldShowWelcomeScreen = (shouldShowWelcomeScreen: boolean) => {
-  console.log('[LCQ-RN] Surveys.setShouldShowWelcomeScreen called', { shouldShowWelcomeScreen });
   NativeSurveys.setShouldShowWelcomeScreen(shouldShowWelcomeScreen);
 };
 
@@ -121,7 +112,6 @@ export const setShouldShowWelcomeScreen = (shouldShowWelcomeScreen: boolean) =>
  */
 
 export const setAppStoreURL = (appStoreURL: string) => {
-  console.log('[LCQ-RN] Surveys.setAppStoreURL called', { appStoreURL });
   if (Platform.OS === 'ios') {
     NativeSurveys.setAppStoreURL(appStoreURL);
   }

package/src/native/NativeConstants.ts

@@ -16,7 +16,9 @@ export type NativeConstants = NativeSdkDebugLogsLevel &
   NativeLaunchType &
   NativeOverAirUpdateServices &
   NativeAutoMaskingType &
-  NativeUserConsentActionType;
+  NativeUserConsentActionType &
+  NativeCapturingMode &
+  NativeScreenshotQuality;
 
 interface NativeSdkDebugLogsLevel {
   sdkDebugLogsLevelVerbose: any;
@@ -213,3 +215,15 @@ interface NativeAutoMaskingType {
   media: any;
   none: any;
 }
+
+interface NativeCapturingMode {
+  capturingModeNavigation: any;
+  capturingModeInteractions: any;
+  capturingModeFrequency: any;
+}
+
+interface NativeScreenshotQuality {
+  screenshotQualityHigh: any;
+  screenshotQualityNormal: any;
+  screenshotQualityGreyscale: any;
+}

package/src/native/NativeSessionReplay.ts

@@ -11,6 +11,9 @@ export interface SessionReplayNativeModule extends NativeModule {
   getSessionReplayLink(): Promise<string>;
   setSyncCallback(): Promise<void>;
   evaluateSync(shouldSync: boolean): void;
+  setCapturingMode(mode: any): void;
+  setScreenshotQuality(quality: any): void;
+  setScreenshotCaptureInterval(intervalMs: number): void;
 }
 
 export const NativeSessionReplay = NativeModules.LCQSessionReplay;

package/src/utils/Enums.ts

@@ -264,3 +264,42 @@ export enum AutoMaskingType {
   media = constants.media,
   none = constants.none,
 }
+
+/**
+ * The capturing mode for Session Replay screenshots.
+ */
+export enum CapturingMode {
+  /**
+   * Captures screenshots only when users navigate between screens.
+   * This is the default behavior and provides the lowest overhead.
+   */
+  navigation = constants.capturingModeNavigation,
+  /**
+   * Captures screenshots on screen navigation and user interactions.
+   * Includes debouncing to prevent excessive captures.
+   */
+  interactions = constants.capturingModeInteractions,
+  /**
+   * Captures screenshots at a fixed time interval for true video-like playback.
+   * Also captures on screen navigation.
+   */
+  frequency = constants.capturingModeFrequency,
+}
+
+/**
+ * The quality profile for Session Replay screenshots.
+ */
+export enum ScreenshotQuality {
+  /**
+   * 50% WebP compression - Best visual quality.
+   */
+  high = constants.screenshotQualityHigh,
+  /**
+   * 25% WebP compression - Balanced quality and storage (default).
+   */
+  normal = constants.screenshotQualityNormal,
+  /**
+   * Grayscale + 25% WebP compression - Maximum storage efficiency.
+   */
+  greyscale = constants.screenshotQualityGreyscale,
+}