calculate-version/app/output.js

'use strict';

const fs = require('node:fs');

/**
 * 將一行 `name=value` 附加寫入 GitHub/Gitea Action 的輸出檔。
 *
 * @param {string} name - 輸出變數名稱（output 的 key）。
 * @param {string} value - 輸出變數的值（output 的 value）。
 * @param {string} [file=process.env.GITHUB_OUTPUT] - 輸出檔路徑，預設取自環境變數 `GITHUB_OUTPUT`。
 * @throws {Error} 當輸出檔路徑為 falsy（例如 `GITHUB_OUTPUT` 未設定）時拋出，無法寫入輸出。
 * @returns {void}
 */
function writeOutput(name, value, file = process.env.GITHUB_OUTPUT) {
    if (!file) {
        throw new Error('GITHUB_OUTPUT 未設定，無法寫入輸出');
    }

    fs.appendFileSync(file, `${name}=${value}\n`);
}

module.exports = { writeOutput };