@nexe/config-manager 0.1.0

package/dist/sources/yaml-config-source.d.ts

@@ -0,0 +1,57 @@
+import type { IConfigSource } from '../interfaces';
+/**
+ * YAML配置文件源
+ */
+export declare class YamlConfigSource implements IConfigSource {
+    private watchChanges;
+    private filePath;
+    private cache;
+    private watcher;
+    private callbacks;
+    /**
+     * @param filePath 配置文件路径
+     * @param watchChanges 是否监听文件变化
+     */
+    constructor(filePath: string, watchChanges?: boolean);
+    /**
+     * 从YAML文件加载配置
+     */
+    load(key?: string, _pathPrefix?: string): Promise<unknown>;
+    /**
+     * 获取配置源名称
+     */
+    getName(): string;
+    /**
+     * 是否支持热更新
+     */
+    supportsHotReload(): boolean;
+    /**
+     * 订阅配置变更
+     */
+    subscribe(key: string, callback: (value: unknown) => void): void;
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key: string): void;
+    /**
+     * 设置文件变更监听器
+     */
+    private setupWatcher;
+    /**
+     * 处理文件变更
+     */
+    private handleFileChange;
+    /**
+     * 加载文件到缓存
+     */
+    private loadFile;
+    /**
+     * 获取嵌套对象的属性值
+     */
+    private getNestedValue;
+    /**
+     * 关闭资源
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=yaml-config-source.d.ts.map

package/dist/sources/yaml-config-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config-source.d.ts","sourceRoot":"","sources":["../../src/sources/yaml-config-source.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;GAEG;AACH,qBACa,gBAAiB,YAAW,aAAa;IAYlD,OAAO,CAAC,YAAY;IAXtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAmD;IAEpE;;;OAGG;gBAED,QAAQ,EAAE,MAAM,EACR,YAAY,UAAQ;IAQ9B;;OAEG;IACG,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBhE;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAWhE;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,OAAO,CAAC,YAAY;IA8CpB;;OAEG;YACW,gBAAgB;IAe9B;;OAEG;YACW,QAAQ;IAatB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/sources/yaml-config-source.js

@@ -0,0 +1,163 @@
+import { __decorate, __metadata } from "tslib";
+import { createLogger } from '@nexe/logger';
+import * as fs from 'fs';
+import { readFile } from 'fs/promises';
+import * as path from 'path';
+import { injectable } from 'tsyringe';
+import * as YAML from 'yaml';
+const logger = createLogger('YamlConfigSource');
+/**
+ * YAML配置文件源
+ */
+let YamlConfigSource = class YamlConfigSource {
+    /**
+     * @param filePath 配置文件路径
+     * @param watchChanges 是否监听文件变化
+     */
+    constructor(filePath, watchChanges = false) {
+        this.watchChanges = watchChanges;
+        this.cache = {};
+        this.watcher = null;
+        this.callbacks = new Map();
+        this.filePath = path.resolve(filePath);
+        if (this.watchChanges) {
+            this.setupWatcher();
+        }
+    }
+    /**
+     * 从YAML文件加载配置
+     */
+    async load(key, _pathPrefix) {
+        try {
+            if (Object.keys(this.cache).length === 0) {
+                await this.loadFile();
+            }
+            if (!key) {
+                return this.cache;
+            }
+            return this.getNestedValue(this.cache, key);
+        }
+        catch (error) {
+            logger.error('从YAML加载配置失败', error);
+            return undefined;
+        }
+    }
+    /**
+     * 获取配置源名称
+     */
+    getName() {
+        return `YamlConfigSource(${this.filePath})`;
+    }
+    /**
+     * 是否支持热更新
+     */
+    supportsHotReload() {
+        return this.watchChanges;
+    }
+    /**
+     * 订阅配置变更
+     */
+    subscribe(key, callback) {
+        if (!this.supportsHotReload()) {
+            logger.warn('此配置源未启用热更新，无法订阅变更');
+            return;
+        }
+        const callbacks = this.callbacks.get(key) ?? [];
+        callbacks.push(callback);
+        this.callbacks.set(key, callbacks);
+    }
+    /**
+     * 取消订阅配置变更
+     */
+    unsubscribe(key) {
+        this.callbacks.delete(key);
+    }
+    /**
+     * 设置文件变更监听器
+     */
+    setupWatcher() {
+        try {
+            // 先确保文件存在
+            if (!fs.existsSync(this.filePath)) {
+                logger.warn(`配置文件不存在: ${this.filePath}`);
+                return;
+            }
+            logger.info(`开始监听文件变更: ${this.filePath}`);
+            // 监听文件变更 - 使用更强大的选项
+            this.watcher = fs.watch(this.filePath, {
+                persistent: true,
+                encoding: 'utf8',
+                recursive: false,
+            }, (eventType, filename) => {
+                logger.info(`检测到文件变更: ${filename ?? this.filePath}, 事件类型: ${eventType}`);
+                // 文件变更后等待一小段时间再读取，确保写入完成
+                setTimeout(() => {
+                    this.handleFileChange().catch(error => {
+                        logger.error(`处理文件变更时出错: ${error instanceof Error ? error.message : String(error)}`);
+                    });
+                }, 100);
+            });
+        }
+        catch (error) {
+            logger.error(`设置文件监听失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 处理文件变更
+     */
+    async handleFileChange() {
+        const oldCache = { ...this.cache };
+        await this.loadFile();
+        // 通知所有订阅者
+        this.callbacks.forEach((callbacks, key) => {
+            const newValue = this.getNestedValue(this.cache, key);
+            const oldValue = this.getNestedValue(oldCache, key);
+            if (JSON.stringify(newValue) !== JSON.stringify(oldValue)) {
+                callbacks.forEach(callback => callback(newValue));
+            }
+        });
+    }
+    /**
+     * 加载文件到缓存
+     */
+    async loadFile() {
+        try {
+            const content = await readFile(this.filePath, 'utf-8');
+            this.cache = YAML.parse(content);
+        }
+        catch (error) {
+            throw new Error(`加载YAML文件失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * 获取嵌套对象的属性值
+     */
+    getNestedValue(obj, key) {
+        const parts = key.split('.');
+        let current = obj;
+        for (const part of parts) {
+            if (current === undefined ||
+                current === null ||
+                typeof current !== 'object') {
+                return undefined;
+            }
+            current = current[part];
+        }
+        return current;
+    }
+    /**
+     * 关闭资源
+     */
+    dispose() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+};
+YamlConfigSource = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [String, Object])
+], YamlConfigSource);
+export { YamlConfigSource };
+//# sourceMappingURL=yaml-config-source.js.map

package/dist/sources/yaml-config-source.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@nexe/config-manager",
+  "version": "0.1.0",
+  "description": "Nexe Config Manager - A flexible configuration management solution with multiple sources and hot reload support",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish:npm": "npm publish --access public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aqz236/nexe.git",
+    "directory": "packages/tools/config-manager"
+  },
+  "homepage": "https://github.com/aqz236/nexe/tree/main/packages/tools/config-manager#readme",
+  "bugs": {
+    "url": "https://github.com/aqz236/nexe/issues"
+  },
+  "author": "aqz236",
+  "license": "MIT",
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "tsyringe": "^4.10.0",
+    "@nexe/logger": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.19",
+    "@types/node": "^24.1.0",
+    "@types/reflect-metadata": "^0.1.0",
+    "typescript": "5.9.2"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "nexe",
+    "config",
+    "configuration",
+    "config-manager",
+    "hot-reload",
+    "consul",
+    "environment",
+    "json",
+    "yaml",
+    "toml"
+  ]
+}