koa-boot-runtime 1.0.0

package/dist/utils/date.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 格式化日期为指定模式
+ *
+ * 支持的占位符:
+ *  YYYY - 四位年份
+ *  MM   - 两位月份 (01-12)
+ *  DD   - 两位日期 (01-31)
+ *  HH   - 两位小时 (00-23)
+ *  mm   - 两位分钟 (00-59)
+ *  ss   - 两位秒数 (00-59)
+ *  SSS  - 三位毫秒
+ */
+export declare function formatDate(date: Date | string | number, pattern?: string): string;
+/**
+ * 获取相对时间描述（如 "3分钟前"、"2小时前"）
+ */
+export declare function timeAgo(date: Date | string | number): string;
+/**
+ * 增减天数
+ */
+export declare function addDays(date: Date | string | number, days: number): Date;
+/**
+ * 计算两个日期之间的天数差（绝对值）
+ */
+export declare function diffDays(date1: Date | string | number, date2: Date | string | number): number;
+/**
+ * 获取当天起始时间 (00:00:00.000)
+ */
+export declare function startOfDay(date?: Date | string | number): Date;
+/**
+ * 获取当天结束时间 (23:59:59.999)
+ */
+export declare function endOfDay(date?: Date | string | number): Date;
+/**
+ * 判断是否为同一天
+ */
+export declare function isSameDay(date1: Date | string | number, date2: Date | string | number): boolean;
+/**
+ * 判断日期是否在指定范围内
+ */
+export declare function isInRange(date: Date | string | number, start: Date | string | number, end: Date | string | number): boolean;
+/** 格式化为 YYYY-MM-DD */
+export declare function formatDateShort(date?: Date | string | number): string;
+/** 格式化为 YYYY-MM-DD HH:mm:ss */
+export declare function formatDateTime(date?: Date | string | number): string;
+/** 格式化为 YYYY-MM-DD HH:mm:ss.SSS */
+export declare function formatDateTimeFull(date?: Date | string | number): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,MAA8B,GAAG,MAAM,CAyBxG;AAID;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAoB5D;AAID;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAK7F;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,GAAG,IAAI,CAI1E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,GAAG,IAAI,CAIxE;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAQ/F;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC5B,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,EAC7B,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAC1B,OAAO,CAKT;AAID,sBAAsB;AACtB,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,GAAG,MAAM,CAEjF;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,GAAG,MAAM,CAEhF;AAED,mCAAmC;AACnC,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,MAAmB,GAAG,MAAM,CAEpF"}

package/dist/utils/date.js

