@mzzsfy/dsh-session-manager 0.7.1 → 0.9.0

package/src/trash.mjs

@@ -1,8 +1,11 @@
-// 回收站:跨平台把文件或目录移入系统回收站,不做直接删除降级。
-// 执行器可注入以便测试;失败按原样抛出,由调用方按失败矩阵处理。
+// 处置:跨平台把文件或目录移入系统回收站;系统回收站不可用的环境(容器无
+// gio / dbus 等)降级为插件回收区(rename 搬移,跨设备回退复制),保持可还原。
+// 执行器与 fs 可注入以便测试;失败按原样抛出,由调用方按失败矩阵处理。
 
 import { execFile } from 'node:child_process'
 import { promisify } from 'node:util'
+import { cp, mkdir, rename, rm } from 'node:fs/promises'
+import { basename, join } from 'node:path'
 
 const TRASH_TIMEOUT_MS = 60 * 1000
 const execFilep = promisify(execFile)
@@ -47,3 +50,38 @@ export async function trashPath(path, options = {}) {
   const env = command.env ? { ...process.env, ...command.env } : undefined
   await run(command.file, command.args, { timeout: timeoutMs, env })
 }
+
+// 同一文件系统内 rename 即搬移;跨设备(容器卷挂载等)EXDEV 时复制后删除原路径
+async function movePath(from, to, fsImpl) {
+  try {
+    await fsImpl.rename(from, to)
+  } catch (error) {
+    if (!error || error.code !== 'EXDEV') throw error
+    await fsImpl.cp(from, to, { recursive: true })
+    await fsImpl.rm(from, { recursive: true, force: true })
+  }
+}
+
+const REAL_FS = { rename, cp, rm, mkdir }
+
+/**
+ * 把目录搬入插件回收区,返回暂存路径;同名基名经时间戳保证唯一。
+ * @param options.fs - 注入的 fs 操作(rename/cp/rm/mkdir),默认真实实现
+ * @param options.now - 注入的时钟,默认 Date.now
+ */
+export async function moveToQuarantine(path, quarantineDir, options = {}) {
+  const { fs: fsImpl = REAL_FS, now = Date.now } = options
+  await fsImpl.mkdir(quarantineDir, { recursive: true })
+  const heldPath = join(quarantineDir, basename(path) + '-' + now())
+  await movePath(path, heldPath, fsImpl)
+  return heldPath
+}
+
+/**
+ * 把回收区暂存的目录移回原位置;原位置已被占用时失败上抛,由调用方响应。
+ * @param options.fs - 注入的 fs 操作(rename/cp/rm/mkdir),默认真实实现
+ */
+export async function restoreFromQuarantine(heldPath, originalPath, options = {}) {
+  const { fs: fsImpl = REAL_FS } = options
+  await movePath(heldPath, originalPath, fsImpl)
+}

package/test/client-delete.test.mjs

@@ -0,0 +1,46 @@
+// 删除确认链与强提示契约:删除 = 两击行内确认 + 弹窗强提示,弹窗内确认才发请求。
+// 文案与行为同源锁定,防重构丢失强提示使用户误删。
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const CLIENT_SRC = readFileSync(fileURLToPath(new URL('../src/client.js', import.meta.url)), 'utf8')
+
+test('源码契约:删除按钮悬停强提示齐备', () => {
+  assert.ok(CLIENT_SRC.includes('会影响其他插件'), '删除提示缺其他插件影响声明')
+  assert.ok(CLIENT_SRC.includes('若无特殊需求,请不要删除'), '删除提示缺"若无特殊需求不要删除"劝阻语')
+})
+
+// Given 弹窗确认层, When 渲染, Then 强提示文案、会话标题、双按钮齐备且受控挂载
+test('源码契约:删除弹窗强提示与受控挂载齐备', () => {
+  assert.ok(CLIENT_SRC.includes('sm-dialog'), '缺弹窗样式锚点')
+  assert.ok(CLIENT_SRC.includes('DELETE_DIALOG_TITLE'), '缺弹窗标题常量')
+  assert.ok(CLIENT_SRC.includes('DELETE_DIALOG_BODY'), '缺弹窗正文常量')
+  assert.ok(/DELETE_DIALOG_BODY[\s\S]{0,60}row\.title/.test(CLIENT_SRC), '弹窗正文未携带会话标题')
+  assert.ok(CLIENT_SRC.includes("h(DeleteDialog"), '弹窗组件未在应用内挂载')
+  assert.ok(CLIENT_SRC.includes('pendingDelete'), '缺待删会话受控状态')
+  assert.ok(/pendingDelete[\s\S]{0,80}setPendingDelete\(null\)/.test(CLIENT_SRC), '弹窗取消未清空待删状态')
+  // 可达性:aria 关联 + 初始焦点落取消 + Escape 出口
+  assert.ok(CLIENT_SRC.includes("'aria-labelledby'"), '弹窗缺 aria-labelledby')
+  assert.ok(CLIENT_SRC.includes("'aria-describedby'"), '弹窗缺 aria-describedby')
+  assert.ok(/cancelRef\.current\.focus\(\)/.test(CLIENT_SRC), '弹窗初始焦点未落取消键')
+  assert.ok(/key === 'Escape'/.test(CLIENT_SRC), '弹窗缺 Escape 取消出口')
+})
+
+// Given 弹窗确认, When 确认删除, Then 才发删除请求;成功文案按处置模式区分
+test('源码契约:弹窗确认触发请求且成功文案区分处置模式', () => {
+  assert.ok(CLIENT_SRC.includes('DELETE_TOAST_OS'), '缺 OS 回收站成功文案常量')
+  assert.ok(CLIENT_SRC.includes('DELETE_TOAST_QUARANTINE'), '缺回收区成功文案常量')
+  assert.ok(CLIENT_SRC.includes("mode === 'quarantine'"), '成功文案未按响应 mode 区分')
+  assert.ok(CLIENT_SRC.includes('DELETE_URL'), '缺删除请求地址')
+  // 弹窗确认函数与删除请求联动:确认键处理体内发出 DELETE 请求
+  assert.ok(/function onDialogConfirm[\s\S]{0,700}DELETE_URL/.test(CLIENT_SRC), '弹窗确认未触发删除请求')
+})
+
+// Given 已删除区, When 渲染提示, Then 两种找回路径(OS 还原 / 回收区直接重挂载)均有说明
+test('源码契约:已删除区说明覆盖两种找回路径', () => {
+  assert.ok(CLIENT_SRC.includes('到系统回收站将会话文件夹还原到原位置'), '缺 OS 回收站还原指引')
+  assert.ok(CLIENT_SRC.includes('回收区暂存的会话直接点「重新挂载」即可找回'), '缺回收区直接重挂载指引')
+})

