@nest-omni/core 4.1.3-2 → 4.1.3-4

package/validators/custom-validate.validator.js

@@ -28,6 +28,9 @@ let CustomValidateValidator = class CustomValidateValidator {
     constructor(moduleRef) {
         this.moduleRef = moduleRef;
     }
+    /**
+     * 验证入口
+     */
     validate(value, args) {
         return __awaiter(this, void 0, void 0, function* () {
             const [constraint, ...extraArgs] = args.constraints;
@@ -40,12 +43,15 @@ let CustomValidateValidator = class CustomValidateValidator {
                 args,
             };
             try {
+                // 1. 如果是函数，直接调用
                 if (typeof constraint === 'function') {
                     return yield this.callFunction(constraint, value, context, extraArgs);
                 }
+                // 2. 如果是字符串，调用 Entity 方法
                 if (typeof constraint === 'string') {
                     return yield this.callEntityMethod(args.object, constraint, value, context, extraArgs);
                 }
+                // 3. 如果是数组，调用 Service 方法
                 if (Array.isArray(constraint)) {
                     return yield this.callServiceMethod(constraint, value, context);
                 }
@@ -53,17 +59,24 @@ let CustomValidateValidator = class CustomValidateValidator {
                     `Expected: function, string, or array. Got: ${typeof constraint}`);
             }
             catch (error) {
+                // 验证函数执行出错，记录详细错误信息
                 console.error(`[@CustomValidate] Validation error for property "${args.property}":`, error);
                 throw error;
             }
         });
     }
+    /**
+     * 调用内联函数
+     */
     callFunction(fn, value, context, extraArgs) {
         return __awaiter(this, void 0, void 0, function* () {
             const result = fn(value, context, ...extraArgs);
             return result instanceof Promise ? yield result : result;
         });
     }
+    /**
+     * 调用 Entity 方法
+     */
     callEntityMethod(entity, methodName, value, context, extraArgs) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!entity || typeof entity[methodName] !== 'function') {
@@ -74,13 +87,18 @@ let CustomValidateValidator = class CustomValidateValidator {
             return result instanceof Promise ? yield result : result;
         });
     }
+    /**
+     * 调用 Service 方法
+     */
     callServiceMethod(constraint, value, context) {
         return __awaiter(this, void 0, void 0, function* () {
             let [serviceClass, methodName, ...extraArgs] = constraint;
+            // 验证参数
             if (!serviceClass || !methodName) {
                 throw new Error(`[@CustomValidate] Invalid service constraint format. ` +
                     `Expected: [ServiceClass, 'methodName'] or [() => ServiceClass, 'methodName']`);
             }
+            // 解析延迟引用（解决循环依赖）
             if (typeof serviceClass === 'function' && !serviceClass.prototype) {
                 serviceClass = serviceClass();
             }
@@ -89,6 +107,7 @@ let CustomValidateValidator = class CustomValidateValidator {
                     `This may be caused by circular dependencies. ` +
                     `Consider using lazy reference: [() => ServiceClass, 'methodName']`);
             }
+            // 通过依赖注入获取 service 实例
             let service;
             try {
                 service = this.moduleRef.get(serviceClass, { strict: false });
@@ -106,7 +125,11 @@ let CustomValidateValidator = class CustomValidateValidator {
             return result instanceof Promise ? yield result : result;
         });
     }
+    /**
+     * 默认错误消息
+     */
     defaultMessage(args) {
+        // 优先使用 i18n
         return (0, nestjs_i18n_1.i18nValidationMessage)('validation.CUSTOM_VALIDATE')(args);
     }
 };
@@ -116,6 +139,67 @@ exports.CustomValidateValidator = CustomValidateValidator = __decorate([
     (0, class_validator_1.ValidatorConstraint)({ name: 'customValidate', async: true }),
     __metadata("design:paramtypes", [core_1.ModuleRef])
 ], CustomValidateValidator);
