@sparkelf/dsh-plugin-backup 0.1.0-rc.10

package/lib/client.js

@@ -0,0 +1,594 @@
+window.__ModuleLoader__.load({
+	id: "@sparkelf/dsh-plugin-backup",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness-plus/deepseek-harness-plus/packages/plus/backup/src/client/BackupSection.module.css.mjs
+		const css = ".cY-W_a_section{flex-direction:column;gap:16px;display:flex}.cY-W_a_title{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;font-weight:600}.cY-W_a_desc{color:var(--dsw-alias-label-secondary);margin:0;font-size:13px}.cY-W_a_actions{flex-wrap:wrap;align-items:center;gap:12px;display:flex}.cY-W_a_button{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);cursor:pointer;border-radius:8px;padding:8px 14px;font-size:13px}.cY-W_a_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.cY-W_a_button:disabled{opacity:.6;cursor:default}.cY-W_a_fileInput{display:none}.cY-W_a_progress{flex-direction:column;gap:8px;width:min(100%,480px);display:flex}.cY-W_a_progressLabel,.cY-W_a_progressDetail{margin:0;font-size:13px}.cY-W_a_progressLabel{color:var(--dsw-alias-label-primary);font-weight:500}.cY-W_a_progressDetail{color:var(--dsw-alias-label-secondary)}.cY-W_a_progressTrack{width:100%;height:8px;accent-color:var(--dsw-alias-state-business-primary);border:0}.cY-W_a_progressTrack::-webkit-progress-bar{background:var(--dsw-alias-border-l2);border-radius:4px}.cY-W_a_progressTrack::-webkit-progress-value{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_progressTrack::-moz-progress-bar{background:var(--dsw-alias-state-business-primary);border-radius:4px}.cY-W_a_status{color:var(--dsw-alias-state-success-primary);margin:0;font-size:13px}.cY-W_a_error{color:var(--dsw-alias-state-error-primary);margin:0;font-size:13px}.cY-W_a_warning{color:var(--dsw-alias-state-warn-primary);margin:0;font-size:12px}";
+		const tagId = "@sparkelf/dsh-plugin-backup/BackupSection.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@sparkelf/dsh-plugin-backup";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var BackupSection_module_css_default = {
+			"actions": "cY-W_a_actions",
+			"button": "cY-W_a_button",
+			"desc": "cY-W_a_desc",
+			"error": "cY-W_a_error",
+			"fileInput": "cY-W_a_fileInput",
+			"progress": "cY-W_a_progress",
+			"progressDetail": "cY-W_a_progressDetail",
+			"progressLabel": "cY-W_a_progressLabel",
+			"progressTrack": "cY-W_a_progressTrack",
+			"section": "cY-W_a_section",
+			"status": "cY-W_a_status",
+			"title": "cY-W_a_title",
+			"warning": "cY-W_a_warning"
+		};
+		//#endregion
+		//#region lib/types/client/BackupSection.js
+		/**
+		* Backup settings section: exact Host routes stream archive bytes and progress;
+		* the slot store survives settings-driven component remounts.
+		*/
+		/** Prove exhaustive progress phase handling. */
+		function assertNever(value) {
+			throw new Error("unknown backup progress phase: " + String(value));
+		}
+		/** Return the locale key naming the current phase. */
+		function progressTextKey(progress) {
+			switch (progress.phase) {
+				case "scan": return "exportScan";
+				case "compress": return "exportCompress";
+				case "upload": return "importUpload";
+				case "validate": return "importValidate";
+				case "restore": return "importRestore";
+				case "reload": return "importReload";
+				default: return assertNever(progress);
+			}
+		}
+		/** Derive a displayed integer percentage only for phases with stable byte totals. */
+		function progressPercent(progress) {
+			switch (progress.phase) {
+				case "scan":
+				case "validate":
+				case "reload": return;
+				case "compress":
+				case "upload":
+				case "restore": return progress.totalBytes === 0 ? 100 : Math.floor(progress.completedBytes * 100 / progress.totalBytes);
+				default: return assertNever(progress);
+			}
+		}
+		/** Return whether the current phase can still stop without interrupting committed restore mutation. */
+		function canCancel(progress) {
+			switch (progress.phase) {
+				case "scan":
+				case "compress":
+				case "upload":
+				case "validate": return true;
+				case "restore":
+				case "reload": return false;
+				default: return assertNever(progress);
+			}
+		}
+		/** Recognize the browser cancellation error returned by fetch and XHR. */
+		function isCancellation(caught) {
+			return caught instanceof Error && caught.name === "AbortError";
+		}
+		/** Map one transport or archive rejection to product copy. */
+		function localize(caught, kind) {
+			const message = caught instanceof Error ? caught.message : String(caught);
+			if (message.includes("missing backup-manifest.json")) return "notBackup";
+			if (message.includes("unsafe path")) return "unsafe";
+			return kind === "export" ? "exportFailed" : "importFailed";
+		}
+		/**
+		* The Backup section body.
+		* @param props - runtime owner props, locale, store seat, and streamed operation callbacks.
+		* @returns the section tree.
+		*/
+		function BackupSection(props) {
+			const { t, actions } = props;
+			const operation = props.useStore((state) => state.operation);
+			const status = props.useStore((state) => state.status);
+			const error = props.useStore((state) => state.error);
+			const cancelling = props.useStore((state) => state.cancelling);
+			const reloadRequired = status === "imported";
+			const fileRef = (0, react.useRef)(null);
+			const runExport = async () => {
+				actions.begin({
+					kind: "export",
+					progress: { phase: "scan" }
+				});
+				try {
+					const { downloadUrl } = await props.exportArchive((progress) => {
+						actions.progress({
+							kind: "export",
+							progress
+						});
+					});
+					const anchor = document.createElement("a");
+					anchor.href = downloadUrl;
+					anchor.download = "deepseek-harness-backup.zip";
+					anchor.click();
+					actions.complete("exported");
+				} catch (caught) {
+					if (isCancellation(caught)) {
+						actions.cancelled();
+						return;
+					}
+					actions.fail(localize(caught, "export"));
+				}
+			};
+			const onPick = (event) => {
+				const file = event.target.files?.[0];
+				event.target.value = "";
+				if (file === void 0) return;
+				actions.begin({
+					kind: "import",
+					progress: {
+						phase: "upload",
+						completedBytes: 0,
+						totalBytes: file.size
+					}
+				});
+				(async () => {
+					try {
+						await props.importArchive(file, (progress) => {
+							actions.progress({
+								kind: "import",
+								progress
+							});
+						});
+						actions.complete("imported");
+					} catch (caught) {
+						if (isCancellation(caught)) {
+							actions.cancelled();
+							return;
+						}
+						actions.fail(localize(caught, "import"));
+					}
+				})();
+			};
+			const percent = operation === null ? void 0 : progressPercent(operation.progress);
+			const progressText = operation === null ? "" : t(progressTextKey(operation.progress)) + (percent === void 0 ? "" : " " + String(percent) + "%");
+			return (0, react_jsx_runtime.jsxs)("section", {
+				className: BackupSection_module_css_default.section,
+				children: [
+					(0, react_jsx_runtime.jsx)("h2", {
+						className: BackupSection_module_css_default.title,
+						children: t("title")
+					}),
+					(0, react_jsx_runtime.jsx)("p", {
+						className: BackupSection_module_css_default.desc,
+						children: t("desc")
+					}),
+					(0, react_jsx_runtime.jsxs)("div", {
+						className: BackupSection_module_css_default.actions,
+						children: [
+							(0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: BackupSection_module_css_default.button,
+								disabled: operation !== null || reloadRequired,
+								onClick: () => {
+									runExport();
+								},
+								children: operation?.kind === "export" ? t("busyExport") : t("exportButton")
+							}),
+							(0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: BackupSection_module_css_default.button,
+								disabled: operation !== null || reloadRequired,
+								onClick: () => {
+									fileRef.current?.click();
+								},
+								children: operation?.kind === "import" ? t("busyImport") : t("importButton")
+							}),
+							operation !== null && canCancel(operation.progress) ? (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: BackupSection_module_css_default.button,
+								disabled: cancelling,
+								onClick: () => {
+									actions.requestCancel();
+									props.cancelOperation();
+								},
+								children: t(cancelling ? "cancellingButton" : "cancelButton")
+							}) : null,
+							(0, react_jsx_runtime.jsx)("input", {
+								ref: fileRef,
+								type: "file",
+								accept: ".zip,application/zip",
+								className: BackupSection_module_css_default.fileInput,
+								onChange: onPick
+							})
+						]
+					}),
+					operation !== null ? (0, react_jsx_runtime.jsxs)("div", {
+						className: BackupSection_module_css_default.progress,
+						role: "status",
+						"aria-live": "polite",
+						children: [
+							(0, react_jsx_runtime.jsx)("p", {
+								className: BackupSection_module_css_default.progressLabel,
+								children: progressText
+							}),
+							percent === void 0 ? (0, react_jsx_runtime.jsx)("progress", {
+								className: BackupSection_module_css_default.progressTrack,
+								"aria-label": t(operation.kind === "export" ? "exportProgressLabel" : "importProgressLabel"),
+								"aria-valuetext": progressText
+							}) : (0, react_jsx_runtime.jsx)("progress", {
+								className: BackupSection_module_css_default.progressTrack,
+								max: 100,
+								value: percent,
+								"aria-label": t(operation.kind === "export" ? "exportProgressLabel" : "importProgressLabel"),
+								"aria-valuetext": progressText
+							}),
+							(0, react_jsx_runtime.jsx)("p", {
+								className: BackupSection_module_css_default.progressDetail,
+								children: t("progressDetail")
+							})
+						]
+					}) : null,
+					status !== null ? (0, react_jsx_runtime.jsx)("p", {
+						className: BackupSection_module_css_default.status,
+						role: "status",
+						children: t(status)
+					}) : null,
+					reloadRequired ? (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: BackupSection_module_css_default.button,
+						onClick: () => {
+							props.reloadPage();
+						},
+						children: t("reloadButton")
+					}) : null,
+					error !== null ? (0, react_jsx_runtime.jsx)("p", {
+						className: BackupSection_module_css_default.error,
+						role: "alert",
+						children: t(error)
+					}) : null,
+					(0, react_jsx_runtime.jsx)("p", {
+						className: BackupSection_module_css_default.warning,
+						children: t("warning")
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/store.js
+		/** Remount-surviving state for the Settings Backup slot registration. */
+		/**
+		* Declare the Backup section operation and result state.
+		* @returns the root-scoped store handle.
+		*/
+		function createBackupSectionStore() {
+			return (0, _deepseek_ai_dsh_client_store.defineStore)({
+				init: () => ({
+					operation: null,
+					status: null,
+					error: null,
+					cancelling: false
+				}),
+				actions: {
+					begin: (draft, operation) => {
+						draft.operation = operation;
+						draft.status = null;
+						draft.error = null;
+						draft.cancelling = false;
+					},
+					progress: (draft, operation) => {
+						draft.operation = operation;
+					},
+					requestCancel: (draft) => {
+						draft.cancelling = true;
+					},
+					cancelled: (draft) => {
+						draft.operation = null;
+						draft.cancelling = false;
+					},
+					complete: (draft, status) => {
+						draft.operation = null;
+						draft.status = status;
+						draft.error = null;
+						draft.cancelling = false;
+					},
+					fail: (draft, error) => {
+						draft.operation = null;
+						draft.status = null;
+						draft.error = error;
+						draft.cancelling = false;
+					}
+				}
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** Settings Backup section dictionaries (zh product copy, en twin). */
+		const zh = {
+			nav: "备份",
+			title: "备份与恢复",
+			desc: "把用户设置和数据导出为一个 zip 压缩包，或从备份压缩包恢复。",
+			exportButton: "导出备份压缩包",
+			importButton: "选择压缩包并导入",
+			busyExport: "正在生成备份…",
+			busyImport: "正在导入备份…",
+			cancelButton: "取消",
+			cancellingButton: "正在取消…",
+			exportScan: "正在计算备份数据量…",
+			exportCompress: "正在生成备份",
+			exportProgressLabel: "备份生成进度",
+			importUpload: "正在上传备份",
+			importValidate: "正在校验备份完整性…",
+			importRestore: "正在恢复备份",
+			importReload: "正在加载会话与工作区…",
+			importProgressLabel: "备份恢复进度",
+			progressDetail: "数据较多时可能需要几分钟，请保持此页面打开。",
+			exported: "备份已生成，浏览器已开始下载。",
+			imported: "备份已导入。重新加载页面后，会话和工作区将使用恢复后的数据。",
+			reloadButton: "重新加载页面",
+			notBackup: "所选压缩包不是 DeepSeek Harness 备份文件。",
+			unsafe: "备份压缩包包含不安全的条目路径。",
+			exportFailed: "备份导出失败，请重试；若持续失败，请检查可用磁盘空间。",
+			importFailed: "备份导入失败，请检查所选压缩包后重试。",
+			warning: "备份压缩包包含 API 密钥等敏感信息，请妥善保管。"
+		};
+		/** English twin of the `zh` dictionary. */
+		const en = {
+			nav: "Backup",
+			title: "Backup and restore",
+			desc: "Export user settings and data as one zip archive, or restore them from a backup archive.",
+			exportButton: "Export backup archive",
+			importButton: "Choose archive and import",
+			busyExport: "Generating backup…",
+			busyImport: "Importing backup…",
+			cancelButton: "Cancel",
+			cancellingButton: "Cancelling…",
+			exportScan: "Calculating backup size…",
+			exportCompress: "Generating backup",
+			exportProgressLabel: "Backup generation progress",
+			importUpload: "Uploading backup",
+			importValidate: "Validating backup integrity…",
+			importRestore: "Restoring backup",
+			importReload: "Loading sessions and workspaces…",
+			importProgressLabel: "Backup restore progress",
+			progressDetail: "Large data sets may take several minutes; keep this page open.",
+			exported: "Backup generated; the browser download has started.",
+			imported: "Backup imported. Reload to apply the restored session and workspace data.",
+			reloadButton: "Reload page",
+			notBackup: "The selected archive is not a DeepSeek Harness backup file.",
+			unsafe: "The backup archive contains unsafe entry paths.",
+			exportFailed: "Backup export failed. Retry; if it keeps failing, check available disk space.",
+			importFailed: "Backup import failed. Check the selected archive and retry.",
+			warning: "The backup archive contains sensitive data such as API keys; store it carefully."
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/**
+		* Settings Backup section plugin, browser half. Archive bytes use exact Host
+		* routes; preparation and restore state arrive as validated NDJSON progress
+		* lines, outside the unary RPC carrier.
+		*/
+		const NS = "settingsBackup";
+		const inject = ["slots", "locale"];
+		/** Resolve a Host logical path beneath the runtime-injected document base. */
+		function browserHostUrl(path) {
+			return new URL(path.replace(/^[/]/u, ""), document.baseURI).toString();
+		}
+		/** Parse one unknown JSON object at the backup progress HTTP boundary. */
+		function parseRecord(value) {
+			if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("invalid backup progress message");
+			return value;
+		}
+		/** Parse one finite non-negative byte or count field from the progress wire. */
+		function parseCount(value) {
+			if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw new Error("invalid backup progress count");
+			return value;
+		}
+		/** Parse one Host-authored phase update from the exact-route stream. */
+		function parseHostProgress(value) {
+			const record = parseRecord(value);
+			if (record.phase === "scan" || record.phase === "validate" || record.phase === "reload") return { phase: record.phase };
+			if (record.phase === "compress" || record.phase === "restore") {
+				const completedBytes = parseCount(record.completedBytes);
+				const totalBytes = parseCount(record.totalBytes);
+				if (completedBytes > totalBytes) throw new Error("invalid backup progress byte range");
+				return {
+					phase: record.phase,
+					completedBytes,
+					totalBytes
+				};
+			}
+			throw new Error("unknown backup progress phase");
+		}
+		/** Parse one complete NDJSON line; this is the progress protocol's sole browser parser. */
+		function parseProgressLine(line) {
+			const record = parseRecord(JSON.parse(line));
+			if (record.type === "progress") return {
+				type: "progress",
+				progress: parseHostProgress(record.progress)
+			};
+			if (record.type === "export-ready") {
+				if (typeof record.downloadUrl !== "string" || record.downloadUrl === "") throw new Error("invalid backup export download URL");
+				return {
+					type: "export-ready",
+					downloadUrl: record.downloadUrl,
+					entries: parseCount(record.entries)
+				};
+			}
+			if (record.type === "import-complete") return {
+				type: "import-complete",
+				entries: parseCount(record.entries)
+			};
+			if (record.type === "error" && typeof record.message === "string") return {
+				type: "error",
+				message: record.message
+			};
+			throw new Error("unknown backup progress message");
+		}
+		/** Read and validate one exact-route NDJSON response until its terminal line. */
+		async function readProgressResponse(response, report) {
+			if (!response.ok) throw new Error("backup operation failed: HTTP " + String(response.status));
+			if (response.body === null) throw new Error("backup progress response has no body");
+			const reader = response.body.getReader();
+			const decoder = new TextDecoder();
+			let pending = "";
+			let terminal;
+			let terminalError;
+			try {
+				while (true) {
+					const { done, value } = await reader.read();
+					pending += decoder.decode(value, { stream: !done });
+					const lines = pending.split(String.fromCharCode(10));
+					if (done) pending = "";
+					else pending = lines.pop();
+					for (const line of lines) {
+						if (line === "") continue;
+						const message = parseProgressLine(line);
+						if (message.type === "progress") report(message.progress);
+						else if (message.type === "error") terminalError = message.message;
+						else terminal = message;
+					}
+					if (done) break;
+				}
+			} finally {
+				reader.releaseLock();
+			}
+			if (terminalError !== void 0) throw new Error(terminalError);
+			if (terminal === void 0) throw new Error("backup progress response ended without a result");
+			return terminal;
+		}
+		/** Parse the upload route's single-use token response. */
+		function parseUploadToken(text) {
+			const record = parseRecord(JSON.parse(text));
+			if (typeof record.token !== "string" || record.token === "") throw new Error("invalid backup upload token");
+			return record.token;
+		}
+		/** Upload a File with browser-native byte progress and caller cancellation. */
+		function uploadArchive(file, report, signal) {
+			report({
+				phase: "upload",
+				completedBytes: 0,
+				totalBytes: file.size
+			});
+			return new Promise((resolve, reject) => {
+				const request = new XMLHttpRequest();
+				const onSignalAbort = () => {
+					request.abort();
+				};
+				const settle = (complete) => {
+					signal.removeEventListener("abort", onSignalAbort);
+					complete();
+				};
+				request.open("POST", browserHostUrl("/api/backup.upload"));
+				request.upload.onprogress = (event) => {
+					report({
+						phase: "upload",
+						completedBytes: event.loaded,
+						totalBytes: file.size
+					});
+				};
+				request.onload = () => {
+					if (request.status < 200 || request.status >= 300) {
+						settle(() => {
+							reject(/* @__PURE__ */ new Error("backup upload failed: HTTP " + String(request.status)));
+						});
+						return;
+					}
+					try {
+						const token = parseUploadToken(request.responseText);
+						settle(() => {
+							resolve(token);
+						});
+					} catch (error) {
+						settle(() => {
+							reject(error instanceof Error ? error : new Error(String(error)));
+						});
+					}
+				};
+				request.onerror = () => {
+					settle(() => {
+						reject(/* @__PURE__ */ new Error("backup upload failed"));
+					});
+				};
+				request.onabort = () => {
+					settle(() => {
+						reject(new DOMException("Backup upload aborted", "AbortError"));
+					});
+				};
+				signal.addEventListener("abort", onSignalAbort, { once: true });
+				request.send(file);
+			});
+		}
+		/** Register the Backup settings section and its exact-route transport callbacks. */
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "plus-backup: dictionaries");
+			const store = createBackupSectionStore();
+			let activeController = null;
+			ctx.effect(() => () => {
+				activeController?.abort();
+			}, "plus-backup: cancel active operation");
+			const runAbortable = async (run) => {
+				const controller = new AbortController();
+				activeController = controller;
+				try {
+					return await run(controller.signal);
+				} finally {
+					if (activeController === controller) activeController = null;
+				}
+			};
+			const injected = () => ({
+				exportArchive: (report) => runAbortable(async (signal) => {
+					const terminal = await readProgressResponse(await fetch(browserHostUrl("/api/backup.export.prepare"), {
+						method: "POST",
+						signal
+					}), report);
+					if (terminal.type !== "export-ready") throw new Error("backup export returned an import result");
+					return {
+						downloadUrl: browserHostUrl(terminal.downloadUrl),
+						entries: terminal.entries
+					};
+				}),
+				importArchive: (file, report) => runAbortable(async (signal) => {
+					const token = await uploadArchive(file, report, signal);
+					const terminal = await readProgressResponse(await fetch(browserHostUrl("/api/backup.import?token=" + encodeURIComponent(token)), {
+						method: "POST",
+						signal
+					}), report);
+					if (terminal.type !== "import-complete") throw new Error("backup import returned an export result");
+					return { entries: terminal.entries };
+				}),
+				cancelOperation: () => {
+					activeController?.abort();
+				},
+				reloadPage: () => {
+					window.location.reload();
+				}
+			});
+			ctx.slots.inject("settings.section", () => ctx.slots.register({
+				name: "settings.section",
+				id: "backup",
+				order: 30,
+				label: () => ctx.locale.bind(NS)("nav"),
+				locale: NS,
+				store,
+				inject: injected
+			}, BackupSection));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map