@base44-preview/sdk 0.8.11-pr.65.dc85e14 → 0.8.12-pr.63.2ce5b64

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 base44
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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;
+    // Auto-detect staging mode from URL if in browser and not explicitly set
+    const autoDetectStagingDb = typeof window !== "undefined"
+        ? new URLSearchParams(window.location.search).get("use_staging_db") === "true"
+        : false;
+    const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, useStagingDb = autoDetectStagingDb, } = config;
     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/agents.types.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from "axios";
-import { RoomsSocket } from "../utils/socket-utils";
-import { ModelFilterParams } from "../types";
+import { RoomsSocket } from "../utils/socket-utils.js";
+import { ModelFilterParams } from "../types.js";
 /**
  * Reasoning information for an agent message.
  *

package/dist/modules/analytics.d.ts

@@ -2,7 +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_REFERRER_EVENT_NAME = "__referrer_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,7 +1,8 @@
-import { getSharedInstance } from "../utils/sharedInstance";
-import { generateUuid } from "../utils/common";
+import { getSharedInstance } from "../utils/sharedInstance.js";
+import { generateUuid } from "../utils/common.js";
 export const USER_HEARTBEAT_EVENT_NAME = "__user_heartbeat_event__";
-export const ANALYTICS_REFERRER_EVENT_NAME = "__referrer_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 = {
@@ -21,8 +22,9 @@ const analyticsSharedState = getSharedInstance(ANALYTICS_SHARED_STATE_NAME, () =
     requestsQueue: [],
     isProcessing: false,
     isHeartBeatProcessing: false,
-    wasReferrerTracked: false,
+    wasInitializationTracked: false,
     sessionContext: null,
+    sessionStartTime: null,
     config: {
         ...defaultConfiguration,
         ...getAnalyticsConfigFromUrlParams(),
@@ -97,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 });
@@ -127,7 +131,7 @@ export const createAnalyticsModule = ({ axiosClient, serverUrl, appId, userAuthM
     // start the heart beat processor //
     clearHeartBeatProcessor = startHeartBeatProcessor(track);
     // track the referrer event //
-    trackReferrerEvent(track);
+    trackInitializationEvent(track);
     // start the visibility change listener //
     if (typeof window !== "undefined") {
         window.addEventListener("visibilitychange", onVisibilityChange);
@@ -170,14 +174,37 @@ function startHeartBeatProcessor(track) {
         analyticsSharedState.isHeartBeatProcessing = false;
     };
 }
-function trackReferrerEvent(track) {
-    if (typeof window === "undefined" || analyticsSharedState.wasReferrerTracked)
+function trackInitializationEvent(track) {
+    if (typeof window === "undefined" ||
+        analyticsSharedState.wasInitializationTracked) {
         return;
-    analyticsSharedState.wasReferrerTracked = true;
-    const referrer = document.referrer;
-    if (!referrer)
+    }
+    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;
-    track({ eventName: ANALYTICS_REFERRER_EVENT_NAME, properties: { referrer } });
+    }
+    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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.11-pr.65.dc85e14",
+  "version": "0.8.12-pr.63.2ce5b64",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,15 +32,18 @@
     "@types/hast": "^3.0.4",
     "@types/node": "^25.0.1",
     "@types/unist": "^3.0.3",
+    "@typescript-eslint/parser": "^8.51.0",
     "@vitest/coverage-istanbul": "^1.0.0",
     "@vitest/coverage-v8": "^1.0.0",
     "@vitest/ui": "^1.0.0",
     "dotenv": "^16.3.1",
-    "eslint": "^8.54.0",
+    "eslint": "^9.39.2",
+    "eslint-plugin-import": "^2.32.0",
     "nock": "^13.4.0",
     "typedoc": "^0.28.14",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.3.2",
+    "typescript-eslint": "^8.51.0",
     "vitest": "^1.6.1"
   },
   "keywords": [
@@ -52,11 +55,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/base44/sdk.git"
+    "url": "git+https://github.com/base44/javascript-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/base44/sdk/issues"
+    "url": "https://github.com/base44/javascript-sdk/issues"
   },
-  "homepage": "https://github.com/base44/sdk#readme",
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+  "homepage": "https://github.com/base44/javascript-sdk#readme"
 }