@aicore/core-analytics-client-lib 1.0.11 → 2.0.0

package/dist/analytics.min.js

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

package/dist/analytics.min.js.map

@@ -1 +1 @@
-{"version":3,"sourceRoot":"src/analytics.js","sources":["src/analytics.js"],"names":["initAnalyticsSession","accountIDInit","appNameInit","analyticsURLInit","postIntervalSecondsInit","granularitySecInit","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","postIntervalSecondsInitial","granularitySecInitial","eventData","IS_NODE_ENV","window","DEFAULT_BASE_URL","granularityTimer","postTimer","currentQuantisedTime","disabled","debugLog","args","analytics","debugMode","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","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","toString","replace","localUserID","localStorage","getItem","crypto","randomUUID","setItem","_getOrCreateUserID","localSessionID","sessionStorage","Math","random","substr","_getOrCreateSessionID","Promise","configURL","json","serverResponse","resolve","err","updatedServerConfig","_initData","_getCurrentAnalyticsEvent","parse","_getAppConfig","c","getRandomValues","Uint8Array"],"mappings":"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"}
+{"version":3,"sourceRoot":"src/analytics.js","sources":["src/analytics.js"],"names":["initAnalyticsSession","accountIDInit","appNameInit","analyticsURLInit","postIntervalSecondsInit","granularitySecInit","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","postIntervalSecondsInitial","granularitySecInitial","eventData","IS_NODE_ENV","window","DEFAULT_BASE_URL","granularityTimer","postTimer","currentQuantisedTime","disabled","debugLog","args","analytics","debugMode","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","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","time","valueCount","eventItem","timeArray","push","modificationIndex","index","newValue","storedValueIsCount","newValueCount","storedValueObject","toString","replace","localUserID","localStorage","getItem","crypto","randomUUID","setItem","localSessionID","sessionStorage","Math","random","substr","Promise","configURL","json","serverResponse","resolve","err","updatedServerConfig","_initData","_getCurrentAnalyticsEvent","parse","_getAppConfig","countEvent","valueEvent","c","getRandomValues","Uint8Array"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicore/core-analytics-client-lib",
-  "version": "1.0.11",
+  "version": "2.0.0",
   "description": "Analytics client library for https://github.com/aicore/Core-Analytics-Server",
   "main": "dist/analytics.min.js",
   "type": "module",
@@ -47,14 +47,14 @@
   },
   "homepage": "https://github.com/aicore/core-analytics-client-lib#readme",
   "devDependencies": {
-    "@commitlint/cli": "17.0.2",
-    "@commitlint/config-conventional": "17.0.2",
-    "c8": "7.11.3",
-    "chai": "4.3.6",
-    "eslint": "8.16.0",
-    "husky": "7.0.4",
-    "mocha": "9.2.2",
-    "uglify-js": "3.15.5",
+    "@commitlint/cli": "17.5.1",
+    "@commitlint/config-conventional": "17.4.4",
+    "c8": "7.13.0",
+    "chai": "4.3.7",
+    "eslint": "8.37.0",
+    "husky": "8.0.3",
+    "mocha": "10.2.0",
+    "uglify-js": "3.17.4",
     "http-server": "14.1.1"
   }
 }

package/src/analytics.js