@@ -0,0 +1,145 @@
+"use strict";
+// ============ 日期格式化工具 ============
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.timeAgo = timeAgo;
+exports.addDays = addDays;
+exports.diffDays = diffDays;
+exports.startOfDay = startOfDay;
+exports.endOfDay = endOfDay;
+exports.isSameDay = isSameDay;
+exports.isInRange = isInRange;
+exports.formatDateShort = formatDateShort;
+exports.formatDateTime = formatDateTime;
+exports.formatDateTimeFull = formatDateTimeFull;
+/**
+ * 格式化日期为指定模式
+ *
+ * 支持的占位符:
+ *  YYYY - 四位年份
+ *  MM   - 两位月份 (01-12)
+ *  DD   - 两位日期 (01-31)
+ *  HH   - 两位小时 (00-23)
+ *  mm   - 两位分钟 (00-59)
+ *  ss   - 两位秒数 (00-59)
+ *  SSS  - 三位毫秒
+ */
+function formatDate(date, pattern = 'YYYY-MM-DD HH:mm:ss') {
+    const d = date instanceof Date ? date : new Date(date);
+    if (isNaN(d.getTime())) {
+        return '';
+    }
+    const pad = (n, len = 2) => String(n).padStart(len, '0');
+    const tokens = {
+        YYYY: String(d.getFullYear()),
+        MM: pad(d.getMonth() + 1),
+        DD: pad(d.getDate()),
+        HH: pad(d.getHours()),
+        mm: pad(d.getMinutes()),
+        ss: pad(d.getSeconds()),
+        SSS: pad(d.getMilliseconds(), 3),
+    };
+    let result = pattern;
+    // 先替换长 token 再替换短 token，避免 SSS 被 SS 匹配
+    for (const key of Object.keys(tokens).sort((a, b) => b.length - a.length)) {
+        result = result.replace(key, tokens[key]);
+    }
+    return result;
+}
+// ============ 相对时间 ============
+/**
+ * 获取相对时间描述（如 "3分钟前"、"2小时前"）
+ */
+function timeAgo(date) {
+    const d = date instanceof Date ? date : new Date(date);
+    const now = Date.now();
+    const diff = now - d.getTime();
+    if (diff < 0)
+        return '刚刚';
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    const months = Math.floor(days / 30);
+    const years = Math.floor(months / 12);
+    if (years > 0)
+        return `${years}年前`;
+    if (months > 0)
+        return `${months}个月前`;
+    if (days > 0)
+        return `${days}天前`;
+    if (hours > 0)
+        return `${hours}小时前`;
+    if (minutes > 0)
+        return `${minutes}分钟前`;
+    return '刚刚';
+}
+// ============ 日期计算 ============
+/**
+ * 增减天数
+ */
+function addDays(date, days) {
+    const d = new Date(date instanceof Date ? date : new Date(date));
+    d.setDate(d.getDate() + days);
+    return d;
+}
+/**
+ * 计算两个日期之间的天数差（绝对值）
+ */
+function diffDays(date1, date2) {
+    const d1 = date1 instanceof Date ? date1 : new Date(date1);
+    const d2 = date2 instanceof Date ? date2 : new Date(date2);
+    const diff = Math.abs(d1.getTime() - d2.getTime());
+    return Math.floor(diff / (1000 * 60 * 60 * 24));
+}
+// ============ 日期边界 ============
+/**
+ * 获取当天起始时间 (00:00:00.000)
+ */
+function startOfDay(date = new Date()) {
+    const d = new Date(date instanceof Date ? date : new Date(date));
+    d.setHours(0, 0, 0, 0);
+    return d;
+}
+/**
+ * 获取当天结束时间 (23:59:59.999)
+ */
+function endOfDay(date = new Date()) {
+    const d = new Date(date instanceof Date ? date : new Date(date));
+    d.setHours(23, 59, 59, 999);
+    return d;
+}
+// ============ 判断 ============
+/**
+ * 判断是否为同一天
+ */
+function isSameDay(date1, date2) {
+    const d1 = date1 instanceof Date ? date1 : new Date(date1);
+    const d2 = date2 instanceof Date ? date2 : new Date(date2);
+    return (d1.getFullYear() === d2.getFullYear() &&
+        d1.getMonth() === d2.getMonth() &&
+        d1.getDate() === d2.getDate());
+}
+/**
+ * 判断日期是否在指定范围内
+ */
+function isInRange(date, start, end) {
+    const ts = new Date(date instanceof Date ? date : new Date(date)).getTime();
+    const s = new Date(start instanceof Date ? start : new Date(start)).getTime();
+    const e = new Date(end instanceof Date ? end : new Date(end)).getTime();
+    return ts >= s && ts <= e;
+}
+// ============ 快捷格式化 ============
+/** 格式化为 YYYY-MM-DD */
+function formatDateShort(date = new Date()) {
+    return formatDate(date, 'YYYY-MM-DD');
+}
+/** 格式化为 YYYY-MM-DD HH:mm:ss */
+function formatDateTime(date = new Date()) {
+    return formatDate(date, 'YYYY-MM-DD HH:mm:ss');
+}
+/** 格式化为 YYYY-MM-DD HH:mm:ss.SSS */
+function formatDateTimeFull(date = new Date()) {
+    return formatDate(date, 'YYYY-MM-DD HH:mm:ss.SSS');
+}
+//# sourceMappingURL=date.js.map

package/dist/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../src/utils/date.ts"],"names":[],"mappings":"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"}

package/dist/utils/emailClient.d.ts

@@ -0,0 +1,15 @@
+/** 校验 SMTP 配置是否完整（不抛出，返回缺失项说明；供调用方决定是否跳过） */
+export declare function isEmailConfigured(): {
+    ok: boolean;
+    reason?: string;
+};
+/**
+ * 发送单封邮件
+ * @param to 接收邮箱
+ * @param subject 邮件主题
+ * @param html 邮件正文（HTML 富文本）
+ */
+export declare function sendEmail(to: string, subject: string, html: string): Promise<void>;
+/** 批量发送邮件（逐条发送；SMTP 无批量接口） */
+export declare function sendEmailBatch(emails: string[], subject: string, html: string): Promise<number>;
+//# sourceMappingURL=emailClient.d.ts.map

