@base44-preview/sdk 0.8.42-pr.256.fb681e4 → 0.8.43-pr.256.e07d4b3

package/dist/client.js

@@ -113,6 +113,7 @@ export function createClient(config) {
     const userAuthModule = createAuthModule(axiosClient, functionsAxiosClient, appId, {
         appBaseUrl: normalizedAppBaseUrl,
         serverUrl,
+        token,
     });
     // Apply the access token before any module that may issue authenticated
     // requests during construction (notably analytics, which fires an init

package/dist/index.d.ts

@@ -14,6 +14,6 @@ export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { ActorsModule, ActorClient, ActorRef, Connection, ActorSubscription, ActorConnectOptions, ActorNameRegistry, ActorRegistry, } from "./modules/actors.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export { Actor, type Conn } from "./actor.js";
-export type { ConnectorsModule, UserConnectorsModule, ConnectorApiRequest, ConnectorApiResponse, } from "./modules/connectors.types.js";
+export type { ConnectorsModule, UserConnectorsModule, ConnectorApiRequest, ConnectorApiResponse, ConnectorApiResponsePhase, } from "./modules/connectors.types.js";
 export type { CustomIntegrationsModule, CustomIntegrationCallParams, CustomIntegrationCallResponse, } from "./modules/custom-integrations.types.js";
 export type { GetAccessTokenOptions, SaveAccessTokenOptions, RemoveAccessTokenOptions, GetLoginUrlOptions, } from "./utils/auth-utils.types.js";

package/dist/modules/analytics.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from "axios";
 import { TrackEventParams, AnalyticsModuleOptions } from "./analytics.types";
-import type { AuthModule } from "./auth.types";
+import type { InternalAuthModule } from "./auth.types";
 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__";
@@ -10,7 +10,7 @@ export interface AnalyticsModuleArgs {
     axiosClient: AxiosInstance;
     serverUrl: string;
     appId: string;
-    userAuthModule: AuthModule;
+    userAuthModule: InternalAuthModule;
 }
 export declare const createAnalyticsModule: ({ axiosClient, serverUrl, appId, userAuthModule, }: AnalyticsModuleArgs) => {
     track: (params: TrackEventParams) => void;

package/dist/modules/analytics.js

@@ -247,6 +247,13 @@ export function resetAnalyticsSessionContext() {
 }
 async function getSessionContext(userAuthModule) {
     if (!analyticsSharedState.sessionContext) {
+        // With no token there is no identity to resolve: `me()` can only answer 401,
+        // which the browser logs to the console before any handler here sees it. On
+        // a public page that request is the sole reason an error appears, so skip
+        // it. This is not memoized — a visitor who logs in later must still resolve.
+        if (!userAuthModule.hasToken()) {
+            return { user_id: null, session_id: getAnalyticsSessionId() };
+        }
         if (!sessionContextPromise) {
             const sessionId = getAnalyticsSessionId();
             sessionContextPromise = userAuthModule

package/dist/modules/auth.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import { AuthModule, AuthModuleOptions } from "./auth.types";
+import { AuthModuleOptions, InternalAuthModule } from "./auth.types";
 /**
  * Creates the auth module for the Base44 SDK.
  *
@@ -10,4 +10,4 @@ import { AuthModule, AuthModuleOptions } from "./auth.types";
  * @returns Auth module with authentication and user management methods
  * @internal
  */
-export declare function createAuthModule(axios: AxiosInstance, functionsAxiosClient: AxiosInstance, appId: string, options: AuthModuleOptions): AuthModule;
+export declare function createAuthModule(axios: AxiosInstance, functionsAxiosClient: AxiosInstance, appId: string, options: AuthModuleOptions): InternalAuthModule;

package/dist/modules/auth.js

@@ -78,7 +78,14 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
     const clearPendingMe = () => {
         pendingMe = null;
     };
+    // Tracked here rather than read off `axios.defaults` so the answer stays tied
+    // to the identity transitions below (`setToken`, `logout`) instead of to the
+    // header a caller may have set on the instance directly.
+    let hasAccessToken = Boolean(options.token);
     return {
+        hasToken() {
+            return hasAccessToken;
+        },
         // Get current user information
         async me() {
             const request = pendingMe !== null && pendingMe !== void 0 ? pendingMe : axios.get(`/apps/${appId}/entities/User/me`).finally(() => {
@@ -144,6 +151,7 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
             // flight would otherwise resolve into callers that run after the logout.
             clearPendingMe();
             resetAnalyticsSessionContext();
+            hasAccessToken = false;
             // Only do the rest if in a browser environment
             if (typeof window !== "undefined") {
                 // Remove token from localStorage
@@ -172,6 +180,7 @@ export function createAuthModule(axios, functionsAxiosClient, appId, options) {
             // resolved for the previous one must not be handed to later callers.
             clearPendingMe();
             resetAnalyticsSessionContext();
+            hasAccessToken = true;
             // handle token change for axios clients
             axios.defaults.headers.common["Authorization"] = `Bearer ${token}`;
             functionsAxiosClient.defaults.headers.common["Authorization"] = `Bearer ${token}`;

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

@@ -92,6 +92,12 @@ export interface AuthModuleOptions {
     serverUrl: string;
     /** Base URL for the app (used for login redirects). */
     appBaseUrl: string;
+    /**
+     * Access token the client was constructed with, if any. Seeds the module's
+     * view of whether a session exists before {@link AuthModule.setToken} runs,
+     * which is how the server-side SDK reports a token it never sets explicitly.
+     */
+    token?: string;
 }
 /**
  * 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.
@@ -515,3 +521,20 @@ export interface AuthModule {
      */
     changePassword(params: ChangePasswordParams): Promise<any>;
 }
+/**
+ * The auth module as constructed internally, before it is narrowed to
+ * {@link AuthModule} on the public client. Not exported from the package
+ * index — SDK consumers see only {@link AuthModule}.
+ *
+ * @internal
+ */
+export interface InternalAuthModule extends AuthModule {
+    /**
+     * Whether an access token is currently set on the client.
+     *
+     * Reports only the presence of a token, never its validity — an expired or
+     * revoked token still reads as `true`. Callers use this to skip requests that
+     * could not succeed without a session, not to decide that one is valid.
+     */
+    hasToken(): boolean;
+}

package/dist/modules/connectors.js

@@ -1,3 +1,11 @@
+const CONNECTOR_API_METHODS = new Set([
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "HEAD",
+]);
 /**
  * Creates the Connectors module for the Base44 SDK.
  *
@@ -89,13 +97,20 @@ function assertNonEmptyString(value, label) {
  * @internal
  */
 async function proxyCall(axios, url, request) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     if (!request || typeof request !== "object") {
         throw new Error("Request is required and must be an object");
     }
     assertNonEmptyString(request.path, "Request path");
+    const method = (_a = request.method) !== null && _a !== void 0 ? _a : "GET";
+    if (!CONNECTOR_API_METHODS.has(method)) {
+        throw new Error("Request method must be one of GET, POST, PUT, PATCH, DELETE, or HEAD");
+    }
     const response = await axios.post(url, {
-        method: ((_a = request.method) !== null && _a !== void 0 ? _a : "GET").toUpperCase(),
+        method,
+        // Omitted rather than sent as null so the proxy applies the connector's
+        // declared default host.
+        ...(request.host === undefined ? {} : { host: request.host }),
         path: request.path,
         query: (_b = request.query) !== null && _b !== void 0 ? _b : {},
         headers: (_c = request.headers) !== null && _c !== void 0 ? _c : {},
@@ -104,10 +119,13 @@ async function proxyCall(axios, url, request) {
     const data = response;
     return {
         success: data.success,
+        phase: data.phase,
         status: (_e = data.status_code) !== null && _e !== void 0 ? _e : null,
         data: data.data,
-        headers: (_f = data.headers) !== null && _f !== void 0 ? _f : {},
-        creditsCharged: (_g = data.credits_charged) !== null && _g !== void 0 ? _g : 0,
+        dataBase64: (_f = data.data_base64) !== null && _f !== void 0 ? _f : null,
+        contentType: (_g = data.content_type) !== null && _g !== void 0 ? _g : null,
+        headers: (_h = data.headers) !== null && _h !== void 0 ? _h : {},
+        creditsCharged: (_j = data.credits_charged) !== null && _j !== void 0 ? _j : 0,
     };
 }
 /**

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

@@ -41,12 +41,26 @@ export interface AppUserConnectorConnectionResponse {
     /** Key-value configuration for the connection, or `null` if the connector does not provide one. */
     connectionConfig: Record<string, string> | null;
 }
+/**
+ * How far a metered connector call progressed through the Base44 proxy.
+ *
+ * Only `not_sent` proves that the provider did not execute the request.
+ * `timed_out` and `sent_unconfirmed` may have executed upstream, so do not
+ * automatically retry non-idempotent requests based on those phases.
+ */
+export type ConnectorApiResponsePhase = "not_sent" | "responded" | "timed_out" | "sent_unconfirmed";
 /**
  * A request to forward to a metered connector's API through the Base44 proxy.
  */
 export interface ConnectorApiRequest {
     /** HTTP method for the upstream request. Defaults to `'GET'`. */
     method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";
+    /**
+     * Which of the connector's API hosts to call, by the name it declares.
+     * Omit for its default host (the first one declared). Only relevant for
+     * connectors that expose more than one host.
+     */
+    host?: string;
     /**
      * Path relative to the connector's API root, starting with `/`, such as `'/2/tweets'`.
      *
@@ -58,19 +72,31 @@ export interface ConnectorApiRequest {
     query?: Record<string, string | number | boolean | Array<string | number>>;
     /** Extra request headers. Only headers the connector explicitly allows are forwarded; the rest are dropped. */
     headers?: Record<string, string>;
-    /** JSON request body. Ignored for `GET`, `HEAD`, and `DELETE`. */
+    /** JSON request body. Ignored for `GET` and `HEAD`. */
     body?: unknown;
 }
 /**
  * The upstream API's response, as returned by the Base44 connector proxy.
  */
 export interface ConnectorApiResponse<T = unknown> {
-    /** `true` when the upstream API returned a 2xx status. */
+    /** `true` only when the upstream API returned a 2xx status. Proxy and upstream errors are `false`. */
     success: boolean;
-    /** The upstream HTTP status code, or `null` if the request never reached the provider. */
+    /** How far the call progressed. Only `not_sent` proves the provider did not execute it. */
+    phase: ConnectorApiResponsePhase;
+    /** The upstream HTTP status code, or `null` when no response was received. */
     status: number | null;
-    /** The parsed upstream response body. */
+    /**
+     * The parsed upstream response body, or proxy error details when no response
+     * was received. `null` when the response was binary — see {@link dataBase64}.
+     */
     data: T;
+    /**
+     * The response body base64-encoded, for the media types the connector declares
+     * as binary (images, PDFs). Set instead of {@link data}, never alongside it.
+     */
+    dataBase64: string | null;
+    /** The response media type, set only alongside {@link dataBase64}. */
+    contentType: string | null;
     /** The subset of upstream response headers the connector exposes, typically rate-limit counters. */
     headers: Record<string, string>;
     /** Integration credits billed to the workspace for this call. */
@@ -82,8 +108,11 @@ export interface ConnectorApiResponse<T = unknown> {
  */
 export interface ConnectorProxyRawResponse {
     success: boolean;
+    phase: ConnectorApiResponsePhase;
     status_code: number | null;
     data: unknown;
+    data_base64: string | null;
+    content_type: string | null;
     headers: Record<string, string>;
     credits_charged: number;
 }
@@ -126,7 +155,8 @@ export interface ConnectorProxyRawResponse {
  * Two things to keep in mind when writing against a metered connector:
  *
  * - **Cost varies by endpoint, sometimes sharply.** The same connector can charge two orders of magnitude more for one endpoint than another, so avoid putting an expensive call inside a loop and batch wherever the provider supports it. Each response reports what it actually cost as `creditsCharged`.
- * - **An upstream error is returned, not thrown.** A `4xx` or `5xx` from the provider comes back as `success: false` with the provider's own `status` and `data`, because it is a normal outcome of a call that Base44 completed. Only Base44-side failures — no connection, credits exhausted, a rejected request — reject the promise.
+ * - **Provider and transport outcomes are returned, not thrown.** A provider `4xx`/`5xx` or a connection failure comes back as `success: false` with its `phase`; authorization, quota, and invalid proxy requests reject the promise.
+ * - **Only `phase: 'not_sent'` proves the provider did not execute the request.** A timeout or in-flight failure may have executed upstream, so do not automatically retry a non-idempotent call unless the provider supports an idempotency key.
  *
  * ## Available connectors
  *

package/dist/utils/axios-client.js

@@ -185,11 +185,11 @@ export function createAxiosClient({ baseURL, headers = {}, token, interceptRespo
             }
             return response.data;
         }, (error) => {
-            var _a, _b, _c, _d, _e, _f, _g, _h;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
             const message = ((_b = (_a = error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.message) ||
                 ((_d = (_c = error.response) === null || _c === void 0 ? void 0 : _c.data) === null || _d === void 0 ? void 0 : _d.detail) ||
                 error.message;
-            const base44Error = new Base44Error(message, (_e = error.response) === null || _e === void 0 ? void 0 : _e.status, (_g = (_f = error.response) === null || _f === void 0 ? void 0 : _f.data) === null || _g === void 0 ? void 0 : _g.code, (_h = error.response) === null || _h === void 0 ? void 0 : _h.data, error);
+            const base44Error = new Base44Error(message, (_e = error.response) === null || _e === void 0 ? void 0 : _e.status, (_m = (_h = (_g = (_f = error.response) === null || _f === void 0 ? void 0 : _f.data) === null || _g === void 0 ? void 0 : _g.code) !== null && _h !== void 0 ? _h : (_l = (_k = (_j = error.response) === null || _j === void 0 ? void 0 : _j.headers) === null || _k === void 0 ? void 0 : _k.get) === null || _l === void 0 ? void 0 : _l.call(_k, "x-base44-connector-error")) !== null && _m !== void 0 ? _m : (_p = (_o = error.response) === null || _o === void 0 ? void 0 : _o.headers) === null || _p === void 0 ? void 0 : _p["x-base44-connector-error"], (_q = error.response) === null || _q === void 0 ? void 0 : _q.data, error);
             // Log errors in development
             if (process.env.NODE_ENV !== "production") {
                 safeErrorLog("[Base44 SDK Error]", base44Error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.42-pr.256.fb681e4",
+  "version": "0.8.43-pr.256.e07d4b3",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",