feat: WebDAV catalog and library browsing (#316)

* feat: WebDAV catalog and library browsing with configurable mappings

Add catalogs and libraries array fields to SDK config so users can
specify which catalog/library IDs to browse in the WebDAV tree.

The Catalogs and Libraries roots in the WebDAV browser are now
virtual roots that show configured IDs as expandable children
instead of attempting a PROPFIND on the bare path (which fails).

- Add catalogs/libraries to NormalizedConfig, DwJsonConfig, env-source
- New WebDavMappingsProvider seeds from config, supports runtime add/remove
- Add Catalog / Add Library commands (catalogs use OCAPI discovery)
- Browse in WebDAV context menu on library and static asset nodes
- contentLibrary falls back to libraries[0] for content tree default

* fix: use distinct contextValues for catalog/library virtual roots

Prevents Add Catalog from appearing on the Libraries root and vice
versa by using virtual-root-catalogs and virtual-root-libraries as
contextValues instead of relying on resourcePath matching.

* feat: WebDAV drag-and-drop and MOVE/COPY client methods

Add copy() and move() methods to the SDK WebDAV client using the
standard WebDAV Destination header pattern.

Implement TreeDragAndDropController for the WebDAV browser:
- Drop files from OS/VS Code explorer to upload (including directories)
- Drag files/directories within the tree to move via WebDAV MOVE
- Cross-root moves gated behind webdavCrossRootDragDrop setting (off by default)

* fix: validate internal MIME payload before treating as tree drop

External drops (e.g., from Finder) can produce a truthy but invalid
value for the internal tree MIME type. Validate the payload is actually
an array of webdav path strings before routing to the tree move handler,
otherwise fall through to the external upload handler.

* feat: add upload progress notification for drag-and-drop file uploads

Show incremental progress with file count and cancellation support
when uploading files via drag-and-drop to the WebDAV browser.

* fix: remove cross-root drag-and-drop, refresh tree after move

- Remove the webdavCrossRootDragDrop setting and cross-root move support
  (B2C Commerce doesn't support moves between WebDAV roots)
- Fire change events after a successful WebDAV MOVE so the source
  directory updates immediately without requiring a manual refresh

Author: clavery

packages/b2c-tooling-sdk/src/clients/webdav.ts

@@ -366,6 +366,56 @@ export class WebDavClient {
     return await this.parsePropfindResponse(xml);
   }
 
+  /**
+   * Copies a file or directory.
+   *
+   * @param source - Source path relative to /webdav/Sites/
+   * @param destination - Destination path relative to /webdav/Sites/
+   * @param overwrite - Whether to overwrite if destination exists (default: true)
+   *
+   * @example
+   * await client.copy('Cartridges/v1/cartridge', 'Cartridges/v2/cartridge');
+   */
+  async copy(source: string, destination: string, overwrite = true): Promise<void> {
+    const destUrl = this.buildUrl(destination);
+    const response = await this.request(source, {
+      method: 'COPY',
+      headers: {
+        Destination: new URL(destUrl).pathname,
+        Overwrite: overwrite ? 'T' : 'F',
+      },
+    });
+
+    if (!response.ok) {
+      throw new HTTPError(`COPY failed: ${response.status} ${response.statusText}`, response, 'COPY');
+    }
+  }
+
+  /**
+   * Moves (renames) a file or directory.
+   *
+   * @param source - Source path relative to /webdav/Sites/
+   * @param destination - Destination path relative to /webdav/Sites/
+   * @param overwrite - Whether to overwrite if destination exists (default: true)
+   *
+   * @example
+   * await client.move('Cartridges/v1/old-name', 'Cartridges/v1/new-name');
+   */
+  async move(source: string, destination: string, overwrite = true): Promise<void> {
+    const destUrl = this.buildUrl(destination);
+    const response = await this.request(source, {
+      method: 'MOVE',
+      headers: {
+        Destination: new URL(destUrl).pathname,
+        Overwrite: overwrite ? 'T' : 'F',
+      },
+    });
+
+    if (!response.ok) {
+      throw new HTTPError(`MOVE failed: ${response.status} ${response.statusText}`, response, 'MOVE');
+    }
+  }
+
   /**
    * Checks if a path exists.
    *

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

@@ -79,6 +79,10 @@ export interface DwJsonConfig {
   cartridges?: string | string[];
   /** Default content library ID for content export/list commands */
   contentLibrary?: string;
+  /** Catalog IDs for WebDAV browsing */
+  catalogs?: string[];
+  /** Library IDs for WebDAV browsing */
+  libraries?: string[];
   /** Optional CIP analytics host override */
   cipHost?: string;
   /** Path to PKCS12 certificate file for mTLS (two-factor auth) */

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

@@ -155,6 +155,8 @@ export function mapDwJsonToNormalizedConfig(json: DwJsonConfig): NormalizedConfi
     realm: json.realm,
     cartridges: parseCartridges(json.cartridges),
     contentLibrary: json.contentLibrary,
+    catalogs: json.catalogs,
+    libraries: json.libraries,
     cipHost: json.cipHost,
     instanceName: json.name,
     authMethods: json.authMethods,
@@ -241,6 +243,12 @@ export function mapNormalizedConfigToDwJson(config: Partial<NormalizedConfig>, n
   if (config.cartridges !== undefined) {
     result.cartridges = config.cartridges;
   }
+  if (config.catalogs !== undefined) {
+    result.catalogs = config.catalogs;
+  }
+  if (config.libraries !== undefined) {
+    result.libraries = config.libraries;
+  }
   if (config.cipHost !== undefined) {
     result.cipHost = config.cipHost;
   }
@@ -367,6 +375,8 @@ export function mergeConfigsWithProtection(
       tenantId: overrides.tenantId ?? base.tenantId,
       cartridges: overrides.cartridges ?? base.cartridges,
       contentLibrary: overrides.contentLibrary ?? base.contentLibrary,
+      catalogs: overrides.catalogs ?? base.catalogs,
+      libraries: overrides.libraries ?? base.libraries,
       cipHost: overrides.cipHost ?? base.cipHost,
       sandboxApiHost: overrides.sandboxApiHost ?? base.sandboxApiHost,
       realm: overrides.realm ?? base.realm,

packages/b2c-tooling-sdk/src/config/sources/env-source.ts

@@ -38,6 +38,8 @@ const ENV_VAR_MAP: Record<string, keyof NormalizedConfig> = {
   SFCC_SHORTCODE: 'shortCode',
   SFCC_TENANT_ID: 'tenantId',
   SFCC_CARTRIDGES: 'cartridges',
+  SFCC_CATALOGS: 'catalogs',
+  SFCC_LIBRARIES: 'libraries',
   SFCC_AUTH_METHODS: 'authMethods',
   SFCC_ACCOUNT_MANAGER_HOST: 'accountManagerHost',
   SFCC_SANDBOX_API_HOST: 'sandboxApiHost',
@@ -53,7 +55,7 @@ const ENV_VAR_MAP: Record<string, keyof NormalizedConfig> = {
 };
 
 /** Fields that should be parsed as comma-separated arrays. */
-const ARRAY_FIELDS = new Set<keyof NormalizedConfig>(['scopes', 'authMethods', 'cartridges']);
+const ARRAY_FIELDS = new Set<keyof NormalizedConfig>(['scopes', 'authMethods', 'cartridges', 'catalogs', 'libraries']);
 
 /** Fields that should be parsed as booleans. */
 const BOOLEAN_FIELDS = new Set<keyof NormalizedConfig>(['selfSigned']);

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

@@ -95,6 +95,12 @@ export interface NormalizedConfig {
   /** Default content library ID for content export/list commands */
   contentLibrary?: string;
 
+  /** Catalog IDs for WebDAV browsing */
+  catalogs?: string[];
+
+  /** Library IDs for WebDAV browsing */
+  libraries?: string[];
+
   // CIP
   /** Optional CIP analytics host override */
   cipHost?: string;

packages/b2c-vs-extension/package.json

@@ -316,6 +316,36 @@
         "icon": "$(root-folder-opened)",
         "category": "B2C DX"
       },
+      {
+        "command": "b2c-dx.webdav.addCatalog",
+        "title": "Add Catalog",
+        "icon": "$(add)",
+        "category": "B2C DX"
+      },
+      {
+        "command": "b2c-dx.webdav.removeCatalog",
+        "title": "Remove Catalog",
+        "icon": "$(remove)",
+        "category": "B2C DX"
+      },
+      {
+        "command": "b2c-dx.webdav.addLibrary",
+        "title": "Add Library",
+        "icon": "$(add)",
+        "category": "B2C DX"
+      },
+      {
+        "command": "b2c-dx.webdav.removeLibrary",
+        "title": "Remove Library",
+        "icon": "$(remove)",
+        "category": "B2C DX"
+      },
+      {
+        "command": "b2c-dx.content.browseWebdav",
+        "title": "Browse in WebDAV",
+        "icon": "$(folder-opened)",
+        "category": "B2C DX"
+      },
       {
         "command": "b2c-dx.content.refresh",
         "title": "Refresh",
@@ -431,19 +461,39 @@
         }
       ],
       "view/item/context": [
+        {
+          "command": "b2c-dx.webdav.addCatalog",
+          "when": "view == b2cWebdavExplorer && viewItem == virtual-root-catalogs",
+          "group": "0_add@0"
+        },
+        {
+          "command": "b2c-dx.webdav.addLibrary",
+          "when": "view == b2cWebdavExplorer && viewItem == virtual-root-libraries",
+          "group": "0_add@0"
+        },
+        {
+          "command": "b2c-dx.webdav.removeCatalog",
+          "when": "view == b2cWebdavExplorer && viewItem == catalog-mapping",
+          "group": "2_manage@1"
+        },
+        {
+          "command": "b2c-dx.webdav.removeLibrary",
+          "when": "view == b2cWebdavExplorer && viewItem == library-mapping",
+          "group": "2_manage@1"
+        },
         {
           "command": "b2c-dx.webdav.newFile",
-          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|directory)$/",
+          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|catalog-mapping|library-mapping|directory)$/",
           "group": "1_modification@0"
         },
         {
           "command": "b2c-dx.webdav.newFolder",
-          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|directory)$/",
+          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|catalog-mapping|library-mapping|directory)$/",
           "group": "1_modification@1"
         },
         {
           "command": "b2c-dx.webdav.uploadFile",
-          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|directory)$/",
+          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|catalog-mapping|library-mapping|directory)$/",
           "group": "1_modification@2"
         },
         {
@@ -463,7 +513,7 @@
         },
         {
           "command": "b2c-dx.webdav.mountWorkspace",
-          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|directory)$/",
+          "when": "view == b2cWebdavExplorer && viewItem =~ /^(root|catalog-mapping|library-mapping|directory)$/",
           "group": "3_workspace@1"
         },
         {
@@ -486,6 +536,11 @@
           "when": "view == b2cContentExplorer && viewItem == library",
           "group": "2_manage@1"
         },
