@dyanet/nestjs-config-aws 1.0.1

package/dist/types/integration/services/error-handler.service.d.ts

@@ -0,0 +1,84 @@
+import { IntegrationOptions } from '../interfaces/integration-options.interface';
+/**
+ * Service for handling errors and implementing graceful degradation strategies
+ * in the AWS configuration integration.
+ */
+export declare class ErrorHandlerService {
+    private readonly options;
+    private readonly logger;
+    private readonly errorHandling;
+    constructor(options: IntegrationOptions);
+    /**
+     * Handle AWS service unavailability.
+     * @param serviceName - Name of the AWS service that's unavailable
+     * @param error - The error that occurred
+     * @returns Whether to continue processing
+     */
+    handleAwsUnavailable(serviceName: string, error?: Error): boolean;
+    /**
+     * Handle configuration loading errors.
+     * @param source - Name of the configuration source
+     * @param error - The error that occurred
+     * @returns Whether to continue processing
+     */
+    handleConfigurationError(source: string, error: Error): boolean;
+    /**
+     * Handle validation errors.
+     * @param field - The field that failed validation
+     * @param error - The validation error
+     * @returns Whether to continue processing
+     */
+    handleValidationError(field: string, error: Error): boolean;
+    /**
+     * Handle network connectivity issues.
+     * @param service - The service experiencing connectivity issues
+     * @param error - The network error
+     * @returns Whether to retry or continue
+     */
+    handleNetworkError(service: string, error: Error): {
+        shouldRetry: boolean;
+        shouldContinue: boolean;
+    };
+    /**
+     * Handle permission denied errors.
+     * @param service - The service that denied access
+     * @param resource - The resource that was accessed
+     * @param error - The permission error
+     * @returns Whether to continue processing
+     */
+    handlePermissionError(service: string, resource: string, error: Error): boolean;
+    /**
+     * Handle resource not found errors.
+     * @param service - The service where the resource was not found
+     * @param resource - The resource that was not found
+     * @param error - The not found error
+     * @returns Whether to continue processing
+     */
+    handleResourceNotFound(service: string, resource: string, error?: Error): boolean;
+    /**
+     * Log detailed error information for troubleshooting.
+     * @param context - The context where the error occurred
+     * @param error - The error to log
+     * @param additionalInfo - Additional information to include
+     */
+    logDetailedError(context: string, error: Error, additionalInfo?: Record<string, any>): void;
+    /**
+     * Create a fallback configuration when AWS sources fail.
+     * @param namespace - Optional namespace for the fallback config
+     * @returns Fallback configuration object
+     */
+    createFallbackConfiguration(namespace?: string): Record<string, any>;
+    /**
+     * Check if an error is retryable.
+     * @param error - The error to check
+     * @returns Whether the error is retryable
+     */
+    isRetryableError(error: Error): boolean;
+    /**
+     * Get retry delay for retryable errors.
+     * @param attemptNumber - The current attempt number (1-based)
+     * @returns Delay in milliseconds
+     */
+    getRetryDelay(attemptNumber: number): number;
+}
+//# sourceMappingURL=error-handler.service.d.ts.map

package/dist/types/integration/services/error-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/error-handler.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAyB,MAAM,6CAA6C,CAAC;AAGxG;;;GAGG;AACH,qBACa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;gBAEzB,OAAO,EAAE,kBAAkB;IAWxD;;;;;OAKG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAyBjE;;;;;OAKG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAwB/D;;;;;OAKG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAwB3D;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE;IAiBpG;;;;;;OAMG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAc/E;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAYjF;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAyB3F;;;;OAIG;IACH,2BAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA6BpE;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAyBvC;;;;OAIG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAY7C"}

package/dist/types/integration/services/factory-registration.service.d.ts

