@base44-preview/sdk 0.8.20-pr.136.cbfe0f7 → 0.8.20-pr.136.ee4a41b

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,13 +44,16 @@ 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 |
  * |---|---|
+ * | Box | `box` |
+ * | ClickUp | `clickup` |
  * | Discord | `discord` |
  * | GitHub | `github` |
  * | Gmail | `gmail` |
+ * | Google Analytics | `google_analytics` |
  * | Google BigQuery | `googlebigquery` |
  * | Google Calendar | `googlecalendar` |
  * | Google Docs | `googledocs` |
@@ -64,6 +67,7 @@ export interface ConnectorConnectionResponse {
  * | Slack User | `slack` |
  * | Slack Bot | `slackbot` |
  * | TikTok | `tiktok` |
+ * | Wrike | `wrike` |
  *
  * See the integration guides for more details:
  *
@@ -82,7 +86,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
@@ -149,39 +153,61 @@ export interface ConnectorsModule {
      */
     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).
      *
-     * 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).
+     * 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`.
      *
-     * @param integrationType - The type of integration, such as `'googlecalendar'`, `'slack'`, or `'github'`.
+     * 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'`, `'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>;

package/package.json

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