@dofe/infra-common 0.1.1

package/dist/config/env-config.service.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConfig = exports.researchConfig = exports.auditConfig = exports.featureConfig = exports.s3Config = exports.dockerConfig = void 0;
+exports.getEnv = getEnv;
+exports.getEnvWithDefault = getEnvWithDefault;
+exports.hasEnv = hasEnv;
+exports.getNodeEnv = getNodeEnv;
+exports.isProduction = isProduction;
+exports.isDevelopment = isDevelopment;
+exports.getProjectRoot = getProjectRoot;
+exports.clearEnvCache = clearEnvCache;
+/**
+ * Environment Configuration Service
+ *
+ * 提供类型安全的环境变量访问，替代直接使用 process.env
+ *
+ * 使用方式:
+ * 1. 直接导入函数: import { getEnv } from '@/common/config/env-config.service';
+ * 2. 在服务中使用: const botDataDir = getEnv('BOT_DATA_DIR');
+ *
+ * 注意: 此服务在模块初始化后使用，启动时的配置加载仍使用 configuration.ts
+ */
+const configuration_1 = require("./configuration");
+/**
+ * 缓存的环境配置
+ */
+let cachedEnv;
+/**
+ * 获取已验证的环境配置
+ * 如果配置未初始化，返回 process.env 作为 fallback
+ */
+function getValidatedEnv() {
+    if (cachedEnv) {
+        return cachedEnv;
+    }
+    // 尝试从配置服务获取
+    const envConfig = (0, configuration_1.getEnvConfig)();
+    if (envConfig) {
+        cachedEnv = envConfig;
+        return envConfig;
+    }
+    // Fallback: 直接使用 process.env（非验证模式）
+    return process.env;
+}
+/**
+ * 获取单个环境变量（类型安全）
+ *
+ * @param key - 环境变量名
+ * @returns 环境变量值
+ *
+ * @example
+ * const botDataDir = getEnv('BOT_DATA_DIR'); // string
+ * const port = getEnv('API_PORT'); // number (自动转换)
+ * const optional = getEnv('MODE_USER_ID'); // string | undefined
+ */
+function getEnv(key) {
+    const env = getValidatedEnv();
+    return env[key];
+}
+/**
+ * 获取环境变量，带默认值
+ *
+ * @param key - 环境变量名
+ * @param defaultValue - 默认值
+ * @returns 环境变量值或默认值
+ *
+ * @example
+ * const dir = getEnvWithDefault('BOT_DATA_DIR', '/data/bots');
+ */
+function getEnvWithDefault(key, defaultValue) {
+    const value = getEnv(key);
+    return (value ?? defaultValue);
+}
+/**
+ * 检查环境变量是否设置
+ *
+ * @param key - 环境变量名
+ * @returns 是否设置
+ */
+function hasEnv(key) {
+    const env = getValidatedEnv();
+    return env[key] !== undefined && env[key] !== '';
+}
+/**
+ * 获取当前运行环境
+ */
+function getNodeEnv() {
+    return getEnv('NODE_ENV') || 'dev';
+}
+/**
+ * 是否为生产环境
+ */
+function isProduction() {
+    const env = getNodeEnv();
+    return env.startsWith('prod');
+}
+/**
+ * 是否为开发环境
+ */
+function isDevelopment() {
+    return getNodeEnv() === 'dev';
+}
+/**
+ * 获取项目根目录
+ */
+function getProjectRoot() {
+    const root = getEnv('PROJECT_ROOT');
+    if (root?.includes('$(pwd)')) {
+        return root.replace('$(pwd)', process.cwd());
+    }
+    return root || process.cwd();
+}
+// ============================================================================
+// 分类配置获取器（便捷方法）
+// ============================================================================
+/**
+ * Docker/Bot 容器配置
+ */
+exports.dockerConfig = {
+    get images() {
+        return {
+            gateway: getEnvWithDefault('BOT_IMAGE_GATEWAY', 'openclaw:latest'),
+            // Sandbox images - configurable via environment variables
+            toolSandbox: getEnvWithDefault('BOT_IMAGE_TOOL_SANDBOX', 'openclaw-sandbox:bookworm-slim'),
+            browserSandbox: getEnvWithDefault('BOT_IMAGE_BROWSER_SANDBOX', 'openclaw-sandbox-browser:bookworm-slim'),
+        };
+    },
+    get limits() {
+        return {
+            cpu: Number(getEnvWithDefault('GATEWAY_CONTAINER_CPU_LIMIT', 1)),
+            memory: Number(getEnvWithDefault('GATEWAY_CONTAINER_MEMORY_LIMIT', 2147483648)),
+        };
+    },
+    get directories() {
+        return {
+            data: getEnvWithDefault('BOT_DATA_DIR', '/data/bots'),
+            secrets: getEnvWithDefault('BOT_SECRETS_DIR', '/data/secrets'),
+            openclaw: getEnvWithDefault('BOT_OPENCLAW_DIR', '/data/openclaw'),
+        };
+    },
+    get volumes() {
+        return {
+            data: getEnv('DATA_VOLUME_NAME'),
+            secrets: getEnv('SECRETS_VOLUME_NAME'),
+            openclaw: getEnv('OPENCLAW_VOLUME_NAME'),
+        };
+    },
+    get portStart() {
+        return getEnvWithDefault('GATEWAY_DOCKER_PORT_START', 9200);
+    },
+    get openclawSrcPath() {
+        return getEnvWithDefault('OPENCLAW_SRC_PATH', '../openclaw');
+    },
+    get npmRegistry() {
+        return getEnv('NPM_CONFIG_REGISTRY');
+    },
+    get dockerHost() {
+        return getEnvWithDefault('DOCKER_HOST', '/var/run/docker.sock');
+    },
+    get platform() {
+        return getEnvWithDefault('DOCKER_PLATFORM', 'linux/amd64');
+    },
+    get registryAuth() {
+        const username = getEnv('DOCKER_REGISTRY_USERNAME');
+        const password = getEnv('DOCKER_REGISTRY_PASSWORD');
+        const serveraddress = getEnv('DOCKER_REGISTRY_SERVER');
+        if (!username || !password)
+            return null;
+        return { username, password, serveraddress: serveraddress || undefined };
+    },
+    get mcpBuildDir() {
+        return getEnvWithDefault('MCP_BUILD_DIR', '/tmp/mcp-builds');
+    },
+    get sandboxCleanup() {
+        return {
+            idleThresholdMs: Number(getEnvWithDefault('SANDBOX_IDLE_THRESHOLD_MS', 3600000)),
+            gracePeriodMs: Number(getEnvWithDefault('SANDBOX_GRACE_PERIOD_MS', 300000)),
+        };
+    },
+};
+/**
+ * S3 存储配置
+ * 优先读取 config.local.yaml 的 app 段，环境变量作为 fallback
+ */
+exports.s3Config = {
+    get enableRetry() {
+        return ((0, configuration_1.getConfig)()?.app?.enableRetryMechanism ??
+            getEnv('S3_ENABLE_RETRY') ??
+            true);
+    },
+    get enhancedLogging() {
+        return ((0, configuration_1.getConfig)()?.app?.enableEnhancedLogging ??
+            getEnv('S3_ENHANCED_LOGGING') ??
+            true);
+    },
+    get maxRetries() {
+        return ((0, configuration_1.getConfig)()?.app?.maxRetries ?? getEnvWithDefault('S3_MAX_RETRIES', 3));
+    },
+    get retryDelay() {
+        return ((0, configuration_1.getConfig)()?.app?.baseRetryDelay ??
+            getEnvWithDefault('S3_RETRY_DELAY', 1000));
+    },
+};
+/**
+ * 功能开关配置
+ */
+exports.featureConfig = {
+    get swaggerEnabled() {
+        const value = getEnv('SWAGGER_ENABLE');
+        return value === true;
+    },
+    get proxyPreferStats() {
+        const value = getEnv('PROXY_PREFER_STATS');
+        return value === true;
+    },
+    get proxyTokenTtl() {
+        return getEnvWithDefault('PROXY_TOKEN_TTL', 86400);
+    },
+    get zeroTrustMode() {
+        return getEnv('ZERO_TRUST_MODE');
+    },
+    get modeUserId() {
+        return getEnv('MODE_USER_ID');
+    },
+};
+/**
+ * 审计相关配置
+ */
+exports.auditConfig = {
+    /** 审计签名密钥（生产环境必须设置） */
+    get signatureSecret() {
+        return getEnv('AUDIT_SIGNATURE_SECRET');
+    },
+    /** 是否启用 detail 脱敏 */
+    get maskEnabled() {
+        return getEnv('AUDIT_MASK_ENABLED') ?? true;
+    },
+    /** Gateway 审计上报超时（毫秒） */
+    get gatewayAuditTimeoutMs() {
+        return getEnvWithDefault('GATEWAY_AUDIT_TIMEOUT_MS', 5000);
+    },
+    /** Gateway 审计上报端点（可选，默认由 API_BASE_URL 拼接） */
+    get gatewayAuditEndpoint() {
+        return getEnv('GATEWAY_AUDIT_ENDPOINT');
+    },
+    /** API Base URL（用于拼接 Gateway 审计端点） */
+    get apiBaseUrl() {
+        return (getEnv('API_BASE_URL') ||
+            getEnv('INTERNAL_API_BASE_URL') ||
+            'http://localhost:3100');
+    },
+};
+/**
+ * Model Capability Research 配置
+ */
+exports.researchConfig = {
+    /** API Base URL（用于调用内部代理端点） */
+    get apiBaseUrl() {
+        return (getEnv('API_BASE_URL') ||
+            getEnv('INTERNAL_API_BASE_URL') ||
+            'http://localhost:3100');
+    },
+    /** 专用内部研究 Bot 的代理 Token */
+    get researchBotProxyToken() {
+        return getEnv('RESEARCH_BOT_PROXY_TOKEN');
+    },
+    /** Anthropic-compatible 代理端点路径 */
+    get anthropicCompatiblePath() {
+        return '/api/v1/anthropic-compatible/v1/messages';
+    },
+    /** 完整的研究代理端点 URL */
+    get researchProxyEndpoint() {
+        return `${this.apiBaseUrl}${this.anthropicCompatiblePath}`;
+    },
+};
+/**
+ * 服务构建信息
+ */
+exports.buildConfig = {
+    get serverName() {
+        return getEnvWithDefault('MICRO_SERVER_NAME', 'api');
+    },
+    get serverBuild() {
+        return getEnv('SERVER_BUILD');
+    },
+    get gitCommitHash() {
+        return getEnv('GIT_COMMIT_HASH') || getEnv('VERCEL_GIT_COMMIT_SHA');
+    },
+};
+/**
+ * 清除缓存（用于测试）
+ */
+function clearEnvCache() {
+    cachedEnv = undefined;
+}
+//# sourceMappingURL=env-config.service.js.map

