@dofe/infra-common 0.1.1

package/dist/decorators/feature-flag/feature-flag.decorator.js

@@ -0,0 +1,135 @@
+"use strict";
+/**
+ * Feature Flag Decorators
+ *
+ * 提供功能开关装饰器，支持 Unleash 集成或自定义实现。
+ *
+ * 支持的策略:
+ * - 布尔值: 简单开关
+ * - 用户 ID: 基于用户的灰度
+ * - 百分比: 按比例开放
+ * - 环境: 基于运行环境
+ * - 自定义: 自定义评估策略
+ *
+ * @example
+ * ```typescript
+ * // 简单功能开关
+ * @FeatureEnabled('new-dashboard')
+ * @Get('dashboard')
+ * async getDashboard() { ... }
+ *
+ * // 条件开关 - 抛出 NotImplementedException
+ * @FeatureEnabled('beta-feature', { throwIfDisabled: true })
+ * async betaFeature() { ... }
+ *
+ * // 灰度发布 - 基于用户
+ * @FeatureEnabled('premium-feature', { userIdParam: 'userId' })
+ * async premiumFeature(@Param('userId') userId: string) { ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_FLAGS_METADATA_KEY = exports.FEATURE_FLAG_METADATA_KEY = void 0;
+exports.FeatureEnabled = FeatureEnabled;
+exports.FeatureFlags = FeatureFlags;
+exports.IfFeatureEnabled = IfFeatureEnabled;
+exports.BetaFeature = BetaFeature;
+exports.GradualRollout = GradualRollout;
+const common_1 = require("@nestjs/common");
+// ============================================================================
+// Constants
+// ============================================================================
+exports.FEATURE_FLAG_METADATA_KEY = 'feature:flag';
+exports.FEATURE_FLAGS_METADATA_KEY = 'feature:flags';
+// ============================================================================
+// Decorators
+// ============================================================================
+/**
+ * @FeatureEnabled - 功能开关装饰器
+ *
+ * 根据功能开关状态决定是否执行方法。
+ *
+ * @param flagName - 功能标识
+ * @param options - 配置选项
+ *
+ * @example
+ * ```typescript
+ * // 简单开关
+ * @FeatureEnabled('new-feature')
+ * @Get()
+ * async getNewFeature() { ... }
+ *
+ * // 抛出异常
+ * @FeatureEnabled('beta', { throwIfDisabled: true, errorMessage: '功能暂未开放' })
+ * async betaFeature() { ... }
+ * ```
+ */
+function FeatureEnabled(flagName, options) {
+    const flagOptions = {
+        flagName,
+        strategy: 'boolean',
+        throwIfDisabled: false,
+        ...options,
+    };
+    return (0, common_1.SetMetadata)(exports.FEATURE_FLAG_METADATA_KEY, flagOptions);
+}
+/**
+ * @FeatureFlags - 多功能开关装饰器
+ *
+ * 同时检查多个功能开关，全部启用时才执行方法。
+ *
+ * @param flags - 功能开关配置数组
+ *
+ * @example
+ * ```typescript
+ * @FeatureFlags([
+ *     { flagName: 'feature-a' },
+ *     { flagName: 'feature-b', throwIfDisabled: true },
+ * ])
+ * async combinedFeature() { ... }
+ * ```
+ */
+function FeatureFlags(flags) {
+    const flagConfigs = flags.map((f) => ({
+        flagName: f.flagName,
+        strategy: 'boolean',
+        throwIfDisabled: false,
+        ...f.options,
+    }));
+    return (0, common_1.SetMetadata)(exports.FEATURE_FLAGS_METADATA_KEY, flagConfigs);
+}
+/**
+ * @IfFeatureEnabled - 条件装饰器别名
+ *
+ * 与 @FeatureEnabled 相同，但语义更清晰。
+ * 如果功能未启用，抛出 NotFoundException。
+ */
+function IfFeatureEnabled(flagName) {
+    return FeatureEnabled(flagName, { throwIfDisabled: true });
+}
+/**
+ * @BetaFeature - Beta 功能装饰器
+ *
+ * 标记 Beta 功能，仅对特定用户或环境开放。
+ */
+function BetaFeature(flagName, options) {
+    return FeatureEnabled(flagName, {
+        strategy: 'userId',
+        throwIfDisabled: true,
+        errorMessage: 'Beta 功能暂未对您开放',
+        ...options,
+    });
+}
+/**
+ * @GradualRollout - 灰度发布装饰器
+ *
+ * 按百分比逐步开放功能。
+ */
+function GradualRollout(flagName, percentage) {
+    return FeatureEnabled(flagName, {
+        strategy: 'percentage',
+        percentage,
+        throwIfDisabled: true,
+        errorMessage: '功能正在逐步开放中',
+    });
+}
+//# sourceMappingURL=feature-flag.decorator.js.map

