feat(connectors): add OAuth flow handling with browser redirect and polling

[Paveltarno]

Note

Description

This PR adds a complete connectors management system to the Base44 CLI, enabling users to configure and push OAuth-based integrations (Google Calendar, Slack, Notion, etc.) to their Base44 apps. It includes the new base44 connectors push command with interactive OAuth flow handling that opens the user's browser and polls for authorization completion.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

CLI Layer:

• Added src/cli/commands/connectors/index.ts - Parent command for connector management
• Added src/cli/commands/connectors/push.ts - Push command with OAuth flow orchestration, user prompts, and summary output
• Registered connectors command in program.ts

Core Layer:

• Created src/core/resources/connector/oauth.ts - runOAuthFlow() function that opens browser and polls OAuth status (2-minute timeout)
• Updated src/core/resources/connector/api.ts - Renamed syncConnector to setConnector, changed endpoint from POST /sync to PUT /integrations/{type}
• Updated src/core/resources/connector/push.ts - Adapted to new API endpoint and response format
• Updated src/core/resources/connector/schema.ts - Renamed OAuthPollingStatus to ConnectorOAuthStatus, updated connector status values to lowercase, made error fields nullable
• Simplified src/core/resources/connector/config.ts - Removed filename-type validation (no longer required)
• Integrated connectors into project config loading (project/config.ts, project/schema.ts, project/types.ts)

Tests:

• Added tests/cli/connectors_push.spec.ts - CLI integration tests covering push scenarios, OAuth flows, and error cases
• Updated tests/core/connectors.spec.ts - Unit tests for OAuth flow with polling behavior
• Added connector-related mocks to tests/cli/testkit/Base44APIMock.ts
• Removed obsolete connector-type-mismatch fixture

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (npm test)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated AGENTS.md if I made architectural changes

Additional Notes

• The OAuth flow automatically skips in CI environments to avoid blocking automated tests
• Users can authorize connectors later by re-running base44 connectors push
• The command syncs local connectors, updates scopes, and removes unlisted remote connectors
• Error handling is per-connector, so one failing connector doesn't block others
• Uses p-wait-for with TimeoutError for clean timeout handling (2-minute polling window)

---

_{🤖 Generated by Claude | 2026-02-08 15:47 UTC}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.28-pr.192.83d7b55

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.0.28-pr.192.83d7b55"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.28-pr.192.83d7b55"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.0.28-pr.192.83d7b55
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}

[claude]

---

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

---