@aduh95 suggestion

Author: avivkeller

src/generators/legacy-html/utils/safeCopy.mjs

@@ -4,36 +4,40 @@ import { copyFile, readdir, stat, constants } from 'node:fs/promises';
 import { join } from 'node:path';
 
 /**
- * Safely copies files from source to target directory, skipping files that haven't changed
- * based on file stats (size and modification time). Uses native fs.copyFile which handles
- * concurrent operations gracefully.
+ * Attempts to copy a file forcibly (`COPYFILE_FICLONE_FORCE`. Otherwise, falls back to a time-based check approach)
  *
  * @param {string} srcDir - Source directory path
  * @param {string} targetDir - Target directory path
  */
 export async function safeCopy(srcDir, targetDir) {
-  const files = await readdir(srcDir);
+  try {
+    await copyFile(srcDir, targetDir, constants.COPYFILE_FICLONE);
+  } catch (err) {
+    if (err?.syscall !== 'copyfile') {
+      throw err;
+    }
 
-  for (const file of files) {
-    const sourcePath = join(srcDir, file);
-    const targetPath = join(targetDir, file);
+    const files = await readdir(srcDir);
 
-    const [sStat, tStat] = await Promise.allSettled([
-      stat(sourcePath),
-      stat(targetPath),
-    ]);
+    for (const file of files) {
+      const sourcePath = join(srcDir, file);
+      const targetPath = join(targetDir, file);
 
-    const shouldWrite =
-      tStat.status === 'rejected' ||
-      sStat.value.size !== tStat.value.size ||
-      sStat.value.mtimeMs > tStat.value.mtimeMs;
+      const [sStat, tStat] = await Promise.allSettled([
+        stat(sourcePath),
+        stat(targetPath),
+      ]);
 
-    if (!shouldWrite) {
-      continue;
-    }
+      const shouldWrite =
+        tStat.status === 'rejected' ||
+        sStat.value.size !== tStat.value.size ||
+        sStat.value.mtimeMs > tStat.value.mtimeMs;
 
-    // Use copyFile with COPYFILE_FICLONE flag for efficient copying
-    // This is atomic and handles concurrent operations better than manual read/write
-    await copyFile(sourcePath, targetPath, constants.COPYFILE_FICLONE);
+      if (!shouldWrite) {
+        continue;
+      }
+
+      await copyFile(sourcePath, targetPath);
+    }
   }
 }