@plaud-ai/cli 0.1.2 → 0.1.4

package/dist/index.js

@@ -2,15 +2,21 @@
 
 // src/index.ts
 import "dotenv/config";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/commands/login.ts
 import { Command } from "commander";
 import { createServer } from "http";
 import open from "open";
-import chalk from "chalk";
+import chalk2 from "chalk";
 import ora from "ora";
 
+// src/config.ts
+import { readFileSync, existsSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+import { parse } from "yaml";
+
 // ../shared/dist/oauth.js
 import { randomBytes, createHash } from "crypto";
 
@@ -21,9 +27,9 @@ import { homedir } from "os";
 var TokenStore = class {
   configDir;
   tokenPath;
-  constructor() {
+  constructor(filename = "tokens.json") {
     this.configDir = join(homedir(), ".plaud");
-    this.tokenPath = join(this.configDir, "tokens.json");
+    this.tokenPath = join(this.configDir, filename);
   }
   async save(tokenSet) {
     await mkdir(this.configDir, { recursive: true });
@@ -63,7 +69,7 @@ var OAuth = class {
   refreshUrl;
   constructor(config) {
     this.config = config;
-    this.tokenStore = new TokenStore();
+    this.tokenStore = new TokenStore(config.tokenFile);
     this.authorizationUrl = config.authorizationUrl ?? DEFAULT_AUTHORIZATION_URL;
     this.tokenUrl = config.tokenUrl ?? DEFAULT_TOKEN_URL;
     this.refreshUrl = config.refreshUrl ?? DEFAULT_REFRESH_URL;
@@ -233,20 +239,30 @@ var PlaudClient = class {
 };
 
 // src/config.ts
+function loadCliConfig() {
+  const configPath = join2(homedir2(), ".plaud", "cli.yaml");
+  if (!existsSync(configPath)) return {};
+  try {
+    return parse(readFileSync(configPath, "utf8")) ?? {};
+  } catch {
+    return {};
+  }
+}
 function buildExtraHeaders() {
   const headers = {};
   if (process.env.PLAUD_ENV) headers["x-pld-env"] = process.env.PLAUD_ENV;
   if (process.env.PLAUD_REGION) headers["x-pld-region"] = process.env.PLAUD_REGION;
   return headers;
 }
+var fileConfig = loadCliConfig();
 var CONFIG = {
-  clientId: process.env.PLAUD_CLIENT_ID ?? "client_f9e0b214-c11f-434b-8b95-c4497d1feb81",
+  clientId: process.env.PLAUD_CLI_CLIENT_ID ?? process.env.PLAUD_CLIENT_ID ?? "client_f9e0b214-c11f-434b-8b95-c4497d1feb81",
   clientSecret: process.env.PLAUD_CLIENT_SECRET ?? "",
   redirectUri: "http://localhost:8199/auth/callback",
-  apiBase: process.env.PLAUD_API_BASE,
-  authorizationUrl: process.env.PLAUD_AUTH_URL,
-  tokenUrl: process.env.PLAUD_TOKEN_URL,
-  refreshUrl: process.env.PLAUD_REFRESH_URL,
+  apiBase: process.env.PLAUD_API_BASE ?? fileConfig.api_base,
+  authorizationUrl: process.env.PLAUD_AUTH_URL ?? fileConfig.auth_url,
+  tokenUrl: process.env.PLAUD_TOKEN_URL ?? fileConfig.token_url,
+  refreshUrl: process.env.PLAUD_REFRESH_URL ?? fileConfig.refresh_url,
   extraHeaders: buildExtraHeaders()
 };
 var client = null;
@@ -257,6 +273,38 @@ function getClient() {
   return client;
 }
 
+// src/exit-codes.ts
+var ExitCode = {
+  OK: 0,
+  ERROR: 1,
+  // 参数错误、未知异常
+  AUTH_FAILED: 2,
+  // Token 无效或过期（HTTP 401）
+  UNREACHABLE: 3,
+  // 后端服务不可达（网络错误）
+  TIMEOUT: 4
+  // 请求超时
+};
+
+// src/error.ts
+import chalk from "chalk";
+function printError(code, message, detail) {
+  console.error(chalk.red(`\u2717 [${code}] ${message}`));
+  if (detail) console.error(chalk.gray(String(detail)));
+}
+function isAuthError(err) {
+  if (!(err instanceof Error)) return false;
+  return err.message.includes("Not authenticated") || err.message.includes("401");
+}
+function isNetworkError(err) {
+  if (!(err instanceof Error)) return false;
+  return err instanceof TypeError || err.message.includes("ECONNREFUSED") || err.message.includes("ENOTFOUND") || err.message.includes("fetch failed");
+}
+function isTimeoutError(err) {
+  if (!(err instanceof Error)) return false;
+  return err.name === "AbortError" || err.message.toLowerCase().includes("timeout");
+}
+
 // src/commands/login.ts
 var CORS_HEADERS = {
   "Access-Control-Allow-Origin": "*",
@@ -268,7 +316,7 @@ var loginCommand = new Command("login").description("Authenticate with Plaud via
   try {
     const token = await client2.auth.getAccessToken();
     if (token) {
-      console.log(chalk.yellow("Already logged in. Run `plaud logout` first to switch accounts."));
+      console.log(chalk2.yellow("Already logged in. Run `plaud logout` first to switch accounts."));
       return;
     }
   } catch {
@@ -292,8 +340,9 @@ var loginCommand = new Command("login").description("Authenticate with Plaud via
     if (!code) {
       res.writeHead(400, CORS_HEADERS);
       res.end("Invalid callback: missing code");
-      spinner.fail("Authentication failed: missing authorization code");
-      server.close();
+      spinner.stop();
+      printError("AUTH_FAILED", "Authentication failed: missing authorization code");
+      server.close(() => process.exit(ExitCode.AUTH_FAILED));
       return;
     }
     try {
@@ -304,14 +353,15 @@ var loginCommand = new Command("login").description("Authenticate with Plaud via
     } catch (err) {
       res.writeHead(500, CORS_HEADERS);
       res.end("Token exchange failed");
-      spinner.fail(`Authentication failed: ${err}`);
+      spinner.stop();
+      printError("AUTH_FAILED", "Authentication failed.", err);
     } finally {
       server.closeAllConnections();
       server.close(() => process.exit(0));
     }
   });
   server.listen(8199, () => {
-    console.log(chalk.blue(`
+    console.log(chalk2.blue(`
 Opening browser for authentication...
 `));
     open(url);
@@ -320,12 +370,12 @@ Opening browser for authentication...
 
 // src/commands/logout.ts
 import { Command as Command2 } from "commander";
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 var logoutCommand = new Command2("logout").description("Log out and revoke authorization").action(async () => {
   const client2 = getClient();
   const token = await client2.auth.getAccessToken();
   if (!token) {
-    console.log(chalk2.yellow("Not logged in."));
+    console.log(chalk3.yellow("Not logged in."));
     return;
   }
   try {
@@ -333,12 +383,12 @@ var logoutCommand = new Command2("logout").description("Log out and revoke autho
   } catch {
   }
   await client2.auth.logout();
-  console.log(chalk2.green("Logged out and revoked authorization."));
+  console.log(chalk3.green("Logged out and revoked authorization."));
 });
 
 // src/commands/me.ts
 import { Command as Command3 } from "commander";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 import ora2 from "ora";
 var meCommand = new Command3("me").description("Show current authenticated user info").action(async () => {
   const client2 = getClient();
@@ -346,58 +396,82 @@ var meCommand = new Command3("me").description("Show current authenticated user
   try {
     const user = await client2.getCurrentUser();
     spinner.stop();
-    console.log(chalk3.bold("\nUser Info:\n"));
+    console.log(chalk4.bold("\nUser Info:\n"));
     for (const [key, value] of Object.entries(user)) {
-      console.log(`  ${chalk3.cyan(key)}: ${value}`);
+      console.log(`  ${chalk4.cyan(key)}: ${value}`);
     }
     console.log();
   } catch (err) {
-    spinner.fail(`Failed to fetch user info: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    printError("FETCH_FAILED", "Failed to fetch user info.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
 // src/commands/list-files.ts
 import { Command as Command4 } from "commander";
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import ora3 from "ora";
 var listFilesCommand = new Command4("files").description("List your Plaud recordings").option("-p, --page <number>", "Page number", "1").option("-s, --page-size <number>", "Page size", "20").action(async (opts) => {
   const page = parseInt(opts.page);
   const pageSize = parseInt(opts.pageSize);
   if (isNaN(page) || page < 1 || page > 1e3) {
-    console.error(chalk4.red("Error: --page must be a number between 1 and 1000"));
-    process.exit(1);
+    printError("INVALID_ARGS", "--page must be a number between 1 and 1000");
+    process.exit(ExitCode.ERROR);
   }
   if (isNaN(pageSize) || pageSize < 10 || pageSize > 100) {
-    console.error(chalk4.red("Error: --page-size must be a number between 10 and 100"));
-    process.exit(1);
+    printError("INVALID_ARGS", "--page-size must be a number between 10 and 100");
+    process.exit(ExitCode.ERROR);
   }
   const client2 = getClient();
   const spinner = ora3("Fetching files...").start();
   try {
     const result = await client2.listFiles(page, pageSize);
     spinner.stop();
-    console.log(chalk4.bold(`
+    console.log(chalk5.bold(`
 Files on this page: ${result.data.length}
 `));
     for (const file of result.data) {
       const date = new Date(file.created_at).toLocaleDateString();
       const duration = file.duration ? `${Math.round(file.duration / 60)}min` : "";
-      console.log(`  ${chalk4.cyan(file.id)}  ${file.name}  ${chalk4.gray(date)}  ${chalk4.gray(duration)}`);
+      console.log(`  ${chalk5.cyan(file.id)}  ${file.name}  ${chalk5.gray(date)}  ${chalk5.gray(duration)}`);
     }
-    console.log(
-      chalk4.gray(`
-Page ${result.page}`)
-    );
+    console.log(chalk5.gray(`
+Page ${result.page}`));
   } catch (err) {
-    spinner.fail(`Failed to fetch files: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    printError("FETCH_FAILED", "Failed to fetch files.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
 // src/commands/get-file.ts
 import { Command as Command5 } from "commander";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import ora4 from "ora";
 function formatDuration(ms) {
   const totalSeconds = Math.floor(ms / 1e3);
@@ -415,26 +489,43 @@ var getFileCommand = new Command5("file").description("Get details of a specific
     const noteList = file.note_list ?? [];
     const hasTranscript = sourceList.some((s) => s.data_type === "transaction");
     const hasSummary = noteList.some((n) => n.data_type === "auto_sum_note");
-    console.log(chalk5.bold("\nFile Details:\n"));
-    console.log(`  ${chalk5.cyan("id")}:           ${file.id}`);
-    console.log(`  ${chalk5.cyan("name")}:         ${file.name}`);
-    console.log(`  ${chalk5.cyan("created_at")}:   ${file.created_at}`);
-    console.log(`  ${chalk5.cyan("start_at")}:     ${file.start_at ?? "-"}`);
-    console.log(`  ${chalk5.cyan("duration")}:     ${file.duration ? formatDuration(file.duration) : "-"}`);
-    console.log(`  ${chalk5.cyan("serial_number")}: ${file.serial_number ?? "-"}`);
-    console.log(`  ${chalk5.cyan("audio")}:        ${file.presigned_url ? chalk5.green("available") : chalk5.gray("unavailable")}`);
-    console.log(`  ${chalk5.cyan("transcript")}:   ${hasTranscript ? chalk5.green("available") : chalk5.gray("unavailable")}`);
-    console.log(`  ${chalk5.cyan("summary")}:      ${hasSummary ? chalk5.green("available") : chalk5.gray("unavailable")}`);
+    console.log(chalk6.bold("\nFile Details:\n"));
+    console.log(`  ${chalk6.cyan("id")}:           ${file.id}`);
+    console.log(`  ${chalk6.cyan("name")}:         ${file.name}`);
+    console.log(`  ${chalk6.cyan("created_at")}:   ${file.created_at}`);
+    console.log(`  ${chalk6.cyan("start_at")}:     ${file.start_at ?? "-"}`);
+    console.log(`  ${chalk6.cyan("duration")}:     ${file.duration ? formatDuration(file.duration) : "-"}`);
+    console.log(`  ${chalk6.cyan("serial_number")}: ${file.serial_number ?? "-"}`);
+    console.log(`  ${chalk6.cyan("audio")}:        ${file.presigned_url ? chalk6.green("available") : chalk6.gray("unavailable")}`);
+    console.log(`  ${chalk6.cyan("transcript")}:   ${hasTranscript ? chalk6.green("available") : chalk6.gray("unavailable")}`);
+    console.log(`  ${chalk6.cyan("summary")}:      ${hasSummary ? chalk6.green("available") : chalk6.gray("unavailable")}`);
     console.log();
   } catch (err) {
-    spinner.fail(`Failed to fetch file: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    if (err instanceof Error && err.message.includes("404")) {
+      printError("NOT_FOUND", `File not found: ${fileId}`);
+      process.exit(ExitCode.ERROR);
+    }
+    printError("FETCH_FAILED", "Failed to fetch file.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
 // src/commands/audio.ts
 import { Command as Command6 } from "commander";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import ora5 from "ora";
 var audioCommand = new Command6("audio").description("Get the audio download URL for a Plaud recording").argument("<file_id>", "The file ID to retrieve audio for").action(async (fileId) => {
   const client2 = getClient();
@@ -443,22 +534,35 @@ var audioCommand = new Command6("audio").description("Get the audio download URL
     const file = await client2.getFile(fileId);
     spinner.stop();
     if (!file.presigned_url) {
-      console.log(chalk6.yellow("Audio not available for this recording."));
+      console.log(chalk7.yellow("Audio not available for this recording."));
       return;
     }
-    console.log(chalk6.bold("\nAudio Download URL:\n"));
+    console.log(chalk7.bold("\nAudio Download URL:\n"));
     console.log(file.presigned_url);
-    console.log(chalk6.gray("\nNote: This URL expires in 24 hours."));
+    console.log(chalk7.gray("\nNote: This URL expires in 24 hours."));
     console.log();
   } catch (err) {
-    spinner.fail(`Failed to fetch audio URL: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    printError("FETCH_FAILED", "Failed to fetch audio URL.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
 // src/commands/transcript.ts
 import { Command as Command7 } from "commander";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 import ora6 from "ora";
 import { writeFile as writeFile2 } from "fs/promises";
 function formatTime(ms) {
@@ -476,7 +580,7 @@ var transcriptCommand = new Command7("transcript").description("Get the transcri
     const sourceList = file.source_list ?? [];
     const source = sourceList.find((s) => s.data_type === "transaction");
     if (!source) {
-      console.log(chalk7.yellow("Transcript not available for this recording."));
+      console.log(chalk8.yellow("Transcript not available for this recording."));
       return;
     }
     const segments = JSON.parse(source.data_content);
@@ -488,23 +592,36 @@ var transcriptCommand = new Command7("transcript").description("Get the transcri
     const output = lines.join("\n");
     if (opts.output) {
       await writeFile2(opts.output, output, "utf-8");
-      console.log(chalk7.green(`Transcript saved to ${opts.output}`));
+      console.log(chalk8.green(`Transcript saved to ${opts.output}`));
     } else {
-      console.log(chalk7.bold(`
+      console.log(chalk8.bold(`
 Transcript: ${file.name}
 `));
       console.log(output);
       console.log();
     }
   } catch (err) {
-    spinner.fail(`Failed to fetch transcript: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    printError("FETCH_FAILED", "Failed to fetch transcript.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
 // src/commands/summary.ts
 import { Command as Command8 } from "commander";
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 import ora7 from "ora";
 import { writeFile as writeFile3 } from "fs/promises";
 var summaryCommand = new Command8("summary").description("Get the AI summary for a Plaud recording").argument("<file_id>", "The file ID to retrieve summary for").option("-o, --output <file>", "Save summary to a file").action(async (fileId, opts) => {
@@ -516,29 +633,50 @@ var summaryCommand = new Command8("summary").description("Get the AI summary for
     const noteList = file.note_list ?? [];
     const note = noteList.find((n) => n.data_type === "auto_sum_note");
     if (!note || !note.data_content) {
-      console.log(chalk8.yellow("Summary not available for this recording."));
+      console.log(chalk9.yellow("Summary not available for this recording."));
       return;
     }
     const content = note.data_content;
     if (opts.output) {
       await writeFile3(opts.output, content, "utf-8");
-      console.log(chalk8.green(`Summary saved to ${opts.output}`));
+      console.log(chalk9.green(`Summary saved to ${opts.output}`));
     } else {
-      console.log(chalk8.bold(`
+      console.log(chalk9.bold(`
 Summary: ${file.name}
 `));
       console.log(content);
       console.log();
     }
   } catch (err) {
-    spinner.fail(`Failed to fetch summary: ${err}`);
-    process.exit(1);
+    spinner.stop();
+    if (isAuthError(err)) {
+      printError("AUTH_FAILED", "Token invalid or expired. Run `plaud login`.");
+      process.exit(ExitCode.AUTH_FAILED);
+    }
+    if (isNetworkError(err)) {
+      printError("UNREACHABLE", "Cannot reach Plaud servers. Check your network.", err);
+      process.exit(ExitCode.UNREACHABLE);
+    }
+    if (isTimeoutError(err)) {
+      printError("TIMEOUT", "Request timed out.");
+      process.exit(ExitCode.TIMEOUT);
+    }
+    printError("FETCH_FAILED", "Failed to fetch summary.", err);
+    process.exit(ExitCode.ERROR);
   }
 });
 
+// src/commands/version.ts
+import { Command as Command9 } from "commander";
+var versionCommand = new Command9("version").description("Show CLI version information").action(() => {
+  console.log(`plaud ${"0.1.4"}`);
+  if ("8ad7434") console.log(`commit  ${"8ad7434"}`);
+  if ("2026-04-16T03:13:01.650Z") console.log(`built   ${"2026-04-16T03:13:01.650Z"}`);
+});
+
 // src/index.ts
-var program = new Command9();
-program.name("plaud").description("Plaud CLI - manage your Plaud recordings").version("0.1.0");
+var program = new Command10();
+program.name("plaud").description("Plaud CLI - manage your Plaud recordings");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(meCommand);
@@ -547,4 +685,5 @@ program.addCommand(getFileCommand);
 program.addCommand(audioCommand);
 program.addCommand(transcriptCommand);
 program.addCommand(summaryCommand);
+program.addCommand(versionCommand);
 program.parse();

package/package.json

@@ -1,26 +1,29 @@
 {
   "name": "@plaud-ai/cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "bin": {
     "plaud": "dist/index.js"
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist"
-  },
+  "files": [
+    "dist"
+  ],
   "dependencies": {
     "chalk": "^5.4.0",
     "commander": "^13.0.0",
     "dotenv": "^17.3.1",
     "open": "^10.2.0",
-    "ora": "^8.1.0"
+    "ora": "^8.1.0",
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
-    "@plaud-ai/shared": "workspace:*",
     "@types/node": "^25.5.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "@plaud-ai/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
   }
-}
+}