Add missing connector types and improve SDK docs

- Add slackbot, discord, googlebigquery, and github to connectors JSDoc
  with available connectors table and Slack User vs Bot explanation
- Expose ConnectorIntegrationType and ConnectorIntegrationTypeRegistry
  in generated docs via types-to-expose and appended-articles config
- Group connector types under Type Definitions in post-processing
- Fix copy-to-local-docs to support dropdowns navigation format
- Remove SSO from loginWithProvider docs (not ready for public docs)
- Switch auth provider list separators from hyphens to colons

Made-with: Cursor

Author: wixysam

.claude/skills/sdk-docs-writing/SKILL.md

@@ -196,6 +196,10 @@ mint dev
 
 When adding a new public type, add it to `types-to-expose.json`. When a helper type should live inside another page, add it to `appended-articles.json`.
 
+## Review checklist for multi-page changes
+
+When a docs task touches three or more pages in `mintlify-docs` (including pages regenerated by `create-docs-local`), create a `REVIEW-CHECKLIST.md` file in the mintlify-docs repo root listing every affected page with its URL path and what to verify. Split the list into intentional changes and side-effect changes from regeneration. Add a reminder to delete the file before committing. Tell the user the checklist exists so they can work through it at their own pace.
+
 ## Checklist before submitting a PR
 
 1. **JSDoc completeness:** Every public method has description, `@param`, `@returns`, and `@example`.

scripts/mintlify-post-processing/appended-articles.json

@@ -1,4 +1,8 @@
 {
+  "interfaces/ConnectorsModule": [
+    "type-aliases/ConnectorIntegrationType",
+    "interfaces/ConnectorIntegrationTypeRegistry"
+  ],
   "type-aliases/EntitiesModule": [
     "interfaces/EntityHandler",
     "type-aliases/EntityRecord",

scripts/mintlify-post-processing/copy-to-local-docs.js

@@ -160,7 +160,8 @@ function updateDocsJson(repoDir, sdkFiles) {
     `SDK Reference pages: ${JSON.stringify(sdkReferencePages, null, 2)}`
   );
 
-  // Navigate to: Developers tab -> anchors -> SDK anchor -> groups -> SDK Reference
+  // Navigate to: Developers tab -> SDK section -> groups -> SDK Reference
+  // Supports both legacy "anchors" format and current "dropdowns" format.
   const developersTab = docs.navigation.tabs.find(
     (tab) => tab.tab === "Developers"
   );
@@ -170,13 +171,13 @@ function updateDocsJson(repoDir, sdkFiles) {
     process.exit(1);
   }
 
-  // Find the SDK anchor
-  const sdkAnchor = developersTab.anchors?.find(
-    (anchor) => anchor.anchor === "SDK"
-  );
+  // Find the SDK section (try dropdowns first, then fall back to anchors)
+  const sdkAnchor =
+    developersTab.dropdowns?.find((d) => d.dropdown === "SDK") ??
+    developersTab.anchors?.find((a) => a.anchor === "SDK");
 
   if (!sdkAnchor) {
-    console.error("Could not find 'SDK' anchor in Developers tab");
+    console.error("Could not find 'SDK' dropdown or anchor in Developers tab");
     process.exit(1);
   }
 

scripts/mintlify-post-processing/file-processing/file-processing.js

@@ -1286,6 +1286,11 @@ function groupTypeDefinitions(content) {
 
   // Define type definition patterns for different modules
   const typeGroups = [
+    // Connectors module
+    {
+      types: ["ConnectorIntegrationType", "ConnectorIntegrationTypeRegistry"],
+      indicator: "ConnectorIntegrationType"
+    },
     // Entities module
     {
       types: ["EntityRecord", "EntityTypeRegistry", "SortField"],

scripts/mintlify-post-processing/types-to-expose.json

@@ -5,6 +5,8 @@
   "AnalyticsModule",
   "AppLogsModule",
   "AuthModule",
+  "ConnectorIntegrationType",
+  "ConnectorIntegrationTypeRegistry",
   "ConnectorsModule",
   "CustomIntegrationsModule",
   "DeleteManyResult",

src/modules/auth.types.ts

@@ -195,13 +195,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
@@ -222,11 +221,6 @@ export interface AuthModule {
    * base44.auth.loginWithProvider('apple', '/dashboard');
    * ```
    *
-   * @example
-   * ```typescript
-   * // SSO
-   * base44.auth.loginWithProvider('sso', '/dashboard');
-   * ```
    */
   loginWithProvider(provider: string, fromUrl?: string): void;
 

src/modules/connectors.types.ts

@@ -13,9 +13,10 @@ export interface ConnectorIntegrationTypeRegistry {}
  * const token = await base44.asServiceRole.connectors.getAccessToken('googlecalendar');
  * ```
  */
-export type ConnectorIntegrationType = keyof ConnectorIntegrationTypeRegistry extends never
-  ? string
-  : keyof ConnectorIntegrationTypeRegistry;
+export type ConnectorIntegrationType =
+  keyof ConnectorIntegrationTypeRegistry extends never
+    ? string
+    : keyof ConnectorIntegrationTypeRegistry;
 
 /**
  * Response from the connectors access token endpoint.
@@ -27,13 +28,43 @@ export interface ConnectorAccessTokenResponse {
 /**
  * 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` |
+ *
+ * ### Slack User vs Slack Bot
+ *
+ * Base44 provides two separate Slack connectors with different OAuth flows:
+ *
+ * - **`slack`** (Slack User): Uses a user token. API calls act as the connected Slack user. Requests user-level scopes such as reading conversations and searching message history. Some organizations restrict user-scope Slack apps.
+ * - **`slackbot`** (Slack Bot): Uses a bot token. API calls act as a bot with a customizable display name and icon. Requests bot-level scopes, which are more commonly allowed by organizations with stricter security policies. The bot can post to public channels without being invited and supports custom branding per message.
+ *
  * ## 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.
@@ -50,7 +81,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'`.
    * @returns Promise resolving to the access token string.
    *
    * @example
@@ -72,8 +103,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
@@ -85,6 +116,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>;
 }