@revopush/react-native-code-push 0.0.1

package/docs/multi-deployment-testing-android.md

@@ -0,0 +1,55 @@
+### Android
+
+> NOTE
+>
+> Complete demo configured with "multi-deployment testing" feature is [here](https://github.com/microsoft/react-native-code-push/files/1314118/rncp1004.zip).
+
+The [Android Gradle plugin](https://google.github.io/android-gradle-dsl/current/index.html) allows you to define custom config settings for each "build type" (like debug, release). This mechanism allows you to easily configure your debug builds to use your CodePush staging deployment key and your release builds to use your CodePush production deployment key.
+
+*NOTE: As a reminder, you can retrieve these keys by running `appcenter codepush deployment list -a <ownerName>/<appName> -k` from your terminal.*
+
+To set this up, perform the following steps:
+
+**For React Native >= v0.76**
+
+1. Open the project's app level `build.gradle` file (for example `android/app/build.gradle` in standard React Native projects)
+
+2. Find the `android { buildTypes {} }` section and define `resValue` entries for both your `debug` and `release` build types, which reference your `Staging` and `Production` deployment keys respectively.
+
+    ```groovy
+    android {
+        ...
+        buildTypes {
+            debug {
+                ...
+                // Note: CodePush updates should not be tested in Debug mode as they are overriden by the RN packager. However, because CodePush checks for updates in all modes, we must supply a key.
+                resValue "string", "CodePushDeploymentKey", '""'
+                ...
+            }
+
+            releaseStaging {
+                ...
+                resValue "string", "CodePushDeploymentKey", '"<INSERT_STAGING_KEY>"'
+
+                // Note: It is a good idea to provide matchingFallbacks for the new buildType you create to prevent build issues
+                // Add the following line if not already there
+                matchingFallbacks = ['release']
+                ...
+            }
+
+            release {
+                ...
+                resValue "string", "CodePushDeploymentKey", '"<INSERT_PRODUCTION_KEY>"'
+                ...
+            }
+        }
+        ...
+    }
+    ```
+
+   *NOTE: Remember to remove the key from `strings.xml` if you are configuring the deployment key in the build process*
+
+   *NOTE: The naming convention for `releaseStaging` is significant due to [this line](https://github.com/facebook/react-native/blob/e083f9a139b3f8c5552528f8f8018529ef3193b9/react.gradle#L79).*
+
+
+And that's it! View [here](http://tools.android.com/tech-docs/new-build-system/resource-merging) for more details on how resource merging works in Android.

package/docs/multi-deployment-testing-ios.md

@@ -0,0 +1,59 @@
+### iOS
+
+> NOTE
+>
+> Complete demos configured with "multi-deployment testing" feature are [here]:
+> *  **without using cocoa pods**: [link](https://github.com/microsoft/react-native-code-push/files/1259957/rncp976.copy.zip)
+> *  **using cocoa pods**: [link](https://github.com/microsoft/react-native-code-push/files/1172217/rncp893.copy.zip)
+
+Xcode allows you to define custom build settings for each "configuration" (like debug, release), which can then be referenced as the value of keys within the `Info.plist` file (like the `CodePushDeploymentKey` setting). This mechanism allows you to easily configure your builds to produce binaries, which are configured to synchronize with different CodePush deployments.
+
+To set this up, perform the following steps:
+
+1. Open up your Xcode project and select your project in the `Project navigator` window
+
+2. Ensure the project node is selected, as opposed to one of your targets
+
+3. Select the `Info` tab
+
+4. Click the `+` button within the `Configurations` section and select `Duplicate "Release" Configuration`
+
+   ![Configuration](https://cloud.githubusercontent.com/assets/116461/16101597/088714c0-331c-11e6-9504-5469d9a59d74.png)
+
+5. Name the new configuration `Staging` (or whatever you prefer)
+
+6. Select the `Build Settings` tab
+
+7. Click the `+` button on the toolbar and select `Add User-Defined Setting`
+
+   ![Setting](https://cloud.githubusercontent.com/assets/116461/15764165/a16dbe30-28dd-11e6-94f2-fa3b7eb0c7de.png)
+
+   Name this new setting something like `Multi_Deployment_Config`. Go to the setting and add value `$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)` for Release. After that add value `$(BUILD_DIR)/Release$(EFFECTIVE_PLATFORM_NAME)` for Staging
+
+   ![MultiDeploymentConfig](https://user-images.githubusercontent.com/48414875/87178636-1d6a6500-c2e6-11ea-890d-b7773f07e503.png)
+
+   *NOTE: For Xcode 10 and lower version: Go to Build Location -> Per-configuration Build Products Path -> Staging and change Staging value from $(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME) to $(BUILD_DIR)/Release$(EFFECTIVE_PLATFORM_NAME)*
+
+   ![BuildFilesPath1](https://cloud.githubusercontent.com/assets/4928157/22645377/b1d7df0e-ec77-11e6-83c6-291a27bcdb17.png)
+
+   *NOTE: Due to https://github.com/facebook/react-native/issues/11813, we have to do this step to make it possible to use other configurations than Debug or Release on RN 0.40.0 or higher.*
+
+8. Click the `+` button again on the toolbar and select `Add User-Defined Setting`
+
+   Name this new setting something like `CODEPUSH_KEY`, expand it, and specify your `Staging` deployment key for the `Staging` config and your `Production` deployment key for the `Release` config.
+
+    ![Setting Keys](https://cloud.githubusercontent.com/assets/8598682/16821919/fc1eac4a-490d-11e6-9b11-128129c24b80.png)
+
+    *NOTE: As a reminder, you can retrieve these keys by running `appcenter codepush deployment list -a <ownerName>/<appName> -k` from your terminal.*
+
+9. Open your project's `Info.plist` file and change the value of your `CodePushDeploymentKey` entry to `$(CODEPUSH_KEY)`
+
+    ![Infoplist](https://cloud.githubusercontent.com/assets/116461/15764252/3ac8aed2-28de-11e6-8c19-2270ae9857a7.png)
+
+And that's it! Now when you run or build your app, your staging builds will automatically be configured to sync with your `Staging` deployment, and your release builds will be configured to sync with your `Production` deployment.
+
+*NOTE: CocoaPods users may need to run `pod install` before building with their new release configuration.*
+
+*Note: If you encounter the error message `ld: library not found for ...`, please consult [this issue](https://github.com/microsoft/react-native-code-push/issues/426) for a possible solution.*
+
+Additionally, if you want to give them seperate names and/or icons, you can modify the `Product Bundle Identifier`, `Product Name` and `Asset Catalog App Icon Set Name` build settings, which will allow your staging builds to be distinguishable from release builds when installed on the same device.

package/docs/setup-android.md

@@ -0,0 +1,92 @@
+## Android Setup
+
+* [Plugin Installation and Configuration for React Native 0.76 version and above](#plugin-installation-and-configuration-for-react-native-060-version-and-above-android)
+* [Code Signing setup](#code-signing-setup)
+
+In order to integrate CodePush into your Android project, please perform the following steps:
+
+### Plugin Installation and Configuration for React Native 0.76 version and above (Android)
+
+
+1. In your `android/app/build.gradle` file, add the `codepush.gradle` file as an additional build task definition to the end of the file:
+
+    ```gradle
+    ...
+    apply from: "../../node_modules/@revopush/react-native-code-push/android/codepush.gradle"
+    ...
+    ```
+
+2. Update the `MainApplication` file to use CodePush via the following changes:
+
+   For React Native 0.76 and above: update the `MainApplication.kt`
+
+   **Important! : PackageList must be instantiated only one in application lifetime.**
+
+    ```kotlin
+    ...
+    // 1. Import the plugin class.
+    import com.microsoft.codepush.react.CodePush
+
+    class MainApplication : Application(), ReactApplication {
+       override val reactNativeHost: ReactNativeHost =
+           object : DefaultReactNativeHost(this) {
+               override fun getPackages(): List<ReactPackage> = PackageList(this).packages.apply {
+                 // Packages that cannot be autolinked yet can be added manually here, for example:
+                 // add(MyReactNativePackage())
+                }
+
+               // 2. Override the getJSBundleFile method in order to let
+               // the CodePush runtime determine where to get the JS
+               // bundle location from on each app start
+               override fun getJSBundleFile(): String {
+                 return CodePush.getJSBundleFile() 
+               }
+        };
+    }
+    ```
+
+
+3. Add the Deployment key to `strings.xml`:
+
+   To let the CodePush runtime know which deployment it should query for updates, open your app's `strings.xml` file and add a new string 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 CodePush 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. The "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.
+
+   Your `strings.xml` should looks like this:
+
+   ```xml
+    <resources>
+        <string name="app_name">AppName</string>
+        <string moduleConfig="true" name="CodePushDeploymentKey">DeploymentKey</string>
+    </resources>
+    ```
+
+   *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)*
+
+
+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.
+
+
+
+### 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 use Public Key for Code Signing you need to do following steps:
+
+Add `CodePushPublicKey` string item to `/path_to_your_app/android/app/src/main/res/values/strings.xml`. It may looks like this:
+
+ ```xml
+ <resources>
+    <string name="app_name">my_app</string>
+    <string name="CodePushPublicKey">-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtPSR9lkGzZ4FR0lxF+ZA
+P6jJ8+Xi5L601BPN4QESoRVSrJM08roOCVrs4qoYqYJy3Of2cQWvNBEh8ti3FhHu
+tiuLFpNdfzM4DjAw0Ti5hOTfTixqVBXTJPYpSjDh7K6tUvp9MV0l5q/Ps3se1vud
+M1/X6g54lIX/QoEXTdMgR+SKXvlUIC13T7GkDHT6Z4RlwxkWkOmf2tGguRcEBL6j
+ww7w/3g0kWILz7nNPtXyDhIB9WLH7MKSJWdVCZm+cAqabUfpCFo7sHiyHLnUxcVY
+OTw3sz9ceaci7z2r8SZdsfjyjiDJrq69eWtvKVUpredy9HtyALtNuLjDITahdh8A
+zwIDAQAB
+-----END PUBLIC KEY-----</string>
+</resources>
+ ```

package/docs/setup-ios.md

@@ -0,0 +1,137 @@
+## 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.76 version and above (iOS)
+
+1. Run `cd ios && pod install && cd ..` to install all the necessary CocoaPods dependencies.
+   ​
+2. Change bundleUrl on AppDelegate file.
+
+   **If you're using objective-c:**
+   1. Open up the `AppDelegate.m` file, and add an import statement for the CodePush headers:
+
+            ```objective-c
+            #import <CodePush/CodePush.h>
+            ```
+
+   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];
+      ```
+      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
+      }
+      ```
+
+   **If you're using Swift:**
+   1. Open up the `AppDelegate.swift` file, and add an import statement for the CodePush headers:
+      ```swift
+      import CodePush
+      ```
+
+   2. Find the following line of code, which sets the source URL for bridge for production release:
+      ```swift
+      Bundle.main.url(forResource: "main", withExtension: "jsbundle")
+      ```
+   3. Replace it with this line:
+      ```swift
+      CodePush.bundleURL()
+      ```
+
+      Your `bundleUrl` method should look like this:
+      ```swift
+      override func bundleURL() -> URL? {
+      #if DEBUG
+         RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
+      #else
+         CodePush.bundleURL()
+      #endif
+      }
+      ```
+
+4. 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)*
+
+
+### HTTP exception domains configuration (iOS)
+
+CodePush plugin makes HTTPS requests to the following domains:
+
+- api.revopush.org
+- blob.revopush.org
+
+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>api.revopush.org</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/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