feat(connectors): add pull command

[Paveltarno]

Note

Description

Adds a new connectors pull command that syncs connector configurations from the Base44 server to local files. This command fetches remote connectors via the API and intelligently writes/updates/deletes local connector files to match the server state, preserving custom file names and comments where possible.

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 command that fetches connectors from Base44 and syncs to local files
• Implemented writeConnectors() function in connector/config.ts that handles intelligent file writing:
  • Creates/updates connector files based on remote state
  • Deletes local files for connectors that no longer exist remotely
  • Preserves existing file names (e.g., my-slack.jsonc) when updating connectors by type
  • Skips writing when data is unchanged to preserve comments and formatting
• Added fetchConnectors() API wrapper function as alias for listConnectors()
• Refactored connector reading logic to track file paths for intelligent updates
• Added comprehensive unit tests for writeConnectors() covering edge cases (duplicate types, file preservation, empty lists)
• Added CLI integration tests for the new 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 writeConnectors() function uses deep equality comparison to detect changes, ensuring local files are only rewritten when the data actually differs. This preserves user comments and custom formatting in connector config files. The function also handles type-based file matching rather than filename-based matching, allowing users to name their connector files however they prefer.

---

_{🤖 Generated by Claude | 2026-02-11 23:47 UTC}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.30-pr.214.4036a54

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.30-pr.214.4036a54"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.30-pr.214.4036a54"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.0.30-pr.214.4036a54
• 🔗 View this commit on GitHub

---

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