package/test/client-help.test.mjs

@@ -0,0 +1,36 @@
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+
+const CLIENT_SRC = readFileSync(fileURLToPath(new URL('../src/client.js', import.meta.url)), 'utf8')
+
+// 设置项悬停说明契约:说明常量必须存在且逐项挂到对应控件(title 属性)。
+// 开关行断言以常量为锚回看相邻的行文本,配置行断言以展示文案为锚——
+// 防常量互换挂载或挂错行仍通过(纯存在性匹配检不出错挂)
+test('源码契约:自动归档设置的悬停说明齐备且挂到对应控件', () => {
+  const TITLES = {
+    ARCHIVE_OVERVIEW_TITLE: '自动归档行',
+    ARCHIVE_DAYS_TITLE: '阈值字段',
+    ARCHIVE_INTERVAL_TITLE: '检查周期字段',
+  }
+  for (const [name, label] of Object.entries(TITLES)) {
+    assert.ok(CLIENT_SRC.includes('const ' + name + ' ='), '缺悬停说明常量 ' + name)
+  }
+  const configAnchors = [
+    { constant: 'ARCHIVE_OVERVIEW_TITLE', text: "'自动归档'", label: TITLES.ARCHIVE_OVERVIEW_TITLE },
+    { constant: 'ARCHIVE_DAYS_TITLE', text: "'阈值', numberInput('days')", label: TITLES.ARCHIVE_DAYS_TITLE },
+    { constant: 'ARCHIVE_INTERVAL_TITLE', text: "'检查周期', numberInput('intervalHours')", label: TITLES.ARCHIVE_INTERVAL_TITLE },
+  ]
+  for (const { constant, text, label } of configAnchors) {
+    const mounted = new RegExp('title: ' + constant + '[\\s\\S]{0,120}' + text.replace(/[()']/g, '\\$&')).test(CLIENT_SRC)
+    assert.ok(mounted, label + ' 未挂对应悬停说明(常量与字段不在同一配置行)')
+  }
+})
+
+// 说明文案与行为同源的抽样锁定:核心语义缺失即为文案回归
+test('源码契约:悬停说明覆盖各设置的关键行为语义', () => {
+  assert.ok(CLIENT_SRC.includes('空白(无消息)会话不参与归档'), '阈值说明缺空白会话例外(core.mjs selectArchiveCandidates 过滤 blank)')
+  assert.ok(CLIENT_SRC.includes('0 = 关闭自动归档'), '阈值说明缺 0 关闭语义')
+  assert.ok(CLIENT_SRC.includes('0 = 关闭周期检查'), '周期说明缺 0 关闭语义')
+})

package/test/client-id.test.mjs

@@ -13,4 +13,12 @@ test('client.js 注册 id 为完整包名', () => {
   const match = source.match(/__ModuleLoader__\.load\(\{\s*id:\s*'([^']+)'/)
   assert.ok(match, 'client.js 缺少 __ModuleLoader__.load 注册')
   assert.equal(match[1], name)
+})
+
+test('client.js 样式注入自带 data-plugin', () => {
+  const source = readFileSync(join(PKG_ROOT, 'src', 'client.js'), 'utf8')
+  const injections = source.split("createElement('style')").length - 1
+  assert.ok(injections > 0, 'client.js 无样式注入点')
+  const marked = source.split(`setAttribute('data-plugin', '${name}')`).length - 1
+  assert.equal(marked, injections, '每个样式注入点都必须自带 data-plugin(值=注册包名),防宿主 claimStyles 误归属后随他插件 HMR 整批误删')
 })