package/dist/config/env-config.service.js.map

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

package/dist/config/features/feature-errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Feature Configuration Errors
+ *
+ * 当运行时使用未配置的功能时抛出的标准错误。
+ * 启动期校验失败会在 dev 环境警告、prod 环境阻止启动。
+ * 运行时使用未配置功能始终 throw 此错误。
+ */
+export declare class FeatureNotConfiguredError extends Error {
+    readonly feature: string;
+    readonly missingKey: string;
+    constructor(feature: string, missingKey: string, message?: string);
+}
+//# sourceMappingURL=feature-errors.d.ts.map

package/dist/config/features/feature-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-errors.d.ts","sourceRoot":"","sources":["../../../src/config/features/feature-errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAWlE"}

package/dist/config/features/feature-errors.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureNotConfiguredError = void 0;
+/**
+ * Feature Configuration Errors
+ *
+ * 当运行时使用未配置的功能时抛出的标准错误。
+ * 启动期校验失败会在 dev 环境警告、prod 环境阻止启动。
+ * 运行时使用未配置功能始终 throw 此错误。
+ */
+class FeatureNotConfiguredError extends Error {
+    feature;
+    missingKey;
+    constructor(feature, missingKey, message) {
+        super(message ??
+            `功能 "${feature}" 未配置。缺少: ${missingKey}。` +
+                `请在 keys/config.json 或 config.local.yaml 中添加配置，` +
+                `或在 REQUIRED_FEATURES 中移除此功能声明。`);
+        this.feature = feature;
+        this.missingKey = missingKey;
+        this.name = 'FeatureNotConfiguredError';
+    }
+}
+exports.FeatureNotConfiguredError = FeatureNotConfiguredError;
+//# sourceMappingURL=feature-errors.js.map