@@ -311,16 +311,17 @@ function initAnalyticsSession(accountIDInit, appNameInit, analyticsURLInit,
 
     function _updateExistingAnalyticsEvent(index, eventType, category, subCategory, count, newValue) {
         let events = currentAnalyticsEvent.events;
-        const storedValueIsCount = typeof(events[eventType][category][subCategory]["valueCount"][index]) === 'number';
+        const eventItem = events[eventType][category][subCategory];
+        const storedValueIsCount = typeof(eventItem.valueCount[index]) === 'number';
         if(storedValueIsCount && newValue === 0){
-            events[eventType][category][subCategory]["valueCount"][index] += count;
+            eventItem.valueCount[index] += count;
         } else if(storedValueIsCount && newValue !== 0){
             let newValueCount = {};
             newValueCount[newValue] = count;
-            newValueCount[0] = events[eventType][category][subCategory]["valueCount"][index];
-            events[eventType][category][subCategory]["valueCount"][index] = newValueCount;
+            newValueCount[0] = eventItem.valueCount[index];
+            eventItem.valueCount[index] = newValueCount;
         } else if(!storedValueIsCount){
-            let storedValueObject = events[eventType][category][subCategory]["valueCount"][index];
+            let storedValueObject = eventItem.valueCount[index];
             storedValueObject[newValue] = (storedValueObject[newValue] || 0) + count;
         }
         currentAnalyticsEvent.numEventsTotal += 1;
@@ -342,24 +343,69 @@ function initAnalyticsSession(accountIDInit, appNameInit, analyticsURLInit,
         _validateEvent(eventType, eventCategory, subCategory, eventCount, eventValue);
         _ensureAnalyticsEventExists(eventType, eventCategory, subCategory);
         let events = currentAnalyticsEvent.events;
-        let timeArray = events[eventType][eventCategory][subCategory]["time"];
+        const eventItem = events[eventType][eventCategory][subCategory];
+        let timeArray = eventItem.time;
         let lastTime = timeArray.length>0? timeArray[timeArray.length-1] : null;
         if(lastTime !== currentQuantisedTime){
-            events[eventType][eventCategory][subCategory]["time"].push(currentQuantisedTime);
+            timeArray.push(currentQuantisedTime);
             if(eventValue===0){
-                events[eventType][eventCategory][subCategory]["valueCount"].push(eventCount);
+                eventItem.valueCount.push(eventCount);
             } else {
                 let valueCount = {};
                 valueCount[eventValue] = eventCount;
-                events[eventType][eventCategory][subCategory]["valueCount"].push(valueCount);
+                eventItem.valueCount.push(valueCount);
             }
             currentAnalyticsEvent.numEventsTotal += 1;
             return;
         }
-        let modificationIndex = events[eventType][eventCategory][subCategory]["valueCount"].length -1;
+        let modificationIndex = eventItem.valueCount.length - 1;
         _updateExistingAnalyticsEvent(modificationIndex, eventType, eventCategory, subCategory, eventCount, eventValue);
     }
 
+    /**
+     * Counts the occurrence of a specific event. Use this to track how many times something happens.
+     * Events are aggregated and periodically sent to the analytics server.
+     *
+     * @example
+     * // Count a single occurrence of a button click
+     * analytics.countEvent("ui", "button", "save");
+     *
+     * // Count multiple occurrences at once (e.g., 5 items were deleted in a batch)
+     * analytics.countEvent("action", "delete", "files", 5);
+     *
+     * @param {string} eventType - The type of the event (e.g., "ui", "action", "lifecycle").
+     * @param {string} eventCategory - The category of the event (e.g., "button", "menu", "startup").
+     * @param {string} subCategory - The subcategory of the event (e.g., "save", "open", "click").
+     * @param {number} [eventCount=1] - The number of occurrences to count. Must be a non-negative number.
+     */
+    function countEvent(eventType, eventCategory, subCategory, eventCount = 1) {
+        return event(eventType, eventCategory, subCategory, eventCount, 0);
+    }
+
+    /**
+     * Tracks an event with an associated numeric value. Use this to measure quantities like latencies,
+     * durations, sizes, or anything where you need running averages and distributions.
+     *
+     * @example
+     * // Track an API response time of 250ms
+     * analytics.valueEvent("performance", "api", "getUserData", 250);
+     *
+     * // Track a file size of 1024 bytes
+     * analytics.valueEvent("resource", "file", "upload", 1024);
+     *
+     * // Track that a 300ms latency occurred 10 times (e.g., from a pre-aggregated batch)
+     * analytics.valueEvent("performance", "api", "listItems", 300, 10);
+     *
+     * @param {string} eventType - The type of the event (e.g., "performance", "resource", "usage").
+     * @param {string} eventCategory - The category of the event (e.g., "api", "file", "memory").
+     * @param {string} subCategory - The subcategory of the event (e.g., "upload", "render", "query").
+     * @param {number} [eventValue=0] - The numeric value to associate with the event.
+     * @param {number} [count=1] - The number of times this value occurred. Must be a non-negative number.
+     */
+    function valueEvent(eventType, eventCategory, subCategory, eventValue = 0, count = 1) {
+        return event(eventType, eventCategory, subCategory, count, eventValue);
+    }
+
     // Init Analytics
     if(!accountIDInit || !appNameInit){
         throw new Error("accountID and appName must exist for init");
@@ -389,5 +435,6 @@ function initAnalyticsSession(accountIDInit, appNameInit, analyticsURLInit,
     analytics._getAppConfig = _getAppConfig;
 
     // Public API
-    analytics.event = event;
+    analytics.countEvent = countEvent;
+    analytics.valueEvent = valueEvent;
 }