@base44-preview/sdk 0.8.48-pr.282.028b41c → 0.8.48-pr.282.081f33c

package/dist/client.js

@@ -5,7 +5,7 @@ import { createAuthModule } from "./modules/auth.js";
 import { createSsoModule } from "./modules/sso.js";
 import { createConnectorsModule, createUserConnectorsModule, } from "./modules/connectors.js";
 import { getAccessToken } from "./utils/auth-utils.js";
-import { exchangeEmbedToken, isEmbeddedTab, markEmbeddedTab, takeEmbedTokenFromUrl, } from "./utils/embed-session.js";
+import { exchangeEmbedToken, isEmbeddedTab, isFramed, markEmbeddedTab, takeEmbedTokenFromUrl, } from "./utils/embed-session.js";
 import { createFetchWithAuth } from "./utils/fetch-with-auth.js";
 import { createFunctionsModule } from "./modules/functions.js";
 import { createAgentsModule } from "./modules/agents.js";
@@ -58,13 +58,19 @@ export function createClient(config) {
     const { serverUrl = "https://base44.app", appId, analytics, 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 embedOtt = takeEmbedTokenFromUrl();
+    // Always taken off the URL, even outside a frame: a one-time token must not
+    // be left in the address bar, in history, or in a shared link.
+    const urlOtt = takeEmbedTokenFromUrl();
+    // Only redeemed inside a frame. Opened as a normal tab, the same URL falls
+    // back to the app's own login, which works there and cannot work in a frame.
+    const embedOtt = isFramed() ? urlOtt : null;
     if (embedOtt) {
-        markEmbeddedTab();
+        markEmbeddedTab(appId);
     }
-    const embedded = Boolean(embedOtt) || isEmbeddedTab();
-    // In a frame the passed token is the OTT itself or a stale stored one, not this session.
-    const token = embedded ? undefined : config.token;
+    const embedded = Boolean(embedOtt) || isEmbeddedTab(appId);
+    // The passed token is the OTT itself whenever one came in on the URL, and a
+    // stale stored one in a frame. Neither of those is this session.
+    const token = urlOtt !== null || embedded ? undefined : config.token;
     const headers = {
         ...optionalHeaders,
         "X-App-Id": String(appId),
@@ -118,6 +124,7 @@ export function createClient(config) {
         serverUrl,
         token,
         embedded,
+        onEmbedSessionEnded: options === null || options === void 0 ? void 0 : options.onEmbedSessionEnded,
     });
     // Apply the access token before any module that may issue authenticated
     // requests during construction (notably analytics, which fires an init
@@ -171,6 +178,21 @@ export function createClient(config) {
             console.error("Base44: applying the embedded session failed:", e);
         })
         : Promise.resolve();
+    // Everything that can wait for the session does. `aiGateway.connection()`
+    // and the agents connect URLs cannot: they hand back a value, not a promise,
+    // and a value read now would stay wrong after the session arrives. They warn
+    // instead of failing quietly.
+    let warnedEarlyRead = false;
+    const getTokenNow = () => {
+        const sessionToken = getToken();
+        if (sessionToken === null && embedOtt && !warnedEarlyRead) {
+            warnedEarlyRead = true;
+            console.warn("Base44: read a token before the embedded session was ready, so it is " +
+                "empty. Await a call such as base44.auth.me() before building a " +
+                "client or a URL that keeps the token.");
+        }
+        return sessionToken;
+    };
     if (embedOtt) {
         // Requests issued during the exchange wait for it. Registered after createAxiosClient's
         // interceptors so it runs first and the anonymous-visitor header sees the Authorization.
@@ -191,7 +213,10 @@ export function createClient(config) {
         // URL needs an absolute host, so fall back to the page origin.
         host: resolveActorsHost(serverUrl, typeof window !== "undefined" ? (_a = window.location) === null || _a === void 0 ? void 0 : _a.origin : undefined),
         functionsVersion,
-        getAuthToken: getToken,
+        getAuthToken: async () => {
+            await authReady;
+            return getToken();
+        },
         mintConnectionToken: async (actorName, room, connectionId) => {
             await authReady;
             const authToken = getToken();
@@ -219,6 +244,7 @@ export function createClient(config) {
         connectors: createUserConnectorsModule(axiosClient, appId),
         auth: userAuthModule,
         functions: createFunctionsModule(functionsAxiosClient, appId, {
+            waitForAuth: () => authReady,
             getAuthHeaders: () => {
                 const headers = {};
                 const sessionToken = getToken();
@@ -234,9 +260,13 @@ export function createClient(config) {
             getSocket,
             appId,
             serverUrl,
-            getToken,
+            getToken: getTokenNow,
+        }),
+        aiGateway: createAiGatewayModule({
+            serverUrl,
+            getToken: getTokenNow,
+            appId,
         }),
-        aiGateway: createAiGatewayModule({ serverUrl, getToken, appId }),
         appLogs: createAppLogsModule(axiosClient, appId),
         app: createAppModule(axiosClient, appId),
         users: createUsersModule(axiosClient, appId),
@@ -281,7 +311,10 @@ export function createClient(config) {
             getSocket,
             appId,
             serverUrl,
-            getToken: () => token,
+            // The user's token, as on the user-scoped module: the only thing this is
+            // read for is the `?token=` on a channel URL handed to that user, which
+            // the app's service credential must never end up in.
+            getToken: getTokenNow,
         }),
         aiGateway: createAiGatewayModule({
             serverUrl,
@@ -322,12 +355,12 @@ export function createClient(config) {
             serverUrl,
             functionsVersion,
             platformHeaders: optionalHeaders,
+            waitForAuth: () => authReady,
         }),
         /**
          * Sets a new authentication token for all subsequent requests.
          *
          * @param newToken - The new authentication token
-         * @param saveToStorage - Whether to also keep the token in local storage. Defaults to `true`.
          *
          * @example
          * ```typescript
@@ -339,8 +372,8 @@ export function createClient(config) {
          * base44.setToken(access_token);
          * ```
          */
-        setToken(newToken, saveToStorage = true) {
-            applyToken(newToken, saveToStorage);
+        setToken(newToken) {
+            applyToken(newToken, true);
         },
         /**
          * Gets the current client configuration.

package/dist/client.types.d.ts

@@ -22,6 +22,18 @@ export interface CreateClientOptions {
      * are usually {@linkcode Base44Error} instances — check `error.status`.
      */
     onError?: (error: Error) => void;
+    /**
+     * Called when an embedded app's session ends, instead of the SDK's built-in
+     * notice.
+     *
+     * A platform-embedded app holds its session in memory and only the platform
+     * can mint the next one, so there is no login page to send the visitor to.
+     * When {@link AuthModule.redirectToLogin | redirectToLogin()} or
+     * {@link AuthModule.logout | logout()} is reached in that state the SDK
+     * covers the page with a plain "session ended" notice; pass this to render
+     * your own instead. See {@link AuthModule.isEmbedded | auth.isEmbedded()}.
+     */
+    onEmbedSessionEnded?: () => void;
     /**
      * Forces the actors transport. `"auto"` (default) connects directly to the
      * actor and falls back to the platform proxy when the app's actors don't
@@ -200,9 +212,8 @@ export interface Base44Client {
      * Updates the token for both HTTP requests and WebSocket connections.
      *
      * @param newToken - The new authentication token.
-     * @param saveToStorage - Whether to also keep the token in local storage so it survives a page load. Defaults to `true`.
      */
-    setToken(newToken: string, saveToStorage?: boolean): void;
+    setToken(newToken: string): void;
     /**
      * Gets the current client configuration.
      * @internal

package/dist/modules/actors.d.ts

@@ -12,7 +12,7 @@ interface ActorsConfig {
     /** Current user access token, if authenticated. Rides the WS query on the
      * proxy-fallback path so the platform proxy can authenticate the connection;
      * anonymous connects omit it. */
-    getAuthToken(): string | null | undefined;
+    getAuthToken(): string | null | undefined | Promise<string | null | undefined>;
     /** Same semantics as function calls: editors with a non-prod version get the
      * draft actor script; everyone else gets the published one. */
     functionsVersion?: string;

package/dist/modules/actors.js

@@ -83,7 +83,7 @@ class Connection {
                 }
             }
             // Rebuilt per attempt so a login/logout is picked up on reconnect.
-            return buildProxyActorUrl(config.host, actorName, instanceId, this.id, config.appId, config.getAuthToken(), config.functionsVersion);
+            return buildProxyActorUrl(config.host, actorName, instanceId, this.id, config.appId, await config.getAuthToken(), config.functionsVersion);
         };
         const ws = new ReconnectingWebSocket(urlProvider);
         this.ws = ws;

package/dist/modules/auth.js

@@ -83,6 +83,17 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
     // to the identity transitions below (`setToken`, `logout`) instead of to the
     // header a caller may have set on the instance directly.
     let accessToken = options.token || null;
+    // Where an embedded app goes when it has no session: nowhere. Only the host
+    // platform can mint the next one — a login here would sign the visitor in as
+    // an app user, a different identity from the platform user the frame is for.
+    // The app's own notice wins when it passed one.
+    const endEmbeddedSession = () => {
+        if (options.onEmbedSessionEnded) {
+            options.onEmbedSessionEnded();
+            return;
+        }
+        showEmbedSessionEnded();
+    };
     return {
         hasToken() {
             return accessToken !== null;
@@ -116,10 +127,12 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
             if (typeof window === "undefined") {
                 throw new Error("Login method can only be used in a browser environment");
             }
-            // An embedded session can only be renewed by the host platform; the
-            // login round trip cannot complete inside its frame.
+            // Only the host platform can sign a platform user in, so there is no
+            // login page to send them to. (The app's own login would work in the
+            // frame — `loginWithProvider` opens a popup — but it would mint a
+            // different, app-level identity.)
             if (options.embedded) {
-                showEmbedSessionEnded();
+                endEmbeddedSession();
                 return;
             }
             // If nextUrl is not provided, use the current URL
@@ -178,6 +191,13 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
                         console.error("Failed to remove token from localStorage:", e);
                     }
                 }
+                // An embedded session holds no app cookie to clear — it lived in
+                // memory — and navigating a third-party frame to the logout endpoint
+                // would only break the frame. The state above is already cleared.
+                if (options.embedded) {
+                    endEmbeddedSession();
+                    return;
+                }
                 // Determine the from_url parameter
                 const fromUrl = redirectUrl || window.location.href;
                 // Redirect to server-side logout endpoint to clear HTTP-only cookies

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

@@ -103,6 +103,11 @@ export interface AuthModuleOptions {
      * session is minted by the platform and cannot be renewed by a login redirect.
      */
     embedded?: boolean;
+    /**
+     * Called instead of the SDK's built-in notice when an embedded session ends.
+     * See {@link CreateClientOptions.onEmbedSessionEnded}.
+     */
+    onEmbedSessionEnded?: () => void;
 }
 /**
  * Authentication module for managing user authentication and authorization. The module automatically stores tokens in local storage when available and manages authorization headers for API requests.
@@ -187,7 +192,9 @@ export interface AuthModule {
     /**
      * Whether the app is running embedded in a host platform.
      *
-     * A platform embeds an app in an iframe and signs its user in by minting a one-time token onto the frame's URL; the SDK trades it for a session as the client is created. That session is held in memory only and can be renewed only by the platform, so when it ends there is no login page to send the user to — {@linkcode AuthModule.redirectToLogin | redirectToLogin()} shows a "session ended" notice instead. Use this to render your own notice or to hide sign-in and sign-out controls that cannot work inside the frame.
+     * A platform embeds an app in an iframe and signs its user in by minting a one-time token onto the frame's URL; the SDK trades it for a session as the client is created. That session is held in memory only and can be renewed only by the platform, so when it ends there is no login page to send the user to — {@linkcode AuthModule.redirectToLogin | redirectToLogin()} and {@linkcode AuthModule.logout | logout()} show a "session ended" notice instead (pass `options.onEmbedSessionEnded` to {@linkcode createClient} to show your own). Use this to render your own notice or to hide sign-in and sign-out controls that cannot work inside the frame.
+     *
+     * Because the session lives in memory, it does not survive a full page load inside the frame: routing within the app keeps it, while a reload or a real navigation ends it and the platform has to embed the app again. Prefer client-side navigation in an embedded app.
      *
      * @returns `true` when the app was embedded by a host platform, `false` otherwise.
      *

package/dist/modules/functions.js

@@ -65,8 +65,12 @@ export function createFunctionsModule(axios, appId, config) {
         },
         // Fetch a backend function endpoint directly.
         async fetch(path, init = {}) {
+            var _a;
             const normalizedPath = path.startsWith("/") ? path : `/${path}`;
             const primaryPath = `/functions${normalizedPath}`;
+            // Headers are read after this: a session still being negotiated must be
+            // in hand before the Authorization is built, not after.
+            await ((_a = config === null || config === void 0 ? void 0 : config.waitForAuth) === null || _a === void 0 ? void 0 : _a.call(config));
             const headers = toHeaders(init.headers);
             const requestInit = {
                 ...init,

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

@@ -29,6 +29,12 @@ export type FunctionsFetchInit = RequestInit;
 export interface FunctionsModuleConfig {
     getAuthHeaders?: () => Record<string, string>;
     baseURL?: string;
+    /**
+     * Resolves once the client's session is settled. `fetch` builds its headers
+     * by hand rather than through axios, so without this it would miss the gate
+     * every other request goes through.
+     */
+    waitForAuth?: () => Promise<void>;
 }
 /**
  * Functions module for invoking custom backend functions.

package/dist/utils/auth-utils.d.ts

@@ -5,7 +5,7 @@ import { GetAccessTokenOptions, SaveAccessTokenOptions, RemoveAccessTokenOptions
  * Low-level utility for manually retrieving tokens. In most cases, the Base44 client handles
  * token management automatically. This function is useful for custom authentication flows or when you need direct access to stored tokens. Requires a browser environment and can't be used in the backend.
  *
- * When a host platform has embedded the app with a one-time token (`?ott=`), that token is returned as it stands: it is what {@linkcode createClient} trades for the session, so a page that gates on "is there a token?" as it loads sees one. It is neither stored nor removed from the URL here.
+ * When a host platform has embedded the app with a one-time token (`?ott=`), that token is returned as it stands: it is what {@linkcode createClient} trades for the session, so a page that gates on "is there a token?" as it loads sees one. It is neither stored nor removed from the URL here, and it is reported only inside a frame, where such a token is redeemed.
  *
  * @internal
  *

package/dist/utils/auth-utils.js

@@ -1,11 +1,13 @@
-import { EMBED_TOKEN_PARAM } from "./embed-session.js";
+import { EMBED_TOKEN_PARAM, isFramed } from "./embed-session.js";
+/** The URL parameter a Base44 session token arrives on. */
+const DEFAULT_TOKEN_PARAM = "access_token";
 /**
  * Retrieves an access token from URL parameters or local storage.
  *
  * Low-level utility for manually retrieving tokens. In most cases, the Base44 client handles
  * token management automatically. This function is useful for custom authentication flows or when you need direct access to stored tokens. Requires a browser environment and can't be used in the backend.
  *
- * When a host platform has embedded the app with a one-time token (`?ott=`), that token is returned as it stands: it is what {@linkcode createClient} trades for the session, so a page that gates on "is there a token?" as it loads sees one. It is neither stored nor removed from the URL here.
+ * When a host platform has embedded the app with a one-time token (`?ott=`), that token is returned as it stands: it is what {@linkcode createClient} trades for the session, so a page that gates on "is there a token?" as it loads sees one. It is neither stored nor removed from the URL here, and it is reported only inside a frame, where such a token is redeemed.
  *
  * @internal
  *
@@ -38,7 +40,7 @@ import { EMBED_TOKEN_PARAM } from "./embed-session.js";
  * ```
  */
 export function getAccessToken(options = {}) {
-    const { storageKey = "base44_access_token", paramName = "access_token", saveToStorage = true, removeFromUrl = true, } = options;
+    const { storageKey = "base44_access_token", paramName = DEFAULT_TOKEN_PARAM, saveToStorage = true, removeFromUrl = true, } = options;
     let token = null;
     // Try to get token from URL parameters
     if (typeof window !== "undefined" && window.location) {
@@ -63,9 +65,16 @@ export function getAccessToken(options = {}) {
             // session yet — createClient takes it off the URL and exchanges it — but
             // it is the identity this load arrives with, and callers that read this
             // once as the page loads must not conclude there is none.
-            const embedToken = urlParams.get(EMBED_TOKEN_PARAM);
-            if (embedToken) {
-                return embedToken;
+            //
+            // Only in a frame, and only for the parameter a session arrives on: a
+            // one-time token is redeemed nowhere else, so a top-level load still
+            // carrying one (a URL rewrite the browser refused) must not have it
+            // applied as a session — and never saved as one.
+            if (paramName === DEFAULT_TOKEN_PARAM && isFramed()) {
+                const embedToken = urlParams.get(EMBED_TOKEN_PARAM);
+                if (embedToken) {
+                    return embedToken;
+                }
             }
         }
         catch (e) {

package/dist/utils/embed-session.d.ts

@@ -19,15 +19,23 @@ export declare const EMBED_TOKEN_PARAM = "ott";
  */
 export declare function takeEmbedTokenFromUrl(): string | null;
 /**
- * Whether this tab previously redeemed an embed token. Counts only inside a
- * frame: a top-level tab that once carried a token must fall back to the
- * regular login, or it could never sign in again.
+ * Whether this document is rendered inside a frame. Read at call time, not at
+ * import: a module-level answer would be fixed before a host (or a test) has
+ * set the window up.
  *
  * @internal
  */
-export declare function isEmbeddedTab(): boolean;
+export declare function isFramed(): boolean;
+/**
+ * Whether this tab previously redeemed an embed token for this app. Counts only
+ * inside a frame: a top-level tab that once carried a token must fall back to
+ * the regular login, or it could never sign in again.
+ *
+ * @internal
+ */
+export declare function isEmbeddedTab(appId: string): boolean;
 /** @internal */
-export declare function markEmbeddedTab(): void;
+export declare function markEmbeddedTab(appId: string): void;
 /**
  * Trades a one-time embed token for an app-user session token. Resolves to
  * `null` when the platform refuses the token; never throws.
@@ -43,8 +51,12 @@ export declare function exchangeEmbedToken({ serverUrl, appId, ott, fetchImpl, }
 /**
  * Covers the page with a plain "session ended" notice. An embedded session can
  * only be renewed by the host platform, so this stands in for the login
- * redirect, which cannot complete inside a frame. The copy points at the host
- * page: reloading the frame itself carries no token and lands here again.
+ * redirect: only the platform can mint the next session. The copy points at the
+ * host page: reloading the frame itself carries no token and lands here again.
+ *
+ * This is the default an app that predates embedding gets. An app that wants its
+ * own can pass `options.onEmbedSessionEnded` to {@linkcode createClient}, or
+ * check {@linkcode AuthModule.isEmbedded} before asking for a login.
  *
  * @internal
  */

package/dist/utils/embed-session.js

@@ -11,7 +11,9 @@
  */
 /** The query parameter a host platform puts the one-time token on. @internal */
 export const EMBED_TOKEN_PARAM = "ott";
-const EMBED_TAB_KEY = "base44_embed_session";
+const EMBED_TAB_KEY_PREFIX = "base44_embed_session";
+/** Per-app, so a second app framed on the same origin keeps its own answer. */
+const embedTabKey = (appId) => `${EMBED_TAB_KEY_PREFIX}:${appId}`;
 const GRANT_TYPE = "urn:ietf:params:oauth:grant-type:token-exchange";
 const SUBJECT_TOKEN_TYPE = "urn:base44:params:oauth:token-type:embed-ott";
 const RATE_LIMITED = 429;
@@ -47,30 +49,49 @@ export function takeEmbedTokenFromUrl() {
     return ott;
 }
 /**
- * Whether this tab previously redeemed an embed token. Counts only inside a
- * frame: a top-level tab that once carried a token must fall back to the
- * regular login, or it could never sign in again.
+ * Whether this document is rendered inside a frame. Read at call time, not at
+ * import: a module-level answer would be fixed before a host (or a test) has
+ * set the window up.
  *
  * @internal
  */
-export function isEmbeddedTab() {
+export function isFramed() {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    try {
+        return window.self !== window.top;
+    }
+    catch (_a) {
+        // Reaching the top window can be refused outright; if we cannot see it,
+        // we are certainly not it.
+        return true;
+    }
+}
+/**
+ * Whether this tab previously redeemed an embed token for this app. Counts only
+ * inside a frame: a top-level tab that once carried a token must fall back to
+ * the regular login, or it could never sign in again.
+ *
+ * @internal
+ */
+export function isEmbeddedTab(appId) {
     if (typeof window === "undefined") {
         return false;
     }
     // A cross-site frame is third-party storage, which some browsers block
     // outright — every access can throw, and the marker is then unavailable.
     try {
-        return (window.self !== window.top &&
-            window.sessionStorage.getItem(EMBED_TAB_KEY) === "1");
+        return (isFramed() && window.sessionStorage.getItem(embedTabKey(appId)) === "1");
     }
     catch (_a) {
         return false;
     }
 }
 /** @internal */
-export function markEmbeddedTab() {
+export function markEmbeddedTab(appId) {
     try {
-        window.sessionStorage.setItem(EMBED_TAB_KEY, "1");
+        window.sessionStorage.setItem(embedTabKey(appId), "1");
     }
     catch (_a) {
         /* storage blocked */
@@ -113,8 +134,12 @@ export async function exchangeEmbedToken({ serverUrl, appId, ott, fetchImpl = fe
 /**
  * Covers the page with a plain "session ended" notice. An embedded session can
  * only be renewed by the host platform, so this stands in for the login
- * redirect, which cannot complete inside a frame. The copy points at the host
- * page: reloading the frame itself carries no token and lands here again.
+ * redirect: only the platform can mint the next session. The copy points at the
+ * host page: reloading the frame itself carries no token and lands here again.
+ *
+ * This is the default an app that predates embedding gets. An app that wants its
+ * own can pass `options.onEmbedSessionEnded` to {@linkcode createClient}, or
+ * check {@linkcode AuthModule.isEmbedded} before asking for a login.
  *
  * @internal
  */
@@ -125,21 +150,28 @@ export function showEmbedSessionEnded() {
     if (document.getElementById(SESSION_ENDED_ELEMENT_ID)) {
         return;
     }
+    // Colors as custom properties in a stylesheet rather than inline, so the
+    // notice follows the reader's theme — including a change made while it is up.
+    const style = document.createElement("style");
+    style.textContent =
+        `#${SESSION_ENDED_ELEMENT_ID}{--b44-bg:#fff;--b44-fg:#0f172a;--b44-muted:#475569;}` +
+            `@media (prefers-color-scheme:dark){#${SESSION_ENDED_ELEMENT_ID}` +
+            `{--b44-bg:#0f172a;--b44-fg:#f8fafc;--b44-muted:#94a3b8;}}`;
     const overlay = document.createElement("div");
     overlay.id = SESSION_ENDED_ELEMENT_ID;
     overlay.setAttribute("role", "alert");
     overlay.style.cssText =
         "position:fixed;inset:0;z-index:2147483647;display:flex;align-items:center;" +
-            "justify-content:center;background:#fff;color:#0f172a;" +
+            "justify-content:center;background:var(--b44-bg);color:var(--b44-fg);" +
             "font-family:ui-sans-serif,system-ui,sans-serif;text-align:center;padding:2rem;";
     const title = document.createElement("h1");
     title.textContent = "Session ended";
     title.style.cssText = "font-size:1.5rem;font-weight:700;margin:0 0 .75rem;";
     const body = document.createElement("p");
     body.textContent = "Reload this page in your browser to start a new session.";
-    body.style.cssText = "margin:0;color:#475569;";
+    body.style.cssText = "margin:0;color:var(--b44-muted);";
     const card = document.createElement("div");
     card.append(title, body);
-    overlay.append(card);
+    overlay.append(style, card);
     document.body.append(overlay);
 }

package/dist/utils/fetch-with-auth.d.ts

@@ -33,11 +33,13 @@ export interface FetchWithAuthInit extends RequestInit {
  * has none, so nothing is sent.
  * @internal
  */
-export declare function createFetchWithAuth({ axios, serviceRoleAxios, appId, serverUrl, functionsVersion, platformHeaders, }: {
+export declare function createFetchWithAuth({ axios, serviceRoleAxios, appId, serverUrl, functionsVersion, platformHeaders, waitForAuth, }: {
     axios: AxiosInstance;
     serviceRoleAxios: AxiosInstance;
     appId: string;
     serverUrl: string;
     functionsVersion?: string;
     platformHeaders?: Record<string, string>;
+    /** Resolves once the client's session is settled. */
+    waitForAuth?: () => Promise<void>;
 }): (path: string, init?: FetchWithAuthInit) => Promise<Response>;

package/dist/utils/fetch-with-auth.js

@@ -21,7 +21,7 @@
  * has none, so nothing is sent.
  * @internal
  */
-export function createFetchWithAuth({ axios, serviceRoleAxios, appId, serverUrl, functionsVersion, platformHeaders, }) {
+export function createFetchWithAuth({ axios, serviceRoleAxios, appId, serverUrl, functionsVersion, platformHeaders, waitForAuth, }) {
     const inherited = new Headers(platformHeaders);
     const bearer = (client) => {
         const header = client.defaults.headers.common["Authorization"];
@@ -31,6 +31,9 @@ export function createFetchWithAuth({ axios, serviceRoleAxios, appId, serverUrl,
     };
     return async function fetchWithAuth(path, init = {}) {
         assertOwnOriginPath(path);
+        // The Authorization below is read off the axios defaults, which a session
+        // still being negotiated has not written yet.
+        await (waitForAuth === null || waitForAuth === void 0 ? void 0 : waitForAuth());
         const { fetch: transport = fetch, ...requestInit } = init;
         const headers = new Headers(init.headers);
         // A caller-supplied value always wins, so a route can hand the callee a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.48-pr.282.028b41c",
+  "version": "0.8.48-pr.282.081f33c",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",