@xrn1997/dsh-session-delete 0.0.0-stage → 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,65 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/trash/entry.d.ts
+/** 回收站的一条记录。`id` 由 `makeEntryId` 生成（`<删除时刻>-<原目录名>`）——**它不是随手起的键**：
+ *  回收站目录名就是它，恢复也按它反推出原目录名放回（设计稿 §3），所以 id 的形状有契约意义。
+ *  其余字段在删除那一刻就地取。 */
+interface TrashEntry {
+  id: string;
+  sessionId: string;
+  projectDir: string;
+  /** 删除时它所属的工作区；**空串 = 删除时就没有账目**（「未分组」的会话，宿主的"删除工作区"会造出这种），
+   *  恢复时据此跳过 `attach`。 */
+  workspaceId: string;
+  /** 删除**之前**的归档态。删除会把"原本未归档"的会话归档（藏起来，免得它掉进「未分组」），
+   *  恢复时按这个字段还原可见性：true ⇒ 仍处归档态，false ⇒ 取消归档放回树里。 */
+  wasArchived: boolean;
+  deletedAt: number;
+  /** 删除时**尽力**取的会话标题（来源：`storages/session_projcache/sessions/<会话id>.json`
+   *  里的 `rows.title.val`）；取不到存空串，绝不因此让删除失败。 */
+  title: string;
+  /** 删除时用 `fs.sizeOfDir` 量到的会话目录字节数。 */
+  sizeBytes: number;
+}
+//#endregion
+//#region src/trash/manifest.d.ts
+/** 回收站清单的**唯一**读法（动词只依赖这个端口，不认 storage domain 的形状）。 */
+interface ManifestPort {
+  list(): Promise<TrashEntry[]>;
+  add(e: TrashEntry): Promise<void>;
+  remove(id: string): Promise<void>;
+}
+//#endregion
+//#region src/index.d.ts
+export declare const name = "@xrn1997/dsh-session-delete";
+/**
+ * 插件依赖：**只写字符串数组**（隔离数据根上实测：写成 `{ required, optional }` 会让插件停在
+ * `pending (waiting for services: required, optional)`）。
+ *
+ * 三项都是在隔离数据根上实测注入成功、且本插件真正用到的宿主服务。三个**故意不写**的：
+ * - `remote`：那是**浏览器半**的服务（asar `dsh-api-gateway/lib/client.js`：`super(ctx, "remote")`），
+ *   Node 半挂的是 `ctx.typertGateway`。把它写进 Node 半的 inject 会让插件永远 pending（同 `slots` 那次的形状）。
+ * - `sessions` / `sessionProjectionCache`：前者本实现不用（活跃判据走 waterfall，见设计稿 §5）；后者是**可选**服务，
+ *   官方消费方也按可选读（`ctx.get('sessionProjectionCache')?.…`），inject 一个可能没挂的服务 = 整个插件 pending。
+ *   它取不到时 `titleOf` 返回空串，正是契约允许的降级。
+ *
+ * `webServer` 是**浏览器半取数通道的承载者**（那条薄线）：插件用它注册 `/dsh-session-delete-api`
+ * 前缀路由，浏览器半同源 fetch 那五个端点。它是宿主 web 组成里的硬依赖（`dsh-host-webserver` 的
+ * `super(ctx, "webServer")`），服务名与 `register({kind:'prefix', path, handler})` 的形状按
+ * `dsh-host-webserver/lib/index.js` 与 `README.md` 原文读实，不是猜的。
+ */
+export declare const inject: string[];
+/**
+ * 清单的真实绑定：官方 storage domain → `ManifestPort`（`StorageDomainLike` 在动词层保持一种读法）。
+ * 域**懒开**且只开一次（`apply` 是同步的，而 `open()` 是异步的），并挂一条 `ctx.effect` 清理：
+ * 插件卸载时关掉句柄（句柄归调用方所有，这是 `open()` 的 JSDoc 明写的契约）。
+ */
+export declare function createStorageManifest(ctx: Context): ManifestPort;
+/**
+ * 装配顺序：**清单 → 端口 → 动词依赖 → 前缀路由**（`DeleteDeps` 就是前两者的合一）。
+ *
+ * 路由用 `ctx.effect` 挂、disposer 归装载它的那根 fiber：插件卸载即摘路由（`register` 返回的
+ * disposer 是官方契约）。**同一进程里只注册一次**这件事由宿主把住：重复的 `(kind, path)`
+ * 在 `register` 里直接抛（`webserver: duplicate prefix route "…"`），响亮失败而不是悄悄覆盖。
+ */
+export declare function apply(ctx: Context): void;
+//#endregion