react-native-clarity 4.3.2 → 4.4.0

package/android/build.gradle

@@ -72,7 +72,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation "com.microsoft.clarity:clarity:3.4.5"
+  implementation "com.microsoft.clarity:clarity:3.6.1"
 }
 
 if (isNewArchitectureEnabled()) {

package/android/src/main/java/com/microsoft/clarity/reactnative/ClarityModule.kt

@@ -81,6 +81,13 @@ class ClarityModule(reactContext: ReactApplicationContext) :
         promise.resolve(Clarity.setCustomTag(key, value))
     }
 
+    @ReactMethod
+    fun setCustomTags(key: String?, values: ReadableArray?, promise: Promise) {
+        val tagValues = values?.let { readableArrayToList(it) } ?: emptyList()
+
+        promise.resolve(Clarity.setCustomTag(key, *tagValues.toTypedArray()))
+    }
+
     @ReactMethod
     fun sendCustomEvent(value: String, promise: Promise) {
         promise.resolve(Clarity.sendCustomEvent(value))
@@ -100,7 +107,9 @@ class ClarityModule(reactContext: ReactApplicationContext) :
         val ret = mutableListOf<String>()
 
         for (i in 0 until arr.size()) {
-            ret.add(arr.getString(i) ?: "")
+            if (!arr.isNull(i)) {
+                arr.getString(i)?.let { ret.add(it) }
+            }
         }
 
         return ret

package/ios/Clarity.m

@@ -95,6 +95,18 @@ RCT_EXPORT_METHOD(setCustomTag:(NSString *)key value:(NSString *)value
                                         value:[self sanitizeBridgedValue:value]]));
 }
 
