@dofe/infra-common 0.1.1

package/dist/decorators/cache/cache.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.module.js","sourceRoot":"","sources":["../../../src/decorators/cache/cache.module.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;AAEH,2CAAgD;AAChD,uCAA+C;AAC/C,mDAAgD;AAChD,2DAAuD;AAahD,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;CAAG,CAAA;AAAvB,oDAAoB;+BAApB,oBAAoB;IAXhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,yBAAW,CAAC;QACtB,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,sBAAe;gBACxB,QAAQ,EAAE,oCAAgB;aAC3B;SACF;QACD,OAAO,EAAE,EAAE;KACZ,CAAC;GACW,oBAAoB,CAAG"}

package/dist/decorators/cache/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cache Decorators Module Exports
+ */
+export { Cacheable, CacheEvict, CachePut, CacheOptions, CacheEvictOptions, HierarchicalKeyConfig, defaultKeyGenerator, objectKeyGenerator, compositeKeyGenerator, hierarchicalKeyGenerator, simpleHierarchicalKeyGenerator, userKeyGenerator, spaceKeyGenerator, hashObject, hashParams, CACHE_METADATA_KEY, CACHE_EVICT_METADATA_KEY, CACHE_PUT_METADATA_KEY, } from './cache.decorator';
+export { CacheInterceptor } from './cache.interceptor';
+export { CacheDecoratorModule } from './cache.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/cache/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,SAAS,EACT,UAAU,EACV,QAAQ,EAER,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EAErB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EAErB,wBAAwB,EACxB,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACV,UAAU,EAEV,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/decorators/cache/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Cache Decorators Module Exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheDecoratorModule = exports.CacheInterceptor = exports.CACHE_PUT_METADATA_KEY = exports.CACHE_EVICT_METADATA_KEY = exports.CACHE_METADATA_KEY = exports.hashParams = exports.hashObject = exports.spaceKeyGenerator = exports.userKeyGenerator = exports.simpleHierarchicalKeyGenerator = exports.hierarchicalKeyGenerator = exports.compositeKeyGenerator = exports.objectKeyGenerator = exports.defaultKeyGenerator = exports.CachePut = exports.CacheEvict = exports.Cacheable = void 0;
+var cache_decorator_1 = require("./cache.decorator");
+// Decorators
+Object.defineProperty(exports, "Cacheable", { enumerable: true, get: function () { return cache_decorator_1.Cacheable; } });
+Object.defineProperty(exports, "CacheEvict", { enumerable: true, get: function () { return cache_decorator_1.CacheEvict; } });
+Object.defineProperty(exports, "CachePut", { enumerable: true, get: function () { return cache_decorator_1.CachePut; } });
+// Key Generators - Basic
+Object.defineProperty(exports, "defaultKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.defaultKeyGenerator; } });
+Object.defineProperty(exports, "objectKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.objectKeyGenerator; } });
+Object.defineProperty(exports, "compositeKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.compositeKeyGenerator; } });
+// Key Generators - Hierarchical (支持分层缓存)
+Object.defineProperty(exports, "hierarchicalKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.hierarchicalKeyGenerator; } });
+Object.defineProperty(exports, "simpleHierarchicalKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.simpleHierarchicalKeyGenerator; } });
+Object.defineProperty(exports, "userKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.userKeyGenerator; } });
+Object.defineProperty(exports, "spaceKeyGenerator", { enumerable: true, get: function () { return cache_decorator_1.spaceKeyGenerator; } });
+// Hash Utilities
+Object.defineProperty(exports, "hashObject", { enumerable: true, get: function () { return cache_decorator_1.hashObject; } });
+Object.defineProperty(exports, "hashParams", { enumerable: true, get: function () { return cache_decorator_1.hashParams; } });
+// Metadata Keys
+Object.defineProperty(exports, "CACHE_METADATA_KEY", { enumerable: true, get: function () { return cache_decorator_1.CACHE_METADATA_KEY; } });
+Object.defineProperty(exports, "CACHE_EVICT_METADATA_KEY", { enumerable: true, get: function () { return cache_decorator_1.CACHE_EVICT_METADATA_KEY; } });
+Object.defineProperty(exports, "CACHE_PUT_METADATA_KEY", { enumerable: true, get: function () { return cache_decorator_1.CACHE_PUT_METADATA_KEY; } });
+var cache_interceptor_1 = require("./cache.interceptor");
+Object.defineProperty(exports, "CacheInterceptor", { enumerable: true, get: function () { return cache_interceptor_1.CacheInterceptor; } });
+var cache_module_1 = require("./cache.module");
+Object.defineProperty(exports, "CacheDecoratorModule", { enumerable: true, get: function () { return cache_module_1.CacheDecoratorModule; } });
+//# sourceMappingURL=index.js.map

package/dist/decorators/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/cache/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAyB2B;AAxBzB,aAAa;AACb,4GAAA,SAAS,OAAA;AACT,6GAAA,UAAU,OAAA;AACV,2GAAA,QAAQ,OAAA;AAKR,yBAAyB;AACzB,sHAAA,mBAAmB,OAAA;AACnB,qHAAA,kBAAkB,OAAA;AAClB,wHAAA,qBAAqB,OAAA;AACrB,yCAAyC;AACzC,2HAAA,wBAAwB,OAAA;AACxB,iIAAA,8BAA8B,OAAA;AAC9B,mHAAA,gBAAgB,OAAA;AAChB,oHAAA,iBAAiB,OAAA;AACjB,iBAAiB;AACjB,6GAAA,UAAU,OAAA;AACV,6GAAA,UAAU,OAAA;AACV,gBAAgB;AAChB,qHAAA,kBAAkB,OAAA;AAClB,2HAAA,wBAAwB,OAAA;AACxB,yHAAA,sBAAsB,OAAA;AAGxB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,+CAAsD;AAA7C,oHAAA,oBAAoB,OAAA"}

package/dist/decorators/data-visibility/data-visibility.decorator.d.ts

@@ -0,0 +1,74 @@
+import type { ResourceType, Permission } from '@dofe/infra-contracts';
+/**
+ * 数据可见性元数据键
+ */
+export declare const DATA_VISIBILITY_KEY = "data_visibility_resource_type";
+/**
+ * 数据可见性装饰器
+ *
+ * 标记端点需要注入数据可见性范围，自动根据用户角色解析 DataScope
+ *
+ * @param resourceType 资源类型
+ *
+ * @example
+ * ```typescript
+ * @DataVisibility('bot')
+ * async listBots(@ReqDataScope() scope: DataScope) {
+ *   // scope 已自动注入
+ *   return this.botService.list({ ...scope });
+ * }
+ * ```
+ */
+export declare const DataVisibility: (resourceType: ResourceType) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+/**
+ * 数据可见性参数装饰器
+ *
+ * 从请求中提取已解析的数据可见性范围
+ *
+ * @example
+ * ```typescript
+ * async list(@ReqDataScope() scope: DataScope) {
+ *   // scope.type: 'tenant' | 'department_tree' | 'department' | 'team' | 'user'
+ *   // scope.departmentIds, scope.teamIds, scope.userId 根据类型不同而不同
+ * }
+ * ```
+ */
+export declare const ReqDataScope: (...dataOrPipes: unknown[]) => ParameterDecorator;
+/**
+ * 组织权限 API 装饰器
+ *
+ * 组合认证、租户上下文、权限检查和数据可见性注入
+ * 适用于需要基于组织架构进行数据隔离的 API
+ *
+ * @param permissions 需要的权限
+ * @param resourceType 资源类型（用于数据可见性）
+ *
+ * @example
+ * ```typescript
+ * @OrganizationApi(PERMISSION.BOT_READ, 'bot')
+ * async listBots(@ReqDataScope() scope: DataScope) {
+ *   return this.botService.list(scope);
+ * }
+ * ```
+ */
+export declare const OrganizationApi: (permissions: Permission | Permission[], resourceType: ResourceType) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+/**
+ * 安全资源装饰器
+ *
+ * 组合权限检查和数据可见性注入
+ * 等同于设计文档中的 SecureResource
+ *
+ * @param permissions 需要的权限
+ * @param resourceType 资源类型（用于数据可见性）
+ *
+ * @example
+ * ```typescript
+ * @SecureResource(['bot:delete'], 'bot')
+ * async deleteBot(@ReqDataScope() scope: DataScope) {
+ *   // 先检查权限，再检查数据归属
+ *   return this.botService.delete(scope);
+ * }
+ * ```
+ */
+export declare const SecureResource: (permissions: Permission | Permission[], resourceType: ResourceType) => <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;
+//# sourceMappingURL=data-visibility.decorator.d.ts.map

package/dist/decorators/data-visibility/data-visibility.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-visibility.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/data-visibility/data-visibility.decorator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAa,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOjF;;GAEG;AACH,eAAO,MAAM,mBAAmB,kCAAkC,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,YAAY,gJAItD,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,mDAKxB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,UAAU,GAAG,UAAU,EAAE,EACtC,cAAc,YAAY,gJAczB,CAAC;AAEJ;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,gBAnCZ,UAAU,GAAG,UAAU,EAAE,gBACxB,YAAY,gJAkCiB,CAAC"}

package/dist/decorators/data-visibility/data-visibility.decorator.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecureResource = exports.OrganizationApi = exports.ReqDataScope = exports.DataVisibility = exports.DATA_VISIBILITY_KEY = void 0;
+const common_1 = require("@nestjs/common");
+const infra_contracts_1 = require("@dofe/infra-contracts");
+const guards_1 = require("@/common/guards");
+const tenant_context_guard_1 = require("@/common/guards/tenant-context.guard");
+const permission_guard_1 = require("@/common/guards/permission.guard");
+const data_visibility_guard_1 = require("@/common/guards/data-visibility.guard");
+/**
+ * 数据可见性元数据键
+ */
+exports.DATA_VISIBILITY_KEY = 'data_visibility_resource_type';
+/**
+ * 数据可见性装饰器
+ *
+ * 标记端点需要注入数据可见性范围，自动根据用户角色解析 DataScope
+ *
+ * @param resourceType 资源类型
+ *
+ * @example
+ * ```typescript
+ * @DataVisibility('bot')
+ * async listBots(@ReqDataScope() scope: DataScope) {
+ *   // scope 已自动注入
+ *   return this.botService.list({ ...scope });
+ * }
+ * ```
+ */
+const DataVisibility = (resourceType) => (0, common_1.applyDecorators)((0, common_1.SetMetadata)(exports.DATA_VISIBILITY_KEY, resourceType), (0, common_1.UseGuards)(guards_1.AuthGuard, tenant_context_guard_1.TenantContextGuard, data_visibility_guard_1.DataVisibilityGuard));
+exports.DataVisibility = DataVisibility;
+/**
+ * 数据可见性参数装饰器
+ *
+ * 从请求中提取已解析的数据可见性范围
+ *
+ * @example
+ * ```typescript
+ * async list(@ReqDataScope() scope: DataScope) {
+ *   // scope.type: 'tenant' | 'department_tree' | 'department' | 'team' | 'user'
+ *   // scope.departmentIds, scope.teamIds, scope.userId 根据类型不同而不同
+ * }
+ * ```
+ */
+exports.ReqDataScope = (0, common_1.createParamDecorator)((_data, ctx) => {
+    const request = ctx.switchToHttp().getRequest();
+    return request.dataScope;
+});
+/**
+ * 组织权限 API 装饰器
+ *
+ * 组合认证、租户上下文、权限检查和数据可见性注入
+ * 适用于需要基于组织架构进行数据隔离的 API
+ *
+ * @param permissions 需要的权限
+ * @param resourceType 资源类型（用于数据可见性）
+ *
+ * @example
+ * ```typescript
+ * @OrganizationApi(PERMISSION.BOT_READ, 'bot')
+ * async listBots(@ReqDataScope() scope: DataScope) {
+ *   return this.botService.list(scope);
+ * }
+ * ```
+ */
+const OrganizationApi = (permissions, resourceType) => (0, common_1.applyDecorators)((0, common_1.SetMetadata)(infra_contracts_1.REQUIRE_PERMISSIONS_KEY, Array.isArray(permissions) ? permissions : [permissions]), (0, common_1.SetMetadata)(exports.DATA_VISIBILITY_KEY, resourceType), (0, common_1.UseGuards)(guards_1.AuthGuard, tenant_context_guard_1.TenantContextGuard, permission_guard_1.PermissionGuard, data_visibility_guard_1.DataVisibilityGuard));
+exports.OrganizationApi = OrganizationApi;
+/**
+ * 安全资源装饰器
+ *
+ * 组合权限检查和数据可见性注入
+ * 等同于设计文档中的 SecureResource
+ *
+ * @param permissions 需要的权限
+ * @param resourceType 资源类型（用于数据可见性）
+ *
+ * @example
+ * ```typescript
+ * @SecureResource(['bot:delete'], 'bot')
+ * async deleteBot(@ReqDataScope() scope: DataScope) {
+ *   // 先检查权限，再检查数据归属
+ *   return this.botService.delete(scope);
+ * }
+ * ```
+ */
+exports.SecureResource = exports.OrganizationApi;
+//# sourceMappingURL=data-visibility.decorator.js.map

package/dist/decorators/data-visibility/data-visibility.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-visibility.decorator.js","sourceRoot":"","sources":["../../../src/decorators/data-visibility/data-visibility.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAMwB;AAExB,2DAAgE;AAChE,4CAA4C;AAC5C,+EAA0E;AAC1E,uEAAmE;AACnE,iFAA4E;AAE5E;;GAEG;AACU,QAAA,mBAAmB,GAAG,+BAA+B,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACI,MAAM,cAAc,GAAG,CAAC,YAA0B,EAAE,EAAE,CAC3D,IAAA,wBAAe,EACb,IAAA,oBAAW,EAAC,2BAAmB,EAAE,YAAY,CAAC,EAC9C,IAAA,kBAAS,EAAC,kBAAS,EAAE,yCAAkB,EAAE,2CAAmB,CAAC,CAC9D,CAAC;AAJS,QAAA,cAAc,kBAIvB;AAEJ;;;;;;;;;;;;GAYG;AACU,QAAA,YAAY,GAAG,IAAA,6BAAoB,EAC9C,CAAC,KAAc,EAAE,GAAqB,EAAyB,EAAE;IAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;IAChD,OAAO,OAAO,CAAC,SAAS,CAAC;AAC3B,CAAC,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,eAAe,GAAG,CAC7B,WAAsC,EACtC,YAA0B,EAC1B,EAAE,CACF,IAAA,wBAAe,EACb,IAAA,oBAAW,EACT,yCAAuB,EACvB,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CACzD,EACD,IAAA,oBAAW,EAAC,2BAAmB,EAAE,YAAY,CAAC,EAC9C,IAAA,kBAAS,EACP,kBAAS,EACT,yCAAkB,EAClB,kCAAe,EACf,2CAAmB,CACpB,CACF,CAAC;AAhBS,QAAA,eAAe,mBAgBxB;AAEJ;;;;;;;;;;;;;;;;;GAiBG;AACU,QAAA,cAAc,GAAG,uBAAe,CAAC"}

package/dist/decorators/data-visibility/index.d.ts

@@ -0,0 +1,2 @@
+export * from './data-visibility.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/decorators/data-visibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/decorators/data-visibility/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/decorators/data-visibility/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./data-visibility.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/data-visibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/data-visibility/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C"}

package/dist/decorators/event/event.decorator.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Event Decorators
+ *
+ * 提供方法级别的事件装饰器，用于解耦业务逻辑。
+ * 支持同步和异步事件触发，与 NestJS EventEmitter 深度融合。
+ *
+ * @example
+ * ```typescript
+ * // 触发事件 - 方法执行后触发
+ * @EmitEvent('user.updated')
+ * async updateUser(userId: string, data: any) { ... }
+ *
+ * // 监听事件
+ * @OnEvent('user.updated')
+ * async handleUserUpdated(payload: UserUpdatedPayload) { ... }
+ *
+ * // 条件触发
+ * @EmitEvent('user.created', { condition: (result) => result !== null })
+ * async createUser(data: any) { ... }
+ * ```
+ */
+export declare const EMIT_EVENT_METADATA_KEY = "event:emit";
+export declare const EMIT_EVENTS_METADATA_KEY = "event:emit:multiple";
+/**
+ * 系统事件名称常量
+ * 使用点号分隔的命名约定: domain.action
+ */
+export declare const EventNames: {
+    readonly USER: {
+        readonly CREATED: "user.created";
+        readonly UPDATED: "user.updated";
+        readonly DELETED: "user.deleted";
+        readonly LOGIN: "user.login";
+        readonly LOGOUT: "user.logout";
+        readonly PASSWORD_CHANGED: "user.password.changed";
+    };
+    readonly CACHE: {
+        readonly INVALIDATED: "cache.invalidated";
+        readonly REFRESHED: "cache.refreshed";
+    };
+    readonly AUTH: {
+        readonly TOKEN_CREATED: "auth.token.created";
+        readonly TOKEN_REFRESHED: "auth.token.refreshed";
+        readonly TOKEN_REVOKED: "auth.token.revoked";
+    };
+};
+/**
+ * 事件发射配置选项
+ */
+export interface EmitEventOptions {
+    /** 事件名称 */
+    eventName: string;
+    /**
+     * 是否异步触发 (不阻塞方法返回)
+     * 默认: true
+     */
+    async?: boolean;
+    /**
+     * 是否在方法执行前触发
+     * 默认: false (方法执行后触发)
+     */
+    beforeInvocation?: boolean;
+    /**
+     * 条件表达式 - 决定是否触发事件
+     * 接收方法返回值，返回 true 则触发
+     * 默认: 总是触发
+     */
+    condition?: (result: any, args: any[]) => boolean;
+    /**
+     * 自定义 payload 生成器
+     * 接收方法参数和返回值，返回事件 payload
+     * 默认: { args, result }
+     */
+    payloadGenerator?: (args: any[], result: any) => any;
+}
+/**
+ * 事件 Payload 基础类型
+ */
+export interface BaseEventPayload<T = any> {
+    /** 事件触发时间 */
+    timestamp: Date;
+    /** 方法参数 */
+    args: any[];
+    /** 方法返回值 */
+    result: T;
+    /** 额外上下文 */
+    context?: Record<string, any>;
+}
+/**
+ * @EmitEvent - 方法执行后触发事件
+ *
+ * @param eventName - 事件名称
+ * @param options - 可选配置
+ *
+ * @example
+ * ```typescript
+ * @EmitEvent(EventNames.USER.UPDATED)
+ * async updateUser(userId: string, data: any) {
+ *     return await this.prisma.userInfo.update({ where: { id: userId }, data });
+ * }
+ *
+ * @EmitEvent(EventNames.USER.CREATED, {
+ *     condition: (result) => result !== null,
+ *     payloadGenerator: (args, result) => ({ userId: result.id, email: result.email }),
+ * })
+ * async createUser(data: CreateUserDto) { ... }
+ * ```
+ */
+export declare function EmitEvent(eventName: string, options?: Partial<Omit<EmitEventOptions, 'eventName'>>): MethodDecorator;
+/**
+ * @EmitEvents - 方法执行后触发多个事件
+ *
+ * @param events - 事件配置数组
+ *
+ * @example
+ * ```typescript
+ * @EmitEvents([
+ *     { eventName: EventNames.USER.UPDATED },
+ *     { eventName: EventNames.CACHE.INVALIDATED, payloadGenerator: (args) => ({ key: `user:${args[0]}` }) },
+ * ])
+ * async updateUser(userId: string, data: any) { ... }
+ * ```
+ */
+export declare function EmitEvents(events: Array<{
+    eventName: string;
+    options?: Partial<Omit<EmitEventOptions, 'eventName'>>;
+}>): MethodDecorator;
+/**
+ * 默认 payload 生成器
+ */
+export declare function defaultPayloadGenerator(args: any[], result: any): BaseEventPayload;
+/**
+ * 用户事件 payload 生成器
+ */
+export declare function userEventPayloadGenerator(args: any[], result: any): {
+    timestamp: Date;
+    userId: any;
+    user: any;
+    args: any[];
+    result: any;
+};
+/**
+ * 缓存失效事件 payload 生成器
+ */
+export declare function cacheInvalidatePayloadGenerator(cacheName: string, keyGenerator?: (...args: any[]) => string): (args: any[], result: any) => {
+    timestamp: Date;
+    cacheName: string;
+    cacheKey: any;
+    args: any[];
+    result: any;
+};
+//# sourceMappingURL=event.decorator.d.ts.map

package/dist/decorators/event/event.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/event/event.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,eAAO,MAAM,uBAAuB,eAAe,CAAC;AACpD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAM9D;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;CAqBb,CAAC;AAMX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;IAElD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,GAAG;IACvC,aAAa;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW;IACX,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,YAAY;IACZ,MAAM,EAAE,CAAC,CAAC;IACV,YAAY;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,GACrD,eAAe,CASjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC;CACxD,CAAC,GACD,eAAe,CASjB;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,EAAE,GAAG,GACV,gBAAgB,CAMlB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG;;;;;;EASjE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,IAEjC,MAAM,GAAG,EAAE,EAAE,QAAQ,GAAG;;;;;;EAOjC"}

package/dist/decorators/event/event.decorator.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Event Decorators
+ *
+ * 提供方法级别的事件装饰器，用于解耦业务逻辑。
+ * 支持同步和异步事件触发，与 NestJS EventEmitter 深度融合。
+ *
+ * @example
+ * ```typescript
+ * // 触发事件 - 方法执行后触发
+ * @EmitEvent('user.updated')
+ * async updateUser(userId: string, data: any) { ... }
+ *
+ * // 监听事件
+ * @OnEvent('user.updated')
+ * async handleUserUpdated(payload: UserUpdatedPayload) { ... }
+ *
+ * // 条件触发
+ * @EmitEvent('user.created', { condition: (result) => result !== null })
+ * async createUser(data: any) { ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventNames = exports.EMIT_EVENTS_METADATA_KEY = exports.EMIT_EVENT_METADATA_KEY = void 0;
+exports.EmitEvent = EmitEvent;
+exports.EmitEvents = EmitEvents;
+exports.defaultPayloadGenerator = defaultPayloadGenerator;
+exports.userEventPayloadGenerator = userEventPayloadGenerator;
+exports.cacheInvalidatePayloadGenerator = cacheInvalidatePayloadGenerator;
+const common_1 = require("@nestjs/common");
+// ============================================================================
+// Metadata Keys
+// ============================================================================
+exports.EMIT_EVENT_METADATA_KEY = 'event:emit';
+exports.EMIT_EVENTS_METADATA_KEY = 'event:emit:multiple';
+// ============================================================================
+// Event Names (建议统一在此定义)
+// ============================================================================
+/**
+ * 系统事件名称常量
+ * 使用点号分隔的命名约定: domain.action
+ */
+exports.EventNames = {
+    // 用户相关事件
+    USER: {
+        CREATED: 'user.created',
+        UPDATED: 'user.updated',
+        DELETED: 'user.deleted',
+        LOGIN: 'user.login',
+        LOGOUT: 'user.logout',
+        PASSWORD_CHANGED: 'user.password.changed',
+    },
+    // 缓存相关事件
+    CACHE: {
+        INVALIDATED: 'cache.invalidated',
+        REFRESHED: 'cache.refreshed',
+    },
+    // 认证相关事件
+    AUTH: {
+        TOKEN_CREATED: 'auth.token.created',
+        TOKEN_REFRESHED: 'auth.token.refreshed',
+        TOKEN_REVOKED: 'auth.token.revoked',
+    },
+};
+// ============================================================================
+// Decorators
+// ============================================================================
+/**
+ * @EmitEvent - 方法执行后触发事件
+ *
+ * @param eventName - 事件名称
+ * @param options - 可选配置
+ *
+ * @example
+ * ```typescript
+ * @EmitEvent(EventNames.USER.UPDATED)
+ * async updateUser(userId: string, data: any) {
+ *     return await this.prisma.userInfo.update({ where: { id: userId }, data });
+ * }
+ *
+ * @EmitEvent(EventNames.USER.CREATED, {
+ *     condition: (result) => result !== null,
+ *     payloadGenerator: (args, result) => ({ userId: result.id, email: result.email }),
+ * })
+ * async createUser(data: CreateUserDto) { ... }
+ * ```
+ */
+function EmitEvent(eventName, options) {
+    const eventOptions = {
+        eventName,
+        async: true,
+        beforeInvocation: false,
+        ...options,
+    };
+    return (0, common_1.SetMetadata)(exports.EMIT_EVENT_METADATA_KEY, eventOptions);
+}
+/**
+ * @EmitEvents - 方法执行后触发多个事件
+ *
+ * @param events - 事件配置数组
+ *
+ * @example
+ * ```typescript
+ * @EmitEvents([
+ *     { eventName: EventNames.USER.UPDATED },
+ *     { eventName: EventNames.CACHE.INVALIDATED, payloadGenerator: (args) => ({ key: `user:${args[0]}` }) },
+ * ])
+ * async updateUser(userId: string, data: any) { ... }
+ * ```
+ */
+function EmitEvents(events) {
+    const eventConfigs = events.map((e) => ({
+        eventName: e.eventName,
+        async: true,
+        beforeInvocation: false,
+        ...e.options,
+    }));
+    return (0, common_1.SetMetadata)(exports.EMIT_EVENTS_METADATA_KEY, eventConfigs);
+}
+// ============================================================================
+// Payload Generators
+// ============================================================================
+/**
+ * 默认 payload 生成器
+ */
+function defaultPayloadGenerator(args, result) {
+    return {
+        timestamp: new Date(),
+        args,
+        result,
+    };
+}
+/**
+ * 用户事件 payload 生成器
+ */
+function userEventPayloadGenerator(args, result) {
+    const userId = args[0];
+    return {
+        timestamp: new Date(),
+        userId,
+        user: result,
+        args,
+        result,
+    };
+}
+/**
+ * 缓存失效事件 payload 生成器
+ */
+function cacheInvalidatePayloadGenerator(cacheName, keyGenerator) {
+    return (args, result) => ({
+        timestamp: new Date(),
+        cacheName,
+        cacheKey: keyGenerator ? keyGenerator(...args) : args[0],
+        args,
+        result,
+    });
+}
+//# sourceMappingURL=event.decorator.js.map

package/dist/decorators/event/event.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.decorator.js","sourceRoot":"","sources":["../../../src/decorators/event/event.decorator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAsHH,8BAYC;AAgBD,gCAcC;AASD,0DASC;AAKD,8DASC;AAKD,0EAWC;AA9MD,2CAA6C;AAE7C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAElE,QAAA,uBAAuB,GAAG,YAAY,CAAC;AACvC,QAAA,wBAAwB,GAAG,qBAAqB,CAAC;AAE9D,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;GAGG;AACU,QAAA,UAAU,GAAG;IACxB,SAAS;IACT,IAAI,EAAE;QACJ,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,aAAa;QACrB,gBAAgB,EAAE,uBAAuB;KAC1C;IACD,SAAS;IACT,KAAK,EAAE;QACL,WAAW,EAAE,mBAAmB;QAChC,SAAS,EAAE,iBAAiB;KAC7B;IACD,SAAS;IACT,IAAI,EAAE;QACJ,aAAa,EAAE,oBAAoB;QACnC,eAAe,EAAE,sBAAsB;QACvC,aAAa,EAAE,oBAAoB;KACpC;CACO,CAAC;AAsDX,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,SAAS,CACvB,SAAiB,EACjB,OAAsD;IAEtD,MAAM,YAAY,GAAqB;QACrC,SAAS;QACT,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,KAAK;QACvB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO,IAAA,oBAAW,EAAC,+BAAuB,EAAE,YAAY,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CACxB,MAGE;IAEF,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,KAAK,EAAE,IAAI;QACX,gBAAgB,EAAE,KAAK;QACvB,GAAG,CAAC,CAAC,OAAO;KACb,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAA,oBAAW,EAAC,gCAAwB,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,uBAAuB,CACrC,IAAW,EACX,MAAW;IAEX,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,IAAW,EAAE,MAAW;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO;QACL,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,MAAM;QACN,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,+BAA+B,CAC7C,SAAiB,EACjB,YAAyC;IAEzC,OAAO,CAAC,IAAW,EAAE,MAAW,EAAE,EAAE,CAAC,CAAC;QACpC,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,SAAS;QACT,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI;QACJ,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/decorators/event/event.interceptor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Event Interceptor
+ *
+ * 拦截器实现，处理 @EmitEvent, @EmitEvents 装饰器的事件触发逻辑。
+ * 与 NestJS EventEmitter2 深度融合。
+ */
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { EventEmitter2 } from '@nestjs/event-emitter';
+import { Logger } from 'winston';
+export declare class EventInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly eventEmitter;
+    private readonly logger;
+    constructor(reflector: Reflector, eventEmitter: EventEmitter2, logger: Logger);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 触发事件
+     */
+    private emitEvent;
+}
+//# sourceMappingURL=event.interceptor.d.ts.map

package/dist/decorators/event/event.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interceptor.d.ts","sourceRoot":"","sources":["../../../src/decorators/event/event.interceptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EAEZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AASjC,qBACa,gBAAiB,YAAW,eAAe;IAEpD,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IACI,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFvC,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,aAAa,EACM,MAAM,EAAE,MAAM;IAGlE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;IAuDxE;;OAEG;IACH,OAAO,CAAC,SAAS;CA4DlB"}