luciq_flutter

Added

• Add support for logging user events with key-value parameters using UserEventParam. (#70)
• Adds a new Surveys.setOnFinishCallback API that notifies the host app when a survey finishes,
  whether it was submitted, ended midway, or dismissed at the
  start. (#74)
• Add support for Swift-Package-Manager (
  SPM) (#76)

Changed

• Bump Luciq iOS SDK to
  v19.9.3 (#77). See release notes.
• Bump Luciq Android SDK to
  v19.10.0 (#77). See release notes.

Added

• Add support for logging user events with key-value parameters using UserEventParam. (#70)

• Adds a new Surveys.setOnFinishCallback API that notifies the host app when a survey finishes, whether it was submitted, ended midway, or dismissed at the start. (#74)

• Add support for Swift-Package-Manager ( SPM) (#76)

Changed

• Bump Luciq iOS SDK to v19.9.3 (#77). See release notes.

• Bump Luciq Android SDK to v19.10.0 (#77). See release notes.

Add

• comprehensive debug logging across all modules and performance-critical hot paths, ensuring the strict protection and redaction of SDK consumer PII.

Fixed

• Prevent PixelCopy crash on invalid surface during capture (#67).

Changed

• Bump Luciq iOS SDK to v19.8.1 (#62). See release notes.
• Bump Luciq Android SDK to v19.8.0 (#62). See release notes.

BREAKING CHANGES

Errors thrown by native (Pigeon) host calls are now logged and swallowed by the SDK instead of being re-thrown into your app. This honors the SDK rule that no exception may escape into the embedding application. As a consequence, every public API that previously returned a value now returns its nullable equivalent â�� null signals that the underlying host call failed.
Affected public APIs:

final hasChats = (await Replies.hasChats()) ?? false;
final unread = (await Replies.getUnreadRepliesCount()) ?? 0;
final link = await SessionReplay.getSessionReplayLink();
if (link != null) { ... }

Add

• comprehensive debug logging across all modules and performance-critical hot paths, ensuring the strict protection and redaction of SDK consumer PII.

Fixed

• Prevent PixelCopy crash on invalid surface during capture (#67).

Changed

• Bump Luciq iOS SDK to v19.8.1 (#62). See release notes.

• Bump Luciq Android SDK to v19.8.0 (#62). See release notes.

BREAKING CHANGES

Errors thrown by native (Pigeon) host calls are now logged and swallowed by the SDK instead of being re-thrown into your app. This honors the SDK rule that no exception may escape into the embedding application. As a consequence, every public API that previously returned a value now returns its nullable equivalent — null signals that the underlying host call failed.

Affected public APIs:

Migration: coalesce with a sensible default or null-check before use, e.g.

final hasChats = (await Replies.hasChats()) ?? false;
final unread = (await Replies.getUnreadRepliesCount()) ?? 0;
final link = await SessionReplay.getSessionReplayLink();
if (link != null) { ... }

Added

• WebView Support: New APIs to monitor WebViews in your app, including page navigations, user interactions, and network requests issued from inside the WebView. Screenshots and session replays now capture WebView content alongside the rest of the UI.
  Enable WebView monitoring after Luciq.init:

  // Enable WebView monitoring (required for the APIs below).
  Luciq.setWebViewMonitoringEnabled(true);
  // Track taps and other user interactions inside WebViews.
  Luciq.setWebViewUserInteractionsTrackingEnabled(true);
  // Log network requests issued from WebViews.
  Luciq.setWebViewNetworkTrackingEnabled(true);

  All three APIs default to disabled. setWebViewMonitoringEnabled must be on for the user-interactions and network-tracking APIs to take effect.

Changed

• Bump Luciq iOS SDK to v19.7.0 (#57). See release notes.
• Bump Luciq Android SDK to v19.7.0 (#57). See release notes.

Added

• WebView Support: New APIs to monitor WebViews in your app, including page navigations, user interactions, and network requests issued from inside the WebView. Screenshots and session replays now capture WebView content alongside the rest of the UI.

  Enable WebView monitoring after Luciq.init:

  // Enable WebView monitoring (required for the APIs below).
  Luciq.setWebViewMonitoringEnabled(true);
  
  // Track taps and other user interactions inside WebViews.
  Luciq.setWebViewUserInteractionsTrackingEnabled(true);
  
  // Log network requests issued from WebViews.
  Luciq.setWebViewNetworkTrackingEnabled(true);
  

  All three APIs default to disabled. setWebViewMonitoringEnabled must be on for the user-interactions and network-tracking APIs to take effect.

Changed

• Bump Luciq iOS SDK to v19.7.0 (#57). See release notes.

• Bump Luciq Android SDK to v19.7.0 (#57). See release notes.

Added

• Add support for Screen Loading with react-navigation integration and manual reporting API.

Changed

• Bump Luciq iOS SDK to v19.6.1 (#60). See release notes.
• Bump Luciq Android SDK to v19.6.0 (#60). See release notes.

Added

• Add support for Screen Loading with react-navigation integration and manual reporting API.

Changed

• Bump Luciq iOS SDK to v19.6.1 (#60). See release notes.

• Bump Luciq Android SDK to v19.6.0 (#60). See release notes.

Added

• Session Replay Screenshot Quality Control: New API to adjust the visual quality of captured screenshots.

  // Available quality options:
  // - ScreenshotQualityMode.normal (default) - 25% WebP compression, balanced size/quality
  // - ScreenshotQualityMode.high - 50% WebP compression, better clarity
  // - ScreenshotQualityMode.greyScale - 25% WebP compression, reduced color data
  SessionReplay.setScreenshotQualityMode(ScreenshotQualityMode.normal);

• Video-like Session Replay (Experimental): Capture screenshots based on user interactions or at fixed intervals for a video-like playback experience.

  Warning: Video-like Session Replay may capture sensitive UI unmasked in some cases. USE AT YOUR OWN DISCRETION TO PREVENT PII LEAKAGE. Opt in ONLY after validating masking/privacy in your app.

  // Set capturing mode
  // - ScreenshotCapturingMode.navigation (default) - Captures on screen changes
  // - ScreenshotCapturingMode.interaction - Captures on user interactions
  // - ScreenshotCapturingMode.frequency - Captures at fixed intervals
  SessionReplay.setScreenshotCapturingMode(ScreenshotCapturingMode.frequency);
  // Set screenshot capture interval (only applies to ScreenshotCapturingMode.frequency)
  // Value in milliseconds. Minimum: 500ms, Default: 1000ms
  SessionReplay.setScreenshotCaptureInterval(500);

  Note: On Android low-performance devices, only ScreenshotCapturingMode.navigation mode is available.

• Custom Spans: New feature to manually instrument code paths for performance tracking
  • APM.startCustomSpan(name) - Start a custom span and return a span object
  • CustomSpan.end() - End the span and report to SDK
  • APM.addCompletedCustomSpan(name, startDate, endDate) - Record a pre-completed span
  • Support for up to 100 concurrent spans
  • Comprehensive validation (name length, empty checks, timestamp validation)
  • Feature flag support to enable/disable custom spans

Changed

• Bump Luciq iOS SDK to v19.5.1 (#48). See release notes.
• Bump Luciq Android SDK to v19.4.0 (#48). See release notes.

Added

• Session Replay Screenshot Quality Control: New API to adjust the visual quality of captured screenshots.

  // Available quality options:
  // - ScreenshotQualityMode.normal (default) - 25% WebP compression, balanced size/quality
  // - ScreenshotQualityMode.high - 50% WebP compression, better clarity
  // - ScreenshotQualityMode.greyScale - 25% WebP compression, reduced color data
  SessionReplay.setScreenshotQualityMode(ScreenshotQualityMode.normal);
  

• Video-like Session Replay (Experimental): Capture screenshots based on user interactions or at fixed intervals for a video-like playback experience.

  Warning: Video-like Session Replay may capture sensitive UI unmasked in some cases. USE AT YOUR OWN DISCRETION TO PREVENT PII LEAKAGE. Opt in ONLY after validating masking/privacy in your app.

  // Set capturing mode
  // - ScreenshotCapturingMode.navigation (default) - Captures on screen changes
  // - ScreenshotCapturingMode.interaction - Captures on user interactions
  // - ScreenshotCapturingMode.frequency - Captures at fixed intervals
  SessionReplay.setScreenshotCapturingMode(ScreenshotCapturingMode.frequency);
  
  // Set screenshot capture interval (only applies to ScreenshotCapturingMode.frequency)
  // Value in milliseconds. Minimum: 500ms, Default: 1000ms
  SessionReplay.setScreenshotCaptureInterval(500);
  

  Note: On Android low-performance devices, only ScreenshotCapturingMode.navigation mode is available.

• Custom Spans: New feature to manually instrument code paths for performance tracking

  • APM.startCustomSpan(name) - Start a custom span and return a span object
  • CustomSpan.end() - End the span and report to SDK
  • APM.addCompletedCustomSpan(name, startDate, endDate) - Record a pre-completed span
  • Support for up to 100 concurrent spans
  • Comprehensive validation (name length, empty checks, timestamp validation)
  • Feature flag support to enable/disable custom spans

Changed

• Bump Luciq iOS SDK to v19.5.1 (#48). See release notes.

• Bump Luciq Android SDK to v19.4.0 (#48). See release notes.

Changed

• Bump Luciq iOS SDK to v19.5.0 (#42). See release notes.
• Bump Luciq Android SDK to v19.3.0 (#42). See release notes.

Changed

• Bump Luciq iOS SDK to v19.5.0 (#42). See release notes.

• Bump Luciq Android SDK to v19.3.0 (#42). See release notes.

Added

• Allow identification with nullable email. (#40).

Changed

• Bump Luciq iOS SDK to v19.4.1 (#41). See release notes.
• Bump Luciq Android SDK to v19.2.2 (#41). See release notes.

Added

• Allow identification with nullable email. (#40).

Changed

• Bump Luciq iOS SDK to v19.4.1 (#41). See release notes.

• Bump Luciq Android SDK to v19.2.2 (#41). See release notes.

Added

• Add new UserConsentActionType - noAutomaticBugGrouping.

Changed

• Bump Luciq iOS SDK to v19.4.0 (#36). See release notes.
• Bump Luciq Android SDK to v19.2.1 (#36). See release notes.

Added

• Add new UserConsentActionType - noAutomaticBugGrouping.

Changed

• Bump Luciq iOS SDK to v19.4.0 (#36). See release notes.

• Bump Luciq Android SDK to v19.2.1 (#36). See release notes.

Changed

• Bump Luciq iOS SDK to v19.3.0 (#33). See release notes.
• Bump Luciq Android SDK to v19.1.0 (#33). See release notes.

Changed

• Bump Luciq iOS SDK to v19.3.0 (#33). See release notes.

• Bump Luciq Android SDK to v19.1.0 (#33). See release notes.

Added

• Add support for Screen Rendering (#22)

Changed

• Bump Luciq iOS SDK to v19.2.0 (#22). See release notes.
• Bump Luciq Android SDK to v19.0.0 (#22). See release notes.

Added

• Add support for Screen Rendering (#22)

Changed

• Bump Luciq iOS SDK to v19.2.0 (#22). See release notes.

• Bump Luciq Android SDK to v19.0.0 (#22). See release notes.

Fixed

• Guard LuciqNavigatorObserver pending-step removal to eliminate the race that could crash apps or produce incorrect screenshots during rapid route transitions. (#23)

Added

• Make LuciqNavigatorObserver screen report delay configurable. (#17)

Changed

• Bump Luciq iOS SDK to v19.1.0 (#10). See release notes.

• Bump Luciq Android SDK to v18.2.0 (#10). See release notes.

Added

• Add support for proactive bug-reporting (#4).

• Add support enable/disable the automatic masking of sensitive information in network logs. (#6).

• Add support NDK Crash. (#2).

Changed

• Bump Luciq iOS SDK to v18.0.1 (#10). See release notes.

• Bump Luciq Android SDK to v18.0.1 (#10). See release notes.

• SDK rebranded from Luciq to Luciq.