@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/external-providers/services/external-providers-registry.backend.service.js

@@ -0,0 +1,422 @@
+/**
+ * External Providers Registry Backend Service
+ *
+ * Provides runtime access to the computed external provider registry and
+ * their protocol configurations, secrets, and operations.
+ *
+ * The registry is COMPUTED by CapabilityBindingsBackendService from the
+ * capabilities policy + provider definitions. This service consumes that
+ * computed registry and enriches it with protocol caching, configuration
+ * resolution, and secret access.
+ */
+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); }
+};
+import { injectable, inject } from 'inversify';
+import { CLIRuntime_AuthMode, ExternalProvider_ExchangeProtocol_Kind } from '@wildo-ai/external-connectors-models';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';
+let ExternalProvidersRegistryBackendService = class ExternalProvidersRegistryBackendService {
+    logger;
+    configService;
+    errorBuilder;
+    lazyProviderRegistry;
+    capabilityBindings;
+    logDebug;
+    registry = null;
+    protocolCache = new Map();
+    isInitialized = false;
+    constructor(logger, configService, errorBuilder, lazyProviderRegistry, capabilityBindings) {
+        this.logger = logger;
+        this.configService = configService;
+        this.errorBuilder = errorBuilder;
+        this.lazyProviderRegistry = lazyProviderRegistry;
+        this.capabilityBindings = capabilityBindings;
+        this.logDebug = this.logger.debugByType('ExternalProvidersRegistryBackendService');
+        this.logger.setDebugTypeLogging('ExternalProvidersRegistryBackendService', false);
+        this.logDebug('External providers registry service created (not yet initialized)');
+    }
+    // ================================
+    // Initialization Method
+    // ================================
+    /**
+     * Initialize by reading the computed registry from CapabilityBindingsBackendService.
+     * The registry is no longer stored in appConfig — it's computed from the capabilities policy.
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            this.logDebug('Service already initialized, skipping');
+            return;
+        }
+        if (!this.configService.isInitialized()) {
+            await this.configService.initialize();
+        }
+        const computedMap = this.capabilityBindings.getComputedRegistry();
+        const registry = {};
+        for (const [providerRef, item] of computedMap) {
+            registry[providerRef] = item;
+        }
+        this.registry = registry;
+        await this.preloadEnabledProviders(registry);
+        this.isInitialized = true;
+        this.logDebug('External providers registry initialized from computed capabilities', {
+            totalProviders: Object.keys(registry).length,
+            cachedProtocols: this.protocolCache.size
+        });
+    }
+    /**
+     * Preload protocol definitions for providers in the registry
+     */
+    async preloadEnabledProviders(registry) {
+        const preloadPromises = [];
+        for (const [providerRef, item] of Object.entries(registry)) {
+            for (const protocolKind of item.protocols) {
+                preloadPromises.push(this.loadAndCacheProtocol(providerRef, protocolKind));
+            }
+        }
+        await Promise.all(preloadPromises);
+    }
+    /**
+     * Load a protocol from lazy registry and cache it.
+     * Also loads operations and merges them into the protocol for non-REST_API protocols.
+     */
+    async loadAndCacheProtocol(providerRef, protocolKind) {
+        try {
+            const protocol = await this.lazyProviderRegistry.getProtocol(providerRef, protocolKind);
+            if (protocol) {
+                const cacheKey = `${providerRef}:${protocolKind}`;
+                if (protocolKind !== ExternalProvider_ExchangeProtocol_Kind.REST_API) {
+                    try {
+                        const operations = await this.lazyProviderRegistry.getOperations(providerRef, protocolKind);
+                        if (operations && Object.keys(operations).length > 0) {
+                            protocol.operations = operations;
+                            this.logDebug(`Merged ${Object.keys(operations).length} operations into protocol ${providerRef}:${protocolKind}`);
+                        }
+                    }
+                    catch (opError) {
+                        this.logDebug(`Failed to load operations for ${providerRef}:${protocolKind}`, {
+                            error: opError instanceof Error ? opError.message : String(opError)
+                        });
+                    }
+                }
+                this.protocolCache.set(cacheKey, protocol);
+                this.logDebug(`Cached protocol ${providerRef}:${protocolKind}`);
+            }
+        }
+        catch (error) {
+            this.logDebug(`Failed to preload ${providerRef}:${protocolKind}`, {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    // ================================
+    // Access Methods
+    // ================================
+    getExternalProvidersRegistry() {
+        this.ensureInitialized();
+        return this.registry;
+    }
+    getProviderTypes() {
+        this.ensureInitialized();
+        return Object.keys(this.registry);
+    }
+    getProvider(providerRef) {
+        this.ensureInitialized();
+        return this.registry[providerRef];
+    }
+    hasProvider(providerRef) {
+        this.ensureInitialized();
+        return providerRef in (this.registry || {});
+    }
+    /**
+     * Get provider configuration for a specific protocol.
+     * Falls back to default configuration from cached provider definitions if not overridden.
+     */
+    getProviderConfiguration(providerRef, protocolKind) {
+        this.ensureInitialized();
+        try {
+            if (!this.configService.isInitialized()) {
+                return this.getDefaultProviderConfiguration(providerRef, protocolKind);
+            }
+            const appConfig = this.configService.config;
+            const providerConfigs = appConfig.externalProvidersConfigurations || {};
+            const customConfig = providerConfigs[providerRef]?.[protocolKind];
+            if (customConfig) {
+                this.logDebug(`Using custom configuration for ${providerRef}.${protocolKind}`);
+                return customConfig;
+            }
+            const defaultConfig = this.getDefaultProviderConfiguration(providerRef, protocolKind);
+            if (defaultConfig) {
+                this.logDebug(`Using default configuration for ${providerRef}.${protocolKind}`);
+            }
+            return defaultConfig;
+        }
+        catch (error) {
+            this.logDebug('Error getting provider configuration, falling back to default', {
+                providerRef,
+                protocolKind,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return this.getDefaultProviderConfiguration(providerRef, protocolKind);
+        }
+    }
+    getCLIRuntimeConfiguration(providerRef) {
+        const config = this.getProviderConfiguration(providerRef, ExternalProvider_ExchangeProtocol_Kind.CLI_RUNTIME);
+        return config;
+    }
+    getDefaultProviderConfiguration(providerRef, protocolKind) {
+        try {
+            const cacheKey = `${providerRef}:${protocolKind}`;
+            const protocol = this.protocolCache.get(cacheKey);
+            if (!protocol) {
+                this.logDebug(`Protocol not in cache: ${cacheKey}`);
+                return undefined;
+            }
+            if ('defaultConfiguration' in protocol && protocol.defaultConfiguration) {
+                return protocol.defaultConfiguration;
+            }
+            return undefined;
+        }
+        catch (error) {
+            this.logDebug('Error getting default provider configuration', {
+                providerRef,
+                protocolKind,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return undefined;
+        }
+    }
+    getCachedProtocol(providerRef, protocolKind) {
+        const cacheKey = `${providerRef}:${protocolKind}`;
+        return this.protocolCache.get(cacheKey);
+    }
+    getCachedCLIRuntimeProfile(providerRef) {
+        const protocol = this.getCachedProtocol(providerRef, ExternalProvider_ExchangeProtocol_Kind.CLI_RUNTIME);
+        if (!protocol || protocol.kind !== ExternalProvider_ExchangeProtocol_Kind.CLI_RUNTIME) {
+            return undefined;
+        }
+        return protocol.profile;
+    }
+    async getOperationsForDomain(providerRef, protocolKind, domain) {
+        return await this.lazyProviderRegistry.getOperations(providerRef, protocolKind, domain);
+    }
+    /**
+     * Get provider secrets for a specific protocol and secret reference.
+     * Provider secrets are runtime-delivered via env/K8s materialization.
+     * The secret binding contract is still declared by the provider protocol
+     * configuration, but the secret value source is `process.env`.
+     */
+    getProviderSecret(providerRef, protocolKind, secretRef) {
+        this.ensureInitialized();
+        try {
+            const envVarName = this.getProviderSecretEnvVarName(providerRef, protocolKind, secretRef);
+            if (!envVarName) {
+                return undefined;
+            }
+            const secretValue = process.env[envVarName];
+            return secretValue && secretValue.length > 0 ? secretValue : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    getProviderSecretEnvVarName(providerRef, protocolKind, secretRef) {
+        if (protocolKind === ExternalProvider_ExchangeProtocol_Kind.CLI_RUNTIME) {
+            const cliRuntimeConfig = this.getCLIRuntimeConfiguration(providerRef);
+            for (const executionProfile of Object.values(cliRuntimeConfig?.executionProfiles ?? {})) {
+                if (executionProfile.authMode === CLIRuntime_AuthMode.SECRET_REF_ENV_INJECTION
+                    && executionProfile.secretRef === secretRef) {
+                    return executionProfile.secretEnvVarName;
+                }
+            }
+        }
+        const protocolConfig = this.getProviderConfiguration(providerRef, protocolKind);
+        if (protocolConfig?.authConfig?.secretRef === secretRef) {
+            return protocolConfig.authConfig.secretRef;
+        }
+        return undefined;
+    }
+    getConfiguredProviderSecretRef(providerRef, protocolKind) {
+        const config = this.getProviderConfiguration(providerRef, protocolKind);
+        return config?.authConfig?.secretRef;
+    }
+    /**
+     * Resolve one named CLI execution profile from the provider's CLI runtime
+     * configuration. This preserves the existing providerRef + protocolKind
+     * lookup model while adding the second selector only inside CLI runtime.
+     */
+    getCLIRuntimeExecutionProfile(providerRef, executionProfileRef) {
+        this.ensureInitialized();
+        const cliRuntimeConfig = this.getCLIRuntimeConfiguration(providerRef);
+        const executionProfile = cliRuntimeConfig?.executionProfiles?.[executionProfileRef];
+        if (!executionProfile) {
+            this.logDebug(`CLI runtime execution profile ${executionProfileRef} not found for ${providerRef}`);
+            return undefined;
+        }
+        return executionProfile;
+    }
+    getCLIRuntimeExecutionProfileSecret(providerRef, executionProfileRef) {
+        this.ensureInitialized();
+        const executionProfile = this.getCLIRuntimeExecutionProfile(providerRef, executionProfileRef);
+        if (!executionProfile) {
+            return undefined;
+        }
+        if (executionProfile.authMode !== CLIRuntime_AuthMode.SECRET_REF_ENV_INJECTION ||
+            !executionProfile.secretRef) {
+            return undefined;
+        }
+        const runtimeSecret = executionProfile.secretEnvVarName
+            ? process.env[executionProfile.secretEnvVarName]
+            : undefined;
+        if (runtimeSecret && runtimeSecret.length > 0) {
+            this.logDebug('Resolved CLI runtime secret from process env', {
+                providerRef,
+                executionProfileRef,
+                secretEnvVarName: executionProfile.secretEnvVarName,
+            });
+            return runtimeSecret;
+        }
+        return undefined;
+    }
+    getProviderApiKey(providerRef, protocolKind) {
+        this.ensureInitialized();
+        try {
+            const secretRef = this.getConfiguredProviderSecretRef(providerRef, protocolKind);
+            if (!secretRef) {
+                this.logDebug(`No authConfig.secretRef found for ${providerRef}.${protocolKind}`);
+                return undefined;
+            }
+            const apiKey = this.getProviderSecret(providerRef, protocolKind, secretRef);
+            if (!apiKey) {
+                this.logDebug(`Secret ${secretRef} not found for ${providerRef}.${protocolKind}`);
+            }
+            return apiKey;
+        }
+        catch (error) {
+            this.logDebug('Error getting provider API key', {
+                providerRef,
+                protocolKind,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return undefined;
+        }
+    }
+    isProviderEnabled(providerRef, protocolKind) {
+        this.ensureInitialized();
+        try {
+            if (!this.hasProvider(providerRef)) {
+                return false;
+            }
+            const provider = this.getProvider(providerRef);
+            if (!provider || !provider.protocols.includes(protocolKind)) {
+                return false;
+            }
+            const config = this.getProviderConfiguration(providerRef, protocolKind);
+            if (!config) {
+                return true;
+            }
+            return config.enabled !== false;
+        }
+        catch (error) {
+            this.logDebug('Error checking if provider is enabled', {
+                providerRef,
+                protocolKind,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    getProviderProtocolSecrets(providerRef, protocolKind) {
+        this.ensureInitialized();
+        try {
+            const resolvedSecrets = {};
+            const protocolConfig = this.getProviderConfiguration(providerRef, protocolKind);
+            const protocolSecretRef = protocolConfig?.authConfig?.secretRef;
+            if (protocolSecretRef) {
+                const secretValue = this.getProviderSecret(providerRef, protocolKind, protocolSecretRef);
+                if (secretValue) {
+                    resolvedSecrets[protocolSecretRef] = secretValue;
+                }
+            }
+            if (protocolKind === ExternalProvider_ExchangeProtocol_Kind.CLI_RUNTIME) {
+                const cliRuntimeConfig = this.getCLIRuntimeConfiguration(providerRef);
+                for (const executionProfile of Object.values(cliRuntimeConfig?.executionProfiles ?? {})) {
+                    if (executionProfile.authMode !== CLIRuntime_AuthMode.SECRET_REF_ENV_INJECTION
+                        || !executionProfile.secretRef) {
+                        continue;
+                    }
+                    const secretValue = this.getProviderSecret(providerRef, protocolKind, executionProfile.secretRef);
+                    if (secretValue) {
+                        resolvedSecrets[executionProfile.secretRef] = secretValue;
+                    }
+                }
+            }
+            return Object.keys(resolvedSecrets).length > 0 ? resolvedSecrets : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Refresh registry from computed capabilities (useful after config/capability reload).
+     */
+    async refreshFromConfig() {
+        try {
+            const computedMap = this.capabilityBindings.getComputedRegistry();
+            const registry = {};
+            for (const [providerRef, item] of computedMap) {
+                registry[providerRef] = item;
+            }
+            this.protocolCache.clear();
+            this.registry = registry;
+            await this.preloadEnabledProviders(registry);
+            this.isInitialized = true;
+            this.logDebug('External providers registry refreshed from computed capabilities', {
+                totalProviders: Object.keys(registry).length,
+                cachedProtocols: this.protocolCache.size
+            });
+        }
+        catch (error) {
+            this.logDebug('Failed to refresh registry from config', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
+                customMessageReference: ErrorCustomMessageReference.EXTERNAL_PROVIDER_REGISTRY_INITIALIZATION_FAILED,
+                context: {
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    // ================================
+    // Initialization Utils
+    // ================================
+    ensureInitialized() {
+        if (!this.isInitialized || !this.registry) {
+            throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
+                customMessageReference: ErrorCustomMessageReference.EXTERNAL_PROVIDER_REGISTRY_INITIALIZATION_FAILED
+            });
+        }
+    }
+};
+ExternalProvidersRegistryBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.AppConfigService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.LazyProviderRegistryService)),
+    __param(4, inject(SAAS_SERVICE_TYPES.CapabilityBindingsService)),
+    __metadata("design:paramtypes", [Function, Function, ErrorBuilderBackendService, Function, Function])
+], ExternalProvidersRegistryBackendService);
+export { ExternalProvidersRegistryBackendService };
+//# sourceMappingURL=external-providers-registry.backend.service.js.map

package/dist/esm/external-providers/services/external-providers-registry.backend.service.js.map

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

package/dist/esm/external-providers/services/feature-bindings.backend.service.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Capability Bindings Backend Service
+ *
+ * Responsible for:
+ * - Resolving CapabilityBindingsPolicy (which providers to use for which capabilities)
+ * - Computing External_Providers_RegistryItem from policy + provider definitions
+ * - Validating provider requirements for capabilities
+ * - Providing query methods for capability availability
+ */
+import { External_Providers_RegistryItem, EngineCapability, CapabilityBindingsPolicy } from '@wildo-ai/saas-models';
+import { ExternalProvider_Capability } from '@wildo-ai/external-connectors-models';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import type { AppConfigurationService } from '../../config/services/app-configuration.backend.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import type { LazyProviderRegistryBackendService } from './lazy-provider-registry.backend.service.js';
+interface CapabilityValidationResult {
+    valid: boolean;
+    missingRequirements: string[];
+}
+export declare class CapabilityBindingsBackendService {
+    protected readonly logger: LoggerService;
+    protected readonly configService: AppConfigurationService;
+    protected readonly errorBuilder: ErrorBuilderBackendService;
+    protected readonly lazyProviderRegistry: LazyProviderRegistryBackendService;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    protected isInitialized: boolean;
+    /** Reverse lookup: ExternalProvider_Capability → EngineCapability (for EXTERNAL_PROVIDER fulfillment only) */
+    private externalToCapabilityMap;
+    /** Computed registry (from policy + provider definitions) */
+    private computedRegistry;
+    /** Policy reference (from app config) */
+    private policy;
+    constructor(logger: LoggerService, configService: AppConfigurationService, errorBuilder: ErrorBuilderBackendService, lazyProviderRegistry: LazyProviderRegistryBackendService);
+    /**
+     * Initialize service:
+     * 1. Build reverse lookup index from EngineCapability_Definitions
+     * 2. Load policy from app config
+     * 3. Compute the registry from policy + provider definitions
+     */
+    initialize(): Promise<void>;
+    /**
+     * Build reverse lookup index from static definitions.
+     * Only EXTERNAL_PROVIDER capabilities with an externalProviderCapabilityRef are indexed.
+     */
+    private buildReverseLookupIndexes;
+    /**
+     * Compute the registry from policy + provider definitions
+     */
+    private computeRegistryFromPolicy;
+    /**
+     * Compute External_Providers_RegistryItem for a provider.
+     * Only processes EXTERNAL_PROVIDER capabilities (PLATFORM_SERVICE capabilities
+     * don't go through the external provider registry).
+     */
+    computeRegistryItemForProvider(providerRef: string): Promise<External_Providers_RegistryItem | null>;
+    /**
+     * Validate that a provider meets requirements for an EngineCapability.
+     * Checks: required protocols, transformer availability, SDK packages.
+     */
+    validateProviderMeetsCapabilityRequirements(providerRef: string, capability: EngineCapability): Promise<CapabilityValidationResult>;
+    /**
+     * Check if provider has a transformer for a capability.
+     * Uses the capabilities array in ProviderCatalogEntry to verify transformer availability.
+     */
+    private checkProviderHasTransformerForCapability;
+    /**
+     * Get the provider(s) for an EngineCapability (from policy)
+     */
+    getProvidersForCapability(capability: EngineCapability): string[];
+    /**
+     * Get the primary provider for an EngineCapability (first provider if array, or single provider)
+     */
+    getPrimaryProviderForCapability(capability: EngineCapability): string | undefined;
+    /**
+     * Check if an EngineCapability is available (has at least one enabled provider that meets requirements)
+     */
+    isCapabilityAvailable(capability: EngineCapability): boolean;
+    private isPlatformServiceAvailable;
+    /**
+     * Get the computed registry item for a provider
+     */
+    getComputedRegistryItem(providerRef: string): External_Providers_RegistryItem | undefined;
+    /**
+     * Get all computed registry items
+     */
+    getComputedRegistry(): Map<string, External_Providers_RegistryItem>;
+    /**
+     * Get the current capability bindings policy
+     */
+    getPolicy(): CapabilityBindingsPolicy | null;
+    /**
+     * Convert ExternalProvider_Capability to EngineCapability (using reverse lookup)
+     */
+    externalCapabilityToEngineCapability(externalCapability: ExternalProvider_Capability): EngineCapability | undefined;
+    /**
+     * Refresh from config (useful after config reload)
+     */
+    refreshFromConfig(): Promise<void>;
+    protected ensureInitialized(): void;
+}
+export {};
+//# sourceMappingURL=feature-bindings.backend.service.d.ts.map

package/dist/esm/external-providers/services/feature-bindings.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-bindings.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/external-providers/services/feature-bindings.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,+BAA+B,EAC/B,gBAAgB,EAGhB,wBAAwB,EAGzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,2BAA2B,EAE5B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AACpH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AAMnG,UAAU,0BAA0B;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAgBD,qBACa,gCAAgC;IAkBN,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,uBAAuB;IACtD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,0BAA0B;IACnD,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,kCAAkC;IApBrI,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,SAAS,CAAC,aAAa,UAAS;IAMhC,8GAA8G;IAC9G,OAAO,CAAC,uBAAuB,CAA4C;IAE3E,6DAA6D;IAC7D,OAAO,CAAC,gBAAgB,CAA2D;IAEnF,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAyC;gBAGC,MAAM,EAAE,aAAa,EACX,aAAa,EAAE,uBAAuB,EACnC,YAAY,EAAE,0BAA0B,EAChC,oBAAoB,EAAE,kCAAkC;IAYrI;;;;;OAKG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBxC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAajC;;OAEG;YACW,yBAAyB;IA2BvC;;;;OAIG;IACU,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IA4CjH;;;OAGG;IACU,2CAA2C,CACtD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,0BAA0B,CAAC;IA+CtC;;;OAGG;YACW,wCAAwC;IAoBtD;;OAEG;IACI,yBAAyB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAWxE;;OAEG;IACI,+BAA+B,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS;IAKxF;;OAEG;IACI,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAenE,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACI,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,+BAA+B,GAAG,SAAS;IAKhG;;OAEG;IACI,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,+BAA+B,CAAC;IAK1E;;OAEG;IACI,SAAS,IAAI,wBAAwB,GAAG,IAAI;IAKnD;;OAEG;IACI,oCAAoC,CAAC,kBAAkB,EAAE,2BAA2B,GAAG,gBAAgB,GAAG,SAAS;IAI1H;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/C,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAYpC"}