@base44-preview/sdk 0.8.49-pr.280.04af9f9 → 0.8.49-pr.288.a18e427

package/dist/client.js

@@ -14,9 +14,6 @@ import { createAppModule } from "./modules/app.js";
 import { createUsersModule } from "./modules/users.js";
 import { RoomsSocket } from "./utils/socket-utils.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
-import { createExperimentsModule } from "./modules/experiments.js";
-import { createExposureTracker } from "./modules/experiment-exposures.js";
-import { EXPERIMENTS_CONTEXT_HEADER, getBrowserExperimentsContext, readExperimentsContext } from "./modules/experiments-context.js";
 import { createActorsModule, resolveActorsHost, } from "./modules/actors.js";
 /**
  * Creates a Base44 client.
@@ -56,11 +53,10 @@ import { createActorsModule, resolveActorsHost, } from "./modules/actors.js";
  * ```
  */
 export function createClient(config) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d;
     const { serverUrl = "https://base44.app", appId, analytics, token, serviceToken, requiresAuth = false, appBaseUrl, options, functionsVersion, headers: optionalHeaders, } = config;
     // Normalize appBaseUrl to always be a string (empty if not provided or invalid)
     const normalizedAppBaseUrl = typeof appBaseUrl === "string" ? appBaseUrl : "";
-    const experimentsContext = (_a = config.experiments) !== null && _a !== void 0 ? _a : getBrowserExperimentsContext(appId);
     const socketConfig = {
         serverUrl,
         mountPath: "/ws-user-apps/socket.io/",
@@ -77,14 +73,9 @@ export function createClient(config) {
         }
         return socket;
     };
-    const { [EXPERIMENTS_CONTEXT_HEADER]: inheritedExperimentsContext, ...requestHeaders } = optionalHeaders !== null && optionalHeaders !== void 0 ? optionalHeaders : {};
     const headers = {
-        ...requestHeaders,
+        ...optionalHeaders,
         "X-App-Id": String(appId),
-        ...(experimentsContext ? {
-            "Base44-Visitor-Id": experimentsContext.identity.visitorId,
-            "Base44-Experiment-Preview": JSON.stringify((_b = experimentsContext.preview) !== null && _b !== void 0 ? _b : {}),
-        } : {}),
     };
     const functionHeaders = functionsVersion
         ? {
@@ -130,25 +121,10 @@ export function createClient(config) {
         baseURL: `${serverUrl}/api`,
         headers,
     });
-    const exposureTracker = createExposureTracker({
-        axiosClient,
-        appId,
-        enabled: (_c = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _c !== void 0 ? _c : true,
-        source: typeof window === "undefined" ? "backend" : "browser",
-        pageUrl: experimentsContext === null || experimentsContext === void 0 ? void 0 : experimentsContext.pageUrl,
-    });
-    const experiments = createExperimentsModule({
-        appId,
-        getAuth: () => userAuthModule,
-        trackExposure: exposureTracker.track,
-        flushExposures: exposureTracker.flush,
-        context: experimentsContext,
-    });
     const userAuthModule = createAuthModule(axiosClient, functionsAxiosClient, appId, {
         appBaseUrl: normalizedAppBaseUrl,
         serverUrl,
         token,
-        onAuthStateChange: experiments.onAuthStateChange,
     });
     // Apply the access token before any module that may issue authenticated
     // requests during construction (notably analytics, which fires an init
@@ -160,19 +136,11 @@ export function createClient(config) {
             userAuthModule.setToken(accessToken);
         }
     }
