@nest-omni/core 4.1.3-20 → 4.1.3-23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nest-omni/core",
-  "version": "4.1.3-20",
+  "version": "4.1.3-23",
   "description": "A comprehensive NestJS framework for building enterprise-grade applications with best practices",
   "main": "index.js",
   "types": "index.d.ts",
@@ -41,11 +41,11 @@
   },
   "devDependencies": {
     "@types/compression": "^1.8.1",
-    "@types/express": "^5.0.4",
+    "@types/express": "^5.0.6",
     "@types/express-session": "^1.18.2",
-    "@types/lodash": "^4.17.20",
-    "@types/node": "^24.9.1",
-    "@types/sharp": "^0.31.1",
+    "@types/lodash": "^4.17.21",
+    "@types/node": "^25.0.3",
+    "@types/sharp": "^0.32.0",
     "@types/sprintf-js": "^1.1.4",
     "@types/uuid": "^11.0.0",
     "sqlite3": "^5.1.7",
@@ -56,49 +56,48 @@
     "@dataui/crud-typeorm": "^5.3.4",
     "@nest-omni/transaction": "*",
     "@nestjs/bull": "^11.0.4",
-    "@nestjs/common": "^11.1.7",
+    "@nestjs/common": "^11.1.11",
     "@nestjs/config": "^4.0.2",
-    "@nestjs/core": "^11.1.7",
-    "@nestjs/platform-express": "^11.1.7",
-    "@nestjs/schedule": "^6.0.1",
-    "@nestjs/swagger": "^11.2.1",
+    "@nestjs/core": "^11.1.11",
+    "@nestjs/platform-express": "^11.1.11",
+    "@nestjs/schedule": "^6.1.0",
+    "@nestjs/swagger": "^11.2.4",
     "@nestjs/terminus": "^11.0.0",
     "@nestjs/typeorm": "^11.0.0",
-    "@sentry/nestjs": "^10.22.0",
-    "@sentry/profiling-node": "^10.22.0",
+    "@sentry/nestjs": "^10.32.1",
+    "@sentry/profiling-node": "^10.32.1",
     "@songkeys/nestjs-redis": "^11.0.0",
     "@songkeys/nestjs-redis-health": "^11.0.0",
     "axios": "^1.13.2",
     "axios-retry": "^4.5.0",
     "bcrypt": "^6.0.0",
-    "body-parser": "^2.2.0",
+    "body-parser": "^2.2.1",
     "bull": "^4.16.5",
     "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.2",
+    "class-validator": "^0.14.3",
     "compression": "^1.8.1",
     "connect-redis": "^9.0.0",
     "dotenv": "^17.2.3",
-    "express": "^5.1.0",
+    "express": "^5.2.1",
     "express-session": "^1.18.2",
     "fast-csv": "^5.0.5",
     "hygen": "^6.2.11",
-    "ioredis": "^5.8.2",
-    "libphonenumber-js": "^1.12.25",
+    "ioredis": "^5.9.0",
     "lodash": "^4.17.21",
-    "mime-types": "^3.0.1",
+    "mime-types": "^3.0.2",
     "moment": "^2.30.1",
-    "mysql2": "^3.15.3",
-    "nestjs-cls": "^6.0.1",
-    "nestjs-i18n": "^10.5.1",
-    "nestjs-pino": "^4.4.1",
+    "mysql2": "^3.16.0",
+    "nestjs-cls": "^6.2.0",
+    "nestjs-i18n": "^10.6.0",
+    "nestjs-pino": "^4.5.0",
     "node-vault": "^0.10.9",
     "pino-http": "^11.0.0",
-    "pino-pretty": "^13.1.2",
+    "pino-pretty": "^13.1.3",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
     "source-map-support": "^0.5.21",
     "sprintf-js": "^1.1.3",
-    "typeorm": "^0.3.27",
+    "typeorm": "^0.3.28",
     "uuid": "^13.0.0",
     "xlsx": "git+https://git.sheetjs.com/sheetjs/sheetjs.git#v0.20.3"
   },

package/providers/context.provider.d.ts

