calculate-version/app/config.js

'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 };