@@ -0,0 +1,158 @@
+import { ConfigFactory } from '@nestjs/config';
+import { ConfigurationFactoryProviderImpl } from '../providers/configuration-factory.provider';
+import { AwsConfigurationLoaderService } from '../providers/aws-configuration-loader.service';
+import { IntegrationOptions } from '../interfaces/integration-options.interface';
+import { NamespaceHandlerService } from './namespace-handler.service';
+import { ValidationIntegrationService } from './validation-integration.service';
+/**
+ * Service responsible for registering configuration factories with @nestjs/config.
+ * This service creates and manages the bridge between AWS-loaded configuration
+ * and the standard @nestjs/config module.
+ */
+export declare class FactoryRegistrationService {
+    private readonly configurationFactoryProvider;
+    private readonly awsConfigurationLoader;
+    private readonly namespaceHandler;
+    private readonly validationService;
+    private readonly options;
+    private readonly logger;
+    private readonly registeredFactories;
+    private isInitialized;
+    constructor(configurationFactoryProvider: ConfigurationFactoryProviderImpl, awsConfigurationLoader: AwsConfigurationLoaderService, namespaceHandler: NamespaceHandlerService, validationService: ValidationIntegrationService, options?: IntegrationOptions);
+    /**
+     * Register configuration factories with @nestjs/config based on AWS-loaded configuration.
+     * This method loads configuration from AWS sources and creates factories that can be
+     * consumed by @nestjs/config.
+     *
+     * @returns Promise resolving to array of registered configuration factories
+     */
+    registerFactories(): Promise<ConfigFactory[]>;
+    /**
+     * Register configuration factories asynchronously.
+     * This method is designed to work with @nestjs/config's forRootAsync pattern.
+     *
+     * @returns Promise resolving to array of configuration factories
+     */
+    registerFactoriesAsync(): Promise<ConfigFactory[]>;
+    /**
+     * Create a single configuration factory for immediate use.
+     * This method can be used for synchronous factory creation.
+     *
+     * @param namespace - Optional namespace for the factory
+     * @param config - Configuration data to use for the factory
+     * @returns Configuration factory
+     */
+    createSyncFactory(namespace?: string, config?: Record<string, any>): ConfigFactory;
+    /**
+     * Register factories for specific namespaces.
+     * This method allows selective registration of configuration for specific namespaces.
+     *
+     * @param namespaces - Array of namespace names to register
+     * @returns Promise resolving to array of namespace-specific factories
+     */
+    registerNamespacedFactories(namespaces: string[]): Promise<ConfigFactory[]>;
+    /**
+     * Get all registered factories.
+     * @returns Map of factory names to configuration factories
+     */
+    getRegisteredFactories(): Map<string, ConfigFactory>;
+    /**
+     * Get a specific registered factory by name.
+     * @param name - Name of the factory to retrieve
+     * @returns Configuration factory or undefined if not found
+     */
+    getFactory(name: string): ConfigFactory | undefined;
+    /**
+     * Check if factories have been initialized.
+     * @returns Whether factories have been registered
+     */
+    isFactoriesInitialized(): boolean;
+    /**
+     * Register validated namespace factories with schema validation.
+     * This method creates factories that validate configuration using Joi, class-validator, or custom functions.
+     *
+     * @param namespaces - Array of namespace names to register
+     * @param validationSchemas - Validation schemas for each namespace
+     * @param validationType - Type of validation to use
+     * @returns Promise resolving to array of validated namespace factories
+     */
+    registerValidatedNamespaceFactories(namespaces: string[], validationSchemas: Record<string, any>, validationType?: 'joi' | 'class-validator' | 'custom'): Promise<ConfigFactory[]>;
+    /**
+     * Create enhanced namespace factories using the namespace handler service.
+     * This method provides improved namespace support with better configuration extraction.
+     *
+     * @param namespaces - Array of namespace names to create factories for
+     * @returns Promise resolving to array of enhanced namespace factories
+     */
+    createEnhancedNamespaceFactories(namespaces: string[]): Promise<ConfigFactory[]>;
+    /**
+     * Get validation recommendations for current configuration.
+     * This method analyzes the loaded configuration and provides validation recommendations.
+     *
+     * @returns Promise resolving to validation recommendations
+     */
+    getValidationRecommendations(): Promise<Record<string, any>>;
+    /**
+     * Validate namespace access patterns for current configuration.
+     * This method checks if namespace configurations are properly structured for @nestjs/config access.
+     *
+     * @param namespaces - Namespaces to validate
+     * @returns Promise resolving to validation results
+     */
+    validateNamespaceAccess(namespaces: string[]): Promise<Record<string, any>>;
+    /**
+     * Reset the factory registration state.
+     * This method clears all registered factories and resets the initialization state.
+     */
+    reset(): void;
+    /**
+     * Load configuration from AWS sources with error handling.
+     * @returns Promise resolving to AWS configuration data
+     */
+    private loadAwsConfiguration;
+    /**
+     * Create configuration factories based on loaded AWS configuration.
+     * @param awsConfig - Configuration data loaded from AWS
+     * @returns Promise resolving to array of configuration factories
+     */
+    private createConfigurationFactories;
+    /**
+     * Create namespaced factories from configuration data.
+     * @param config - Configuration data organized by namespace
+     * @param sources - Configuration sources metadata
+     * @returns Array of namespaced configuration factories
+     */
+    private createNamespacedFactoriesFromConfig;
+    /**
+     * Create a single factory from all configuration data.
+     * @param config - All configuration data
+     * @param sources - Configuration sources metadata
+     * @returns Single configuration factory or null if no valid configuration
+     */
+    private createSingleFactoryFromConfig;
+    /**
+     * Register factories internally and track them.
+     * @param factories - Array of factories to register
+     */
+    private registerFactoriesInternal;
+    /**
+     * Get a unique key for a factory for tracking purposes.
+     * @param factory - Configuration factory
+     * @returns Unique key for the factory
+     */
+    private getFactoryKey;
+    /**
+     * Generate a simple hash for factory identification.
+     * @param str - String to hash
+     * @returns Simple hash value
+     */
+    private simpleHash;
+    /**
+     * Validate if a namespace configuration is valid.
+     * @param namespace - The namespace name
+     * @param config - The configuration data
+     * @returns True if valid, false otherwise
+     */
+    private isValidNamespaceConfig;
+}
+//# sourceMappingURL=factory-registration.service.d.ts.map

