@salesforce/b2c-tooling-sdk 1.7.0 → 1.8.0

package/dist/esm/operations/code/download.js

@@ -11,14 +11,169 @@ import { getActiveCodeVersion } from './versions.js';
 const ZIP_BODY = new URLSearchParams({ method: 'ZIP' }).toString();
 // 10 minutes — server-side zipping and large downloads can take a long time
 const LONG_OPERATION_TIMEOUT_MS = 600_000;
+// Progress helper: fires immediately (0s) then every 5s until stopped
+const PROGRESS_INTERVAL_MS = 5_000;
+function startProgress(phase, onProgress) {
+    const start = Date.now();
+    onProgress?.({ phase, elapsedSeconds: 0 });
+    if (!onProgress)
+        return () => { };
+    const interval = setInterval(() => {
+        onProgress({ phase, elapsedSeconds: Math.round((Date.now() - start) / 1000) });
+    }, PROGRESS_INTERVAL_MS);
+    return () => clearInterval(interval);
+}
+/**
+ * Resolves code version from instance config or OCAPI auto-discovery.
+ */
+async function resolveCodeVersion(instance) {
+    const logger = getLogger();
+    let codeVersion = instance.config.codeVersion;
+    if (!codeVersion) {
+        logger.debug('No code version configured, attempting to discover active version...');
+        try {
+            const activeVersion = await getActiveCodeVersion(instance);
+            if (activeVersion?.id) {
+                codeVersion = activeVersion.id;
+                instance.config.codeVersion = codeVersion;
+            }
+        }
+        catch (error) {
+            logger.debug({ error }, 'Failed to discover active code version');
+        }
+        if (!codeVersion) {
+            throw new Error('Code version required for download. Configure --code-version or ensure OAuth credentials are available for auto-discovery.');
+        }
+    }
+    return codeVersion;
+}
+/**
+ * Extracts files from a ZIP archive to disk.
+ *
+ * @param zip - Loaded JSZip instance
+ * @param options - Extraction options
+ * @param options.stripPrefix - Number of path segments to strip from ZIP entry paths (e.g. 1 to remove codeVersion, 2 to remove codeVersion + cartridgeName)
+ * @param options.outputDirectory - Base output directory
+ * @param options.mirror - Map of cartridge names to local paths for mirror extraction
+ * @param options.include - Cartridge names to include
+ * @param options.exclude - Cartridge names to exclude
+ * @returns Set of extracted cartridge names
+ */
+async function extractZip(zip, options) {
+    const extractedCartridges = new Set();
+    const entries = Object.values(zip.files).filter((entry) => !entry.dir);
+    for (const entry of entries) {
+        const parts = entry.name.split('/');
+        if (parts.length < options.stripPrefix + 1) {
+            continue;
+        }
+        // Strip the prefix segments
+        for (let i = 0; i < options.stripPrefix; i++) {
+            parts.shift();
+        }
+        // Determine cartridge name: either from the next segment or from the option
+        const cartridgeName = options.cartridgeName ?? parts.shift();
+        const relativePath = options.cartridgeName ? parts.join('/') : parts.join('/');
+        // Apply filters
+        if (options.include?.length && !options.include.includes(cartridgeName)) {
+            continue;
+        }
+        if (options.exclude?.length && options.exclude.includes(cartridgeName)) {
+            continue;
+        }
+        let targetPath;
+        if (options.mirror?.has(cartridgeName)) {
+            targetPath = path.join(options.mirror.get(cartridgeName), relativePath);
+        }
+        else {
+            targetPath = path.join(options.outputDirectory, cartridgeName, relativePath);
+        }
+        // Preserve existing file permissions
+        let existingMode = null;
+        try {
+            const stat = await fs.promises.stat(targetPath);
+            existingMode = stat.mode;
+        }
+        catch {
+            // File doesn't exist yet
+        }
+        await fs.promises.mkdir(path.dirname(targetPath), { recursive: true });
+        const content = await entry.async('nodebuffer');
+        await fs.promises.writeFile(targetPath, content);
+        if (existingMode !== null) {
+            await fs.promises.chmod(targetPath, existingMode);
+        }
+        extractedCartridges.add(cartridgeName);
+    }
+    return extractedCartridges;
+}
+/**
+ * Downloads a single cartridge from an instance via WebDAV.
+ *
+ * This is more efficient than downloading the entire code version when only
+ * one cartridge is needed, as it ZIPs only the cartridge subdirectory on the server.
+ *
+ * @param instance - B2C instance to download from
+ * @param codeVersion - Code version containing the cartridge
+ * @param cartridgeName - Name of the cartridge to download
+ * @param outputPath - Local path to extract the cartridge into
+ * @param onProgress - Optional progress callback
+ */
+export async function downloadSingleCartridge(instance, codeVersion, cartridgeName, outputPath, onProgress) {
+    const logger = getLogger();
+    const webdav = instance.webdav;
+    const cartridgePath = `Cartridges/${codeVersion}/${cartridgeName}`;
+    const zipPath = `${cartridgePath}.zip`;
+    let stopProgress = startProgress('zipping', onProgress);
+    logger.debug({ cartridgeName, codeVersion }, 'Requesting server-side zip for single cartridge...');
+    const zipResponse = await webdav.request(cartridgePath, {
+        method: 'POST',
+        body: ZIP_BODY,
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        signal: AbortSignal.timeout(LONG_OPERATION_TIMEOUT_MS),
+    });
+    stopProgress();
+    if (!zipResponse.ok) {
+        const text = await zipResponse.text();
+        throw new Error(`Failed to create server-side zip: ${zipResponse.status} ${zipResponse.statusText} - ${text}`);
+    }
+    stopProgress = startProgress('downloading', onProgress);
+    const dlResponse = await webdav.request(zipPath, {
+        method: 'GET',
+        signal: AbortSignal.timeout(LONG_OPERATION_TIMEOUT_MS),
+    });
+    if (!dlResponse.ok) {
+        stopProgress();
+        throw new Error(`Failed to download zip: ${dlResponse.status} ${dlResponse.statusText}`);
+    }
+    const buffer = await dlResponse.arrayBuffer();
+    stopProgress();
+    logger.debug({ size: buffer.byteLength }, `Archive downloaded: ${buffer.byteLength} bytes`);
+    // Cleanup server-side zip (best effort)
+    onProgress?.({ phase: 'cleanup', elapsedSeconds: 0 });
+    try {
+        await webdav.delete(zipPath);
+    }
+    catch (error) {
+        logger.warn({ error, zipPath }, 'Failed to clean up server-side zip (non-fatal)');
+    }
+    // Extract
+    onProgress?.({ phase: 'extracting', elapsedSeconds: 0 });
+    const zip = await JSZip.loadAsync(buffer);
+    // Single cartridge ZIP contains: cartridgeName/relative/path...
+    await extractZip(zip, {
+        stripPrefix: 1,
+        outputDirectory: path.dirname(outputPath),
+        cartridgeName,
+    });
+    logger.debug({ cartridgeName, codeVersion }, `Downloaded cartridge ${cartridgeName}`);
+}
 /**
  * Downloads cartridges from an instance via WebDAV.
  *
- * This function:
- * 1. Triggers server-side zipping of the code version
- * 2. Downloads the zip archive
- * 3. Cleans up the server-side zip (best-effort)
- * 4. Extracts cartridges locally with optional filtering
+ * When `include` specifies cartridges, each is downloaded individually using
+ * per-cartridge server-side zipping for efficiency. When downloading all
+ * cartridges (no include filter), the entire code version is zipped at once.
  *
  * If `instance.config.codeVersion` is not set, attempts to discover the active
  * code version via OCAPI. If that also fails, throws an error.
@@ -34,7 +189,7 @@ const LONG_OPERATION_TIMEOUT_MS = 600_000;
  * // Download all cartridges
  * const result = await downloadCartridges(instance, './output');
  *
- * // Download specific cartridges
+ * // Download specific cartridges (efficient per-cartridge download)
  * const result = await downloadCartridges(instance, './output', {
  *   include: ['app_storefront_base'],
  * });
@@ -46,41 +201,28 @@ const LONG_OPERATION_TIMEOUT_MS = 600_000;
  */
 export async function downloadCartridges(instance, outputDirectory, options = {}) {
     const logger = getLogger();
-    let codeVersion = instance.config.codeVersion;
-    if (!codeVersion) {
-        logger.debug('No code version configured, attempting to discover active version...');
-        try {
-            const activeVersion = await getActiveCodeVersion(instance);
-            if (activeVersion?.id) {
-                codeVersion = activeVersion.id;
-                instance.config.codeVersion = codeVersion;
-            }
-        }
-        catch (error) {
-            logger.debug({ error }, 'Failed to discover active code version');
-        }
-        if (!codeVersion) {
-            throw new Error('Code version required for download. Configure --code-version or ensure OAuth credentials are available for auto-discovery.');
+    const codeVersion = await resolveCodeVersion(instance);
+    const resolvedOutput = path.resolve(outputDirectory);
+    const { include, exclude, mirror, onProgress } = options;
+    // When specific cartridges are requested, download each individually
+    if (include?.length) {
+        const allExtracted = new Set();
+        for (const cartridgeName of include) {
+            if (exclude?.length && exclude.includes(cartridgeName))
+                continue;
+            const outputPath = mirror?.has(cartridgeName)
+                ? mirror.get(cartridgeName)
+                : path.join(resolvedOutput, cartridgeName);
+            await downloadSingleCartridge(instance, codeVersion, cartridgeName, outputPath, onProgress);
+            allExtracted.add(cartridgeName);
         }
+        const cartridgeList = [...allExtracted].sort();
+        return { cartridges: cartridgeList, codeVersion, outputDirectory: resolvedOutput };
     }
+    // Full code version download
     const webdav = instance.webdav;
     const zipPath = `Cartridges/${codeVersion}.zip`;
-    const resolvedOutput = path.resolve(outputDirectory);
-    const { onProgress } = options;
-    // Progress helper: fires immediately (0s) then every 5s until stopped
-    const PROGRESS_INTERVAL_MS = 5_000;
-    function startProgress(phase) {
-        const start = Date.now();
-        onProgress?.({ phase, elapsedSeconds: 0 });
-        if (!onProgress)
-            return () => { };
-        const interval = setInterval(() => {
-            onProgress({ phase, elapsedSeconds: Math.round((Date.now() - start) / 1000) });
-        }, PROGRESS_INTERVAL_MS);
-        return () => clearInterval(interval);
-    }
-    // Step 1: Trigger server-side zip (can take several minutes for large code versions)
-    let stopProgress = startProgress('zipping');
+    let stopProgress = startProgress('zipping', onProgress);
     logger.debug({ codeVersion }, 'Requesting server-side zip...');
     const zipResponse = await webdav.request(`Cartridges/${codeVersion}`, {
         method: 'POST',
@@ -96,8 +238,7 @@ export async function downloadCartridges(instance, outputDirectory, options = {}
         throw new Error(`Failed to create server-side zip: ${zipResponse.status} ${zipResponse.statusText} - ${text}`);
     }
     logger.debug('Server-side zip created');
-    // Step 2: Download zip archive (can be large)
-    stopProgress = startProgress('downloading');
+    stopProgress = startProgress('downloading', onProgress);
     logger.debug({ zipPath }, 'Downloading zip archive...');
     const downloadResponse = await webdav.request(zipPath, {
         method: 'GET',
@@ -110,7 +251,7 @@ export async function downloadCartridges(instance, outputDirectory, options = {}
     const buffer = await downloadResponse.arrayBuffer();
     stopProgress();
     logger.debug({ size: buffer.byteLength }, `Archive downloaded: ${buffer.byteLength} bytes`);
-    // Step 3: Cleanup server-side zip (best-effort)
+    // Cleanup server-side zip (best-effort)
     onProgress?.({ phase: 'cleanup', elapsedSeconds: 0 });
     try {
         await webdav.delete(zipPath);
@@ -119,56 +260,17 @@ export async function downloadCartridges(instance, outputDirectory, options = {}
     catch (error) {
         logger.warn({ error, zipPath }, 'Failed to clean up server-side zip (non-fatal)');
     }
-    // Step 4: Extract locally
+    // Extract
     onProgress?.({ phase: 'extracting', elapsedSeconds: 0 });
     logger.debug('Extracting archive...');
     const zip = await JSZip.loadAsync(buffer);
-    const extractedCartridges = new Set();
-    const { include, exclude, mirror } = options;
-    const entries = Object.values(zip.files).filter((entry) => !entry.dir);
-    for (const entry of entries) {
-        const parts = entry.name.split('/');
-        if (parts.length < 3) {
-            continue;
-        }
-        // Format: {codeVersion}/{cartridgeName}/{relativePath...}
-        parts.shift(); // remove codeVersion
-        const cartridgeName = parts.shift();
-        const relativePath = parts.join('/');
-        // Apply filters
-        if (include?.length && !include.includes(cartridgeName)) {
-            continue;
-        }
-        if (exclude?.length && exclude.includes(cartridgeName)) {
-            continue;
-        }
-        let targetPath;
-        if (mirror?.has(cartridgeName)) {
-            targetPath = path.join(mirror.get(cartridgeName), relativePath);
-        }
-        else {
-            targetPath = path.join(resolvedOutput, cartridgeName, relativePath);
-        }
-        // Preserve existing file permissions
-        let existingMode = null;
-        try {
-            const stat = await fs.promises.stat(targetPath);
-            existingMode = stat.mode;
-        }
-        catch {
-            // File doesn't exist yet
-        }
-        // Ensure parent directory exists
-        await fs.promises.mkdir(path.dirname(targetPath), { recursive: true });
-        // Write file
-        const content = await entry.async('nodebuffer');
-        await fs.promises.writeFile(targetPath, content);
-        // Restore permissions if file existed
-        if (existingMode !== null) {
-            await fs.promises.chmod(targetPath, existingMode);
-        }
-        extractedCartridges.add(cartridgeName);
-    }
+    // Full code version ZIP: {codeVersion}/{cartridgeName}/{relativePath...}
+    const extractedCartridges = await extractZip(zip, {
+        stripPrefix: 1,
+        outputDirectory: resolvedOutput,
+        mirror,
+        exclude,
+    });
     const cartridgeList = [...extractedCartridges].sort();
     logger.debug({ server: instance.config.hostname, codeVersion, cartridgeCount: cartridgeList.length }, `Downloaded ${cartridgeList.length} cartridge(s) from ${instance.config.hostname}`);
     return {

package/dist/esm/operations/code/download.js.map

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/operations/code/download.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../../src/operations/code/download.ts"],"names":[],"mappings":"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"}

package/dist/esm/operations/code/index.d.ts

@@ -66,7 +66,9 @@ export { listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCode
 export type { CodeVersion, CodeVersionResult } from './versions.js';
 export { findAndDeployCartridges, uploadCartridges, deleteCartridges } from './deploy.js';
 export type { DeployOptions, DeployResult, UploadOptions, UploadProgressInfo } from './deploy.js';
-export { downloadCartridges } from './download.js';
+export { downloadCartridges, downloadSingleCartridge } from './download.js';
 export type { DownloadOptions, DownloadProgressInfo, DownloadResult } from './download.js';
+export { uploadFiles, fileToCartridgePath } from './upload-files.js';
+export type { FileChange, UploadFilesOptions } from './upload-files.js';
 export { watchCartridges } from './watch.js';
 export type { WatchOptions, WatchResult } from './watch.js';

package/dist/esm/operations/code/index.js

@@ -72,7 +72,9 @@ export { listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCode
 // Deployment
 export { findAndDeployCartridges, uploadCartridges, deleteCartridges } from './deploy.js';
 // Download
-export { downloadCartridges } from './download.js';
+export { downloadCartridges, downloadSingleCartridge } from './download.js';
+// File upload pipeline
+export { uploadFiles, fileToCartridgePath } from './upload-files.js';
 // Watch
 export { watchCartridges } from './watch.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/operations/code/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/code/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,sBAAsB;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAG/C,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,aAAa;AACb,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAGxF,WAAW;AACX,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAGjD,QAAQ;AACR,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/code/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,sBAAsB;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAG/C,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,aAAa;AACb,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAGxF,WAAW;AACX,OAAO,EAAC,kBAAkB,EAAE,uBAAuB,EAAC,MAAM,eAAe,CAAC;AAG1E,uBAAuB;AACvB,OAAO,EAAC,WAAW,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAGnE,QAAQ;AACR,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC"}

package/dist/esm/operations/code/upload-files.d.ts

@@ -0,0 +1,47 @@
+import type { B2CInstance } from '../../instance/index.js';
+import type { CartridgeMapping } from './cartridges.js';
+/**
+ * Represents a file to upload or delete, with source and destination paths.
+ */
+export interface FileChange {
+    /** Absolute path to the file on disk */
+    src: string;
+    /** Cartridge-relative destination path (e.g. "cartridgeName/path/to/file.js") */
+    dest: string;
+}
+/**
+ * Callbacks for file upload/delete operations.
+ */
+export interface UploadFilesOptions {
+    /** Called after files are successfully uploaded */
+    onUpload?: (files: string[]) => void;
+    /** Called after files are successfully deleted */
+    onDelete?: (files: string[]) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * Maps an absolute file path to its cartridge-relative destination.
+ *
+ * @param absolutePath - The absolute path to a file
+ * @param cartridges - The list of discovered cartridge mappings
+ * @returns The file change with src and dest, or undefined if the path is not inside any cartridge
+ */
+export declare function fileToCartridgePath(absolutePath: string, cartridges: CartridgeMapping[]): FileChange | undefined;
+/**
+ * Uploads and deletes files on an instance via WebDAV.
+ *
+ * This is the core batch-upload pipeline used by both `watchCartridges` and
+ * the VS Code extension. It:
+ * 1. Filters out non-existent upload files
+ * 2. Creates a ZIP archive of upload files
+ * 3. Uploads via WebDAV PUT and unzips on server
+ * 4. Deletes files (skipping any that were also uploaded in the same batch)
+ *
+ * @param instance - B2C instance to sync to
+ * @param codeVersion - Code version to deploy to
+ * @param uploads - Files to upload
+ * @param deletes - Files to delete
+ * @param options - Callbacks for upload/delete/error events
+ */
+export declare function uploadFiles(instance: B2CInstance, codeVersion: string, uploads: FileChange[], deletes: FileChange[], options?: UploadFilesOptions): Promise<void>;

package/dist/esm/operations/code/upload-files.js

@@ -0,0 +1,116 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import JSZip from 'jszip';
+import { getLogger } from '../../logging/logger.js';
+const UNZIP_BODY = new URLSearchParams({ method: 'UNZIP' }).toString();
+/**
+ * Maps an absolute file path to its cartridge-relative destination.
+ *
+ * @param absolutePath - The absolute path to a file
+ * @param cartridges - The list of discovered cartridge mappings
+ * @returns The file change with src and dest, or undefined if the path is not inside any cartridge
+ */
+export function fileToCartridgePath(absolutePath, cartridges) {
+    const cartridge = cartridges.find((c) => absolutePath.startsWith(c.src));
+    if (!cartridge) {
+        return undefined;
+    }
+    const relativePath = absolutePath.substring(cartridge.src.length);
+    const destPath = path.join(cartridge.dest, relativePath);
+    return {
+        src: absolutePath,
+        dest: destPath,
+    };
+}
+/**
+ * Uploads and deletes files on an instance via WebDAV.
+ *
+ * This is the core batch-upload pipeline used by both `watchCartridges` and
+ * the VS Code extension. It:
+ * 1. Filters out non-existent upload files
+ * 2. Creates a ZIP archive of upload files
+ * 3. Uploads via WebDAV PUT and unzips on server
+ * 4. Deletes files (skipping any that were also uploaded in the same batch)
+ *
+ * @param instance - B2C instance to sync to
+ * @param codeVersion - Code version to deploy to
+ * @param uploads - Files to upload
+ * @param deletes - Files to delete
+ * @param options - Callbacks for upload/delete/error events
+ */
+export async function uploadFiles(instance, codeVersion, uploads, deletes, options) {
+    const logger = getLogger();
+    const webdav = instance.webdav;
+    const webdavLocation = `Cartridges/${codeVersion}`;
+    const validUploadFiles = uploads.filter((f) => {
+        if (!fs.existsSync(f.src)) {
+            logger.debug({ file: f.src }, 'Skipping missing file');
+            return false;
+        }
+        return true;
+    });
+    if (validUploadFiles.length > 0) {
+        const uploadPath = `${webdavLocation}/_upload-${Date.now()}.zip`;
+        try {
+            const zip = new JSZip();
+            for (const f of validUploadFiles) {
+                try {
+                    const content = await fs.promises.readFile(f.src);
+                    zip.file(f.dest, content);
+                }
+                catch (error) {
+                    logger.warn({ file: f.src, error }, 'Failed to add file to archive');
+                }
+            }
+            const buffer = await zip.generateAsync({
+                type: 'nodebuffer',
+                compression: 'DEFLATE',
+                compressionOptions: { level: 5 },
+            });
+            await webdav.put(uploadPath, buffer, 'application/zip');
+            logger.debug({ uploadPath }, 'Archive uploaded');
+            const response = await webdav.request(uploadPath, {
+                method: 'POST',
+                body: UNZIP_BODY,
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`Unzip failed: ${response.status}`);
+            }
+            await webdav.delete(uploadPath);
+            logger.debug({ fileCount: validUploadFiles.length, server: instance.config.hostname }, `Uploaded ${validUploadFiles.length} file(s)`);
+            options?.onUpload?.(validUploadFiles.map((f) => f.dest));
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error({ error: err }, `Upload error: ${err.message}`);
+            options?.onError?.(err);
+            throw err;
+        }
+    }
+    // Skip deletes for any file that was also uploaded in this batch (disk state wins)
+    const uploadedPaths = new Set(validUploadFiles.map((f) => f.dest));
+    const filesToDeleteFiltered = deletes.filter((f) => !uploadedPaths.has(f.dest));
+    if (filesToDeleteFiltered.length > 0) {
+        logger.debug({ fileCount: filesToDeleteFiltered.length }, `Deleting ${filesToDeleteFiltered.length} file(s)`);
+        for (const f of filesToDeleteFiltered) {
+            const deletePath = `${webdavLocation}/${f.dest}`;
+            try {
+                await webdav.delete(deletePath);
+                logger.info({ path: deletePath }, `Deleted: ${deletePath}`);
+            }
+            catch (error) {
+                logger.debug({ path: deletePath, error }, `Failed to delete ${deletePath}`);
+            }
+        }
+        options?.onDelete?.(filesToDeleteFiltered.map((f) => f.dest));
+    }
+}
+//# sourceMappingURL=upload-files.js.map

package/dist/esm/operations/code/upload-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-files.js","sourceRoot":"","sources":["../../../../src/operations/code/upload-files.ts"],"names":[],"mappings":"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"}