+        {
+          "command": "b2c-dx.content.browseWebdav",
+          "when": "view == b2cContentExplorer && viewItem =~ /^(library|static)$/",
+          "group": "3_webdav@1"
+        },
         {
           "command": "b2c-dx.sandbox.create",
           "when": "view == b2cSandboxExplorer && viewItem == realm",
@@ -605,6 +660,18 @@
           "command": "b2c-dx.sandbox.extendExpiration",
           "when": "false"
         },
+        {
+          "command": "b2c-dx.webdav.removeCatalog",
+          "when": "false"
+        },
+        {
+          "command": "b2c-dx.webdav.removeLibrary",
+          "when": "false"
+        },
+        {
+          "command": "b2c-dx.content.browseWebdav",
+          "when": "false"
+        },
         {
           "command": "b2c-dx.webdav.newFolder",
           "when": "false"

packages/b2c-vs-extension/src/content-tree/content-commands.ts

@@ -236,5 +236,29 @@ export function registerContentCommands(
     vscode.window.showInformationMessage('Site archive imported successfully.');
   });
 
-  return [refresh, addLibrary, removeLibrary, exportCmd, exportNoAssets, exportAssets, filter, clearFilter, importCmd];
+  const browseWebdav = vscode.commands.registerCommand('b2c-dx.content.browseWebdav', async (node: ContentTreeItem) => {
+    if (!node) return;
+
+    if (node.nodeType === 'library') {
+      await vscode.commands.executeCommand('b2c-dx.webdav.revealLibrary', node.libraryId);
+    } else if (node.nodeType === 'static') {
+      // Static assets have a webdav path: Libraries/{libraryId}/default/{path}
+      const cleanPath = node.contentId.startsWith('/') ? node.contentId.slice(1) : node.contentId;
+      const webdavPath = `Libraries/${node.libraryId}/default/${cleanPath}`;
+      await vscode.commands.executeCommand('b2c-dx.webdav.revealPath', webdavPath);
+    }
+  });
+
+  return [
+    refresh,
+    addLibrary,
+    removeLibrary,
+    exportCmd,
+    exportNoAssets,
+    exportAssets,
+    filter,
+    clearFilter,
+    importCmd,
+    browseWebdav,
+  ];
 }

