@base44-preview/sdk 0.8.6-pr.52.d6f1bf2 → 0.8.6-pr.57.aa9ac21

package/dist/client.d.ts

@@ -1,241 +1,92 @@
-export type CreateClientOptions = {
-    onError?: (error: Error) => void;
-};
-export type Base44Client = ReturnType<typeof createClient>;
+import type { Base44Client, CreateClientConfig, CreateClientOptions } from "./client.types.js";
+export type { Base44Client, CreateClientConfig, CreateClientOptions };
 /**
- * Create a Base44 client instance
- * @param {Object} config - Client configuration
- * @param {string} [config.serverUrl='https://base44.app'] - API server URL
- * @param {string} [config.appBaseUrl] - Application base URL
- * @param {string|number} config.appId - Application ID
- * @param {string} [config.token] - Authentication token
- * @param {string} [config.serviceToken] - Service role authentication token
- * @param {boolean} [config.requiresAuth=false] - Whether the app requires authentication
- * @returns {Object} Base44 client instance
+ * Creates a Base44 client.
+ *
+ * This is the main entry point for the Base44 SDK. It creates a client that provides access to the SDK's modules, such as {@linkcode EntitiesModule | entities}, {@linkcode AuthModule | auth}, and {@linkcode FunctionsModule | functions}.
+ *
+ * Typically, you don't need to call this function because Base44 creates the client for you. You can then import and use the client to make API calls. The client takes care of managing authentication for you.
+ *
+ * The client supports three authentication modes:
+ * - **Anonymous**: Access modules anonymously without authentication using `base44.moduleName`. Operations are scoped to public data and permissions.
+ * - **User authentication**: Access modules with user-level permissions using `base44.moduleName`. Operations are scoped to the authenticated user's data and permissions.
+ * - **Service role authentication**: Access modules with elevated permissions using `base44.asServiceRole.moduleName`. Operations can access any data available to the app's admin. Can only be used in the backend. Typically, you create a client with service role authentication using the {@linkcode createClientFromRequest | createClientFromRequest()} function in your backend functions.
+ *
+ * For example, when using the {@linkcode EntitiesModule | entities} module:
+ * - **Anonymous**: Can only read public data.
+ * - **User authentication**: Can access the current user's data.
+ * - **Service role authentication**: Can access all data that admins can access.
+ *
+ * Most modules are available in all three modes, but with different permission levels. However, some modules are only available in specific authentication modes.
+ *
+ * @param config - Configuration object for the client.
+ * @returns A configured Base44 client instance with access to all SDK modules.
+ *
+ * @example
+ * ```typescript
+ * // Create a client for your app
+ * import { createClient } from '@base44/sdk';
+ *
+ * const base44 = createClient({
+ *   appId: 'my-app-id'
+ * });
+ *
+ * // Use the client to access your data
+ * const products = await base44.entities.Products.list();
+ * ```
  */
