39 lines
1.6 KiB
JavaScript
39 lines
1.6 KiB
JavaScript
// main/file-ops.js atomicWriteFile —— tmp 路径生成（audit P2-1）
|
||
//
|
||
// 背景：原 inline 实现 `Math.random().toString(36).slice(2, 8)`
|
||
// - Math.random() 不加密安全，并发同毫秒 + 同 pid + 同 dst 可能撞名
|
||
// （虽然 36^6 ≈ 21 亿，实际不撞，但语义上 audit 要求与 crypto.randomUUID 对齐）
|
||
// - 仓库其它路径已用 crypto.randomUUID()，统一风格
|
||
//
|
||
// 设计：
|
||
// - 抽 generateTmpPath(dst, { crypto, pid, now }) 工厂
|
||
// - 注入 crypto / pid / now 便于单测验证随机性来源
|
||
// - 默认走 node:crypto.randomUUID()（128-bit 加密安全）
|
||
// - 路径格式：${dst}.tmp.${pid}.${ts}.${randomId}
|
||
// 保持现有格式不破坏 fs-watcher（fs-watcher 旧逻辑只匹配 .tmp.* 前缀，randomId
|
||
// 改成 UUID 不影响匹配）
|
||
//
|
||
// 调用方：atomicWriteFile 在 fs.open 之前构造 tmpPath。
|
||
|
||
'use strict';
|
||
|
||
/**
|
||
* 生成 atomicWriteFile 用的 tmp 路径。
|
||
* @param {string} dst 目标文件完整路径
|
||
* @param {{
|
||
* crypto?: { randomUUID: () => string },
|
||
* pid?: number,
|
||
* now?: () => number,
|
||
* }} [opts] 注入依赖，便于单测
|
||
* @returns {string} `${dst}.tmp.${pid}.${ts}.${randomId}`
|
||
*/
|
||
function generateTmpPath(dst, opts) {
|
||
const cryptoImpl = (opts && opts.crypto) || require('node:crypto');
|
||
const pid = (opts && typeof opts.pid === 'number') ? opts.pid : process.pid;
|
||
const now = (opts && typeof opts.now === 'function') ? opts.now : Date.now;
|
||
const randomId = cryptoImpl.randomUUID();
|
||
return `${dst}.tmp.${pid}.${now()}.${randomId}`;
|
||
}
|
||
|
||
module.exports = { generateTmpPath };
|