yingzios-platform-backend-shared 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,19 @@
+"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("./cache.config"), exports);
+__exportStar(require("./cache.service"), exports);
+__exportStar(require("./cache.module"), exports);

package/dist/env/env-loader.d.ts

@@ -0,0 +1,50 @@
+export interface EnvLoadOptions {
+    /**
+     * 服务目录路径（通常是 __dirname 所在目录）
+     * 如果不传，默认使用 process.cwd()
+     */
+    serviceDir?: string;
+    /**
+     * 是否启用根目录继承（默认 true）
+     */
+    inheritFromRoot?: boolean;
+    /**
+     * 根目录路径（默认自动向上查找包含 nx.json 的目录）
+     */
+    rootDir?: string;
+    /**
+     * 是否打印加载日志（默认 true）
+     */
+    verbose?: boolean;
+}
+/**
+ * 加载环境变量（支持根目录继承）
+ *
+ * 加载顺序：
+ * 1. 根目录 .env.local（公共配置）
+ * 2. 服务目录 .env.local（服务特定配置，会覆盖公共配置）
+ *
+ * @example
+ * ```typescript
+ * // 在服务的 main.ts 或 utils/index.ts 中
+ * import { loadEnvWithInheritance } from 'yz-web-server-shared';
+ *
+ * loadEnvWithInheritance({ serviceDir: __dirname });
+ * ```
+ */
+export declare function loadEnvWithInheritance(options?: EnvLoadOptions): void;
+/**
+ * 环境变量初始化函数（默认配置）
+ *
+ * 各服务可直接 import 使用：
+ * ```typescript
+ * import { envInitialize } from 'yz-web-server-shared';
+ * envInitialize();
+ * ```
+ *
+ * 加载顺序：
+ * 1. 根目录 .env.local（公共配置，如 Service Keys）
+ * 2. 服务目录 .env.local（服务特定配置，会覆盖公共配置）
+ */
+export declare function envInitialize(): void;
+//# sourceMappingURL=env-loader.d.ts.map

package/dist/env/env-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-loader.d.ts","sourceRoot":"","sources":["../../src/env/env-loader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA2ED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAqCzE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/env/env-loader.js