+RCT_EXPORT_METHOD(setCustomTags:(NSString *)key
+                  values:(NSArray<NSString *> *)values
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+    NSArray<NSString *> *sanitizedValues = [self sanitizeBridgedStringArray:values];
+    NSSet<NSString *> *valueSet = sanitizedValues.count > 0 ? [NSSet setWithArray:sanitizedValues] : nil;
+
+    resolve(@([ClaritySDK setCustomTagWithKey:[self sanitizeBridgedValue:key]
+                                       values:valueSet]));
+}
+
 RCT_EXPORT_METHOD(sendCustomEvent:(NSString *)value
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
@@ -155,4 +167,26 @@ RCT_EXPORT_METHOD(setCurrentScreenName:(NSString *)currentScreenName
     return value;
 }
 
+- (NSArray<NSString *> *)sanitizeBridgedStringArray:(id)values {
+    if (![values isKindOfClass:[NSArray class]]) {
+        return @[];
+    }
+
+    NSMutableArray<NSString *> *sanitized = [NSMutableArray array];
+
+    for (id value in (NSArray *)values) {
+        id sanitizedValue = [self sanitizeBridgedValue:value];
+
+        if (sanitizedValue == nil) {
+            continue;
+        }
+
+        if ([sanitizedValue isKindOfClass:[NSString class]]) {
+            [sanitized addObject:sanitizedValue];
+        }
+    }
+
+    return sanitized;
+}
+
 @end

package/lib/commonjs/index.js

@@ -14,6 +14,7 @@ exports.sendCustomEvent = sendCustomEvent;
 exports.setCurrentScreenName = setCurrentScreenName;
 exports.setCustomSessionId = setCustomSessionId;
 exports.setCustomTag = setCustomTag;
+exports.setCustomTags = setCustomTags;
 exports.setCustomUserId = setCustomUserId;
 exports.setOnSessionStartedCallback = setOnSessionStartedCallback;
 exports.startNewSession = startNewSession;
@@ -231,6 +232,23 @@ function setCustomTag(key, value) {
   return Clarity.setCustomTag(key, value);
 }
 
+/**
+ * Sets custom tags for the current session. These tags can be used to filter sessions on the Clarity dashboard.
+ *
+ * @param key - The key for the custom tag. The value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @param values - The values for the custom tag. Each value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @returns {Promise<boolean>} A Promise that resolves with `true` if the custom tag was set successfully; otherwise `false`.
+ *
+ *  **Notes:**
+ *  - To ensure that the custom tag is associated with the correct session, it's recommended to call this function within the callbacks of {@linkcode setOnSessionStartedCallback} or {@linkcode startNewSession}.
+ */
+function setCustomTags(key, values) {
+  if (isClarityUnavailable()) {
+    return Promise.resolve(false);
+  }
+  return Clarity.setCustomTags(key, values);
+}
+
 /**
  * Sends a custom event to the current Clarity session. These custom events can be used to track specific user interactions or actions that Clarity's built-in event tracking doesn't capture.
  *

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","ReferToDocs","Clarity","NativeModules","ClarityEmitter","NativeEventEmitter","SupportedPlatforms","SupportWarningWasShown","ValidConfigKeys","Set","Object","keys","userId","undefined","logLevel","RemovedDynamicConfigKeys","LogLevel","exports","ClarityError","Error","constructor","message","name","isClarityUnavailable","includes","OS","console","warn","join","error","validateClarityConfig","config","values","key","has","errorMessage","enableIOS_experimental","initialize","projectId","None","pause","Promise","resolve","resume","isPaused","startNewSession","callback","setCustomUserId","customUserId","setCustomSessionId","customSessionId","setCustomTag","value","sendCustomEvent","onSessionStartedSubscription","onSessionStartedCallback","setOnSessionStartedCallback","addListener","sessionId","setCurrentScreenName","screenName","getCurrentSessionId","getCurrentSessionUrl"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","ReferToDocs","Clarity","NativeModules","ClarityEmitter","NativeEventEmitter","SupportedPlatforms","SupportWarningWasShown","ValidConfigKeys","Set","Object","keys","userId","undefined","logLevel","RemovedDynamicConfigKeys","LogLevel","exports","ClarityError","Error","constructor","message","name","isClarityUnavailable","includes","OS","console","warn","join","error","validateClarityConfig","config","values","key","has","errorMessage","enableIOS_experimental","initialize","projectId","None","pause","Promise","resolve","resume","isPaused","startNewSession","callback","setCustomUserId","customUserId","setCustomSessionId","customSessionId","setCustomTag","value","setCustomTags","sendCustomEvent","onSessionStartedSubscription","onSessionStartedCallback","setOnSessionStartedCallback","addListener","sessionId","setCurrentScreenName","screenName","getCurrentSessionId","getCurrentSessionUrl"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -212,6 +212,23 @@ export function setCustomTag(key, value) {
   return Clarity.setCustomTag(key, value);
 }
 
+/**
+ * Sets custom tags for the current session. These tags can be used to filter sessions on the Clarity dashboard.
+ *
+ * @param key - The key for the custom tag. The value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @param values - The values for the custom tag. Each value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @returns {Promise<boolean>} A Promise that resolves with `true` if the custom tag was set successfully; otherwise `false`.
+ *
+ *  **Notes:**
+ *  - To ensure that the custom tag is associated with the correct session, it's recommended to call this function within the callbacks of {@linkcode setOnSessionStartedCallback} or {@linkcode startNewSession}.
+ */
+export function setCustomTags(key, values) {
+  if (isClarityUnavailable()) {
+    return Promise.resolve(false);
+  }
+  return Clarity.setCustomTags(key, values);
+}
+
 /**
  * Sends a custom event to the current Clarity session. These custom events can be used to track specific user interactions or actions that Clarity's built-in event tracking doesn't capture.
  *

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","LINKING_ERROR","select","ios","default","ReferToDocs","Clarity","ClarityEmitter","SupportedPlatforms","SupportWarningWasShown","ValidConfigKeys","Set","Object","keys","userId","undefined","logLevel","RemovedDynamicConfigKeys","LogLevel","ClarityError","Error","constructor","message","name","isClarityUnavailable","includes","OS","console","warn","join","error","validateClarityConfig","config","values","key","has","errorMessage","enableIOS_experimental","initialize","projectId","None","pause","Promise","resolve","resume","isPaused","startNewSession","callback","setCustomUserId","customUserId","setCustomSessionId","customSessionId","setCustomTag","value","sendCustomEvent","onSessionStartedSubscription","onSessionStartedCallback","setOnSessionStartedCallback","addListener","sessionId","setCurrentScreenName","screenName","getCurrentSessionId","getCurrentSessionUrl"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","LINKING_ERROR","select","ios","default","ReferToDocs","Clarity","ClarityEmitter","SupportedPlatforms","SupportWarningWasShown","ValidConfigKeys","Set","Object","keys","userId","undefined","logLevel","RemovedDynamicConfigKeys","LogLevel","ClarityError","Error","constructor","message","name","isClarityUnavailable","includes","OS","console","warn","join","error","validateClarityConfig","config","values","key","has","errorMessage","enableIOS_experimental","initialize","projectId","None","pause","Promise","resolve","resume","isPaused","startNewSession","callback","setCustomUserId","customUserId","setCustomSessionId","customSessionId","setCustomTag","value","setCustomTags","sendCustomEvent","onSessionStartedSubscription","onSessionStartedCallback","setOnSessionStartedCallback","addListener","sessionId","setCurrentScreenName","screenName","getCurrentSessionId","getCurrentSessionUrl"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -104,6 +104,17 @@ export declare function setCustomSessionId(customSessionId: string): Promise<boo
  *  - To ensure that the custom tag is associated with the correct session, it's recommended to call this function within the callbacks of {@linkcode setOnSessionStartedCallback} or {@linkcode startNewSession}.
  */
 export declare function setCustomTag(key: string, value: string): Promise<boolean>;
+/**
+ * Sets custom tags for the current session. These tags can be used to filter sessions on the Clarity dashboard.
+ *
+ * @param key - The key for the custom tag. The value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @param values - The values for the custom tag. Each value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @returns {Promise<boolean>} A Promise that resolves with `true` if the custom tag was set successfully; otherwise `false`.
+ *
+ *  **Notes:**
+ *  - To ensure that the custom tag is associated with the correct session, it's recommended to call this function within the callbacks of {@linkcode setOnSessionStartedCallback} or {@linkcode startNewSession}.
+ */
+export declare function setCustomTags(key: string, values: string[]): Promise<boolean>;
 /**
  * Sends a custom event to the current Clarity session. These custom events can be used to track specific user interactions or actions that Clarity's built-in event tracking doesn't capture.
  *

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AA0BA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAiBD;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AA2ED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,QAiBnE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAMzC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAM3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAM3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/D;AAKD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAmBT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AA0BA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAiBD;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AA2ED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,QAiBnE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAMzC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAM3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAM3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAM7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM/D;AAKD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAmBT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMlE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-clarity",
-  "version": "4.3.2",
+  "version": "4.4.0",
   "description": "A plugin to provide the Clarity experience for the React Native applications.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/react-native-clarity.podspec

@@ -1,7 +1,6 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
 
 Pod::Spec.new do |s|
   s.name         = "react-native-clarity"
@@ -17,20 +16,10 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm}"
 
   s.dependency "React-Core"
-  s.dependency "Clarity", '3.0.15'
+  s.dependency "Clarity", '3.3.2'
 
   # Don't install the dependencies when we run `pod install` in the old architecture.
   if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
-    s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
-    s.pod_target_xcconfig    = {
-        "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
-        "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
-        "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
-    }
-    s.dependency "React-Codegen"
-    s.dependency "RCT-Folly"
-    s.dependency "RCTRequired"
-    s.dependency "RCTTypeSafety"
-    s.dependency "ReactCommon/turbomodule/core"
+    s.compiler_flags = " -DRCT_NEW_ARCH_ENABLED=1"
   end
 end

package/src/index.tsx

@@ -288,6 +288,24 @@ export function setCustomTag(key: string, value: string): Promise<boolean> {
   return Clarity.setCustomTag(key, value);
 }
 
+/**
+ * Sets custom tags for the current session. These tags can be used to filter sessions on the Clarity dashboard.
+ *
+ * @param key - The key for the custom tag. The value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @param values - The values for the custom tag. Each value must be a nonempty string, with a maximum length of 255 characters, and can't consist only of whitespace.
+ * @returns {Promise<boolean>} A Promise that resolves with `true` if the custom tag was set successfully; otherwise `false`.
+ *
+ *  **Notes:**
+ *  - To ensure that the custom tag is associated with the correct session, it's recommended to call this function within the callbacks of {@linkcode setOnSessionStartedCallback} or {@linkcode startNewSession}.
+ */
+export function setCustomTags(key: string, values: string[]): Promise<boolean> {
+  if (isClarityUnavailable()) {
+    return Promise.resolve(false);
+  }
+
+  return Clarity.setCustomTags(key, values);
+}
+
 /**
  * Sends a custom event to the current Clarity session. These custom events can be used to track specific user interactions or actions that Clarity's built-in event tracking doesn't capture.
  *