@xrn1997/dsh-session-delete 0.1.1 → 0.2.1

package/lib/types/verbs/restore-session.d.ts

@@ -0,0 +1,37 @@
+import { type TrashEntry } from '../trash/entry.js';
+import { type HostPort } from '../ports/host-port.js';
+import type { DeleteDeps } from './delete-session.js';
+/**
+ * 恢复 = 把删除那次**按原路退回**，而且按组走：当年是按组一起搬进来的（父 + 它在盘上的孩子），
+ * 只回父就会在回收站里留下一堆点不到的孩子行——清单只列父行，那些行既看不见也清不掉。
+ *
+ * 三段与删除对称：
+ * ① **预检整组**（一个字节都不写）：每个成员的回收站目录与项目目录都得在。缺席的判据与原来一致
+ *    （回收站目录不在 = `trash-empty`；原项目目录不在 = `project-missing`，且绝不静默建目录）。
+ *    预检在写之前，是为了不让"父已经回到 `sessions/`、孩子因为项目目录没了而回不去"这种半组留在外面。
+ *    **工作区账本不在这条硬前提里**：宿主的「删除工作区」只删注册、保留日志，记下的工作区没了就按
+ *    「未分组」收（判据在 {@link attachableWorkspaceId}），照旧回盘——恢复是加法，不该因为一个可选的账目而失败。
+ * ② **逐个恢复**，顺序与删除相反：文件先回来 → 挂账本 → 还原可见性 → 摘清册行 → 通告回来。
+ * ③ 中途失败把这个成员自己退回回收站（就地回滚），并把**已经恢复完的**兄弟按相反顺序一起退回，失败照抛。
+ */
+export declare function restoreSession(deps: DeleteDeps): (entryId: string, options?: {
+    readonly snapshot?: TrashEntry[];
+    /** 批量（`verbs/apply.ts`）**自己收尾一次发**时传 `suppressAnnounce`：动词不再逐条通告——
+     *  单条一份摘要 = 一条一次宿主全表扫，那是 2026-10-17 "恢复很慢"的头号来源。 */
+    readonly suppressAnnounce?: boolean;
+}) => Promise<TrashEntry>;
+/**
+ * 这一次恢复**到底挂不挂账本**：交出能挂的那个 `workspaceId`，挂不了就 `undefined`。
+ *
+ * 两种缺席是同一件事：空串 = 删除时它就没有账目（「未分组」的会话）；非空但账本里已经没它 =
+ * 宿主的「删除工作区」只删注册、保留目录与每一份日志，那些会话之后本来就在「未分组」下。
+ * 恢复不该为了挂一个不存在的账本把整条退回回收站。
+ *
+ * 判据**只有这一处**：`restoreOne` 拿它决定挂不挂，`GET /list` 拿它决定行上那句「原工作区已不存在，
+ * 恢复后归入未分组」说不说。两边各问一遍就会有一天一个说、一个不挂。
+ */
+export declare function attachableWorkspaceId(host: Pick<HostPort, 'workspaceExists'>, entry: TrashEntry): Promise<string | undefined>;
+/** 这一条记着的工作区**是不是已经没了**（区别于"删除时它就没有账目"的空串）——清单行据此决定
+ *  要不要在点之前说那句「原工作区已不存在，恢复后归入未分组」。由 {@link attachableWorkspaceId}
+ *  派生，不另起一份判据：那样会有一天一个说、一个不挂。 */
+export declare function isWorkspaceMissing(host: Pick<HostPort, 'workspaceExists'>, entry: TrashEntry): Promise<boolean>;

package/package.json

@@ -1,95 +1,105 @@
-{
-  "name": "@xrn1997/dsh-session-delete",
-  "version": "0.1.1",
-  "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./client": "./lib/client.js",
-    "./locale/*.json": "./locale/*.json",
-    "./package.json": "./package.json"
-  },
-  "icon": "./icon.svg",
-  "files": [
-    "lib",
-    "locale",
-    "icon.svg",
-    "cordis.patch.yml",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=24"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "prepack": "npm run build"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "react": "^18.3.1"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.4",
-    "@testing-library/dom": "^10.4.2",
-    "@testing-library/jest-dom": "^6.10.0",
-    "@testing-library/react": "^16.3.3",
-    "@types/node": "24.19.0",
-    "@types/react": "18.3.31",
-    "@types/react-dom": "18.3.5",
-    "jsdom": "^26.1.0",
-    "react": "18.3.1",
-    "react-dom": "18.3.1",
-    "tsdown": "0.23.0",
-    "typescript": "5.9.3",
-    "vitest": "3.2.7"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-locale"
-      ],
-      "platform": "web"
-    },
-    "compatibility": {
-      "dshReleases": {
-        "0.2.0-rc.2": "compatible"
-      }
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xrn1997/dsh-session-delete.git"
-  },
-  "homepage": "https://github.com/xrn1997/dsh-session-delete#readme",
-  "bugs": {
-    "url": "https://github.com/xrn1997/dsh-session-delete/issues"
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "session",
-    "trash",
-    "delete"
-  ],
-  "author": "xrn1997",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1"
-  }
-}
+{
+  "name": "@xrn1997/dsh-session-delete",
+  "version": "0.2.1",
+  "description": "在 DeepSeek Harness 里删除会话：删除=移入回收站（可恢复），另设显式彻底删除",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "icon": "./icon.svg",
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=24",
+    "dsh": ">=0.1.7-rc.2 <0.3.0-0"
+  },
+  "scripts": {
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^6.10.0",
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "24.19.0",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "18.3.5",
+    "@types/semver": "^7.8.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.3.1",
+    "react-dom": "18.3.1",
+    "semver": "^7.8.5",
+    "tsdown": "0.23.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.7"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-rc.1": "compatible",
+        "0.2.1-rc.2": "compatible"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xrn1997/dsh-session-delete.git"
+  },
+  "homepage": "https://github.com/xrn1997/dsh-session-delete#readme",
+  "bugs": {
+    "url": "https://github.com/xrn1997/dsh-session-delete/issues"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "session",
+    "trash",
+    "delete"
+  ],
+  "author": "xrn1997",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
+  }
+}