Adding snippets for Chat token management (TwilioDevEd#748)

* Adding snippets for Chat token management
Particularly addressing three scenarios:
- initializing the client with initial token
- updating the token with provided string
- using the built-in token lifecycle events

* Listener fix

* Add token refresh samples for Obj-C and Swift

* Make fetchToken async

Author: dr0nius

ip-messaging/tokens/initialization/initialization.java

@@ -0,0 +1,14 @@
+import com.twilio.chat.ChatClient;
+import com.twilio.chat.ChatClientListener;
+
+ChatClient.Properties.Builder builder = new ChatClient.Properties.Builder();
+ChatClient.Properties properties = builder.createProperties();
+// See below for client event listener implementation
+ChatClientListener listener = new Listener();
+
+// Make a secure request to your backend to retrieve an access token.
+// Use an authentication mechanism to prevent token exposure to 3rd parties.
+
+String accessToken = "<your token here>";
+
+ChatClient.create(getApplicationContext(), accessToken, properties, listener);

ip-messaging/tokens/initialization/initialization.js

@@ -0,0 +1,11 @@
+const Chat = require('twilio-chat');
+
+// Make a secure request to your backend to retrieve an access token.
+// Use an authentication mechanism to prevent token exposure to 3rd parties.
+
+const accessToken = '<your accessToken>';
+
+Chat.Client.create(accessToken)
+  .then(client => {
+    // Use Programmable Chat client
+  });

ip-messaging/tokens/initialization/initialization.m

@@ -0,0 +1,13 @@
+#import <TwilioChatClient/TwilioChatClient.h>
+
+// Make a secure request to your backend to retrieve an access token.
+// Use an authentication mechanism to prevent token exposure to 3rd parties.
+
+NSString *accessToken = @"<your token here>";
+
+[TwilioChatClient chatClientWithToken:accessToken
+  properties:properties delegate:delegate completion:(TCHResult *result, TwilioChatClient *client) {
+    if (![result isSuccessful]) {
+      // warn the user the initialization didn't succeed
+    }
+  }];

ip-messaging/tokens/initialization/initialization.swift

@@ -0,0 +1,14 @@
+import TwilioChatClient
+
+// Make a secure request to your backend to retrieve an access token.
+// Use an authentication mechanism to prevent token exposure to 3rd parties.
+
+let accessToken = "<your token here>"
+
+TwilioChatClient.chatClient(withToken: accessToken,
+  properties: nil, delegate: self) {
+    (result, chatClient) in
+    if (!result.isSuccessful()) {
+      // warn the user the initialization didn't succeed
+    }
+  }

ip-messaging/tokens/initialization/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Initializing Chat SDK",
+  "type": "mobile"
+}

ip-messaging/tokens/renewal/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Responding to Renewal Events",
+  "type": "mobile"
+}

ip-messaging/tokens/renewal/renewal.java

@@ -0,0 +1,14 @@
+public class Listener implements ChatClientListener {
+  @Override public void onTokenAboutToExpire()
+  {
+    // Implement fetchToken() to make a secure request to your backend to retrieve a refreshed access token.
+    // Use an authentication mechanism to prevent token exposure to 3rd parties.
+    fetchToken((String updatedToken) -> {
+      chatClient.updateToken(updatedToken, new StatusListener {
+        @Override public void onSuccess() {
+          System.out.println("Token renewed successfully");
+        }
+      });
+    });
+  }
+}

ip-messaging/tokens/renewal/renewal.js

@@ -0,0 +1,7 @@
+chatClient.on('tokenAboutToExpire', function() {
+  // Implement fetchToken() to make a secure request to your backend to retrieve a refreshed access token.
+  // Use an authentication mechanism to prevent token exposure to 3rd parties.
+  fetchToken(function(updatedToken) {
+    chatClient.updateToken(updatedToken);
+  });
+});

ip-messaging/tokens/renewal/renewal.m

@@ -0,0 +1,12 @@
+- (void)chatClientTokenWillExpire:(TwilioChatClient *)chatClient {
+  // Implement fetchToken() to make a secure request to your backend to retrieve a refreshed access token.
+  // Use an authentication mechanism to prevent token exposure to 3rd parties.
+  [self fetchToken:completion:^(NSString *updatedToken) {
+    [chatClient updateToken:updatedToken
+      completion:^(TCHResult * _Nonnull result) {
+        if (!result.isSuccessful) {
+          NSLog(@"Error updating token: %@", result.error);
+        }
+      }];
+  }]
+}

ip-messaging/tokens/renewal/renewal.swift

@@ -0,0 +1,14 @@
+func chatClientTokenWillExpire(_ chatClient: TwilioChatClient) {
+  // Implement fetchToken() to make a secure request to your backend to retrieve a refreshed access token.
+  // Use an authentication mechanism to prevent token exposure to 3rd parties.
+  fetchToken(completion: { (updatedToken) -> (Void) in
+    if let updatedToken = updatedToken {
+      chatClient.updateToken(updatedToken, completion: { (result) in
+        if !result.isSuccessful() {
+          print("Error updating token: \(String(describing: result.error?.description))")
+            return
+          }
+      })
+    }
+  })
+}

ip-messaging/tokens/update/meta.json

@@ -0,0 +1,4 @@
+{
+  "title": "Updating a Token in Chat SDK",
+  "type": "mobile"
+}

ip-messaging/tokens/update/update.java

@@ -0,0 +1,5 @@
+chatClient.updateToken(accessToken, new StatusListener {
+  @Override public void onSuccess() {
+    System.out.println("Token updated successfully");
+  }
+});

ip-messaging/tokens/update/update.js

@@ -0,0 +1 @@
+chatClient.updateToken(accessToken);

ip-messaging/tokens/update/update.m

@@ -0,0 +1,5 @@
+[chatClient updateToken:accessToken completion:^(TCHResult *result) {
+  if (![result isSuccessful]) {
+    // warn the user the update didn't succeed
+  }
+}];

ip-messaging/tokens/update/update.swift

@@ -0,0 +1,5 @@
+chatClient.updateToken(accessToken) { (result) in
+  if (!result.isSuccessful()) {
+    // warn the user the update didn't succeed
+  }
+}