diff --git a/vendor/dsh-remote-ssh/tests/settings-sync-scope-ui.test.mjs b/vendor/dsh-remote-ssh/tests/settings-sync-scope-ui.test.mjs new file mode 100644 index 0000000..ac95b0d --- /dev/null +++ b/vendor/dsh-remote-ssh/tests/settings-sync-scope-ui.test.mjs @@ -0,0 +1,266 @@ +// 同步范围的可达性(issue #28)。 +// +// 举报人核对过:`syncPaths` / `syncExclude` / `syncMaxBytes`(#20 引入)后端早就齐了 +// —— schema 有字段、`updateWorkspace` 能写、`syncOptsFrom` 有三级回退 —— 但 GUI 里 +// 一个入口都没有,「添加工作区」也只会建出 `syncPaths: []` 的工作区。对 remotePath 是 +// `~` 的工作区,空范围意味着 sync 退化成整树、先被 2 GiB 体积哨兵拒绝,每次都得手改配置 +// 或直调 HTTP。 +// +// 这个文件钉住四件事: +// ① 三个归一化/解析函数的行为(抽真实实现跑,不是看代码里有没有写); +// ② 宿主三个入口(updateWorkspaceGuards / createRemoteWorkspace / savePrefs+getPrefs) +// 都真的接住了这三个字段,且 createRemoteWorkspace 会回落到全局默认; +// ③ 三个 settings face 的 read() 都回 defaultSync*(少一处,设置面板在旧版 DSH 上就显示空); +// ④ 客户端真有控件(含「添加工作区」弹窗与手动同步按钮),且新文案中英各一份。 +import { readFileSync } from 'node:fs' + +const root = new URL('..', import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1') +const src = readFileSync(root + '/lib/index.js', 'utf8') +const client = readFileSync(root + '/lib/client.js', 'utf8') + +let pass = 0 +let fail = 0 +const check = (cond, label) => { + if (cond) { pass++; console.log(' ✓ ' + label) } + else { fail++; console.log(' ✗ FAIL: ' + label) } +} + +/** 从源码里按大括号配对抽出一个函数声明(含注释头)。 */ +function grab(text, name) { + const start = text.indexOf(name) + if (start < 0) throw new Error(name + ' not found') + const declStart = text.lastIndexOf('\n', start) + let i = text.indexOf('{', start) + let depth = 0 + for (; i < text.length; i++) { + if (text[i] === '{') depth++ + else if (text[i] === '}') { depth--; if (depth === 0) break } + } + return text.slice(declStart + 1, i + 1) +} + +console.log('A · 归一化函数的行为(抽真实实现跑)') +{ + const block = [ + grab(src, 'function normalizeSyncList('), + grab(src, 'function parseSyncMaxBytes(') + ].join('\n') + const fns = new Function(block + '\nreturn { normalizeSyncList, parseSyncMaxBytes }')() + const { normalizeSyncList, parseSyncMaxBytes } = fns + + check(Array.isArray(normalizeSyncList(['a', ' b ', '', ' '])), 'normalizeSyncList 回数组') + check(JSON.stringify(normalizeSyncList(['a', ' b ', '', ' '])) === '["a","b"]', '数组输入:trim + 丢空串') + check(JSON.stringify(normalizeSyncList('.dsh, src\n docs;config')) === '[".dsh","src","docs","config"]', + '整串输入:逗号/换行/分号都认(与客户端输入框同语义)') + check(JSON.stringify(normalizeSyncList(['a', 'a', ' a '])) === '["a"]', '重复项去重(否则 tar 命令行无谓变长)') + check(JSON.stringify(normalizeSyncList(null)) === '[]' && JSON.stringify(normalizeSyncList(undefined)) === '[]', + 'null / undefined → 空数组(清空范围时不会塞进奇怪值)') + check(JSON.stringify(normalizeSyncList('')) === '[]', '空串 → 空数组(空 exclude 会命中一切,必须丢掉)') + + check(parseSyncMaxBytes(0) === 0, '数字 0 是合法值(= 用内置默认上限)') + check(parseSyncMaxBytes(1048576) === 1048576, '数字按字节原样接受') + check(parseSyncMaxBytes('2 GiB') === 2 * 1024 * 1024 * 1024, '"2 GiB" 按 1024 进制解析') + check(parseSyncMaxBytes('512MB') === 512 * 1000 * 1000, '"512MB" 按 1000 进制解析') + check(parseSyncMaxBytes('1.5GiB') === Math.round(1.5 * 1024 * 1024 * 1024), '接受小数') + check(parseSyncMaxBytes(-1) === null, '负数非法 → null') + check(parseSyncMaxBytes('abc') === null, '乱填非法 → null') + check(parseSyncMaxBytes('') === null && parseSyncMaxBytes(null) === null, '空值 → null(调用方据此回落到默认)') +} + +console.log('B · 宿主:schema 与三个入口都接住新字段') +{ + check(/defaultSyncPaths: z\.array\(z\.string\(\)\)\.default\(\[\]\)/.test(src), 'PrefsSchema 有 defaultSyncPaths') + check(/defaultSyncExclude: z\.array\(z\.string\(\)\)\.default\(\[\]\)/.test(src), 'PrefsSchema 有 defaultSyncExclude') + check(/defaultSyncMaxBytes: z\.number\(\)\.default\(0\)/.test(src), 'PrefsSchema 有 defaultSyncMaxBytes') + + const guardBody = src.slice( + src.indexOf('updateWorkspaceGuards: async (args) => {'), + src.indexOf('createRemoteWorkspace: async (args) => {') + ) + check(/next\.syncPaths = normalizeSyncList\(a\.syncPaths\)/.test(guardBody), 'updateWorkspaceGuards 写 syncPaths') + check(/next\.syncExclude = normalizeSyncList\(a\.syncExclude\)/.test(guardBody), 'updateWorkspaceGuards 写 syncExclude') + check(/next\.syncMaxBytes = n === null \? 0 : n/.test(guardBody), 'updateWorkspaceGuards 写 syncMaxBytes(非法值归 0)') + check(/if \(a\.syncPaths !== undefined\)/.test(guardBody), '只有传了才写(undefined = 不动,避免误清空)') + + const createBody = src.slice( + src.indexOf('createRemoteWorkspace: async (args) => {'), + src.indexOf('deleteWorkspace: async (args) => {') + ) + // issue #32 起建区还会「接管」同连接同路径的旧条目:取值优先级是 + // 显式参数 > 旧记录(复用时不把用户设好的范围重置回默认) > 全局默认。 + check(/a\.syncPaths !== undefined/.test(createBody) && /prefsNow\.defaultSyncPaths/.test(createBody), + '建区时显式 syncPaths 优先,否则回落全局默认') + check(/existing \? existing\.syncPaths : prefsNow\.defaultSyncPaths/.test(createBody), + '复用旧条目时沿用该条目自己的 syncPaths(不被默认值覆盖)') + check(/a\.syncExclude !== undefined/.test(createBody) && /prefsNow\.defaultSyncExclude/.test(createBody), + '建区时 syncExclude 同样回落全局默认') + check(/existing \? existing\.syncExclude : prefsNow\.defaultSyncExclude/.test(createBody), + '复用旧条目时沿用该条目自己的 syncExclude') + check(/prefsNow\.defaultSyncMaxBytes/.test(createBody), '建区时体积上限回落全局默认') + check(/syncPaths: normalizeSyncList\(/.test(createBody) && /syncExclude: normalizeSyncList\(/.test(createBody), + '落库前先归一化(手调 HTTP 传整串也不会写进脏数据)') + + const saveBody = src.slice( + src.indexOf('savePrefs: async (args) => {'), + src.indexOf('updateWorkspaceGuards: async (args) => {') + ) + check(/patch\.defaultSyncPaths = normalizeSyncList\(a\.defaultSyncPaths\)/.test(saveBody), 'savePrefs 接受 defaultSyncPaths') + check(/patch\.defaultSyncExclude = normalizeSyncList\(a\.defaultSyncExclude\)/.test(saveBody), 'savePrefs 接受 defaultSyncExclude') + check(/patch\.defaultSyncMaxBytes = n === null \? 0 : n/.test(saveBody), 'savePrefs 接受 defaultSyncMaxBytes(非法归 0)') + check(!/patch\.profiles/.test(saveBody) && !/patch\.workspaces/.test(saveBody), 'savePrefs 仍不碰 profiles / workspaces(负向控制)') + + const getBody = src.slice(src.indexOf('getPrefs: async () => {'), src.indexOf('savePrefs: async (args) => {')) + check(/defaultSyncPaths: normalizeSyncList\(v\.defaultSyncPaths\)/.test(getBody), 'getPrefs 回 defaultSyncPaths(设置面板要能显示)') + check(/defaultSyncMaxBytes: Number\.isFinite\(v\.defaultSyncMaxBytes\)/.test(getBody), 'getPrefs 回 defaultSyncMaxBytes') +} + +console.log('C · 三个 settings face 的 read() 都回 defaultSync*(旧版 DSH 上也不能显示成空)') +{ + const n = (src.match(/defaultSyncPaths: normalizeSyncList\(prefsArray\(/g) || []).length + check(n === 3, 'defaultSyncPaths 在三处 read() 都回(实际 ' + n + ')') + const m = (src.match(/defaultSyncMaxBytes: prefsNumber\(0,/g) || []).length + check(m === 3, 'defaultSyncMaxBytes 在三处 read() 都回(实际 ' + m + ')') + check(/function prefsNumber\(fallback, \.\.\.candidates\)/.test(src), '有 prefsNumber(0 是合法值,不能被当成"没设")') +} + +console.log('D · 客户端:控件、弹窗、手动同步按钮') +{ + check(/api\("updateWorkspaceGuards"/.test(client), '工作区保存仍走 updateWorkspaceGuards') + const saveCall = client.slice( + client.indexOf('function saveGuard(ws) {'), + client.indexOf('function runSync(ws, action) {') + ) + check(/syncPaths: splitList\(g\.syncPaths\)/.test(saveCall), 'saveGuard 提交 syncPaths') + check(/syncExclude: splitList\(g\.syncExclude\)/.test(saveCall), 'saveGuard 提交 syncExclude') + check(/syncMaxBytes: gibTextToBytes\(g\.syncMaxBytes\)/.test(saveCall), 'saveGuard 提交 syncMaxBytes(GiB 文本 → 字节)') + + check(/setGuard\(ws\.id, "syncPaths"/.test(client), '每个工作区有"同步范围"输入框') + check(/setGuard\(ws\.id, "syncExclude"/.test(client), '每个工作区有"同步排除"输入框') + check(/setGuard\(ws\.id, "syncMaxBytes"/.test(client), '每个工作区有"体积上限"输入框') + check(/setPref\("defaultSyncPaths"/.test(client), '偏好设置里有"默认同步范围"输入框') + check(/setPref\("defaultSyncMaxBytes"/.test(client), '偏好设置里有"默认体积上限"输入框') + + check(/defaultSyncPaths: splitList\(prefs\.defaultSyncPaths\)/.test(client), 'savePrefs 提交默认同步范围') + + const flow = client.slice(client.indexOf('function RemoteWorkspaceFlow(props) {'), client.indexOf('// 设置页小节')) + check(/payload\.syncPaths = scope/.test(flow), '「添加工作区」弹窗把同步范围传给 createRemoteWorkspace') + check(/scope\.length/.test(flow), '留空不传(交给宿主用全局默认兜底)') + + check(/api\(action, \{ id: ws\.id \}\)/.test(client), '手动同步按钮复用已有 syncDown / syncUp 端点') + check(/runSync\(ws, "syncDown"\)/.test(client) && /runSync\(ws, "syncUp"\)/.test(client), '工作区卡片有"同步/推送"两个按钮') + check(/if \(syncId\) return;/.test(client) && /disabled: !!syncId/.test(client), + '同步进行中再次点击被挡住(两次同步会在同一镜像目录里抢)') +} + +console.log('E · 客户端辅助函数的行为(抽真实实现跑)') +{ + const start = client.indexOf('// ---- 同步范围输入框') + const end = client.indexOf('// 远程操作弹窗') + check(start > 0 && end > start, '能定位客户端辅助函数区块') + const block = client.slice(start, end) + const fns = new Function(block + '\nreturn { splitList, bytesToGibText, gibTextToBytes, prefsForUi }')() + const { splitList, bytesToGibText, gibTextToBytes, prefsForUi } = fns + + check(JSON.stringify(splitList('.dsh, src\ndocs')) === '[".dsh","src","docs"]', 'splitList 与宿主同样拆分') + check(JSON.stringify(splitList('')) === '[]', 'splitList 空串 → 空数组') + check(bytesToGibText(2 * 1024 * 1024 * 1024) === '2', 'bytesToGibText(2 GiB) = "2"') + check(bytesToGibText(0) === '' && bytesToGibText(undefined) === '', '0 / 未设 → 空(占位符提示用默认)') + check(gibTextToBytes('2') === 2 * 1024 * 1024 * 1024, 'gibTextToBytes("2") = 2 GiB') + check(gibTextToBytes('') === 0 && gibTextToBytes('abc') === 0, '空/乱填 → 0(回到内置默认上限)') + const ui = prefsForUi({ nodePath: 'n', writeBackFailure: 'log', writeBackFreshness: false, defaultSyncPaths: ['.dsh', 'src'], defaultSyncExclude: [], defaultSyncMaxBytes: 1073741824 }) + check(ui.defaultSyncPaths === '.dsh, src' && ui.defaultSyncExclude === '' && ui.defaultSyncMaxBytes === '1', + 'prefsForUi 数组转文本、字节转 GiB') + check(ui.writeBackFreshness === false, 'prefsForUi 保留复选框的 false(负向控制)') +} + +console.log('F · 文案:新键在 zh / en 各定义一次') +{ + const keys = [ + 'settings.wsSyncPaths', 'settings.wsSyncExclude', 'settings.wsSyncMaxBytes', + 'settings.syncScope', 'settings.syncScopeHint', + 'settings.defaultSyncPaths', 'settings.defaultSyncExclude', 'settings.defaultSyncMaxBytes', + 'flow.syncPaths', 'sync.upDone', 'sync.upFail' + ] + for (const k of keys) { + const n = (client.match(new RegExp('"' + k.replace(/\./g, '\\.') + '":', 'g')) || []).length + check(n === 2, k + ' 在 zh/en 各定义一次(实际 ' + n + ')') + } +} + +/** 从源码里抽出一个对象方法(`name: async (args) => { ... }`),按大括号配对,保留箭头头。 */ +function grabMethod(text, label) { + const start = text.indexOf(label) + if (start < 0) throw new Error(label + ' not found') + let i = text.indexOf('{', start) + let depth = 0 + for (; i < text.length; i++) { + if (text[i] === '{') depth++ + else if (text[i] === '}') { depth--; if (depth === 0) break } + } + const arrowStart = text.indexOf('async', start) + return text.slice(arrowStart, i + 1) +} + +console.log('G · 真跑宿主写路径(抽真实 handler,注入假 settingsFace)') +{ + const block = grab(src, 'function normalizeSyncList(') + '\n' + grab(src, 'function parseSyncMaxBytes(') + const helpers = new Function(block + '\nreturn { normalizeSyncList, parseSyncMaxBytes }')() + + // ---- updateWorkspaceGuards:同步范围真的落库,undefined 不动,空值清空 ---- + const store = { + workspaces: [{ id: 'w1', profileId: 'p1', title: 't', remotePath: '~', mirrorPath: 'm', syncPaths: [], syncExclude: [], syncMaxBytes: 0 }] + } + const face = { + read: () => JSON.parse(JSON.stringify(store)), + updateWorkspaces: async (list) => { store.workspaces = JSON.parse(JSON.stringify(list)) }, + updatePrefs: async () => {} + } + const guard = new Function( + 'settingsFace', 'normalizeSyncList', 'parseSyncMaxBytes', + 'return ' + grabMethod(src, 'updateWorkspaceGuards: async (args) => {') + )(face, helpers.normalizeSyncList, helpers.parseSyncMaxBytes) + + const r1 = await guard({ id: 'w1', syncPaths: ' .dsh , src\n.dsh ', syncExclude: ['data/', ' '], syncMaxBytes: '2 GiB' }) + check(r1.ok === true, 'updateWorkspaceGuards 返回 ok') + check(JSON.stringify(store.workspaces[0].syncPaths) === '[".dsh","src"]', 'syncPaths 真落库(trim + 去重 + 拆整串)') + check(JSON.stringify(store.workspaces[0].syncExclude) === '["data/"]', 'syncExclude 真落库(空项被丢掉)') + check(store.workspaces[0].syncMaxBytes === 2 * 1024 * 1024 * 1024, 'syncMaxBytes 按 "2 GiB" 落成字节数') + + const before = JSON.stringify(store.workspaces[0].syncPaths) + await guard({ id: 'w1', writeBack: false }) + check(store.workspaces[0].writeBack === false, 'writeBack 照旧可写') + check(JSON.stringify(store.workspaces[0].syncPaths) === before, '没传同步范围 → 原值不动(undefined = 不改,负向控制)') + + await guard({ id: 'w1', syncPaths: [], syncExclude: '', syncMaxBytes: 'garbage' }) + check(JSON.stringify(store.workspaces[0].syncPaths) === '[]', '传空数组 = 显式清空(回到整树)') + check(JSON.stringify(store.workspaces[0].syncExclude) === '[]', '传空串 = 显式清空') + check(store.workspaces[0].syncMaxBytes === 0, '乱填体积上限 → 归 0(回到内置默认),不会写进 NaN') + + const missing = await guard({ id: 'nope', syncPaths: ['.dsh'] }) + check(missing.ok === false && /未找到远程工作区/.test(missing.error), '工作区不存在时报错而不是静默成功') + + // ---- savePrefs:新键进白名单、非法体积归一化、无关键不写 ---- + const prefsStore = { nodePath: '', writeBackFailure: 'error', writeBackFreshness: true, defaultSyncPaths: [], defaultSyncExclude: [], defaultSyncMaxBytes: 0 } + const patches = [] + const prefsFace = { + read: () => Object.assign({}, prefsStore), + updatePrefs: async (patch) => { patches.push(patch); Object.assign(prefsStore, patch) } + } + const savePrefs = new Function( + 'settingsFace', 'normalizeSyncList', 'parseSyncMaxBytes', + 'return ' + grabMethod(src, 'savePrefs: async (args) => {') + )(prefsFace, helpers.normalizeSyncList, helpers.parseSyncMaxBytes) + + const saved = await savePrefs({ defaultSyncPaths: '.dsh, src', defaultSyncExclude: 'data/', defaultSyncMaxBytes: '512MB', evil: 'x' }) + check(saved.ok === true, 'savePrefs 返回 ok') + check(JSON.stringify(patches[0].defaultSyncPaths) === '[".dsh","src"]', 'defaultSyncPaths 归一化后写入') + check(patches[0].defaultSyncMaxBytes === 512 * 1000 * 1000, 'defaultSyncMaxBytes 按 "512MB" 写入') + check(!('evil' in patches[0]) && !('profiles' in patches[0]) && !('workspaces' in patches[0]), '白名单外的键不写(负向控制)') + check(JSON.stringify(saved.prefs.defaultSyncPaths) === '[".dsh","src"]', '返回值回读最新值(面板据此刷新)') + + const none = await savePrefs({ unrelated: 1 }) + check(none.ok === false && /没有可保存的字段/.test(none.error), '没有任何白名单键时报错') +} + +console.log(`\n结果: ${pass} 通过, ${fail} 失败`) +process.exit(fail ? 1 : 0) \ No newline at end of file