@base44-preview/cli 0.0.16-pr.95.3b2ce0c → 0.0.17-pr.104.ad47aa8

package/README.md

@@ -58,15 +58,15 @@ base44 link
 base44 link --create --name "my-app" --description "My app description"
 
 # Link to an existing project by ID (non-interactive)
-base44 link --existing <app-id>
+base44 link --projectId <app-id>
 ```
 
 | Option | Description |
 |--------|-------------|
 | `-c, --create` | Create a new project (skip selection prompt) |
-| `-e, --existing <id>` | Link to an existing project by ID |
 | `-n, --name <name>` | Project name (required with --create) |
 | `-d, --description <desc>` | Project description (optional) |
+| `-p, --projectId <id>` | Link to an existing project by ID (skips selection prompt) |
 
 ### Deployment
 
@@ -92,6 +92,60 @@ base44 link --existing <app-id>
 |---------|-------------|
 | `base44 site deploy` | Deploy built site files to Base44 hosting |
 
+### Connectors
+
+Manage OAuth integrations to connect your app with external services. Connectors are stored in the `connectors` property of your project's `config.jsonc` file.
+
+| Command | Description |
+|---------|-------------|
+| `base44 connectors add [type]` | Add and connect an OAuth integration |
+| `base44 connectors list` | List all connectors (local and connected) |
+| `base44 connectors push` | Sync connectors with backend (connect new, remove missing) |
+| `base44 connectors remove [type]` | Remove an integration |
+| `base44 connectors remove [type] --hard` | Permanently remove an integration |
+
+**Supported integrations:** Slack, Google Calendar, Google Drive, Gmail, Google Sheets, Google Docs, Google Slides, Notion, Salesforce, HubSpot, LinkedIn, TikTok
+
+**Example workflow:**
+```bash
+# Add a connector interactively (saves to config.jsonc and opens OAuth)
+base44 connectors add slack
+
+# List connectors showing local vs connected status
+base44 connectors list
+# Output:
+# ● Slack - user@example.com
+# ○ Google Calendar (not connected)
+
+# Sync all connectors (connects new, removes missing from config)
+base44 connectors push
+# Output:
+# 1 connector to connect:
+#   + Google Calendar
+# 1 connector to remove:
+#   - Notion (user@example.com)
+# Apply 2 changes? (Y/n)
+
+# Remove a single connector
+base44 connectors remove slack
+```
+
+**Configuration** (`base44/config.jsonc`):
+```jsonc
+{
+  "name": "my-app",
+  "connectors": {
+    "slack": {},
+    "googlecalendar": { "scopes": ["calendar.readonly"] }
+  }
+}
+```
+
+Once connected, use the SDK's `connectors.getAccessToken()` to retrieve tokens:
+```javascript
+const token = await base44.connectors.getAccessToken("slack");
+```
+
 ## Configuration
 
 ### Project Configuration