@algocare/react-native-code-push 9.0.0-beta.3

package/docs/setup-ios.md

@@ -0,0 +1,280 @@
+## iOS Setup
+
+Once you've acquired the CodePush plugin, you need to integrate it into the Xcode project of your React Native app and configure it correctly. To do this, take the following steps:
+​
+### Plugin Installation and Configuration for React Native 0.60 version and above (iOS)
+
+1. Run `cd ios && pod install && cd ..` to install all the necessary CocoaPods dependencies.
+​
+2. Open up the `AppDelegate.m` file, and add an import statement for the CodePush headers:
+
+   ```objective-c
+   #import <CodePush/CodePush.h>
+   ```
+
+3. Find the following line of code, which sets the source URL for bridge for production releases:
+
+   ```objective-c
+   return [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];
+   ```
+
+4. Replace it with this line:
+   
+   ```objective-c
+   return [CodePush bundleURL];
+   ```
+   This change configures your app to always load the most recent version of your app's JS bundle. On the first launch, this will correspond to the file that was compiled with the app. However, after an update has been pushed via CodePush, this will return the location of the most recently installed update.
+  
+   *NOTE: The `bundleURL` method assumes your app's JS bundle is named `main.jsbundle`. If you have configured your app to use a different file name, simply call the `bundleURLForResource:` method (which assumes you're using the `.jsbundle` extension) or `bundleURLForResource:withExtension:` method instead, in order to overwrite that default behavior*
+
+   Typically, you're only going to want to use CodePush to resolve your JS bundle location within release builds, and therefore, we recommend using the `DEBUG` pre-processor macro to dynamically switch between using the packager server and CodePush, depending on whether you are debugging or not. This will make it much simpler to ensure you get the right behavior you want in production, while still being able to use the Chrome Dev Tools, live reload, etc. at debug-time.
+
+   Your `sourceURLForBridge` method should look like this:
+
+   ```objective-c
+   - (NSURL *)sourceURLForBridge:(RCTBridge *)bridge
+   {
+     #if DEBUG
+       return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index"];
+     #else
+       return [CodePush bundleURL];
+     #endif
+   }
+   ```
+
+5. Add the Deployment key to `Info.plist`:
+
+   To let the CodePush runtime know which deployment it should query for updates against, open your app's `Info.plist` file and add a new entry named `CodePushDeploymentKey`, whose value is the key of the deployment you want to configure this app against (like the key for the `Staging` deployment for the `FooBar` app). You can retrieve this value by running `appcenter codepush deployment list -a <ownerName>/<appName> -k` in the AppCenter CLI (the `-k` flag is necessary since keys aren't displayed by default) and copying the value of the `Key` column which corresponds to the deployment you want to use (see below). Note that using the deployment's name (like Staging) will not work. That "friendly name" is intended only for authenticated management usage from the CLI, and not for public consumption within your app.
+
+   ![Deployment list](https://cloud.githubusercontent.com/assets/116461/11601733/13011d5e-9a8a-11e5-9ce2-b100498ffb34.png)
+
+   In order to effectively make use of the `Staging` and `Production` deployments that were created along with your CodePush app, refer to the [multi-deployment testing](../README.md#multi-deployment-testing) docs below before actually moving your app's usage of CodePush into production.
+
+   *Note: If you need to dynamically use a different deployment, you can also override your deployment key in JS code using [Code-Push options](./api-js.md#CodePushOptions)*
+
+### Plugin Installation for React Native lower than 0.60 (iOS)
+
+In order to accommodate as many developer preferences as possible, the CodePush plugin supports iOS installation via three mechanisms:
+
+1. [**RNPM**](#plugin-installation-ios---rnpm) - [React Native Package Manager (RNPM)](https://github.com/rnpm/rnpm) is an awesome tool that provides the simplest installation experience possible for React Native plugins. If you're already using it, or you want to use it, then we recommend this approach.
+
+2. [**CocoaPods**](#plugin-installation-ios---cocoapods) - If you're building a native iOS app that is embedding React Native into it, or you simply prefer using [CocoaPods](https://cocoapods.org), then we recommend using the Podspec file that we ship as part of our plugin.
+
+3. [**"Manual"**](#plugin-installation-ios---manual) - If you don't want to depend on any additional tools or are fine with a few extra installation steps (it's a one-time thing), then go with this approach.
+
+#### Plugin Installation (iOS - RNPM)
+
+1. As of v0.27 of React Native, `rnpm link` has already been merged into the React Native CLI. Simply run:
+    ```
+    react-native link react-native-code-push
+    ```
+
+    If your app uses a version of React Native that is lower than v0.27, run the following:
+    ```
+    rnpm link react-native-code-push
+    ```
+
+    *Note: If you don't already have RNPM installed, you can do so by simply running `npm i -g rnpm` and then executing the above command. If you already have RNPM installed, make sure you have v1.9.0+ in order to benefit from this one step install.*
+
+2. You will be prompted for the deployment key you'd like to use. If you don't already have it, you can retrieve this value by running `appcenter codepush deployment list -a <ownerName>/<appName> -k`, or you can choose to ignore it (by simply hitting `<ENTER>`) and add it in later. To get started, we would recommend just using your `Staging` deployment key, so that you can test out the CodePush end-to-end.
+
+And that's it! Isn't RNPM awesome? :)
+
+#### Plugin Installation (iOS - CocoaPods)
+
+1. Add the ReactNative and CodePush plugin dependencies to your `Podfile`, pointing at the path where NPM installed it
+
+    ```
+    # React Native requirements
+    pod 'React', :path => '../node_modules/react-native', :subspecs => [
+       'Core',
+       'CxxBridge', # Include this for RN >= 0.47
+       'DevSupport', # Include this to enable In-App Devmenu if RN >= 0.43
+       'RCTText',
+       'RCTNetwork',
+       'RCTWebSocket', # Needed for debugging
+       'RCTAnimation', # Needed for FlatList and animations running on native UI thread
+       # Add any other subspecs you want to use in your project
+    ]
+    # Explicitly include Yoga if you are using RN >= 0.42.0
+    pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'
+    pod 'DoubleConversion', :podspec => '../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec'
+    pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
+    pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'
+      
+    # CodePush plugin dependency
+    pod 'CodePush', :path => '../node_modules/react-native-code-push'
+    ```
+
+    *NOTE: The above path needs to be relative to your app's `Podfile`, so adjust it as necessary.*
+
+    *NOTE: `JWT` library should be >= version 3.0.x*
+
+2. Run `pod install`
+
+*NOTE: The CodePush `.podspec` depends on the `React` pod, and so in order to ensure that it can correctly use the version of React Native that your app is built with, please make sure to define the `React` dependency in your app's `Podfile` as explained [here](https://facebook.github.io/react-native/docs/integration-with-existing-apps.html#podfile).*
+
+#### Plugin Installation (iOS - Manual)
+
+1. Open your app's Xcode project
+
+2. Find the `CodePush.xcodeproj` file within the `node_modules/react-native-code-push/ios` directory (or `node_modules/react-native-code-push` for <=`1.7.3-beta` installations) and drag it into the `Libraries` node in Xcode
+
+    ![Add CodePush to project](https://cloud.githubusercontent.com/assets/8598682/13368613/c5c21422-dca0-11e5-8594-c0ec5bde9d81.png)
+
+3. Select the project node in Xcode and select the "Build Phases" tab of your project configuration.
+
+4. Drag `libCodePush.a` from `Libraries/CodePush.xcodeproj/Products` into the "Link Binary With Libraries" section of your project's "Build Phases" configuration.
+
+    ![Link CodePush during build](https://cloud.githubusercontent.com/assets/516559/10322221/a75ea066-6c31-11e5-9d88-ff6f6a4d6968.png)
+
+5. Click the plus sign underneath the "Link Binary With Libraries" list and select the `libz.tbd` library underneath the `iOS 9.1` node.
+
+    ![Libz reference](https://cloud.githubusercontent.com/assets/116461/11605042/6f786e64-9aaa-11e5-8ca7-14b852f808b1.png)
+
+    *Note: Alternatively, if you prefer, you can add the `-lz` flag to the `Other Linker Flags` field in the `Linking` section of the `Build Settings`.*
+
+
+### Plugin Configuration for React Native lower than 0.60 (iOS)
+
+*NOTE: If you used RNPM or `react-native link` to automatically link the plugin, these steps have already been done for you so you may skip this section.*
+
+Once your Xcode project has been setup to build/link the CodePush plugin, you need to configure your app to consult CodePush for the location of your JS bundle, since it is responsible for synchronizing it with updates that are released to the CodePush server. To do this, perform the following steps:
+
+1. Open up the `AppDelegate.m` file, and add an import statement for the CodePush headers:
+
+    ```objective-c
+    #import <CodePush/CodePush.h>
+    ```
+
+For React Native 0.59 - 0.59.10:
+
+2. Find the following line of code, which sets the source URL for bridge for production releases:
+
+    ```objective-c
+    return [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];
+    ```
+
+3. Replace it with this line:
+
+    ```objective-c
+    return [CodePush bundleURL];
+    ```
+
+For React Native 0.58 and below:
+
+2. Find the following line of code, which loads your JS Bundle from the app binary for production releases:
+
+    ```objective-c
+    jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
+    ```
+
+3. Replace it with this line:
+
+    ```objective-c
+    jsCodeLocation = [CodePush bundleURL];
+    ```
+
+This change configures your app to always load the most recent version of your app's JS bundle. On the first launch, this will correspond to the file that was compiled with the app. However, after an update has been pushed via CodePush, this will return the location of the most recently installed update.
+
+*NOTE: The `bundleURL` method assumes your app's JS bundle is named `main.jsbundle`. If you have configured your app to use a different file name, simply call the `bundleURLForResource:` method (which assumes you're using the `.jsbundle` extension) or `bundleURLForResource:withExtension:` method instead, in order to overwrite that default behavior*
+
+Typically, you're only going to want to use CodePush to resolve your JS bundle location within release builds, and therefore, we recommend using the `DEBUG` pre-processor macro to dynamically switch between using the packager server and CodePush, depending on whether you are debugging or not. This will make it much simpler to ensure you get the right behavior you want in production, while still being able to use the Chrome Dev Tools, live reload, etc. at debug-time.
+
+For React Native 0.59 - 0.59.10:
+
+```objective-c
+- (NSURL *)sourceURLForBridge:(RCTBridge *)bridge
+{
+  #if DEBUG
+    return [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
+  #else
+    return [CodePush bundleURL];
+  #endif
+}
+```
+
+For React Native 0.49 - 0.58:
+
+```objective-c
+NSURL *jsCodeLocation;
+
+#ifdef DEBUG
+    jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];
+#else
+    jsCodeLocation = [CodePush bundleURL];
+#endif
+```
+
+For React Native 0.48 and below:
+
+```objective-c
+NSURL *jsCodeLocation;
+
+#ifdef DEBUG
+    jsCodeLocation = [NSURL URLWithString:@"http://localhost:8081/index.ios.bundle?platform=ios&dev=true"];
+#else
+    jsCodeLocation = [CodePush bundleURL];
+#endif
+```
+
+To let the CodePush runtime know which deployment it should query for updates against, open your app's `Info.plist` file and add a new entry named `CodePushDeploymentKey`, whose value is the key of the deployment you want to configure this app against (like the key for the `Staging` deployment for the `FooBar` app). You can retrieve this value by running `appcenter codepush deployment list -a <ownerName>/<appName> -k` in the AppCenter CLI (the `-k` flag is necessary since keys aren't displayed by default) and copying the value of the `Key` column which corresponds to the deployment you want to use (see below). Note that using the deployment's name (like Staging) will not work. That "friendly name" is intended only for authenticated management usage from the CLI, and not for public consumption within your app.
+
+![Deployment list](https://cloud.githubusercontent.com/assets/116461/11601733/13011d5e-9a8a-11e5-9ce2-b100498ffb34.png)
+
+In order to effectively make use of the `Staging` and `Production` deployments that were created along with your CodePush app, refer to the [multi-deployment testing](../README.md#multi-deployment-testing) docs below before actually moving your app's usage of CodePush into production.
+
+### HTTP exception domains configuration (iOS)
+
+CodePush plugin makes HTTPS requests to the following domains:
+
+- codepush.appcenter.ms
+- codepush.blob.core.windows.net
+- codepushupdates.azureedge.net
+
+If you want to change the default HTTP security configuration for any of these domains, you have to define the [`NSAppTransportSecurity` (ATS)][ats] configuration inside your __Info.plist__ file:
+
+```xml
+<plist version="1.0">
+  <dict>
+    <!-- ...other configs... -->
+
+    <key>NSAppTransportSecurity</key>
+    <dict>
+      <key>NSExceptionDomains</key>
+      <dict>
+        <key>codepush.appcenter.ms</key>
+        <dict><!-- read the ATS Apple Docs for available options --></dict>
+      </dict>
+    </dict>
+
+    <!-- ...other configs... -->
+  </dict>
+</plist>
+```
+
+Before doing anything, please [read the docs][ats] first.
+
+[ats]: https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW33
+
+### Code Signing setup
+
+Starting with CLI version **2.1.0** you can self sign bundles during release and verify its signature before installation of update. For more info about Code Signing please refer to [relevant code-push documentation section](https://github.com/microsoft/code-push/tree/v3.0.1/cli#code-signing).
+
+In order to configure Public Key for bundle verification you need to add record in `Info.plist` with name `CodePushPublicKey` and string value of public key content. Example:
+
+```xml
+<plist version="1.0">
+  <dict>
+    <!-- ...other configs... -->
+
+    <key>CodePushPublicKey</key>
+        <string>-----BEGIN PUBLIC KEY-----
+MFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBANkWYydPuyOumR/sn2agNBVDnzyRpM16NAUpYPGxNgjSEp0etkDNgzzdzyvyl+OsAGBYF3jCxYOXozum+uV5hQECAwEAAQ==
+-----END PUBLIC KEY-----</string>
+
+    <!-- ...other configs... -->
+  </dict>
+</plist>
+```
+

package/eslint.config.mjs

@@ -0,0 +1,32 @@
+import globals from "globals";
+import pluginJs from "@eslint/js";
+import tseslint from "typescript-eslint";
+import pluginReact from "eslint-plugin-react";
+
+
+export default [
+  {files: ["**/*.{js,mjs,cjs,ts,jsx,tsx}"]},
+  {languageOptions: { globals: {
+    ...globals.node,
+    ...globals.mocha,
+    ...globals.browser,
+    ...globals.jest
+  } }},
+  pluginJs.configs.recommended,
+  ...tseslint.configs.recommended,
+  pluginReact.configs.flat.recommended,
+  {"rules": {
+    "@typescript-eslint/no-require-imports": "warn",
+    "@typescript-eslint/no-unused-vars": "warn",
+    "@typescript-eslint/no-unused-expressions": "warn",
+    "no-empty": "warn",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "no-var": "warn",
+    "@typescript-eslint/no-this-alias": "warn",
+    "@typescript-eslint/no-empty-object-type": "warn",
+    "react/no-deprecated": "warn",
+    "no-extra-boolean-cast": "warn",
+    "no-useless-escape": "warn",
+    "no-control-regex": "warn",
+  }}
+];

package/ios/CodePush/Base64/Base64/MF_Base64Additions.h

@@ -0,0 +1,34 @@
+//
+//  MF_Base64Additions.h
+//  Base64 -- RFC 4648 compatible implementation
+//  see http://www.ietf.org/rfc/rfc4648.txt for more details
+//
+//  Designed to be compiled with Automatic Reference Counting
+//
+//  Created by Dave Poirier on 2012-06-14.
+//  Public Domain
+//  Hosted at https://github.com/ekscrypto/Base64
+//
+
+#import <Foundation/Foundation.h>
+
+@interface NSString (Base64Addition)
++(NSString *)stringFromBase64String:(NSString *)base64String;
++(NSString *)stringFromBase64UrlEncodedString:(NSString *)base64UrlEncodedString;
+-(NSString *)base64String;
+-(NSString *)base64UrlEncodedString;
+@end
+
+@interface NSData (Base64Addition)
++(NSData *)dataWithBase64String:(NSString *)base64String;
++(NSData *)dataWithBase64UrlEncodedString:(NSString *)base64UrlEncodedString;
+-(NSString *)base64String;
+-(NSString *)base64UrlEncodedString;
+@end
+
+@interface MF_Base64Codec : NSObject 
++(NSData *)dataFromBase64String:(NSString *)base64String;
++(NSString *)base64StringFromData:(NSData *)data;
++(NSString *)base64UrlEncodedStringFromBase64String:(NSString *)base64String;
++(NSString *)base64StringFromBase64UrlEncodedString:(NSString *)base64UrlEncodedString;
+@end

package/ios/CodePush/Base64/Base64/MF_Base64Additions.m

@@ -0,0 +1,252 @@
+//
+//  MF_Base64Additions.m
+//  Base64 -- RFC 4648 compatible implementation
+//  see http://www.ietf.org/rfc/rfc4648.txt for more details
+//
+//  Designed to be compiled with Automatic Reference Counting
+//
+//  Created by Dave Poirier on 2012-06-14.
+//  Public Domain
+//  Hosted at https://github.com/ekscrypto/Base64
+//
+
+#import "MF_Base64Additions.h"
+
+@implementation MF_Base64Codec
+
++(NSString *)base64StringFromBase64UrlEncodedString:(NSString *)base64UrlEncodedString
+{
+    NSString *s = base64UrlEncodedString;
+    s = [s stringByReplacingOccurrencesOfString:@"-" withString:@"+"];
+    s = [s stringByReplacingOccurrencesOfString:@"_" withString:@"/"];
+    switch (s.length % 4) {
+        case 2:
+            s = [s stringByAppendingString:@"=="];
+            break;
+        case 3:
+            s = [s stringByAppendingString:@"="];
+            break;
+        default:
+            break;
+    }
+    return s;
+}
+
++(NSString *)base64UrlEncodedStringFromBase64String:(NSString *)base64String
+{
+    NSString *s = base64String;
+    s = [s stringByReplacingOccurrencesOfString:@"=" withString:@""];
+    s = [s stringByReplacingOccurrencesOfString:@"+" withString:@"-"];
+    s = [s stringByReplacingOccurrencesOfString:@"/" withString:@"_"];
+    return s;
+}
+
++(NSData *)dataFromBase64String:(NSString *)encoding
+{
+    NSData *data = nil;
+    unsigned char *decodedBytes = NULL;
+    @try {
+#define __ 255
+        static char decodingTable[256] = {
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0x00 - 0x0F
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0x10 - 0x1F
+            __,__,__,__, __,__,__,__, __,__,__,62, __,__,__,63,  // 0x20 - 0x2F
+            52,53,54,55, 56,57,58,59, 60,61,__,__, __, 0,__,__,  // 0x30 - 0x3F
+            __, 0, 1, 2,  3, 4, 5, 6,  7, 8, 9,10, 11,12,13,14,  // 0x40 - 0x4F
+            15,16,17,18, 19,20,21,22, 23,24,25,__, __,__,__,__,  // 0x50 - 0x5F
+            __,26,27,28, 29,30,31,32, 33,34,35,36, 37,38,39,40,  // 0x60 - 0x6F
+            41,42,43,44, 45,46,47,48, 49,50,51,__, __,__,__,__,  // 0x70 - 0x7F
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0x80 - 0x8F
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0x90 - 0x9F
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xA0 - 0xAF
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xB0 - 0xBF
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xC0 - 0xCF
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xD0 - 0xDF
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xE0 - 0xEF
+            __,__,__,__, __,__,__,__, __,__,__,__, __,__,__,__,  // 0xF0 - 0xFF
+        };
+        encoding = [encoding stringByReplacingOccurrencesOfString:@"=" withString:@""];
+        NSData *encodedData = [encoding dataUsingEncoding:NSASCIIStringEncoding];
+        unsigned char *encodedBytes = (unsigned char *)[encodedData bytes];
+        
+        NSUInteger encodedLength = [encodedData length];
+        if( encodedLength >= (NSUIntegerMax - 3) ) return nil; // NSUInteger overflow check
+        NSUInteger encodedBlocks = (encodedLength+3) >> 2;
+        NSUInteger expectedDataLength = encodedBlocks * 3;
+        
+        unsigned char decodingBlock[4];
+        
+        decodedBytes = malloc(expectedDataLength);
+        if( decodedBytes != NULL ) {
+            
+            NSUInteger i = 0;
+            NSUInteger j = 0;
+            NSUInteger k = 0;
+            unsigned char c;
+            while( i < encodedLength ) {
+                c = decodingTable[encodedBytes[i]];
+                i++;
+                if( c != __ ) {
+                    decodingBlock[j] = c;
+                    j++;
+                    if( j == 4 ) {
+                        decodedBytes[k] = (decodingBlock[0] << 2) | (decodingBlock[1] >> 4);                
+                        decodedBytes[k+1] = (decodingBlock[1] << 4) | (decodingBlock[2] >> 2);
+                        decodedBytes[k+2] = (decodingBlock[2] << 6) | (decodingBlock[3]);
+                        j = 0;
+                        k += 3;
+                    }
+                }
+            }
+            
+            // Process left over bytes, if any
+            if( j == 3 ) {
+                decodedBytes[k] = (decodingBlock[0] << 2) | (decodingBlock[1] >> 4);                
+                decodedBytes[k+1] = (decodingBlock[1] << 4) | (decodingBlock[2] >> 2);
+                k += 2;
+            } else if( j == 2 ) {
+                decodedBytes[k] = (decodingBlock[0] << 2) | (decodingBlock[1] >> 4);                
+                k += 1;
+            }
+            data = [[NSData alloc] initWithBytes:decodedBytes length:k];
+        }
+    }
+    @catch (NSException *exception) {
+        data = nil;
+        NSLog(@"WARNING: error occured while decoding base 32 string: %@", exception);
+    }
+    @finally {
+        if( decodedBytes != NULL ) {
+            free( decodedBytes );
+        }
+    }
+    return data;
+}
++(NSString *)base64StringFromData:(NSData *)data
+{
+    NSString *encoding = nil;
+    unsigned char *encodingBytes = NULL;
+    @try {
+        static char encodingTable[64] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+        static NSUInteger paddingTable[] = {0,2,1};
+        //                 Table 1: The Base 64 Alphabet
+        //        
+        //    Value Encoding  Value Encoding  Value Encoding  Value Encoding
+        //        0 A            17 R            34 i            51 z
+        //        1 B            18 S            35 j            52 0
+        //        2 C            19 T            36 k            53 1
+        //        3 D            20 U            37 l            54 2
+        //        4 E            21 V            38 m            55 3
+        //        5 F            22 W            39 n            56 4
+        //        6 G            23 X            40 o            57 5
+        //        7 H            24 Y            41 p            58 6
+        //        8 I            25 Z            42 q            59 7
+        //        9 J            26 a            43 r            60 8
+        //       10 K            27 b            44 s            61 9
+        //       11 L            28 c            45 t            62 +
+        //       12 M            29 d            46 u            63 /
+        //       13 N            30 e            47 v
+        //       14 O            31 f            48 w         (pad) =
+        //       15 P            32 g            49 x
+        //       16 Q            33 h            50 y
+        
+        NSUInteger dataLength = [data length];
+        NSUInteger encodedBlocks = dataLength / 3;
+        if( (encodedBlocks + 1) >= (NSUIntegerMax / 4) ) return nil; // NSUInteger overflow check
+        NSUInteger padding = paddingTable[dataLength % 3];
+        if( padding > 0 ) encodedBlocks++;
+        NSUInteger encodedLength = encodedBlocks * 4;
+        
+        encodingBytes = malloc(encodedLength);
+        if( encodingBytes != NULL ) {
+            NSUInteger rawBytesToProcess = dataLength;
+            NSUInteger rawBaseIndex = 0;
+            NSUInteger encodingBaseIndex = 0;
+            unsigned char *rawBytes = (unsigned char *)[data bytes];
+            unsigned char rawByte1, rawByte2, rawByte3;
+            while( rawBytesToProcess >= 3 ) {
+                rawByte1 = rawBytes[rawBaseIndex];
+                rawByte2 = rawBytes[rawBaseIndex+1];
+                rawByte3 = rawBytes[rawBaseIndex+2];
+                encodingBytes[encodingBaseIndex] = encodingTable[((rawByte1 >> 2) & 0x3F)];
+                encodingBytes[encodingBaseIndex+1] = encodingTable[((rawByte1 << 4) & 0x30) | ((rawByte2 >> 4) & 0x0F) ];
+                encodingBytes[encodingBaseIndex+2] = encodingTable[((rawByte2 << 2) & 0x3C) | ((rawByte3 >> 6) & 0x03) ];
+                encodingBytes[encodingBaseIndex+3] = encodingTable[(rawByte3 & 0x3F)];
+                
+                rawBaseIndex += 3;
+                encodingBaseIndex += 4;
+                rawBytesToProcess -= 3;
+            }
+            rawByte2 = 0;
+            switch (dataLength-rawBaseIndex) {
+                case 2:
+                    rawByte2 = rawBytes[rawBaseIndex+1];
+                case 1:
+                    rawByte1 = rawBytes[rawBaseIndex];
+                    encodingBytes[encodingBaseIndex] = encodingTable[((rawByte1 >> 2) & 0x3F)];
+                    encodingBytes[encodingBaseIndex+1] = encodingTable[((rawByte1 << 4) & 0x30) | ((rawByte2 >> 4) & 0x0F) ];
+                    encodingBytes[encodingBaseIndex+2] = encodingTable[((rawByte2 << 2) & 0x3C) ];
+                    // we can skip rawByte3 since we have a partial block it would always be 0
+                    break;
+            }
+            // compute location from where to begin inserting padding, it may overwrite some bytes from the partial block encoding
+            // if their value was 0 (cases 1-2).
+            encodingBaseIndex = encodedLength - padding;
+            while( padding-- > 0 ) {
+                encodingBytes[encodingBaseIndex++] = '=';
+            }
+            encoding = [[NSString alloc] initWithBytes:encodingBytes length:encodedLength encoding:NSASCIIStringEncoding];
+        }
+    }
+    @catch (NSException *exception) {
+        encoding = nil;
+        NSLog(@"WARNING: error occured while tring to encode base 32 data: %@", exception);
+    }
+    @finally {
+        if( encodingBytes != NULL ) {
+            free( encodingBytes );
+        }
+    }
+    return encoding;
+}
+@end
+
+@implementation NSString (Base64Addition)
+-(NSString *)base64String
+{
+    NSData *utf8encoding = [self dataUsingEncoding:NSUTF8StringEncoding];
+    return [MF_Base64Codec base64StringFromData:utf8encoding];
+}
+-(NSString *)base64UrlEncodedString
+{
+    return [MF_Base64Codec base64UrlEncodedStringFromBase64String:[self base64String]];
+}
++(NSString *)stringFromBase64String:(NSString *)base64String
+{
+    NSData *utf8encoding = [MF_Base64Codec dataFromBase64String:base64String];
+    return [[NSString alloc] initWithData:utf8encoding encoding:NSUTF8StringEncoding];
+}
++(NSString *)stringFromBase64UrlEncodedString:(NSString *)base64UrlEncodedString
+{
+    return [self stringFromBase64String:[MF_Base64Codec base64StringFromBase64UrlEncodedString:base64UrlEncodedString]];
+}
+@end
+
+@implementation NSData (Base64Addition)
++(NSData *)dataWithBase64String:(NSString *)base64String
+{
+    return [MF_Base64Codec dataFromBase64String:base64String];
+}
++(NSData *)dataWithBase64UrlEncodedString:(NSString *)base64UrlEncodedString
+{
+    return [self dataWithBase64String:[MF_Base64Codec base64StringFromBase64UrlEncodedString:base64UrlEncodedString]];
+}
+-(NSString *)base64String
+{
+    return [MF_Base64Codec base64StringFromData:self];
+}
+-(NSString *)base64UrlEncodedString
+{
+    return [MF_Base64Codec base64UrlEncodedStringFromBase64String:[self base64String]];
+}
+@end

package/ios/CodePush/Base64/README.md

@@ -0,0 +1,47 @@
+[![CI Status](https://travis-ci.org/ekscrypto/Base64.svg?branch=master)](https://github.com/ekscrypto/Base64)
+
+Base64 Additions for Objective-C on Mac OS X and iOS
+=======
+
+
+Usage
+----
+Open the Xcode project file, and drag MF_Base64Additions.m/.h into your project.
+
+In files where you want to use Base64 encoding/decoding, simply include the header file and use one of the provided NSData or NSString additions.
+    
+Example use:
+    #import "MF_Base64Additions.h"
+    
+    NSString *helloWorld = @"Hello World";
+    NSString *helloInBase64 = [helloWorld base64String];
+    NSString *helloDecoded = [NSString stringFromBase64String:helloInBase64];
+
+
+
+
+Performance
+----
+* Encoding: Approximately 4 to 5 times faster than using the equivalent SecTransform.
+* Encoding: 30% faster than https://github.com/l4u/NSData-Base64
+* Decoding: 5% faster than using the equivalent SecTransform.
+* Decoding: 5% faster than https://github.com/l4u/NSData-Base64
+
+
+
+Requirements
+-----
+* Compile with Automatic Reference Counting
+* Compatible with Mac OSX 10.6+ and iOS 4.0+
+
+
+
+Implementation
+----
+* Implemented as per RFC 4648, see http://www.ietf.org/rfc/rfc4648.txt for more details.
+
+
+
+Licensing
+----
+* Public Domain