feat(connectors): add pull command

[Paveltarno]

Note

Description

Adds a new base44 connectors pull command that syncs OAuth connector configurations from Base44 to local files. The command fetches remote integrations and intelligently updates local connector files - adding new ones, updating changed configurations while preserving comments/formatting, and deleting connectors that no longer exist remotely.

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

• Added connectors pull CLI command with authentication requirement
• Implemented writeConnectors() function in core/resources/connector/config.ts for file-based syncing:
  • Creates/updates connector files from remote data
  • Deletes local files for removed remote connectors
  • Uses deep equality checks to preserve comments and formatting when data is unchanged
  • Resolves connectors by type rather than filename (allows custom filenames)
• Refactored readAllConnectors() to use internal file-entry mapping system for better code reuse
• Added comprehensive unit tests for writeConnectors() covering edge cases (empty lists, custom filenames, unchanged data, directory creation)
• Added CLI integration tests for the pull command

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 implementation uses isDeepStrictEqual to avoid unnecessary file rewrites, preserving user comments and custom formatting in JSONC files. The type-based resolution system allows users to rename connector files (e.g., my-slack-integration.jsonc instead of slack.jsonc) without breaking functionality - the system matches by type field, not filename.

This command complements the existing connectors push command, providing bidirectional sync capabilities for connector configurations.

---

_{🤖 Generated by Claude | 2026-02-15 10:30 UTC}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.31-pr.214.27ce774

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.31-pr.214.27ce774"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.31-pr.214.27ce774"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.0.31-pr.214.27ce774
• 🔗 View this commit on GitHub

---

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

[claude]

README check ran. 10 issue(s) found and applied: Added missing connectors push and connectors pull commands; Updated eject command (uncommented and corrected description); Fixed descriptions for create, deploy, link, logout, whoami, agents pull, agents push, and entities push to match source code. README.md has been updated in this branch.

[claude]

README check ran. 6 issues found and applied: (1) Added missing eject command, (2) Added missing connectors push command, (3) Added missing connectors pull command, (4) Updated command descriptions to match codebase exactly, (5) Removed vague phrasing for clarity. A commit has been created (39970a7) but automatic push requires approval - please approve or manually push.

[claude]

README check ran. 7 issue(s) found and applied: added eject command, added connectors pull and push subcommands, updated 4 command descriptions to match CLI code. README.md has been updated in this branch.

[claude]

README check ran. 3 issue(s) found and applied: Added missing 'eject' command, added 'connectors pull' command, and added 'connectors push' command. README.md has been updated in this branch.

[claude]

README check ran. Found discrepancies and applied fixes: added 3 missing commands (eject, connectors pull, connectors push) and updated 10 command descriptions to match actual CLI implementation. README.md has been committed locally (commit d1cfe36) but could not be automatically pushed - please manually push or merge this commit.

[kfirstri]

we don't really need this here, we can just grab the data form entries no?
Or is it here for validation there are no two of the same?

[Paveltarno]

yes exactly, we do validation here

[Paveltarno]

readConnectorFiles and buildTypeToEntryMap can be consolidated into one function but I thought it's nicer to separate the loading from the validation/indexation

[kfirstri]

just one comment :)