+/**
+ * @CustomValidate 装饰器
+ *
+ * 支持多种验证方式的灵活验证装饰器
+ *
+ * @example
+ * // 1. 内联函数（同步）
+ * @CustomValidate(
+ *   (value) => value > 0,
+ *   { message: '价格必须大于0' }
+ * )
+ * price: number;
+ *
+ * @example
+ * // 2. 内联函数（异步）
+ * @CustomValidate(
+ *   async (value, context) => {
+ *     const response = await fetch(`/api/check/${value}`);
+ *     return response.ok;
+ *   }
+ * )
+ * username: string;
+ *
+ * @example
+ * // 3. Entity 方法
+ * @CustomValidate('validateVersion')
+ * version: string;
+ *
+ * validateVersion(value: string): boolean {
+ *   return /^\d+\.\d+\.\d+$/.test(value);
+ * }
+ *
+ * @example
+ * // 4. Service 方法
+ * @CustomValidate([UserValidationService, 'checkUsername'])
+ * username: string;
+ *
+ * @example
+ * // 5. 延迟引用（解决循环依赖）
+ * @CustomValidate([() => UserValidationService, 'checkUsername'])
+ * username: string;
+ *
+ * @example
+ * // 6. 带额外参数
+ * @CustomValidate(
+ *   [ValidationService, 'checkRange', 0, 100],
+ *   { message: '价格必须在 0-100 之间' }
+ * )
+ * price: number;
+ *
+ * @example
+ * // 7. 使用 i18n
+ * @CustomValidate(
+ *   (value) => value.length >= 6,
+ *   { message: 'validation.PASSWORD_TOO_SHORT' }
+ * )
+ * password: string;
+ *
+ * @param constraint 验证约束（函数、方法名、或 [Service, 方法名]）
+ * @param validationOptions 验证选项
+ */
 function CustomValidate(constraint, validationOptions) {
     return (object, propertyName) => {
         (0, class_validator_1.registerDecorator)({

package/validators/index.d.ts

@@ -5,3 +5,4 @@ export * from './is-exists.validator';
 export * from './is-unique.validator';
 export * from './same-as.validator';
 export * from './custom-validate.validator';
+export * from './common-validators';

package/validators/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./is-exists.validator"), exports);
 __exportStar(require("./is-unique.validator"), exports);
 __exportStar(require("./same-as.validator"), exports);
 __exportStar(require("./custom-validate.validator"), exports);
+__exportStar(require("./common-validators"), exports);

package/validators/is-exists.validator.d.ts

@@ -5,7 +5,18 @@ import { TransactionalAdapterTypeOrm } from '@nestjs-cls/transactional-adapter-t
 export declare class IsExistsValidator implements ValidatorConstraintInterface {
     private readonly transactionHost;
     constructor(transactionHost: TransactionHost<TransactionalAdapterTypeOrm>);
+    /**
+     * 解析 Entity 引用，支持多种形式：
+     * 1. Entity 类直接引用
+     * 2. 延迟函数 () => Entity
+     * 3. 字符串名称 "EntityName"
+     * 4. undefined (从属性名自动推断)
+     */
     private resolveEntity;
+    /**
+     * 从属性名推断 Entity 名称
+     * 例如：appId -> App, userId -> User
+     */
     private inferEntityNameFromProperty;
     validate<E>(value: string, args: IExistsValidationArguments<E>): Promise<boolean>;
     defaultMessage(args: ValidationArguments): string;

package/validators/is-exists.validator.js

@@ -28,26 +28,41 @@ let IsExistsValidator = class IsExistsValidator {
     constructor(transactionHost) {
         this.transactionHost = transactionHost;
     }
+    /**
+     * 解析 Entity 引用，支持多种形式：
+     * 1. Entity 类直接引用
+     * 2. 延迟函数 () => Entity
+     * 3. 字符串名称 "EntityName"
+     * 4. undefined (从属性名自动推断)
+     */
     resolveEntity(entityRef, propertyName, object) {
+        // 1. 如果是字符串，直接返回（TypeORM 支持字符串）
         if (typeof entityRef === 'string') {
             return entityRef;
         }
+        // 2. 如果是函数，需要区分延迟函数和 Entity 类
         if (typeof entityRef === 'function') {
+            // 2.1 箭头函数没有 prototype，是延迟函数
             if (!entityRef.prototype) {
                 const resolved = entityRef();
                 if (resolved)
                     return resolved;
             }
             else {
+                // 2.2 有 prototype，是 Entity 类或普通构造函数
+                // 直接返回
                 return entityRef;
             }
         }
+        // 3. 如果是 undefined，尝试从属性名推断 Entity
+        // 例如：appId -> AppEntity, userId -> UserEntity
         if (!entityRef) {
             const inferredEntityName = this.inferEntityNameFromProperty(propertyName);
             if (inferredEntityName) {
                 console.warn(`[IsExists] Entity reference is undefined for property "${propertyName}". ` +
                     `This may be caused by circular dependencies. ` +
                     `Consider using lazy reference: () => ${inferredEntityName}`);
+                // 返回字符串形式的 Entity 名称
                 return inferredEntityName;
             }
         }
@@ -58,16 +73,23 @@ let IsExistsValidator = class IsExistsValidator {
             `2. String reference: @IsExists(["EntityName", ...])\n` +
             `3. Break the circular dependency`);
     }
+    /**
+     * 从属性名推断 Entity 名称
+     * 例如：appId -> App, userId -> User
+     */
     inferEntityNameFromProperty(propertyName) {
+        // 移除常见后缀：Id, Ids, Key, Code
         const name = propertyName.replace(/(Id|Ids|Key|Code)$/, '');
         if (!name)
             return null;
+        // 转换为 PascalCase 并添加 Entity 后缀
         const entityName = name.charAt(0).toUpperCase() + name.slice(1) + 'Entity';
         return entityName;
     }
     validate(value, args) {
         return __awaiter(this, void 0, void 0, function* () {
             const [entityRef, findCondition] = args.constraints;
+            // 解析 Entity 引用
             const entityClass = this.resolveEntity(entityRef, args.property, args.object);
             const repository = this.transactionHost.tx.getRepository(entityClass);
             args.value = value;

package/validators/is-unique.validator.d.ts

@@ -5,7 +5,18 @@ import { TransactionalAdapterTypeOrm } from '@nestjs-cls/transactional-adapter-t
 export declare class IsUniqueValidator implements ValidatorConstraintInterface {
     private readonly transactionHost;
     constructor(transactionHost: TransactionHost<TransactionalAdapterTypeOrm>);
+    /**
+     * 解析 Entity 引用，支持多种形式：
+     * 1. Entity 类直接引用
+     * 2. 延迟函数 () => Entity
+     * 3. 字符串名称 "EntityName"
+     * 4. undefined (从属性名自动推断)
+     */
     private resolveEntity;
+    /**
+     * 从属性名推断 Entity 名称
+     * 例如：appId -> App, userId -> User
+     */
     private inferEntityNameFromProperty;
     validate<E>(value: string, args: IUniqueValidationArguments<E>): Promise<boolean>;
     defaultMessage(args: ValidationArguments): string;

package/validators/is-unique.validator.js

@@ -28,20 +28,33 @@ let IsUniqueValidator = class IsUniqueValidator {
     constructor(transactionHost) {
         this.transactionHost = transactionHost;
     }
+    /**
+     * 解析 Entity 引用，支持多种形式：
+     * 1. Entity 类直接引用
+     * 2. 延迟函数 () => Entity
+     * 3. 字符串名称 "EntityName"
+     * 4. undefined (从属性名自动推断)
+     */
     resolveEntity(entityRef, propertyName, object) {
+        // 1. 如果是字符串，直接返回（TypeORM 支持字符串）
         if (typeof entityRef === 'string') {
             return entityRef;
         }
+        // 2. 如果是函数，需要区分延迟函数和 Entity 类
         if (typeof entityRef === 'function') {
+            // 2.1 箭头函数没有 prototype，是延迟函数
             if (!entityRef.prototype) {
                 const resolved = entityRef();
                 if (resolved)
                     return resolved;
             }
             else {
+                // 2.2 有 prototype，是 Entity 类或普通构造函数
+                // 直接返回
                 return entityRef;
             }
         }
+        // 3. 如果是 undefined，尝试从属性名推断 Entity
         if (!entityRef) {
             const inferredEntityName = this.inferEntityNameFromProperty(propertyName);
             if (inferredEntityName) {
@@ -58,6 +71,10 @@ let IsUniqueValidator = class IsUniqueValidator {
             `2. String reference: @IsUnique(["EntityName", ...])\n` +
             `3. Break the circular dependency`);
     }
+    /**
+     * 从属性名推断 Entity 名称
+     * 例如：appId -> App, userId -> User
+     */
     inferEntityNameFromProperty(propertyName) {
         const name = propertyName.replace(/(Id|Ids|Key|Code)$/, '');
         if (!name)
@@ -68,6 +85,7 @@ let IsUniqueValidator = class IsUniqueValidator {
     validate(value, args) {
         return __awaiter(this, void 0, void 0, function* () {
             const [entityRef, findCondition] = args.constraints;
+            // 解析 Entity 引用
             const entityClass = this.resolveEntity(entityRef, args.property, args.object);
             const repository = this.transactionHost.tx.getRepository(entityClass);
             args.value = value;
@@ -75,13 +93,20 @@ let IsUniqueValidator = class IsUniqueValidator {
             const defCon = findCondition(args);
             const pkCols = repository.metadata
                 .primaryColumns.map((column) => column.propertyName);
-            const isNew = pkCols.some((pk) => args.object[pk]);
-            if (!isNew) {
+            // 修复：检查是否为新建记录
+            // 如果所有主键都没有值（null/undefined），则为新建
+            const isNew = !pkCols.some((pk) => {
+                const pkValue = args.object[pk];
+                return pkValue !== null && pkValue !== undefined && pkValue !== '';
+            });
+            if (isNew) {
+                // 新建场景：简单检查是否存在相同值的记录
                 exists =
                     (yield repository
                         .count({ where: defCon })) < 1;
             }
             else {
+                // 更新场景：需要排除当前记录（通过主键对比）
                 const entities = yield repository
                     .createQueryBuilder()
                     .where(defCon)
@@ -90,16 +115,19 @@ let IsUniqueValidator = class IsUniqueValidator {
                     .execute();
                 const entityCount = entities.length;
                 if (entityCount === 1) {
+                    // 只有一条记录，检查是否是当前记录本身
                     const entity = entities[0];
                     const oldPk = {};
                     const newPk = {};
-                    pkCols.map((pk) => {
+                    pkCols.forEach((pk) => {
                         oldPk[pk] = entity[pk];
                         newPk[pk] = args.object[pk];
                     });
+                    // 如果主键相同，说明是自己，允许（唯一）
                     exists = JSON.stringify(oldPk) === JSON.stringify(newPk);
                 }
                 else {
+                    // 0条或多条记录
                     exists = entityCount < 1;
                 }
             }

package/validators/skip-empty.validator.d.ts

@@ -1 +1,6 @@
+/**
+ * When the value is emtpy, validation is skipped
+ * @param field
+ * @constructor
+ */
 export declare function SkipEmpty(field?: string): <TFunction extends Function, Y>(target: TFunction | object, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<Y>) => void;

package/validators/skip-empty.validator.js

@@ -5,6 +5,11 @@ const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const lodash_1 = require("lodash");
+/**
+ * When the value is emtpy, validation is skipped
+ * @param field
+ * @constructor
+ */
 function SkipEmpty(field) {
     return (0, common_1.applyDecorators)((0, swagger_1.ApiProperty)({ required: false }), (0, class_validator_1.ValidateIf)((obj, value) => {
         if (field) {

package/vault/interfaces/vault-options.interface.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Vault 认证选项
+ */
 export interface VaultAuthOptions {
     token?: string;
     roleId?: string;
@@ -5,6 +8,9 @@ export interface VaultAuthOptions {
     k8sRole?: string;
     k8sServiceAccountToken?: string;
 }
+/**
+ * Vault 配置选项
+ */
 export interface VaultOptions {
     endpoint: string;
     auth: VaultAuthOptions;
@@ -16,6 +22,9 @@ export interface VaultOptions {
     hotReloadInterval?: number;
     failOnError?: boolean;
 }
+/**
+ * Vault 配置
+ */
 export interface VaultConfig {
     enabled: boolean;
     options?: VaultOptions;

package/vault/vault-config.loader.d.ts

@@ -1,13 +1,43 @@
+/**
+ * Vault 配置加载器
+ * 负责在应用启动时从 Vault 加载配置并注入到 process.env
+ * 配置优先级: base.env < 环境.env < Vault
+ */
 export declare class VaultConfigLoader {
     private static readonly logger;
     private static vaultClient;
     private static hotReloadTimer;
+    /**
+     * 从环境变量构建 Vault 配置
+     */
     private static buildVaultOptions;
+    /**
+     * 初始化 Vault 客户端并进行认证
+     */
     private static initializeVaultClient;
+    /**
+     * 从 Vault 读取指定路径的配置
+     */
     private static readSecrets;
+    /**
+     * 加载 Vault 配置并注入到 process.env
+     * 配置优先级: base.env < 环境.env < Vault（Vault 会覆盖之前的配置）
+     */
     static loadVaultConfig(): Promise<void>;
+    /**
+     * 启动配置热更新
+     */
     private static startHotReload;
+    /**
+     * 停止热更新
+     */
     static stopHotReload(): void;
+    /**
+     * 获取 Vault 客户端（用于运行时动态读取）
+     */
     static getVaultClient(): any;
+    /**
+     * 检查 Vault 是否已连接
+     */
     static isConnected(): boolean;
 }

package/vault/vault-config.loader.js

@@ -11,7 +11,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VaultConfigLoader = void 0;
 const common_1 = require("@nestjs/common");
+/**
+ * Vault 配置加载器
+ * 负责在应用启动时从 Vault 加载配置并注入到 process.env
+ * 配置优先级: base.env < 环境.env < Vault
+ */
 class VaultConfigLoader {
+    /**
+     * 从环境变量构建 Vault 配置
+     */
     static buildVaultOptions() {
         var _a;
         const enabled = process.env.VAULT_ENABLED === 'true';
@@ -29,6 +37,7 @@ class VaultConfigLoader {
             this.logger.warn('Vault enabled but VAULT_SECRET_PATHS is empty');
             return null;
         }
+        // 构建认证配置
         const auth = {};
         if (process.env.VAULT_TOKEN) {
             auth.token = process.env.VAULT_TOKEN;
@@ -57,13 +66,17 @@ class VaultConfigLoader {
             timeout: parseInt(process.env.VAULT_TIMEOUT || '5000', 10),
             enableHotReload: process.env.VAULT_HOT_RELOAD === 'true',
             hotReloadInterval: parseInt(process.env.VAULT_HOT_RELOAD_INTERVAL || '300', 10),
-            failOnError: process.env.VAULT_FAIL_ON_ERROR !== 'false',
+            failOnError: process.env.VAULT_FAIL_ON_ERROR !== 'false', // 默认失败时终止
         };
         this.logger.log(`Vault configuration loaded: ${secretPaths.length} secret path(s)`);
         return options;
     }
+    /**
+     * 初始化 Vault 客户端并进行认证
+     */
     static initializeVaultClient(options) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 动态导入 node-vault
             let vault;
             try {
                 vault = yield Promise.resolve().then(() => require('node-vault'));
@@ -79,12 +92,15 @@ class VaultConfigLoader {
                     timeout: options.timeout,
                 },
             });
+            // 根据认证方式进行认证
             try {
                 if (options.auth.token) {
+                    // Token 认证
                     client.token = options.auth.token;
                     this.logger.log('Vault Token authentication configured');
                 }
                 else if (options.auth.roleId && options.auth.secretId) {
+                    // AppRole 认证
                     const result = yield client.approleLogin({
                         role_id: options.auth.roleId,
                         secret_id: options.auth.secretId,
@@ -93,7 +109,9 @@ class VaultConfigLoader {
                     this.logger.log('Vault AppRole authentication successful');
                 }
                 else if (options.auth.k8sRole) {
+                    // Kubernetes 认证
                     let jwt = options.auth.k8sServiceAccountToken;
+                    // 如果没有提供 token，从默认路径读取
                     if (!jwt) {
                         const fs = yield Promise.resolve().then(() => require('fs'));
                         const K8S_SA_TOKEN_PATH = '/var/run/secrets/kubernetes.io/serviceaccount/token';
@@ -114,6 +132,7 @@ class VaultConfigLoader {
                 else {
                     throw new Error('No valid Vault authentication method configured');
                 }
+                // 验证 token 是否有效
                 yield client.tokenLookupSelf();
                 this.logger.log('Vault authentication verified');
                 return client;
@@ -124,6 +143,9 @@ class VaultConfigLoader {
             }
         });
     }
+    /**
+     * 从 Vault 读取指定路径的配置
+     */
     static readSecrets(client, secretPath, apiVersion) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
@@ -133,6 +155,8 @@ class VaultConfigLoader {
                     this.logger.warn(`No data found at path: ${secretPath}`);
                     return {};
                 }
+                // KV v2 引擎的数据在 data.data 中
+                // KV v1 引擎的数据在 data 中
                 const secrets = apiVersion === 'v2' ? result.data.data : result.data;
                 if (!secrets || typeof secrets !== 'object') {
                     this.logger.warn(`Invalid secret format at path: ${secretPath}`);
@@ -148,6 +172,10 @@ class VaultConfigLoader {
             }
         });
     }
+    /**
+     * 加载 Vault 配置并注入到 process.env
+     * 配置优先级: base.env < 环境.env < Vault（Vault 会覆盖之前的配置）
+     */
     static loadVaultConfig() {
         return __awaiter(this, void 0, void 0, function* () {
             const options = this.buildVaultOptions();
@@ -158,11 +186,14 @@ class VaultConfigLoader {
             try {
                 this.logger.log(`Connecting to Vault at ${options.endpoint}`);
                 this.vaultClient = yield this.initializeVaultClient(options);
+                // 从所有配置路径读取配置（后面的路径会覆盖前面的）
                 const allSecrets = {};
                 for (const secretPath of options.secretPaths) {
                     const secrets = yield this.readSecrets(this.vaultClient, secretPath, options.apiVersion);
+                    // 合并配置（后面的路径会覆盖前面的）
                     Object.assign(allSecrets, secrets);
                 }
+                // 注入到 process.env（覆盖所有已有的环境变量）
                 let injectedCount = 0;
                 let overriddenCount = 0;
                 for (const [key, value] of Object.entries(allSecrets)) {
@@ -177,12 +208,14 @@ class VaultConfigLoader {
                     }
                 }
                 this.logger.log(`Vault configuration loaded: ${injectedCount} new, ${overriddenCount} overridden`);
+                // 启动热更新（如果启用）
                 if (options.enableHotReload) {
                     this.startHotReload(options);
                 }
             }
             catch (error) {
                 this.logger.error('Failed to load Vault configuration', error.message);
+                // 根据配置决定是否在 Vault 失败时继续启动
                 if (options.failOnError) {
                     this.logger.error('Application startup failed due to Vault error');
                     throw error;
@@ -193,8 +226,12 @@ class VaultConfigLoader {
             }
         });
     }
+    /**
+     * 启动配置热更新
+     */
     static startHotReload(options) {
         this.logger.log(`Starting Vault hot reload with interval: ${options.hotReloadInterval}s`);
+        // 清除之前的定时器
         if (this.hotReloadTimer) {
             clearInterval(this.hotReloadTimer);
         }
@@ -206,6 +243,7 @@ class VaultConfigLoader {
                     const secrets = yield this.readSecrets(this.vaultClient, secretPath, options.apiVersion);
                     Object.assign(allSecrets, secrets);
                 }
+                // 更新 process.env
                 let changedCount = 0;
                 for (const [key, value] of Object.entries(allSecrets)) {
                     const newValue = String(value);
@@ -227,6 +265,9 @@ class VaultConfigLoader {
             }
         }), options.hotReloadInterval * 1000);
     }
+    /**
+     * 停止热更新
+     */
     static stopHotReload() {
         if (this.hotReloadTimer) {
             clearInterval(this.hotReloadTimer);
@@ -234,9 +275,15 @@ class VaultConfigLoader {
             this.logger.log('Vault hot reload stopped');
         }
     }
+    /**
+     * 获取 Vault 客户端（用于运行时动态读取）
+     */
     static getVaultClient() {
         return this.vaultClient;
     }
+    /**
+     * 检查 Vault 是否已连接
+     */
     static isConnected() {
         return this.vaultClient !== null && this.vaultClient !== undefined;
     }