koa-boot-runtime 1.0.0

package/dist/utils/permissionSync.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 权限自动同步工具（已禁用）
+ *
+ * 由于权限管理机制暂时简化，此文件的权限自动同步功能已禁用。
+ * 如需重新启用后端权限检查，可从此文件的 Git 历史记录中恢复完整实现。
+ *
+ * 禁用日期：2026-07-08
+ * 相关变更：后端权限中间件已注释，前端改为菜单驱动的角色绑定。
+ */
+//# sourceMappingURL=permissionSync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissionSync.d.ts","sourceRoot":"","sources":["../../src/utils/permissionSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/utils/permissionSync.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * 权限自动同步工具（已禁用）
+ *
+ * 由于权限管理机制暂时简化，此文件的权限自动同步功能已禁用。
+ * 如需重新启用后端权限检查，可从此文件的 Git 历史记录中恢复完整实现。
+ *
+ * 禁用日期：2026-07-08
+ * 相关变更：后端权限中间件已注释，前端改为菜单驱动的角色绑定。
+ */
+//# sourceMappingURL=permissionSync.js.map

package/dist/utils/permissionSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionSync.js","sourceRoot":"","sources":["../../src/utils/permissionSync.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/utils/redisClient.d.ts

@@ -0,0 +1,91 @@
+import { RedisClientType } from 'redis';
+/**
+ * 连接 Redis（应在应用启动时调用一次）
+ */
+export declare function connectRedis(): Promise<void>;
+/**
+ * 断开 Redis 连接
+ */
+export declare function disconnectRedis(): Promise<void>;
+export declare const redis: {
+    /**
+     * 获取当前客户端原始实例（同步，不保证已连接；并发场景请使用 incr 等封装方法）
+     */
+    readonly raw: RedisClientType | null;
+    /**
+     * 原子自增（发号器等场景）
+     */
+    incr(key: string): Promise<number>;
+    /**
+     * 设置键值对
+     * @param key    键
+     * @param value  值（字符串）
+     * @param ttl    过期时间（秒），不传则不过期
+     */
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    /**
+     * 获取值
+     * @param key 键
+     * @returns 值或 null
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * 删除键
+     * @param keys 一个或多个键
+     * @returns 删除的键数量
+     */
+    del(...keys: string[]): Promise<number>;
+    /**
+     * 检查键是否存在
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * 设置过期时间
+     * @param key    键
+     * @param ttl    过期时间（秒）
+     */
+    expire(key: string, ttl: number): Promise<boolean>;
+    /**
+     * 获取键的剩余过期时间（秒）
+     * @returns -2=不存在，-1=无过期，其他=剩余秒数
+     */
+    ttl(key: string): Promise<number>;
+    /**
+     * 设置 JSON 对象（自动序列化）
+     * @param key    键
+     * @param value  对象
+     * @param ttl    过期时间（秒）
+     */
+    setJSON<T>(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * 获取 JSON 对象（自动反序列化）
+     * @param key 键
+     * @returns 解析后的对象或 null
+     */
+    getJSON<T>(key: string): Promise<T | null>;
+    /**
+     * 设置 Hash 字段
+     */
+    hSet(key: string, field: string, value: string): Promise<void>;
+    /**
+     * 获取 Hash 字段
+     */
+    hGet(key: string, field: string): Promise<string | null>;
+    /**
+     * 获取整个 Hash
+     */
+    hGetAll(key: string): Promise<Record<string, string>>;
+    /**
+     * 删除 Hash 字段
+     */
+    hDel(key: string, ...fields: string[]): Promise<number>;
+    /**
+     * 缓存穿透防护：获取缓存，未命中则调用 fetcher 并缓存结果
+     * @param key     缓存键
+     * @param fetcher 数据获取函数
+     * @param ttl     缓存时间（秒），默认 300
+     */
+    getOrSet<T>(key: string, fetcher: () => Promise<T>, ttl?: number): Promise<T>;
+};
+export default redis;
+//# sourceMappingURL=redisClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redisClient.d.ts","sourceRoot":"","sources":["../../src/utils/redisClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,eAAe,EAAE,MAAM,OAAO,CAAC;AA+FtD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD;AAID,eAAO,MAAM,KAAK;IAChB;;OAEG;kBACQ,eAAe,GAAG,IAAI;IAIjC;;OAEG;cACa,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxC;;;;;OAKG;aACY,MAAM,SAAS,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlE;;;;OAIG;aACY,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C;;;;OAIG;iBACgB,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;OAEG;gBACe,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;;OAIG;gBACe,MAAM,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;;OAGG;aACY,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvC;;;;;OAKG;YACW,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;OAIG;YACW,CAAC,OAAO,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYhD;;OAEG;cACa,MAAM,SAAS,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;OAEG;cACa,MAAM,SAAS,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9D;;OAEG;iBACgB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI3D;;OAEG;cACa,MAAM,aAAa,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D;;;;;OAKG;aACY,CAAC,OAAO,MAAM,WAAW,MAAM,OAAO,CAAC,CAAC,CAAC,QAAO,MAAM,GAAS,OAAO,CAAC,CAAC,CAAC;CAQzF,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/utils/redisClient.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redis = void 0;
+exports.connectRedis = connectRedis;
+exports.disconnectRedis = disconnectRedis;
+const redis_1 = require("redis");
+const logger_1 = require("./logger");
+/**
+ * Redis 客户端封装（自动重连）
+ *
+ * 提供连接管理、常用操作封装、自动重连等功能。
+ * 使用 `redis` v5 官方客户端（默认 RESP2 协议）。
+ *
+ * 协议说明：node-redis v6 起默认改用 RESP3（握手发送 HELLO 命令），要求 Redis ≥ 6.0；
+ * 本项目部署环境为 Redis 5，因此固定使用 v5（默认 RESP2，不发送 HELLO），
+ * 升级 redis 包时务必保持 v5 大版本或确认服务端版本。
+ *
+ * 注意：connect() 只能调用一次，实例一旦断开（Redis 重启/空闲断连）
+ * 即进入 closed 状态无法复用。本封装在检测到连接不可用时自动重建实例并重连，
+ * 避免出现 "The client is closed" 错误。
+ *
+ * @example
+ * ```ts
+ * import { redis } from '../utils/redisClient';
+ *
+ * await redis.set('key', 'value', 60);   // 设置，60秒过期
+ * const val = await redis.get('key');     // 获取
+ * await redis.del('key');                 // 删除
+ * ```
+ */
+const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379';
+const REDIS_DB = parseInt(process.env.REDIS_DB || '0', 10);
+let client = null;
+let connecting = null;
+/**
+ * 创建客户端实例并绑定事件
+ */
+function createRedisClient() {
+    const instance = (0, redis_1.createClient)({
+        url: REDIS_URL,
+        database: REDIS_DB,
+        socket: {
+            // 中间断连自动重连（退避至最多 3s）；真正关闭后由 end 事件触发下次调用时重建
+            reconnectStrategy: (retries) => Math.min(200 * retries, 3000),
+        },
+    });
+    instance.on('connect', () => {
+        logger_1.logger.info(`[Redis] Connected to ${REDIS_URL} (db ${REDIS_DB})`);
+    });
+    instance.on('ready', () => {
+        logger_1.logger.info(`[Redis] Ready (db ${REDIS_DB})`);
+    });
+    instance.on('error', (err) => {
+        logger_1.logger.error('[Redis] Connection error:', err.message);
+    });
+    instance.on('reconnecting', () => {
+        logger_1.logger.info('[Redis] Reconnecting...');
+    });
+    instance.on('end', () => {
+        logger_1.logger.warn('[Redis] Connection closed, will recreate on next use');
+        if (client === instance)
+            client = null;
+    });
+    return instance;
+}
+/**
+ * 获取已连接的客户端（懒初始化 + 断开自动重建，并发安全）
+ */
+async function getClient() {
+    if (client && client.isOpen)
+        return client;
+    if (connecting)
+        return connecting;
+    connecting = (async () => {
+        if (!client)
+            client = createRedisClient();
+        if (!client.isOpen) {
+            try {
+                await client.connect();
+            }
+            catch (e) {
+                logger_1.logger.error('[Redis] Connect failed:', e.message);
+                // connect 失败时该实例不可复用，丢弃由下次调用重建
+                client = null;
+                throw e;
+            }
+        }
+        return client;
+    })().finally(() => {
+        connecting = null;
+    });
+    return connecting;
+}
+/**
+ * 连接 Redis（应在应用启动时调用一次）
+ */
+async function connectRedis() {
+    await getClient();
+}
+/**
+ * 断开 Redis 连接
+ */
+async function disconnectRedis() {
+    const c = client;
+    client = null;
+    if (c?.isOpen) {
+        await c.quit();
+    }
+}
+// ============ 常用操作封装 ============
+exports.redis = {
+    /**
+     * 获取当前客户端原始实例（同步，不保证已连接；并发场景请使用 incr 等封装方法）
+     */
+    get raw() {
+        return client;
+    },
+    /**
+     * 原子自增（发号器等场景）
+     */
+    async incr(key) {
+        return (await getClient()).incr(key);
+    },
+    /**
+     * 设置键值对
+     * @param key    键
+     * @param value  值（字符串）
+     * @param ttl    过期时间（秒），不传则不过期
+     */
+    async set(key, value, ttl) {
+        const c = await getClient();
+        if (ttl && ttl > 0) {
+            await c.setEx(key, ttl, value);
+        }
+        else {
+            await c.set(key, value);
+        }
+    },
+    /**
+     * 获取值
+     * @param key 键
+     * @returns 值或 null
+     */
+    async get(key) {
+        return (await getClient()).get(key);
+    },
+    /**
+     * 删除键
+     * @param keys 一个或多个键
+     * @returns 删除的键数量
+     */
+    async del(...keys) {
+        return (await getClient()).del(keys);
+    },
+    /**
+     * 检查键是否存在
+     */
+    async exists(key) {
+        const result = await (await getClient()).exists(key);
+        return result === 1;
+    },
+    /**
+     * 设置过期时间
+     * @param key    键
+     * @param ttl    过期时间（秒）
+     */
+    async expire(key, ttl) {
+        const result = await (await getClient()).expire(key, ttl);
+        return result === 1;
+    },
+    /**
+     * 获取键的剩余过期时间（秒）
+     * @returns -2=不存在，-1=无过期，其他=剩余秒数
+     */
+    async ttl(key) {
+        return (await getClient()).ttl(key);
+    },
+    // ============ JSON 操作 ============
+    /**
+     * 设置 JSON 对象（自动序列化）
+     * @param key    键
+     * @param value  对象
+     * @param ttl    过期时间（秒）
+     */
+    async setJSON(key, value, ttl) {
+        await this.set(key, JSON.stringify(value), ttl);
+    },
+    /**
+     * 获取 JSON 对象（自动反序列化）
+     * @param key 键
+     * @returns 解析后的对象或 null
+     */
+    async getJSON(key) {
+        const raw = await this.get(key);
+        if (raw === null)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    },
+    // ============ Hash 操作 ============
+    /**
+     * 设置 Hash 字段
+     */
+    async hSet(key, field, value) {
+        await (await getClient()).hSet(key, field, value);
+    },
+    /**
+     * 获取 Hash 字段
+     */
+    async hGet(key, field) {
+        return (await getClient()).hGet(key, field);
+    },
+    /**
+     * 获取整个 Hash
+     */
+    async hGetAll(key) {
+        return (await getClient()).hGetAll(key);
+    },
+    /**
+     * 删除 Hash 字段
+     */
+    async hDel(key, ...fields) {
+        return (await getClient()).hDel(key, fields);
+    },
+    // ============ 缓存辅助 ============
+    /**
+     * 缓存穿透防护：获取缓存，未命中则调用 fetcher 并缓存结果
+     * @param key     缓存键
+     * @param fetcher 数据获取函数
+     * @param ttl     缓存时间（秒），默认 300
+     */
+    async getOrSet(key, fetcher, ttl = 300) {
+        const cached = await this.getJSON(key);
+        if (cached !== null)
+            return cached;
+        const data = await fetcher();
+        await this.setJSON(key, data, ttl);
+        return data;
+    },
+};
+exports.default = exports.redis;
+//# sourceMappingURL=redisClient.js.map

package/dist/utils/redisClient.js.map

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

package/dist/utils/sequence.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 单据编号发号器
+ *
+ * 全系统单号统一格式：「前缀-日期-当日序号」，如 WB-20260811-001。
+ * 优先使用 Redis INCR（键 seq:{prefix}:{yyyyMMdd}，当日首次发号时设置次日凌晨过期）保证并发唯一；
+ * Redis 不可用时降级为数据库序列表 sys_sequences 发号。
+ * 序号溢出 999 时自动扩展位数；单号列均有唯一索引兜底。
+ */
+/** 单据前缀定义（与 database-design.md 第10节一致） */
+export declare const SEQ_PREFIX: {
+    /** 销售订单 */
+    readonly SALE_ORDER: "SO";
+    /** 仓发出库单 */
+    readonly OUTBOUND: "OB";
+    /** 销售出库单（无订单直出） */
+    readonly SALE_OUTBOUND: "SDO";
+    /** 运单（V4.0 替代发货批次） */
+    readonly WAYBILL: "WB";
+    /** 常规采购单 */
+    readonly PURCHASE_ORDER: "PO";
+    /** 采购入库单 */
+    readonly PURCHASE_RECEIPT: "PR";
+    /** 销售退货单 */
+    readonly SALE_RETURN: "SR";
+    /** 采购退货单 */
+    readonly PURCHASE_RETURN: "PRT";
+    /** 调拨单 */
+    readonly TRANSFER: "TR";
+    /** 盘点单 */
+    readonly STOCK_CHECK: "SC";
+    /** 应收单 */
+    readonly RECEIVABLE: "AR";
+    /** 应付单 */
+    readonly PAYABLE: "AP";
+    /** 费用单 */
+    readonly FEE: "FEE";
+    /** 商品SKU编码 */
+    readonly SKU: "SKU";
+    /** 门店编号 */
+    readonly STORE: "ST";
+};
+export type SeqPrefix = (typeof SEQ_PREFIX)[keyof typeof SEQ_PREFIX];
+/**
+ * 生成下一个单据编号
+ *
+ * @param prefix 单据前缀（使用 SEQ_PREFIX 常量）
+ * @returns 形如 `SO-20260729-001` 的单号
+ *
+ * @example
+ * const orderNo = await nextSequenceNo(SEQ_PREFIX.SALE_ORDER);
+ */
+export declare function nextSequenceNo(prefix: SeqPrefix): Promise<string>;
+//# sourceMappingURL=sequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/utils/sequence.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,eAAO,MAAM,UAAU;IACrB,WAAW;;IAEX,YAAY;;IAEZ,mBAAmB;;IAEnB,sBAAsB;;IAEtB,YAAY;;IAEZ,YAAY;;IAEZ,YAAY;;IAEZ,YAAY;;IAEZ,UAAU;;IAEV,UAAU;;IAEV,UAAU;;IAEV,UAAU;;IAEV,UAAU;;IAEV,cAAc;;IAEd,WAAW;;CAEH,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AA0CrE;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAevE"}

package/dist/utils/sequence.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEQ_PREFIX = void 0;
+exports.nextSequenceNo = nextSequenceNo;
+const database_1 = require("../config/database");
+const redisClient_1 = require("./redisClient");
+const logger_1 = require("./logger");
+/**
+ * 单据编号发号器
+ *
+ * 全系统单号统一格式：「前缀-日期-当日序号」，如 WB-20260811-001。
+ * 优先使用 Redis INCR（键 seq:{prefix}:{yyyyMMdd}，当日首次发号时设置次日凌晨过期）保证并发唯一；
+ * Redis 不可用时降级为数据库序列表 sys_sequences 发号。
+ * 序号溢出 999 时自动扩展位数；单号列均有唯一索引兜底。
+ */
+/** 单据前缀定义（与 database-design.md 第10节一致） */
+exports.SEQ_PREFIX = {
+    /** 销售订单 */
+    SALE_ORDER: 'SO',
+    /** 仓发出库单 */
+    OUTBOUND: 'OB',
+    /** 销售出库单（无订单直出） */
+    SALE_OUTBOUND: 'SDO',
+    /** 运单（V4.0 替代发货批次） */
+    WAYBILL: 'WB',
+    /** 常规采购单 */
+    PURCHASE_ORDER: 'PO',
+    /** 采购入库单 */
+    PURCHASE_RECEIPT: 'PR',
+    /** 销售退货单 */
+    SALE_RETURN: 'SR',
+    /** 采购退货单 */
+    PURCHASE_RETURN: 'PRT',
+    /** 调拨单 */
+    TRANSFER: 'TR',
+    /** 盘点单 */
+    STOCK_CHECK: 'SC',
+    /** 应收单 */
+    RECEIVABLE: 'AR',
+    /** 应付单 */
+    PAYABLE: 'AP',
+    /** 费用单 */
+    FEE: 'FEE',
+    /** 商品SKU编码 */
+    SKU: 'SKU',
+    /** 门店编号 */
+    STORE: 'ST',
+};
+/** 获取当日日期串 yyyyMMdd */
+function todayStr() {
+    const now = new Date();
+    const y = now.getFullYear();
+    const m = String(now.getMonth() + 1).padStart(2, '0');
+    const d = String(now.getDate()).padStart(2, '0');
+    return `${y}${m}${d}`;
+}
+/** 距离次日凌晨的剩余秒数（作为 Redis 键过期时间） */
+function secondsUntilMidnight() {
+    const now = new Date();
+    const midnight = new Date(now.getFullYear(), now.getMonth(), now.getDate() + 1);
+    return Math.max(60, Math.floor((midnight.getTime() - now.getTime()) / 1000));
+}
+/** Redis 发号 */
+async function nextFromRedis(seqKey) {
+    const key = `seq:${seqKey}`;
+    const value = await redisClient_1.redis.incr(key);
+    if (value === 1) {
+        await redisClient_1.redis.expire(key, secondsUntilMidnight());
+    }
+    return value;
+}
+/** 数据库序列表降级发号（upsert + 原子自增后读取） */
+async function nextFromDb(seqKey) {
+    const result = await database_1.prisma.$transaction(async (tx) => {
+        await tx.sysSequence.upsert({
+            where: { seqKey },
+            update: { currentValue: { increment: 1 } },
+            create: { seqKey, currentValue: 1 },
+        });
+        const row = await tx.sysSequence.findUniqueOrThrow({ where: { seqKey } });
+        return row.currentValue;
+    });
+    return result;
+}
+/**
+ * 生成下一个单据编号
+ *
+ * @param prefix 单据前缀（使用 SEQ_PREFIX 常量）
+ * @returns 形如 `SO-20260729-001` 的单号
+ *
+ * @example
+ * const orderNo = await nextSequenceNo(SEQ_PREFIX.SALE_ORDER);
+ */
+async function nextSequenceNo(prefix) {
+    const date = todayStr();
+    const seqKey = `${prefix}:${date}`;
+    let seq;
+    try {
+        seq = await nextFromRedis(seqKey);
+    }
+    catch (err) {
+        logger_1.logger.warn(`[Sequence] Redis 发号失败，降级为数据库发号：${err.message}`);
+        seq = await nextFromDb(seqKey);
+    }
+    // 序号默认3位，溢出自动扩展位数
+    const seqStr = String(seq).padStart(3, '0');
+    return `${prefix}-${date}-${seqStr}`;
+}
+//# sourceMappingURL=sequence.js.map

package/dist/utils/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../src/utils/sequence.ts"],"names":[],"mappings":";;;AAkGA,wCAeC;AAjHD,iDAA4C;AAC5C,+CAAsC;AACtC,qCAAkC;AAElC;;;;;;;GAOG;AAEH,0CAA0C;AAC7B,QAAA,UAAU,GAAG;IACxB,WAAW;IACX,UAAU,EAAE,IAAI;IAChB,YAAY;IACZ,QAAQ,EAAE,IAAI;IACd,mBAAmB;IACnB,aAAa,EAAE,KAAK;IACpB,sBAAsB;IACtB,OAAO,EAAE,IAAI;IACb,YAAY;IACZ,cAAc,EAAE,IAAI;IACpB,YAAY;IACZ,gBAAgB,EAAE,IAAI;IACtB,YAAY;IACZ,WAAW,EAAE,IAAI;IACjB,YAAY;IACZ,eAAe,EAAE,KAAK;IACtB,UAAU;IACV,QAAQ,EAAE,IAAI;IACd,UAAU;IACV,WAAW,EAAE,IAAI;IACjB,UAAU;IACV,UAAU,EAAE,IAAI;IAChB,UAAU;IACV,OAAO,EAAE,IAAI;IACb,UAAU;IACV,GAAG,EAAE,KAAK;IACV,cAAc;IACd,GAAG,EAAE,KAAK;IACV,WAAW;IACX,KAAK,EAAE,IAAI;CACH,CAAC;AAIX,uBAAuB;AACvB,SAAS,QAAQ;IACf,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,kCAAkC;AAClC,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,eAAe;AACf,KAAK,UAAU,aAAa,CAAC,MAAc;IACzC,MAAM,GAAG,GAAG,OAAO,MAAM,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,mBAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,mBAAK,CAAC,MAAM,CAAC,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mCAAmC;AACnC,KAAK,UAAU,UAAU,CAAC,MAAc;IACtC,MAAM,MAAM,GAAG,MAAM,iBAAM,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACpD,MAAM,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;YAC1B,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;YAC1C,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE;SACpC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC1E,OAAO,GAAG,CAAC,YAAY,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,cAAc,CAAC,MAAiB;IACpD,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;IAEnC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,eAAM,CAAC,IAAI,CAAC,kCAAmC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxE,GAAG,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,kBAAkB;IAClB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC"}

package/dist/utils/smsClient.d.ts

@@ -0,0 +1,15 @@
+/** 校验短信配置是否完整（不抛出，返回缺失项说明；供调用方决定是否跳过） */
+export declare function isSmsConfigured(): {
+    ok: boolean;
+    reason?: string;
+};
+/**
+ * 发送短信验证码/通知短信（单条）
+ * @param phone 接收手机号（如 13800138000）
+ * @param templateParams 模板变量（JSON 字符串，如 '{"name":"张三","date":"2026-08-20"}'，与模板中 ${xxx} 一一对应）
+ * @returns 阿里云返回的 BizId
+ */
+export declare function sendSms(phone: string, templateParams?: Record<string, any>): Promise<string>;
+/** 批量发送短信（逐条发送；阿里云短信 API 单次仅支持一个手机号） */
+export declare function sendSmsBatch(phones: string[], templateParams?: Record<string, any>): Promise<number>;
+//# sourceMappingURL=smsClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smsClient.d.ts","sourceRoot":"","sources":["../../src/utils/smsClient.ts"],"names":[],"mappings":"AASA,yCAAyC;AACzC,wBAAgB,eAAe,IAAI;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAMlE;AAqBD;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAelG;AAED,wCAAwC;AACxC,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1G"}