midway-fatcms 0.0.7 → 0.0.9

package/dist/libs/crud-sharding/index.d.ts

@@ -7,15 +7,15 @@
  * - YEAR: 按年分表，如 order_2024, order_2025
  * - MONTH: 按月分表，如 order_202401, order_202402
  * - DAY: 按日分表，如 order_20240101
- * - RANGE: 按范围分表，如 user_0 ~ user_99
  * - HASH: 按哈希分表，如 order_01 ~ order_16
+ * - KEY: 按键值分表，字段原值=表后缀，如 order_east, order_west
  * - CUSTOM: 自定义分表规则
  *
  * @example
- * import { ShardingCrudPro, ShardingType } from '../../libs/crud-sharding';
+ * import { ShardingByTimeCrud, ShardingType } from '../../libs/crud-sharding';
  *
- * // 创建分表操作器
- * const sharding = new ShardingCrudPro(crudPro, {
+ * // 创建时间分表操作器
+ * const sharding = new ShardingByTimeCrud(crudProFactory, {
  *   type: ShardingType.MONTH,
  *   baseTable: 't_order',
  *   timeColumn: 'created_at',
@@ -25,21 +25,19 @@
  * await sharding.insert({
  *   data: { order_id: '001', amount: 100, created_at: '2024-03-15' },
  * });
- *
- * // 分页查询（自动合并多表结果）
- * const result = await sharding.queryPage({
- *   condition: { created_at: { $gte: '2024-01-01', $lte: '2024-03-31' } },
- *   pageNo: 1,
- *   pageSize: 10,
- * });
  */
-export { ShardingCrudPro } from './ShardingCrudPro';
-export { ShardingRouter } from './ShardingRouter';
+export { ShardingBase } from './ShardingBase';
+export { ShardingByTimeCrud } from './ShardingByTimeCrud';
+export { ShardingByHashCrud } from './ShardingByHashCrud';
+export { ShardingByKeyCrud } from './ShardingByKeyCrud';
+export { ShardingByCustomCrud } from './ShardingByCustomCrud';
+export { ShardingBase as ShardingCrudPro } from './ShardingBase';
 export { ShardingMerger } from './ShardingMerger';
 export { ShardingType } from './ShardingConfig';
 export type { IShardingConfig, IShardingRouterContext, IShardingRouterFunc, IShardingTimeRange, IShardingTableCreateOptions, IShardingTableCreateResult, IShardingCountCacheConfig, } from './ShardingConfig';
-export type { IShardingPageQueryResult } from './ShardingMerger';
-export type { IShardingSmartBatchInsertResult } from './ShardingCrudPro';
+export { ShardingBatchInsertResult } from './ShardingResult';
+export type { IShardingPageQueryResult, IShardingListQueryResult } from './ShardingMerger';
+export { CrudWriteResult, CrudQueryOneResult, CrudQueryListResult, CrudQueryPageResult, CrudExistResult, CrudCountResult, CrudUpsertResult, } from '../../libs/crud-pro/models/CrudResult';
 export { ShardingTableCreator } from './ShardingTableCreator';
 export { ShardingCountCache, shardingHashCondition } from './ShardingCountCache';
 export type { ShardingTimeGranularity } from './ShardingUtils';

package/dist/libs/crud-sharding/index.js

@@ -8,15 +8,15 @@
  * - YEAR: 按年分表，如 order_2024, order_2025
  * - MONTH: 按月分表，如 order_202401, order_202402
  * - DAY: 按日分表，如 order_20240101
- * - RANGE: 按范围分表，如 user_0 ~ user_99
  * - HASH: 按哈希分表，如 order_01 ~ order_16
+ * - KEY: 按键值分表，字段原值=表后缀，如 order_east, order_west
  * - CUSTOM: 自定义分表规则
  *
  * @example
- * import { ShardingCrudPro, ShardingType } from '../../libs/crud-sharding';
+ * import { ShardingByTimeCrud, ShardingType } from '../../libs/crud-sharding';
  *
- * // 创建分表操作器
- * const sharding = new ShardingCrudPro(crudPro, {
+ * // 创建时间分表操作器
+ * const sharding = new ShardingByTimeCrud(crudProFactory, {
  *   type: ShardingType.MONTH,
  *   baseTable: 't_order',
  *   timeColumn: 'created_at',
@@ -26,26 +26,42 @@
  * await sharding.insert({
  *   data: { order_id: '001', amount: 100, created_at: '2024-03-15' },
  * });
- *
- * // 分页查询（自动合并多表结果）
- * const result = await sharding.queryPage({
- *   condition: { created_at: { $gte: '2024-01-01', $lte: '2024-03-31' } },
- *   pageNo: 1,
- *   pageSize: 10,
- * });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shardingHashCondition = exports.ShardingCountCache = exports.ShardingTableCreator = exports.ShardingType = exports.ShardingMerger = exports.ShardingRouter = exports.ShardingCrudPro = void 0;
-// 核心类
-var ShardingCrudPro_1 = require("./ShardingCrudPro");
-Object.defineProperty(exports, "ShardingCrudPro", { enumerable: true, get: function () { return ShardingCrudPro_1.ShardingCrudPro; } });
-var ShardingRouter_1 = require("./ShardingRouter");
-Object.defineProperty(exports, "ShardingRouter", { enumerable: true, get: function () { return ShardingRouter_1.ShardingRouter; } });
+exports.shardingHashCondition = exports.ShardingCountCache = exports.ShardingTableCreator = exports.CrudUpsertResult = exports.CrudCountResult = exports.CrudExistResult = exports.CrudQueryPageResult = exports.CrudQueryListResult = exports.CrudQueryOneResult = exports.CrudWriteResult = exports.ShardingBatchInsertResult = exports.ShardingType = exports.ShardingMerger = exports.ShardingCrudPro = exports.ShardingByCustomCrud = exports.ShardingByKeyCrud = exports.ShardingByHashCrud = exports.ShardingByTimeCrud = exports.ShardingBase = void 0;
+// 基类
+var ShardingBase_1 = require("./ShardingBase");
+Object.defineProperty(exports, "ShardingBase", { enumerable: true, get: function () { return ShardingBase_1.ShardingBase; } });
+// 四个子类
+var ShardingByTimeCrud_1 = require("./ShardingByTimeCrud");
+Object.defineProperty(exports, "ShardingByTimeCrud", { enumerable: true, get: function () { return ShardingByTimeCrud_1.ShardingByTimeCrud; } });
+var ShardingByHashCrud_1 = require("./ShardingByHashCrud");
+Object.defineProperty(exports, "ShardingByHashCrud", { enumerable: true, get: function () { return ShardingByHashCrud_1.ShardingByHashCrud; } });
+var ShardingByKeyCrud_1 = require("./ShardingByKeyCrud");
+Object.defineProperty(exports, "ShardingByKeyCrud", { enumerable: true, get: function () { return ShardingByKeyCrud_1.ShardingByKeyCrud; } });
+var ShardingByCustomCrud_1 = require("./ShardingByCustomCrud");
+Object.defineProperty(exports, "ShardingByCustomCrud", { enumerable: true, get: function () { return ShardingByCustomCrud_1.ShardingByCustomCrud; } });
+// 兼容旧代码：ShardingCrudPro → ShardingBase
+var ShardingBase_2 = require("./ShardingBase");
+Object.defineProperty(exports, "ShardingCrudPro", { enumerable: true, get: function () { return ShardingBase_2.ShardingBase; } });
+// 合并器（仅 Time 使用）
 var ShardingMerger_1 = require("./ShardingMerger");
 Object.defineProperty(exports, "ShardingMerger", { enumerable: true, get: function () { return ShardingMerger_1.ShardingMerger; } });
 // 配置和类型
 var ShardingConfig_1 = require("./ShardingConfig");
 Object.defineProperty(exports, "ShardingType", { enumerable: true, get: function () { return ShardingConfig_1.ShardingType; } });
+// 结果类型
+var ShardingResult_1 = require("./ShardingResult");
+Object.defineProperty(exports, "ShardingBatchInsertResult", { enumerable: true, get: function () { return ShardingResult_1.ShardingBatchInsertResult; } });
+// 重新导出 CrudResult 类型
+var CrudResult_1 = require("../../libs/crud-pro/models/CrudResult");
+Object.defineProperty(exports, "CrudWriteResult", { enumerable: true, get: function () { return CrudResult_1.CrudWriteResult; } });
+Object.defineProperty(exports, "CrudQueryOneResult", { enumerable: true, get: function () { return CrudResult_1.CrudQueryOneResult; } });
+Object.defineProperty(exports, "CrudQueryListResult", { enumerable: true, get: function () { return CrudResult_1.CrudQueryListResult; } });
+Object.defineProperty(exports, "CrudQueryPageResult", { enumerable: true, get: function () { return CrudResult_1.CrudQueryPageResult; } });
+Object.defineProperty(exports, "CrudExistResult", { enumerable: true, get: function () { return CrudResult_1.CrudExistResult; } });
+Object.defineProperty(exports, "CrudCountResult", { enumerable: true, get: function () { return CrudResult_1.CrudCountResult; } });
+Object.defineProperty(exports, "CrudUpsertResult", { enumerable: true, get: function () { return CrudResult_1.CrudUpsertResult; } });
 // 分表创建器
 var ShardingTableCreator_1 = require("./ShardingTableCreator");
 Object.defineProperty(exports, "ShardingTableCreator", { enumerable: true, get: function () { return ShardingTableCreator_1.ShardingTableCreator; } });

package/dist/models/RedisKeys.d.ts

@@ -11,5 +11,6 @@ declare const RedisKeys: {
     CURD_MIX_BY_DICT_PREFIX: string;
     QUERY_ENUM_INFO_PREFIX: string;
     REDIS_LOCK_MIDDILEWARE: string;
+    TABLE_META_CACHE_INVALIDATE_CHANNEL: string;
 };
 export { RedisKeys };

package/dist/models/RedisKeys.js

@@ -14,5 +14,6 @@ const RedisKeys = {
     CURD_MIX_BY_DICT_PREFIX: 'FatCurdMixByDict@@',
     QUERY_ENUM_INFO_PREFIX: 'FatQueryEnum@@',
     REDIS_LOCK_MIDDILEWARE: 'FatRedisLock@@',
+    TABLE_META_CACHE_INVALIDATE_CHANNEL: 'FatTableMetaCacheInvalidate',
 };
 exports.RedisKeys = RedisKeys;

package/dist/models/bizmodels.d.ts

@@ -1,5 +1,6 @@
-import { IRequestCfgModel, IVisitor } from '../libs/crud-pro/interfaces';
+import { IVisitor } from '../libs/crud-pro/interfaces';
 import { CacheLevelEnum } from "../models/SystemEntities";
+export type { IRequestCfgModel2 } from '../libs/crud-pro-quick';
 export interface IAccountEntity {
     nick_name: string;
     avatar: string;
@@ -81,11 +82,6 @@ export declare const CTX_VISITOR_AVATAR = "visitor.avatar";
 export declare const CTX_VISITOR_NICKNAME = "visitor.nickName";
 export declare const CTX_VISITOR_ACCOUNT_TYPE = "visitor.accountType";
 export declare const CTX_WORKBENCH_CODE = "visitor.workbenchCode";
-export interface IRequestCfgModel2 extends IRequestCfgModel {
-    enableStandardUpdateCfg?: boolean | string[];
-    enableStandardUpdateCfgCondition?: boolean | string[];
-    enableSoftDelete?: boolean;
-}
 export interface IVisitorExt extends IVisitor {
     workbenchCode: string;
     avatar: string;

package/dist/service/SysAppService.d.ts

@@ -7,8 +7,8 @@ export declare class SysAppService extends BaseService {
     getSysAppPageOne({ page_path, workbench_code }: {
         page_path: string;
         workbench_code: string;
-    }): Promise<any>;
-    getSysAppOne(app_code: string): Promise<any>;
+    }): Promise<Record<string, any>>;
+    getSysAppOne(app_code: string): Promise<Record<string, any>>;
     deletePrivateField(parsedAppInfo: any): any;
     removeSysAppOneCache(app_code: string): Promise<any>;
     removeSysAppCacheByCondition({ condition }: any): Promise<void>;

package/dist/service/SysAppService.js

@@ -20,11 +20,19 @@ const bizmodels_1 = require("../models/bizmodels");
 let SysAppService = class SysAppService extends BaseService_1.BaseService {
     get sysAppDao() {
         const { SystemDbName, SystemDbType } = global_config_1.GLOBAL_STATIC_CONFIG.getConfig();
-        return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables_1.SystemTables.sys_app);
+        return this.curdProService.getQuickCrud({
+            sqlDatabase: SystemDbName,
+            sqlDbType: SystemDbType,
+            sqlTable: SystemTables_1.SystemTables.sys_app,
+        });
     }
     get sysAppPageDao() {
         const { SystemDbName, SystemDbType } = global_config_1.GLOBAL_STATIC_CONFIG.getConfig();
-        return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables_1.SystemTables.sys_app_page);
+        return this.curdProService.getQuickCrud({
+            sqlDatabase: SystemDbName,
+            sqlDbType: SystemDbType,
+            sqlTable: SystemTables_1.SystemTables.sys_app_page,
+        });
     }
     async getSysAppPageOne({ page_path, workbench_code }) {
         if (!page_path || typeof page_path !== 'string') {
@@ -37,9 +45,10 @@ let SysAppService = class SysAppService extends BaseService_1.BaseService {
             cacheKey: `${workbench_code}#${page_path}`,
             cacheName: bizmodels_1.CacheNameEnum.GetSysAppPageOne,
             getter: async () => {
-                return await this.sysAppPageDao.getUniqueOne({
+                const res = await this.sysAppPageDao.findOne({
                     condition: { page_path, workbench_code, deleted_at: 0 }
                 });
+                return res.row;
             },
         });
     }
@@ -51,9 +60,10 @@ let SysAppService = class SysAppService extends BaseService_1.BaseService {
             cacheKey: app_code,
             cacheName: bizmodels_1.CacheNameEnum.GetSysAppOne,
             getter: async () => {
-                return await this.sysAppDao.getUniqueOne({
+                const res = await this.sysAppDao.findOne({
                     condition: { app_code, deleted_at: 0 }
                 });
+                return res.row;
             },
         });
     }
@@ -85,10 +95,11 @@ let SysAppService = class SysAppService extends BaseService_1.BaseService {
         if (!condition) {
             throw new Error('[removeSysAppCacheByCondition] condition required');
         }
-        const appList = await this.sysAppDao.getList({
+        const res = await this.sysAppDao.findList({
             condition: condition,
             columns: ['id', 'app_code']
         });
+        const appList = res.rows;
         for (const app of appList) {
             await this.removeSysAppOneCache(app.app_code);
         }

package/dist/service/SysConfigService.d.ts

@@ -5,6 +5,6 @@ export declare class SysConfigService extends BaseService {
     private curdProService;
     private cacheServiceFactory;
     private get sysConfigsDao();
-    getSysConfigOne(config_code: string): Promise<any>;
+    getSysConfigOne(config_code: string): Promise<Record<string, any>>;
     removeSysConfigOneCache(config_code: string): Promise<any>;
 }

package/dist/service/SysConfigService.js

@@ -20,7 +20,11 @@ const CacheServiceFactory_1 = require("../service/base/cache/CacheServiceFactory
 let SysConfigService = class SysConfigService extends BaseService_1.BaseService {
     get sysConfigsDao() {
         const { SystemDbName, SystemDbType } = global_config_1.GLOBAL_STATIC_CONFIG.getConfig();
-        return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables_1.SystemTables.sys_configs);
+        return this.curdProService.getQuickCrud({
+            sqlDatabase: SystemDbName,
+            sqlDbType: SystemDbType,
+            sqlTable: SystemTables_1.SystemTables.sys_configs,
+        });
     }
     async getSysConfigOne(config_code) {
         if (!config_code || typeof config_code !== 'string') {
@@ -30,9 +34,10 @@ let SysConfigService = class SysConfigService extends BaseService_1.BaseService
             cacheKey: config_code,
             cacheName: bizmodels_1.CacheNameEnum.GetSysConfigOne,
             getter: async () => {
-                return await this.sysConfigsDao.getUniqueOne({
+                const res = await this.sysConfigsDao.findOne({
                     condition: { config_code, deleted_at: 0 }
                 });
+                return res.row;
             },
         });
     }

package/dist/service/SysDictDataService.js

@@ -20,11 +20,19 @@ const bizmodels_1 = require("../models/bizmodels");
 let SysDictDataService = class SysDictDataService extends BaseService_1.BaseService {
     get sys_data_dict_item() {
         const { SystemDbName, SystemDbType } = global_config_1.GLOBAL_STATIC_CONFIG.getConfig();
-        return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables_1.SystemTables.sys_data_dict_item);
+        return this.curdProService.getQuickCrud({
+            sqlDatabase: SystemDbName,
+            sqlDbType: SystemDbType,
+            sqlTable: SystemTables_1.SystemTables.sys_data_dict_item,
+        });
     }
     // private get sys_data_dict(){
     //   const { SystemDbName, SystemDbType } = GLOBAL_STATIC_CONFIG.getConfig();
-    //   return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables.sys_data_dict)
+    //   return this.curdProService.getQuickCrud({
+    //     sqlDatabase: SystemDbName,
+    //     sqlDbType: SystemDbType,
+    //     sqlTable: SystemTables.sys_data_dict,
+    //   })
     // }
     async getDataDictItemsByDictCode(dict_code) {
         if (!dict_code || typeof dict_code !== 'string') {
@@ -34,14 +42,16 @@ let SysDictDataService = class SysDictDataService extends BaseService_1.BaseServ
             cacheKey: dict_code,
             cacheName: bizmodels_1.CacheNameEnum.GetDataDictItemsByDictCode,
             getter: async () => {
-                return await this.sys_data_dict_item.getList({
+                const res = await this.sys_data_dict_item.findList({
                     condition: { dict_code, status: 1, deleted_at: 0 }
                 });
+                return res.rows;
             },
         });
     }
     async removeCacheByDictItemId(dict_item_id) {
-        const dictItemObj = await this.sys_data_dict_item.getUniqueOne({ condition: { id: dict_item_id } });
+        const res = await this.sys_data_dict_item.findOne({ condition: { id: dict_item_id } });
+        const dictItemObj = res.row;
         return this.removeCacheByDictCode(dictItemObj['dict_code']);
     }
     // public async removeCacheByDictId(dict_id: string) {

package/dist/service/SysMenuService.js

@@ -20,7 +20,11 @@ const bizmodels_1 = require("../models/bizmodels");
 let SysMenuService = class SysMenuService extends BaseService_1.BaseService {
     get sys_menus_table() {
         const { SystemDbName, SystemDbType } = global_config_1.GLOBAL_STATIC_CONFIG.getConfig();
-        return this.curdProService.getQuickCrud(SystemDbName, SystemDbType, SystemTables_1.SystemTables.sys_menus);
+        return this.curdProService.getQuickCrud({
+            sqlDatabase: SystemDbName,
+            sqlDbType: SystemDbType,
+            sqlTable: SystemTables_1.SystemTables.sys_menus,
+        });
     }
     /**
      * 获取所有菜单列表
@@ -31,9 +35,10 @@ let SysMenuService = class SysMenuService extends BaseService_1.BaseService {
             cacheKey: bizmodels_1.CacheNameEnum.GetSysMenusList,
             cacheName: bizmodels_1.CacheNameEnum.GetSysMenusList,
             getter: async () => {
-                return await this.sys_menus_table.getList({
+                const res = await this.sys_menus_table.findList({
                     condition: {}
                 });
+                return res.rows;
             },
         });
     }

package/dist/service/TableMetaCacheRedisSubscriber.d.ts

@@ -0,0 +1,31 @@
+import { RedisService } from '@midwayjs/redis';
+/**
+ * 初始化发布客户端
+ *
+ * 在 Midway 容器初始化完成后调用，注入已有的 RedisService 实例
+ * @param client RedisService 实例
+ */
+export declare function initTableMetaCachePublishClient(client: RedisService): void;
+/**
+ * 初始化 Redis 订阅，监听缓存失效广播
+ *
+ * 使用 RedisService.duplicate() 创建独立的订阅连接。
+ * 收到广播后自动清空本节点的本地缓存。
+ *
+ * @param mainClient 已有的 RedisService 实例，用于 duplicate 出订阅连接
+ */
+export declare function initTableMetaCacheSubscriber(mainClient: RedisService): void;
+/**
+ * 清空本节点缓存并广播通知集群中其他节点
+ *
+ * 调用流程：
+ * 1. 清空本节点本地缓存
+ * 2. 通过 Redis PUBLISH 广播消息
+ * 3. 其他节点收到消息后清空各自的本地缓存
+ *
+ * @returns 清空前的缓存统计
+ */
+export declare function clearTableMetaCacheWithBroadcast(): {
+    metaCacheCount: number;
+    tableInfoCacheCount: number;
+};

package/dist/service/TableMetaCacheRedisSubscriber.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearTableMetaCacheWithBroadcast = exports.initTableMetaCacheSubscriber = exports.initTableMetaCachePublishClient = void 0;
+const CrudProTableMetaService_1 = require("../libs/crud-pro/services/CrudProTableMetaService");
+const RedisKeys_1 = require("../models/RedisKeys");
+const CHANNEL = RedisKeys_1.RedisKeys.TABLE_META_CACHE_INVALIDATE_CHANNEL;
+/**
+ * 本节点唯一标识，用于区分是自己发出的广播还是其他节点发出的
+ * 避免重复清空（本节点已在发布前清空过）
+ */
+const NODE_ID = `node_${process.pid}_${Date.now()}`;
+/**
+ * 用于发布消息的 Redis 客户端（复用 @midwayjs/redis 注入的实例）
+ */
+let publishClient = null;
+/**
+ * 用于订阅的 Redis 客户端（独立连接，ioredis 规定订阅连接不能执行普通命令）
+ */
+let subscribeClient = null;
+/**
+ * 初始化发布客户端
+ *
+ * 在 Midway 容器初始化完成后调用，注入已有的 RedisService 实例
+ * @param client RedisService 实例
+ */
+function initTableMetaCachePublishClient(client) {
+    publishClient = client;
+}
+exports.initTableMetaCachePublishClient = initTableMetaCachePublishClient;
+/**
+ * 初始化 Redis 订阅，监听缓存失效广播
+ *
+ * 使用 RedisService.duplicate() 创建独立的订阅连接。
+ * 收到广播后自动清空本节点的本地缓存。
+ *
+ * @param mainClient 已有的 RedisService 实例，用于 duplicate 出订阅连接
+ */
+function initTableMetaCacheSubscriber(mainClient) {
+    if (subscribeClient) {
+        return; // 防止重复初始化
+    }
+    // duplicate() 创建一个同配置的独立连接
+    subscribeClient = mainClient.duplicate();
+    subscribeClient.subscribe(CHANNEL).catch((err) => {
+        console.error('[TableMetaCacheRedis] subscribe failed:', err.message);
+    });
+    subscribeClient.on('message', (channel, message) => {
+        if (channel !== CHANNEL)
+            return;
+        try {
+            const data = JSON.parse(message);
+            // 跳过自己发出的广播（本节点已在发布前清空过）
+            if (data.nodeId === NODE_ID)
+                return;
+            const stats = (0, CrudProTableMetaService_1.clearTableMetaCache)();
+            console.info(`[TableMetaCacheRedis] 收到其他节点(${data.nodeId})的缓存清空广播，已清空本地缓存:`, stats);
+        }
+        catch (e) {
+            console.error('[TableMetaCacheRedis] 处理缓存失效广播异常:', e);
+        }
+    });
+    subscribeClient.on('error', (err) => {
+        console.error('[TableMetaCacheRedis] subscriber connection error:', err.message);
+    });
+    console.info('[TableMetaCacheRedis] 订阅已启动，监听频道:', CHANNEL);
+}
+exports.initTableMetaCacheSubscriber = initTableMetaCacheSubscriber;
+/**
+ * 清空本节点缓存并广播通知集群中其他节点
+ *
+ * 调用流程：
+ * 1. 清空本节点本地缓存
+ * 2. 通过 Redis PUBLISH 广播消息
+ * 3. 其他节点收到消息后清空各自的本地缓存
+ *
+ * @returns 清空前的缓存统计
+ */
+function clearTableMetaCacheWithBroadcast() {
+    // 1. 清空本节点缓存
+    const stats = (0, CrudProTableMetaService_1.clearTableMetaCache)();
+    // 2. 广播通知其他节点
+    if (publishClient && typeof publishClient.publish === 'function') {
+        const message = JSON.stringify({
+            nodeId: NODE_ID,
+            timestamp: Date.now(),
+            beforeClear: stats,
+        });
+        publishClient.publish(CHANNEL, message).catch((err) => {
+            console.error('[TableMetaCacheRedis] publish failed:', err.message);
+        });
+    }
+    else {
+        // 没有 Redis 连接时仅清空本地（单节点部署降级）
+        console.info('[TableMetaCacheRedis] 无 Redis 发布客户端，仅清空本节点缓存');
+    }
+    return stats;
+}
+exports.clearTableMetaCacheWithBroadcast = clearTableMetaCacheWithBroadcast;

package/dist/service/curd/CurdMixService.d.ts

@@ -1,7 +1,8 @@
-import { ColumnRelation, IRequestCfgModel, IRequestModel, ISqlCfgModel, ITableListResult, ITableNamesOptions, ITableNamesQuery } from '../../libs/crud-pro/interfaces';
+import { ColumnRelation, IRequestCfgModel, IRequestModel, ISqlCfgModel, ITableListResult, ITableNamesOptions, ITableNamesQuery, ExecuteSQLResult } from '../../libs/crud-pro/interfaces';
 import { IRequestCfgModel2 } from '../../models/bizmodels';
-import { SqlDbType } from '../../libs/crud-pro/models/keys';
 import { ExecuteContext } from '../../libs/crud-pro/models/ExecuteContext';
+import { ShardingBase } from "../../libs/crud-sharding";
+import { IGetQuickCrudParam, IGetShardingCrudParam } from './CurdProService';
 export interface ILinkColumnRelationParam {
     columnsRelations: ColumnRelation[];
 }
@@ -14,8 +15,9 @@ export declare class CurdMixService {
     private curdMixByLinkToCustomService;
     private prepare;
     executeCrudByCfg(reqJson: IRequestModel, cfgModel: IRequestCfgModel2): Promise<ExecuteContext>;
-    getBbUtil(sqlDatabase: string, sqlDbType: SqlDbType, sqlTable?: string): import("./CrudProQuick").CrudProQuick;
-    executeSQL(sqlCfgModel: ISqlCfgModel): Promise<any>;
+    getQuickCrud(param: IGetQuickCrudParam): import("../..").CrudProQuick;
+    getShardingCrud(param: IGetShardingCrudParam): ShardingBase;
+    executeSQL(sqlCfgModel: ISqlCfgModel): Promise<ExecuteSQLResult>;
     executeCrud(reqJson: IRequestModel): Promise<ExecuteContext>;
     getCachedCfgByMethod(method: string): Promise<IRequestCfgModel>;
     /**

package/dist/service/curd/CurdMixService.js

@@ -30,9 +30,23 @@ let CurdMixService = class CurdMixService {
         this.prepare();
         return this.curdProService.executeCrudByCfg(reqJson, cfgModel);
     }
-    getBbUtil(sqlDatabase, sqlDbType, sqlTable) {
+    // /**
+    //  * @deprecated 请使用 getQuickCrud 替代
+    //  * @param sqlDatabase
+    //  * @param sqlDbType
+    //  * @param sqlTable
+    //  */
+    // getBbUtil(sqlDatabase: string, sqlDbType: SqlDbType, sqlTable?: string) {
+    //   this.prepare();
+    //   return this.curdProService.getQuickCrud({ sqlDatabase, sqlDbType, sqlTable });
+    // }
+    getQuickCrud(param) {
         this.prepare();
-        return this.curdProService.getQuickCrud(sqlDatabase, sqlDbType, sqlTable);
+        return this.curdProService.getQuickCrud(param);
+    }
+    getShardingCrud(param) {
+        this.prepare();
+        return this.curdProService.getShardingCrud(param);
     }
     async executeSQL(sqlCfgModel) {
         this.prepare();