-    if (experimentsContext) {
-        const { userId, status } = experimentsContext.identity;
-        // The document's cookie identity may differ from this client's localStorage token.
-        const needsClientIdentity = typeof window !== "undefined" && userAuthModule.hasToken() &&
-            experimentsContext.config.experiments.some((experiment) => experiment.assign_by === "user");
-        experiments.onAuthStateChange(status === "pending" || needsClientIdentity ? { status: "pending" } :
-            userId ? { status: "authenticated", userId } : { status: "anonymous" });
-    }
     const actorsModule = createActorsModule({
         appId,
         // serverUrl is often relative/empty (same-origin app); the proxy-fallback
         // URL needs an absolute host, so fall back to the page origin.
-        host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_d = window.location) === null || _d === void 0 ? void 0 : _d.origin : undefined),
+        host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin : undefined),
         functionsVersion,
         getAuthToken: () => token || getAccessToken(),
         mintConnectionToken: async (actorName, room, connectionId) => {
@@ -200,7 +168,6 @@ export function createClient(config) {
         integrations: createIntegrationsModule(axiosClient, appId),
         connectors: createUserConnectorsModule(axiosClient, appId),
         auth: userAuthModule,
-        experiments: experiments.module,
         functions: createFunctionsModule(functionsAxiosClient, appId, {
             getAuthHeaders: () => {
                 const headers = {};
@@ -211,7 +178,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_e = functionsAxiosClient.defaults) === null || _e === void 0 ? void 0 : _e.baseURL,
+            baseURL: (_b = functionsAxiosClient.defaults) === null || _b === void 0 ? void 0 : _b.baseURL,
         }),
         agents: createAgentsModule({
             axios: axiosClient,
@@ -229,14 +196,11 @@ export function createClient(config) {
             serverUrl,
             appId,
             userAuthModule,
-            enabled: (_f = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _f !== void 0 ? _f : true,
-            getVisitorId: experiments.visitorId,
-            experimentsContext,
+            enabled: (_c = analytics === null || analytics === void 0 ? void 0 : analytics.enabled) !== null && _c !== void 0 ? _c : true,
         }),
         actors: actorsModule.module,
         cleanup: () => {
             userModules.analytics.cleanup();
-            experiments.cleanup();
             actorsModule.closeAll();
             if (socket) {
                 socket.disconnect();
@@ -261,7 +225,7 @@ export function createClient(config) {
                 }
                 return headers;
             },
-            baseURL: (_g = serviceRoleFunctionsAxiosClient.defaults) === null || _g === void 0 ? void 0 : _g.baseURL,
+            baseURL: (_d = serviceRoleFunctionsAxiosClient.defaults) === null || _d === void 0 ? void 0 : _d.baseURL,
         }),
         agents: createAgentsModule({
             axios: serviceRoleAxiosClient,
@@ -304,10 +268,7 @@ export function createClient(config) {
             appId: String(appId),
             serverUrl,
             functionsVersion,
-            platformHeaders: {
-                ...headers,
-                ...(inheritedExperimentsContext ? { [EXPERIMENTS_CONTEXT_HEADER]: inheritedExperimentsContext } : {}),
-            },
+            platformHeaders: optionalHeaders,
         }),
         /**
          * Sets a new authentication token for all subsequent requests.
@@ -459,10 +420,6 @@ export function createClientFromRequest(request) {
     }
     // Prepare additional headers to propagate
     const additionalHeaders = {};
-    const encodedExperiments = request.headers.get(EXPERIMENTS_CONTEXT_HEADER);
-    const experimentsContext = readExperimentsContext(encodedExperiments, appId);
-    if (experimentsContext && encodedExperiments)
-        additionalHeaders[EXPERIMENTS_CONTEXT_HEADER] = encodedExperiments;
     if (stateHeader) {
         additionalHeaders["Base44-State"] = stateHeader;
     }
@@ -483,6 +440,5 @@ export function createClientFromRequest(request) {
         serviceToken: serviceRoleToken,
         functionsVersion: functionsVersion !== null && functionsVersion !== void 0 ? functionsVersion : undefined,
         headers: additionalHeaders,
-        experiments: experimentsContext ? { ...experimentsContext, pageUrl: request.url ? new URL(request.url).pathname : "/" } : undefined,
     });
 }

package/dist/client.types.d.ts

@@ -9,8 +9,6 @@ import type { AiGatewayModule } from "./modules/ai-gateway.types.js";
 import type { AppLogsModule } from "./modules/app-logs.types.js";
 import type { AppModule } from "./modules/app.types.js";
 import type { AnalyticsModule } from "./modules/analytics.types.js";
-import type { ExperimentsModule } from "./modules/experiments.types.js";
-import type { ExperimentsContext } from "./modules/experiments-config.types.js";
 import type { ActorsModule } from "./modules/actors.types.js";
 import type { FetchWithAuthInit } from "./utils/fetch-with-auth.js";
 /**
@@ -41,9 +39,9 @@ export interface CreateClientAnalyticsConfig {
     /**
      * Whether app analytics is enabled for this client.
      *
-     * When disabled, automatic analytics, experiment exposures and calls to
-     * `analytics.track()` are no-ops. The SDK does not create an analytics session
-     * identifier, start heartbeat timers, or send analytics requests.
+     * When disabled, automatic analytics and calls to `analytics.track()` are
+     * no-ops. The SDK does not create an analytics session identifier, start
+     * heartbeat timers, or send analytics requests.
      *
      * @defaultValue `true`
      */
@@ -81,12 +79,6 @@ export interface CreateClientConfig {
      * Omit this option to preserve the default analytics behavior.
      */
     analytics?: CreateClientAnalyticsConfig;
-    /**
-     * Platform-validated context for local flag evaluation. Request-scoped on servers.
-     * Automatically read from the platform bootstrap in browsers and trusted headers
-     * by createClientFromRequest(). Not an authorization credential.
-     */
-    experiments?: ExperimentsContext;
     /**
      * User authentication token. Used to authenticate as a specific user.
      *
@@ -142,8 +134,6 @@ export interface Base44Client {
     connectors: UserConnectorsModule;
     /** {@link EntitiesModule | Entities module} for CRUD operations on your data models. */
     entities: EntitiesModule;
-    /** {@link ExperimentsModule | Experiments module} for local feature flags and exposures. */
-    experiments: ExperimentsModule;
     /** {@link FunctionsModule | Functions module} for invoking custom backend functions. */
     functions: FunctionsModule;
     /** {@link IntegrationsModule | Integrations module} for calling pre-built integration endpoints. */

package/dist/index.d.ts

@@ -4,15 +4,12 @@ import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export type { Base44Client, CreateClientAnalyticsConfig, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, };
 export * from "./types.js";
-export { evaluateExperiments } from "./modules/experiments-evaluator.js";
-export type { ExperimentsConfig, ExperimentsContext, ExperimentsIdentity } from "./modules/experiments-config.types.js";
-export type { ExperimentsModule, ExperimentsSnapshot, } from "./modules/experiments.types.js";
 export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityAggregateResult, EntityAggregateSpec, EntityDateBucketUnit, EntityDistinctOptions, EntityFilterOperators, EntityFilterQuery, EntityFilterValue, EntityHandler, EntityListOptions, EntityPage, EntityRecord, EntityTypeRegistry, EntityUpsertOptions, EntityUpsertResult, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
 export type { IntegrationsModule, IntegrationEndpointFunction, CoreIntegrations, InvokeLLMParams, GenerateImageParams, GenerateImageResult, UploadFileParams, UploadFileResult, SendEmailParams, SendEmailResult, ExtractDataFromUploadedFileParams, ExtractDataFromUploadedFileResult, UploadPrivateFileParams, UploadPrivateFileResult, CreateFileSignedUrlParams, CreateFileSignedUrlResult, } from "./modules/integrations.types.js";
 export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./modules/functions.types.js";
 export type { AgentsModule, AgentName, AgentNameRegistry, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
-export type { AiGatewayModule, AiGatewayConnection, } from "./modules/ai-gateway.types.js";
+export type { AiGatewayModule, AiGatewayConnection, AiGatewayConnectionOptions, } from "./modules/ai-gateway.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { AppModule, AppPublicSettings, AppPublicSettingsResponse, } from "./modules/app.types.js";
 export type { ActorsModule, ActorClient, ActorRef, Connection, ActorSubscription, ActorConnectOptions, ActorNameRegistry, ActorRegistry, } from "./modules/actors.types.js";

package/dist/index.js

@@ -3,5 +3,4 @@ import { Base44Error } from "./utils/axios-client.js";
 import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, } from "./utils/auth-utils.js";
 export { createClient, createClientFromRequest, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export * from "./types.js";
-export { evaluateExperiments } from "./modules/experiments-evaluator.js";
 export { Actor } from "./actor.js";

package/dist/modules/ai-gateway.js

@@ -1,11 +1,19 @@
 import { getAccessToken } from "../utils/auth-utils.js";
+const PROVIDER_PATHS = {
+    openai: "openai",
+    typesafe: "typesafe",
+};
 export function createAiGatewayModule({ serverUrl, token, appId, }) {
-    const connection = () => {
+    const connection = ({ provider = "openai" } = {}) => {
         var _a;
-        return ({
-            baseURL: `${serverUrl}/api/apps/${appId}/ai/openai/v1`,
+        if (!Object.prototype.hasOwnProperty.call(PROVIDER_PATHS, provider)) {
+            throw new Error(`Unsupported AI Gateway provider: ${provider}`);
+        }
+        const providerPath = PROVIDER_PATHS[provider];
+        return {
+            baseURL: `${serverUrl}/api/apps/${appId}/ai/${providerPath}/v1`,
             token: (_a = token !== null && token !== void 0 ? token : getAccessToken()) !== null && _a !== void 0 ? _a : "",
-        });
+        };
     };
     return {
         connection,

package/dist/modules/ai-gateway.types.d.ts

@@ -2,7 +2,7 @@
  * Connection details for the Base44 AI Gateway.
  */
 export interface AiGatewayConnection {
-    /** Base URL of the gateway's OpenAI-compatible Chat Completions endpoint. */
+    /** Base URL of the selected gateway provider. */
     baseURL: string;
     /**
      * Bearer token that authenticates the request. Empty string when the caller is
@@ -10,6 +10,11 @@ export interface AiGatewayConnection {
      */
     token: string;
 }
+/** Options for selecting an AI Gateway provider. */
+export interface AiGatewayConnectionOptions {
+    /** Gateway provider to connect to. Defaults to `openai`. */
+    provider?: "openai" | "typesafe";
+}
 /**
  * Configuration for the AI Gateway module.
  * @internal
@@ -34,13 +39,17 @@ export interface AiGatewayModuleConfig {
  * against the provider directly, no separate account, API key, or billing
  * setup with the underlying model provider required.
  *
+ * By default, `connection()` uses the OpenAI-compatible provider. Pass
+ * `{ provider: "typesafe" }` to connect to TypeSafe for structured evaluations
+ * with `@ai-sdk/typesafe-ai`.
+ *
  * Call `connection()` from a backend function rather than the browser. This
  * keeps your instructions, tools, and business logic server-side, and lets
  * you enforce your own auth, rate, and spend limits around the call. The
  * `token` it returns is the caller's regular session token, the same one
  * used for every other SDK call.
  *
- * ## Models
+ * ## OpenAI-compatible models
  *
  * You can use any of the [models available through `InvokeLLM`](/developers/references/sdk/docs/type-aliases/integrations#invokellm).
  * Pass `'automatic'` to let Base44 choose one, or pin a specific model such
@@ -69,7 +78,9 @@ export interface AiGatewayModule {
     /**
      * Gets the connection details for the Base44 AI Gateway.
      *
-     * Returns the `baseURL` and `token` to pass to any OpenAI-compatible client.
+     * Returns the `baseURL` and `token` to pass to the selected provider client.
+     *
+     * @param options - Provider selection. Omit it to use the OpenAI-compatible gateway.
      *
      * @returns The gateway {@linkcode AiGatewayConnection | connection} (`baseURL` and `token`).
      *
@@ -135,5 +146,5 @@ export interface AiGatewayModule {
      * await agent.generate({ prompt: `Review this return request: ${JSON.stringify(returnRequest)}` });
      * ```
      */
-    connection(): AiGatewayConnection;
+    connection(options?: AiGatewayConnectionOptions): AiGatewayConnection;
 }

package/dist/modules/analytics.d.ts

@@ -1,44 +1,19 @@
 import { AxiosInstance } from "axios";
-import { TrackEventParams, AnalyticsModuleOptions, SessionContext } from "./analytics.types";
+import { TrackEventParams, AnalyticsModuleOptions } from "./analytics.types";
 import type { InternalAuthModule } from "./auth.types";
-import type { ExperimentsContext } from "./experiments-config.types.js";
 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";
-declare function createAnalyticsState(): {
-    isHeartBeatProcessing: boolean;
-    wasInitializationTracked: boolean;
-    sessionContext: SessionContext | null;
-    sessionContextPromise: Promise<SessionContext> | null;
-    sessionStartTime: string | null;
-    fallbackSessionId: string | null;
-    config: Required<AnalyticsModuleOptions>;
-};
-type AnalyticsState = ReturnType<typeof createAnalyticsState>;
-/** @internal */
-export declare function getAnalyticsState(axiosClient: AxiosInstance): AnalyticsState;
 export interface AnalyticsModuleArgs {
     axiosClient: AxiosInstance;
     serverUrl: string;
     appId: string;
     userAuthModule: InternalAuthModule;
     enabled: boolean;
-    getVisitorId?: () => string | undefined;
-    experimentsContext?: ExperimentsContext;
 }
-/** @internal */
-export declare function isAnalyticsEnabled(enabled: boolean, state?: {
-    isHeartBeatProcessing: boolean;
-    wasInitializationTracked: boolean;
-    sessionContext: SessionContext | null;
-    sessionContextPromise: Promise<SessionContext> | null;
-    sessionStartTime: string | null;
-    fallbackSessionId: string | null;
-    config: Required<AnalyticsModuleOptions>;
-}): boolean;
-export declare const createAnalyticsModule: ({ axiosClient, appId, userAuthModule, enabled, getVisitorId, experimentsContext, }: AnalyticsModuleArgs) => {
+export declare const createAnalyticsModule: ({ axiosClient, serverUrl, appId, userAuthModule, enabled, }: AnalyticsModuleArgs) => {
     track: (params: TrackEventParams) => void;
     cleanup: () => void;
 };
@@ -52,15 +27,6 @@ export declare const createAnalyticsModule: ({ axiosClient, appId, userAuthModul
  *
  * @internal
  */
-export declare function resetAnalyticsSessionContext(axiosClient?: AxiosInstance): void;
+export declare function resetAnalyticsSessionContext(): void;
 export declare function getAnalyticsConfigFromUrlParams(): AnalyticsModuleOptions | undefined;
-export declare function getAnalyticsSessionId(state?: {
-    isHeartBeatProcessing: boolean;
-    wasInitializationTracked: boolean;
-    sessionContext: SessionContext | null;
-    sessionContextPromise: Promise<SessionContext> | null;
-    sessionStartTime: string | null;
-    fallbackSessionId: string | null;
-    config: Required<AnalyticsModuleOptions>;
-}): string;
-export {};
+export declare function getAnalyticsSessionId(): string;