package/dist/decorators/feature-flag/feature-flag.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.decorator.js","sourceRoot":"","sources":["../../../src/decorators/feature-flag/feature-flag.decorator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAyGH,wCAYC;AAkBD,oCAcC;AAQD,4CAEC;AAOD,kCAUC;AAOD,wCAUC;AA/LD,2CAA6C;AAE7C,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAElE,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAC3C,QAAA,0BAA0B,GAAG,eAAe,CAAC;AAwE1D,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,OAAuD;IAEvD,MAAM,WAAW,GAAuB;QACtC,QAAQ;QACR,QAAQ,EAAE,SAAS;QACnB,eAAe,EAAE,KAAK;QACtB,GAAG,OAAO;KACX,CAAC;IAEF,OAAO,IAAA,oBAAW,EAAC,iCAAyB,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAC1B,KAGE;IAEF,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,SAAgC;QAC1C,eAAe,EAAE,KAAK;QACtB,GAAG,CAAC,CAAC,OAAO;KACb,CAAC,CAAC,CAAC;IAEJ,OAAO,IAAA,oBAAW,EAAC,kCAA0B,EAAE,WAAW,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,cAAc,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CACzB,QAAgB,EAChB,OAAkC;IAElC,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,QAAQ,EAAE,QAAQ;QAClB,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,eAAe;QAC7B,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAC5B,QAAgB,EAChB,UAAkB;IAElB,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,QAAQ,EAAE,YAAY;QACtB,UAAU;QACV,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,WAAW;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/decorators/feature-flag/feature-flag.interceptor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Feature Flag Interceptor
+ *
+ * 拦截器实现，处理 @FeatureEnabled 装饰器逻辑。
+ */
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { Logger } from 'winston';
+import { FeatureFlagService } from './feature-flag.service';
+export declare class FeatureFlagInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly featureFlagService;
+    private readonly logger;
+    constructor(reflector: Reflector, featureFlagService: FeatureFlagService, logger: Logger);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    /**
+     * 评估单个功能开关
+     */
+    private evaluateFlag;
+    /**
+     * 评估多个功能开关
+     */
+    private evaluateMultipleFlags;
+    /**
+     * 处理功能未启用
+     */
+    private handleDisabled;
+}
+//# sourceMappingURL=feature-flag.interceptor.d.ts.map

package/dist/decorators/feature-flag/feature-flag.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.interceptor.d.ts","sourceRoot":"","sources":["../../../src/decorators/feature-flag/feature-flag.interceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,WAAW,EAGZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAY,MAAM,MAAM,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAQjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qBACa,sBAAuB,YAAW,eAAe;IAE1D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFvC,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,kBAAkB,EACL,MAAM,EAAE,MAAM;IAGlE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;IA8DxE;;OAEG;YACW,YAAY;IAgB1B;;OAEG;YACW,qBAAqB;IAgBnC;;OAEG;IACH,OAAO,CAAC,cAAc;CAUvB"}

