@wport/cli 0.9.0 → 0.9.1-dev.0

package/README.md

@@ -16,6 +16,16 @@ npm install -g @wport/cli
 
 Requires Node.js >= 18.17.
 
+### dev channel(內部測試用)
+
+`@wport/cli@dev` 是預設連 dev 後端(`https://developers.wport.me/v2`)的建置,供內部測試未上 prod 的後端改動:
+
+    npm i -g @wport/cli@dev     # wport → dev 後端
+    wport login                 # 直接對 dev 後端做 device flow
+    npm i -g @wport/cli@latest  # 換回 prod 版
+
+dev 版憑證獨立存於 `credentials-dev.json`,與 prod 版的 `credentials.json` 互不干擾;`wport doctor` 會印出目前 channel。base URL 仍可用 `--api` / `WPORT_API_BASE` 覆寫。
+
 ## Quick start
 
 ```bash
@@ -314,6 +324,19 @@ Three codegen variants — pick whichever matches your setup:
 
 The `:prod` / `:remote` variants go through `scripts/gen-from-remote.cjs`, which filters the upstream spec down to the endpoints this CLI uses (it ignores unrelated `$ref` breakage elsewhere in the spec). When the CLI starts using a new endpoint, add it to `KEEP_PATHS` in that script.
 
+#### 發 dev channel 到 npm
+
+    npm version prerelease --preid=dev --no-git-tag-version   # 0.9.0 → 0.9.1-dev.0(prerelease 會先進 patch)
+    npm run build:dev                                         # 選用:發布前先在本地確認 dev build 行為正常
+    # 發布必須帶 WPORT_BUILD_CHANNEL=dev:否則 npm publish 的 prepublishOnly hook 會跑 `npm run build`(prod),
+    # 把 dist 覆寫回 prod 產物,結果 @wport/cli@dev 底下發成 prod build(靜默、不報錯)。
+    WPORT_BUILD_CHANNEL=dev npm publish --tag dev --otp <code> # 必須顯式帶 --tag dev
+    npm view @wport/cli dist-tags                             # 斷言 latest 未被動到
+
+⚠️ npm 預設 tag 是 `latest`,即使版號是 prerelease;漏掉 `--tag dev` 會把 `latest` 指到 dev 版,污染所有 `npm i @wport/cli`。發布後務必用 `npm view dist-tags` 確認 `latest` 沒變。
+
+⚠️ `package.json` 的 `prepublishOnly` 會在 `npm publish` 時自動重跑 `npm run build`(prod build,無 dev channel),覆寫掉上一步 `build:dev` 產出的 dist。真正決定 channel 的是 publish 指令本身的 `WPORT_BUILD_CHANNEL=dev` 前綴 —— 該 env 會被 npm 傳進 prepublishOnly 的子行程,讓重跑的 `npm run build` 也讀到 dev channel。漏掉這個前綴,`@wport/cli@dev` 就會靜默發成連 `api.wport.me` 的 prod build。
+
 ## Support
 
 This CLI is in pre-release. Bug reports and feature requests are best-effort and handled directly by the maintainer.

package/dist/index.js

@@ -179,7 +179,7 @@ function isTimeoutAbort(err) {
   return false;
 }
 function buildUserAgent() {
-  return `wport-cli/${"0.9.0"} (node ${process.version}; ${process.platform})`;
+  return `wport-cli/${"0.9.1-dev.0"} (node ${process.version}; ${process.platform})`;
 }
 function unwrapDataResponse(body) {
   if (body && typeof body === "object" && "success" in body && "data" in body) {
@@ -366,8 +366,26 @@ function validateAndCoerce(key, value) {
   }
 }
 
+// src/lib/channel.ts
+var CHANNEL_BASE_URL = {
+  prod: "https://api.wport.me",
+  dev: "https://developers.wport.me/v2"
+};
+function currentChannel() {
+  return true ? "dev" : "prod";
+}
+function channelBaseUrl(channel) {
+  return CHANNEL_BASE_URL[channel] ?? CHANNEL_BASE_URL.prod;
+}
+function channelBanner() {
+  const channel = currentChannel();
+  if (channel === "prod") return null;
+  return `[${channel}] targeting the dev backend
+`;
+}
+
 // src/lib/global-opts.ts
-var DEFAULT_BASE_URL = "https://api.wport.me";
+var DEFAULT_BASE_URL = channelBaseUrl(currentChannel());
 var API_BASE_ENV_VAR = "WPORT_API_BASE";
 var DEFAULT_LOCALE = "zh-TW";
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -981,7 +999,8 @@ var KEY_PREFIX = "wpk_live_";
 var KEY_MIN_LENGTH = KEY_PREFIX.length + 32;
 var paths2 = (0, import_env_paths2.default)("wport", { suffix: "" });
 function getCredentialsPath() {
-  return (0, import_node_path2.join)(paths2.config, "credentials.json");
+  const fileName = currentChannel() === "dev" ? "credentials-dev.json" : "credentials.json";
+  return (0, import_node_path2.join)(paths2.config, fileName);
 }
 function isValidKeyFormat(key) {
   return key.startsWith(KEY_PREFIX) && key.length >= KEY_MIN_LENGTH && !/\s/.test(key);
@@ -1253,11 +1272,12 @@ function registerDoctorCommand(program2) {
 }
 async function runDoctor(ctx) {
   const line = (s = "") => process.stdout.write(s + "\n");
-  line(`wport-cli ${"0.9.0"}`);
+  line(`wport-cli ${"0.9.1-dev.0"}`);
   line(`  bundled schema fingerprint: ${"839e8a891dfb"}`);
   line("");
   line("Resolved configuration:");
   line(`  API base URL: ${ctx.baseUrl}`);
+  line(`  channel:      ${currentChannel()}`);
   line(`  locale:       ${ctx.locale}`);
   line(`  timeout:      ${ctx.timeoutMs}ms`);
   const cfgPath = getConfigPath();
@@ -1427,6 +1447,8 @@ function warnIfRateLimitLow(headers) {
 
 // src/commands/enterprise/login.ts
 async function performLogin(ctx, key) {
+  const banner = channelBanner();
+  if (banner) process.stderr.write(banner);
   if (!isValidKeyFormat(key)) {
     throw new CliError(
       `That does not look like a valid ${KEY_PREFIX} key. Nothing was saved.`,
@@ -2744,6 +2766,8 @@ function describeIdentity(displayName, email) {
   return "this device";
 }
 async function performLogin2(ctx, flags, deps = {}) {
+  const banner = channelBanner();
+  if (banner) process.stderr.write(banner);
   const openBrowser = deps.openBrowser ?? openInBrowser;
   const hostnameFn = deps.hostname ?? import_node_os.hostname;
   if (!flags.force) {
@@ -4706,7 +4730,7 @@ function registerPersonalCommand(program2) {
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("wport").description("wport CLI \u2014 terminal interface to the W101 Talent Search Hub public API").version("0.9.0", "-v, --version", "output the CLI version").option("--lang <locale>", "Accept-Language locale: zh-TW | en-US | vi-VN | th-TH | id-ID").option("--api <url>", "override API base URL").option("--output <fmt>", "output format: table | json").option("--no-color", "disable color output").option("--timeout <ms>", "HTTP timeout in milliseconds", (v) => Number(v));
+program.name("wport").description("wport CLI \u2014 terminal interface to the W101 Talent Search Hub public API").version("0.9.1-dev.0", "-v, --version", "output the CLI version").option("--lang <locale>", "Accept-Language locale: zh-TW | en-US | vi-VN | th-TH | id-ID").option("--api <url>", "override API base URL").option("--output <fmt>", "output format: table | json").option("--no-color", "disable color output").option("--timeout <ms>", "HTTP timeout in milliseconds", (v) => Number(v));
 registerJobsCommand(program);
 registerConfigCommand(program);
 registerDoctorCommand(program);