@@ -3,6 +3,7 @@ export declare class ContextProvider {
     private static readonly nameSpace;
     private static readonly authUserKey;
     private static readonly routerKey;
+    private static readonly sourceKey;
     private static readonly languageKey;
     private static readonly requestKey;
     static get<T>(key: string): import("nestjs-cls/dist/src/types/type-if-type.type").TypeIfUndefined<T, import("nestjs-cls").ClsStore, T>;
@@ -31,4 +32,12 @@ export declare class ContextProvider {
     static getRole(): string;
     static getAdmin(): boolean;
     static getTenantId(): string;
+    /**
+     * 设置请求来源（如业务主键ID等）
+     */
+    static setSource(source: string): void;
+    /**
+     * 获取请求来源
+     */
+    static getSource(): string | undefined;
 }

package/providers/context.provider.js

@@ -73,10 +73,23 @@ class ContextProvider {
     static getTenantId() {
         return ContextProvider.getAuthUserField('tenantId');
     }
+    /**
+     * 设置请求来源（如业务主键ID等）
+     */
+    static setSource(source) {
+        ContextProvider.set(ContextProvider.sourceKey, source);
+    }
+    /**
+     * 获取请求来源
+     */
+    static getSource() {
+        return ContextProvider.get(ContextProvider.sourceKey);
+    }
 }
 exports.ContextProvider = ContextProvider;
 ContextProvider.nameSpace = 'request';
 ContextProvider.authUserKey = 'user_key';
 ContextProvider.routerKey = 'router_key';
+ContextProvider.sourceKey = 'source_key';
 ContextProvider.languageKey = 'language_key';
 ContextProvider.requestKey = 'request_key';

package/setup/bootstrap.setup.d.ts

@@ -1,3 +1,3 @@
 import '../common/boilerplate.polyfill';
 import type { NestExpressApplication } from '@nestjs/platform-express';
-export declare function bootstrapSetup(AppModule: any, SetupSwagger: any): Promise<NestExpressApplication<import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>>>;
+export declare function bootstrapSetup(AppModule: any, SetupSwagger: any): Promise<NestExpressApplication<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>>>;

package/setup/bootstrap.setup.js

@@ -173,7 +173,7 @@ function bootstrapSetup(AppModule, SetupSwagger) {
             errorHttpStatusCode: common_1.HttpStatus.UNPROCESSABLE_ENTITY,
             transform: true,
             stopAtFirstError: true,
-            validationError: { target: false, value: false },
+            validationError: { target: true, value: true },
         }));
         // 可选功能模块 - 仅在 HTTP 或 Hybrid 模式下启用
         if (shouldStartHttp) {

package/shared/service-registry.module.js

@@ -126,7 +126,6 @@ if (services_1.ApiConfigService.toBoolean(process.env.CACHE_ENABLED)) {
             return {
                 isGlobal: true,
                 redisClient,
-                dataSource,
                 memoryTtl: config.getNumber('CACHE_TTL'),
                 memoryNamespace: config.getString('CACHE_NAMESPACE', 'default'),
                 enableCompression: config.getBoolean('CACHE_COMPRESSION_ENABLED', false),

package/cache/providers/memory-cache.provider.d.ts

@@ -1,69 +0,0 @@
-import { BaseCacheProvider } from './base-cache.provider';
-/**
- * Memory cache provider using native Map with TTL support
- *
- * This is the L2 cache layer - process-level caching.
- * Data is stored in memory and shared across all requests in the same process.
- *
- * Faster than Redis but not shared across multiple processes/servers.
- *
- * **Automatic Cleanup**: Includes periodic cleanup of expired items to prevent memory leaks.
- */
-export declare class MemoryCacheProvider extends BaseCacheProvider {
-    private cache;
-    private keys;
-    private defaultTtl?;
-    private namespace;
-    private cleanupTimer?;
-    /**
-     * Cleanup interval in milliseconds
-     * @default 300000 (5 minutes)
-     */
-    private readonly CLEANUP_INTERVAL;
-    constructor(options?: {
-        ttl?: number;
-        namespace?: string;
-    });
-    /**
-     * Start periodic cleanup of expired items
-     */
-    private startCleanupTimer;
-    /**
-     * Stop automatic cleanup timer
-     */
-    private stopCleanupTimer;
-    /**
-     * Destroy the provider and cleanup resources
-     */
-    destroy(): void;
-    getName(): string;
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<void>;
-    delete(key: string | string[]): Promise<void>;
-    deletePattern(pattern: string): Promise<number>;
-    clear(): Promise<void>;
-    has(key: string): Promise<boolean>;
-    /**
-     * Get all keys (for debugging/testing)
-     */
-    getAllKeys(): string[];
-    /**
-     * Get cache size
-     */
-    getSize(): number;
-    /**
-     * Clean up expired items (optional maintenance method)
-     */
-    cleanup(): number;
-    /**
-     * Optimized mget with batch cleanup
-     */
-    mget<T>(keys: string[]): Promise<(T | null)[]>;
-    /**
-     * Optimized mset
-     */
-    mset(items: Array<{
-        key: string;
-        value: any;
-    }>, ttl?: number): Promise<void>;
-}

package/cache/providers/memory-cache.provider.js

@@ -1,237 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemoryCacheProvider = void 0;
-const base_cache_provider_1 = require("./base-cache.provider");
-/**
- * Memory cache provider using native Map with TTL support
- *
- * This is the L2 cache layer - process-level caching.
- * Data is stored in memory and shared across all requests in the same process.
- *
- * Faster than Redis but not shared across multiple processes/servers.
- *
- * **Automatic Cleanup**: Includes periodic cleanup of expired items to prevent memory leaks.
- */
-class MemoryCacheProvider extends base_cache_provider_1.BaseCacheProvider {
-    constructor(options) {
-        super();
-        this.cache = new Map();
-        this.keys = new Set();
-        /**
-         * Cleanup interval in milliseconds
-         * @default 300000 (5 minutes)
-         */
-        this.CLEANUP_INTERVAL = 5 * 60 * 1000;
-        this.defaultTtl = options === null || options === void 0 ? void 0 : options.ttl;
-        this.namespace = (options === null || options === void 0 ? void 0 : options.namespace) || 'cache:memory';
-        // Start automatic cleanup timer
-        this.startCleanupTimer();
-    }
-    /**
-     * Start periodic cleanup of expired items
-     */
-    startCleanupTimer() {
-        this.cleanupTimer = setInterval(() => {
-            const cleaned = this.cleanup();
-            if (cleaned > 0) {
-                console.debug(`[MemoryCache] Cleaned up ${cleaned} expired items from namespace: ${this.namespace}`);
-            }
-        }, this.CLEANUP_INTERVAL);
-        // Allow Node.js to exit if this is the only active timer
-        if (this.cleanupTimer.unref) {
-            this.cleanupTimer.unref();
-        }
-    }
-    /**
-     * Stop automatic cleanup timer
-     */
-    stopCleanupTimer() {
-        if (this.cleanupTimer) {
-            clearInterval(this.cleanupTimer);
-            this.cleanupTimer = undefined;
-        }
-    }
-    /**
-     * Destroy the provider and cleanup resources
-     */
-    destroy() {
-        this.stopCleanupTimer();
-        this.clear();
-    }
-    getName() {
-        return 'Memory';
-    }
-    get(key) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const item = this.cache.get(key);
-                if (!item) {
-                    return null;
-                }
-                // Check if item has expired
-                if (item.expiresAt && Date.now() > item.expiresAt) {
-                    this.cache.delete(key);
-                    this.keys.delete(key);
-                    return null;
-                }
-                return item.value;
-            }
-            catch (_a) {
-                return null;
-            }
-        });
-    }
-    set(key, value, ttl) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const effectiveTtl = ttl !== null && ttl !== void 0 ? ttl : this.defaultTtl;
-                const expiresAt = effectiveTtl ? Date.now() + effectiveTtl : undefined;
-                const item = {
-                    value,
-                    expiresAt,
-                };
-                this.cache.set(key, item);
-                this.keys.add(key);
-            }
-            catch (error) {
-                throw new Error(`MemoryCacheProvider: Failed to set key ${key}: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        });
-    }
-    delete(key) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                if (Array.isArray(key)) {
-                    key.forEach((k) => {
-                        this.cache.delete(k);
-                        this.keys.delete(k);
-                    });
-                }
-                else {
-                    this.cache.delete(key);
-                    this.keys.delete(key);
-                }
-            }
-            catch (error) {
-                throw new Error(`MemoryCacheProvider: Failed to delete key(s): ${error instanceof Error ? error.message : String(error)}`);
-            }
-        });
-    }
-    deletePattern(pattern) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const regex = this.patternToRegex(pattern);
-                const matchedKeys = Array.from(this.keys).filter((key) => regex.test(key));
-                if (matchedKeys.length > 0) {
-                    yield this.delete(matchedKeys);
-                }
-                return matchedKeys.length;
-            }
-            catch (_a) {
-                return 0;
-            }
-        });
-    }
-    clear() {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                this.cache.clear();
-                this.keys.clear();
-            }
-            catch (error) {
-                throw new Error(`MemoryCacheProvider: Failed to clear cache: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        });
-    }
-    has(key) {
-        return __awaiter(this, void 0, void 0, function* () {
-            try {
-                const item = this.cache.get(key);
-                if (!item) {
-                    return false;
-                }
-                // Check if item has expired
-                if (item.expiresAt && Date.now() > item.expiresAt) {
-                    this.cache.delete(key);
-                    this.keys.delete(key);
-                    return false;
-                }
-                return true;
-            }
-            catch (_a) {
-                return false;
-            }
-        });
-    }
-    /**
-     * Get all keys (for debugging/testing)
-     */
-    getAllKeys() {
-        return Array.from(this.keys);
-    }
-    /**
-     * Get cache size
-     */
-    getSize() {
-        return this.keys.size;
-    }
-    /**
-     * Clean up expired items (optional maintenance method)
-     */
-    cleanup() {
-        let cleaned = 0;
-        const now = Date.now();
-        for (const [key, item] of this.cache.entries()) {
-            if (item.expiresAt && now > item.expiresAt) {
-                this.cache.delete(key);
-                this.keys.delete(key);
-                cleaned++;
-            }
-        }
-        return cleaned;
-    }
-    /**
-     * Optimized mget with batch cleanup
-     */
-    mget(keys) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const results = [];
-            const now = Date.now();
-            for (const key of keys) {
-                const item = this.cache.get(key);
-                if (!item) {
-                    results.push(null);
-                    continue;
-                }
-                // Check if item has expired
-                if (item.expiresAt && now > item.expiresAt) {
-                    this.cache.delete(key);
-                    this.keys.delete(key);
-                    results.push(null);
-                    continue;
-                }
-                results.push(item.value);
-            }
-            return results;
-        });
-    }
-    /**
-     * Optimized mset
-     */
-    mset(items, ttl) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const promises = items.map((item) => this.set(item.key, item.value, ttl));
-            yield Promise.all(promises);
-        });
-    }
-}
-exports.MemoryCacheProvider = MemoryCacheProvider;