@base44-preview/sdk 0.8.6-pr.57.0298afb → 0.8.6-pr.57.2eea21a

package/dist/client.js

@@ -124,6 +124,7 @@ export function createClient(config) {
             userAuthModule,
         }),
         cleanup: () => {
+            userModules.analytics.cleanup();
             if (socket) {
                 socket.disconnect();
             }

package/dist/client.types.d.ts

@@ -6,6 +6,7 @@ import type { ConnectorsModule } from "./modules/connectors.types.js";
 import type { FunctionsModule } from "./modules/functions.types.js";
 import type { AgentsModule } from "./modules/agents.types.js";
 import type { AppLogsModule } from "./modules/app-logs.types.js";
+import type { AnalyticsModule } from "./modules/analytics.types.js";
 /**
  * Options for creating a Base44 client.
  */
@@ -82,6 +83,8 @@ export interface Base44Client {
     agents: AgentsModule;
     /** {@link AppLogsModule | App logs module} for tracking app usage. */
     appLogs: AppLogsModule;
+    /** {@link AnalyticsModule | Analytics module} for tracking app usage. */
+    analytics: AnalyticsModule;
     /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */
     cleanup: () => void;
     /**

package/dist/modules/analytics.d.ts

@@ -1,6 +1,7 @@
 import { AxiosInstance } from "axios";
 import { TrackEventParams, AnalyticsModuleOptions } from "./analytics.types";
 import type { AuthModule } from "./auth.types";
+export declare const USER_HEARTBEAT_EVENT_NAME = "__user_heartbeat_event__";
 export interface AnalyticsModuleArgs {
     axiosClient: AxiosInstance;
     serverUrl: string;
@@ -9,5 +10,6 @@ export interface AnalyticsModuleArgs {
 }
 export declare const createAnalyticsModule: ({ axiosClient, serverUrl, appId, userAuthModule, }: AnalyticsModuleArgs) => {
     track: (params: TrackEventParams) => void;
+    cleanup: () => void;
 };
-export declare function getAnalyticsModuleOptionsFromUrlParams(): AnalyticsModuleOptions | undefined;
+export declare function getAnalyticsModuleOptionsFromLocalStorage(): AnalyticsModuleOptions | undefined;

package/dist/modules/analytics.js

@@ -1,4 +1,12 @@
-import { getSharedInstance, } from "../utils/singleton";
+import { getSharedInstance } from "../utils/sharedInstance";
+export const USER_HEARTBEAT_EVENT_NAME = "__user_heartbeat_event__";
+const defaultConfiguration = {
+    enabled: true,
+    maxQueueSize: 1000,
+    throttleTime: 1000,
+    batchSize: 30,
+    heartBeatInterval: 60 * 1000,
+};
 ///////////////////////////////////////////////
 //// shared queue for analytics events     ////
 ///////////////////////////////////////////////
@@ -7,32 +15,18 @@ const ANALYTICS_SHARED_STATE_NAME = "analytics";
 const analyticsSharedState = getSharedInstance(ANALYTICS_SHARED_STATE_NAME, () => ({
     requestsQueue: [],
     isProcessing: false,
+    isHeartBeatProcessing: false,
+    sessionContext: null,
+    config: {
+        ...defaultConfiguration,
+        ...getAnalyticsModuleOptionsFromLocalStorage(),
+    },
 }));
 export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthModule, }) => {
-    var _a;
     // prevent overflow of events //
-    const { enabled = true, maxQueueSize = 1000, throttleTime = 1000, batchSize = 30, } = (_a = getAnalyticsModuleOptionsFromUrlParams()) !== null && _a !== void 0 ? _a : {};
+    const { enabled, maxQueueSize, throttleTime, batchSize } = analyticsSharedState.config;
+    let clearHeartBeatProcessor = undefined;
     const trackBatchUrl = `${serverUrl}/api/apps/${appId}/analytics/track/batch`;
-    let sessionContext = null;
-    const getSessionContext = async () => {
-        if (sessionContext)
-            return sessionContext;
-        const user = await userAuthModule.me();
-        sessionContext = {
-            user_id: user.id,
-        };
-        return sessionContext;
-    };
-    const track = (params) => {
-        if (!enabled || analyticsSharedState.requestsQueue.length >= maxQueueSize) {
-            return;
-        }
-        const intrinsicData = getEventIntrinsicData();
-        analyticsSharedState.requestsQueue.push({
-            ...params,
-            ...intrinsicData,
-        });
-    };
     const batchRequestFallback = async (events) => {
         await axiosClient.request({
             method: "POST",
@@ -41,27 +35,53 @@ export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthM
         });
     };
     const flush = async (eventsData) => {
-        const sessionContext_ = sessionContext !== null && sessionContext !== void 0 ? sessionContext : (await getSessionContext());
+        const sessionContext_ = await getSessionContext(userAuthModule);
         const events = eventsData.map(transformEventDataToApiRequestData(sessionContext_));
         const beaconPayload = JSON.stringify({ events });
-        if (typeof navigator === "undefined" ||
-            beaconPayload.length > 60000 ||
-            !navigator.sendBeacon(trackBatchUrl, beaconPayload)) {
-            // beacon didn't work, fallback to axios
-            await batchRequestFallback(events);
+        try {
+            if (typeof navigator === "undefined" ||
+                beaconPayload.length > 60000 ||
+                !navigator.sendBeacon(trackBatchUrl, beaconPayload)) {
+                // beacon didn't work, fallback to axios
+                await batchRequestFallback(events);
+            }
+        }
+        catch (_a) {
+            // TODO: think about retries if needed
         }
     };
-    const onDocHidden = () => {
-        analyticsSharedState.isProcessing = false;
-        //  flush entire queue on visibility change and hope for the best //
-        const eventsData = analyticsSharedState.requestsQueue.splice(0);
-        flush(eventsData);
+    const startProcessing = () => {
+        if (!enabled)
+            return;
+        startAnalyticsProcessor(flush, {
+            throttleTime,
+            batchSize,
+        });
+    };
+    const track = (params) => {
+        if (!enabled || analyticsSharedState.requestsQueue.length >= maxQueueSize) {
+            return;
+        }
+        const intrinsicData = getEventIntrinsicData();
+        analyticsSharedState.requestsQueue.push({
+            ...params,
+            ...intrinsicData,
+        });
+        startProcessing();
     };
     const onDocVisible = () => {
         startAnalyticsProcessor(flush, {
             throttleTime,
             batchSize,
         });
+        clearHeartBeatProcessor = startHeartBeatProcessor(track);
+    };
+    const onDocHidden = () => {
+        stopAnalyticsProcessor();
+        //  flush entire queue on visibility change and hope for the best //
+        const eventsData = analyticsSharedState.requestsQueue.splice(0);
+        flush(eventsData);
+        clearHeartBeatProcessor === null || clearHeartBeatProcessor === void 0 ? void 0 : clearHeartBeatProcessor();
     };
     const onVisibilityChange = () => {
         if (typeof window === "undefined")
@@ -73,39 +93,58 @@ export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthM
             onDocVisible();
         }
     };
+    const cleanup = () => {
+        stopAnalyticsProcessor();
+        clearHeartBeatProcessor === null || clearHeartBeatProcessor === void 0 ? void 0 : clearHeartBeatProcessor();
+        if (typeof window !== "undefined") {
+            window.removeEventListener("visibilitychange", onVisibilityChange);
+        }
+    };
+    // start the flusing process ///
+    startProcessing();
+    // start the heart beat processor //
+    clearHeartBeatProcessor = startHeartBeatProcessor(track);
+    // start the visibility change listener //
     if (typeof window !== "undefined" && enabled) {
         window.addEventListener("visibilitychange", onVisibilityChange);
     }
-    // start analytics processor only if it's the first instance and analytics is enabled //
-    if (enabled) {
-        startAnalyticsProcessor(flush, {
-            throttleTime,
-            batchSize,
-        });
-    }
     return {
         track,
+        cleanup,
     };
 };
+function stopAnalyticsProcessor() {
+    analyticsSharedState.isProcessing = false;
+}
 async function startAnalyticsProcessor(handleTrack, options) {
     if (analyticsSharedState.isProcessing) {
+        // only one instance of the analytics processor can be running at a time //
         return;
     }
     analyticsSharedState.isProcessing = true;
     const { throttleTime = 1000, batchSize = 30 } = options !== null && options !== void 0 ? options : {};
-    while (analyticsSharedState.isProcessing) {
+    while (analyticsSharedState.isProcessing &&
+        analyticsSharedState.requestsQueue.length > 0) {
         const requests = analyticsSharedState.requestsQueue.splice(0, batchSize);
-        if (requests.length > 0) {
-            try {
-                await handleTrack(requests);
-            }
-            catch (error) {
-                // TODO: think about retries if needed
-                console.error("Error processing analytics request:", error);
-            }
-        }
+        requests.length && (await handleTrack(requests));
         await new Promise((resolve) => setTimeout(resolve, throttleTime));
     }
+    analyticsSharedState.isProcessing = false;
+}
+function startHeartBeatProcessor(track) {
+    var _a;
+    if (analyticsSharedState.isHeartBeatProcessing ||
+        ((_a = analyticsSharedState.config.heartBeatInterval) !== null && _a !== void 0 ? _a : 0) < 10) {
+        return () => { };
+    }
+    analyticsSharedState.isHeartBeatProcessing = true;
+    const interval = setInterval(() => {
+        track({ eventName: USER_HEARTBEAT_EVENT_NAME });
+    }, analyticsSharedState.config.heartBeatInterval);
+    return () => {
+        clearInterval(interval);
+        analyticsSharedState.isHeartBeatProcessing = false;
+    };
 }
 function getEventIntrinsicData() {
     return {
@@ -122,14 +161,30 @@ function transformEventDataToApiRequestData(sessionContext) {
         ...sessionContext,
     });
 }
-export function getAnalyticsModuleOptionsFromUrlParams() {
+let sessionContextPromise = null;
+async function getSessionContext(userAuthModule) {
+    if (!analyticsSharedState.sessionContext) {
+        if (!sessionContextPromise) {
+            sessionContextPromise = userAuthModule
+                .me()
+                .then((user) => ({
+                user_id: user.id,
+            }))
+                .catch(() => ({
+                user_id: "unknown: error getting session context",
+            }));
+        }
+        analyticsSharedState.sessionContext = await sessionContextPromise;
+    }
+    return analyticsSharedState.sessionContext;
+}
+export function getAnalyticsModuleOptionsFromLocalStorage() {
     if (typeof window === "undefined")
         return undefined;
-    const urlParams = new URLSearchParams(window.location.search);
-    const jsonString = urlParams.get("analytics");
-    if (!jsonString)
-        return undefined;
     try {
+        const jsonString = localStorage.getItem("base44_analytics_config");
+        if (!jsonString)
+            return undefined;
         return JSON.parse(jsonString);
     }
     catch (_a) {

package/dist/modules/analytics.types.d.ts

@@ -34,4 +34,8 @@ export type AnalyticsModuleOptions = {
     maxQueueSize?: number;
     throttleTime?: number;
     batchSize?: number;
+    heartBeatInterval?: number;
+};
+export type AnalyticsModule = {
+    track: (params: TrackEventParams) => void;
 };

package/dist/utils/{singleton.d.ts → sharedInstance.d.ts}

@@ -1,2 +1 @@
 export declare function getSharedInstance<T>(name: string, factory: () => T): T;
-export declare function getSharedInstanceRefCount<T>(name: string): number;

package/dist/utils/{singleton.js → sharedInstance.js}

@@ -9,13 +9,7 @@ export function getSharedInstance(name, factory) {
     if (!windowObj.base44SharedInstances[name]) {
         windowObj.base44SharedInstances[name] = {
             instance: factory(),
-            _refCount: 0,
         };
     }
-    windowObj.base44SharedInstances[name]._refCount++;
     return windowObj.base44SharedInstances[name].instance;
 }
-export function getSharedInstanceRefCount(name) {
-    var _a, _b, _c;
-    return (_c = (_b = (_a = windowObj.base44SharedInstances) === null || _a === void 0 ? void 0 : _a[name]) === null || _b === void 0 ? void 0 : _b._refCount) !== null && _c !== void 0 ? _c : 0;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.6-pr.57.0298afb",
+  "version": "0.8.6-pr.57.2eea21a",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",