refactor(calculate-version): 將版本計算邏輯由 bash 改寫為 Node.js 並依功能分檔
保留 entrypoint.sh 作為容器進入點,改為啟動 app/ 下的 Node.js 程式; 依功能拆分為 logger/config/version/releases/output/index,並更新 Dockerfile 改用 node:lts-alpine。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
4983a72524
commit
bd6b6017ab
@@ -0,0 +1,64 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 判斷環境變數值是否視為「未設定」。
|
||||
*
|
||||
* 下列任一情況皆視為未設定:undefined、null、空字串、字面字串 "null"。
|
||||
*
|
||||
* @param {*} value - 欲檢查的值(通常為環境變數字串)。
|
||||
* @returns {boolean} 視為未設定時回傳 true,否則回傳 false。
|
||||
*/
|
||||
function isUnset(value) {
|
||||
return value === undefined || value === null || value === '' || value === 'null';
|
||||
}
|
||||
|
||||
/**
|
||||
* 驗證必填環境變數;未設定時拋出錯誤。
|
||||
*
|
||||
* @param {string} name - 環境變數名稱,用於組出錯誤訊息。
|
||||
* @param {*} value - 環境變數的值。
|
||||
* @returns {*} 驗證通過後原樣回傳的 value。
|
||||
* @throws {Error} 當 value 被視為未設定(undefined/null/空字串/"null")時拋出,訊息為 `${name} 未設定`。
|
||||
*/
|
||||
function requireEnv(name, value) {
|
||||
if (isUnset(value)) {
|
||||
throw new Error(`${name} 未設定`);
|
||||
}
|
||||
return value;
|
||||
}
|
||||
|
||||
/**
|
||||
* 將 beta 旗標正規化為布林值。
|
||||
*
|
||||
* 未設定時預設為 false;僅當值嚴格等於字面字串 "true" 時回傳 true。
|
||||
*
|
||||
* @param {*} value - beta 旗標環境變數的值。
|
||||
* @returns {boolean} 啟用 beta 時回傳 true,否則回傳 false。
|
||||
*/
|
||||
function normalizeBetaFlag(value) {
|
||||
if (isUnset(value)) {
|
||||
return false;
|
||||
}
|
||||
return value === 'true';
|
||||
}
|
||||
|
||||
/**
|
||||
* 從環境變數載入並驗證執行所需的設定。
|
||||
*
|
||||
* GITEA_SERVER_URL 與 GITEA_REPOSITORY 為必填,未設定時會拋出錯誤;
|
||||
* GITEA_TOKEN 為非必填,未設定時為 null;IS_BETA 會被正規化為布林值。
|
||||
*
|
||||
* @param {Object} [env=process.env] - 環境變數來源物件,預設為 process.env。
|
||||
* @returns {{ serverUrl: string, repository: string, token: (string|null), isBeta: boolean }} 已驗證的設定物件。
|
||||
* @throws {Error} 當 GITEA_SERVER_URL 或 GITEA_REPOSITORY 未設定時拋出。
|
||||
*/
|
||||
function loadConfig(env = process.env) {
|
||||
const serverUrl = requireEnv('GITEA_SERVER_URL', env.GITEA_SERVER_URL);
|
||||
const repository = requireEnv('GITEA_REPOSITORY', env.GITEA_REPOSITORY);
|
||||
const token = isUnset(env.GITEA_TOKEN) ? null : env.GITEA_TOKEN;
|
||||
const isBeta = normalizeBetaFlag(env.IS_BETA);
|
||||
|
||||
return { serverUrl, repository, token, isBeta };
|
||||
}
|
||||
|
||||
module.exports = { isUnset, requireEnv, normalizeBetaFlag, loadConfig };
|
||||
Reference in New Issue
Block a user