needware-cli 1.0.0

package/dist/utils/config.js

@@ -0,0 +1,237 @@
+"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.ConfigManager = void 0;
+const path = __importStar(require("path"));
+const file_1 = require("./file");
+const error_1 = require("../types/error");
+class ConfigManager {
+    configPath;
+    config;
+    defaultConfig;
+    constructor(options = {}) {
+        this.configPath = options.configPath || this.getDefaultConfigPath();
+        this.defaultConfig = this.createDefaultConfig();
+        if (options.defaultConfig) {
+            this.defaultConfig = this.merge(this.defaultConfig, options.defaultConfig);
+        }
+        this.config = this.load();
+    }
+    /**
+     * 获取默认配置文件路径
+     */
+    getDefaultConfigPath() {
+        const configDir = file_1.FileUtils.getConfigDir();
+        return path.join(configDir, 'config.json');
+    }
+    /**
+     * 创建默认配置
+     */
+    createDefaultConfig() {
+        return {
+            version: '1.0.0',
+            logging: {
+                level: 'info',
+                file: path.join(file_1.FileUtils.getConfigDir(), 'logs', 'cli.log'),
+            },
+            sdks: {
+                example: {
+                    apiKey: '',
+                    endpoint: 'https://api.example.com',
+                    timeout: 30000,
+                    retries: 3,
+                },
+            },
+            preferences: {
+                colorOutput: true,
+                interactive: true,
+            },
+        };
+    }
+    /**
+     * 加载配置
+     */
+    load() {
+        try {
+            // 从环境变量加载配置
+            const envConfig = this.loadFromEnv();
+            // 如果配置文件不存在，使用默认配置
+            if (!file_1.FileUtils.exists(this.configPath)) {
+                const config = this.merge(this.defaultConfig, envConfig);
+                this.save(config);
+                return config;
+            }
+            // 读取用户配置文件
+            const userConfig = file_1.FileUtils.readJSON(this.configPath);
+            // 合并配置：默认 < 用户 < 环境变量
+            return this.merge(this.merge(this.defaultConfig, userConfig), envConfig);
+        }
+        catch (error) {
+            throw new error_1.CLIError('Failed to load configuration', error_1.ErrorType.CONFIG, [
+                'Check if the config file is valid JSON',
+                'Try resetting config: needware-cli config reset',
+            ], { configPath: this.configPath, error });
+        }
+    }
+    /**
+     * 从环境变量加载配置
+     */
+    loadFromEnv() {
+        const envConfig = {};
+        // 日志级别
+        if (process.env.NEEDWARE_LOG_LEVEL) {
+            envConfig.logging = {
+                ...(envConfig.logging || this.defaultConfig.logging),
+                level: process.env.NEEDWARE_LOG_LEVEL,
+            };
+        }
+        // SDK 配置
+        if (process.env.NEEDWARE_API_KEY || process.env.NEEDWARE_ENDPOINT) {
+            envConfig.sdks = {
+                example: {
+                    apiKey: process.env.NEEDWARE_API_KEY || '',
+                    endpoint: process.env.NEEDWARE_ENDPOINT || this.defaultConfig.sdks.example.endpoint,
+                    timeout: this.defaultConfig.sdks.example.timeout,
+                },
+            };
+        }
+        // 偏好设置
+        if (process.env.NEEDWARE_COLOR_OUTPUT !== undefined) {
+            envConfig.preferences = {
+                ...(envConfig.preferences || this.defaultConfig.preferences),
+                colorOutput: process.env.NEEDWARE_COLOR_OUTPUT === 'true',
+            };
+        }
+        return envConfig;
+    }
+    /**
+     * 保存配置
+     */
+    save(config) {
+        try {
+            const configToSave = config || this.config;
+            file_1.FileUtils.writeJSON(this.configPath, configToSave);
+            this.config = configToSave;
+        }
+        catch (error) {
+            throw new error_1.CLIError('Failed to save configuration', error_1.ErrorType.CONFIG, ['Check file permissions', 'Check if the directory exists'], { configPath: this.configPath, error });
+        }
+    }
+    /**
+     * 获取配置项
+     */
+    get(key) {
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value && typeof value === 'object' && k in value) {
+                value = value[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return value;
+    }
+    /**
+     * 设置配置项
+     */
+    set(key, value) {
+        const keys = key.split('.');
+        let target = this.config;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const k = keys[i];
+            if (!(k in target) || typeof target[k] !== 'object') {
+                target[k] = {};
+            }
+            target = target[k];
+        }
+        target[keys[keys.length - 1]] = value;
+        this.save();
+    }
+    /**
+     * 合并配置
+     */
+    merge(base, override) {
+        const result = { ...base };
+        for (const key in override) {
+            const value = override[key];
+            if (value !== undefined) {
+                if (typeof value === 'object' && !Array.isArray(value) && value !== null) {
+                    result[key] = {
+                        ...result[key],
+                        ...value,
+                    };
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 重置配置为默认值
+     */
+    reset() {
+        this.config = { ...this.defaultConfig };
+        this.save();
+    }
+    /**
+     * 获取当前配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * 获取配置文件路径
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * 删除配置文件
+     */
+    deleteConfig() {
+        if (file_1.FileUtils.exists(this.configPath)) {
+            file_1.FileUtils.deleteFile(this.configPath);
+        }
+    }
+}
+exports.ConfigManager = ConfigManager;
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/file.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 文件操作工具
+ */
+export declare class FileUtils {
+    /**
+     * 确保目录存在
+     */
+    static ensureDir(dirPath: string): void;
+    /**
+     * 读取文件内容
+     */
+    static readFile(filePath: string, encoding?: BufferEncoding): string;
+    /**
+     * 写入文件内容
+     */
+    static writeFile(filePath: string, content: string, encoding?: BufferEncoding): void;
+    /**
+     * 读取 JSON 文件
+     */
+    static readJSON<T = any>(filePath: string): T;
+    /**
+     * 写入 JSON 文件
+     */
+    static writeJSON(filePath: string, data: any, pretty?: boolean): void;
+    /**
+     * 检查文件是否存在
+     */
+    static exists(filePath: string): boolean;
+    /**
+     * 删除文件
+     */
+    static deleteFile(filePath: string): void;
+    /**
+     * 删除目录
+     */
+    static deleteDir(dirPath: string): void;
+    /**
+     * 获取用户主目录
+     */
+    static getHomeDir(): string;
+    /**
+     * 解析路径中的 ~ 为用户主目录
+     */
+    static resolvePath(filePath: string): string;
+    /**
+     * 获取配置目录路径
+     */
+    static getConfigDir(): string;
+    /**
+     * 复制文件
+     */
+    static copyFile(src: string, dest: string): void;
+    /**
+     * 获取文件大小
+     */
+    static getFileSize(filePath: string): number;
+    /**
+     * 检查是否为目录
+     */
+    static isDirectory(dirPath: string): boolean;
+    /**
+     * 列出目录内容
+     */
+    static listDir(dirPath: string): string[];
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,MAAM;IAI5E;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAuB,GAAG,IAAI;IAM5F;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAK7C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,UAAO,GAAG,IAAI;IAKlE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO5C;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM;IAK7B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMhD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK5C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAS5C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAM1C"}

package/dist/utils/file.js

@@ -0,0 +1,162 @@
+"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.FileUtils = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+class FileUtils {
+    /**
+     * 确保目录存在
+     */
+    static ensureDir(dirPath) {
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+    }
+    /**
+     * 读取文件内容
+     */
+    static readFile(filePath, encoding = 'utf8') {
+        return fs.readFileSync(filePath, encoding);
+    }
+    /**
+     * 写入文件内容
+     */
+    static writeFile(filePath, content, encoding = 'utf8') {
+        const dir = path.dirname(filePath);
+        this.ensureDir(dir);
+        fs.writeFileSync(filePath, content, encoding);
+    }
+    /**
+     * 读取 JSON 文件
+     */
+    static readJSON(filePath) {
+        const content = this.readFile(filePath);
+        return JSON.parse(content);
+    }
+    /**
+     * 写入 JSON 文件
+     */
+    static writeJSON(filePath, data, pretty = true) {
+        const content = pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
+        this.writeFile(filePath, content);
+    }
+    /**
+     * 检查文件是否存在
+     */
+    static exists(filePath) {
+        return fs.existsSync(filePath);
+    }
+    /**
+     * 删除文件
+     */
+    static deleteFile(filePath) {
+        if (this.exists(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    /**
+     * 删除目录
+     */
+    static deleteDir(dirPath) {
+        if (this.exists(dirPath)) {
+            fs.rmSync(dirPath, { recursive: true, force: true });
+        }
+    }
+    /**
+     * 获取用户主目录
+     */
+    static getHomeDir() {
+        return os.homedir();
+    }
+    /**
+     * 解析路径中的 ~ 为用户主目录
+     */
+    static resolvePath(filePath) {
+        if (filePath.startsWith('~/') || filePath === '~') {
+            return path.join(this.getHomeDir(), filePath.slice(1));
+        }
+        return path.resolve(filePath);
+    }
+    /**
+     * 获取配置目录路径
+     */
+    static getConfigDir() {
+        const homeDir = this.getHomeDir();
+        return path.join(homeDir, '.needware');
+    }
+    /**
+     * 复制文件
+     */
+    static copyFile(src, dest) {
+        const destDir = path.dirname(dest);
+        this.ensureDir(destDir);
+        fs.copyFileSync(src, dest);
+    }
+    /**
+     * 获取文件大小
+     */
+    static getFileSize(filePath) {
+        const stats = fs.statSync(filePath);
+        return stats.size;
+    }
+    /**
+     * 检查是否为目录
+     */
+    static isDirectory(dirPath) {
+        try {
+            const stats = fs.statSync(dirPath);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 列出目录内容
+     */
+    static listDir(dirPath) {
+        if (!this.exists(dirPath) || !this.isDirectory(dirPath)) {
+            return [];
+        }
+        return fs.readdirSync(dirPath);
+    }
+}
+exports.FileUtils = FileUtils;
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/dist/utils/validator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 输入验证工具
+ */
+export declare class Validator {
+    /**
+     * 验证字符串非空
+     */
+    static isNonEmpty(value: string): boolean;
+    /**
+     * 验证邮箱格式
+     */
+    static isEmail(value: string): boolean;
+    /**
+     * 验证 URL 格式
+     */
+    static isURL(value: string): boolean;
+    /**
+     * 验证端口号
+     */
+    static isPort(value: number | string): boolean;
+    /**
+     * 验证 IP 地址
+     */
+    static isIP(value: string): boolean;
+    /**
+     * 验证路径格式
+     */
+    static isPath(value: string): boolean;
+    /**
+     * 验证 API Key 格式（基本验证）
+     */
+    static isAPIKey(value: string): boolean;
+    /**
+     * 验证数字范围
+     */
+    static isInRange(value: number, min: number, max: number): boolean;
+    /**
+     * 验证字符串长度范围
+     */
+    static isLengthInRange(value: string, min: number, max: number): boolean;
+    /**
+     * 验证是否为有效的 JSON
+     */
+    static isJSON(value: string): boolean;
+    /**
+     * 验证对象是否包含必需的键
+     */
+    static hasRequiredKeys(obj: any, keys: string[]): boolean;
+    /**
+     * 验证枚举值
+     */
+    static isInEnum<T>(value: T, enumValues: T[]): boolean;
+    /**
+     * 验证正整数
+     */
+    static isPositiveInteger(value: number): boolean;
+    /**
+     * 验证布尔值
+     */
+    static isBoolean(value: any): boolean;
+    /**
+     * 自定义验证器
+     */
+    static custom(value: any, validator: (val: any) => boolean): boolean;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIzC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKtC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASpC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAK9C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMnC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKrC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKvC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIlE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxE;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASrC;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO;IAQzD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,OAAO;IAItD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIhD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIrC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO;CAGrE"}

package/dist/utils/validator.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * 输入验证工具
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validator = void 0;
+class Validator {
+    /**
+     * 验证字符串非空
+     */
+    static isNonEmpty(value) {
+        return typeof value === 'string' && value.trim().length > 0;
+    }
+    /**
+     * 验证邮箱格式
+     */
+    static isEmail(value) {
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return emailRegex.test(value);
+    }
+    /**
+     * 验证 URL 格式
+     */
+    static isURL(value) {
+        try {
+            new URL(value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 验证端口号
+     */
+    static isPort(value) {
+        const port = typeof value === 'string' ? parseInt(value, 10) : value;
+        return !isNaN(port) && port >= 1 && port <= 65535;
+    }
+    /**
+     * 验证 IP 地址
+     */
+    static isIP(value) {
+        const ipv4Regex = /^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+        return ipv4Regex.test(value);
+    }
+    /**
+     * 验证路径格式
+     */
+    static isPath(value) {
+        // 基本路径格式验证
+        return typeof value === 'string' && value.length > 0 && !value.includes('\0');
+    }
+    /**
+     * 验证 API Key 格式（基本验证）
+     */
+    static isAPIKey(value) {
+        // 基本验证：非空且长度合理
+        return this.isNonEmpty(value) && value.length >= 10;
+    }
+    /**
+     * 验证数字范围
+     */
+    static isInRange(value, min, max) {
+        return typeof value === 'number' && value >= min && value <= max;
+    }
+    /**
+     * 验证字符串长度范围
+     */
+    static isLengthInRange(value, min, max) {
+        return typeof value === 'string' && value.length >= min && value.length <= max;
+    }
+    /**
+     * 验证是否为有效的 JSON
+     */
+    static isJSON(value) {
+        try {
+            JSON.parse(value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 验证对象是否包含必需的键
+     */
+    static hasRequiredKeys(obj, keys) {
+        if (typeof obj !== 'object' || obj === null) {
+            return false;
+        }
+        return keys.every((key) => key in obj);
+    }
+    /**
+     * 验证枚举值
+     */
+    static isInEnum(value, enumValues) {
+        return enumValues.includes(value);
+    }
+    /**
+     * 验证正整数
+     */
+    static isPositiveInteger(value) {
+        return Number.isInteger(value) && value > 0;
+    }
+    /**
+     * 验证布尔值
+     */
+    static isBoolean(value) {
+        return typeof value === 'boolean';
+    }
+    /**
+     * 自定义验证器
+     */
+    static custom(value, validator) {
+        return validator(value);
+    }
+}
+exports.Validator = Validator;
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

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