package/dist/decorators/feature-flag/feature-flag.interceptor.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Feature Flag Interceptor
+ *
+ * 拦截器实现，处理 @FeatureEnabled 装饰器逻辑。
+ */
+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 __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.FeatureFlagInterceptor = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const nest_winston_1 = require("nest-winston");
+const winston_1 = require("winston");
+const feature_flag_decorator_1 = require("./feature-flag.decorator");
+const feature_flag_service_1 = require("./feature-flag.service");
+let FeatureFlagInterceptor = class FeatureFlagInterceptor {
+    reflector;
+    featureFlagService;
+    logger;
+    constructor(reflector, featureFlagService, logger) {
+        this.reflector = reflector;
+        this.featureFlagService = featureFlagService;
+        this.logger = logger;
+    }
+    intercept(context, next) {
+        const handler = context.getHandler();
+        // 获取单个功能开关
+        const flagOptions = this.reflector.get(feature_flag_decorator_1.FEATURE_FLAG_METADATA_KEY, handler);
+        // 获取多个功能开关
+        const flagsOptions = this.reflector.get(feature_flag_decorator_1.FEATURE_FLAGS_METADATA_KEY, handler);
+        // 无功能开关配置，直接执行
+        if (!flagOptions && !flagsOptions) {
+            return next.handle();
+        }
+        // 构建评估上下文
+        const request = context.switchToHttp().getRequest();
+        const flagContext = {
+            userId: request.user?.id || request.userId,
+            environment: process.env.NODE_ENV,
+            request: {
+                ip: request.ip,
+                sessionId: request.session?.id,
+                headers: request.headers,
+            },
+            properties: {},
+        };
+        // 处理单个功能开关
+        if (flagOptions) {
+            return (0, rxjs_1.from)(this.evaluateFlag(flagOptions, flagContext)).pipe((0, operators_1.switchMap)((isEnabled) => {
+                if (isEnabled) {
+                    return next.handle();
+                }
+                return this.handleDisabled(flagOptions);
+            }));
+        }
+        // 处理多个功能开关
+        if (flagsOptions) {
+            return (0, rxjs_1.from)(this.evaluateMultipleFlags(flagsOptions, flagContext)).pipe((0, operators_1.switchMap)((allEnabled) => {
+                if (allEnabled) {
+                    return next.handle();
+                }
+                // 找到第一个未启用的开关
+                const disabledFlag = flagsOptions.find((f) => f.throwIfDisabled);
+                return this.handleDisabled(disabledFlag || flagsOptions[0]);
+            }));
+        }
+        return next.handle();
+    }
+    /**
+     * 评估单个功能开关
+     */
+    async evaluateFlag(options, context) {
+        const isEnabled = await this.featureFlagService.evaluate(options, context);
+        this.logger.debug('Feature flag evaluated', {
+            flagName: options.flagName,
+            isEnabled,
+            strategy: options.strategy,
+            userId: context.userId,
+        });
+        return isEnabled;
+    }
+    /**
+     * 评估多个功能开关
+     */
+    async evaluateMultipleFlags(optionsList, context) {
+        for (const options of optionsList) {
+            const isEnabled = await this.featureFlagService.evaluate(options, context);
+            if (!isEnabled) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 处理功能未启用
+     */
+    handleDisabled(options) {
+        if (options.throwIfDisabled) {
+            const message = options.errorMessage || `功能 ${options.flagName} 暂未开放`;
+            throw new common_1.NotImplementedException(message);
+        }
+        // 返回空响应
+        return (0, rxjs_1.of)(null);
+    }
+};
+exports.FeatureFlagInterceptor = FeatureFlagInterceptor;
+exports.FeatureFlagInterceptor = FeatureFlagInterceptor = __decorate([
+    (0, common_1.Injectable)(),
+    __param(2, (0, common_1.Inject)(nest_winston_1.WINSTON_MODULE_PROVIDER)),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        feature_flag_service_1.FeatureFlagService,
+        winston_1.Logger])
+], FeatureFlagInterceptor);
+//# sourceMappingURL=feature-flag.interceptor.js.map

package/dist/decorators/feature-flag/feature-flag.interceptor.js.map

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

package/dist/decorators/feature-flag/feature-flag.module.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Feature Flag Module
+ *
+ * 提供功能开关服务的全局模块。
+ * 支持 Unleash 集成或自定义 Redis/内存实现。
+ */
+export declare class FeatureFlagModule {
+}
+//# sourceMappingURL=feature-flag.module.d.ts.map

package/dist/decorators/feature-flag/feature-flag.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.module.d.ts","sourceRoot":"","sources":["../../../src/decorators/feature-flag/feature-flag.module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,qBAYa,iBAAiB;CAAG"}

package/dist/decorators/feature-flag/feature-flag.module.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Feature Flag Module
+ *
+ * 提供功能开关服务的全局模块。
+ * 支持 Unleash 集成或自定义 Redis/内存实现。
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureFlagModule = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const config_1 = require("@nestjs/config");
+const infra_redis_1 = require("@dofe/infra-redis");
+const feature_flag_service_1 = require("./feature-flag.service");
+const feature_flag_interceptor_1 = require("./feature-flag.interceptor");
+let FeatureFlagModule = class FeatureFlagModule {
+};
+exports.FeatureFlagModule = FeatureFlagModule;
+exports.FeatureFlagModule = FeatureFlagModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, infra_redis_1.RedisModule],
+        providers: [
+            feature_flag_service_1.FeatureFlagService,
+            {
+                provide: core_1.APP_INTERCEPTOR,
+                useClass: feature_flag_interceptor_1.FeatureFlagInterceptor,
+            },
+        ],
+        exports: [feature_flag_service_1.FeatureFlagService],
+    })
+], FeatureFlagModule);
+//# sourceMappingURL=feature-flag.module.js.map

package/dist/decorators/feature-flag/feature-flag.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.module.js","sourceRoot":"","sources":["../../../src/decorators/feature-flag/feature-flag.module.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;AAEH,2CAAgD;AAChD,uCAA+C;AAC/C,2CAA8C;AAC9C,mDAAgD;AAChD,iEAA4D;AAC5D,yEAAoE;AAc7D,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAAG,CAAA;AAApB,8CAAiB;4BAAjB,iBAAiB;IAZ7B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,EAAE,yBAAW,CAAC;QACpC,SAAS,EAAE;YACT,yCAAkB;YAClB;gBACE,OAAO,EAAE,sBAAe;gBACxB,QAAQ,EAAE,iDAAsB;aACjC;SACF;QACD,OAAO,EAAE,CAAC,yCAAkB,CAAC;KAC9B,CAAC;GACW,iBAAiB,CAAG"}