@@ -0,0 +1,159 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadEnvWithInheritance = loadEnvWithInheritance;
+exports.envInitialize = envInitialize;
+const dotenv = __importStar(require("dotenv"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 查找 monorepo 根目录
+ * 向上查找包含 nx.json 或 pnpm-workspace.yaml 的目录
+ */
+function findMonorepoRoot(startDir) {
+    let currentDir = startDir;
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        if (fs.existsSync(path.join(currentDir, 'nx.json')) ||
+            fs.existsSync(path.join(currentDir, 'pnpm-workspace.yaml'))) {
+            return currentDir;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * 获取环境相关的配置文件列表
+ * 注意：.env.example 是示例文件，不会被加载
+ */
+function getEnvFiles(env) {
+    if (env === 'test') {
+        return ['.env.test', '.env.local', '.env'];
+    }
+    if (env === 'prod' || env === 'production') {
+        return ['.env.prod', '.env.local', '.env'];
+    }
+    return ['.env.local', '.env'];
+}
+/**
+ * 从指定目录加载第一个存在的 .env 文件
+ * @returns 加载的文件路径，如果没有找到则返回 null
+ */
+function loadEnvFromDir(dir, envFiles, override, verbose, label) {
+    for (const envFileName of envFiles) {
+        const envFilePath = path.join(dir, envFileName);
+        if (fs.existsSync(envFilePath)) {
+            const result = dotenv.config({ path: envFilePath, override });
+            if (result.error) {
+                console.error(`无法读取 ${label} .env 文件: ${envFilePath}`, result.error);
+                continue;
+            }
+            const injectedCount = Object.keys(result.parsed || {}).length;
+            if (injectedCount === 0) {
+                if (verbose) {
+                    console.warn(`警告: ${envFilePath} 未解析出任何环境变量，继续尝试后续配置文件`);
+                }
+                continue;
+            }
+            if (verbose) {
+                console.log(`[${label}] 加载环境变量: ${envFilePath} (${injectedCount} 项)`);
+            }
+            return envFilePath;
+        }
+    }
+    return null;
+}
+/**
+ * 加载环境变量（支持根目录继承）
+ *
+ * 加载顺序：
+ * 1. 根目录 .env.local（公共配置）
+ * 2. 服务目录 .env.local（服务特定配置，会覆盖公共配置）
+ *
+ * @example
+ * ```typescript
+ * // 在服务的 main.ts 或 utils/index.ts 中
+ * import { loadEnvWithInheritance } from 'yz-web-server-shared';
+ *
+ * loadEnvWithInheritance({ serviceDir: __dirname });
+ * ```
+ */
+function loadEnvWithInheritance(options = {}) {
+    const { serviceDir = process.cwd(), inheritFromRoot = true, rootDir, verbose = true, } = options;
+    const env = process.env.NODE_ENV;
+    const envFiles = getEnvFiles(env);
+    if (verbose) {
+        console.log(`---------[ 系统变量 ]---------`);
+        console.log(`NODE_ENV: ${env || 'development'}`);
+    }
+    let rootLoaded = null;
+    let serviceLoaded = null;
+    // 1. 先加载根目录配置（公共配置）
+    if (inheritFromRoot) {
+        const detectedRootDir = rootDir || findMonorepoRoot(serviceDir);
+        if (detectedRootDir && detectedRootDir !== serviceDir) {
+            rootLoaded = loadEnvFromDir(detectedRootDir, envFiles, false, verbose, '根目录');
+        }
+    }
+    // 2. 再加载服务目录配置（服务特定配置，会覆盖公共配置）
+    serviceLoaded = loadEnvFromDir(serviceDir, envFiles, true, verbose, '服务目录');
+    // 输出加载结果
+    if (verbose) {
+        if (!rootLoaded && !serviceLoaded) {
+            console.warn(`警告: 未找到任何环境配置文件`);
+        }
+        console.log(`---------[ /系统变量 ]---------`);
+    }
+}
+/**
+ * 环境变量初始化函数（默认配置）
+ *
+ * 各服务可直接 import 使用：
+ * ```typescript
+ * import { envInitialize } from 'yz-web-server-shared';
+ * envInitialize();
+ * ```
+ *
+ * 加载顺序：
+ * 1. 根目录 .env.local（公共配置，如 Service Keys）
+ * 2. 服务目录 .env.local（服务特定配置，会覆盖公共配置）
+ */
+function envInitialize() {
+    loadEnvWithInheritance({
+        serviceDir: process.cwd(),
+        inheritFromRoot: true,
+        verbose: process.env.NODE_ENV !== 'test',
+    });
+}

package/dist/env/env.module.d.ts

@@ -0,0 +1,11 @@
+import { DynamicModule } from '@nestjs/common';
+import { type RuntimeEnvHookOptions } from './env.service';
+export interface EnvModuleAsyncOptions {
+    useFactory: (...args: any[]) => any;
+    inject?: any[];
+    runtimeFile?: RuntimeEnvHookOptions;
+}
+export declare class EnvModule {
+    static forRootAsync(options: EnvModuleAsyncOptions): DynamicModule;
+}
+//# sourceMappingURL=env.module.d.ts.map

package/dist/env/env.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.module.d.ts","sourceRoot":"","sources":["../../src/env/env.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACpC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAED,qBAEa,SAAS;IACpB,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa;CA4BnE"}

package/dist/env/env.module.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var EnvModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvModule = void 0;
+const common_1 = require("@nestjs/common");
+const env_loader_1 = require("./env-loader");
+const env_service_1 = require("./env.service");
+let EnvModule = EnvModule_1 = class EnvModule {
+    static forRootAsync(options) {
+        // 在模块构建时自动加载环境变量（支持根目录继承）
+        (0, env_loader_1.loadEnvWithInheritance)();
+        return {
+            module: EnvModule_1,
+            providers: [
+                {
+                    provide: 'CUSTOM_ENV_CONFIG',
+                    useFactory: async (...args) => {
+                        const config = await options.useFactory(...args);
+                        return config;
+                    },
+                    inject: options.inject || [],
+                },
+                {
+                    provide: env_service_1.ENV_RUNTIME_FILE_OPTIONS,
+                    useValue: options.runtimeFile ?? true, // 默认启用，输出 .env.runtime.json
+                },
+                env_service_1.EnvService,
+                {
+                    provide: 'ENV_SERVICE',
+                    useExisting: env_service_1.EnvService,
+                },
+            ],
+            exports: [env_service_1.EnvService, 'ENV_SERVICE'],
+        };
+    }
+};
+exports.EnvModule = EnvModule;
+exports.EnvModule = EnvModule = EnvModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], EnvModule);

package/dist/env/env.service.d.ts

@@ -0,0 +1,31 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import type { LoggerService } from '@nestjs/common';
+export declare const ENV_RUNTIME_FILE_OPTIONS = "ENV_RUNTIME_FILE_OPTIONS";
+export interface RuntimeEnvFileOptions {
+    filePath?: string;
+    spaces?: number;
+    excludeKeys?: string[];
+    excludePrefixes?: string[];
+}
+export type RuntimeEnvHookOptions = boolean | RuntimeEnvFileOptions;
+export declare class EnvService implements OnApplicationBootstrap {
+    readonly configs: Record<string, any>;
+    readonly logger: LoggerService;
+    readonly runtimeFileOptions?: RuntimeEnvHookOptions;
+    private envs;
+    constructor(configs: Record<string, any>, logger: LoggerService, runtimeFileOptions?: RuntimeEnvHookOptions);
+    getItem(key: string): any;
+    setItem(key: string, value: any): void;
+    getAll(): {
+        [k: string]: any;
+    };
+    onApplicationBootstrap(): void;
+    private logEnvironmentVariables;
+    private stringifyRuntimeEnvs;
+    private logMessage;
+    getRuntimeFileEnvs(options?: Omit<RuntimeEnvFileOptions, 'filePath' | 'spaces'>): {
+        [k: string]: any;
+    };
+    writeRuntimeFile(options?: RuntimeEnvFileOptions): string;
+}
+//# sourceMappingURL=env.service.d.ts.map

package/dist/env/env.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.service.d.ts","sourceRoot":"","sources":["../../src/env/env.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,sBAAsB,EAAY,MAAM,gBAAgB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,qBAAqB,CAAC;AAoDpE,qBACa,UAAW,YAAW,sBAAsB;IAIrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAErC,QAAQ,CAAC,MAAM,EAAE,aAAa;IAG9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,qBAAqB;IARrD,OAAO,CAAC,IAAI,CAA0B;gBAG3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAE5B,MAAM,EAAE,aAAa,EAGrB,kBAAkB,CAAC,EAAE,qBAAqB;IAYrD,OAAO,CAAC,GAAG,EAAE,MAAM;IAInB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAI/B,MAAM;;;IAIN,sBAAsB;IAsBtB,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,UAAU;IAQlB,kBAAkB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,QAAQ,CAAC;;;IAqB/E,gBAAgB,CAAC,OAAO,CAAC,EAAE,qBAAqB;CAQjD"}

package/dist/env/env.service.js

@@ -0,0 +1,195 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvService = exports.ENV_RUNTIME_FILE_OPTIONS = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const common_1 = require("@nestjs/common");
+exports.ENV_RUNTIME_FILE_OPTIONS = 'ENV_RUNTIME_FILE_OPTIONS';
+const DEFAULT_RUNTIME_ENV_EXCLUDE_KEYS = new Set([
+    'PATH',
+    'NODE',
+    'NODE_PATH',
+    'NODE_OPTIONS',
+    'FPATH',
+    'PWD',
+    'OLDPWD',
+    'INIT_CWD',
+    'HOME',
+    'USER',
+    'LOGNAME',
+    'LANG',
+    'TERM',
+    'TERM_PROGRAM',
+    'TERM_PROGRAM_VERSION',
+    'COLORTERM',
+    'SHELL',
+    'SHLVL',
+    'TMP',
+    'TEMP',
+    'TMPDIR',
+    'COMMAND_MODE',
+    'SSH_AUTH_SOCK',
+    'INFOPATH',
+    'PKG_CONFIG_PATH',
+    'CPPFLAGS',
+    'LDFLAGS',
+    'GK_GL_ADDR',
+    'GK_GL_PATH',
+    'GIT_ASKPASS',
+    'MallocNanoZone',
+    'NVM_BIN',
+    'NVM_DIR',
+    'PNPM_SCRIPT_SRC_DIR',
+    'PYENV_ROOT',
+    'PYENV_SHELL',
+    '_',
+]);
+const DEFAULT_RUNTIME_ENV_EXCLUDE_PREFIXES = [
+    'npm_',
+    'NVM_',
+    'PYENV_',
+    'VSCODE_',
+    'HOMEBREW_',
+    '__CF',
+    'XPC_',
+];
+let EnvService = class EnvService {
+    configs;
+    logger;
+    runtimeFileOptions;
+    envs = new Map();
+    constructor(configs, logger, runtimeFileOptions) {
+        this.configs = configs;
+        this.logger = logger;
+        this.runtimeFileOptions = runtimeFileOptions;
+        for (const key in configs) {
+            this.envs.set(key, configs[key]);
+        }
+        // 使用process.env覆盖默认的configs,让它的优先级更高一些,方便开发调试
+        for (const [key, value] of Object.entries(process.env)) {
+            this.envs.set(key, value);
+        }
+    }
+    getItem(key) {
+        return this.envs.get(key);
+    }
+    setItem(key, value) {
+        this.envs.set(key, value);
+    }
+    getAll() {
+        return Object.fromEntries(this.envs);
+    }
+    onApplicationBootstrap() {
+        // 启动时输出环境变量到终端
+        this.logEnvironmentVariables();
+        if (!this.runtimeFileOptions) {
+            return;
+        }
+        const runtimeEnvPath = this.writeRuntimeFile(this.runtimeFileOptions === true ? undefined : this.runtimeFileOptions);
+        const message = `环境变量已写入文件: ${runtimeEnvPath}`;
+        if ('forceLog' in this.logger && typeof this.logger.forceLog === 'function') {
+            this.logger.forceLog(message);
+            return;
+        }
+        this.logger.log?.(message);
+    }
+    logEnvironmentVariables() {
+        const envs = this.getRuntimeFileEnvs();
+        const envCount = Object.keys(envs).length;
+        if (envCount === 0) {
+            console.log('未找到需要输出的环境变量');
+            return;
+        }
+        console.log('\n---------[ 运行时环境变量 ]---------');
+        console.log(this.stringifyRuntimeEnvs(envs, this.runtimeFileOptions));
+        console.log(`---------[ 共 ${envCount} 个变量 ]---------\n`);
+    }
+    stringifyRuntimeEnvs(envs, options) {
+        const spaces = typeof options === 'object' && options?.spaces != null ? options.spaces : 2;
+        return JSON.stringify(envs, null, spaces);
+    }
+    logMessage(message) {
+        if ('forceLog' in this.logger && typeof this.logger.forceLog === 'function') {
+            this.logger.forceLog(message);
+        }
+        else {
+            this.logger.log?.(message);
+        }
+    }
+    getRuntimeFileEnvs(options) {
+        const excludeKeys = new Set([
+            ...DEFAULT_RUNTIME_ENV_EXCLUDE_KEYS,
+            ...(options?.excludeKeys ?? []),
+        ]);
+        const excludePrefixes = [
+            ...DEFAULT_RUNTIME_ENV_EXCLUDE_PREFIXES,
+            ...(options?.excludePrefixes ?? []),
+        ];
+        return Object.fromEntries(Object.entries(this.getAll()).filter(([key]) => {
+            if (excludeKeys.has(key)) {
+                return false;
+            }
+            return !excludePrefixes.some((prefix) => key.startsWith(prefix));
+        }));
+    }
+    writeRuntimeFile(options) {
+        const runtimeEnvPath = options?.filePath ?? path.join(process.cwd(), '.env.runtime.json');
+        const envs = this.getRuntimeFileEnvs(options);
+        fs.writeFileSync(runtimeEnvPath, this.stringifyRuntimeEnvs(envs, options), 'utf8');
+        return runtimeEnvPath;
+    }
+};
+exports.EnvService = EnvService;
+exports.EnvService = EnvService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('CUSTOM_ENV_CONFIG')),
+    __param(1, (0, common_1.Inject)('APP_LOGGER')),
+    __param(2, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Inject)(exports.ENV_RUNTIME_FILE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, Object, Object])
+], EnvService);

