@zrhsh/wukong-cli 0.1.12 → 0.2.0

package/README.md

@@ -10,6 +10,8 @@ TypeScript CLI tool for Oceanet/NRP system with OAuth Device PKCE Flow authentic
 - 🐛 **Debug Mode** - Show HTTP requests and responses with `--debug` flag
 - 💾 **Secure Storage** - Platform native credential managers with file fallback
 - 🛠️ **HTTP Client** - Built-in HTTP client with automatic authentication
+- ⚙️ **Smart Configuration** - Built-in defaults with fallback to user configuration
+- 🔍 **Structured Errors** - Clear error messages with actionable fix suggestions
 
 ## Quick Start
 
@@ -80,6 +82,61 @@ set WUKONG_CLI_ENV=beta
 wukong-cli auth login
 ```
 
+## Configuration
+
+Wukong CLI uses intelligent configuration with built-in defaults:
+
+- **No Configuration Required**: CLI works out of the box with built-in environment defaults
+- **Custom Configuration**: Optional `wukong-cli.json` for custom endpoints
+- **Smart Fallback**: Uses built-in defaults when environments are not configured
+- **Clear Errors**: Structured error messages guide you to fix configuration issues
+
+### Configuration File Location
+
+```bash
+~/wukong-cli.json  # User home directory
+```
+
+### Initialize Configuration
+
+```bash
+wukong-cli init  # Creates or resets configuration file
+```
+
+### Example Configuration
+
+```json
+{
+  "defaultEnv": "prod",
+  "environments": {
+    "prod": {
+      "authBaseUrl": "https://portal.zrhsh.com",
+      "apiBaseUrl": "https://nrp.zrhsh.com",
+      "clientId": "wukong-cli-prod"
+    },
+    "dev": {
+      "authBaseUrl": "https://portal-dev.zrhsh.com",
+      "apiBaseUrl": "https://nrp-recode-dev.zrhsh.com",
+      "clientId": "wukong-cli-dev"
+    }
+  }
+}
+```
+
+### Configuration Errors
+
+If your configuration is incomplete, you'll see structured error messages:
+
+```
+[ERROR] Configuration Error
+
+Incomplete configuration for environment 'prod'
+Environment: prod
+Missing fields: apiBaseUrl, clientId
+
+Edit your wukong-cli.json or run 'wukong-cli init' to reset
+```
+
 ## Documentation
 
 ### Getting Started
@@ -109,7 +166,7 @@ wukong-cli auth login
 
 ## Project Information
 
-- **Version**: 0.1.6
+- **Version**: 0.1.12
 - **Package**: @zrhsh/wukong-cli
 - **Organization**: @zrhsh
 - **License**: MIT
@@ -189,4 +246,4 @@ See [Release Notes](docs/publishing/release-notes.md) for version history and ch
 
 ---
 
-**Current Version**: 0.1.6 | **Package**: @zrhsh/wukong-cli | **Organization**: @zrhsh
+**Current Version**: 0.1.12 | **Package**: @zrhsh/wukong-cli | **Organization**: @zrhsh

package/dist/cli.js

@@ -3,6 +3,12 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -88,6 +94,235 @@ var init_debug = __esm({
   }
 });
 
+// src/utils/version/cache.ts
+var VersionCache;
+var init_cache = __esm({
+  "src/utils/version/cache.ts"() {
+    "use strict";
+    init_esm_shims();
+    VersionCache = class {
+      lastCheckTime = 0;
+      cachedVersion = null;
+      checkInterval;
+      /**
+       * Constructor
+       * @param checkInterval - Check interval in milliseconds (default: 24 hours)
+       */
+      constructor(checkInterval = 24 * 60 * 60 * 1e3) {
+        this.checkInterval = checkInterval;
+      }
+      /**
+       * Check if a new version check should be performed
+       */
+      shouldCheck() {
+        const now = Date.now();
+        return now - this.lastCheckTime >= this.checkInterval;
+      }
+      /**
+       * Get cached version
+       */
+      get() {
+        return this.cachedVersion;
+      }
+      /**
+       * Set cached version with timestamp
+       */
+      set(version) {
+        this.cachedVersion = version;
+        this.lastCheckTime = Date.now();
+      }
+      /**
+       * Clear cache
+       */
+      clear() {
+        this.lastCheckTime = 0;
+        this.cachedVersion = null;
+      }
+      /**
+       * Get time since last check
+       */
+      getTimeSinceLastCheck() {
+        if (this.lastCheckTime === 0) {
+          return 0;
+        }
+        return Date.now() - this.lastCheckTime;
+      }
+    };
+  }
+});
+
+// src/utils/version/provider.ts
+var provider_exports = {};
+__export(provider_exports, {
+  NpmVersionProvider: () => NpmVersionProvider
+});
+var NpmVersionProvider;
+var init_provider = __esm({
+  "src/utils/version/provider.ts"() {
+    "use strict";
+    init_esm_shims();
+    NpmVersionProvider = class {
+      constructor(packageName, registryUrl) {
+        this.packageName = packageName;
+        this.registryUrl = registryUrl;
+        this.timeout = 5e3;
+      }
+      timeout;
+      /**
+       * Get latest version from npm
+       */
+      async getLatestVersion() {
+        try {
+          const controller = new AbortController();
+          const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+          const response = await fetch(`${this.registryUrl}/${this.packageName}`, {
+            signal: controller.signal
+          });
+          clearTimeout(timeoutId);
+          if (!response.ok) {
+            return null;
+          }
+          const data = await response.json();
+          return data["dist-tags"]?.latest || null;
+        } catch (error) {
+          return null;
+        }
+      }
+    };
+  }
+});
+
+// src/utils/version/checker.ts
+var checker_exports = {};
+__export(checker_exports, {
+  VersionChecker: () => VersionChecker
+});
+var VersionChecker;
+var init_checker = __esm({
+  "src/utils/version/checker.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_cache();
+    VersionChecker = class {
+      constructor(provider, currentVersion, cache) {
+        this.provider = provider;
+        this.currentVersion = currentVersion;
+        this.cache = cache || new VersionCache();
+      }
+      cache;
+      /**
+       * Compare two version strings
+       * Returns: 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+       */
+      compareVersions(v1, v2) {
+        const parts1 = v1.split(".").map(Number);
+        const parts2 = v2.split(".").map(Number);
+        for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+          const part1 = parts1[i] || 0;
+          const part2 = parts2[i] || 0;
+          if (part1 > part2) return 1;
+          if (part1 < part2) return -1;
+        }
+        return 0;
+      }
+      /**
+       * Check for update (cached or fresh)
+       */
+      async checkForUpdate() {
+        if (!this.cache.shouldCheck()) {
+          const cached = this.cache.get();
+          if (cached) {
+            return {
+              hasUpdate: this.compareVersions(cached, this.currentVersion) > 0,
+              currentVersion: this.currentVersion,
+              latestVersion: cached
+            };
+          }
+        }
+        const latestVersion = await this.provider.getLatestVersion();
+        if (!latestVersion) {
+          return {
+            hasUpdate: false,
+            currentVersion: this.currentVersion,
+            latestVersion: null
+          };
+        }
+        this.cache.set(latestVersion);
+        return {
+          hasUpdate: this.compareVersions(latestVersion, this.currentVersion) > 0,
+          currentVersion: this.currentVersion,
+          latestVersion
+        };
+      }
+      /**
+       * Check in background (for async execution)
+       */
+      async checkInBackground() {
+        try {
+          await this.checkForUpdate();
+        } catch (error) {
+        }
+      }
+      /**
+       * Clear cached data
+       */
+      clearCache() {
+        this.cache.clear();
+      }
+      /**
+       * Get current cache info
+       */
+      getCacheInfo() {
+        return {
+          lastCheckTime: this.cache.lastCheckTime,
+          cachedVersion: this.cache.cachedVersion
+        };
+      }
+    };
+  }
+});
+
+// src/config/errors/config-file-error.ts
+var ConfigFileError;
+var init_config_file_error = __esm({
+  "src/config/errors/config-file-error.ts"() {
+    "use strict";
+    init_esm_shims();
+    ConfigFileError = class extends Error {
+      constructor(type, message, environment, missingFields, fixSuggestion) {
+        super(message);
+        this.type = type;
+        this.environment = environment;
+        this.missingFields = missingFields;
+        this.fixSuggestion = fixSuggestion;
+        this.name = "ConfigFileError";
+      }
+      /**
+       * Format error message for user display
+       */
+      toUserMessage() {
+        let message = `
+${this.message}
+`;
+        if (this.environment) {
+          message += `Environment: ${this.environment}
+`;
+        }
+        if (this.missingFields && this.missingFields.length > 0) {
+          message += `Missing fields: ${this.missingFields.join(", ")}
+`;
+        }
+        if (this.fixSuggestion) {
+          message += `
+${this.fixSuggestion}
+`;
+        }
+        return message;
+      }
+    };
+  }
+});
+
 // src/constants/config.ts
 var API_ENDPOINTS, POLL_CONFIG;
 var init_config = __esm({
@@ -226,28 +461,38 @@ function loadConfig() {
 }
 function getMergedEnvironmentConfig(env) {
   const config = loadConfig();
-  if (!config.environments || !(env in config.environments)) {
-    throw new Error(
-      `Environment '${env}' not found in configuration. Please run 'wukong-cli init' to create a valid configuration file.`
+  const defaultEnvConfig = ENVIRONMENTS[env];
+  if (!defaultEnvConfig) {
+    throw new ConfigFileError(
+      "ENVIRONMENT_MISSING" /* ENVIRONMENT_MISSING */,
+      `Unknown environment: '${env}'`,
+      env,
+      void 0,
+      `Valid environments: ${Object.keys(ENVIRONMENTS).join(", ")}`
     );
   }
-  const envConfig = config.environments[env];
-  const requiredFields = ["authBaseUrl", "apiBaseUrl", "clientId"];
-  const missingFields = requiredFields.filter((field) => !(field in envConfig));
-  if (missingFields.length > 0) {
-    throw new Error(
-      `Missing required configuration fields for environment '${env}': ${missingFields.join(", ")}. Please run 'wukong-cli init' to create a valid configuration file.`
-    );
+  if (config.environments && env in config.environments) {
+    const envConfig = config.environments[env];
+    const requiredFields = ["authBaseUrl", "apiBaseUrl", "clientId"];
+    const missingFields = requiredFields.filter((field) => !(field in envConfig));
+    if (missingFields.length > 0) {
+      throw new ConfigFileError(
+        "REQUIRED_FIELD_MISSING" /* REQUIRED_FIELD_MISSING */,
+        `Incomplete configuration for environment '${env}'`,
+        env,
+        missingFields,
+        `Edit your wukong-cli.json or run 'wukong-cli init' to reset`
+      );
+    }
+    return {
+      name: env,
+      displayName: defaultEnvConfig.displayName,
+      authBaseUrl: envConfig.authBaseUrl,
+      apiBaseUrl: envConfig.apiBaseUrl,
+      clientId: envConfig.clientId
+    };
   }
-  const defaultConfig = ENVIRONMENTS[env];
-  const displayName = defaultConfig?.displayName || env;
-  return {
-    name: env,
-    displayName,
-    authBaseUrl: envConfig.authBaseUrl,
-    apiBaseUrl: envConfig.apiBaseUrl,
-    clientId: envConfig.clientId
-  };
+  return defaultEnvConfig;
 }
 function getAllEnvironments() {
   const config = loadConfig();
@@ -282,6 +527,7 @@ var init_config_loader = __esm({
     "use strict";
     init_esm_shims();
     init_environments();
+    init_config_file_error();
     CONFIG_FILENAMES = [
       "wukong-cli.json",
       ".wukong-cli.json",
@@ -499,7 +745,7 @@ var init_ora_ui_callbacks = __esm({
 });
 
 // src/core/auth/keytar-adapter.ts
-import { createRequire as createRequire2 } from "module";
+import { createRequire } from "module";
 function isKeytarAvailable() {
   return keytarModule !== null;
 }
@@ -521,15 +767,15 @@ async function deletePassword(service, account) {
   }
   return await keytarModule.deletePassword(service, account);
 }
-var require3, keytarModule;
+var require2, keytarModule;
 var init_keytar_adapter = __esm({
   "src/core/auth/keytar-adapter.ts"() {
     "use strict";
     init_esm_shims();
-    require3 = createRequire2(import.meta.url);
+    require2 = createRequire(import.meta.url);
     keytarModule = null;
     try {
-      keytarModule = require3("keytar");
+      keytarModule = require2("keytar");
     } catch (error) {
       keytarModule = null;
     }
@@ -717,91 +963,29 @@ init_esm_shims();
 init_debug();
 import { Command as Command4 } from "commander";
 
-// src/utils/version-check.ts
+// src/utils/version/index.ts
 init_esm_shims();
-import { createRequire } from "module";
-var require2 = createRequire(import.meta.url);
-var packageJson = require2("../package.json");
-var PACKAGE_NAME = "@zrhsh/wukong-cli";
-var NPM_REGISTRY_URL = "https://registry.npmjs.org";
-var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
-var lastCheckTime = 0;
-var cachedLatestVersion = null;
-function compareVersions(v1, v2) {
-  const parts1 = v1.split(".").map(Number);
-  const parts2 = v2.split(".").map(Number);
-  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-    const part1 = parts1[i] || 0;
-    const part2 = parts2[i] || 0;
-    if (part1 > part2) return 1;
-    if (part1 < part2) return -1;
-  }
-  return 0;
-}
-async function getLatestVersion() {
-  try {
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), 5e3);
-    const response = await fetch(`${NPM_REGISTRY_URL}/${PACKAGE_NAME}`, {
-      signal: controller.signal
-    });
-    clearTimeout(timeoutId);
-    const data = await response.json();
-    return data["dist-tags"]?.latest || null;
-  } catch (error) {
-    return null;
-  }
-}
-async function checkForUpdate() {
-  const now = Date.now();
-  const currentVersion = packageJson.version;
-  if (now - lastCheckTime < CHECK_INTERVAL && cachedLatestVersion) {
-    return {
-      hasUpdate: compareVersions(cachedLatestVersion, currentVersion) > 0,
-      currentVersion,
-      latestVersion: cachedLatestVersion
-    };
-  }
-  const latestVersion = await getLatestVersion();
-  if (!latestVersion) {
-    return {
-      hasUpdate: false,
-      currentVersion,
-      latestVersion: null
-    };
-  }
-  lastCheckTime = now;
-  cachedLatestVersion = latestVersion;
-  return {
-    hasUpdate: compareVersions(latestVersion, currentVersion) > 0,
-    currentVersion,
-    latestVersion
-  };
-}
-async function showUpdateNotification() {
-  const { hasUpdate, currentVersion, latestVersion } = await checkForUpdate();
-  if (!hasUpdate || !latestVersion) {
-    return;
-  }
-  console.log("");
-  console.log("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-  console.log("\u2551" + " ".repeat(58) + "\u2551");
-  console.log("\u2551" + "  \u{1F389} New version available!".padEnd(60) + "\u2551");
-  console.log("\u2551" + " ".repeat(58) + "\u2551");
-  console.log(`\u2551  Current: ${currentVersion.padEnd(10)}  Latest: ${latestVersion.padEnd(10)}  \u2551`);
-  console.log("\u2551" + " ".repeat(58) + "\u2551");
-  console.log("\u2551" + "  Update command:".padEnd(60) + "\u2551");
-  console.log(`\u2551  npm install -g ${PACKAGE_NAME}@latest`.padEnd(60) + "\u2551");
-  console.log("\u2551" + " ".repeat(58) + "\u2551");
-  console.log("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
-  console.log("");
-}
-async function checkAndUpdate(silent = false) {
-  if (!silent) {
-    await showUpdateNotification();
-  } else {
-    await checkForUpdate();
+init_cache();
+init_provider();
+init_checker();
+var versionCheckerInstance = null;
+function getVersionChecker() {
+  if (!versionCheckerInstance) {
+    const { createRequire: createRequire2 } = __require("module");
+    const nodeRequire = createRequire2(import.meta.url);
+    const packageJson = nodeRequire("../../package.json");
+    const { NpmVersionProvider: NpmVersionProvider2 } = (init_provider(), __toCommonJS(provider_exports));
+    const { VersionChecker: VersionChecker2 } = (init_checker(), __toCommonJS(checker_exports));
+    const provider = new NpmVersionProvider2(
+      "@zrhsh/wukong-cli",
+      "https://registry.npmjs.org"
+    );
+    versionCheckerInstance = new VersionChecker2(
+      provider,
+      packageJson.version
+    );
   }
+  return versionCheckerInstance;
 }
 
 // src/commands/auth.ts
@@ -826,6 +1010,9 @@ function printEnvironmentInfo(env, displayName) {
   }
 }
 
+// src/commands/auth.ts
+init_config_file_error();
+
 // src/core/auth/device-flow.ts
 init_esm_shims();
 init_oceanet();
@@ -1711,6 +1898,14 @@ authCommands.command("login").description("Login using Device Authorization Flow
     console.log(chalk5.dim("Next:"), chalk5.cyan("wukong-cli auth status"));
     console.log("");
   } catch (error) {
+    if (error instanceof ConfigFileError) {
+      console.log("");
+      console.log(chalk5.red(`[ERROR] Configuration Error`));
+      console.log("");
+      console.log(chalk5.red(error.toUserMessage()));
+      console.log("");
+      return;
+    }
     console.log("");
     console.log(chalk5.red(`[ERROR] ${error instanceof Error ? error.message : "Unknown error"}`));
     console.log("");
@@ -1739,8 +1934,8 @@ authCommands.command("refresh").description("Manually refresh access token").act
   const env = getCurrentEnvironment();
   const allEnvs = getAllEnvironments();
   const envConfig = allEnvs[env];
-  const config = getOceanetConfig();
   try {
+    const config = getOceanetConfig();
     const accessToken = await getAccessToken();
     if (!accessToken) {
       console.log("");
@@ -1765,6 +1960,14 @@ authCommands.command("refresh").description("Manually refresh access token").act
       throw error;
     }
   } catch (error) {
+    if (error instanceof ConfigFileError) {
+      console.log("");
+      console.log(chalk5.red(`[ERROR] Configuration Error`));
+      console.log("");
+      console.log(chalk5.red(error.toUserMessage()));
+      console.log("");
+      return;
+    }
     console.log("");
     console.log(chalk5.red(`[ERROR] ${error instanceof Error ? error.message : "Unknown error"}`));
     console.log("");
@@ -1780,8 +1983,8 @@ authCommands.command("status").description("Show authentication status").action(
   const allEnvs = getAllEnvironments();
   setCurrentEnvironment(env);
   const envConfig = allEnvs[env];
-  const config = getOceanetConfig();
   try {
+    const config = getOceanetConfig();
     const accessToken = await getAccessToken();
     if (!accessToken) {
       console.log(chalk5.yellow(`[ERROR] Not authenticated`));
@@ -1815,6 +2018,13 @@ authCommands.command("status").description("Show authentication status").action(
       console.log("");
     }
   } catch (error) {
+    if (error instanceof ConfigFileError) {
+      console.log(chalk5.red(`[ERROR] Configuration Error`));
+      console.log("");
+      console.log(chalk5.red(error.toUserMessage()));
+      console.log("");
+      return;
+    }
     console.log(chalk5.yellow(`\u2717 Not authenticated`));
     console.log("");
     printEnvironmentInfo(env, envConfig.displayName);
@@ -1830,6 +2040,7 @@ import ora4 from "ora";
 import chalk6 from "chalk";
 init_oceanet();
 init_debug();
+init_config_file_error();
 function fixGitBashPath(url) {
   if (url.includes(":") && !url.startsWith("http")) {
     const oceanetIndex = url.indexOf("/oceanet-");
@@ -1902,6 +2113,14 @@ async function executeRequest(method, url, options) {
     console.log(JSON.stringify(data, null, 2));
   } catch (error) {
     spinner.fail("Request failed");
+    if (error instanceof ConfigFileError) {
+      console.log("");
+      console.log(chalk6.red(`[ERROR] Configuration Error`));
+      console.log("");
+      console.log(chalk6.red(error.toUserMessage()));
+      console.log("");
+      process.exit(1);
+    }
     if (error instanceof Error) {
       console.error(chalk6.red(error.message));
     }
@@ -1980,7 +2199,7 @@ var initCommand = new Command3("init").description("Initialize configuration fil
 
 // src/cli.ts
 var program = new Command4();
-program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version("0.1.12").option("--debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
+program.name("wukong-cli").description("Wukong CLI - TypeScript implementation").version("0.2.0").option("--debug", "Enable debug mode (show HTTP requests)").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   if (options.debug === true) {
     setDebugMode(true, true);
@@ -1994,7 +2213,13 @@ program.addCommand(initCommand);
 if (process.argv.length === 2) {
   program.help();
 }
-checkAndUpdate().catch(() => {
-});
 program.parse();
+setImmediate(() => {
+  try {
+    const versionChecker = getVersionChecker();
+    versionChecker.checkInBackground().catch(() => {
+    });
+  } catch {
+  }
+});
 //# sourceMappingURL=cli.js.map