package/dist/config/features/feature-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-errors.js","sourceRoot":"","sources":["../../../src/config/features/feature-errors.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,MAAa,yBAA0B,SAAQ,KAAK;IACzC,OAAO,CAAS;IAChB,UAAU,CAAS;IAE5B,YAAY,OAAe,EAAE,UAAkB,EAAE,OAAgB;QAC/D,KAAK,CACH,OAAO;YACL,OAAO,OAAO,aAAa,UAAU,GAAG;gBACtC,gDAAgD;gBAChD,gCAAgC,CACrC,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAfD,8DAeC"}

package/dist/config/features/feature-registry.d.ts

@@ -0,0 +1,26 @@
+export interface FeatureDescriptor {
+    /** 功能唯一标识 */
+    name: string;
+    /** 功能描述 */
+    description?: string;
+    /** 需要的 env 变量（二选一：env 或 keys） */
+    requiredEnvVars?: string[];
+    /** 需要的 yaml 配置路径 */
+    requiredYamlPaths?: string[];
+    /** 需要的 keys 配置路径 */
+    requiredKeysPaths?: string[];
+}
+export interface FeatureValidationContext {
+    env: Record<string, string | undefined>;
+    yaml: Record<string, unknown>;
+    keys: Record<string, unknown> | undefined;
+}
+export interface FeatureValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    validatedFeatures: string[];
+}
+export declare const FEATURE_REGISTRY: Record<string, FeatureDescriptor>;
+export declare function validateRequiredFeatures(requiredFeatures: string[], ctx: FeatureValidationContext): FeatureValidationResult;
+//# sourceMappingURL=feature-registry.d.ts.map

