JefferyandClaude Opus 4.8
24bcad7141
在刪除迴圈中先檢查項目為非 null 物件,避免對非預期結構解構時拋出未捕捉例外。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
87 lines
3.5 KiB
JavaScript
87 lines
3.5 KiB
JavaScript
// 清理舊版本成品的功能模組。
|
|
// 對應原本 entrypoint.sh 的「取得成品資訊」與「刪除舊版本成品」區段。
|
|
|
|
import { section, info, success, fail, warn } from './logger.js'
|
|
import { isEmptyOrNull } from './validate.js'
|
|
|
|
/**
|
|
* 依 `created_at` 建立時間由新到舊排序,保留最新的 `keepCount` 筆,回傳其餘(較舊)待刪除的成品。
|
|
* 以展開運算子複製陣列後再排序,不會改動傳入的原陣列。為純函式,方便單元測試。
|
|
* @param {any[]} releases 成品清單,每個元素預期含有 `created_at` 欄位
|
|
* @param {number} keepCount 要保留的最新筆數;為 0 時代表全部刪除
|
|
* @returns {any[]} 需要刪除的成品陣列(較舊者),依新到舊排序
|
|
*/
|
|
export function selectReleasesToDelete(releases, keepCount) {
|
|
// 解析 created_at;格式無效或缺漏時視為最舊(0),避免 NaN 造成排序結果不可預期。
|
|
const createdTime = (release) => {
|
|
const time = Date.parse(release?.created_at)
|
|
return Number.isNaN(time) ? 0 : time
|
|
}
|
|
// 先一次性計算每筆的時間戳,避免在排序比較中重複呼叫 Date.parse。
|
|
// 時間相同時以 id(數值,大者為新)作為次要鍵,確保排序結果具決定性。
|
|
return releases
|
|
.map((release) => ({
|
|
release,
|
|
time: createdTime(release),
|
|
id: Number(release?.id) || 0,
|
|
}))
|
|
.sort((a, b) => b.time - a.time || b.id - a.id)
|
|
.map((entry) => entry.release)
|
|
.slice(keepCount)
|
|
}
|
|
|
|
/**
|
|
* 讀取全部成品清單,刪除超出保留數量的舊版本成品。
|
|
*
|
|
* 流程:取得所有 release → 若總數不超過 `keepCount` 則直接結束(無需清理)→
|
|
* 否則以 [[selectReleasesToDelete]] 取出待刪除清單,逐筆刪除(略過沒有 `id` 的項目),
|
|
* 依回應狀態碼 204 判定成功與否並輸出結果。
|
|
*
|
|
* @param {import('./gitea-client.js').GiteaClient} client 用於讀取與刪除的 Gitea 客戶端
|
|
* @param {ReturnType<import('./config.js').loadConfig>} config 設定物件,使用其 `releaseApiUrl` 與 `keepCount`
|
|
* @returns {Promise<void>}
|
|
*/
|
|
export async function cleanupReleases(client, config) {
|
|
section('取得成品資訊')
|
|
info(`GET ${config.releaseApiUrl}`)
|
|
|
|
const releases = await client.fetchAllPages(config.releaseApiUrl)
|
|
info(`RELEASE_COUNT=${releases.length}`)
|
|
info(`KEEP_COUNT=${config.keepCount}`)
|
|
|
|
if (releases.length <= config.keepCount) {
|
|
success('沒有需要清理的舊版本成品')
|
|
return
|
|
}
|
|
|
|
section('刪除舊版本成品')
|
|
const toDelete = selectReleasesToDelete(releases, config.keepCount)
|
|
|
|
for (const release of toDelete) {
|
|
// 防禦非預期結構(null/非物件),避免解構時拋出未捕捉例外。
|
|
if (release === null || typeof release !== 'object') {
|
|
warn('略過格式異常的成品項目')
|
|
continue
|
|
}
|
|
|
|
const { id, tag_name: tag, name } = release
|
|
|
|
// 要求 id 為正整數(Gitea release id 本即正整數);非整數一律略過,不僅依賴 URL 編碼防護。
|
|
if (isEmptyOrNull(id) || !Number.isInteger(Number(id)) || Number(id) <= 0) {
|
|
warn(`略過沒有有效 id 的成品: ${tag} (${name})`)
|
|
continue
|
|
}
|
|
|
|
// id 已驗證為正整數;仍對其編碼作為縱深防禦。
|
|
const url = `${config.releaseApiUrl}/${encodeURIComponent(id)}`
|
|
info(`DELETE ${tag} (${name})`)
|
|
|
|
const code = await client.deleteResource(url)
|
|
if (code === 204) {
|
|
success(`成功刪除: ${tag} (${name})`)
|
|
} else {
|
|
fail(`刪除失敗: ${tag} (${name}), HTTP ${code}`)
|
|
}
|
|
}
|
|
}
|