-export declare function createClient(config: {
-    serverUrl?: string;
-    appBaseUrl?: string;
-    appId: string;
-    token?: string;
-    serviceToken?: string;
-    requiresAuth?: boolean;
-    functionsVersion?: string;
-    headers?: Record<string, string>;
-    options?: CreateClientOptions;
-}): {
-    /**
-     * Set authentication token for all requests
-     * @param {string} newToken - New auth token
-     */
-    setToken(newToken: string): void;
-    /**
-     * Get current configuration
-     * @returns {Object} Current configuration
-     */
-    getConfig(): {
-        serverUrl: string;
-        appId: string;
-        requiresAuth: boolean;
-        token: string | undefined;
-    };
-    asServiceRole: {
-        entities: {};
-        integrations: {};
-        sso: {
-            getAccessToken(userid: string): Promise<import("axios").AxiosResponse<any, any>>;
-        };
-        connectors: {
-            getAccessToken(integrationType: import("./types.js").ConnectorIntegrationType): Promise<import("./types.js").ConnectorAccessTokenResponse>;
-        };
-        functions: {
-            invoke(functionName: string, data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-        };
-        agents: {
-            getConversations: () => Promise<import("./types.js").AgentConversation[]>;
-            getConversation: (conversationId: string) => Promise<import("./types.js").AgentConversation | undefined>;
-            listConversations: (filterParams: import("./types.js").ModelFilterParams) => Promise<import("./types.js").AgentConversation[]>;
-            createConversation: (conversation: {
-                agent_name: string;
-                metadata?: Record<string, any>;
-            }) => Promise<import("./types.js").AgentConversation>;
-            addMessage: (conversation: import("./types.js").AgentConversation, message: import("./types.js").AgentMessage) => Promise<import("./types.js").AgentMessage>;
-            subscribeToConversation: (conversationId: string, onUpdate?: (conversation: import("./types.js").AgentConversation) => void) => () => void;
-            getWhatsAppConnectURL: (agentName: string) => string;
-        };
-        appLogs: {
-            logUserInApp(pageName: string): Promise<void>;
-            fetchLogs(params?: Record<string, any>): Promise<any>;
-            getStats(params?: Record<string, any>): Promise<any>;
-        };
-        cleanup: () => void;
-    };
-    entities: {};
-    integrations: {};
-    auth: {
-        me(): Promise<import("axios").AxiosResponse<any, any>>;
-        updateMe(data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-        redirectToLogin(nextUrl: string): void;
-        logout(redirectUrl?: string): void;
-        setToken(token: string, saveToStorage?: boolean): void;
-        loginViaEmailPassword(email: string, password: string, turnstileToken?: string): Promise<{
-            access_token: string;
-            user: any;
-        }>;
-        isAuthenticated(): Promise<boolean>;
-        inviteUser(userEmail: string, role: string): Promise<import("axios").AxiosResponse<any, any>>;
-        register(payload: {
-            email: string;
-            password: string;
-            turnstile_token?: string | null;
-            referral_code?: string | null;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        verifyOtp({ email, otpCode }: {
-            email: string;
-            otpCode: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        resendOtp(email: string): Promise<import("axios").AxiosResponse<any, any>>;
-        resetPasswordRequest(email: string): Promise<import("axios").AxiosResponse<any, any>>;
-        resetPassword({ resetToken, newPassword, }: {
-            resetToken: string;
-            newPassword: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        changePassword({ userId, currentPassword, newPassword, }: {
-            userId: string;
-            currentPassword: string;
-            newPassword: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-    };
-    functions: {
-        invoke(functionName: string, data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-    };
-    agents: {
-        getConversations: () => Promise<import("./types.js").AgentConversation[]>;
-        getConversation: (conversationId: string) => Promise<import("./types.js").AgentConversation | undefined>;
-        listConversations: (filterParams: import("./types.js").ModelFilterParams) => Promise<import("./types.js").AgentConversation[]>;
-        createConversation: (conversation: {
-            agent_name: string;
-            metadata?: Record<string, any>;
-        }) => Promise<import("./types.js").AgentConversation>;
-        addMessage: (conversation: import("./types.js").AgentConversation, message: import("./types.js").AgentMessage) => Promise<import("./types.js").AgentMessage>;
-        subscribeToConversation: (conversationId: string, onUpdate?: (conversation: import("./types.js").AgentConversation) => void) => () => void;
-        getWhatsAppConnectURL: (agentName: string) => string;
-    };
-    appLogs: {
-        logUserInApp(pageName: string): Promise<void>;
-        fetchLogs(params?: Record<string, any>): Promise<any>;
-        getStats(params?: Record<string, any>): Promise<any>;
-    };
-    users: {
-        inviteUser(user_email: string, role: "user" | "admin"): Promise<any>;
-    };
-    cleanup: () => void;
-};
-export declare function createClientFromRequest(request: Request): {
-    /**
-     * Set authentication token for all requests
-     * @param {string} newToken - New auth token
-     */
-    setToken(newToken: string): void;
-    /**
-     * Get current configuration
-     * @returns {Object} Current configuration
-     */
-    getConfig(): {
-        serverUrl: string;
-        appId: string;
-        requiresAuth: boolean;
-        token: string | undefined;
-    };
-    asServiceRole: {
-        entities: {};
-        integrations: {};
-        sso: {
-            getAccessToken(userid: string): Promise<import("axios").AxiosResponse<any, any>>;
-        };
-        connectors: {
-            getAccessToken(integrationType: import("./types.js").ConnectorIntegrationType): Promise<import("./types.js").ConnectorAccessTokenResponse>;
-        };
-        functions: {
-            invoke(functionName: string, data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-        };
-        agents: {
-            getConversations: () => Promise<import("./types.js").AgentConversation[]>;
-            getConversation: (conversationId: string) => Promise<import("./types.js").AgentConversation | undefined>;
-            listConversations: (filterParams: import("./types.js").ModelFilterParams) => Promise<import("./types.js").AgentConversation[]>;
-            createConversation: (conversation: {
-                agent_name: string;
-                metadata?: Record<string, any>;
-            }) => Promise<import("./types.js").AgentConversation>;
-            addMessage: (conversation: import("./types.js").AgentConversation, message: import("./types.js").AgentMessage) => Promise<import("./types.js").AgentMessage>;
-            subscribeToConversation: (conversationId: string, onUpdate?: (conversation: import("./types.js").AgentConversation) => void) => () => void;
-            getWhatsAppConnectURL: (agentName: string) => string;
-        };
-        appLogs: {
-            logUserInApp(pageName: string): Promise<void>;
-            fetchLogs(params?: Record<string, any>): Promise<any>;
-            getStats(params?: Record<string, any>): Promise<any>;
-        };
-        cleanup: () => void;
-    };
-    entities: {};
-    integrations: {};
-    auth: {
-        me(): Promise<import("axios").AxiosResponse<any, any>>;
-        updateMe(data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-        redirectToLogin(nextUrl: string): void;
-        logout(redirectUrl?: string): void;
-        setToken(token: string, saveToStorage?: boolean): void;
-        loginViaEmailPassword(email: string, password: string, turnstileToken?: string): Promise<{
-            access_token: string;
-            user: any;
-        }>;
-        isAuthenticated(): Promise<boolean>;
-        inviteUser(userEmail: string, role: string): Promise<import("axios").AxiosResponse<any, any>>;
-        register(payload: {
-            email: string;
-            password: string;
-            turnstile_token?: string | null;
-            referral_code?: string | null;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        verifyOtp({ email, otpCode }: {
-            email: string;
-            otpCode: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        resendOtp(email: string): Promise<import("axios").AxiosResponse<any, any>>;
-        resetPasswordRequest(email: string): Promise<import("axios").AxiosResponse<any, any>>;
-        resetPassword({ resetToken, newPassword, }: {
-            resetToken: string;
-            newPassword: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-        changePassword({ userId, currentPassword, newPassword, }: {
-            userId: string;
-            currentPassword: string;
-            newPassword: string;
-        }): Promise<import("axios").AxiosResponse<any, any>>;
-    };
-    functions: {
-        invoke(functionName: string, data: Record<string, any>): Promise<import("axios").AxiosResponse<any, any>>;
-    };
-    agents: {
-        getConversations: () => Promise<import("./types.js").AgentConversation[]>;
-        getConversation: (conversationId: string) => Promise<import("./types.js").AgentConversation | undefined>;
-        listConversations: (filterParams: import("./types.js").ModelFilterParams) => Promise<import("./types.js").AgentConversation[]>;
-        createConversation: (conversation: {
-            agent_name: string;
-            metadata?: Record<string, any>;
-        }) => Promise<import("./types.js").AgentConversation>;
-        addMessage: (conversation: import("./types.js").AgentConversation, message: import("./types.js").AgentMessage) => Promise<import("./types.js").AgentMessage>;
-        subscribeToConversation: (conversationId: string, onUpdate?: (conversation: import("./types.js").AgentConversation) => void) => () => void;
-        getWhatsAppConnectURL: (agentName: string) => string;
-    };
-    appLogs: {
-        logUserInApp(pageName: string): Promise<void>;
-        fetchLogs(params?: Record<string, any>): Promise<any>;
-        getStats(params?: Record<string, any>): Promise<any>;
-    };
-    users: {
-        inviteUser(user_email: string, role: "user" | "admin"): Promise<any>;
-    };
-    cleanup: () => void;
-};
+export declare function createClient(config: CreateClientConfig): Base44Client;
+/**
+ * Creates a Base44 client from an HTTP request.
+ *
+ * The client is created by automatically extracting authentication tokens from a request to a backend function. Base44 inserts the necessary headers when forwarding requests to backend functions.
+ *
+ * To learn more about the Base44 client, see {@linkcode createClient | createClient()}.
+ *
+ * @param request - The incoming HTTP request object containing Base44 authentication headers.
+ * @returns A configured Base44 client instance with authentication from the incoming request.
+ *
+ * @example
+ * ```typescript
+ * // User authentication in backend function
+ * import { createClientFromRequest } from 'npm:@base44/sdk';
+ *
+ * Deno.serve(async (req) => {
+ *   try {
+ *     const base44 = createClientFromRequest(req);
+ *     const user = await base44.auth.me();
+ *
+ *     if (!user) {
+ *       return Response.json({ error: 'Unauthorized' }, { status: 401 });
+ *     }
+ *
+ *     // Access user's data
+ *     const userOrders = await base44.entities.Orders.filter({ userId: user.id });
+ *     return Response.json({ orders: userOrders });
+ *   } catch (error) {
+ *     return Response.json({ error: error.message }, { status: 500 });
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Service role authentication in backend function
+ * import { createClientFromRequest } from 'npm:@base44/sdk';
+ *
+ * Deno.serve(async (req) => {
+ *   try {
+ *     const base44 = createClientFromRequest(req);
+ *
+ *     // Access admin data with service role permissions
+ *     const recentOrders = await base44.asServiceRole.entities.Orders.list('-created_at', 50);
+ *
+ *     return Response.json({ orders: recentOrders });
+ *   } catch (error) {
+ *     return Response.json({ error: error.message }, { status: 500 });
+ *   }
+ * });
+ * ```
+ *
+ */
+export declare function createClientFromRequest(request: Request): Base44Client;

package/dist/client.js

@@ -10,16 +10,41 @@ import { createAgentsModule } from "./modules/agents.js";
 import { createAppLogsModule } from "./modules/app-logs.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
+import { createAnalyticsModule } from "./modules/analytics.js";
 /**
- * Create a Base44 client instance
- * @param {Object} config - Client configuration
- * @param {string} [config.serverUrl='https://base44.app'] - API server URL
- * @param {string} [config.appBaseUrl] - Application base URL
- * @param {string|number} config.appId - Application ID
- * @param {string} [config.token] - Authentication token
- * @param {string} [config.serviceToken] - Service role authentication token
- * @param {boolean} [config.requiresAuth=false] - Whether the app requires authentication
- * @returns {Object} Base44 client instance
+ * Creates a Base44 client.
+ *
+ * This is the main entry point for the Base44 SDK. It creates a client that provides access to the SDK's modules, such as {@linkcode EntitiesModule | entities}, {@linkcode AuthModule | auth}, and {@linkcode FunctionsModule | functions}.
+ *
+ * Typically, you don't need to call this function because Base44 creates the client for you. You can then import and use the client to make API calls. The client takes care of managing authentication for you.
+ *
+ * The client supports three authentication modes:
+ * - **Anonymous**: Access modules anonymously without authentication using `base44.moduleName`. Operations are scoped to public data and permissions.
+ * - **User authentication**: Access modules with user-level permissions using `base44.moduleName`. Operations are scoped to the authenticated user's data and permissions.
+ * - **Service role authentication**: Access modules with elevated permissions using `base44.asServiceRole.moduleName`. Operations can access any data available to the app's admin. Can only be used in the backend. Typically, you create a client with service role authentication using the {@linkcode createClientFromRequest | createClientFromRequest()} function in your backend functions.
+ *
+ * For example, when using the {@linkcode EntitiesModule | entities} module:
+ * - **Anonymous**: Can only read public data.
+ * - **User authentication**: Can access the current user's data.
+ * - **Service role authentication**: Can access all data that admins can access.
+ *
+ * Most modules are available in all three modes, but with different permission levels. However, some modules are only available in specific authentication modes.
+ *
+ * @param config - Configuration object for the client.
+ * @returns A configured Base44 client instance with access to all SDK modules.
+ *
+ * @example
+ * ```typescript
+ * // Create a client for your app
+ * import { createClient } from '@base44/sdk';
+ *
+ * const base44 = createClient({
+ *   appId: 'my-app-id'
+ * });
+ *
+ * // Use the client to access your data
+ * const products = await base44.entities.Products.list();
+ * ```
  */
 export function createClient(config) {
     const { serverUrl = "https://base44.app", appId, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, } = config;
@@ -74,13 +99,14 @@ export function createClient(config) {
         token: serviceToken,
         interceptResponses: false,
     });
+    const userAuthModule = createAuthModule(axiosClient, functionsAxiosClient, appId, {
+        appBaseUrl,
+        serverUrl,
+    });
     const userModules = {
         entities: createEntitiesModule(axiosClient, appId),
         integrations: createIntegrationsModule(axiosClient, appId),
-        auth: createAuthModule(axiosClient, functionsAxiosClient, appId, {
-            appBaseUrl,
-            serverUrl,
-        }),
+        auth: userAuthModule,
         functions: createFunctionsModule(functionsAxiosClient, appId),
         agents: createAgentsModule({
             axios: axiosClient,
@@ -91,6 +117,12 @@ export function createClient(config) {
         }),
         appLogs: createAppLogsModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
+        analytics: createAnalyticsModule({
+            axiosClient,
+            serverUrl,
+            appId,
+            userAuthModule,
+        }),
         cleanup: () => {
             if (socket) {
                 socket.disconnect();
@@ -145,8 +177,19 @@ export function createClient(config) {
     const client = {
         ...userModules,
         /**
-         * Set authentication token for all requests
-         * @param {string} newToken - New auth token
+         * Sets a new authentication token for all subsequent requests.
+         *
+         * @param newToken - The new authentication token
+         *
+         * @example
+         * ```typescript
+         * // Update token after login
+         * const { access_token } = await base44.auth.loginViaEmailPassword(
+         *   'user@example.com',
+         *   'password'
+         * );
+         * base44.setToken(access_token);
+         * ```
          */
         setToken(newToken) {
             userModules.auth.setToken(newToken);
@@ -158,20 +201,34 @@ export function createClient(config) {
             socketConfig.token = newToken;
         },
         /**
-         * Get current configuration
-         * @returns {Object} Current configuration
+         * Gets the current client configuration.
+         *
+         * @internal
          */
         getConfig() {
             return {
                 serverUrl,
                 appId,
                 requiresAuth,
-                token,
             };
         },
         /**
-         * Access service role modules - throws error if no service token was provided
-         * @throws {Error} When accessed without a service token
+         * Provides access to service role modules.
+         *
+         * Service role authentication provides elevated permissions for server-side operations. Unlike user authentication, which is scoped to a specific user's permissions, service role authentication has access to the data and operations available to the app's admin.
+         *
+         * @throws {Error} When accessed without providing a serviceToken during client creation.
+         *
+         * @example
+         * ```typescript
+         * const base44 = createClient({
+         *   appId: 'my-app-id',
+         *   serviceToken: 'service-role-token'
+         * });
+         *
+         * // Also access a module with elevated permissions
+         * const allUsers = await base44.asServiceRole.entities.User.list();
+         * ```
          */
         get asServiceRole() {
             if (!serviceToken) {
@@ -182,6 +239,59 @@ export function createClient(config) {
     };
     return client;
 }
+/**
+ * Creates a Base44 client from an HTTP request.
+ *
+ * The client is created by automatically extracting authentication tokens from a request to a backend function. Base44 inserts the necessary headers when forwarding requests to backend functions.
+ *
+ * To learn more about the Base44 client, see {@linkcode createClient | createClient()}.
+ *
+ * @param request - The incoming HTTP request object containing Base44 authentication headers.
+ * @returns A configured Base44 client instance with authentication from the incoming request.
+ *
+ * @example
+ * ```typescript
+ * // User authentication in backend function
+ * import { createClientFromRequest } from 'npm:@base44/sdk';
+ *
+ * Deno.serve(async (req) => {
+ *   try {
+ *     const base44 = createClientFromRequest(req);
+ *     const user = await base44.auth.me();
+ *
+ *     if (!user) {
+ *       return Response.json({ error: 'Unauthorized' }, { status: 401 });
+ *     }
+ *
+ *     // Access user's data
+ *     const userOrders = await base44.entities.Orders.filter({ userId: user.id });
+ *     return Response.json({ orders: userOrders });
+ *   } catch (error) {
+ *     return Response.json({ error: error.message }, { status: 500 });
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Service role authentication in backend function
+ * import { createClientFromRequest } from 'npm:@base44/sdk';
+ *
+ * Deno.serve(async (req) => {
+ *   try {
+ *     const base44 = createClientFromRequest(req);
+ *
+ *     // Access admin data with service role permissions
+ *     const recentOrders = await base44.asServiceRole.entities.Orders.list('-created_at', 50);
+ *
+ *     return Response.json({ orders: recentOrders });
+ *   } catch (error) {
+ *     return Response.json({ error: error.message }, { status: 500 });
+ *   }
+ * });
+ * ```
+ *
+ */
 export function createClientFromRequest(request) {
     const authHeader = request.headers.get("Authorization");
     const serviceRoleAuthHeader = request.headers.get("Base44-Service-Authorization");

package/dist/client.types.d.ts

@@ -0,0 +1,131 @@
+import type { EntitiesModule } from "./modules/entities.types.js";
+import type { IntegrationsModule } from "./modules/integrations.types.js";
+import type { AuthModule } from "./modules/auth.types.js";
+import type { SsoModule } from "./modules/sso.types.js";
+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";
+/**
+ * Options for creating a Base44 client.
+ */
+export interface CreateClientOptions {
+    /**
+     * Optional error handler that will be called whenever an API error occurs.
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Configuration for creating a Base44 client.
+ */
+export interface CreateClientConfig {
+    /**
+     * The Base44 server URL. Defaults to "https://base44.app".
+     * @internal
+     */
+    serverUrl?: string;
+    /**
+     * The base URL of the app, which is used for login redirects.
+     * @internal
+     */
+    appBaseUrl?: string;
+    /**
+     * The Base44 app ID.
+     *
+     * You can find the `appId` in the browser URL when you're in the app editor.
+     * It's the string between `/apps/` and `/editor/`.
+     */
+    appId: string;
+    /**
+     * User authentication token. Used to authenticate as a specific user.
+     */
+    token?: string;
+    /**
+     * Service role authentication token. Use this in the backend when you need elevated permissions to access data available to the app's admin or perform admin operations. This token should be kept secret and never exposed in the app's frontend. Typically, you get this token from a request to a backend function using {@linkcode createClientFromRequest | createClientFromRequest()}.
+     */
+    serviceToken?: string;
+    /**
+     * Whether authentication is required. If true, redirects to login if not authenticated.
+     * @internal
+     */
+    requiresAuth?: boolean;
+    /**
+     * Version string for functions API.
+     * @internal
+     */
+    functionsVersion?: string;
+    /**
+     * Additional headers to include in API requests.
+     * @internal
+     */
+    headers?: Record<string, string>;
+    /**
+     * Additional client options.
+     */
+    options?: CreateClientOptions;
+}
+/**
+ * The Base44 client instance.
+ *
+ * Provides access to all SDK modules for interacting with the app.
+ */
+export interface Base44Client {
+    /** {@link EntitiesModule | Entities module} for CRUD operations on your data models. */
+    entities: EntitiesModule;
+    /** {@link IntegrationsModule | Integrations module} for calling pre-built integration endpoints. */
+    integrations: IntegrationsModule;
+    /** {@link AuthModule | Auth module} for user authentication and management. */
+    auth: AuthModule;
+    /** {@link FunctionsModule | Functions module} for invoking custom backend functions. */
+    functions: FunctionsModule;
+    /** {@link AgentsModule | Agents module} for managing AI agent conversations. */
+    agents: AgentsModule;
+    /** {@link AppLogsModule | App logs module} for tracking app usage. */
+    appLogs: AppLogsModule;
+    /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */
+    cleanup: () => void;
+    /**
+     * Sets a new authentication token for all subsequent requests.
+     *
+     * Updates the token for both HTTP requests and WebSocket connections.
+     *
+     * @param newToken - The new authentication token.
+     */
+    setToken(newToken: string): void;
+    /**
+     * Gets the current client configuration.
+     * @internal
+     */
+    getConfig(): {
+        serverUrl: string;
+        appId: string;
+        requiresAuth: boolean;
+    };
+    /**
+     * Provides access to supported modules with elevated permissions.
+     *
+     * Service role authentication provides elevated permissions for backend operations. Unlike user authentication, which is scoped to a specific user's permissions, service role authentication has access to the data and operations available to the app's admin.
+     *
+     * @throws {Error} When accessed without providing a serviceToken during client creation
+     */
+    readonly asServiceRole: {
+        /** {@link EntitiesModule | Entities module} with elevated permissions. */
+        entities: EntitiesModule;
+        /** {@link IntegrationsModule | Integrations module} with elevated permissions. */
+        integrations: IntegrationsModule;
+        /** {@link SsoModule | SSO module} for generating SSO tokens.
+         * @internal
+         */
+        sso: SsoModule;
+        /** {@link ConnectorsModule | Connectors module} for OAuth token retrieval. */
+        connectors: ConnectorsModule;
+        /** {@link FunctionsModule | Functions module} with elevated permissions. */
+        functions: FunctionsModule;
+        /** {@link AgentsModule | Agents module} with elevated permissions. */
+        agents: AgentsModule;
+        /** {@link AppLogsModule | App logs module} with elevated permissions. */
+        appLogs: AppLogsModule;
+        /** Cleanup function to disconnect WebSocket connections. */
+        cleanup: () => void;
+    };
+}