share-pages 0.1.0

package/dist/index.mjs

@@ -0,0 +1,679 @@
+#!/usr/bin/env node
+import { a as digest, i as defaultLimits, n as CHUNK_SIZE, r as assert, s as formats, t as AppError } from "./dist-JyXFh6I5.mjs";
+import { Command, CommanderError, Option } from "commander";
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { createWriteStream } from "node:fs";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+//#region ../../packages/sdk/dist/index.js
+function checkAbort(signal) {
+	if (signal?.aborted) throw new AppError("ABORTED", "操作已取消，上传会话仍可恢复", 499);
+}
+function abortScope(parent, timeoutMs) {
+	const controller = new AbortController();
+	const abort = () => controller.abort(parent?.reason);
+	if (parent?.aborted) abort();
+	else parent?.addEventListener("abort", abort, { once: true });
+	const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => controller.abort(), timeoutMs);
+	return {
+		controller,
+		signal: controller.signal,
+		dispose() {
+			if (timer !== void 0) clearTimeout(timer);
+			parent?.removeEventListener("abort", abort);
+		}
+	};
+}
+function delay(ms, signal) {
+	checkAbort(signal);
+	return new Promise((resolve, reject) => {
+		const finish = () => {
+			signal?.removeEventListener("abort", cancel);
+			resolve();
+		};
+		const timer = setTimeout(finish, ms);
+		const cancel = () => {
+			clearTimeout(timer);
+			signal?.removeEventListener("abort", cancel);
+			reject(new AppError("ABORTED", "操作已取消，上传会话仍可恢复", 499));
+		};
+		signal?.addEventListener("abort", cancel, { once: true });
+	});
+}
+function result(session) {
+	assert(session.result, "INVALID_RESPONSE", "已提交会话缺少发布结果", 502);
+	return session.result;
+}
+async function waitForUpload(client, id, timeoutMs = 12e4, signal) {
+	assert(Number.isFinite(timeoutMs) && timeoutMs >= 0, "INVALID_TIMEOUT", "等待时间必须为非负有限数");
+	const end = Date.now() + timeoutMs;
+	while (true) {
+		checkAbort(signal);
+		const status = await client.request(`/uploads/${encodeURIComponent(id)}`, { signal }, true);
+		if (status.status === "committed") return result(status);
+		if ([
+			"failed",
+			"cancelled",
+			"expired"
+		].includes(status.status)) throw new AppError(status.error?.code ?? "PUBLISH_FAILED", status.error?.message ?? `发布 ${status.status}`, 409);
+		if (Date.now() >= end) return status;
+		await delay(Math.min(500, Math.max(0, end - Date.now())), signal);
+	}
+}
+async function publish(client, prepared, options = {}) {
+	const { idempotencyKey = crypto.randomUUID(), uploadId, wait = true, timeoutMs = 12e4, signal, uploadConcurrency = 3, onProgress, onSession, ...input } = options;
+	assert(Number.isFinite(timeoutMs) && timeoutMs >= 0, "INVALID_TIMEOUT", "等待时间必须为非负有限数");
+	assert(Number.isInteger(uploadConcurrency) && uploadConcurrency >= 1 && uploadConcurrency <= 4, "INVALID_CONCURRENCY", "上传并发数必须为 1–4");
+	checkAbort(signal);
+	let session = uploadId ? await client.request(`/uploads/${encodeURIComponent(uploadId)}`, { signal }, true) : await client.json("/uploads", "POST", {
+		...input,
+		title: options.title ?? prepared.title,
+		manifest: prepared.manifest
+	}, { "Idempotency-Key": idempotencyKey }, true, signal);
+	assert(session.manifestDigest === await digest(JSON.stringify(prepared.manifest)), "RESUME_MISMATCH", "上传会话与本地内容清单不同");
+	await onSession?.(session);
+	if (session.status === "committed") return result(session);
+	if (session.status === "uploading") {
+		const files = new Map(prepared.manifest.files.map((file) => [file.id, file]));
+		const tasks = [];
+		const total = prepared.manifest.files.reduce((sum, file) => sum + file.size, 0);
+		let completed = total;
+		for (const missing of session.missing) {
+			const file = files.get(missing.fileId);
+			const data = prepared.files.get(missing.fileId);
+			assert(file && data, "RESUME_MISMATCH", "断点会话与本地文件不同");
+			assert(data.byteLength === file.size, "RESUME_MISMATCH", "本地文件大小与清单不同");
+			assert(new Set(missing.parts).size === missing.parts.length, "INVALID_RESPONSE", "服务端返回重复分片", 502);
+			for (const part of missing.parts) {
+				assert(Number.isInteger(part) && part >= 0 && (part === 0 || part * 8388608 < file.size), "INVALID_RESPONSE", "服务端分片编号无效", 502);
+				const bytes = data.subarray(part * CHUNK_SIZE, (part + 1) * CHUNK_SIZE);
+				completed -= bytes.byteLength;
+				tasks.push({
+					fileId: missing.fileId,
+					part,
+					bytes
+				});
+			}
+		}
+		onProgress?.(completed, total);
+		const scope = abortScope(signal);
+		let next = 0;
+		let failure;
+		try {
+			await Promise.all(Array.from({ length: Math.min(uploadConcurrency, tasks.length) }, async () => {
+				try {
+					while (next < tasks.length) {
+						checkAbort(scope.signal);
+						const task = tasks[next++];
+						if (!task) break;
+						await client.request(`/uploads/${session.id}/files/${task.fileId}?part=${task.part}`, {
+							method: "PUT",
+							headers: { "X-Chunk-SHA256": await digest(task.bytes) },
+							body: task.bytes,
+							signal: scope.signal
+						}, true);
+						completed += task.bytes.byteLength;
+						onProgress?.(completed, total);
+					}
+				} catch (error) {
+					failure ??= error;
+					scope.controller.abort();
+				}
+			}));
+			if (failure) throw failure;
+		} finally {
+			scope.dispose();
+		}
+		session = await client.json(`/uploads/${session.id}/complete`, "POST", {}, {}, true, signal);
+	}
+	return wait ? waitForUpload(client, session.id, timeoutMs, signal) : session;
+}
+var HTTPClient = class {
+	server;
+	transport;
+	token;
+	timeout;
+	constructor(options) {
+		this.server = options.server.replace(/\/$/, "");
+		let url;
+		try {
+			url = new URL(this.server);
+		} catch {
+			throw new AppError("INVALID_SERVER", "实例地址需要是 HTTP(S) origin");
+		}
+		if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.pathname !== "/" || url.search || url.hash) throw new AppError("INVALID_SERVER", "实例地址需要是 HTTP(S) origin");
+		if (url.protocol !== "https:" && ![
+			"localhost",
+			"127.0.0.1",
+			"[::1]"
+		].includes(url.hostname)) throw new AppError("INSECURE_SERVER", "远端实例必须使用 HTTPS");
+		this.timeout = options.requestTimeoutMs ?? 3e4;
+		if (!Number.isFinite(this.timeout) || this.timeout <= 0) throw new AppError("INVALID_TIMEOUT", "请求超时必须是有限正数");
+		this.token = options.token;
+		this.transport = options.fetch ?? globalThis.fetch.bind(globalThis);
+	}
+	async request(path, init = {}, retry = false) {
+		const headers = new Headers(init.headers);
+		if (this.token) headers.set("Authorization", `Bearer ${this.token}`);
+		for (let attempt = 0;; attempt++) {
+			checkAbort(init.signal);
+			const scope = abortScope(init.signal, this.timeout);
+			let retryAfter = 250 * 2 ** attempt;
+			try {
+				const response = await this.transport(`${this.server}/api/v1${path}`, {
+					...init,
+					headers,
+					credentials: "include",
+					signal: init.signal ? AbortSignal.any([scope.signal, init.signal]) : scope.signal
+				});
+				if (retry && [
+					429,
+					502,
+					503,
+					504
+				].includes(response.status) && attempt < 3) {
+					const value = response.headers.get("Retry-After");
+					if (value) retryAfter = Math.min(5e3, Math.max(0, /^\d+$/.test(value) ? Number(value) * 1e3 : Date.parse(value) - Date.now()) || retryAfter);
+					await response.body?.cancel();
+				} else {
+					if (!response.ok) {
+						let error = {};
+						try {
+							const value = await response.json();
+							if (value && typeof value === "object") error = value;
+						} catch {}
+						throw new AppError(typeof error.code === "string" ? error.code : "HTTP_ERROR", typeof error.message === "string" ? error.message : `请求失败 (${response.status})`, response.status, error.fields, error.requestId ?? response.headers.get("X-Request-Id") ?? void 0);
+					}
+					if (response.headers.get("Content-Type")?.includes("application/json")) try {
+						return await response.json();
+					} catch {
+						throw new AppError("INVALID_RESPONSE", "服务端返回了无效 JSON", 502);
+					}
+					return response;
+				}
+			} catch (error) {
+				checkAbort(init.signal);
+				if (error instanceof AppError) throw error;
+				if (!retry || attempt >= 3) throw new AppError(scope.signal.aborted ? "REQUEST_TIMEOUT" : "NETWORK_ERROR", "网络请求失败，可使用相同上传会话继续", 503);
+			} finally {
+				scope.dispose();
+			}
+			await delay(retryAfter, init.signal);
+		}
+	}
+	json(path, method, body, headers = {}, retry = false, signal) {
+		return this.request(path, {
+			method,
+			headers: {
+				"Content-Type": "application/json",
+				...headers
+			},
+			body: JSON.stringify(body),
+			signal
+		}, retry);
+	}
+};
+var SharePagesClient = class extends HTTPClient {
+	publish(prepared, options = {}) {
+		return publish(this, prepared, options);
+	}
+	waitForUpload(id, timeoutMs = 12e4, signal) {
+		return waitForUpload(this, id, timeoutMs, signal);
+	}
+	capabilities() {
+		return this.request("/capabilities", {}, true);
+	}
+	listPages(params = {}) {
+		return this.request(`/pages?${new URLSearchParams(params)}`);
+	}
+	getPage(id) {
+		return this.request(`/pages/${encodeURIComponent(id)}`);
+	}
+	listVersions(id, cursor) {
+		return this.request(`/pages/${encodeURIComponent(id)}/versions` + (cursor ? `?cursor=${encodeURIComponent(cursor)}` : ""));
+	}
+	patchPage(id, patch) {
+		return this.json(`/pages/${encodeURIComponent(id)}`, "PATCH", patch);
+	}
+	async rollback(id, versionId, options = {}) {
+		const s = await this.json(`/pages/${encodeURIComponent(id)}/rollback`, "POST", { versionId }, { "Idempotency-Key": options.idempotencyKey ?? crypto.randomUUID() }, true);
+		return options.wait === false ? s : this.waitForUpload(s.id, options.timeoutMs);
+	}
+	deletePage(id, purge = false) {
+		return this.request(`/pages/${encodeURIComponent(id)}?purge=${purge}`, { method: "DELETE" });
+	}
+	restorePage(id, replaceWith) {
+		return this.json(`/pages/${encodeURIComponent(id)}/restore`, "POST", { replaceWith });
+	}
+	deleteVersion(id, version, options = {}) {
+		const params = new URLSearchParams(Object.entries(options).filter(([, v]) => v !== void 0).map(([k, v]) => [k, String(v)]));
+		return this.request(`/pages/${encodeURIComponent(id)}/versions/${encodeURIComponent(version)}?${params}`, { method: "DELETE" });
+	}
+	restoreVersion(id, version) {
+		return this.json(`/pages/${encodeURIComponent(id)}/versions/${encodeURIComponent(version)}/restore`, "POST", {});
+	}
+	download(id, version) {
+		return this.request(`/pages/${encodeURIComponent(id)}/versions/${encodeURIComponent(version)}/download`);
+	}
+	stats(params = {}) {
+		return this.request(`/stats?${new URLSearchParams(params)}`);
+	}
+};
+//#endregion
+//#region src/config.ts
+const configDir = process.env.SHARE_PAGES_CONFIG_DIR ?? join(process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), "share-pages");
+const configPath = join(configDir, "config.json");
+async function readConfig() {
+	try {
+		const value = JSON.parse(await readFile(configPath, "utf8"));
+		if (!validConfig(value)) throw new Error("Invalid configuration");
+		return value;
+	} catch (e) {
+		if (e.code === "ENOENT") return {
+			active: "default",
+			profiles: {}
+		};
+		throw new AppError("CONFIG_ERROR", "配置文件读取失败");
+	}
+}
+function validConfig(value) {
+	if (!value || typeof value !== "object" || !("active" in value) || !("profiles" in value)) return false;
+	if (typeof value.active !== "string" || !value.profiles || typeof value.profiles !== "object" || Array.isArray(value.profiles)) return false;
+	return Object.values(value.profiles).every((profile) => profile && typeof profile === "object" && typeof profile.server === "string" && typeof profile.token === "string");
+}
+async function savePrivate(path, data) {
+	await mkdir(configDir, {
+		recursive: true,
+		mode: 448
+	});
+	const temp = `${path}.${randomUUID()}.tmp`;
+	try {
+		await writeFile(temp, `${JSON.stringify(data, null, 2)}\n`, {
+			mode: 384,
+			flag: "wx"
+		});
+		await rename(temp, path);
+		await chmod(path, 384);
+	} finally {
+		await unlink(temp).catch((error) => {
+			if (error.code !== "ENOENT") throw error;
+		});
+	}
+}
+async function writeConfig(config) {
+	await savePrivate(configPath, config);
+}
+async function profile(name, server) {
+	const config = await readConfig(), key = name ?? config.active, p = Object.hasOwn(config.profiles, key) ? config.profiles[key] : void 0;
+	const value = {
+		server: server ?? process.env.SHARE_PAGES_SERVER ?? p?.server,
+		token: process.env.SHARE_PAGES_TOKEN ?? p?.token
+	};
+	if (!value.server || !value.token) throw new AppError("LOGIN_REQUIRED", "请先登录，或设置 SHARE_PAGES_SERVER 和 SHARE_PAGES_TOKEN", 401);
+	return value;
+}
+function resumePath(id) {
+	if (!/^[a-z0-9-]+$/i.test(id)) throw new AppError("INVALID_UPLOAD_ID", "非法上传 ID");
+	return join(configDir, `upload-${id}.json`);
+}
+//#endregion
+//#region src/input.ts
+async function stdinBytes(limit = 100 * 1024 ** 2) {
+	const chunks = [];
+	let length = 0;
+	for await (const chunk of process.stdin) {
+		const b = Buffer.from(chunk);
+		length += b.length;
+		if (length > limit) throw new AppError("INPUT_TOO_LARGE", "stdin 内容超限", 413);
+		chunks.push(b);
+	}
+	return new Uint8Array(Buffer.concat(chunks));
+}
+async function secret(prompt, interactive = true) {
+	if (!interactive || !process.stdin.isTTY) throw new AppError("INPUT_REQUIRED", "非交互模式需要通过 stdin 文件或环境变量提供秘密");
+	process.stderr.write(prompt);
+	process.stdin.setRawMode(true);
+	process.stdin.resume();
+	return new Promise((resolve, reject) => {
+		let value = "";
+		const onData = (data) => {
+			for (const c of data.toString("utf8")) {
+				if (c === "\r" || c === "\n") {
+					cleanup();
+					resolve(value);
+					return;
+				}
+				if (c === "") {
+					cleanup();
+					reject(new AppError("CANCELLED", "操作取消"));
+					return;
+				}
+				if (c === "") value = value.slice(0, -1);
+				else if (c >= " ") value += c;
+			}
+		};
+		function cleanup() {
+			process.stdin.off("data", onData);
+			process.stdin.setRawMode(false);
+			process.stdin.pause();
+			process.stderr.write("\n");
+		}
+		process.stdin.on("data", onData);
+	});
+}
+async function confirm(message, yes, interactive) {
+	if (yes) return;
+	if (!interactive || !process.stdin.isTTY) throw new AppError("CONFIRMATION_REQUIRED", "自动化删除需要显式 --yes");
+	const rl = createInterface({
+		input: process.stdin,
+		output: process.stderr
+	});
+	try {
+		if (await rl.question(`${message} 输入 yes 继续：`) !== "yes") throw new AppError("CANCELLED", "操作取消");
+	} finally {
+		rl.close();
+	}
+}
+//#endregion
+//#region src/shared.ts
+function createCommand() {
+	return new Command().name("share-pages").description("个人静态内容发布工具").version("0.1.0").option("--json", "stdout 仅输出 JSON").option("--quiet", "隐藏进度").option("--no-interactive", "禁止交互输入").option("--profile <name>", "实例 profile").option("--server <url>", "覆盖实例地址").exitOverride();
+}
+function options(command) {
+	const chain = [];
+	for (let current = command; current; current = current.parent) chain.unshift(current);
+	const values = {};
+	for (const current of chain) for (const [key, value] of Object.entries(current.opts())) if (!(key in values) || current.getOptionValueSource(key) !== "default") values[key] = value;
+	return values;
+}
+function stringOptions(options, keys) {
+	const values = {};
+	for (const key of keys) {
+		const value = options[key];
+		if (typeof value === "string") values[key] = value;
+	}
+	return values;
+}
+function output(value, o) {
+	if (o.json) process.stdout.write(`${JSON.stringify(value)}\n`);
+	else if (typeof value === "object" && value && "url" in value) process.stdout.write(`${String(value.url)}\n`);
+	else process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+async function client(o) {
+	return new SharePagesClient(await profile(o.profile, o.server));
+}
+//#endregion
+//#region src/accounts.ts
+function registerAccounts(cli) {
+	cli.command("login").description("保存实例和发布 Token").option("--token-stdin", "从 stdin 读取 Token").action(async (_local, command) => {
+		const o = options(command), token = o.tokenStdin ? new TextDecoder().decode(await stdinBytes(1024)).trim() : process.env.SHARE_PAGES_TOKEN ?? await secret("发布 Token：", o.interactive);
+		if (!o.server) throw new AppError("SERVER_REQUIRED", "登录需要 --server <url>");
+		const sdk = new SharePagesClient({
+			server: o.server,
+			token
+		});
+		await sdk.request("/me");
+		const config = await readConfig();
+		const name = o.profile ?? "default";
+		config.profiles = {
+			...config.profiles,
+			[name]: {
+				server: sdk.server,
+				token
+			}
+		};
+		config.active = name;
+		await writeConfig(config);
+		output({
+			profile: name,
+			server: sdk.server,
+			status: "logged-in"
+		}, o);
+	});
+	const profiles = cli.command("profiles");
+	profiles.command("list").action(async (_o, command) => {
+		const o = options(command), c = await readConfig();
+		output({
+			active: c.active,
+			profiles: Object.entries(c.profiles).map(([name, p]) => ({
+				name,
+				server: p.server
+			}))
+		}, o);
+	});
+	profiles.command("use <name>").action(async (name, _o, command) => {
+		const o = options(command), c = await readConfig();
+		if (!Object.hasOwn(c.profiles, name)) throw new AppError("PROFILE_NOT_FOUND", "实例配置不存在");
+		c.active = name;
+		await writeConfig(c);
+		output({ active: name }, o);
+	});
+}
+//#endregion
+//#region src/pages.ts
+function registerPages(cli) {
+	const pages = cli.command("pages");
+	pages.command("list").option("--state <state>").option("--q <text>").option("--format <format>").option("--access <mode>").option("--cursor <cursor>").action(async (_local, command) => {
+		const o = options(command);
+		output(await (await client(o)).listPages(stringOptions(o, [
+			"state",
+			"q",
+			"format",
+			"access",
+			"cursor"
+		])), o);
+	});
+	pages.command("get <id>").action(async (id, _local, command) => {
+		const o = options(command);
+		output(await (await client(o)).getPage(id), o);
+	});
+	pages.command("edit <id>").option("--title <title>").option("--access <mode>").option("--indexable <boolean>").option("--password-file <path>").action(async (id, _local, command) => {
+		const o = options(command);
+		const patch = {};
+		if (o.title) patch.title = o.title;
+		if (o.access) patch.access = o.access;
+		if (o.indexable !== void 0) {
+			if (typeof o.indexable !== "string" || !["true", "false"].includes(o.indexable)) throw new AppError("VALIDATION_ERROR", "--indexable 使用 true/false");
+			patch.indexable = o.indexable === "true";
+		}
+		if (o.access === "password") patch.password = o.passwordFile ? (await readFile(o.passwordFile, "utf8")).trimEnd() : await secret("页面密码：", o.interactive);
+		output(await (await client(o)).patchPage(id, patch), o);
+	});
+	pages.command("delete <id>").option("--purge").option("--yes").action(async (id, _local, command) => {
+		const o = options(command), sdk = await client(o);
+		const page = await sdk.getPage(id);
+		await confirm(`${o.purge ? "永久删除" : "移入回收站"}页面 ${id}（${page.title}）及全部版本。`, !!o.yes, !!o.interactive);
+		output(await sdk.deletePage(id, o.purge), o);
+	});
+	pages.command("restore <id>").option("--replace-with <version>").action(async (id, _local, command) => {
+		const o = options(command);
+		output(await (await client(o)).restorePage(id, o.replaceWith), o);
+	});
+}
+//#endregion
+//#region src/publish.ts
+function registerPublish(cli) {
+	cli.command("publish <input>").description("发布文件、ZIP 或目录；使用 - 从 stdin 读取内容").option("--id <id>").option("--update", "更新已有 ID").option("--type <format>").option("--title <title>").option("--entry <path>", "HTML 入口", "index.html").option("--spa", "启用 HTML 导航回退").option("--access <access>", "public / password / admin").option("--indexable", "允许公开页面收录").option("--encoding <encoding>", "文本编码", "utf-8").option("--delimiter <delimiter>", "CSV 分隔符").option("--no-header", "CSV 没有表头").option("--password-file <path>", "从权限受限文件读取页面密码").option("--dry-run", "仅检查转换和 manifest").option("--resume <uploadId>", "继续上传会话").option("--idempotency-key <key>").option("--no-wait", "提交后返回处理中状态").option("--timeout <seconds>", "等待秒数", "120").action(async (input, _local, command) => {
+		const o = options(command);
+		const { prepareNode, prepareBytes, ensureDOM } = await import("./node-Lh4CQjZ4.mjs");
+		if (o.type && !formats.includes(o.type)) throw new AppError("UNSUPPORTED_FORMAT", `--type 必须是 ${formats.join(", ")}`);
+		if (input === "-" && !o.type) throw new AppError("TYPE_REQUIRED", "stdin 需要显式 --type");
+		let sdk, limits = defaultLimits;
+		if (!o.dryRun) {
+			sdk = await client(o);
+			limits = (await sdk.capabilities()).limits;
+		}
+		const prepareOptions = {
+			type: o.type,
+			title: o.title,
+			entry: o.entry,
+			spa: o.spa,
+			encoding: o.encoding,
+			delimiter: o.delimiter,
+			header: o.header,
+			limits
+		};
+		let prepared;
+		if (input === "-") {
+			if (o.type === "latex") await ensureDOM();
+			prepared = await prepareBytes(`stdin.${o.type === "markdown" ? "md" : o.type === "latex" ? "tex" : o.type}`, await stdinBytes(limits.inputBytes), prepareOptions);
+		} else prepared = await prepareNode(input, prepareOptions);
+		if (o.dryRun) {
+			output({
+				status: "valid",
+				title: prepared.title,
+				manifest: prepared.manifest,
+				warnings: prepared.warnings
+			}, o);
+			return;
+		}
+		const manifestHash = await digest(JSON.stringify(prepared.manifest));
+		if (!sdk) throw new AppError("MISSING_CLIENT", "发布客户端尚未初始化");
+		if (o.resume) {
+			const saved = JSON.parse(await readFile(resumePath(o.resume), "utf8"));
+			if (saved.manifestHash !== manifestHash || saved.server !== sdk?.server) throw new AppError("RESUME_MISMATCH", "文件内容或实例与断点会话不一致");
+		}
+		const password = o.access === "password" ? o.passwordFile ? (await readFile(o.passwordFile, "utf8")).trimEnd() : await secret("页面密码（至少 8 位）：", o.interactive) : void 0;
+		const result = await sdk.publish(prepared, {
+			id: o.id,
+			update: !!o.update,
+			title: o.title,
+			access: o.access,
+			password,
+			indexable: typeof o.indexable === "boolean" ? o.indexable : void 0,
+			idempotencyKey: o.idempotencyKey,
+			uploadId: o.resume,
+			wait: o.wait,
+			timeoutMs: Number(o.timeout) * 1e3,
+			onSession: async (s) => {
+				await savePrivate(resumePath(s.id), {
+					server: sdk?.server,
+					uploadId: s.id,
+					manifestHash
+				});
+				if (!o.quiet) process.stderr.write(`上传会话 ${s.id}\n`);
+			},
+			onProgress: (done, total) => {
+				if (!o.quiet && process.stderr.isTTY) process.stderr.write(`\r上传 ${total ? Math.floor(done / total * 100) : 100}%`);
+			}
+		});
+		if (!o.quiet && process.stderr.isTTY) process.stderr.write("\n");
+		output(result, o);
+		if (result.status !== "ready") process.exitCode = 6;
+	});
+}
+//#endregion
+//#region src/stats.ts
+function registerStats(cli) {
+	cli.command("stats [id]").option("--version <version>").option("--from <date>").option("--to <date>").option("--csv").action(async (id, _local, command) => {
+		const o = options(command), params = {};
+		if (id) params.page = id;
+		for (const k of [
+			"version",
+			"from",
+			"to"
+		]) if (o[k]) params[k] = o[k];
+		if (o.csv) params.format = "csv";
+		const data = await (await client(o)).stats(params);
+		if (data instanceof Response) process.stdout.write(await data.text());
+		else output(data, o);
+	});
+	cli.command("uploads <id>").action(async (id, _local, command) => {
+		const o = options(command);
+		output(await (await client(o)).request(`/uploads/${encodeURIComponent(id)}`), o);
+	});
+}
+//#endregion
+//#region src/transfer.ts
+function registerTransfer(cli) {
+	cli.command("download <id>").option("--version <version>").option("-o, --output <file>").action(async (id, _local, command) => {
+		const o = options(command), sdk = await client(o);
+		const version = o.version ?? (await sdk.getPage(id)).current_version_id;
+		if (!version) throw new AppError("NO_CURRENT_VERSION", "页面没有当前版");
+		const response = await sdk.download(id, String(version));
+		const filename = o.output ?? `${id}-${version}.source`;
+		if (!response.body) throw new AppError("EMPTY_DOWNLOAD", "下载内容为空");
+		await pipeline(Readable.fromWeb(response.body), createWriteStream(filename, {
+			flags: "wx",
+			mode: 384
+		}));
+		output({
+			file: filename,
+			versionId: version
+		}, o);
+	});
+}
+//#endregion
+//#region src/versions.ts
+function registerVersions(cli) {
+	const versions = cli.command("versions");
+	versions.command("list <id>").option("--cursor <cursor>").action(async (id, _local, command) => {
+		const o = options(command);
+		output(await (await client(o)).listVersions(id, o.cursor), o);
+	});
+	versions.command("delete <id> <version>").option("--replace-with <version>").option("--unpublish").option("--purge").option("--yes").action(async (id, version, _local, command) => {
+		const o = options(command), sdk = await client(o);
+		await sdk.getPage(id);
+		await confirm(`${o.purge ? "永久删除" : "移入回收站"} ${id} 的版本 ${version}。`, !!o.yes, !!o.interactive);
+		output(await sdk.deleteVersion(id, version, {
+			replaceWith: o.replaceWith,
+			unpublish: o.unpublish,
+			purge: o.purge
+		}), o);
+	});
+	versions.command("restore <id> <version>").action(async (id, version, _local, command) => {
+		const o = options(command);
+		output(await (await client(o)).restoreVersion(id, version), o);
+	});
+	cli.command("rollback <id>").requiredOption("--to <version>").option("--no-wait").action(async (id, _local, command) => {
+		const o = options(command), result = await (await client(o)).rollback(id, o.to ?? "", { wait: o.wait });
+		output(result, o);
+		if (result.status !== "ready") process.exitCode = 6;
+	});
+}
+//#endregion
+//#region src/program.ts
+function buildCLI() {
+	const cli = createCommand();
+	registerAccounts(cli);
+	registerPublish(cli);
+	registerPages(cli);
+	registerVersions(cli);
+	registerTransfer(cli);
+	registerStats(cli);
+	const configure = (command) => {
+		command.enablePositionalOptions();
+		for (const option of cli.options) {
+			if (option.long === "--version" || command.options.some((local) => local.long === option.long)) continue;
+			command.addOption(new Option(option.flags, option.description));
+		}
+		for (const child of command.commands) configure(child);
+	};
+	configure(cli);
+	return cli;
+}
+//#endregion
+//#region src/index.ts
+const cli = buildCLI();
+try {
+	await cli.parseAsync();
+} catch (error) {
+	if (error instanceof CommanderError && error.exitCode === 0) process.exitCode = 0;
+	else {
+		const e = error instanceof AppError ? error : new AppError("CLI_ERROR", error instanceof Error ? error.message : "命令执行失败");
+		const result = {
+			code: e.code,
+			message: e.message,
+			fields: e.fields
+		};
+		if (process.argv.includes("--json")) process.stdout.write(`${JSON.stringify({ error: result })}\n`);
+		else process.stderr.write(`${e.code}: ${e.message}\n`);
+		process.exitCode = e.status === 401 || e.status === 403 ? 3 : e.status === 409 ? 4 : e.status >= 500 ? 5 : 2;
+	}
+}
+//#endregion
+export {};