package/dist/config/features/feature-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-registry.d.ts","sourceRoot":"","sources":["../../../src/config/features/feature-registry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB;IACpB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAsF9D,CAAC;AA6DF,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,GAAG,EAAE,wBAAwB,GAC5B,uBAAuB,CA+BzB"}

package/dist/config/features/feature-registry.js

@@ -0,0 +1,172 @@
+"use strict";
+// ============================================================================
+// Feature Registry
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_REGISTRY = void 0;
+exports.validateRequiredFeatures = validateRequiredFeatures;
+exports.FEATURE_REGISTRY = {
+    // ── 核心基础设施 ──
+    database: {
+        name: 'database',
+        description: 'PostgreSQL 数据库连接',
+        requiredEnvVars: ['DATABASE_URL'],
+    },
+    redis: {
+        name: 'redis',
+        description: 'Redis 缓存',
+        requiredEnvVars: ['REDIS_URL'],
+    },
+    rabbitmq: {
+        name: 'rabbitmq',
+        description: 'RabbitMQ 消息队列',
+        requiredEnvVars: ['RABBITMQ_URL'],
+    },
+    // ── 核心安全 ──
+    jwt: {
+        name: 'jwt',
+        description: 'JWT 认证（支持 env 或 keys/config.json 二选一）',
+        requiredKeysPaths: ['jwt'],
+        requiredEnvVars: ['JWT_SECRET'],
+    },
+    crypto: {
+        name: 'crypto',
+        description: 'AES 加解密（支持 env 或 keys/config.json 二选一）',
+        requiredKeysPaths: ['crypto'],
+        requiredEnvVars: ['CRYPTO_KEY'],
+    },
+    // ── 通信 ──
+    email: {
+        name: 'email',
+        description: '邮件服务（SendCloud）',
+        requiredKeysPaths: ['sendcloud'],
+    },
+    sms: {
+        name: 'sms',
+        description: '短信服务',
+        requiredKeysPaths: ['sms'],
+    },
+    // ── 存储 ──
+    storage: {
+        name: 'storage',
+        description: '对象存储',
+        requiredYamlPaths: ['buckets'],
+        requiredKeysPaths: ['storage'],
+    },
+    // ── AI / 语音 ──
+    openai: {
+        name: 'openai',
+        description: 'OpenAI 兼容 API',
+        requiredKeysPaths: ['openai'],
+    },
+    tts: {
+        name: 'tts',
+        description: '语音合成',
+        requiredKeysPaths: ['tts'],
+    },
+    openspeech: {
+        name: 'openspeech',
+        description: '语音识别',
+        requiredKeysPaths: ['openspeech'],
+    },
+    // ── 风控 / 检测 ──
+    'risk-detection': {
+        name: 'risk-detection',
+        description: '风控检测',
+        requiredKeysPaths: ['risk'],
+    },
+    image: {
+        name: 'image',
+        description: '图片处理（火山引擎 Imagex）',
+        requiredKeysPaths: ['image'],
+    },
+    // ── 信息查询 ──
+    ipinfo: {
+        name: 'ipinfo',
+        description: 'IP 地理信息',
+        requiredKeysPaths: ['ipinfo'],
+    },
+    'exchange-rate': {
+        name: 'exchange-rate',
+        description: '汇率查询',
+        requiredKeysPaths: ['exchangerate'],
+    },
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+function getByPath(obj, path) {
+    return path.split('.').reduce((acc, key) => acc?.[key], obj);
+}
+/**
+ * 检查功能是否"至少满足一个来源"：
+ * - jwt/crypto 特殊处理：env 或 keys 二选一即可
+ * - 其他功能：只检查 keysPaths 或 yamlPaths
+ */
+function isFeatureSatisfied(descriptor, ctx) {
+    const missing = [];
+    // 对于同时声明了 env 和 keys 的功能（如 jwt, crypto），二选一即可
+    if (descriptor.requiredEnvVars?.length && descriptor.requiredKeysPaths?.length) {
+        const envOk = descriptor.requiredEnvVars.every((v) => ctx.env[v] !== undefined && ctx.env[v] !== '');
+        const keysOk = !!ctx.keys &&
+            descriptor.requiredKeysPaths.every((p) => getByPath(ctx.keys, p) !== undefined);
+        if (!envOk && !keysOk) {
+            missing.push(`需要环境变量 [${descriptor.requiredEnvVars.join(', ')}] 或 keys 配置 [${descriptor.requiredKeysPaths.join(', ')}]（二选一）`);
+        }
+    }
+    else {
+        // 仅 env
+        for (const envVar of descriptor.requiredEnvVars ?? []) {
+            if (!ctx.env[envVar]) {
+                missing.push(`缺少环境变量: ${envVar}`);
+            }
+        }
+        // 仅 keys
+        for (const keysPath of descriptor.requiredKeysPaths ?? []) {
+            if (!ctx.keys || getByPath(ctx.keys, keysPath) === undefined) {
+                missing.push(`缺少密钥配置: keys.${keysPath}`);
+            }
+        }
+    }
+    // yaml 路径始终单独检查
+    for (const yamlPath of descriptor.requiredYamlPaths ?? []) {
+        if (getByPath(ctx.yaml, yamlPath) === undefined) {
+            missing.push(`缺少 YAML 配置: ${yamlPath}`);
+        }
+    }
+    return { satisfied: missing.length === 0, missing };
+}
+// ============================================================================
+// Validation
+// ============================================================================
+function validateRequiredFeatures(requiredFeatures, ctx) {
+    const errors = [];
+    const warnings = [];
+    const validatedFeatures = [];
+    for (const featureName of requiredFeatures) {
+        const trimmed = featureName.trim();
+        if (!trimmed)
+            continue;
+        const descriptor = exports.FEATURE_REGISTRY[trimmed];
+        if (!descriptor) {
+            warnings.push(`[Feature] 未知的功能声明: "${trimmed}"，已跳过`);
+            continue;
+        }
+        const { satisfied, missing: featureErrors } = isFeatureSatisfied(descriptor, ctx);
+        if (satisfied) {
+            validatedFeatures.push(trimmed);
+        }
+        else {
+            for (const err of featureErrors) {
+                errors.push(`[Feature:${trimmed}] ${err}`);
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        validatedFeatures,
+    };
+}
+//# sourceMappingURL=feature-registry.js.map

package/dist/config/features/feature-registry.js.map

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

package/dist/config/features/index.d.ts

@@ -0,0 +1,4 @@
+export { FEATURE_REGISTRY, validateRequiredFeatures, } from './feature-registry';
+export type { FeatureDescriptor, FeatureValidationContext, FeatureValidationResult, } from './feature-registry';
+export { FeatureNotConfiguredError } from './feature-errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/features/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/features/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeatureNotConfiguredError = exports.validateRequiredFeatures = exports.FEATURE_REGISTRY = void 0;
+var feature_registry_1 = require("./feature-registry");
+Object.defineProperty(exports, "FEATURE_REGISTRY", { enumerable: true, get: function () { return feature_registry_1.FEATURE_REGISTRY; } });
+Object.defineProperty(exports, "validateRequiredFeatures", { enumerable: true, get: function () { return feature_registry_1.validateRequiredFeatures; } });
+var feature_errors_1 = require("./feature-errors");
+Object.defineProperty(exports, "FeatureNotConfiguredError", { enumerable: true, get: function () { return feature_errors_1.FeatureNotConfiguredError; } });
+//# sourceMappingURL=index.js.map

package/dist/config/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/features/index.ts"],"names":[],"mappings":";;;AAAA,uDAG4B;AAF1B,oHAAA,gBAAgB,OAAA;AAChB,4HAAA,wBAAwB,OAAA;AAO1B,mDAA6D;AAApD,2HAAA,yBAAyB,OAAA"}