@base44-preview/sdk 0.8.13-pr.58.bc6cdc5 → 0.8.13-pr.63.6dc705a

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, } = config;
+    // Config takes precedence, fallback to URL query param in browser
+    const urlHasStagingDb = typeof window !== "undefined"
+        && new URLSearchParams(window.location.search).get("use_staging_db") === "true";
+    const useStagingDb = configUseStagingDb !== null && configUseStagingDb !== void 0 ? configUseStagingDb : urlHasStagingDb;
     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
         ? {
@@ -104,11 +109,7 @@ export function createClient(config) {
         serverUrl,
     });
     const userModules = {
-        entities: createEntitiesModule({
-            axios: axiosClient,
-            appId,
-            getSocket,
-        }),
+        entities: createEntitiesModule(axiosClient, appId),
         integrations: createIntegrationsModule(axiosClient, appId),
         auth: userAuthModule,
         functions: createFunctionsModule(functionsAxiosClient, appId),
@@ -135,11 +136,7 @@ export function createClient(config) {
         },
     };
     const serviceRoleModules = {
-        entities: createEntitiesModule({
-            axios: serviceRoleAxiosClient,
-            appId,
-            getSocket,
-        }),
+        entities: createEntitiesModule(serviceRoleAxiosClient, appId),
         integrations: createIntegrationsModule(serviceRoleAxiosClient, appId),
         sso: createSsoModule(serviceRoleAxiosClient, appId, token),
         connectors: createConnectorsModule(serviceRoleAxiosClient, appId),
@@ -307,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");
@@ -341,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/index.d.ts

@@ -4,7 +4,7 @@ import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export type { Base44Client, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, };
 export * from "./types.js";
-export type { EntitiesModule, EntityHandler, RealtimeEventType, RealtimeEvent, RealtimeCallback, Subscription, } from "./modules/entities.types.js";
+export type { EntitiesModule, EntityHandler, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationPackage, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
 export type { FunctionsModule } from "./modules/functions.types.js";

package/dist/modules/entities.d.ts

@@ -1,23 +1,5 @@
 import { AxiosInstance } from "axios";
 import { EntitiesModule } from "./entities.types";
-import { RoomsSocket } from "../utils/socket-utils";
-/**
- * Configuration for the entities module.
- * @internal
- */
-export interface EntitiesModuleConfig {
-    axios: AxiosInstance;
-    appId: string;
-    getSocket: () => ReturnType<typeof RoomsSocket>;
-}
-/**
- * Creates the entities module for the Base44 SDK.
- *
- * @param config - Configuration object containing axios, appId, and getSocket
- * @returns Entities module with dynamic entity access
- * @internal
- */
-export declare function createEntitiesModule(config: EntitiesModuleConfig): EntitiesModule;
 /**
  * Creates the entities module for the Base44 SDK.
  *
@@ -25,6 +7,5 @@ export declare function createEntitiesModule(config: EntitiesModuleConfig): Enti
  * @param appId - Application ID
  * @returns Entities module with dynamic entity access
  * @internal
- * @deprecated Use the config object overload instead
  */
 export declare function createEntitiesModule(axios: AxiosInstance, appId: string): EntitiesModule;

package/dist/modules/entities.js

@@ -1,15 +1,12 @@
-export function createEntitiesModule(configOrAxios, appIdArg) {
-    // Handle both old and new signatures for backwards compatibility
-    const config = "axios" in configOrAxios
-        ? configOrAxios
-        : {
-            axios: configOrAxios,
-            appId: appIdArg,
-            getSocket: () => {
-                throw new Error("Realtime subscriptions are not available. Please update your client configuration.");
-            },
-        };
-    const { axios, appId, getSocket } = config;
+/**
+ * Creates the entities module for the Base44 SDK.
+ *
+ * @param axios - Axios instance
+ * @param appId - Application ID
+ * @returns Entities module with dynamic entity access
+ * @internal
+ */
+export function createEntitiesModule(axios, appId) {
     // Using Proxy to dynamically handle entity names
     return new Proxy({}, {
         get(target, entityName) {
@@ -20,40 +17,20 @@ export function createEntitiesModule(configOrAxios, appIdArg) {
                 return undefined;
             }
             // Create entity handler
-            return createEntityHandler(axios, appId, entityName, getSocket);
+            return createEntityHandler(axios, appId, entityName);
         },
     });
 }
-/**
- * Parses the realtime message data and extracts event information.
- * @internal
- */
-function parseRealtimeMessage(dataStr) {
-    var _a;
-    try {
-        const parsed = JSON.parse(dataStr);
-        return {
-            type: parsed.type,
-            data: parsed.data,
-            id: parsed.id || ((_a = parsed.data) === null || _a === void 0 ? void 0 : _a.id),
-            timestamp: parsed.timestamp || new Date().toISOString(),
-        };
-    }
-    catch (_b) {
-        return null;
-    }
-}
 /**
  * Creates a handler for a specific entity.
  *
  * @param axios - Axios instance
  * @param appId - Application ID
  * @param entityName - Entity name
- * @param getSocket - Function to get the socket instance
  * @returns Entity handler with CRUD methods
  * @internal
  */
-function createEntityHandler(axios, appId, entityName, getSocket) {
+function createEntityHandler(axios, appId, entityName) {
     const baseURL = `/apps/${appId}/entities/${entityName}`;
     return {
         // List entities with optional pagination and sorting
@@ -118,21 +95,5 @@ function createEntityHandler(axios, appId, entityName, getSocket) {
                 },
             });
         },
-        // Subscribe to realtime updates
-        subscribe(callback) {
-            const room = `entities:${appId}:${entityName}`;
-            // Get the socket and subscribe to the room
-            const socket = getSocket();
-            const unsubscribe = socket.subscribeToRoom(room, {
-                update_model: (msg) => {
-                    const event = parseRealtimeMessage(msg.data);
-                    if (!event) {
-                        return;
-                    }
-                    callback(event);
-                },
-            });
-            return unsubscribe;
-        },
     };
 }

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

@@ -1,28 +1,3 @@
-/**
- * Event types for realtime entity updates.
- */
-export type RealtimeEventType = "create" | "update" | "delete";
-/**
- * Payload received when a realtime event occurs.
- */
-export interface RealtimeEvent<T = Record<string, any>> {
-    /** The type of change that occurred */
-    type: RealtimeEventType;
-    /** The entity data (new/updated for create/update, previous for delete) */
-    data: T;
-    /** The unique identifier of the affected entity */
-    id: string;
-    /** ISO 8601 timestamp of when the event occurred */
-    timestamp: string;
-}
-/**
- * Callback function invoked when a realtime event occurs.
- */
-export type RealtimeCallback<T = Record<string, any>> = (event: RealtimeEvent<T>) => void;
-/**
- * Function returned from subscribe, call it to unsubscribe.
- */
-export type Subscription = () => void;
 /**
  * Entity handler providing CRUD operations for a specific entity type.
  *
@@ -267,26 +242,6 @@ export interface EntityHandler {
      * ```
      */
     importEntities(file: File): Promise<any>;
-    /**
-     * Subscribes to realtime updates for all records of this entity type.
-     *
-     * Receives notifications whenever any record is created, updated, or deleted.
-     *
-     * @param callback - Function called when an entity changes.
-     * @returns Unsubscribe function to stop listening.
-     *
-     * @example
-     * ```typescript
-     * // Subscribe to all Task changes
-     * const unsubscribe = base44.entities.Task.subscribe((event) => {
-     *   console.log(`Task ${event.id} was ${event.type}d:`, event.data);
-     * });
-     *
-     * // Later, unsubscribe
-     * unsubscribe();
-     * ```
-     */
-    subscribe(callback: RealtimeCallback): Subscription;
 }
 /**
  * Entities module for managing app data.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.13-pr.58.bc6cdc5",
+  "version": "0.8.13-pr.63.6dc705a",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",