package/dist/env/index.d.ts

@@ -0,0 +1,4 @@
+export * from './env.module';
+export * from './env.service';
+export * from './env-loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/env/index.js

@@ -0,0 +1,19 @@
+"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("./env.module"), exports);
+__exportStar(require("./env.service"), exports);
+__exportStar(require("./env-loader"), exports);

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './logger/index';
+export * from './jwt/index';
+export * from './swagger/index';
+export * from './restful/index';
+export * from './snowflake/index';
+export * from './env/index';
+export * from './sequelize/index';
+export * from './cache/index';
+export * from './nacos/index';
+export * from './apollo/index';
+export * from './internal-auth/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"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("./logger/index"), exports);
+__exportStar(require("./jwt/index"), exports);
+__exportStar(require("./swagger/index"), exports);
+__exportStar(require("./restful/index"), exports);
+__exportStar(require("./snowflake/index"), exports);
+__exportStar(require("./env/index"), exports);
+__exportStar(require("./sequelize/index"), exports);
+__exportStar(require("./cache/index"), exports);
+__exportStar(require("./nacos/index"), exports);
+__exportStar(require("./apollo/index"), exports);
+__exportStar(require("./internal-auth/index"), exports);

package/dist/internal-auth/decorators/caller.decorator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 调用方身份（服务或用户）
+ */
+export interface CallerIdentity {
+    type: 'service' | 'user';
+    /** 用户调用时的用户信息 */
+    user?: any;
+}
+/**
+ * 获取调用方身份（支持服务和用户两种类型）
+ *
+ * 用于 @UseEitherGuard(ServiceKeyGuard, JwtAuthGuard) 场景，
+ * 自动识别是服务调用还是用户调用。
+ *
+ * @example
+ * ```typescript
+ * @UseEitherGuard(ServiceKeyGuard, JwtAuthGuard)
+ * @Get('/internal/orders')
+ * getOrders(@Caller() caller: CallerIdentity) {
+ *   if (caller.type === 'service') {
+ *     // 服务调用，无用户上下文
+ *   } else {
+ *     console.log(caller.user.id);
+ *   }
+ * }
+ * ```
+ */
+export declare const Caller: (...dataOrPipes: unknown[]) => ParameterDecorator;
+//# sourceMappingURL=caller.decorator.d.ts.map

package/dist/internal-auth/decorators/caller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller.decorator.d.ts","sourceRoot":"","sources":["../../../src/internal-auth/decorators/caller.decorator.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,iBAAiB;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,mDAiBlB,CAAC"}