@base44-preview/sdk 0.8.19-pr.135.d9d067f → 0.8.20-pr.136.28e7eab

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

@@ -181,13 +181,12 @@ 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.
      *
-     * @param provider - The authentication provider to use: `'google'`, `'microsoft'`, `'facebook'`, `'apple'`, or `'sso'`.
+     * @param provider - The authentication provider to use: `'google'`, `'microsoft'`, `'facebook'`, or `'apple'`.
      * @param fromUrl - URL to redirect to after successful authentication. Defaults to `'/'`.
      *
      * @example
@@ -208,11 +207,6 @@ export interface AuthModule {
      * base44.auth.loginWithProvider('apple', '/dashboard');
      * ```
      *
-     * @example
-     * ```typescript
-     * // SSO
-     * base44.auth.loginWithProvider('sso', '/dashboard');
-     * ```
      */
     loginWithProvider(provider: string, fromUrl?: string): void;
     /**

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");
             }

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

@@ -35,13 +35,42 @@ export interface ConnectorConnectionResponse {
 /**
  * Connectors module for managing 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 [`getAccessToken()`](#getaccesstoken). Pass the integration type string and use the returned OAuth token to call the external service's API directly.
+ *
+ * | Service | Type identifier |
+ * |---|---|
+ * | Discord | `discord` |
+ * | GitHub | `github` |
+ * | Gmail | `gmail` |
+ * | 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` |
+ *
+ * Some connectors have dedicated setup guides: {@link https://docs.base44.com/Integrations/gmail-connector | Gmail}, {@link https://docs.base44.com/Integrations/linkedin-connector | LinkedIn}, and {@link https://docs.base44.com/Integrations/slack-connector | Slack} (covers both `slack` and `slackbot`).
+ *
+ * ### Slack User vs Slack Bot
+ *
+ * Base44 provides two Slack connectors: `slack` uses a user token and acts as the connected user, while `slackbot` uses a bot token with a customizable display name. Use `slack` when your app needs to read Slack data or act with a user's permissions. Use `slackbot` for sending automated messages as a branded bot. See the {@link https://docs.base44.com/Integrations/slack-connector | Slack connectors} guide for full details.
+ *
  * ## 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,7 +81,7 @@ 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.
      *
@@ -60,7 +89,7 @@ export interface ConnectorsModule {
      * 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 +111,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,6 +124,29 @@ 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>;
     /**

package/package.json

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