feat: add telemetry settings

Author: Minishlink

android/app/src/main/java/com/appzung/codepush/react/CodePushConstants.java

@@ -32,4 +32,5 @@ public class CodePushConstants {
     public static final String LATEST_ROLLBACK_TIME_KEY = "time";
     public static final String LATEST_ROLLBACK_COUNT_KEY = "count";
     public static final String CLIENT_UNIQUE_ID_KEY = "clientUniqueId";
+    public static final String TELEMETRY_ENABLED_KEY = "telemetryEnabled";
 }

android/app/src/main/java/com/appzung/codepush/react/CodePushNativeModule.java

@@ -42,6 +42,7 @@
 public class CodePushNativeModule extends ReactContextBaseJavaModule {
     private String mBinaryContentsHash = null;
     private String mClientUniqueId = null;
+    private boolean mTelemetryEnabled = true;
     private LifecycleEventListener mLifecycleEventListener = null;
     private int mMinimumBackgroundDuration = 0;
 
@@ -71,6 +72,17 @@ public CodePushNativeModule(ReactApplicationContext reactContext, CodePush codeP
             mClientUniqueId = UUID.randomUUID().toString();
             preferences.edit().putString(CodePushConstants.CLIENT_UNIQUE_ID_KEY, mClientUniqueId).apply();
         }
+
+        if (preferences.contains(CodePushConstants.TELEMETRY_ENABLED_KEY)) {
+            mTelemetryEnabled = preferences.getBoolean(CodePushConstants.TELEMETRY_ENABLED_KEY, true);
+        } else {
+            int defaultTelemetryEnabledResId = reactContext.getResources().getIdentifier("CodePushDefaultTelemetryEnabled", "bool", reactContext.getPackageName());
+            if (defaultTelemetryEnabledResId != 0) {
+                mTelemetryEnabled = reactContext.getResources().getBoolean(defaultTelemetryEnabledResId);
+            } else {
+                mTelemetryEnabled = true;
+            }
+        }
     }
 
     @Override