package/dist/utils/emailClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailClient.d.ts","sourceRoot":"","sources":["../../src/utils/emailClient.ts"],"names":[],"mappings":"AAQA,6CAA6C;AAC7C,wBAAgB,iBAAiB,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAMpE;AAoBD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxF;AAED,8BAA8B;AAC9B,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrG"}

package/dist/utils/emailClient.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmailConfigured = isEmailConfigured;
+exports.sendEmail = sendEmail;
+exports.sendEmailBatch = sendEmailBatch;
+// SMTP 邮件发送工具（V6.2）：外部通知方式选择 EXTERNAL_NOTIFY_CHANNEL=email 时使用
+// 依赖 nodemailer（标准 SMTP 协议，支持阿里云/腾讯云/网易等企业邮箱或自建 SMTP 服务）
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const config_1 = __importDefault(require("../config"));
+const logger_1 = require("./logger");
+let transporter = null;
+/** 校验 SMTP 配置是否完整（不抛出，返回缺失项说明；供调用方决定是否跳过） */
+function isEmailConfigured() {
+    const mail = config_1.default.email;
+    if (!mail.host)
+        return { ok: false, reason: 'SMTP 服务器 EMAIL_SMTP_HOST 未配置' };
+    if (!mail.user || !mail.pass)
+        return { ok: false, reason: 'SMTP 账号/授权码 EMAIL_SMTP_USER / EMAIL_SMTP_PASS 未配置' };
+    if (!mail.from)
+        return { ok: false, reason: '发件人 EMAIL_FROM 未配置' };
+    return { ok: true };
+}
+/** 获取或初始化 SMTP 客户端（单例） */
+function getTransporter() {
+    if (transporter)
+        return transporter;
+    const mail = config_1.default.email;
+    if (!mail.host || !mail.user || !mail.pass) {
+        throw new Error('SMTP 配置不完整，请检查 EMAIL_SMTP_HOST / EMAIL_SMTP_USER / EMAIL_SMTP_PASS');
+    }
+    transporter = nodemailer_1.default.createTransport({
+        host: mail.host,
+        port: mail.port,
+        // true = 465 端口 SSL/TLS（默认）；false = 587 端口 STARTTLS
+        secure: mail.secure,
+        auth: { user: mail.user, pass: mail.pass },
+    });
+    logger_1.logger.info(`[EMAIL] SMTP 客户端已初始化（${mail.host}:${mail.port} secure=${mail.secure}）`);
+    return transporter;
+}
+/**
+ * 发送单封邮件
+ * @param to 接收邮箱
+ * @param subject 邮件主题
+ * @param html 邮件正文（HTML 富文本）
+ */
+async function sendEmail(to, subject, html) {
+    const mail = config_1.default.email;
+    const tr = getTransporter();
+    await tr.sendMail({ from: mail.from, to, subject, html });
+}
+/** 批量发送邮件（逐条发送；SMTP 无批量接口） */
+async function sendEmailBatch(emails, subject, html) {
+    let sent = 0;
+    for (const email of emails) {
+        if (!email)
+            continue;
+        try {
+            await sendEmail(email, subject, html);
+            sent++;
+        }
+        catch (e) {
+            logger_1.logger.warn(`[EMAIL] ${email} 发送失败:`, e.message);
+        }
+    }
+    return sent;
+}
+//# sourceMappingURL=emailClient.js.map

