feat: Code Sync for VS Code extension with cartridge management (#382)

* feat: add Code Sync feature to VS Code extension with cartridge management

Add file watcher with automatic upload, deploy command, cartridge tree view,
and code version management to the VS Code extension. Extract reusable
uploadFiles and downloadSingleCartridge functions in the SDK for efficient
per-file and per-cartridge operations.

SDK changes:
- Extract batch upload pipeline into uploadFiles() from watchCartridges()
- Add downloadSingleCartridge() for per-cartridge download (ZIPs only the
  target cartridge instead of entire code version)
- downloadCartridges() now uses per-cartridge download when include filter set
- Add autoUpload config field (dw.json: "autoUpload" / "auto-upload")

VS Code extension:
- CodeSyncManager: file watcher using VS Code FileSystemWatcher with debounced
  batch upload, status bar toggle, per-instance state persistence
- Deploy command with cartridge selection and activate/reload options
- Cartridge tree view with discovered cartridges and context menu actions:
  upload, download from instance, add/remove site cartridge path
- Code version management: list, create, activate, reload, delete
- Auto-start based on workspaceState or dw.json autoUpload setting
- Auto-detect new cartridges via .project file watcher
- Move API Browser to separate SCAPI sidebar

* fix: prettier formatting in upload-files.ts

Author: clavery

.changeset/code-upload-sdk.md

@@ -0,0 +1,5 @@
+---
+'@salesforce/b2c-tooling-sdk': minor
+---
+
+Add `uploadFiles` and `downloadSingleCartridge` functions for efficient per-file and per-cartridge operations. Extract batch upload pipeline from `watchCartridges` into reusable `uploadFiles` function. `downloadCartridges` now downloads individual cartridges when `include` filter is specified instead of zipping the entire code version. Add `autoUpload` config field for IDE auto-sync.

.changeset/code-upload-vscode.md

@@ -0,0 +1,5 @@
+---
+'b2c-vs-extension': minor
+---
+
+Add Code Sync feature: file watcher with automatic upload to instance, deploy command, cartridge tree view with download/upload/site path management, and code version management. Includes status bar toggle, per-instance state persistence, and `autoUpload` dw.json support. Move API Browser to separate SCAPI sidebar.

packages/b2c-tooling-sdk/src/config/dw-json.ts

@@ -75,6 +75,8 @@ export interface DwJsonConfig {
   sandboxApiHost?: string;
   /** Default ODS realm for sandbox operations */
   realm?: string;
+  /** Whether to auto-start code upload/sync in IDE extensions */
+  autoUpload?: boolean;
   /** Cartridge names to include in deploy/watch (string with colon/comma separators, or array) */
   cartridges?: string | string[];
   /** Default content library ID for content export/list commands */

packages/b2c-tooling-sdk/src/config/mapping.ts

@@ -156,6 +156,7 @@ export function mapDwJsonToNormalizedConfig(json: DwJsonConfig): NormalizedConfi
     tenantId: json.tenantId,
     sandboxApiHost: json.sandboxApiHost,
     realm: json.realm,
+    autoUpload: json.autoUpload,
     cartridges: parseCartridges(json.cartridges),
     contentLibrary: json.contentLibrary,
     catalogs: json.catalogs,
@@ -274,6 +275,9 @@ export function mapNormalizedConfigToDwJson(config: Partial<NormalizedConfig>, n
   if (config.accountManagerHost !== undefined) {
     result.accountManagerHost = config.accountManagerHost;
   }
+  if (config.autoUpload !== undefined) {
+    result.autoUpload = config.autoUpload;
+  }
   if (config.cartridges !== undefined) {
     result.cartridges = config.cartridges;
   }
@@ -420,6 +424,7 @@ export function mergeConfigsWithProtection(
       accountManagerHost: overrides.accountManagerHost ?? base.accountManagerHost,
       shortCode: overrides.shortCode ?? base.shortCode,
       tenantId: overrides.tenantId ?? base.tenantId,
+      autoUpload: overrides.autoUpload ?? base.autoUpload,
       cartridges: overrides.cartridges ?? base.cartridges,
       contentLibrary: overrides.contentLibrary ?? base.contentLibrary,
       catalogs: overrides.catalogs ?? base.catalogs,

packages/b2c-tooling-sdk/src/config/types.ts

@@ -89,6 +89,10 @@ export interface NormalizedConfig {
   /** MRT API origin URL override */
   mrtOrigin?: string;
 
+  // Code upload
+  /** Whether to auto-start code upload/sync in IDE extensions */
+  autoUpload?: boolean;
+
   // Cartridges
   /** Cartridge names to include in deploy/watch operations */
   cartridges?: string[];