wkgeo-cli 0.2.0 → 0.2.1

package/lib/site-state.mjs

@@ -0,0 +1,137 @@
+/**
+ * 「当前选中站点」的本地状态：**`<凭据目录>/config.json`**（默认 `~/.wkongai/config.json`）。
+ *
+ * 为什么需要它：CMS（栏目 / 内容 / 素材 / 模板）的每个动作都必须落在一个站点上，
+ * 而 CMS 的 `site_id` **只从会话或 `x-cms-site` 头里取**（body 里的 `site_id` 后端故意忽略，
+ * 见 `tencent/functions/cms/index.js` 的 `resolveSite`）。CLI 没有 Cookie 会话，
+ * 所以只能把"我这次要操作哪个站"记在本地，之后每个请求带 `x-cms-site`。
+ *
+ * 为什么不放进 `credentials.json`：
+ *   * 那个文件是**凭据**（0600、只存令牌与账号），删除它 = 退出登录；
+ *   * "选了哪个站"只是操作上下文，`logout` 不该把它一起带走，反过来重新登录也不该丢。
+ *   分成两个文件之后，两件事的语义各自清楚。
+ *
+ * 为什么放在凭据文件同目录：`--credentials` / `WKONGAI_CREDENTIALS` 已经在做"换一套身份"的隔离
+ *   （单测、多人共机、联调都靠它），站点选择跟着走最不容易串；
+ *   默认情况下就是规划文档里写的 `~/.wkongai/config.json`。
+ *
+ * ⚠️ 这个文件**不含任何秘密**（只有站点 id / 名字），但仍然用原子写 + 0600：
+ *    权限口径统一，省得以后往里加别的东西时忘了。
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { CliError } from './errors.mjs';
+
+/** 状态文件版本（将来改结构时用来判断要不要迁移；现在只写不读） */
+export const SITE_STATE_VERSION = 1;
+
+/** 文件名（与规划文档一致：`~/.wkongai/config.json`） */
+export const SITE_STATE_FILE_NAME = 'config.json';
+
+/** 读原始 JSON 对象；文件不存在 / 坏掉都返回 `{}`（写路径用，绝不因为"读不懂"而写不进去） */
+function readRawObjectQuiet(file) {
+  try {
+    const text = fs.readFileSync(file, 'utf8');
+    const parsed = JSON.parse(text);
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+
+/**
+ * 读当前选中的站点。
+ *
+ * @param {string} file 状态文件路径
+ * @returns {{id:string, label:string, saved_at:string|null}|null} 没选过 → `null`
+ * @throws {CliError} 文件存在但**不是合法 JSON / 内容形状不对**（明确报错，不静默当"没选"——
+ *   否则用户会一直看到"还没有选择站点"，却不知道自己有个坏文件在那儿）
+ */
+export function readSiteState(file) {
+  if (!file) return null;
+  let text;
+  try {
+    text = fs.readFileSync(file, 'utf8');
+  } catch (e) {
+    if (e && e.code === 'ENOENT') return null;
+    throw new CliError(`读取本地站点配置失败：${e.message}`, {
+      kind: 'config',
+      hint: `文件位置：${file}`,
+      cause: e,
+    });
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch (e) {
+    throw new CliError(`本地站点配置不是合法 JSON：${file}`, {
+      kind: 'config',
+      hint: '删掉它，或重新运行 `wkgeo site use <站点ID>`（会覆盖写入）',
+      cause: e,
+    });
+  }
+  const one = parsed && typeof parsed === 'object' ? parsed.cms_site : null;
+  if (!one || typeof one !== 'object' || !one.id) return null;
+  return {
+    id: String(one.id),
+    label: String(one.label || ''),
+    saved_at: one.saved_at || null,
+  };
+}
+
+/**
+ * 记住"当前站点"（**保留文件里的其它键**：以后往里放别的本地设置时不用改这里）。
+ *
+ * @param {string} file
+ * @param {{id:string, label?:string}} site
+ */
+export function writeSiteState(file, site, { now = Date.now() } = {}) {
+  const id = String((site && site.id) || '').trim();
+  if (!id) throw new CliError('内部错误：写本地站点配置时缺少站点 id');
+  const dir = path.dirname(file);
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+
+  const payload = {
+    version: SITE_STATE_VERSION,
+    ...readRawObjectQuiet(file),
+    cms_site: {
+      id,
+      label: String((site && site.label) || ''),
+      saved_at: new Date(now).toISOString(),
+    },
+  };
+
+  const tmp = `${file}.tmp-${process.pid}`;
+  const fd = fs.openSync(tmp, 'w', 0o600);
+  try {
+    fs.writeFileSync(fd, JSON.stringify(payload, null, 2) + '\n', 'utf8');
+  } finally {
+    fs.closeSync(fd);
+  }
+  fs.renameSync(tmp, file);
+  return payload.cms_site;
+}
+
+/**
+ * 取消选中（`wkgeo site use --clear`）。
+ *
+ * @returns {boolean} 之前有没有选中过（用来决定提示文案）
+ */
+export function clearSiteState(file) {
+  const raw = readRawObjectQuiet(file);
+  const had = Boolean(raw.cms_site && raw.cms_site.id);
+  delete raw.cms_site;
+  const dir = path.dirname(file);
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+  const tmp = `${file}.tmp-${process.pid}`;
+  const fd = fs.openSync(tmp, 'w', 0o600);
+  try {
+    fs.writeFileSync(fd, JSON.stringify({ version: SITE_STATE_VERSION, ...raw }, null, 2) + '\n', 'utf8');
+  } finally {
+    fs.closeSync(fd);
+  }
+  fs.renameSync(tmp, file);
+  return had;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wkgeo-cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "云站平台官方命令行客户端：授权登录一次，之后建站 / 下单 / 钱包支付 / 查余额都不用再登录（OAuth 授权码 + PKCE，公共客户端，零第三方依赖）",
   "keywords": [
     "wkgeo",