Check at runtime if Kongregate's JavaScript API is present (#6)

* Add logic to gracefully handle the case that the Kongregate API is not present.
* Add new Status property to indicate if the API is uninitialized, unavailable, or ready.

Author: aandre-dedalord

Runtime/KongregateWeb.cs

@@ -65,9 +65,15 @@ public class KongregateUserItem
 [DisallowMultipleComponent]
 public class KongregateWeb : MonoBehaviour
 {
-    private static KongregateWeb _instance;
+    public enum ApiStatus
+    {
+        Uninitialized,
+        Unavailable,
+        Ready
+    }
 
-    private bool _kongregateApiLoaded = false;
+    private static KongregateWeb _instance;
+    private ApiStatus _status = ApiStatus.Uninitialized;
     private string _username;
     private int _userId;
     private string _gameAuthToken;
@@ -236,12 +242,21 @@ public static event Action<bool> AdClosed
         }
     }
 
+    public static ApiStatus Status
+    {
+        get
+        {
+            AssertInstanceExists();
+            return _instance._status;
+        }
+    }
+
     public static bool IsReady
     {
         get
         {
             AssertInstanceExists();
-            return _instance._kongregateApiLoaded;
+            return _instance._status == ApiStatus.Ready;
         }
     }
 
@@ -418,7 +433,7 @@ private static void AssertIsReady()
     {
         AssertInstanceExists();
 
-        if (!_instance._kongregateApiLoaded)
+        if (_instance._status != ApiStatus.Ready)
         {
             throw new Exception($"Do not call any methods on {typeof(KongregateWeb).Name} until the Kongregate web API has finished loading");
         }
@@ -428,7 +443,7 @@ private static void AssertIsReady()
     #region Callbacks from JS
     private void OnInitSucceeded()
     {
-        _kongregateApiLoaded = true;
+        _status = ApiStatus.Ready;
 
         if (!isGuest())
         {
@@ -441,6 +456,11 @@ private void OnInitSucceeded()
         _onBecameReady = null;
     }
 
+    private void OnInitFailed()
+    {
+        _status = ApiStatus.Unavailable;
+    }
+
     private void OnLogin(string userInfo)
     {
         _userId = getUserId();
@@ -541,7 +561,7 @@ private void OnAdClosed(int completed)
     [DllImport("__Internal")]
     private static extern void submitStats(string statisticName, int value);
 #else
-    private static void initKongregateAPI (string gameObjectName) { }
+    private static void initKongregateAPI (string gameObjectName) { _instance._status = ApiStatus.Unavailable; }
     private static bool isGuest() { return true; }
     private static int getUserId() { return 0; }
     private static string getUsername() { return null; }

Runtime/KongregateWeb.jslib

@@ -27,6 +27,11 @@ var LibraryKongregate = {
 		// Save the name of the Unity GameObject that we will send messages to.
 		instance.gameObjectName = Pointer_stringify(gameObjectName);
 
+		if (typeof kongregateAPI === 'undefined' || kongregateAPI === null) {
+			instance.sendMessage('OnInitFailed');
+			return;
+		}
+
 		kongregateAPI.loadAPI(function () {
 			instance.kongregate = kongregateAPI.getAPI();
 
@@ -146,4 +151,4 @@ var LibraryKongregate = {
 autoAddDeps(LibraryKongregate, '$instance');
 autoAddDeps(LibraryKongregate, '$stringToBuffer');
 autoAddDeps(LibraryKongregate, '$parseJSON');
-mergeInto(LibraryManager.library, LibraryKongregate);
+mergeInto(LibraryManager.library, LibraryKongregate);