'use strict'; /** * methods/system.json 库表化维护脚本共用工具。 * * 环境:`--env production` 或 `NODE_ENV=production` 走生产库;默认开发库。 * JSON 字段参数(headers/params/response/errors)支持内联 JSON 或 `@文件路径`。 */ const fs = require('node:fs'); const path = require('node:path'); const mysql = require('mysql2/promise'); function resolveEnv(argv = process.argv) { const idx = argv.indexOf('--env'); if (idx > -1 && argv[idx + 1] && !argv[idx + 1].startsWith('--')) { return argv[idx + 1] === 'production' ? 'production' : 'development'; } return process.env.NODE_ENV === 'production' ? 'production' : 'development'; } function loadDbConfig(env) { const dbConfig = require(path.join(__dirname, '..', 'database', 'config')); return dbConfig[env]; } function warnIfProduction(env) { if (env !== 'production') return; console.log('!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!'); console.log('[DB-CONFIG] ⚠ 警告:目标为【生产数据库】'); console.log('[DB-CONFIG] ⚠ 请确认这是预期环境;如属误判,请去掉 --env production 或清空 NODE_ENV。'); console.log('!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!'); } async function createConnection(env) { warnIfProduction(env); const cfg = loadDbConfig(env); return mysql.createConnection({ host: cfg.host, port: cfg.port, user: cfg.username, password: cfg.password, database: cfg.database, charset: 'utf8mb4', }); } /** 简单参数解析:--key value / --flag;返回 Map。 * @param {string[]} [argv] 参数数组(默认 process.argv)。 */ function parseArgs(argv = process.argv) { const map = new Map(); for (let i = 2; i < argv.length; i++) { const token = argv[i]; if (!token.startsWith('--')) continue; const key = token.slice(2); const next = argv[i + 1]; if (next !== undefined && !next.startsWith('--')) { map.set(key, next); i++; } else { map.set(key, ''); } } return map; } /** JSON 参数:内联 JSON 或 @文件路径。 * @param {string|undefined} value 参数值。 */ function readJsonArg(value) { if (value === undefined || value === null || value === '') return null; const text = String(value); if (text.startsWith('@')) { return JSON.parse(fs.readFileSync(text.slice(1), 'utf8')); } return JSON.parse(text); } /** 解析 JSON 列(DB 返回 string/object 两种可能)。 * @param {string|object|null|undefined} raw 原始值。 */ function parseJsonColumn(raw) { if (raw === null || raw === undefined) return null; if (typeof raw === 'object') return raw; return JSON.parse(String(raw)); } /** 版本号补丁位 +1:0.3.169 -> 0.3.170。 * @param {string} version 当前版本。 */ function bumpVersion(version) { const parts = String(version || '0.3.0').split('.'); const last = parts.length - 1; parts[last] = String((Number(parts[last]) || 0) + 1); return parts.join('.'); } function today() { const d = new Date(); return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`; } /** Date/字符串统一格式化为 YYYY-MM-DD。 * @param {Date|string} value 日期值。 */ function formatDate(value) { if (value instanceof Date) { return `${value.getFullYear()}-${String(value.getMonth() + 1).padStart(2, '0')}-${String(value.getDate()).padStart(2, '0')}`; } return String(value || '').slice(0, 10); } function fail(message) { console.error(`[method-doc] ${message}`); process.exit(1); } module.exports = { resolveEnv, createConnection, parseArgs, readJsonArg, parseJsonColumn, bumpVersion, today, formatDate, fail, };