@base44-preview/sdk 0.8.12-pr.63.3980328 → 0.8.12-pr.63.4708bce

package/dist/client.js

@@ -47,7 +47,11 @@ import { createAnalyticsModule } from "./modules/analytics.js";
  * ```
  */
 export function createClient(config) {
-    const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, } = config;
+    const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, useStagingDb: configUseStagingDb = false, } = config;
+    // URL param is source of truth for staging DB in browser
+    const urlHasStagingDb = typeof window !== "undefined"
+        && new URLSearchParams(window.location.search).get("use_staging_db") === "true";
+    const useStagingDb = urlHasStagingDb || configUseStagingDb;
     const socketConfig = {
         serverUrl,
         mountPath: "/ws-user-apps/socket.io/",
@@ -67,6 +71,7 @@ export function createClient(config) {
     const headers = {
         ...optionalHeaders,
         "X-App-Id": String(appId),
+        "Base44-Use-Staging-DB": String(useStagingDb),
     };
     const functionHeaders = functionsVersion
         ? {
@@ -299,6 +304,7 @@ export function createClientFromRequest(request) {
     const appId = request.headers.get("Base44-App-Id");
     const serverUrlHeader = request.headers.get("Base44-Api-Url");
     const functionsVersion = request.headers.get("Base44-Functions-Version");
+    const useStagingDb = request.headers.get("Base44-Use-Staging-DB") === "true";
     const stateHeader = request.headers.get("Base44-State");
     if (!appId) {
         throw new Error("Base44-App-Id header is required, but is was not found on the request");
@@ -333,6 +339,7 @@ export function createClientFromRequest(request) {
         token: userToken,
         serviceToken: serviceRoleToken,
         functionsVersion: functionsVersion !== null && functionsVersion !== void 0 ? functionsVersion : undefined,
+        useStagingDb: useStagingDb !== null && useStagingDb !== void 0 ? useStagingDb : undefined,
         headers: additionalHeaders,
     });
 }

package/dist/client.types.d.ts

@@ -60,6 +60,11 @@ export interface CreateClientConfig {
      * @internal
      */
     headers?: Record<string, string>;
+    /**
+     * Whether to use the staging database. Defaults to false.
+     * When true, API requests will use the staging database instead of production.
+     */
+    useStagingDb?: boolean;
     /**
      * Additional client options.
      */

package/dist/modules/analytics.d.ts

@@ -2,6 +2,8 @@ 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 declare const ANALYTICS_INITIALIZATION_EVENT_NAME = "__initialization_event__";
+export declare const ANALYTICS_SESSION_DURATION_EVENT_NAME = "__session_duration_event__";
 export declare const ANALYTICS_CONFIG_ENABLE_URL_PARAM_KEY = "analytics-enable";
 export declare const ANALYTICS_SESSION_ID_LOCAL_STORAGE_KEY = "base44_analytics_session_id";
 export interface AnalyticsModuleArgs {

package/dist/modules/analytics.js

@@ -1,6 +1,8 @@
 import { getSharedInstance } from "../utils/sharedInstance.js";
 import { generateUuid } from "../utils/common.js";
 export const USER_HEARTBEAT_EVENT_NAME = "__user_heartbeat_event__";
+export const ANALYTICS_INITIALIZATION_EVENT_NAME = "__initialization_event__";
+export const ANALYTICS_SESSION_DURATION_EVENT_NAME = "__session_duration_event__";
 export const ANALYTICS_CONFIG_ENABLE_URL_PARAM_KEY = "analytics-enable";
 export const ANALYTICS_SESSION_ID_LOCAL_STORAGE_KEY = "base44_analytics_session_id";
 const defaultConfiguration = {
@@ -20,7 +22,9 @@ const analyticsSharedState = getSharedInstance(ANALYTICS_SHARED_STATE_NAME, () =
     requestsQueue: [],
     isProcessing: false,
     isHeartBeatProcessing: false,
+    wasInitializationTracked: false,
     sessionContext: null,
+    sessionStartTime: null,
     config: {
         ...defaultConfiguration,
         ...getAnalyticsConfigFromUrlParams(),
@@ -95,10 +99,12 @@ export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthM
             batchSize,
         });
         clearHeartBeatProcessor = startHeartBeatProcessor(track);
+        setSessionDurationTimerStart();
     };
     const onDocHidden = () => {
         stopAnalyticsProcessor();
         clearHeartBeatProcessor === null || clearHeartBeatProcessor === void 0 ? void 0 : clearHeartBeatProcessor();
+        trackSessionDurationEvent(track);
         //  flush entire queue on visibility change and hope for the best //
         const eventsData = analyticsSharedState.requestsQueue.splice(0);
         flush(eventsData, { isBeacon: true });
@@ -124,6 +130,8 @@ export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthM
     startProcessing();
     // start the heart beat processor //
     clearHeartBeatProcessor = startHeartBeatProcessor(track);
+    // track the referrer event //
+    trackInitializationEvent(track);
     // start the visibility change listener //
     if (typeof window !== "undefined") {
         window.addEventListener("visibilitychange", onVisibilityChange);
@@ -166,6 +174,38 @@ function startHeartBeatProcessor(track) {
         analyticsSharedState.isHeartBeatProcessing = false;
     };
 }
+function trackInitializationEvent(track) {
+    if (typeof window === "undefined" ||
+        analyticsSharedState.wasInitializationTracked) {
+        return;
+    }
+    analyticsSharedState.wasInitializationTracked = true;
+    track({
+        eventName: ANALYTICS_INITIALIZATION_EVENT_NAME,
+        properties: {
+            referrer: document === null || document === void 0 ? void 0 : document.referrer,
+        },
+    });
+}
+function setSessionDurationTimerStart() {
+    if (typeof window === "undefined" ||
+        analyticsSharedState.sessionStartTime !== null) {
+        return;
+    }
+    analyticsSharedState.sessionStartTime = new Date().toISOString();
+}
+function trackSessionDurationEvent(track) {
+    if (typeof window === "undefined" ||
+        analyticsSharedState.sessionStartTime === null)
+        return;
+    const sessionDuration = new Date().getTime() -
+        new Date(analyticsSharedState.sessionStartTime).getTime();
+    analyticsSharedState.sessionStartTime = null;
+    track({
+        eventName: ANALYTICS_SESSION_DURATION_EVENT_NAME,
+        properties: { sessionDuration },
+    });
+}
 function getEventIntrinsicData() {
     return {
         timestamp: new Date().toISOString(),

package/dist/modules/entities.js

@@ -32,10 +32,6 @@ export function createEntitiesModule(axios, appId) {
  */
 function createEntityHandler(axios, appId, entityName) {
     const baseURL = `/apps/${appId}/entities/${entityName}`;
-    const isDevMode = typeof window !== "undefined"
-        ? new URLSearchParams(window.location.search).get("use_staging_db") === "true"
-        : false;
-    const headers = { "X-Use-Staging-DB": String(isDevMode) };
     return {
         // List entities with optional pagination and sorting
         async list(sort, limit, skip, fields) {
@@ -48,7 +44,7 @@ function createEntityHandler(axios, appId, entityName) {
                 params.skip = skip;
             if (fields)
                 params.fields = Array.isArray(fields) ? fields.join(",") : fields;
-            return axios.get(baseURL, { params, headers });
+            return axios.get(baseURL, { params });
         },
         // Filter entities based on query
         async filter(query, sort, limit, skip, fields) {
@@ -63,31 +59,31 @@ function createEntityHandler(axios, appId, entityName) {
                 params.skip = skip;
             if (fields)
                 params.fields = Array.isArray(fields) ? fields.join(",") : fields;
-            return axios.get(baseURL, { params, headers });
+            return axios.get(baseURL, { params });
         },
         // Get entity by ID
         async get(id) {
-            return axios.get(`${baseURL}/${id}`, { headers });
+            return axios.get(`${baseURL}/${id}`);
         },
         // Create new entity
         async create(data) {
-            return axios.post(baseURL, data, { headers });
+            return axios.post(baseURL, data);
         },
         // Update entity by ID
         async update(id, data) {
-            return axios.put(`${baseURL}/${id}`, data, { headers });
+            return axios.put(`${baseURL}/${id}`, data);
         },
         // Delete entity by ID
         async delete(id) {
-            return axios.delete(`${baseURL}/${id}`, { headers });
+            return axios.delete(`${baseURL}/${id}`);
         },
         // Delete multiple entities based on query
         async deleteMany(query) {
-            return axios.delete(baseURL, { data: query, headers });
+            return axios.delete(baseURL, { data: query });
         },
         // Create multiple entities in a single request
         async bulkCreate(data) {
-            return axios.post(`${baseURL}/bulk`, data, { headers });
+            return axios.post(`${baseURL}/bulk`, data);
         },
         // Import entities from a file
         async importEntities(file) {
@@ -95,7 +91,6 @@ function createEntityHandler(axios, appId, entityName) {
             formData.append("file", file, file.name);
             return axios.post(`${baseURL}/import`, formData, {
                 headers: {
-                    ...headers,
                     "Content-Type": "multipart/form-data",
                 },
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.12-pr.63.3980328",
+  "version": "0.8.12-pr.63.4708bce",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",