@wildo-ai/saas-backend-lib 1.0.1

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

@@ -0,0 +1,352 @@
+/**
+ * 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
+ */
+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 { EngineCapability_Definitions, EngineCapabilityFulfillmentKind, ErrorType, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { ExternalProvider_ExchangeProtocol_Kind, } from '@wildo-ai/external-connectors-models';
+import { PlatformRuntimeEndpointKey } from '@wildo-ai/platform-core-shared';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+const PLATFORM_SERVICE_RUNTIME_KEYS = {
+    fileGenerator: [
+        PlatformRuntimeEndpointKey.PLATFORM_FILE_GENERATOR,
+        'fileGenerator',
+    ],
+    clamav: [
+        'clamav',
+    ],
+};
+// =====================================================
+// Capability Bindings Backend Service
+// =====================================================
+let CapabilityBindingsBackendService = class CapabilityBindingsBackendService {
+    logger;
+    configService;
+    errorBuilder;
+    lazyProviderRegistry;
+    logDebug;
+    isInitialized = false;
+    // ================================
+    // Internal State (built at initialization)
+    // ================================
+    /** Reverse lookup: ExternalProvider_Capability → EngineCapability (for EXTERNAL_PROVIDER fulfillment only) */
+    externalToCapabilityMap = new Map();
+    /** Computed registry (from policy + provider definitions) */
+    computedRegistry = new Map();
+    /** Policy reference (from app config) */
+    policy = null;
+    constructor(logger, configService, errorBuilder, lazyProviderRegistry) {
+        this.logger = logger;
+        this.configService = configService;
+        this.errorBuilder = errorBuilder;
+        this.lazyProviderRegistry = lazyProviderRegistry;
+        this.logDebug = this.logger.debugByType('CapabilityBindingsBackendService');
+        this.logger.setDebugTypeLogging('CapabilityBindingsBackendService', false);
+        this.logDebug('Capability bindings service created (not yet initialized)');
+    }
+    // ================================
+    // Initialization & Computation
+    // ================================
+    /**
+     * Initialize service:
+     * 1. Build reverse lookup index from EngineCapability_Definitions
+     * 2. Load policy from app config
+     * 3. Compute the registry from policy + provider definitions
+     */
+    async initialize() {
+        if (this.isInitialized) {
+            this.logDebug('Service already initialized, skipping');
+            return;
+        }
+        if (!this.configService.isInitialized()) {
+            await this.configService.initialize();
+        }
+        this.buildReverseLookupIndexes();
+        const appConfig = this.configService.config;
+        this.policy = appConfig.capabilities || { capabilities: {} };
+        await this.computeRegistryFromPolicy();
+        this.isInitialized = true;
+        this.logDebug('Capability bindings service initialized successfully', {
+            capabilityMappings: this.externalToCapabilityMap.size,
+            computedProviders: this.computedRegistry.size,
+        });
+    }
+    /**
+     * Build reverse lookup index from static definitions.
+     * Only EXTERNAL_PROVIDER capabilities with an externalProviderCapabilityRef are indexed.
+     */
+    buildReverseLookupIndexes() {
+        for (const [capability, definition] of Object.entries(EngineCapability_Definitions)) {
+            if (definition &&
+                definition.fulfillmentKinds.includes(EngineCapabilityFulfillmentKind.EXTERNAL_PROVIDER) &&
+                definition.externalProviderCapabilityRef) {
+                this.externalToCapabilityMap.set(definition.externalProviderCapabilityRef, capability);
+                this.logDebug(`Mapped ${definition.externalProviderCapabilityRef} → ${capability}`);
+            }
+        }
+    }
+    /**
+     * Compute the registry from policy + provider definitions
+     */
+    async computeRegistryFromPolicy() {
+        if (!this.policy)
+            return;
+        const providerRefs = new Set();
+        for (const binding of Object.values(this.policy.capabilities ?? {})) {
+            if (Array.isArray(binding)) {
+                binding.forEach(ref => providerRefs.add(ref));
+            }
+            else {
+                providerRefs.add(binding);
+            }
+        }
+        for (const providerRef of providerRefs) {
+            try {
+                const registryItem = await this.computeRegistryItemForProvider(providerRef);
+                if (registryItem) {
+                    this.computedRegistry.set(providerRef, registryItem);
+                }
+            }
+            catch (error) {
+                this.logDebug(`Failed to compute registry item for ${providerRef}`, {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    /**
+     * Compute External_Providers_RegistryItem for a provider.
+     * Only processes EXTERNAL_PROVIDER capabilities (PLATFORM_SERVICE capabilities
+     * don't go through the external provider registry).
+     */
+    async computeRegistryItemForProvider(providerRef) {
+        const providerMeta = this.lazyProviderRegistry.getProviderMeta(providerRef);
+        if (!providerMeta) {
+            this.logDebug(`Provider metadata not found: ${providerRef}`);
+            return null;
+        }
+        const protocols = providerMeta.protocols
+            .map(entry => entry.kind);
+        const engineCapabilities = [];
+        if (this.policy) {
+            for (const [capability, binding] of Object.entries(this.policy.capabilities)) {
+                const bindings = Array.isArray(binding) ? binding : [binding];
+                if (bindings.includes(providerRef)) {
+                    const engineCapability = capability;
+                    const definition = EngineCapability_Definitions[engineCapability];
+                    if (!definition?.fulfillmentKinds.includes(EngineCapabilityFulfillmentKind.EXTERNAL_PROVIDER)) {
+                        continue;
+                    }
+                    const validation = await this.validateProviderMeetsCapabilityRequirements(providerRef, engineCapability);
+                    if (validation.valid) {
+                        engineCapabilities.push(engineCapability);
+                    }
+                    else {
+                        this.logDebug(`Provider ${providerRef} does not meet requirements for ${engineCapability}`, {
+                            missingRequirements: validation.missingRequirements,
+                        });
+                    }
+                }
+            }
+        }
+        const supportsOAuth2 = protocols.includes(ExternalProvider_ExchangeProtocol_Kind.SSO_OAUTH2);
+        return {
+            providerRef,
+            protocols,
+            engineCapabilities,
+            supportsOAuth2: supportsOAuth2 || undefined,
+        };
+    }
+    /**
+     * Validate that a provider meets requirements for an EngineCapability.
+     * Checks: required protocols, transformer availability, SDK packages.
+     */
+    async validateProviderMeetsCapabilityRequirements(providerRef, capability) {
+        const definition = EngineCapability_Definitions[capability];
+        if (!definition) {
+            this.logDebug(`No definition for EngineCapability ${capability}, skipping validation`);
+            return { valid: true, missingRequirements: [] };
+        }
+        const missingRequirements = [];
+        if (definition.requirements?.requiredProtocols && definition.requirements.requiredProtocols.length > 0) {
+            const providerMeta = this.lazyProviderRegistry.getProviderMeta(providerRef);
+            if (!providerMeta) {
+                missingRequirements.push(`Provider metadata not found`);
+            }
+            else {
+                const providerProtocols = providerMeta.protocols.map(entry => entry.kind);
+                const hasRequiredProtocol = definition.requirements.requiredProtocols.some(protocol => providerProtocols.includes(protocol));
+                if (!hasRequiredProtocol) {
+                    missingRequirements.push(`Required protocol(s): ${definition.requirements.requiredProtocols.join(', ')}`);
+                }
+            }
+        }
+        if (definition.requirements?.requiresTransformer && definition.externalProviderCapabilityRef) {
+            const hasTransformer = await this.checkProviderHasTransformerForCapability(providerRef, definition.externalProviderCapabilityRef);
+            if (!hasTransformer) {
+                missingRequirements.push(`Capability transformer for ${definition.externalProviderCapabilityRef}`);
+            }
+        }
+        const sdkCheck = this.lazyProviderRegistry.checkRequiredPackages(providerRef);
+        if (sdkCheck.available === false) {
+            missingRequirements.push(`Required SDK package(s) not installed: ${sdkCheck.missing.join(', ')}`);
+        }
+        return {
+            valid: missingRequirements.length === 0,
+            missingRequirements,
+        };
+    }
+    /**
+     * Check if provider has a transformer for a capability.
+     * Uses the capabilities array in ProviderCatalogEntry to verify transformer availability.
+     */
+    async checkProviderHasTransformerForCapability(providerRef, externalCapability) {
+        const providerMeta = this.lazyProviderRegistry.getProviderMeta(providerRef);
+        if (!providerMeta) {
+            this.logDebug(`Provider metadata not found for transformer check: ${providerRef}`);
+            return false;
+        }
+        const hasCapability = providerMeta.capabilities?.includes(externalCapability) ?? false;
+        this.logDebug(`Transformer check for ${providerRef}:${externalCapability} - ${hasCapability ? 'available' : 'not available'}`);
+        return hasCapability;
+    }
+    // ================================
+    // Query Methods
+    // ================================
+    /**
+     * Get the provider(s) for an EngineCapability (from policy)
+     */
+    getProvidersForCapability(capability) {
+        this.ensureInitialized();
+        if (!this.policy)
+            return [];
+        const binding = this.policy.capabilities[capability];
+        if (!binding)
+            return [];
+        return Array.isArray(binding) ? binding : [binding];
+    }
+    /**
+     * Get the primary provider for an EngineCapability (first provider if array, or single provider)
+     */
+    getPrimaryProviderForCapability(capability) {
+        const providers = this.getProvidersForCapability(capability);
+        return providers.length > 0 ? providers[0] : undefined;
+    }
+    /**
+     * Check if an EngineCapability is available (has at least one enabled provider that meets requirements)
+     */
+    isCapabilityAvailable(capability) {
+        this.ensureInitialized();
+        const providers = this.getProvidersForCapability(capability);
+        for (const providerRef of providers) {
+            const registryItem = this.computedRegistry.get(providerRef);
+            if (registryItem && registryItem.engineCapabilities.includes(capability)) {
+                return true;
+            }
+        }
+        return this.isPlatformServiceAvailable(capability);
+    }
+    isPlatformServiceAvailable(capability) {
+        const definition = EngineCapability_Definitions[capability];
+        if (!definition?.fulfillmentKinds.includes(EngineCapabilityFulfillmentKind.PLATFORM_SERVICE)) {
+            return false;
+        }
+        const runtimeEndpoints = this.configService.config?.runtime?.endPoints ?? {};
+        const platformServiceRef = definition.platformServiceRef;
+        if (!platformServiceRef) {
+            return false;
+        }
+        const candidateKeys = PLATFORM_SERVICE_RUNTIME_KEYS[platformServiceRef] ?? [platformServiceRef];
+        return candidateKeys.some((runtimeKey) => {
+            const runtimeEndpoint = runtimeEndpoints[runtimeKey];
+            return Boolean(runtimeEndpoint?.internalUrl || runtimeEndpoint?.publicUrl);
+        });
+    }
+    /**
+     * Get the computed registry item for a provider
+     */
+    getComputedRegistryItem(providerRef) {
+        this.ensureInitialized();
+        return this.computedRegistry.get(providerRef);
+    }
+    /**
+     * Get all computed registry items
+     */
+    getComputedRegistry() {
+        this.ensureInitialized();
+        return this.computedRegistry;
+    }
+    /**
+     * Get the current capability bindings policy
+     */
+    getPolicy() {
+        this.ensureInitialized();
+        return this.policy;
+    }
+    /**
+     * Convert ExternalProvider_Capability to EngineCapability (using reverse lookup)
+     */
+    externalCapabilityToEngineCapability(externalCapability) {
+        return this.externalToCapabilityMap.get(externalCapability);
+    }
+    /**
+     * Refresh from config (useful after config reload)
+     */
+    async refreshFromConfig() {
+        try {
+            if (this.configService.isInitialized()) {
+                const appConfig = this.configService.config;
+                this.policy = appConfig.capabilities || { capabilities: {} };
+                this.computedRegistry.clear();
+                await this.computeRegistryFromPolicy();
+                this.logDebug('Capability bindings refreshed from config', {
+                    computedProviders: this.computedRegistry.size,
+                });
+            }
+        }
+        catch (error) {
+            this.logDebug('Failed to refresh capability bindings from config', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // ================================
+    // Initialization Utils
+    // ================================
+    ensureInitialized() {
+        if (!this.isInitialized) {
+            throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
+                customMessageReference: ErrorCustomMessageReference.SERVICES_REGISTRY_INITIALIZATION_FAILED,
+                context: { service: 'CapabilityBindingsBackendService' },
+            });
+        }
+    }
+};
+CapabilityBindingsBackendService = __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)),
+    __metadata("design:paramtypes", [Function, Function, ErrorBuilderBackendService, Function])
+], CapabilityBindingsBackendService);
+export { CapabilityBindingsBackendService };
+//# sourceMappingURL=feature-bindings.backend.service.js.map

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

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

package/dist/esm/external-providers/services/lazy-provider-registry.backend.service.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Lazy Provider Registry Service
+ *
+ * Provides on-demand loading of provider definitions at:
+ * - Protocol level (REST_API, WEBHOOK, LLM, etc.)
+ * - Domain level (customers, invoices, etc.)
+ *
+ * Memory usage: ~100 KB base + loaded providers
+ * vs. AllProviders_Map which loads 1GB+ at startup
+ */
+import { ProviderCatalog, ProviderCatalogEntry, ProtocolCatalogEntry, OperationsMap, ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Base } from '@wildo-ai/external-connectors-models';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+export interface LazyProviderRegistryConfig {
+    /**
+     * Maximum number of protocols to cache
+     * When exceeded, least recently used protocols are evicted
+     */
+    maxProtocolCacheSize?: number;
+    /**
+     * Maximum number of operation sets to cache
+     * When exceeded, least recently used operations are evicted
+     */
+    maxOperationsCacheSize?: number;
+}
+export declare class LazyProviderRegistryBackendService {
+    protected readonly logger: LoggerService;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    private catalog;
+    private protocolCache;
+    private operationsCache;
+    private config;
+    private isInitialized;
+    constructor(logger: LoggerService);
+    /**
+     * Initialize with a provider catalog
+     * The catalog is lightweight (~100 KB) and contains lazy loaders
+     */
+    initialize(catalog: ProviderCatalog, config?: LazyProviderRegistryConfig): Promise<void>;
+    /**
+     * Check if service is initialized
+     */
+    isServiceInitialized(): boolean;
+    /**
+     * Get provider metadata from catalog (synchronous, no loading)
+     */
+    getProviderMeta(providerRef: string): ProviderCatalogEntry | undefined;
+    /**
+     * Get all provider refs from catalog
+     */
+    getProviderRefs(): string[];
+    /**
+     * Check if a provider exists in the catalog
+     */
+    hasProvider(providerRef: string): boolean;
+    /**
+     * Check if a provider has a specific protocol
+     */
+    hasProtocol(providerRef: string, protocolKind: ExternalProvider_ExchangeProtocol_Kind): boolean;
+    /**
+     * Check if all required SDK packages for a provider are available at runtime.
+     *
+     * Returns `{ available: true }` if the provider has no `requiredPackages` or
+     * all packages can be resolved. Otherwise returns `{ available: false, missing: [...] }`.
+     *
+     * This is used at startup to fail fast with a clear error message when a billing
+     * or other capability provider is configured but its SDK package is not installed.
+     */
+    checkRequiredPackages(providerRef: string): {
+        available: true;
+    } | {
+        available: false;
+        missing: string[];
+    };
+    /**
+     * Get available domains for a provider/protocol
+     */
+    getDomains(providerRef: string, protocolKind: ExternalProvider_ExchangeProtocol_Kind): string[] | undefined;
+    /**
+     * Get all provider refs that declare a specific protocol kind.
+     * Used by WebhookAutoControllerBackendService to discover providers with WEBHOOK_ORIGINATOR.
+     *
+     * Returns provider refs + their protocol metadata (synchronous — catalog-level lookup only).
+     */
+    getProviderRefsWithProtocol(protocolKind: ExternalProvider_ExchangeProtocol_Kind): Array<{
+        providerRef: string;
+        protocolMeta: ProtocolCatalogEntry;
+    }>;
+    /**
+     * Load and cache a protocol definition
+     * Returns undefined if service is not initialized (graceful degradation)
+     */
+    getProtocol(providerRef: string, protocolKind: ExternalProvider_ExchangeProtocol_Kind): Promise<ExternalProvider_ExchangeProtocol_Base | undefined>;
+    /**
+     * Load and cache operations for a protocol/domain
+     * Returns empty object if service is not initialized (graceful degradation)
+     */
+    getOperations(providerRef: string, protocolKind: ExternalProvider_ExchangeProtocol_Kind, domain?: string): Promise<OperationsMap>;
+    /**
+     * Get a single operation by key
+     */
+    getOperation(providerRef: string, protocolKind: ExternalProvider_ExchangeProtocol_Kind, operationKey: string, domain?: string): Promise<OperationsMap[string] | undefined>;
+    /**
+     * Preload specific providers/protocols for an application
+     *
+     * @example
+     * await registry.preload({
+     *   stripe: { protocols: ['REST_API'], domains: ['customers', 'invoices'] },
+     *   openai: { protocols: ['LLM_PROVIDER'] },
+     * });
+     */
+    preload(config: Record<string, {
+        protocols: ExternalProvider_ExchangeProtocol_Kind[];
+        domains?: string[];
+    }>): Promise<{
+        loaded: number;
+        errors: string[];
+    }>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        protocolsCached: number;
+        operationsCached: number;
+        maxProtocolCacheSize: number;
+        maxOperationsCacheSize: number;
+    };
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Clear cache for a specific provider
+     */
+    clearProviderCache(providerRef: string): void;
+    private ensureInitialized;
+    /**
+     * Simple LRU-like eviction: remove oldest entries when cache is full
+     */
+    private evictIfNeeded;
+}
+//# sourceMappingURL=lazy-provider-registry.backend.service.d.ts.map

package/dist/esm/external-providers/services/lazy-provider-registry.backend.service.d.ts.map

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