@@ -396,6 +408,7 @@ public void getConfiguration(Promise promise) {
             configMap.putString("clientUniqueId", mClientUniqueId);
             configMap.putString("releaseChannelPublicId", mCodePush.getReleaseChannelPublicId());
             configMap.putString("serverUrl", mCodePush.getServerUrl());
+            configMap.putBoolean("telemetryEnabled", mTelemetryEnabled);
 
             // The binary hash may be null in debug builds
             if (mBinaryContentsHash != null) {
@@ -745,6 +758,24 @@ public void resetClientUniqueId(Promise promise) {
         }
     }
 
+    @ReactMethod
+    public void setTelemetryEnabled(boolean enabled, Promise promise) {
+        try {
+            SharedPreferences preferences = mCodePush.getContext().getSharedPreferences(CodePushConstants.CODE_PUSH_PREFERENCES, 0);
+            preferences.edit().putBoolean(CodePushConstants.TELEMETRY_ENABLED_KEY, enabled).apply();
+            mTelemetryEnabled = enabled;
+            promise.resolve(null);
+        } catch (Exception e) {
+            CodePushUtils.log(e);
+            promise.reject(e);
+        }
+    }
+
+    @ReactMethod
+    public void getTelemetryEnabled(Promise promise) {
+        promise.resolve(mTelemetryEnabled);
+    }
+
     @ReactMethod
     public void addListener(String eventName) {
         // Set up any upstream listeners or background tasks as necessary

docs/advanced-usage.md

@@ -1,5 +1,60 @@
 ## Advanced usage
 
+### Privacy / GDPR
+
+#### Telemetry
+
+CodePush collects anonymous usage data by default to help improve the service (e.g. to provide you with analytics).
+To be fully compliant with GDPR and other privacy regulations, you may want to disable this telemetry collection.
+
+##### Disabling telemetry by default
+
+You can disable telemetry collection by default by configuring your native app:
+
+**Android:**
+
+Add this to your `android/app/build.gradle` file:
+
+```groovy
+android {
+    // ...
+    defaultConfig {
+        // ...
+        resValue "bool", "CodePushDefaultTelemetryEnabled", "false"
+    }
+}
+```
+
+**iOS:**
+
+Add this to your `ios/YourApp/Info.plist` file:
+
+```
+<key>CodePushDefaultTelemetryEnabled</key>
+<false/>
+```
+
+##### Managing telemetry during runtime
+
+You can also programmatically check or change telemetry status during app runtime:
+
+```typescript
+import * as CodePush from '@appzung/react-native-code-push';
+
+// Check if telemetry is enabled
+CodePush.getTelemetryEnabled().then((enabled) => {
+  console.log('Telemetry is ' + (enabled ? 'enabled' : 'disabled'));
+});
+
+// Enable telemetry
+CodePush.setTelemetryEnabled(true);
+
+// Disable telemetry
+CodePush.setTelemetryEnabled(false);
+```
+
+This setting will persist across app sessions.
+
 ### Multiple environments
 
 #### Staging / Production
@@ -43,7 +98,7 @@ In order to achieve this kind of workflow, all you need to do is specify the rel
 ```javascript
 // Imagine that "userProfile" is a prop that this component received
 // which includes the release channel public ID that the current user should use.
-codePush.sync({ releaseChannelPublicId: userProfile.RELEASE_CHANNEL_PUBLIC_ID });
+CodePush.sync({ releaseChannelPublicId: userProfile.RELEASE_CHANNEL_PUBLIC_ID });
 ```
 
 With that change in place, now it's just a matter of choosing how your app determines the right release channel for the current user. In practice, there are typically two solutions for this:

docs/api-js/README.md

@@ -43,11 +43,13 @@
 - [disallowRestart](functions/disallowRestart.md)
 - [getClientUniqueId](functions/getClientUniqueId.md)
 - [getLogLevel](functions/getLogLevel.md)
+- [getTelemetryEnabled](functions/getTelemetryEnabled.md)
 - [getUpdateMetadata](functions/getUpdateMetadata.md)
 - [notifyAppReady](functions/notifyAppReady.md)
 - [resetClientUniqueId](functions/resetClientUniqueId.md)
 - [restartApp](functions/restartApp.md)
 - [setLogLevel](functions/setLogLevel.md)
+- [setTelemetryEnabled](functions/setTelemetryEnabled.md)
 - [sync](functions/sync.md)
 - [withCodePush](functions/withCodePush.md)
 

docs/api-js/functions/getTelemetryEnabled.md

@@ -0,0 +1,17 @@
+[**@appzung/react-native-code-push v11.0.0-rc5**](../README.md)
+
+---
+
+[@appzung/react-native-code-push](../README.md) / getTelemetryEnabled
+
+# Function: getTelemetryEnabled()
+
+> **getTelemetryEnabled**(): `Promise`\<`boolean`\>
+
+Gets the current telemetry enabled status.
+
+When setTelemetryEnabled has never been enabled, returns the default value set in your configuration.
+
+## Returns
+
+`Promise`\<`boolean`\>

docs/api-js/functions/setTelemetryEnabled.md

@@ -0,0 +1,23 @@
+[**@appzung/react-native-code-push v11.0.0-rc5**](../README.md)
+
+---
+
+[@appzung/react-native-code-push](../README.md) / setTelemetryEnabled
+
+# Function: setTelemetryEnabled()
+
+> **setTelemetryEnabled**(`enabled`): `Promise`\<`void`\>
+
+Controls telemetry reporting.
+
+## Parameters
+
+### enabled
+
+`boolean`
+
+When false, updates on this device will stop appearing as failed, pending or succeeded in analytics.
+
+## Returns
+
+`Promise`\<`void`\>

ios/CodePush/CodePush.h

@@ -104,6 +104,7 @@
 @property (readonly) NSString *clientUniqueId;
 @property (copy) NSString *serverURL;
 @property (copy) NSString *publicKey;
+@property (nonatomic) BOOL telemetryEnabled;
 
 + (instancetype)current;
 

ios/CodePush/CodePush.m

@@ -1049,6 +1049,20 @@ - (void)restartAppInternal:(BOOL)onlyIfUpdateIsPending
     resolve([[CodePushConfig current] clientUniqueId]);
 }
 
+RCT_EXPORT_METHOD(setTelemetryEnabled:(BOOL)enabled
+                            resolver:(RCTPromiseResolveBlock)resolve
+                            rejecter:(RCTPromiseRejectBlock)reject)
+{
+    [[CodePushConfig current] setTelemetryEnabled:enabled];
+    resolve(nil);
+}
+
+RCT_EXPORT_METHOD(getTelemetryEnabled:(RCTPromiseResolveBlock)resolve
+                           rejecter:(RCTPromiseRejectBlock)reject)
+{
+    resolve(@([[CodePushConfig current] telemetryEnabled]));
+}
+
 #pragma mark - JavaScript-exported module methods (Private)
 
 /*

ios/CodePush/CodePushConfig.m

@@ -13,6 +13,7 @@ @implementation CodePushConfig {
 static NSString * const ReleaseChannelPublicIDConfigKey = @"releaseChannelPublicId";
 static NSString * const ServerURLConfigKey = @"serverUrl";
 static NSString * const PublicKeyKey = @"publicKey";
+static NSString * const TelemetryEnabledKey = @"telemetryEnabled";
 
 + (instancetype)current
 {
@@ -49,6 +50,16 @@ - (instancetype)init
         [userDefaults synchronize];
     }
 
+    NSNumber *defaultTelemetryEnabled = [infoDictionary objectForKey:@"CodePushDefaultTelemetryEnabled"];
+    BOOL telemetryEnabled;
+    if ([userDefaults objectForKey:TelemetryEnabledKey] != nil) {
+        telemetryEnabled = [userDefaults boolForKey:TelemetryEnabledKey];
+    } else if (defaultTelemetryEnabled != nil) {
+        telemetryEnabled = [defaultTelemetryEnabled boolValue];
+    } else {
+        telemetryEnabled = YES;
+    }
+
     if (!serverURL) {
         serverURL = @"https://codepush.appzung.com/";
     }
@@ -64,6 +75,7 @@ - (instancetype)init
         CPLog(@"Executing CodePush with a signing public key.");
         [_configDictionary setObject:publicKey forKey:PublicKeyKey];
     }
+    [_configDictionary setObject:@(telemetryEnabled) forKey:TelemetryEnabledKey];
 
     return self;
 }
@@ -103,6 +115,19 @@ - (NSString *)publicKey
     return [_configDictionary objectForKey:PublicKeyKey];
 }
 
+- (BOOL)telemetryEnabled
+{
+    return [[_configDictionary objectForKey:TelemetryEnabledKey] boolValue];
+}
+
+- (void)setTelemetryEnabled:(BOOL)telemetryEnabled
+{
+    [_configDictionary setValue:@(telemetryEnabled) forKey:TelemetryEnabledKey];
+    NSUserDefaults *preferences = [NSUserDefaults standardUserDefaults];
+    [preferences setBool:telemetryEnabled forKey:TelemetryEnabledKey];
+    [preferences synchronize];
+}
+
 - (void)setAppVersion:(NSString *)appVersion
 {
     [_configDictionary setValue:appVersion forKey:AppVersionConfigKey];

src/checkForUpdates.ts

@@ -39,7 +39,7 @@ export async function checkForUpdate(
    * release channels (e.g. an early access release channel for insiders).
    */
   const config: Configuration = releaseChannelPublicId ? { ...nativeConfig, releaseChannelPublicId } : nativeConfig;
-  const sdk = new CodePushApiSdk(requestFetchAdapter, config);
+  const sdk = new CodePushApiSdk(requestFetchAdapter, log, config);
 
   const localPackage = await getCurrentPackage();