dsh-session-cloud 0.1.0

package/lib/sync/state.js

@@ -0,0 +1,117 @@
+/**
+ * 本地同步状态（docs/02 §7）：首选 dsh storageDomain 版本化 KV 域，
+ * 不可用时降级为 $DSH_HOME 下插件自建子目录的单文件 JSON。
+ */
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain';
+import fsp from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+const sessionStateSchema = z.object({
+    uploadedBytes: z.number().int().nonnegative(),
+    remoteBytes: z.number().int().nonnegative(),
+    lastSegmentIndex: z.number().int().min(-1),
+    lastTag: z.string(),
+    localRevision: z.string(),
+    eventCount: z.number().int().nonnegative(),
+    title: z.string().optional(),
+    updatedAt: z.number(),
+    status: z.enum(['ok', 'skipped-plain', 'conflict', 'error']).optional(),
+    error: z.string().optional(),
+});
+const globalStateSchema = z.object({
+    lastSyncAt: z.number().optional(),
+    lastError: z.string().optional(),
+    pathMappings: z.array(z.object({ from: z.string(), to: z.string() })),
+});
+export const INITIAL_GLOBAL = { pathMappings: [] };
+/** storageDomain 实现（首选）。 */
+export const cloudSyncDomainSpec = defineDomain({
+    name: 'cloud_sync', // UNIT_NAME_RE 只允许小写字母数字下划线（与 settings 的 cloud-sync 不同体系）
+    version: 1,
+    global: { schema: globalStateSchema, initial: INITIAL_GLOBAL },
+    tables: {
+        sessions: domainTable(sessionStateSchema),
+    },
+});
+export class DomainStateStore {
+    domain;
+    constructor(domain) {
+        this.domain = domain;
+    }
+    getSession(id) {
+        return this.domain.table('sessions').get(id);
+    }
+    entries() {
+        return this.domain.table('sessions').entries();
+    }
+    async putSession(id, state) {
+        await this.domain.table('sessions').put(id, state);
+    }
+    getGlobal() {
+        return this.domain.global.get();
+    }
+    async setGlobal(patch) {
+        await this.domain.global.set({ ...this.domain.global.get(), ...patch });
+    }
+    async close() {
+        await this.domain.close();
+    }
+}
+/** JSON 单文件降级实现：tmp + rename 原子写。 */
+export class JsonFileStateStore {
+    file;
+    sessions = new Map();
+    global = INITIAL_GLOBAL;
+    writing = Promise.resolve();
+    constructor(dir) {
+        this.file = path.join(dir, 'state.json');
+    }
+    /** 打开（或创建）state 文件；损坏时回退为空 state（即全量重传），不阻断启动。 */
+    static async open(dir) {
+        const store = new JsonFileStateStore(dir);
+        try {
+            const parsed = JSON.parse(await fsp.readFile(store.file, 'utf8'));
+            for (const [id, state] of Object.entries(parsed.sessions ?? {}))
+                store.sessions.set(id, state);
+            if (parsed.global)
+                store.global = { ...INITIAL_GLOBAL, ...parsed.global };
+        }
+        catch {
+            // 缺失或损坏即空 state
+        }
+        return store;
+    }
+    persist() {
+        const snapshot = JSON.stringify({
+            sessions: Object.fromEntries(this.sessions),
+            global: this.global,
+        });
+        this.writing = this.writing.then(async () => {
+            await fsp.mkdir(path.dirname(this.file), { recursive: true });
+            const tmp = `${this.file}.tmp-${process.pid}`;
+            await fsp.writeFile(tmp, snapshot);
+            await fsp.rename(tmp, this.file);
+        });
+        return this.writing;
+    }
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    entries() {
+        return this.sessions.entries();
+    }
+    async putSession(id, state) {
+        this.sessions.set(id, state);
+        await this.persist();
+    }
+    getGlobal() {
+        return this.global;
+    }
+    async setGlobal(patch) {
+        this.global = { ...this.global, ...patch };
+        await this.persist();
+    }
+    async close() {
+        await this.writing;
+    }
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "dsh-session-cloud",
+  "version": "0.1.0",
+  "description": "E2E-encrypted cloud mirror plugin for deepseek-harness sessions",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/build-client.mjs",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "prepublishOnly": "pnpm run build",
+    "test": "node --import tsx --test src/**/*.test.ts"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "*"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-locale": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-alpha.2",
+    "@types/react": "^18",
+    "@types/react-dom": "^18",
+    "esbuild": "^0.28.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/dsh-storage-domain": "0.0.1-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "zod": "^4.5.4"
+  }
+}