packages/b2c-vs-extension/src/content-tree/content-config.ts

@@ -32,7 +32,8 @@ export class ContentConfigProvider {
   }
 
   getContentLibrary(): string | undefined {
-    return this.configProvider.getConfig()?.values.contentLibrary;
+    const config = this.configProvider.getConfig();
+    return config?.values.contentLibrary ?? config?.values.libraries?.[0];
   }
 
   getLibraries(): BrowsedLibrary[] {

packages/b2c-vs-extension/src/content-tree/content-tree-provider.ts

@@ -142,7 +142,8 @@ export class ContentTreeDataProvider implements vscode.TreeDataProvider<ContentT
       return [];
     }
 
-    // Auto-add configured library if list is empty
+    // Auto-add configured library if list is empty.
+    // Prefer explicit contentLibrary, fall back to libraries[0] from config.
     const libraries = this.configProvider.getLibraries();
     if (libraries.length === 0) {
       const contentLibrary = this.configProvider.getContentLibrary();

packages/b2c-vs-extension/src/webdav-tree/index.ts

@@ -5,7 +5,9 @@
  */
 import * as vscode from 'vscode';
 import type {B2CExtensionConfig} from '../config-provider.js';
+import {WebDavDragAndDropController} from './webdav-dnd-controller.js';
 import {WEBDAV_SCHEME, WebDavFileSystemProvider} from './webdav-fs-provider.js';
+import {WebDavMappingsProvider} from './webdav-mappings.js';
 import {WebDavTreeDataProvider} from './webdav-tree-provider.js';
 import {registerWebDavCommands} from './webdav-commands.js';
 
@@ -16,14 +18,27 @@ export function registerWebDavTree(context: vscode.ExtensionContext, configProvi
     isCaseSensitive: true,
   });
 
-  const treeProvider = new WebDavTreeDataProvider(configProvider, fsProvider);
+  const mappingsProvider = new WebDavMappingsProvider(configProvider);
+  mappingsProvider.seedFromConfig();
+
+  const treeProvider = new WebDavTreeDataProvider(configProvider, fsProvider, mappingsProvider);
+
+  const dndController = new WebDavDragAndDropController(configProvider, fsProvider);
 
   const treeView = vscode.window.createTreeView('b2cWebdavExplorer', {
     treeDataProvider: treeProvider,
     showCollapseAll: true,
+    dragAndDropController: dndController,
   });
 
-  const commandDisposables = registerWebDavCommands(context, configProvider, treeProvider, fsProvider);
+  const commandDisposables = registerWebDavCommands(
+    context,
+    configProvider,
+    treeProvider,
+    treeView,
+    fsProvider,
+    mappingsProvider,
+  );
 
   // Auto-refresh when config changes (dw.json edit, manual reset, future instance switch)
   configProvider.onDidReset(() => {