package/dist/utils/emailClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailClient.js","sourceRoot":"","sources":["../../src/utils/emailClient.ts"],"names":[],"mappings":";;;;;AASA,8CAMC;AA0BD,8BAIC;AAGD,wCAYC;AA5DD,+DAA+D;AAC/D,yDAAyD;AACzD,4DAAqD;AACrD,uDAA+B;AAC/B,qCAAkC;AAElC,IAAI,WAAW,GAAuB,IAAI,CAAC;AAE3C,6CAA6C;AAC7C,SAAgB,iBAAiB;IAC/B,MAAM,IAAI,GAAG,gBAAM,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IAC7E,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mDAAmD,EAAE,CAAC;IAChH,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACnE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,0BAA0B;AAC1B,SAAS,cAAc;IACrB,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,IAAI,GAAG,gBAAM,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,WAAW,GAAG,oBAAU,CAAC,eAAe,CAAC;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,oDAAoD;QACpD,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KAC3C,CAAC,CAAC;IACH,eAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACrF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,EAAU,EAAE,OAAe,EAAE,IAAY;IACvE,MAAM,IAAI,GAAG,gBAAM,CAAC,KAAK,CAAC;IAC1B,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,8BAA8B;AACvB,KAAK,UAAU,cAAc,CAAC,MAAgB,EAAE,OAAe,EAAE,IAAY;IAClF,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,EAAE,CAAC;QACT,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,eAAM,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/jwt.d.ts

@@ -0,0 +1,10 @@
+export interface JwtPayload {
+    id: string;
+    username: string;
+    /** 用户拥有的角色编码列表（通过 sys_user_roles 关联获取） */
+    roles: string[];
+}
+export declare function signToken(payload: JwtPayload): string;
+export declare function verifyToken(token: string): JwtPayload | null;
+export declare function decodeToken(token: string): JwtPayload | null;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/utils/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAM5D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAM5D"}

