@base44-preview/sdk 0.8.19-pr.135.d9d067f → 0.8.20-pr.130.bda52d3

package/dist/client.js

@@ -3,7 +3,7 @@ import { createEntitiesModule } from "./modules/entities.js";
 import { createIntegrationsModule } from "./modules/integrations.js";
 import { createAuthModule } from "./modules/auth.js";
 import { createSsoModule } from "./modules/sso.js";
-import { createConnectorsModule } from "./modules/connectors.js";
+import { createConnectorsModule, createUserConnectorsModule, } from "./modules/connectors.js";
 import { getAccessToken } from "./utils/auth-utils.js";
 import { createFunctionsModule } from "./modules/functions.js";
 import { createAgentsModule } from "./modules/agents.js";
@@ -108,12 +108,14 @@ export function createClient(config) {
         serverUrl,
     });
     const userModules = {
+        axiosClient,
         entities: createEntitiesModule({
             axios: axiosClient,
             appId,
             getSocket,
         }),
         integrations: createIntegrationsModule(axiosClient, appId),
+        connectors: createUserConnectorsModule(axiosClient, appId),
         auth: userAuthModule,
         functions: createFunctionsModule(functionsAxiosClient, appId),
         agents: createAgentsModule({
@@ -139,6 +141,7 @@ export function createClient(config) {
         },
     };
     const serviceRoleModules = {
+        axiosClient: serviceRoleAxiosClient,
         entities: createEntitiesModule({
             axios: serviceRoleAxiosClient,
             appId,

package/dist/client.types.d.ts

@@ -1,8 +1,9 @@
+import type { AxiosInstance } from "axios";
 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 { ConnectorsModule, UserConnectorsModule } 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";
@@ -82,6 +83,10 @@ export interface Base44Client {
     appLogs: AppLogsModule;
     /** {@link AuthModule | Auth module} for user authentication and management. */
     auth: AuthModule;
+    /** The underlying Axios instance used for API requests. Useful for making custom API calls with the same authentication and configuration as the SDK. */
+    axiosClient: AxiosInstance;
+    /** {@link UserConnectorsModule | Connectors module} for end-user OAuth flows. */
+    connectors: UserConnectorsModule;
     /** {@link EntitiesModule | Entities module} for CRUD operations on your data models. */
     entities: EntitiesModule;
     /** {@link FunctionsModule | Functions module} for invoking custom backend functions. */
@@ -117,6 +122,8 @@ export interface Base44Client {
     readonly asServiceRole: {
         /** {@link AgentsModule | Agents module} with elevated permissions. */
         agents: AgentsModule;
+        /** The underlying Axios instance used for service role API requests. Useful for making custom API calls with service role authentication. */
+        axiosClient: AxiosInstance;
         /** {@link AppLogsModule | App logs module} with elevated permissions. */
         appLogs: AppLogsModule;
         /** {@link ConnectorsModule | Connectors module} for OAuth token retrieval. */

package/dist/index.d.ts

@@ -11,6 +11,6 @@ export type { FunctionsModule, FunctionName, FunctionNameRegistry, } from "./mod
 export type { AgentsModule, AgentName, AgentNameRegistry, AgentConversation, AgentMessage, AgentMessageReasoning, AgentMessageToolCall, AgentMessageUsage, AgentMessageCustomContext, AgentMessageMetadata, CreateConversationParams, } from "./modules/agents.types.js";
 export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
-export type { ConnectorsModule } from "./modules/connectors.types.js";
+export type { ConnectorsModule, UserConnectorsModule, } 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/auth.types.d.ts

@@ -181,11 +181,11 @@ export interface AuthModule {
      * Initiates an OAuth login flow with one of the built-in providers. Requires a browser environment and can't be used in the backend.
      *
      * Supported providers:
-     * - `'google'` - {@link https://developers.google.com/identity/protocols/oauth2 | Google OAuth}. Enabled by default.
-     * - `'microsoft'` - {@link https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow | Microsoft OAuth}. Enable Microsoft in your app's authentication settings before specifying this provider.
-     * - `'facebook'` - {@link https://developers.facebook.com/docs/facebook-login | Facebook Login}. Enable Facebook in your app's authentication settings before using.
-     * - `'apple'` - {@link https://developer.apple.com/sign-in-with-apple/ | Sign in with Apple}. Enable Apple in your app's authentication settings before using this provider.
-     * - `'sso'` - Enterprise SSO. Enable SSO in your app's authentication settings before using this provider.
+     * - `'google'`: {@link https://developers.google.com/identity/protocols/oauth2 | Google OAuth}. Enabled by default.
+     * - `'microsoft'`: {@link https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow | Microsoft OAuth}. Enable Microsoft in your app's authentication settings before specifying this provider.
+     * - `'facebook'`: {@link https://developers.facebook.com/docs/facebook-login | Facebook Login}. Enable Facebook in your app's authentication settings before using.
+     * - `'apple'`: {@link https://developer.apple.com/sign-in-with-apple/ | Sign in with Apple}. Enable Apple in your app's authentication settings before using this provider.
+     * - `'sso'`: Enterprise SSO. {@link https://docs.base44.com/Setting-up-your-app/Setting-up-SSO | Set up an SSO provider} in your app's authentication settings before using this provider.
      *
      * @param provider - The authentication provider to use: `'google'`, `'microsoft'`, `'facebook'`, `'apple'`, or `'sso'`.
      * @param fromUrl - URL to redirect to after successful authentication. Defaults to `'/'`.
@@ -213,6 +213,7 @@ export interface AuthModule {
      * // SSO
      * base44.auth.loginWithProvider('sso', '/dashboard');
      * ```
+     *
      */
     loginWithProvider(provider: string, fromUrl?: string): void;
     /**

package/dist/modules/connectors.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import { ConnectorsModule } from "./connectors.types.js";
+import { ConnectorsModule, UserConnectorsModule } from "./connectors.types.js";
 /**
  * Creates the Connectors module for the Base44 SDK.
  *
@@ -9,3 +9,12 @@ import { ConnectorsModule } from "./connectors.types.js";
  * @internal
  */
 export declare function createConnectorsModule(axios: AxiosInstance, appId: string): ConnectorsModule;
+/**
+ * Creates the user-scoped Connectors module (end-user OAuth flows).
+ *
+ * @param axios - Axios instance (user-scoped client)
+ * @param appId - Application ID
+ * @returns User connectors module with end-user OAuth methods
+ * @internal
+ */
+export declare function createUserConnectorsModule(axios: AxiosInstance, appId: string): UserConnectorsModule;

package/dist/modules/connectors.js

@@ -14,7 +14,6 @@ export function createConnectorsModule(axios, appId) {
          */
         // @ts-expect-error Return type mismatch with interface - implementation returns string, interface expects string but implementation is typed as ConnectorAccessTokenResponse
         async getAccessToken(integrationType) {
-            console.warn("[Base44 SDK] connectors.getAccessToken() is deprecated. Use getConnection(integrationType) and use the returned accessToken instead.");
             if (!integrationType || typeof integrationType !== "string") {
                 throw new Error("Integration type is required and must be a string");
             }
@@ -36,3 +35,38 @@ export function createConnectorsModule(axios, appId) {
         },
     };
 }
+/**
+ * Creates the user-scoped Connectors module (end-user OAuth flows).
+ *
+ * @param axios - Axios instance (user-scoped client)
+ * @param appId - Application ID
+ * @returns User connectors module with end-user OAuth methods
+ * @internal
+ */
+export function createUserConnectorsModule(axios, appId) {
+    return {
+        // @ts-expect-error Return type mismatch - implementation returns object, interface expects string
+        async getAppUserAccessToken(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            const response = await axios.get(`/apps/${appId}/end-user-auth/connectors/${connectorId}/token`);
+            // @ts-expect-error
+            return response.access_token;
+        },
+        async connectAppUser(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            const response = await axios.post(`/apps/${appId}/end-user-auth/connectors/${connectorId}/initiate`);
+            // @ts-expect-error
+            return response.redirect_url;
+        },
+        async disconnectAppUser(connectorId) {
+            if (!connectorId || typeof connectorId !== "string") {
+                throw new Error("Connector ID is required and must be a string");
+            }
+            await axios.delete(`/apps/${appId}/end-user-auth/connectors/${connectorId}`);
+        },
+    };
+}

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

@@ -24,7 +24,7 @@ export interface ConnectorAccessTokenResponse {
     connection_config: Record<string, string> | null;
 }
 /**
- * Camel-cased connection details returned by {@linkcode ConnectorsModule.getConnection | getConnection()}.
+ * Connection details.
  */
 export interface ConnectorConnectionResponse {
     /** The OAuth access token for the external service. */
@@ -33,15 +33,53 @@ export interface ConnectorConnectionResponse {
     connectionConfig: Record<string, string> | null;
 }
 /**
- * Connectors module for managing OAuth tokens for external services.
+ * Response from the connectors initiate endpoint.
+ */
+export interface ConnectorInitiateResponse {
+    redirect_url: string;
+}
+/**
+ * Connectors module for managing app-scoped OAuth tokens for external services.
  *
- * This module allows you to retrieve OAuth access tokens for external services that the app has connected to. Connectors are app-scoped. When an app builder connects an integration like Google Calendar or Slack, all users of the app share that same connection.
+ * This module allows you to retrieve OAuth access tokens for external services that the app has connected to. Connectors are app-scoped. When an app builder connects an integration like Google Calendar, Slack, or GitHub, all users of the app share that same connection.
  *
  * Unlike the integrations module that provides pre-built functions, connectors give you
  * raw OAuth tokens so you can call external service APIs directly with full control over
  * the API calls you make. This is useful when you need custom API interactions that aren't
  * covered by Base44's pre-built integrations.
  *
+ * ## Available connectors
+ *
+ * All connectors work through [`getConnection()`](#getconnection). Pass the integration type string and use the returned OAuth token to call the external service's API directly.
+ *
+ * | Service | Type identifier |
+ * |---|---|
+ * | Box | `box` |
+ * | ClickUp | `clickup` |
+ * | Discord | `discord` |
+ * | GitHub | `github` |
+ * | Gmail | `gmail` |
+ * | Google Analytics | `google_analytics` |
+ * | Google BigQuery | `googlebigquery` |
+ * | Google Calendar | `googlecalendar` |
+ * | Google Docs | `googledocs` |
+ * | Google Drive | `googledrive` |
+ * | Google Sheets | `googlesheets` |
+ * | Google Slides | `googleslides` |
+ * | HubSpot | `hubspot` |
+ * | LinkedIn | `linkedin` |
+ * | Notion | `notion` |
+ * | Salesforce | `salesforce` |
+ * | Slack User | `slack` |
+ * | Slack Bot | `slackbot` |
+ * | TikTok | `tiktok` |
+ * | Wrike | `wrike` |
+ *
+ * See the integration guides for more details:
+ *
+ * - **Scopes and permissions**: {@link https://docs.base44.com/Integrations/gmail-connector#gmail-scopes-and-permissions | Gmail}, {@link https://docs.base44.com/Integrations/linkedin-connector#linkedin-scopes-and-permissions | LinkedIn}, {@link https://docs.base44.com/Integrations/slack-connector#slack-scopes-and-permissions | Slack}
+ * - **Slack connector types**: {@link https://docs.base44.com/Integrations/slack-connector#about-the-slack-connectors | About the Slack connectors} explains the difference between `slack` and `slackbot`
+ *
  * ## Authentication Modes
  *
  * This module is only available to use with a client in service role authentication mode, which means it can only be used in backend environments.
@@ -52,15 +90,15 @@ export interface ConnectorConnectionResponse {
  */
 export interface ConnectorsModule {
     /**
-     * Retrieves an OAuth access token for a specific external integration type.
+     * Retrieves an OAuth access token for a specific [external integration type](#available-connectors).
      *
-     * @deprecated Use {@link getConnection} and use the returned `accessToken` (and `connectionConfig` when needed) instead.
+     * @deprecated Use {@link getConnection} instead.
      *
      * Returns the OAuth token string for an external service that an app builder
      * has connected to. This token represents the connected app builder's account
      * and can be used to make authenticated API calls to that external service on behalf of the app.
      *
-     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, or `'github'`.
+     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, `'slackbot'`, `'github'`, or `'discord'`. See [Available connectors](#available-connectors) for the full list.
      * @returns Promise resolving to the access token string.
      *
      * @example
@@ -82,8 +120,8 @@ export interface ConnectorsModule {
      *
      * @example
      * ```typescript
-     * // Slack connection
-     * // Get Slack OAuth token and list channels
+     * // Slack User connection
+     * // Get Slack user token and list channels
      * const slackToken = await base44.asServiceRole.connectors.getAccessToken('slack');
      *
      * // List all public and private channels
@@ -95,43 +133,158 @@ export interface ConnectorsModule {
      *
      * const data = await slackResponse.json();
      * ```
+     *
+     * @example
+     * ```typescript
+     * // Slack Bot connection
+     * // Get Slack bot token and post a message with a custom bot identity
+     * const botToken = await base44.asServiceRole.connectors.getAccessToken('slackbot');
+     *
+     * const response = await fetch('https://slack.com/api/chat.postMessage', {
+     *   method: 'POST',
+     *   headers: {
+     *     'Authorization': `Bearer ${botToken}`,
+     *     'Content-Type': 'application/json'
+     *   },
+     *   body: JSON.stringify({
+     *     channel: '#alerts',
+     *     text: 'Deployment to production completed successfully.',
+     *     username: 'Deploy Bot',
+     *     icon_emoji: ':rocket:'
+     *   })
+     * });
+     *
+     * const result = await response.json();
+     * ```
      */
     getAccessToken(integrationType: ConnectorIntegrationType): Promise<string>;
     /**
-     * Retrieves the OAuth access token and connection configuration for a specific external integration type.
+     * Retrieves the OAuth access token and connection configuration for a specific [external integration type](#available-connectors).
+     *
+     * Some connectors require connection-specific parameters to build API calls.
+     * In such cases, the returned `connectionConfig` is an object with the additional parameters. If there are no extra parameters needed for the connection, the `connectionConfig` is `null`.
      *
-     * Returns both the OAuth token and any additional connection configuration
-     * that the connector provides. This is useful when the external service requires
-     * extra parameters beyond the access token (e.g., a shop domain, account ID, or API base URL).
+     * For example, a service might need a subdomain to construct the API URL in
+     * the form of `{subdomain}.example.com`. In such a case the subdomain will be available as a property of the `connectionConfig` object.
      *
-     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, or `'github'`.
+     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, `'slackbot'`, `'github'`, or `'discord'`. See [Available connectors](#available-connectors) for the full list.
      * @returns Promise resolving to a {@link ConnectorConnectionResponse} with `accessToken` and `connectionConfig`.
      *
      * @example
      * ```typescript
-     * // Basic usage
-     * const connection = await base44.asServiceRole.connectors.getConnection('googlecalendar');
-     * console.log(connection.accessToken);
-     * console.log(connection.connectionConfig);
+     * // Google Calendar connection
+     * // Get Google Calendar OAuth token and fetch upcoming events
+     * const { accessToken } = await base44.asServiceRole.connectors.getConnection('googlecalendar');
+     *
+     * const timeMin = new Date().toISOString();
+     * const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;
+     *
+     * const calendarResponse = await fetch(url, {
+     *   headers: { Authorization: `Bearer ${accessToken}` }
+     * });
+     *
+     * const events = await calendarResponse.json();
      * ```
      *
      * @example
      * ```typescript
-     * // Shopify: connectionConfig has subdomain (e.g. "my-store" for my-store.myshopify.com)
-     * const connection = await base44.asServiceRole.connectors.getConnection('shopify');
-     * const { accessToken, connectionConfig } = connection;
-     * const shop = connectionConfig?.subdomain
-     *   ? `https://${connectionConfig.subdomain}.myshopify.com`
-     *   : null;
-     *
-     * if (shop) {
-     *   const response = await fetch(
-     *     `${shop}/admin/api/2024-01/products.json?limit=10`,
-     *     { headers: { 'X-Shopify-Access-Token': accessToken } }
-     *   );
-     *   const { products } = await response.json();
-     * }
+     * // Slack connection
+     * // Get Slack OAuth token and list channels
+     * const { accessToken } = await base44.asServiceRole.connectors.getConnection('slack');
+     *
+     * const url = 'https://slack.com/api/conversations.list?types=public_channel,private_channel&limit=100';
+     *
+     * const slackResponse = await fetch(url, {
+     *   headers: { Authorization: `Bearer ${accessToken}` }
+     * });
+     *
+     * const data = await slackResponse.json();
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Using connectionConfig
+     * // Some connectors return a subdomain or other params needed to build the API URL
+     * const { accessToken, connectionConfig } = await base44.asServiceRole.connectors.getConnection('myservice');
+     *
+     * const subdomain = connectionConfig?.subdomain;
+     * const response = await fetch(
+     *   `https://${subdomain}.example.com/api/v1/resources`,
+     *   { headers: { Authorization: `Bearer ${accessToken}` } }
+     * );
+     *
+     * const data = await response.json();
      * ```
      */
     getConnection(integrationType: ConnectorIntegrationType): Promise<ConnectorConnectionResponse>;
 }
+/**
+ * User-scoped connectors module for managing end-user OAuth connections.
+ *
+ * This module provides methods for end-user OAuth flows: initiating an OAuth connection,
+ * retrieving the end user's access token, and disconnecting the end user's connection.
+ *
+ * Unlike {@link ConnectorsModule | ConnectorsModule} which manages app-scoped tokens,
+ * this module manages tokens scoped to individual end users. Methods are keyed on
+ * the connector ID (the OrgConnector's database ID) rather than the integration type.
+ *
+ * Available via `base44.connectors`.
+ */
+export interface UserConnectorsModule {
+    /**
+     * Retrieves an OAuth access token for an end user's connection to a specific connector.
+     *
+     * Returns the OAuth token string that belongs to the currently authenticated end user
+     * for the specified connector.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving to the access token string.
+     *
+     * @example
+     * ```typescript
+     * // Get the end user's access token for a connector
+     * const token = await base44.connectors.getAppUserAccessToken('abc123def');
+     *
+     * const response = await fetch('https://www.googleapis.com/calendar/v3/calendars/primary/events', {
+     *   headers: { 'Authorization': `Bearer ${token}` }
+     * });
+     * ```
+     */
+    getAppUserAccessToken(connectorId: string): Promise<string>;
+    /**
+     * Initiates the end-user OAuth flow for a specific connector.
+     *
+     * Returns a redirect URL that the end user should be navigated to in order to
+     * authenticate with the external service. The scopes and integration type are
+     * derived from the connector configuration server-side.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving to the redirect URL string.
+     *
+     * @example
+     * ```typescript
+     * // Start OAuth for the end user
+     * const redirectUrl = await base44.connectors.connectAppUser('abc123def');
+     *
+     * // Redirect the user to the OAuth provider
+     * window.location.href = redirectUrl;
+     * ```
+     */
+    connectAppUser(connectorId: string): Promise<string>;
+    /**
+     * Disconnects an end user's OAuth connection for a specific connector.
+     *
+     * Removes the stored OAuth credentials for the currently authenticated end user's
+     * connection to the specified connector.
+     *
+     * @param connectorId - The connector ID (OrgConnector database ID).
+     * @returns Promise resolving when the connection has been removed.
+     *
+     * @example
+     * ```typescript
+     * // Disconnect the end user's connection
+     * await base44.connectors.disconnectAppUser('abc123def');
+     * ```
+     */
+    disconnectAppUser(connectorId: string): Promise<void>;
+}

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

@@ -19,7 +19,7 @@ export type IntegrationEndpointFunction = (data: Record<string, any>) => Promise
  * ```typescript
  * await base44.integrations.Core.InvokeLLM({
  *   prompt: 'Explain quantum computing',
- *   model: 'gpt-4'
+ *   model: 'gpt_5'
  * });
  * ```
  *
@@ -41,6 +41,11 @@ export type IntegrationPackage = {
 export interface InvokeLLMParams {
     /** The prompt text to send to the model */
     prompt: string;
+    /** Optionally specify a model to override the app-level model setting for this specific call.
+     *
+     * Options: `"gpt_5_mini"`, `"gemini_3_flash"`, `"gpt_5"`, `"gemini_3_pro"`, `"claude_sonnet_4_6"`, `"claude_opus_4_6"`
+     */
+    model?: 'gpt_5_mini' | 'gemini_3_flash' | 'gpt_5' | 'gemini_3_pro' | 'claude_sonnet_4_6' | 'claude_opus_4_6';
     /** If set to `true`, the LLM will use Google Search, Maps, and News to gather real-time context before answering.
      * @default false
      */
@@ -362,7 +367,7 @@ export type IntegrationsModule = {
      * ```typescript
      * const response = await base44.integrations.Core.InvokeLLM({
      *   prompt: 'Explain quantum computing',
-     *   model: 'gpt-4'
+     *   model: 'gpt_5'
      * });
      * ```
      */
@@ -391,7 +396,7 @@ export type IntegrationsModule = {
      * ```typescript
      * const response = await base44.integrations.Core.InvokeLLM({
      *   prompt: 'Explain quantum computing',
-     *   model: 'gpt-4'
+     *   model: 'gpt_5'
      * });
      * ```
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.19-pr.135.d9d067f",
+  "version": "0.8.20-pr.130.bda52d3",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",