package/dist/types/integration/services/factory-registration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-registration.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/factory-registration.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,6CAA6C,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAEhF;;;;GAIG;AACH,qBACa,0BAA0B;IAMnC,OAAO,CAAC,QAAQ,CAAC,4BAA4B;IAC7C,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyC;IAC7E,OAAO,CAAC,aAAa,CAAS;gBAGX,4BAA4B,EAAE,gCAAgC,EAC9D,sBAAsB,EAAE,6BAA6B,EACrD,gBAAgB,EAAE,uBAAuB,EACzC,iBAAiB,EAAE,4BAA4B,EAE/C,OAAO,GAAE,kBAAuB;IAGnD;;;;;;OAMG;IACG,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAyCnD;;;;;OAKG;IACG,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAmCxD;;;;;;;OAOG;IACH,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;IAoBlF;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyCjF;;;OAGG;IACH,sBAAsB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIpD;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAInD;;;OAGG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;;;;;;;OAQG;IACG,mCAAmC,CACvC,UAAU,EAAE,MAAM,EAAE,EACpB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtC,cAAc,GAAE,KAAK,GAAG,iBAAiB,GAAG,QAAmB,GAC9D,OAAO,CAAC,aAAa,EAAE,CAAC;IAgE3B;;;;;;OAMG;IACG,gCAAgC,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoCtF;;;;;OAKG;IACG,4BAA4B,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAclE;;;;;;OAMG;IACG,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAgBjF;;;OAGG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;YACW,oBAAoB;IAiClC;;;;OAIG;YACW,4BAA4B;IA2B1C;;;;;OAKG;IACH,OAAO,CAAC,mCAAmC;IA2B3C;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAyBrC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAYjC;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAarB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAQ/B"}

package/dist/types/integration/services/index.d.ts

@@ -0,0 +1,9 @@
+export * from './integration-state.service';
+export * from './error-handler.service';
+export * from './precedence-handler.service';
+export * from './factory-registration.service';
+export * from './nestjs-config-integration.service';
+export * from './async-config-helper.service';
+export * from './namespace-handler.service';
+export * from './validation-integration.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/integration/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC"}

package/dist/types/integration/services/integration-state.service.d.ts

