'use strict';

// 主分隔線與次分隔線寬度（沿用原 entrypoint.sh 的視覺樣式）
const LINE = '='.repeat(50);
const SUBLINE = '-'.repeat(50);

/**
 * 產生台灣時區（Asia/Taipei）的時間戳，格式固定為 `yyyy/MM/dd HH:mm:ss`。
 *
 * 供 log 訊息統一格式 `[{等級}][{時間}]: {訊息}` 的時間欄位使用。
 *
 * @returns {string} 台灣時區當下時間字串，例如 `2026/06/30 12:13:04`。
 */
function taipeiTimestamp() {
    const parts = new Intl.DateTimeFormat('zh-TW', {
        timeZone: 'Asia/Taipei',
        year: 'numeric',
        month: '2-digit',
        day: '2-digit',
        hour: '2-digit',
        minute: '2-digit',
        second: '2-digit',
        hour12: false,
    }).formatToParts(new Date());

    const get = (type) => parts.find((part) => part.type === type)?.value ?? '';
    // 部分執行環境會把 24 時制的午夜輸出為 "24"，統一正規化為 "00"
    const hour = get('hour') === '24' ? '00' : get('hour');

    return `${get('year')}/${get('month')}/${get('day')} ${hour}:${get('minute')}:${get('second')}`;
}

/**
 * 輸出帶標題的區塊段落至標準輸出，標題前後以分隔線包夾，
 * 用於在 log 中建立可視的段落區隔。
 *
 * 輸出格式為：換行 + 主分隔線（50 個 `=`）+ 標題 + 次分隔線（50 個 `-`）。
 * 此為結構性段落標題（非 INF/WRN/ERR 等級訊息），故不套用 `[{等級}][{時間}]` 前綴。
 *
 * @param {string} title - 區塊標題文字；會原樣輸出於兩條分隔線之間。
 * @returns {void}
 * @remarks 通常在進入一個處理階段前呼叫（例如「參數檢查」「取得舊版本」），
 *   用以在 CI/容器 log 中分隔各階段輸出，便於閱讀與定位。
 */
function section(title) {
    process.stdout.write(`\n${LINE}\n${title}\n${SUBLINE}\n`);
}

/**
 * 輸出一般資訊（INF）層級的 log 訊息至標準輸出。
 *
 * 訊息格式統一為 `[INF][{台灣時間}]: {訊息}`，時間使用台灣時區（Asia/Taipei），
 * 格式為 `yyyy/MM/dd HH:mm:ss`，並於結尾換行。
 *
 * @param {string} message - 要輸出的資訊內容。
 * @returns {void}
 * @remarks 用於回報正常流程進度（如設定值、URL、各頁取得筆數）；此調整僅變更輸出前綴格式，
 *   不改變訊息所反映的實際行為與內容。
 */
function info(message) {
    process.stdout.write(`[INF][${taipeiTimestamp()}]: ${message}\n`);
}

/**
 * 輸出錯誤（ERR）層級的 log 訊息至標準錯誤輸出（stderr）。
 *
 * 訊息格式統一為 `[ERR][{台灣時間}]: {訊息}`，時間使用台灣時區（Asia/Taipei），
 * 格式為 `yyyy/MM/dd HH:mm:ss`，並於結尾換行。
 *
 * 僅負責輸出，不終止行程；是否結束由呼叫端（進入點）決定，以利測試與錯誤復原。
 *
 * @param {string} message - 要輸出的錯誤描述內容。
 * @returns {void}
 * @remarks 由進入點在頂層捕捉到例外時呼叫，輸出至 stderr 後再由呼叫端決定 exit code；
 *   此調整僅變更輸出前綴格式，不改變訊息所反映的實際行為與內容。
 */
function error(message) {
    process.stderr.write(`[ERR][${taipeiTimestamp()}]: ${message}\n`);
}

module.exports = { section, info, error };