persona-test-cli 0.1.0 → 0.1.3

package/README.md

@@ -1,8 +1,10 @@
 # persona-test-cli
 
-Ops CLI for a [persona-test](https://github.com/) deployment — admin and approved regular
-users can both use it. A regular user only ever sees/edits campaigns and personas they created
-themselves; admin sees and can edit everything.
+Ops CLI for a [persona-test](https://github.com/) deployment. By default it points at
+`https://persona.mixlab.top`; pass `--base-url <url>` (or set `PERSONA_TEST_CLI_URL`) to point
+it at a different deployment instead. Admin and approved regular users can both use it — a
+regular user only ever sees/edits campaigns and personas they created themselves; admin sees
+and can edit everything.
 
 ## Install
 
@@ -14,10 +16,10 @@ npm install -g persona-test-cli
 
 ```bash
 # New account: register, then wait for an admin to approve it at /admin/users
-persona-test-cli register https://your-app.example.com
+persona-test-cli register
 
 # Log in — opens a browser to approve the CLI (device-code flow), no password typed into the terminal
-persona-test-cli login https://your-app.example.com
+persona-test-cli login
 
 # See everything at once
 persona-test-cli examples
@@ -31,8 +33,8 @@ authorize page loads decides the scope of the issued token.
 
 | Command | Who | What |
 |---|---|---|
-| `register <baseUrl>` | anyone | Self-register (pending admin approval) |
-| `login <baseUrl>` | anyone | Device-code browser login |
+| `register` | anyone | Self-register (pending admin approval) |
+| `login` | anyone | Device-code browser login |
 | `logout` | anyone | Clear the stored token |
 | `whoami` | anyone | Show current identity + available commands |
 | `campaigns list/create/edit/link/stats` | anyone | Share links — scoped to your own unless admin |

package/dist/commands/login.js

@@ -2,24 +2,35 @@ import { publicRequest, apiRequest } from "../http.js";
 import { openBrowser } from "../browser.js";
 import { fail, EXIT_CODES } from "../errors.js";
 import { action, printJsonOrText } from "../output.js";
-import { normalizeBaseUrl, saveProfile } from "../config.js";
-export const LOGIN_EXAMPLES = `  persona-test-cli login https://your-app.example.com
-  persona-test-cli login https://your-app.example.com --no-open
-  persona-test-cli login https://your-app.example.com --token <已有的 token,跳过整个设备码流程>`;
+import { resolveBaseUrl, saveProfile } from "../config.js";
+export const LOGIN_EXAMPLES = `  persona-test-cli login
+  persona-test-cli login --no-open
+  persona-test-cli login --token <已有的 token,跳过整个设备码流程>
+
+不传地址默认连 https://persona.mixlab.top。要连别的部署,传 <baseUrl>/--base-url,
+或者设 PERSONA_TEST_CLI_URL 环境变量长期生效:
+  export PERSONA_TEST_CLI_URL=https://your-app.example.com   # 写进 ~/.zshrc 或 ~/.bashrc`;
 const POLL_INTERVAL_MS = 2000;
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 export function loginCommand(program) {
     program
-        .command("login <baseUrl>")
+        .command("login [baseUrl]")
         .description("设备码登录:自动打开浏览器授权,或用 --token 直接注入一个已有 token")
+        .option("--base-url <url>", "同下面的位置参数,两种写法都行")
         .option("--no-open", "不自动打开浏览器,只打印授权链接(无 GUI/沙盒环境用)")
         .option("--wait <seconds>", "轮询超时秒数", "300")
         .option("--token <token>", "跳过设备码流程,直接用这个 token(会先校验有效性)")
         .addHelpText("after", `\n示例:\n${LOGIN_EXAMPLES}`)
         .action(action(async (baseUrlArg, opts) => {
-        const baseUrl = normalizeBaseUrl(baseUrlArg);
+        const baseUrl = resolveBaseUrl(baseUrlArg ?? opts.baseUrl);
+        if (!baseUrl) {
+            fail("没有指定地址,加 <baseUrl> 或 --base-url,或设置 PERSONA_TEST_CLI_URL 环境变量", {
+                usage: LOGIN_EXAMPLES,
+                exitCode: EXIT_CODES.validation,
+            });
+        }
         if (opts.token) {
             const who = await apiRequest(baseUrl, opts.token, "GET", "/api/cli/whoami");
             const scope = who.scope;

package/dist/commands/register.js

@@ -2,18 +2,27 @@ import { publicRequest } from "../http.js";
 import { isInteractive, promptText, promptHidden } from "../prompt.js";
 import { fail, EXIT_CODES } from "../errors.js";
 import { action, printJsonOrText } from "../output.js";
-import { normalizeBaseUrl } from "../config.js";
-export const REGISTER_EXAMPLES = `  persona-test-cli register https://your-app.example.com
-  persona-test-cli register https://your-app.example.com --email me@example.com --password ******** --json`;
+import { resolveBaseUrl } from "../config.js";
+export const REGISTER_EXAMPLES = `  persona-test-cli register --email me@example.com --password ******** --json
+  persona-test-cli register --base-url https://your-app.example.com --email me@example.com --password ********
+
+不传地址默认注册到 https://persona.mixlab.top,见 \`login --help\` 了解怎么连别的部署。`;
 export function registerCommand(program) {
     program
-        .command("register <baseUrl>")
+        .command("register [baseUrl]")
         .description("自助注册一个普通用户账号(注册后需要 admin 在 /admin/users 审核通过才能登录)")
+        .option("--base-url <url>", "同位置参数,两种写法都行")
         .option("--email <email>", "邮箱(作为用户名)")
         .option("--password <password>", "密码(至少 8 位)")
         .addHelpText("after", `\n示例:\n${REGISTER_EXAMPLES}`)
         .action(action(async (baseUrlArg, opts) => {
-        const baseUrl = normalizeBaseUrl(baseUrlArg);
+        const baseUrl = resolveBaseUrl(baseUrlArg ?? opts.baseUrl);
+        if (!baseUrl) {
+            fail("没有指定地址,加 <baseUrl> 或 --base-url,或设置 PERSONA_TEST_CLI_URL 环境变量", {
+                usage: REGISTER_EXAMPLES,
+                exitCode: EXIT_CODES.validation,
+            });
+        }
         let email = opts.email;
         let password = opts.password;
         if (!email || !password) {

package/dist/config.js

@@ -37,13 +37,18 @@ export function clearProfile(baseUrl) {
 export function getProfile(baseUrl) {
     return readConfig().profiles[normalizeBaseUrl(baseUrl)];
 }
-/** Explicit --base-url wins; then PERSONA_TEST_CLI_URL; then whichever base URL was last logged into. */
+// This CLI ships pointed at one specific deployment by default — anyone
+// installing it without overriding this is assumed to be a persona-test
+// admin/user for that instance. Override with --base-url, PERSONA_TEST_CLI_URL,
+// or just log into a different one (that becomes the new last-used default).
+const DEFAULT_BASE_URL = "https://persona.mixlab.top";
+/** Explicit --base-url wins; then PERSONA_TEST_CLI_URL; then whichever base URL was last logged into; then the built-in default. */
 export function resolveBaseUrl(explicit) {
     if (explicit)
         return normalizeBaseUrl(explicit);
     if (process.env.PERSONA_TEST_CLI_URL)
         return normalizeBaseUrl(process.env.PERSONA_TEST_CLI_URL);
-    return readConfig().lastBaseUrl;
+    return readConfig().lastBaseUrl ?? DEFAULT_BASE_URL;
 }
 /** PERSONA_TEST_CLI_TOKEN always wins (agent-friendly: skip login entirely) — falls back to the stored profile. */
 export function resolveToken(baseUrl) {

package/dist/index.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 import { Command } from "commander";
 import { registerCommand } from "./commands/register.js";
 import { loginCommand } from "./commands/login.js";
@@ -9,13 +12,42 @@ import { personasCommand } from "./commands/personas.js";
 import { eventsCommand } from "./commands/events.js";
 import { usersCommand } from "./commands/users.js";
 import { examplesCommand } from "./commands/examples.js";
+import { jsonMode } from "./output.js";
+// Reads package.json's version whether running from source (cli/index.ts,
+// package.json next to it) or from the built dist/index.js (package.json one
+// directory up) — avoids a hardcoded version string drifting from package.json.
+function readVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const candidate of [join(here, "..", "package.json"), join(here, "package.json")]) {
+        try {
+            return JSON.parse(readFileSync(candidate, "utf8")).version;
+        }
+        catch {
+            continue;
+        }
+    }
+    return "0.0.0";
+}
+const version = readVersion();
 const program = new Command();
 program
     .name("persona-test-cli")
     .description("persona-test 运维 CLI —— admin 和已审核通过的普通用户都能用,普通用户只能看到/编辑自己创建的 campaigns/personas。\n" +
     "先跑一次 `persona-test-cli examples` 看全部子命令的可复制示例。")
+    .version(version, "-v, --version", "打印版本号")
     .option("--json", "所有命令输出纯 JSON(成功到 stdout,失败到 stderr),适合脚本/agent 调用")
     .configureHelp({ sortSubcommands: true });
+program
+    .command("version")
+    .description("打印版本号(等价于 -v/--version)")
+    .action(() => {
+    if (jsonMode) {
+        console.log(JSON.stringify({ version }));
+    }
+    else {
+        console.log(version);
+    }
+});
 registerCommand(program);
 loginCommand(program);
 logoutCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persona-test-cli",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "运维 CLI for persona-test — admin 和已审核通过的普通用户都能用；设备码浏览器授权登录，管理分享链接(campaigns)和画像(personas)，普通用户只能看到/编辑自己创建的。",
   "type": "module",
   "bin": {