endef 2.0.1 → 2.0.2

package/README.md

@@ -2,7 +2,7 @@
 
 `endef` 是一个纯 Node.js 的文件旁路转换工具。
 
-它适合这样的场景：某些常见源码或文本后缀的文件在系统读取、复制、粘贴、编辑器打开时出现乱码或异常，但通过 Node.js 脚本读取仍然正常。`endef` 会先把目标文件内容写到同目录的 `.endef` 副本里，再删除原文件，并把 `.endef` 副本重命名回原文件名。
+它适合这样的场景：某些常见源码或文本后缀的文件在系统读取、复制、粘贴、编辑器打开时出现乱码或异常，但通过 Node.js 脚本读取仍然正常。`endef` 会先把目标文件内容写到同目录的 `.endef` 副本里，再删除原文件，并用 `.endef` 副本内容新建原文件。
 
 示例：
 
@@ -20,7 +20,7 @@ README.md -> README.md.endef -> README.md
 - 默认旁路后缀为 `.endef`
 - `en` 默认转换所有匹配后缀的文件
 - `en --marker` 可以只转换命中 marker 的文件，marker 支持数组配置，也支持 CLI 手动指定多个
-- `de` 会删除原文件，并把 `.endef` 临时副本重命名回原文件名
+- `de` 会删除原文件，用 `.endef` 临时副本内容新建原文件，再删除 `.endef`
 - `pack` 会把恢复后的目录打包成 `.tar.gz`
 - 不引入生产依赖
 
@@ -66,7 +66,7 @@ endef en /path/to/project --marker E-SafeNet --marker BadText
 endef en /path/to/project --marker E-SafeNet,BadText
 ```
 
-删除原文件，并把 `.endef` 副本重命名回原文件名：
+删除原文件，用 `.endef` 副本内容新建原文件，再删除 `.endef`：
 
 ```bash
 endef de /path/to/project
@@ -107,11 +107,11 @@ endef all [directory] [options]
 
 `en` 会扫描目标目录，把匹配后缀的文件读取出来，并写成同目录的 `.endef` 副本。
 
-`de` 会扫描目标目录中的 `.endef` 文件，删除对应的原文件，然后把 `.endef` 副本重命名回原文件名。这个命令会直接修改文件，请在执行前确认目录和备份策略。
+`de` 会扫描目标目录中的 `.endef` 文件，删除对应的原文件，用 `.endef` 副本内容新建原文件，然后删除 `.endef` 副本。这个命令会直接修改文件，请在执行前确认目录和备份策略。
 
 `pack` 会按当前配置扫描当前目录，把没有被 `excludeDirs` 排除的文件打包成 `.tar.gz`。如果输出文件已存在，会直接覆盖。
 
-`all` 会按顺序执行 `en`、`de`、`pack`，适合确认配置后一次性完成旁路转换、重命名恢复和打包。
+`all` 会按顺序执行 `en`、`de`、`pack`，适合确认配置后一次性完成旁路转换、新建恢复和打包。
 
 ## 参数
 
@@ -222,13 +222,13 @@ endef en . --marker E-SafeNet --marker BadText
 file.ext.endef
 ```
 
-删除原文件后重命名为：
+删除原文件后，用 `.endef` 内容新建：
 
 ```text
 file.ext
 ```
 
-如果 `file.ext` 已经存在，会先被删除，然后由 `.endef` 副本重命名得到新的 `file.ext`。这个行为符合工具的核心假设：原文件可能已经被异常内容污染，而 `.endef` 是通过旁路读取保存出来的可恢复内容。
+如果 `file.ext` 已经存在，会先被删除，然后用 `.endef` 副本内容创建新的 `file.ext`。创建成功后，`file.ext.endef` 会被删除。这个行为符合工具的核心假设：原文件可能已经被异常内容污染，而 `.endef` 是通过旁路读取保存出来的可恢复内容。
 
 ## 打包策略
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "endef",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Recover text and source files through safe .endef sidecar copies.",
   "bin": {
     "endef": "bin/main.js"

package/src/de.js

@@ -30,22 +30,28 @@ async function restoreFiles(directory, options = {}) {
   })
 
   await Promise.all(tasks)
-  console.log(`Done. restored=${stats.restored}, removed=${stats.removed}, renamed=${stats.renamed}, failed=${stats.failed}`)
+  console.log(
+    `Done. restored=${stats.restored}, removed=${stats.removed}, created=${stats.created}, deleted=${stats.deleted}, failed=${stats.failed}`
+  )
   return stats
 }
 
 async function restoreOne(filePath, config, stats) {
   const targetPath = filePath.slice(0, -config.suffix.length)
   const targetExists = await exists(targetPath)
+  const data = await fs.readFile(filePath)
 
   await fs.rm(targetPath, { force: true })
-  await fs.rename(filePath, targetPath)
+  await waitForMissing(targetPath)
+  await fs.writeFile(targetPath, data, { flag: 'wx' })
+  await fs.rm(filePath, { force: true })
 
   stats.restored += 1
   if (targetExists) {
     stats.removed += 1
   }
-  stats.renamed += 1
+  stats.created += 1
+  stats.deleted += 1
   console.log(`Restored: ${filePath} -> ${targetPath}`)
 }
 
@@ -58,11 +64,30 @@ async function exists(filePath) {
   }
 }
 
+async function waitForMissing(filePath) {
+  for (let index = 0; index < 20; index += 1) {
+    if (!(await exists(filePath))) {
+      return
+    }
+
+    await delay(25)
+  }
+
+  throw new Error(`Target still exists after remove: ${filePath}`)
+}
+
+function delay(ms) {
+  return new Promise(resolve => {
+    setTimeout(resolve, ms)
+  })
+}
+
 function createStats() {
   return {
     restored: 0,
     removed: 0,
-    renamed: 0,
+    created: 0,
+    deleted: 0,
     failed: 0
   }
 }

package/src/en.js

@@ -27,14 +27,14 @@ async function processFiles(directory, options = {}) {
     tasks.push(
       limit(async () => {
         const outputPath = `${filePath}${config.suffix}`
-        const data = await fs.readFile(filePath, 'utf8')
+        const data = await fs.readFile(filePath)
 
         if (config.markerFilter && !matchesAnyMarker(data, config.markers)) {
           stats.skipped += 1
           return
         }
 
-        await fs.writeFile(outputPath, data, 'utf8')
+        await fs.writeFile(outputPath, data)
         console.log(`Written: ${outputPath}`)
         stats.written += 1
       }).catch(error => {