65 lines
2.6 KiB
JavaScript
65 lines
2.6 KiB
JavaScript
// main.js file:rename / folder:rename —— rename 后父目录 fsync（audit P1-6）
|
||
//
|
||
// 背景：fs.rename 在 POSIX 下只 fsync 自己的 inode，不 fsync 父目录的 directory entry。
|
||
// 崩溃时新名可能没落盘，恢复后看到的是「旧名 inode + 文件内容」。audit 要求
|
||
// 与 atomicWriteFile（main.js:1801-1809 模式）一致：rename 成功后对父目录做 fsync。
|
||
//
|
||
// 现状：folder:create 已经在 mkdir 后做了父目录 fsync（main.js:1854-1864），
|
||
// 但 file:rename（main.js:1986）和 folder:rename（main.js:2085）都没有。
|
||
//
|
||
// 设计：
|
||
// - 抽 fsyncParentDir(filePath, opts?) helper
|
||
// - win32 上 NTFS journal 自带元数据持久化，直接 noop（与 folder:create 一致）
|
||
// - fsImpl 注入：生产用 Node 内置 fs；单测用 mock 验证 open→sync→close 顺序
|
||
// - close 失败静默吞（与 folder:create 行为一致）
|
||
// - open/sync 失败透传错误（不静默 —— rename 已成功，父目录 fsync 失败要可观测）
|
||
//
|
||
// 调用方语义：rename 成功后调用。失败不抛、返 {ok:false, error, code} 让调用方
|
||
// 决定是否吞（推荐：log warn，不回滚 rename —— 文件已改名成功，父目录 fsync
|
||
// 失败只是「崩溃时不保证新名持久化」，回滚成本高、收益低）。
|
||
|
||
'use strict';
|
||
|
||
const path = require('path');
|
||
|
||
/**
|
||
* 对 filePath 的父目录做 fsync，确保 directory entry 落盘。
|
||
* @param {string} filePath 文件/文件夹的完整路径
|
||
* @param {{
|
||
* fsImpl?: { open: (p: string, m: string) => Promise<{ sync: () => Promise<void>, close: () => Promise<void> }> },
|
||
* platform?: NodeJS.Platform,
|
||
* }} [opts]
|
||
* @returns {Promise<{ ok: boolean, error?: string, code?: string, skipped?: string }>}
|
||
*/
|
||
async function fsyncParentDir(filePath, opts) {
|
||
const fsImpl = (opts && opts.fsImpl) || require('fs').promises;
|
||
const platform = (opts && opts.platform) || process.platform;
|
||
|
||
if (platform === 'win32') {
|
||
// NTFS journal 自带元数据持久化，无需 fsync
|
||
return { ok: true, skipped: 'win32' };
|
||
}
|
||
|
||
const parentDir = path.dirname(filePath);
|
||
let fh;
|
||
try {
|
||
fh = await fsImpl.open(parentDir, 'r');
|
||
} catch (e) {
|
||
return { ok: false, error: e.message, code: e.code };
|
||
}
|
||
try {
|
||
await fh.sync();
|
||
} catch (e) {
|
||
return { ok: false, error: e.message, code: e.code };
|
||
} finally {
|
||
try {
|
||
await fh.close();
|
||
} catch {
|
||
// close 失败静默吞（与 folder:create 行为一致 —— 防止 fh 泄漏已尽力）
|
||
}
|
||
}
|
||
return { ok: true };
|
||
}
|
||
|
||
module.exports = { fsyncParentDir };
|