package/dist/decorators/feature-flag/feature-flag.service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Feature Flag Service
+ *
+ * 功能开关服务，支持多种后端实现:
+ * - 内存: 开发测试用
+ * - Redis: 生产环境分布式
+ * - Unleash: 企业级功能管理
+ *
+ * 配置项 (config.local.yaml):
+ * ```yaml
+ * featureFlags:
+ *   provider: 'redis'  # 'memory' | 'redis' | 'unleash'
+ *   unleash:
+ *     url: 'http://localhost:4242/api'
+ *     appName: 'pardx-api'
+ *     instanceId: 'instance-1'
+ *   defaultFlags:
+ *     new-feature: true
+ *     beta-dashboard: false
+ * ```
+ */
+import { OnModuleInit } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { Logger } from 'winston';
+import { RedisService } from '@dofe/infra-redis';
+import { FeatureFlagContext, FeatureFlagOptions } from './feature-flag.decorator';
+export type FeatureFlagProvider = 'memory' | 'redis' | 'unleash';
+export interface FeatureFlagRedisConfig {
+    keyPrefix?: string;
+    defaultTTL?: number;
+}
+export interface FeatureFlagConfig {
+    provider: FeatureFlagProvider;
+    redis?: FeatureFlagRedisConfig;
+    unleash?: {
+        url: string;
+        appName: string;
+        instanceId?: string;
+        refreshInterval?: number;
+        metricsInterval?: number;
+    };
+    defaultFlags?: Record<string, boolean>;
+}
+export declare class FeatureFlagService implements OnModuleInit {
+    private readonly configService;
+    private readonly redis;
+    private readonly logger;
+    private provider;
+    private memoryFlags;
+    private unleashClient;
+    private redisKeyPrefix;
+    private redisDefaultTTL;
+    constructor(configService: ConfigService, redis: RedisService, logger: Logger);
+    onModuleInit(): Promise<void>;
+    /**
+     * 初始化 Unleash 客户端
+     */
+    private initUnleash;
+    /**
+     * 检查功能是否启用
+     */
+    isEnabled(flagName: string, context?: FeatureFlagContext): Promise<boolean>;
+    /**
+     * 评估功能开关 (支持策略)
+     */
+    evaluate(options: FeatureFlagOptions, context?: FeatureFlagContext): Promise<boolean>;
+    /**
+     * 设置功能开关
+     * @param flagName 功能开关名称
+     * @param enabled 是否启用
+     * @param ttl 过期时间 (秒), 0=使用默认TTL, -1=永不过期
+     */
+    setFlag(flagName: string, enabled: boolean, ttl?: number): Promise<void>;
+    /**
+     * 获取所有功能开关
+     */
+    getAllFlags(): Promise<Record<string, boolean>>;
+    /**
+     * 删除功能开关
+     */
+    deleteFlag(flagName: string): Promise<void>;
+    /**
+     * 获取功能开关的 TTL (秒)
+     * @returns TTL 秒数, -1=永不过期, -2=不存在
+     */
+    getFlagTTL(flagName: string): Promise<number>;
+    /**
+     * 设置临时功能开关 (自动过期)
+     * @param flagName 功能开关名称
+     * @param enabled 是否启用
+     * @param ttlSeconds 过期时间 (秒)
+     */
+    setTemporaryFlag(flagName: string, enabled: boolean, ttlSeconds: number): Promise<void>;
+    private checkUnleash;
+    private checkRedis;
+    private getAllRedisFlags;
+    private evaluateUserId;
+    private evaluatePercentage;
+    private evaluateEnvironment;
+    private evaluateCustom;
+}
+//# sourceMappingURL=feature-flag.service.d.ts.map

package/dist/decorators/feature-flag/feature-flag.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.service.d.ts","sourceRoot":"","sources":["../../../src/decorators/feature-flag/feature-flag.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAsB,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAOlC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAMD,qBACa,kBAAmB,YAAW,YAAY;IAQnD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAT1D,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,eAAe,CAAK;gBAGT,aAAa,EAAE,aAAa,EAChB,KAAK,EAAE,YAAY,EACE,MAAM,EAAE,MAAM;IAG5D,YAAY;IA2ClB;;OAEG;YACW,WAAW;IA8BzB;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC;IAoBnB;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,OAAO,CAAC;IAyBnB;;;;;OAKG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAUrD;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjD;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnD;;;;;OAKG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAQhB,OAAO,CAAC,YAAY;YAkBN,UAAU;YAUV,gBAAgB;IA+B9B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,mBAAmB;YAUb,cAAc;CAU7B"}