@@ -0,0 +1,41 @@
+import { IntegrationState } from '../interfaces/integration-state.interface';
+import { ConfigurationSource } from '../interfaces/configuration-source.interface';
+/**
+ * Service for managing the state of the integration module.
+ */
+export declare class IntegrationStateService {
+    private state;
+    /**
+     * Get the current integration state.
+     */
+    getState(): IntegrationState;
+    /**
+     * Mark the integration as initialized.
+     */
+    setInitialized(initialized: boolean): void;
+    /**
+     * Set AWS availability status.
+     */
+    setAwsAvailable(available: boolean): void;
+    /**
+     * Add a loaded configuration source.
+     */
+    addLoadedSource(source: ConfigurationSource): void;
+    /**
+     * Add a registered factory name.
+     */
+    addRegisteredFactory(factoryName: string): void;
+    /**
+     * Add an error to the state.
+     */
+    addError(error: string): void;
+    /**
+     * Clear all errors.
+     */
+    clearErrors(): void;
+    /**
+     * Reset the integration state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=integration-state.service.d.ts.map

package/dist/types/integration/services/integration-state.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-state.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/integration-state.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAEnF;;GAEG;AACH,qBACa,uBAAuB;IAClC,OAAO,CAAC,KAAK,CAMX;IAEF;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAI5B;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI;IAI1C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAIzC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAIlD;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;CASd"}

package/dist/types/integration/services/namespace-handler.service.d.ts

@@ -0,0 +1,192 @@
+import { ConfigFactory } from '@nestjs/config';
+import { ConfigurationSource } from '../interfaces/configuration-source.interface';
+/**
+ * Service for handling namespace-aware configuration loading and factory creation.
+ * Provides enhanced namespace support for @nestjs/config integration.
+ */
+export declare class NamespaceHandlerService {
+    private readonly logger;
+    /**
+     * Create a registerAs factory for a specific namespace.
+     * This method creates a factory that can be used with @nestjs/config's registerAs pattern.
+     *
+     * @param namespace - The namespace for the configuration
+     * @param config - The configuration data for the namespace
+     * @param sources - Optional configuration sources metadata
+     * @returns A registerAs factory for the namespace
+     */
+    createNamespaceFactory(namespace: string, config: Record<string, any>, sources?: ConfigurationSource[]): ConfigFactory;
+    /**
+     * Create multiple namespace factories from configuration data.
+     *
+     * @param namespacedConfig - Configuration data organized by namespace
+     * @param sources - Optional configuration sources metadata
+     * @returns Array of namespace factories
+     */
+    createMultipleNamespaceFactories(namespacedConfig: Record<string, Record<string, any>>, sources?: ConfigurationSource[]): ConfigFactory[];
+    /**
+     * Extract namespace configuration from flat configuration using various strategies.
+     *
+     * @param config - Flat configuration object
+     * @param namespace - Target namespace
+     * @returns Configuration for the namespace
+     */
+    extractNamespaceConfig(config: Record<string, any>, namespace: string): Record<string, any>;
+    /**
+     * Organize flat configuration into namespaces based on patterns.
+     *
+     * @param config - Flat configuration object
+     * @param namespaces - List of target namespaces
+     * @returns Configuration organized by namespace
+     */
+    organizeConfigByNamespaces(config: Record<string, any>, namespaces: string[]): Record<string, Record<string, any>>;
+    /**
+     * Validate namespace access patterns for @nestjs/config compatibility.
+     *
+     * @param namespace - Namespace to validate
+     * @param config - Configuration for the namespace
+     * @returns Validation result with suggestions
+     */
+    validateNamespaceAccess(namespace: string, config: Record<string, any>): {
+        isValid: boolean;
+        issues: string[];
+        suggestions: string[];
+    };
+    /**
+     * Generate access patterns documentation for a namespace.
+     *
+     * @param namespace - Namespace name
+     * @param config - Configuration for the namespace
+     * @returns Access patterns documentation
+     */
+    generateAccessPatterns(namespace: string, config: Record<string, any>): {
+        namespace: string;
+        patterns: {
+            injection: string;
+            service: string;
+            direct: string;
+        };
+        examples: string[];
+    };
+    /**
+     * Process namespace configuration with validation and transformation.
+     *
+     * @param config - Raw configuration for the namespace
+     * @param namespace - Namespace name
+     * @returns Processed configuration
+     */
+    private processNamespaceConfig;
+    /**
+     * Extract configuration using prefix patterns.
+     *
+     * @param config - Source configuration
+     * @param namespace - Target namespace
+     * @returns Prefixed configuration
+     */
+    private extractPrefixedConfig;
+    /**
+     * Extract configuration using path patterns.
+     *
+     * @param config - Source configuration
+     * @param namespace - Target namespace
+     * @returns Path-based configuration
+     */
+    private extractPathBasedConfig;
+    /**
+     * Extract configuration that doesn't belong to any namespace.
+     *
+     * @param config - Source configuration
+     * @param namespaces - Known namespaces
+     * @returns Remaining configuration
+     */
+    private extractRemainingConfig;
+    /**
+     * Add metadata to a factory for introspection.
+     *
+     * @param factory - Configuration factory
+     * @param namespace - Namespace name
+     * @param config - Configuration data
+     * @param sources - Configuration sources
+     */
+    private addFactoryMetadata;
+    /**
+     * Transform configuration values (type conversion, etc.).
+     *
+     * @param config - Configuration to transform
+     */
+    private transformConfigValues;
+    /**
+     * Convert string values to appropriate types.
+     *
+     * @param value - String value to convert
+     * @returns Converted value
+     */
+    private convertStringValue;
+    /**
+     * Validate processed configuration.
+     *
+     * @param config - Configuration to validate
+     * @param namespace - Namespace name
+     */
+    private validateProcessedConfig;
+    /**
+     * Convert snake_case or kebab-case to camelCase.
+     *
+     * @param str - String to convert
+     * @returns camelCase string
+     */
+    private toCamelCase;
+    /**
+     * Convert path segments to nested key structure.
+     *
+     * @param path - Path string
+     * @returns Nested key structure
+     */
+    private pathToNestedKey;
+    /**
+     * Set a nested value in an object using dot notation.
+     *
+     * @param obj - Target object
+     * @param path - Dot notation path
+     * @param value - Value to set
+     */
+    private setNestedValue;
+    /**
+     * Validate namespace name.
+     *
+     * @param namespace - Namespace to validate
+     * @returns Whether namespace is valid
+     */
+    private isValidNamespace;
+    /**
+     * Check if namespace is reserved.
+     *
+     * @param namespace - Namespace to check
+     * @returns Whether namespace is reserved
+     */
+    private isReservedNamespace;
+    /**
+     * Validate namespace configuration.
+     *
+     * @param namespace - Namespace name
+     * @param config - Configuration data
+     * @returns Whether configuration is valid
+     */
+    private isValidNamespaceConfig;
+    /**
+     * Find key conflicts in configuration.
+     *
+     * @param config - Configuration to check
+     * @returns Array of conflicting keys
+     */
+    private findKeyConflicts;
+    /**
+     * Generate usage examples for a namespace.
+     *
+     * @param namespace - Namespace name
+     * @param config - Configuration data
+     * @returns Array of usage examples
+     */
+    private generateUsageExamples;
+}
+//# sourceMappingURL=namespace-handler.service.d.ts.map

package/dist/types/integration/services/namespace-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace-handler.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/namespace-handler.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAEnF;;;GAGG;AACH,qBACa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAEnE;;;;;;;;OAQG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAC9B,aAAa;IA4BhB;;;;;;OAMG;IACH,gCAAgC,CAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACrD,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAC9B,aAAa,EAAE;IA6BlB;;;;;;OAMG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAmB3F;;;;;;OAMG;IACH,0BAA0B,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAsBtC;;;;;;OAMG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IAoCD;;;;;;OAMG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE;YACR,SAAS,EAAE,MAAM,CAAC;YAClB,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;IAgBD;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAoB9B"}

package/dist/types/integration/services/nestjs-config-integration.service.d.ts

@@ -0,0 +1,87 @@
+import { ConfigFactory, ConfigModuleOptions } from '@nestjs/config';
+import { DynamicModule } from '@nestjs/common';
+import { FactoryRegistrationService } from './factory-registration.service';
+import { IntegrationOptions } from '../interfaces/integration-options.interface';
+/**
+ * Service that provides integration utilities for working with @nestjs/config.
+ * This service creates ConfigModule configurations that include AWS-sourced factories.
+ */
+export declare class NestjsConfigIntegrationService {
+    private readonly factoryRegistrationService;
+    private readonly options;
+    private readonly logger;
+    constructor(factoryRegistrationService: FactoryRegistrationService, options?: IntegrationOptions);
+    /**
+     * Create a ConfigModule configuration with AWS-sourced factories.
+     * This method can be used to enhance existing @nestjs/config setups.
+     *
+     * @param baseOptions - Base ConfigModule options to enhance
+     * @returns Promise resolving to enhanced ConfigModule options
+     */
+    createConfigModuleOptions(baseOptions?: ConfigModuleOptions): Promise<ConfigModuleOptions>;
+    /**
+     * Create a ConfigModule configuration for async setup.
+     * This method works with ConfigModule.forRootAsync() pattern.
+     *
+     * @param baseOptions - Base async ConfigModule options to enhance
+     * @returns Promise resolving to enhanced async ConfigModule options
+     */
+    createAsyncConfigModuleOptions(baseOptions?: any): Promise<any>;
+    /**
+     * Create a complete ConfigModule with AWS integration.
+     * This method returns a ready-to-use DynamicModule.
+     *
+     * @param baseOptions - Base ConfigModule options
+     * @returns Promise resolving to DynamicModule with AWS integration
+     */
+    createIntegratedConfigModule(baseOptions?: ConfigModuleOptions): Promise<DynamicModule>;
+    /**
+     * Create an async integrated ConfigModule.
+     * This method returns a ready-to-use async DynamicModule.
+     *
+     * @param baseOptions - Base async ConfigModule options
+     * @returns Promise resolving to DynamicModule with async AWS integration
+     */
+    createAsyncIntegratedConfigModule(baseOptions?: ConfigModuleOptions): Promise<DynamicModule>;
+    /**
+     * Get configuration factories for manual registration.
+     * This method allows developers to manually register AWS factories with their own ConfigModule setup.
+     *
+     * @returns Promise resolving to array of configuration factories
+     */
+    getConfigurationFactories(): Promise<ConfigFactory[]>;
+    /**
+     * Get namespaced configuration factories.
+     * This method returns factories for specific namespaces only.
+     *
+     * @param namespaces - Array of namespace names to get factories for
+     * @returns Promise resolving to array of namespaced configuration factories
+     */
+    getNamespacedFactories(namespaces: string[]): Promise<ConfigFactory[]>;
+    /**
+     * Create a configuration factory for immediate use.
+     * This method creates a single factory that can be used directly with @nestjs/config.
+     *
+     * @param namespace - Optional namespace for the factory
+     * @param config - Optional configuration data to use
+     * @returns Configuration factory
+     */
+    createImmediateFactory(namespace?: string, config?: Record<string, any>): ConfigFactory;
+    /**
+     * Check if AWS integration is available and working.
+     * This method can be used to verify the integration status.
+     *
+     * @returns Promise resolving to integration status
+     */
+    checkIntegrationStatus(): Promise<{
+        isAvailable: boolean;
+        factoriesRegistered: number;
+        errors: string[];
+    }>;
+    /**
+     * Reset the integration state.
+     * This method clears all registered factories and resets the integration.
+     */
+    resetIntegration(): void;
+}
+//# sourceMappingURL=nestjs-config-integration.service.d.ts.map

package/dist/types/integration/services/nestjs-config-integration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-config-integration.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/nestjs-config-integration.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAgB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGjF;;;GAGG;AACH,qBACa,8BAA8B;IAIvC,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;gBAGvD,0BAA0B,EAAE,0BAA0B,EAEtD,OAAO,GAAE,kBAAuB;IAGnD;;;;;;OAMG;IACG,yBAAyB,CAAC,WAAW,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0CpG;;;;;;OAMG;IACG,8BAA8B,CAAC,WAAW,GAAE,GAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IA4CzE;;;;;;OAMG;IACG,4BAA4B,CAAC,WAAW,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BjG;;;;;;OAMG;IACG,iCAAiC,CAAC,WAAW,GAAE,mBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BtG;;;;;OAKG;IACG,yBAAyB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB3D;;;;;;OAMG;IACG,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB5E;;;;;;;OAOG;IACH,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;IAyBvF;;;;;OAKG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAkCF;;;OAGG;IACH,gBAAgB,IAAI,IAAI;CAKzB"}