@base44-preview/sdk 0.8.20-pr.136.aa1c529 → 0.8.20-pr.136.e0d0374

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

@@ -185,7 +185,7 @@ export interface AuthModule {
      * - `'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.
+     * - `'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 `'/'`.

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. */
@@ -44,7 +44,7 @@ export interface ConnectorConnectionResponse {
  *
  * ## 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.
+ * 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 |
  * |---|---|
@@ -65,11 +65,10 @@ export interface ConnectorConnectionResponse {
  * | 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`).
+ * See the integration guides for more details:
  *
- * ### 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.
+ * - **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
  *
@@ -83,7 +82,7 @@ export interface ConnectorsModule {
     /**
      * 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
@@ -153,36 +152,60 @@ export interface ConnectorsModule {
      * Retrieves the OAuth access token and connection configuration for a specific external integration type.
      *
      * 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).
+     * that the connector provides. Some connectors require connection-specific
+     * parameters to build API requests. For example, a service might need a
+     * subdomain to construct the API URL (`{subdomain}.example.com`), which
+     * is available in `connectionConfig`. Most connectors only need the
+     * `accessToken`; `connectionConfig` will be `null` when there are no
+     * extra parameters.
      *
      * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, or `'github'`.
      * @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
+     * // 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
-     * // 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();
-     * }
+     * // 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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.20-pr.136.aa1c529",
+  "version": "0.8.20-pr.136.e0d0374",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",