@aicore/core-analytics-client-lib 1.0.5 → 1.0.8

package/README.md

@@ -20,41 +20,31 @@ events for [Core-Analytics-Server](https://github.com/aicore/Core-Analytics-Serv
 # Usage
 
 ## Load the Library
-Embed the script in your HTML file : 
+Embed the script in your HTML file and replace `your_analytics_account_ID` and `appName`
+in the `initAnalyticsSession` call below: 
 ```html
-<script src="https://unpkg.com/@aicore/core-analytics-client-lib/src/analytics.js"></script>
+<!-- Global window.analytics object - core.ai analytics services -->
+<script async src="https://unpkg.com/@aicore/core-analytics-client-lib/src/analytics.js"
+        onload="analyticsLibLoaded()"></script>
+<script>
+    if(!window.analytics){ window.analytics = {
+        _initData : [], loadStartTime: new Date().getTime(),
+        event: function (){window.analytics._initData.push(arguments);}
+    };}
+    function analyticsLibLoaded() {
+        initAnalyticsSession('your_analytics_account_ID', 'appName');
+        analytics.event("core-analytics", "client-lib", "loadTime", 1, (new Date().getTime())-analytics.loadStartTime);
+    }
+</script>
 ```
 This will create a global `analytics` variable which can be used to access the analytics APIs. 
 
-## Initialize the analytics session.
-Call `analytics.initSession()` after loading the library. It takes the following parameters:
-
-* `accountID`: Your analytics account id as configured in the server or core.ai analytics
-* `appName`: The app name to log the events against. Eg: "phoenixCode"
-* `postIntervalSeconds` (_Optional_): This defines the interval between sending analytics events to the server. Default is 10 minutes
-* `granularitySec` (_Optional_): The smallest time period under which the events can be distinguished. Multiple
-events happening during this time period is aggregated to a count. The default granularity is 3 Seconds, which means
-that any events that happen within 3 seconds cannot be distinguished in ordering.
-* `analyticsURL` (_Optional_): Provide your own analytics server address if you self-hosted the server
-* `debug` (_Optional_):  set to true if you want to see detailed debug logs.
-
-### usageExample
-```javascript
-// Init with default values.
-analytics.initSession("accountID", "appName");
-
-// Example for custom initSession where the analytics aggregated data 
-// is posted to custom server https://localhost:3000 every 600 secs
-// with a granularity(resolution) of 5 seconds.
-analytics.initSession("accountID", "appName", "https://localhost:3000", 600, 5);
-
-// To initSession in debug mode set debug arg in init to true:
-analytics.initSession("accountID", "appName", "https://localhost:3000", 600, 5, true);
-```
+NB: The script is loaded async, so it will not block other js scripts. `analytics.event` api can be called anytime
+after the above code and need not wait for the script load to complete.
 
 ## Raising analytics events
-Once `initSession` is called, we can now start logging analytics events by calling `analytics.event` API.
-The API registers an analytics event. The events will be aggregated and send to the analytics server periodically.
+We can now start logging analytics events by calling `analytics.event` API.
+The events will be aggregated and send to the analytics server periodically.
 
 ```javascript
 // analyticsEvent(eventType, eventCategory, subCategory, eventCount, eventValue);
@@ -79,9 +69,87 @@ analytics.event("platform", "CPU", "coreCountsAndFrequencyMhz", 8, 2300);
 * `eventCategory` - A string, required
 * `subCategory` - A string, required
 * `eventCount` (_Optional_) : A non-negative number indicating the number of times the event (or an event with a
-particular value if a value is specified) happened. defaults to 1.
+  particular value if a value is specified) happened. defaults to 1.
 * `eventValue` (_Optional_) : A number value associated with the event. defaults to 0
 
+
+## Advanced Usages
+
+### Pure JS loading instead of HTML scripts
+
+There may be cases where you would want to load the script from JS alone. For Eg. you
+may want to delay library loading till user consents GDPR. For such use cases, use the below code.
+
+```js
+function _initCoreAnalytics() {
+    // Load core analytics scripts
+    if(!window.analytics){ window.analytics = {
+        _initData: [], loadStartTime: new Date().getTime(),
+        event: function (){window.analytics._initData.push(arguments);}
+    };}
+    let script = document.createElement('script');
+    script.type = 'text/javascript';
+    script.async = true;
+    script.onload = function(){
+        // replace `your_analytics_account_ID` and `appName` below with your values 
+        window.initAnalyticsSession('your_analytics_account_ID', 'appName'); // if you have a custom analytics server
+        window.analytics.event("core-analytics", "client-lib", "loadTime", 1,
+            (new Date().getTime())- window.analytics.loadStartTime);
+    };
+    script.src = 'https://unpkg.com/@aicore/core-analytics-client-lib/dist/analytics.min.js';
+    document.getElementsByTagName('head')[0].appendChild(script);
+}
+_initCoreAnalytics();
+```
+To load the library, just call `_initCoreAnalytics()` from JS. Note that you may not be able
+to use `analytics.event()` APIs before `_initCoreAnalytics()` call is made.
+
+### initAnalyticsSession: modify when, where and how analytics lib sends events
+ If you want to modify how analytics library collects and sends information, it is recommended to do so
+with analytics server [accountConfig](https://github.com/aicore/Core-Analytics-Server#accountconfig-configuration).
+
+Alternatively for one off development time uses, the behavior of the library can be configured
+during the `initAnalyticsSession` call. `initAnalyticsSession()` takes the following parameters:
+
+* `accountID`: Your analytics account id as configured in the server or core.ai analytics
+* `appName`: The app name to log the events against. Eg: "phoenixCode"
+* `analyticsURL` (_Optional_): Provide your own analytics server address if you self-hosted the server.
+* `postIntervalSeconds` (_Optional_): This defines the interval between sending analytics events to the server. Default is 1 minutes or server controlled.
+* `granularitySec` (_Optional_): The smallest time period under which the events can be distinguished. Multiple
+events happening during this time period is aggregated to a count. The default granularity is 3 Seconds or server controlled,
+which means that any events that happen within 3 seconds cannot be distinguished in ordering.
+* `debug` (_Optional_):  set to true if you want to see detailed debug logs.
+
+#### usageExample
+```javascript
+// Init with default values and server controlled config. use the following `analyticsLibLoaded` function
+function analyticsLibLoaded() {
+    initAnalyticsSession('your_analytics_account_ID', 'appName');
+    analytics.event("core-analytics", "client-lib", "loadTime", 1, (new Date().getTime())-analytics.loadStartTime);
+}
+
+//Replace initAnalyticsSession in analyticsLibLoaded function for the below use cases.
+
+// Example for custom initSession where the analytics aggregated data 
+// is posted to custom server https://localhost:3000 every 600 secs
+// with a granularity(resolution) of 5 seconds.
+initAnalyticsSession("accountID", "appName", "https://localhost:3000", 600, 5);
+```
+
+### Debug logs
+ If you want to see detailed logs on what is happening inside analytics lib, use the below code:
+```js
+// To initSession in debug mode set debug arg in init to true. In debug mode, details logs
+// about analytics library events will be emitted.
+initAnalyticsSession("accountID", "appName", "https://localhost:3000", 600, 5, true);
+```
+
+To see info level logs that shows actual analytics data being sent to server, set the below property:
+```js 
+window.analytics.debugInfoLogsEnable = true;
+```
+
+
 # Contribute to core-analytics-client-lib
 
 ## Building

package/dist/analytics.min.js

@@ -1,4 +1,4 @@
-var analytics={};function init(){let r,s,e,t,l,u,c,f,n;const v=3,a=30,y=600,o="aicore.analytics.userID",i=1e4;let d=null;var m="undefined"==typeof window;let g="https://analytics.core.ai",p,h,w=0,C=!1,I=!1;function b(...e){I&&console.log(...e)}if(m)throw new Error("Node environment is not currently supported");function S(){return{schemaVersion:1,accountID:r,appName:s,uuid:e,sessionID:t,unixTimestampUTC:+new Date,numEventsTotal:0,events:{}}}function E(){if(!d)throw new Error("Please call initSession before using any analytics event")}function T(){e=function(){let e=localStorage.getItem(o);return e||(e=crypto.randomUUID(),localStorage.setItem(o,e)),e}(),t=function(){let e=sessionStorage.getItem(o);return e||(e=Math.random().toString(36).substr(2,10),sessionStorage.setItem(o,e)),e}()}function D(e){e.backoffCount=(e.backoffCount||0)+1,b(`Failed to call core analytics server. Will retry in ${a*e.backoffCount}s: `),setTimeout(()=>{N(e)},1e3*a*e.backoffCount)}function N(t){var e;C||(t||(t=d,w=0,$(),d=S()),0!==t.numEventsTotal&&((e=JSON.stringify(t)).length>i&&console.warn(`Analytics event generated is very large at greater than ${e.length}B. This 
-        typically means that you may be sending too many value events? .`),b("Sending Analytics data of length: ",e.length,"B"),window.fetch(f,{method:"POST",headers:{"Content-Type":"application/json"},body:e}).then(e=>{200!==e.status&&(400!==e.status?D(t):console.error("Analytics client: Bad Request, this is most likely a problem with the library, update to latest version."))}).catch(e=>{e=[e],I&&console.error(...e),D(t)})))}function $(e){p&&(clearInterval(p),p=null),e||(p=setInterval(()=>{w+=u},1e3*u))}function k(e){$(e),h&&(clearInterval(h),h=null),e||(h=setInterval(N,1e3*l))}async function A(e,t){(n=await new Promise((n,a)=>{var e=c+(`/getAppConfig?accountID=${r}&appName=`+s);window.fetch(e).then(async e=>{switch(e.status){case 200:var t=await e.json();return void n(t);case 400:a("Bad Request, check library version compatible?",e);break;default:a("analytics client: Could not update from remote config. Continuing with defaults.",e)}}).catch(e=>{a("analytics client: Could not update from remote config. Continuing with defaults.",e)})}))!=={}&&(l=e||n.postIntervalSecondsInit||y,u=t||n.granularitySecInit||v,c=n.analyticsURLInit||c||g,k(C=!0===n.disabled),b(`Init analytics Config from remote. disabled: ${C}
-        postIntervalSeconds:${l}, granularitySec: ${u} ,URL: `+c),C&&console.warn(`Core Analytics is disabled from the server for app: ${r}:`+s))}analytics.initSession=function(e,t,n,a,o,i){if(!e||!t)throw new Error("accountID and appName must exist for init");c=n?n.replace(/\/$/,""):g,r=e,s=t,I=i||!1,l=a||y,u=o||v,f=c+"/ingest",T(),d=S(),k(),A(a,o)},analytics.getCurrentAnalyticsEvent=function(){return E(),JSON.parse(JSON.stringify(d))},analytics.event=function(n,a,o,i=1,r=0){if(!C){var s=n,l=a,u=o,c=i,f=r;if(E(),!s||!l||!u)throw new Error("missing eventType or category or subCategory");if("number"!=typeof c||c<0)throw new Error("invalid count");if("number"!=typeof f)throw new Error("invalid value");{s=n;l=a;u=o;let e=d.events;e[s]=e[s]||{},e[s][l]=e[s][l]||{},e[s][l][u]=e[s][l][u]||{time:[],valueCount:[]}}let t=d.events;c=t[n][a][o].time;if((0<c.length?c[c.length-1]:null)===w){f=t[n][a][o].valueCount.length-1;{var s=f,l=n,u=a,c=o,f=i,v=r;let t=d.events;var e="number"==typeof t[l][u][c].valueCount[s];if(e&&0===v)t[l][u][c].valueCount[s]+=f;else if(e&&0!==v){let e={};e[v]=f,e[0]=t[l][u][c].valueCount[s],t[l][u][c].valueCount[s]=e}else if(!e){let e=t[l][u][c].valueCount[s];e[v]=(e[v]||0)+f}d.numEventsTotal+=1}}else{if(t[n][a][o].time.push(w),0===r)t[n][a][o].valueCount.push(i);else{let e={};e[r]=i,t[n][a][o].valueCount.push(e)}d.numEventsTotal+=1}}},analytics.getAppConfig=function(){return{accountID:r,appName:s,disabled:C,uuid:e,sessionID:t,postIntervalSeconds:l,granularitySec:u,analyticsURL:c,serverConfig:n}}}init();
+function initAnalyticsSession(e,t,n,a,o,i){let s,r,l,u,c,f,d,v,y={};const g="aicore.analytics.userID",m="aicore.analytics.sessionID",p=1e4;let h=null;var w,b="undefined"==typeof window;let C="https://analytics.core.ai",I,S,D=0,E=!1,T=!1;function N(...e){T&&console.log("analytics client: ",...e)}function $(...e){T&&console.error("analytics client: ",...e)}if(b)throw new Error("Node environment is not currently supported");function k(){return{schemaVersion:1,accountID:s,appName:r,uuid:l,sessionID:u,unixTimestampUTC:+new Date,numEventsTotal:0,events:{}}}function A(){if(!h)throw new Error("Please call initSession before using any analytics event")}function L(e){e.backoffCount=(e.backoffCount||0)+1,N(`Failed to call core analytics server. Will retry in ${30*e.backoffCount}s: `),setTimeout(()=>{U(e)},3e4*e.backoffCount)}function O(t){var e,n=JSON.stringify(t);n.length>p&&console.warn(`Analytics event generated is very large at greater than ${n.length}B. This 
+        typically means that you may be sending too many value events? .`),N("Sending Analytics data of length: ",n.length,"B"),e=["Sending data:",n],T&&window.analytics.debugInfoLogsEnable&&console.info("analytics client: ",...e),window.navigator.onLine?window.fetch(v,{method:"POST",headers:{"Content-Type":"application/json"},body:n}).then(e=>{200!==e.status&&(400!==e.status?L(t):console.error("Bad Request, this is most likely a problem with the library, update to latest version."))}).catch(e=>{$(e),L(t)}):L(t)}function U(e){E||(e||(e=h,D=0,R(),h=k()),0!==e.numEventsTotal&&O(e))}function R(e){I&&(clearInterval(I),I=null),e||(I=setInterval(()=>{D+=f},1e3*f))}function _(e){R(e),S&&(clearInterval(S),S=null),e||(S=setInterval(U,1e3*c))}function B(n,a,o,i=1,s=0){if(!E){var r=n,l=a,u=o,c=i,f=s;if(A(),!r||!l||!u)throw new Error("missing eventType or category or subCategory");if("number"!=typeof c||c<0)throw new Error("invalid count, count should be a positive number");if("number"!=typeof f)throw new Error("invalid value, value should be a number");{r=n;l=a;u=o;let e=h.events;e[r]=e[r]||{},e[r][l]=e[r][l]||{},e[r][l][u]=e[r][l][u]||{time:[],valueCount:[]}}let t=h.events;c=t[n][a][o].time;if((0<c.length?c[c.length-1]:null)===D){f=t[n][a][o].valueCount.length-1;{var r=f,l=n,u=a,c=o,f=i,d=s;let t=h.events;var e="number"==typeof t[l][u][c].valueCount[r];if(e&&0===d)t[l][u][c].valueCount[r]+=f;else if(e&&0!==d){let e={};e[d]=f,e[0]=t[l][u][c].valueCount[r],t[l][u][c].valueCount[r]=e}else if(!e){let e=t[l][u][c].valueCount[r];e[d]=(e[d]||0)+f}h.numEventsTotal+=1}}else{if(t[n][a][o].time.push(D),0===s)t[n][a][o].valueCount.push(i);else{let e={};e[s]=i,t[n][a][o].valueCount.push(e)}h.numEventsTotal+=1}}}if(!e||!t)throw new Error("accountID and appName must exist for init");d=n?n.replace(/\/$/,""):C,s=e,r=t,T=i||!1,c=a||60,f=o||3,v=d+"/ingest",l=function(){let e=localStorage.getItem(g);return e||(e=crypto.randomUUID(),localStorage.setItem(g,e)),e}(),u=function(){let e=sessionStorage.getItem(m);return e||(e=Math.random().toString(36).substr(2,10),sessionStorage.setItem(m,e)),e}(),h=k(),_(),async function(e,t){(y=await new Promise(n=>{var e;window.navigator.onLine?(e=d+(`/getAppConfig?accountID=${s}&appName=`+r),window.fetch(e).then(async e=>{switch(e.status){case 200:var t=await e.json();return void n(t);case 400:$("Bad Request, check library version compatible?",e),n({});break;default:$("Could not update from remote config. Continuing with defaults.",e),n({})}}).catch(e=>{$("Could not update from remote config. Continuing with defaults.",e),n({})})):n({})}))!=={}&&(c=e||y.postIntervalSecondsInit||60,f=t||y.granularitySecInit||3,d=y.analyticsURLInit||d||C,_(E=!0===y.disabled),N(`Init analytics Config from remote. disabled: ${E}
+        postIntervalSeconds:${c}, granularitySec: ${f} ,URL: `+d),E&&console.warn(`Core Analytics is disabled from the server for app: ${s}:`+r))}(a,o);for(w of analytics._initData)B(...w);analytics._initData=[],analytics._getCurrentAnalyticsEvent=function(){return A(),JSON.parse(JSON.stringify(h))},analytics._getAppConfig=function(){return{accountID:s,appName:r,disabled:E,uuid:l,sessionID:u,postIntervalSeconds:c,granularitySec:f,analyticsURL:d,serverConfig:y}},analytics.event=B}window.analytics||(window.analytics={_initData:[]});
 //# sourceMappingURL=analytics.min.js.map

package/dist/analytics.min.js.map

@@ -1 +1 @@
-{"version":3,"sourceRoot":"src/analytics.js","sources":["src/analytics.js"],"names":["analytics","init","let","accountID","appName","userID","sessionID","postIntervalSeconds","granularitySec","analyticsURL","postURL","serverConfig","DEFAULT_GRANULARITY_IN_SECONDS","DEFAULT_RETRY_TIME_IN_SECONDS","DEFAULT_POST_INTERVAL_SECONDS","USERID_LOCAL_STORAGE_KEY","POST_LARGE_DATA_THRESHOLD_BYTES","currentAnalyticsEvent","IS_NODE_ENV","window","DEFAULT_BASE_URL","granularityTimer","postTimer","currentQuantisedTime","disabled","debugMode","debugLog","args","console","log","Error","_createAnalyticsEvent","schemaVersion","uuid","unixTimestampUTC","Date","numEventsTotal","events","_validateCurrentState","_setupIDs","localUserID","localStorage","getItem","crypto","randomUUID","setItem","_getOrCreateUserID","localSessionID","sessionStorage","Math","random","toString","substr","_getOrCreateSessionID","_retryPost","eventToSend","backoffCount","setTimeout","_postCurrentAnalyticsEvent","textToSend","_resetGranularityTimer","JSON","stringify","length","warn","fetch","method","headers","Content-Type","body","then","res","status","error","catch","debugError","disable","clearInterval","setInterval","_setupTimers","async","_initFromRemoteConfig","postIntervalSecondsInit","granularitySecInit","Promise","resolve","reject","configURL","serverResponse","json","err","initSession","accountIDInit","appNameInit","analyticsURLInit","debug","replace","getCurrentAnalyticsEvent","parse","event","eventType","eventCategory","subCategory","eventCount","eventValue","_validateEvent","category","count","value","_ensureAnalyticsEventExists","time","valueCount","timeArray","modificationIndex","_updateExistingAnalyticsEvent","index","newValue","storedValueIsCount","newValueCount","storedValueObject","push","getAppConfig"],"mappings":"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"}
+{"version":3,"sourceRoot":"src/analytics.js","sources":["src/analytics.js"],"names":["initAnalyticsSession","accountIDInit","appNameInit","analyticsURLInit","postIntervalSecondsInit","granularitySecInit","debug","let","accountID","appName","userID","sessionID","postIntervalSeconds","granularitySec","analyticsURL","postURL","serverConfig","USERID_LOCAL_STORAGE_KEY","SESSION_ID_LOCAL_STORAGE_KEY","POST_LARGE_DATA_THRESHOLD_BYTES","currentAnalyticsEvent","eventData","IS_NODE_ENV","window","DEFAULT_BASE_URL","granularityTimer","postTimer","currentQuantisedTime","disabled","debugMode","debugLog","args","console","log","debugError","error","Error","_createAnalyticsEvent","schemaVersion","uuid","unixTimestampUTC","Date","numEventsTotal","events","_validateCurrentState","_retryPost","eventToSend","backoffCount","setTimeout","_postCurrentAnalyticsEvent","DEFAULT_RETRY_TIME_IN_SECONDS","_postEventWithRetry","textToSend","JSON","stringify","length","warn","debugInfo","analytics","debugInfoLogsEnable","info","navigator","onLine","fetch","method","headers","Content-Type","body","then","res","status","catch","_resetGranularityTimer","disable","clearInterval","setInterval","_setupTimers","event","eventType","eventCategory","subCategory","eventCount","eventValue","_validateEvent","category","count","value","_ensureAnalyticsEventExists","time","valueCount","timeArray","modificationIndex","_updateExistingAnalyticsEvent","index","newValue","storedValueIsCount","newValueCount","storedValueObject","push","replace","localUserID","localStorage","getItem","crypto","randomUUID","setItem","_getOrCreateUserID","localSessionID","sessionStorage","Math","random","toString","substr","_getOrCreateSessionID","async","postIntervalSecondsInitial","granularitySecInitial","Promise","configURL","serverResponse","json","resolve","err","_initFromRemoteConfig","_initData","_getCurrentAnalyticsEvent","parse","_getAppConfig"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicore/core-analytics-client-lib",
-  "version": "1.0.5",
+  "version": "1.0.8",
   "description": "Analytics client library for https://github.com/aicore/Core-Analytics-Server",
   "main": "dist/analytics.min.js",
   "type": "module",

package/src/analytics.js

@@ -1,16 +1,36 @@
 // GNU AGPL-3.0 License Copyright (c) 2021 - present core.ai . All rights reserved.
 
 // jshint ignore: start
-/*global localStorage, sessionStorage, crypto*/
+/*global localStorage, sessionStorage, crypto, analytics*/
 
-var analytics = {};
 
-function init() {
-    let accountID, appName, userID, sessionID, postIntervalSeconds, granularitySec, analyticsURL, postURL, serverConfig;
+if(!window.analytics){
+    window.analytics = {
+        _initData: []
+    };
+}
+
+/**
+ * Initialize the analytics session
+ * @param accountIDInit Your analytics account id as configured in the server or core.ai analytics
+ * @param appNameInit The app name to log the events against.
+ * @param analyticsURLInit Optional: Provide your own analytics server address if you self-hosted the server.
+ * @param postIntervalSecondsInit Optional: This defines the interval between sending analytics events to the server.
+ * Default is 1 minutes or server controlled.
+ * @param granularitySecInit Optional: The smallest time period under which the events can be distinguished. Multiple
+ * events happening during this time period is aggregated to a count. The default granularity is 3 Seconds or server
+ * controlled, which means that any events that happen within 3 seconds cannot be distinguished in ordering.
+ * @param debug set to true if you want to see detailed debug logs.
+ */
+function initAnalyticsSession(accountIDInit, appNameInit, analyticsURLInit,
+    postIntervalSecondsInit, granularitySecInit, debug) {
+    let accountID, appName, userID, sessionID, postIntervalSeconds,
+        granularitySec, analyticsURL, postURL, serverConfig={};
     const DEFAULT_GRANULARITY_IN_SECONDS = 3;
     const DEFAULT_RETRY_TIME_IN_SECONDS = 30;
-    const DEFAULT_POST_INTERVAL_SECONDS = 600; // 10 minutes
+    const DEFAULT_POST_INTERVAL_SECONDS = 60; // 1 minutes
     const USERID_LOCAL_STORAGE_KEY = 'aicore.analytics.userID';
+    const SESSION_ID_LOCAL_STORAGE_KEY = 'aicore.analytics.sessionID';
     const POST_LARGE_DATA_THRESHOLD_BYTES = 10000;
     let currentAnalyticsEvent = null;
     const IS_NODE_ENV = (typeof window === 'undefined');
@@ -26,14 +46,20 @@ function init() {
         if(!debugMode){
             return;
         }
-        console.log(...args);
+        console.log("analytics client: ", ...args);
+    }
+
+    function debugInfo(...args) {
+        if(debugMode && window.analytics.debugInfoLogsEnable){
+            console.info("analytics client: ", ...args);
+        }
     }
 
     function debugError(...args) {
         if(!debugMode){
             return;
         }
-        console.error(...args);
+        console.error("analytics client: ", ...args);
     }
 
 
@@ -60,7 +86,7 @@ function init() {
         }
     }
 
-    function getCurrentAnalyticsEvent() {
+    function _getCurrentAnalyticsEvent() {
         _validateCurrentState();
         // return a clone
         return JSON.parse(JSON.stringify(currentAnalyticsEvent));
@@ -76,10 +102,10 @@ function init() {
     }
 
     function _getOrCreateSessionID() {
-        let localSessionID = sessionStorage.getItem(USERID_LOCAL_STORAGE_KEY);
+        let localSessionID = sessionStorage.getItem(SESSION_ID_LOCAL_STORAGE_KEY);
         if(!localSessionID){
             localSessionID = Math.random().toString(36).substr(2, 10);
-            sessionStorage.setItem(USERID_LOCAL_STORAGE_KEY, localSessionID);
+            sessionStorage.setItem(SESSION_ID_LOCAL_STORAGE_KEY, localSessionID);
         }
         return localSessionID;
     }
@@ -98,25 +124,20 @@ function init() {
         }, DEFAULT_RETRY_TIME_IN_SECONDS * 1000 * eventToSend.backoffCount);
     }
 
-    function _postCurrentAnalyticsEvent(eventToSend) {
-        if(disabled){
-            return;
-        }
-        if(!eventToSend){
-            eventToSend = currentAnalyticsEvent;
-            currentQuantisedTime = 0;
-            _resetGranularityTimer();
-            currentAnalyticsEvent = _createAnalyticsEvent();
-        }
-        if(eventToSend.numEventsTotal === 0 ){
-            return;
-        }
+    function _postEventWithRetry(eventToSend) {
         let textToSend = JSON.stringify(eventToSend);
         if(textToSend.length > POST_LARGE_DATA_THRESHOLD_BYTES){
             console.warn(`Analytics event generated is very large at greater than ${textToSend.length}B. This 
         typically means that you may be sending too many value events? .`);
         }
         debugLog("Sending Analytics data of length: ", textToSend.length, "B");
+        debugInfo("Sending data:", textToSend);
+        if(!window.navigator.onLine){
+            _retryPost(eventToSend);
+            // chrome shows all network failure requests in console. In offline mode, we don't want to bomb debug
+            // console with network failure messages for analytics. So we prevent network requests when offline.
+            return;
+        }
         window.fetch(postURL, {
             method: "POST",
             headers: {'Content-Type': 'application/json'},
@@ -128,8 +149,7 @@ function init() {
             if(res.status !== 400){ // we don't retry bad requests
                 _retryPost(eventToSend);
             } else {
-                console.error("Analytics client: " +
-                    "Bad Request, this is most likely a problem with the library, update to latest version.");
+                console.error("Bad Request, this is most likely a problem with the library, update to latest version.");
             }
         }).catch(res => {
             debugError(res);
@@ -137,6 +157,22 @@ function init() {
         });
     }
 
+    function _postCurrentAnalyticsEvent(eventToSend) {
+        if(disabled){
+            return;
+        }
+        if(!eventToSend){
+            eventToSend = currentAnalyticsEvent;
+            currentQuantisedTime = 0;
+            _resetGranularityTimer();
+            currentAnalyticsEvent = _createAnalyticsEvent();
+        }
+        if(eventToSend.numEventsTotal === 0 ){
+            return;
+        }
+        _postEventWithRetry(eventToSend);
+    }
+
     function _resetGranularityTimer(disable) {
         if(granularityTimer){
             clearInterval(granularityTimer);
@@ -163,7 +199,13 @@ function init() {
     }
 
     async function _getServerConfig() {
-        return new Promise((resolve, reject)=>{
+        return new Promise((resolve)=>{
+            if(!window.navigator.onLine){
+                resolve({});
+                // chrome shows all network failure requests in console. In offline mode, we don't want to bomb debug
+                // console with network failure messages for analytics. So we prevent network requests when offline.
+                return;
+            }
             let configURL = analyticsURL + `/getAppConfig?accountID=${accountID}&appName=${appName}`;
             window.fetch(configURL).then(async res=>{
                 switch (res.status) {
@@ -172,13 +214,16 @@ function init() {
                     resolve(serverResponse);
                     return;
                 case 400:
-                    reject("Bad Request, check library version compatible?", res);
+                    debugError("Bad Request, check library version compatible?", res);
+                    resolve({});
                     break;
                 default:
-                    reject("analytics client: Could not update from remote config. Continuing with defaults.", res);
+                    debugError("Could not update from remote config. Continuing with defaults.", res);
+                    resolve({});
                 }
             }).catch(err => {
-                reject("analytics client: Could not update from remote config. Continuing with defaults.", err);
+                debugError("Could not update from remote config. Continuing with defaults.", err);
+                resolve({});
             });
         });
     }
@@ -187,7 +232,7 @@ function init() {
      * Returns the analytics config for the app
      * @returns {Object}
      */
-    function getAppConfig() {
+    function _getAppConfig() {
         return {
             accountID, appName, disabled,
             uuid: userID, sessionID,
@@ -195,13 +240,13 @@ function init() {
         };
     }
 
-    async function _initFromRemoteConfig(postIntervalSecondsInit, granularitySecInit) {
+    async function _initFromRemoteConfig(postIntervalSecondsInitial, granularitySecInitial) {
         serverConfig = await _getServerConfig();
         if(serverConfig !== {}){
             // User init overrides takes precedence over server overrides
-            postIntervalSeconds = postIntervalSecondsInit ||
+            postIntervalSeconds = postIntervalSecondsInitial ||
                 serverConfig["postIntervalSecondsInit"] || DEFAULT_POST_INTERVAL_SECONDS;
-            granularitySec = granularitySecInit || serverConfig["granularitySecInit"] || DEFAULT_GRANULARITY_IN_SECONDS;
+            granularitySec = granularitySecInitial || serverConfig["granularitySecInit"] || DEFAULT_GRANULARITY_IN_SECONDS;
             // For URLs, the server suggested URL takes precedence over user init values
             analyticsURL = serverConfig["analyticsURLInit"] || analyticsURL || DEFAULT_BASE_URL;
             disabled = serverConfig["disabled"] === true;
@@ -218,35 +263,6 @@ function init() {
         return url.replace(/\/$/, "");
     }
 
-    /**
-     * Initialize the analytics session
-     * @param accountIDInit Your analytics account id as configured in the server or core.ai analytics
-     * @param appNameInit The app name to log the events against.
-     * @param analyticsURLInit Optional: Provide your own analytics server address if you self-hosted the server
-     * @param postIntervalSecondsInit Optional: This defines the interval between sending analytics events to the server.
-     * Default is 10 minutes
-     * @param granularitySecInit Optional: The smallest time period under which the events can be distinguished. Multiple
-     * events happening during this time period is aggregated to a count. The default granularity is 3 Seconds, which means
-     * that any events that happen within 3 seconds cannot be distinguished in ordering.
-     * @param debug set to true if you want to see detailed debug logs.
-     */
-    function initSession(accountIDInit, appNameInit, analyticsURLInit, postIntervalSecondsInit, granularitySecInit, debug) {
-        if(!accountIDInit || !appNameInit){
-            throw new Error("accountID and appName must exist for init");
-        }
-        analyticsURL = analyticsURLInit? _stripTrailingSlash(analyticsURLInit) : DEFAULT_BASE_URL;
-        accountID = accountIDInit;
-        appName = appNameInit;
-        debugMode = debug || false;
-        postIntervalSeconds = postIntervalSecondsInit || DEFAULT_POST_INTERVAL_SECONDS;
-        granularitySec = granularitySecInit || DEFAULT_GRANULARITY_IN_SECONDS;
-        postURL = analyticsURL + "/ingest";
-        _setupIDs();
-        currentAnalyticsEvent = _createAnalyticsEvent();
-        _setupTimers();
-        _initFromRemoteConfig(postIntervalSecondsInit, granularitySecInit);
-    }
-
     function _ensureAnalyticsEventExists(eventType, category, subCategory) {
         let events = currentAnalyticsEvent.events;
         events[eventType] = events[eventType] || {};
@@ -263,10 +279,10 @@ function init() {
             throw new Error("missing eventType or category or subCategory");
         }
         if(typeof(count)!== 'number' || count <0){
-            throw new Error("invalid count");
+            throw new Error("invalid count, count should be a positive number");
         }
         if(typeof(value)!== 'number'){
-            throw new Error("invalid value");
+            throw new Error("invalid value, value should be a number");
         }
     }
 
@@ -321,10 +337,35 @@ function init() {
         _updateExistingAnalyticsEvent(modificationIndex, eventType, eventCategory, subCategory, eventCount, eventValue);
     }
 
-    analytics.initSession = initSession;
-    analytics.getCurrentAnalyticsEvent = getCurrentAnalyticsEvent;
+    // Init Analytics
+    if(!accountIDInit || !appNameInit){
+        throw new Error("accountID and appName must exist for init");
+    }
+    analyticsURL = analyticsURLInit? _stripTrailingSlash(analyticsURLInit) : DEFAULT_BASE_URL;
+    accountID = accountIDInit;
+    appName = appNameInit;
+    debugMode = debug || false;
+    postIntervalSeconds = postIntervalSecondsInit || DEFAULT_POST_INTERVAL_SECONDS;
+    granularitySec = granularitySecInit || DEFAULT_GRANULARITY_IN_SECONDS;
+    postURL = analyticsURL + "/ingest";
+    _setupIDs();
+    currentAnalyticsEvent = _createAnalyticsEvent();
+    _setupTimers();
+    _initFromRemoteConfig(postIntervalSecondsInit, granularitySecInit);
+
+    // As analytics lib load is async, our loading scripts will push event data into initData array till the lib load
+    // is complete. Now as load is done, we need to push these pending analytics events. Assuming that the async load of
+    // the lib should mostly happen under a second, we should not lose any accuracy of event times within the initial
+    // 3-second granularity. For more precision use cases, load the lib sync.
+    for(let eventData of analytics._initData){
+        event(...eventData);
+    }
+    analytics._initData = [];
+
+    // Private API for tests
+    analytics._getCurrentAnalyticsEvent = _getCurrentAnalyticsEvent;
+    analytics._getAppConfig = _getAppConfig;
+
+    // Public API
     analytics.event = event;
-    analytics.getAppConfig = getAppConfig;
 }
-
-init();