package/dist/utils/jwt.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signToken = signToken;
+exports.verifyToken = verifyToken;
+exports.decodeToken = decodeToken;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key-change-in-production';
+const JWT_EXPIRES_IN = process.env.JWT_EXPIRES_IN || '7d';
+function signToken(payload) {
+    return jsonwebtoken_1.default.sign(payload, JWT_SECRET, { expiresIn: JWT_EXPIRES_IN });
+}
+function verifyToken(token) {
+    try {
+        return jsonwebtoken_1.default.verify(token, JWT_SECRET);
+    }
+    catch {
+        return null;
+    }
+}
+function decodeToken(token) {
+    try {
+        return jsonwebtoken_1.default.decode(token);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=jwt.js.map

package/dist/utils/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":";;;;;AAYA,8BAEC;AAED,kCAMC;AAED,kCAMC;AA9BD,gEAA2C;AAE3C,MAAM,UAAU,GAAW,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,sCAAsC,CAAC;AAC5F,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC;AAS1D,SAAgB,SAAS,CAAC,OAAmB;IAC3C,OAAO,sBAAG,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,cAAuB,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,OAAO,sBAAG,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,CAAe,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,OAAO,sBAAG,CAAC,MAAM,CAAC,KAAK,CAAe,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    SILENT = 4
+}
+export interface LoggerOptions {
+    /** 最低输出等级，低于此等级的日志不输出 */
+    level: LogLevel;
+    /** 是否在日志前输出时间戳 */
+    timestamp: boolean;
+    /** 是否输出调用位置（文件名:行号） */
+    caller: boolean;
+}
+export declare class Logger {
+    private options;
+    private context;
+    constructor(context?: string, options?: Partial<LoggerOptions>);
+    /** 创建子 logger（带上下文名称） */
+    child(context: string): Logger;
+    /** 设置最低日志等级 */
+    setLevel(level: LogLevel): void;
+    private log;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    /** 记录请求耗时 */
+    logRequest(method: string, url: string, status: number, duration: number): void;
+}
+/** 全局默认 Logger 实例 */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,MAAM,IAAI;CACX;AAID,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,kBAAkB;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAkCD,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAc,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC;IAKrE,yBAAyB;IACzB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI9B,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAM/B,OAAO,CAAC,GAAG;IAkCX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,aAAa;IACb,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAIhF;AAID,qBAAqB;AACrB,eAAO,MAAM,MAAM,QAAoB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = exports.LogLevel = void 0;
+const date_1 = require("./date");
+// ============ 日志等级 ============
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+const DEFAULT_OPTIONS = {
+    level: process.env.NODE_ENV === 'production' ? LogLevel.INFO : LogLevel.DEBUG,
+    timestamp: true,
+    caller: false,
+};
+// ============ 颜色（终端 ANSI） ============
+const COLORS = {
+    reset: '\x1b[0m',
+    dim: '\x1b[2m',
+    bright: '\x1b[1m',
+    fg: {
+        gray: '\x1b[90m',
+        cyan: '\x1b[36m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        red: '\x1b[31m',
+        magenta: '\x1b[35m',
+    },
+};
+const LEVEL_STYLES = {
+    [LogLevel.DEBUG]: { label: 'DEBUG', color: COLORS.fg.cyan },
+    [LogLevel.INFO]: { label: 'INFO ', color: COLORS.fg.green },
+    [LogLevel.WARN]: { label: 'WARN ', color: COLORS.fg.yellow },
+    [LogLevel.ERROR]: { label: 'ERROR', color: COLORS.fg.red },
+    [LogLevel.SILENT]: { label: '', color: '' },
+};
+// ============ Logger 类 ============
+class Logger {
+    options;
+    context;
+    constructor(context = 'App', options) {
+        this.context = context;
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /** 创建子 logger（带上下文名称） */
+    child(context) {
+        return new Logger(`${this.context}:${context}`, this.options);
+    }
+    /** 设置最低日志等级 */
+    setLevel(level) {
+        this.options.level = level;
+    }
+    // ---- 核心输出 ----
+    log(level, message, ...args) {
+        if (level < this.options.level)
+            return;
+        const style = LEVEL_STYLES[level];
+        const parts = [];
+        // 时间戳
+        if (this.options.timestamp) {
+            parts.push(`${COLORS.fg.gray}${(0, date_1.formatDateTimeFull)()}${COLORS.reset}`);
+        }
+        // 等级
+        parts.push(`${style.color}${style.label}${COLORS.reset}`);
+        // 上下文
+        parts.push(`${COLORS.fg.magenta}[${this.context}]${COLORS.reset}`);
+        // 消息
+        parts.push(message);
+        const output = parts.join(' ');
+        const rest = args.length > 0 ? ' ' + args.map(a => (typeof a === 'object' ? JSON.stringify(a) : String(a))).join(' ') : '';
+        if (level >= LogLevel.ERROR) {
+            console.error(output + rest);
+        }
+        else if (level >= LogLevel.WARN) {
+            console.warn(output + rest);
+        }
+        else {
+            console.log(output + rest);
+        }
+    }
+    // ---- 公开方法 ----
+    debug(message, ...args) {
+        this.log(LogLevel.DEBUG, message, ...args);
+    }
+    info(message, ...args) {
+        this.log(LogLevel.INFO, message, ...args);
+    }
+    warn(message, ...args) {
+        this.log(LogLevel.WARN, message, ...args);
+    }
+    error(message, ...args) {
+        this.log(LogLevel.ERROR, message, ...args);
+    }
+    // ---- 便捷方法 ----
+    /** 记录请求耗时 */
+    logRequest(method, url, status, duration) {
+        const level = status >= 500 ? LogLevel.ERROR : status >= 400 ? LogLevel.WARN : LogLevel.INFO;
+        this.log(level, `${method} ${url} ${status} - ${duration}ms`);
+    }
+}
+exports.Logger = Logger;
+// ============ 默认导出 ============
+/** 全局默认 Logger 实例 */
+exports.logger = new Logger('App');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/ossClient.d.ts

@@ -0,0 +1,38 @@
+import OSS from 'ali-oss';
+/** 获取或初始化 OSS 客户端（单例） */
+export declare function getOssClient(): OSS;
+/**
+ * 构建 OSS 存储路径：uploads/YYYY-MM/{timestamp36}{random4}_{originalName}
+ * 路径唯一性由时间戳保证，原始文件名保留可读性。
+ */
+export declare function buildOssPath(originalName: string): string;
+interface UploadResult {
+    /** OSS 访问 URL */
+    url: string;
+    /** OSS 返回的文件 ETag（内容哈希），用作 fileNo */
+    etag: string;
+}
+/**
+ * 上传文件到 OSS
+ * @param fileBuffer 文件二进制内容
+ * @param ossPath   OSS 存储路径
+ * @param mimeType  MIME 类型
+ * @returns { url, etag } — etag 即 OSS 返回的唯一标识，去除首尾引号后作为 fileNo
+ */
+export declare function uploadToOss(fileBuffer: Buffer, ossPath: string, mimeType: string): Promise<UploadResult>;
+/**
+ * 从 OSS 获取文件内容
+ */
+export declare function getFromOss(ossPath: string): Promise<Buffer>;
+/**
+ * 从 OSS 删除文件
+ */
+export declare function deleteFromOss(ossPath: string): Promise<void>;
+/**
+ * 解析 URL 中的 OSS 路径
+ * 例如 https://bucket.oss-cn-hangzhou.aliyuncs.com/uploads/2026-07/file.pdf
+ *   → uploads/2026-07/file.pdf
+ */
+export declare function extractOssPath(url: string): string | null;
+export {};
+//# sourceMappingURL=ossClient.d.ts.map

package/dist/utils/ossClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ossClient.d.ts","sourceRoot":"","sources":["../../src/utils/ossClient.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,SAAS,CAAC;AAM1B,yBAAyB;AACzB,wBAAgB,YAAY,IAAI,GAAG,CAqBlC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,UAAU,YAAY;IACpB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD"}

package/dist/utils/ossClient.js

@@ -0,0 +1,92 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOssClient = getOssClient;
+exports.buildOssPath = buildOssPath;
+exports.uploadToOss = uploadToOss;
+exports.getFromOss = getFromOss;
+exports.deleteFromOss = deleteFromOss;
+exports.extractOssPath = extractOssPath;
+const ali_oss_1 = __importDefault(require("ali-oss"));
+const config_1 = __importDefault(require("../config"));
+const logger_1 = require("./logger");
+let client = null;
+/** 获取或初始化 OSS 客户端（单例） */
+function getOssClient() {
+    if (client)
+        return client;
+    const oss = config_1.default.oss;
+    if (!oss.accessKeyId || !oss.accessKeySecret || !oss.bucket) {
+        logger_1.logger.warn('[OSS] 未配置完整参数，OSS 功能不可用');
+        throw new Error('OSS 配置不完整，请检查环境变量');
+    }
+    client = new ali_oss_1.default({
+        accessKeyId: oss.accessKeyId,
+        accessKeySecret: oss.accessKeySecret,
+        bucket: oss.bucket,
+        endpoint: oss.endpoint,
+        region: oss.region,
+        secure: true,
+    });
+    logger_1.logger.info(`[OSS] 客户端已初始化 → bucket=${oss.bucket}, endpoint=${oss.endpoint}`);
+    return client;
+}
+/**
+ * 构建 OSS 存储路径：uploads/YYYY-MM/{timestamp36}{random4}_{originalName}
+ * 路径唯一性由时间戳保证，原始文件名保留可读性。
+ */
+function buildOssPath(originalName) {
+    const now = new Date();
+    const ym = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`;
+    const uniq = Date.now().toString(36) + Math.random().toString(36).substring(2, 6);
+    return `uploads/${ym}/${uniq}_${originalName}`;
+}
+/**
+ * 上传文件到 OSS
+ * @param fileBuffer 文件二进制内容
+ * @param ossPath   OSS 存储路径
+ * @param mimeType  MIME 类型
+ * @returns { url, etag } — etag 即 OSS 返回的唯一标识，去除首尾引号后作为 fileNo
+ */
+async function uploadToOss(fileBuffer, ossPath, mimeType) {
+    const ossClient = getOssClient();
+    const result = await ossClient.put(ossPath, fileBuffer, {
+        mime: mimeType,
+    });
+    // ETag 格式如 "5B3C1A2D..."，去除首尾双引号
+    const rawEtag = result.res?.headers?.etag || '';
+    const etag = rawEtag.replace(/^"|"$/g, '');
+    return { url: result.url, etag };
+}
+/**
+ * 从 OSS 获取文件内容
+ */
+async function getFromOss(ossPath) {
+    const ossClient = getOssClient();
+    const result = await ossClient.get(ossPath);
+    return Buffer.from(result.content);
+}
+/**
+ * 从 OSS 删除文件
+ */
+async function deleteFromOss(ossPath) {
+    const ossClient = getOssClient();
+    await ossClient.delete(ossPath);
+}
+/**
+ * 解析 URL 中的 OSS 路径
+ * 例如 https://bucket.oss-cn-hangzhou.aliyuncs.com/uploads/2026-07/file.pdf
+ *   → uploads/2026-07/file.pdf
+ */
+function extractOssPath(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.pathname.startsWith('/') ? parsed.pathname.substring(1) : parsed.pathname;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ossClient.js.map

package/dist/utils/ossClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ossClient.js","sourceRoot":"","sources":["../../src/utils/ossClient.ts"],"names":[],"mappings":"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"}