130 lines
3.7 KiB
JavaScript
130 lines
3.7 KiB
JavaScript
'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,
|
||
};
|