@dyanet/nestjs-config-aws 1.0.1

package/dist/types/integration/interfaces/configuration-factory.interface.d.ts

@@ -0,0 +1,71 @@
+import { ConfigFactory } from '@nestjs/config';
+import { ConfigurationSource } from './configuration-source.interface';
+import { PrecedenceRule } from './integration-options.interface';
+/**
+ * Enhanced configuration factory that includes AWS integration metadata.
+ */
+export interface AwsConfigurationFactory extends ConfigFactory {
+    /** Optional namespace for the configuration */
+    namespace?: string;
+    /** Sources that contributed to this configuration */
+    sources: ConfigurationSource[];
+    /** Precedence rule applied to this configuration */
+    precedenceRule: PrecedenceRule;
+}
+/**
+ * Provider for creating configuration factories that @nestjs/config can consume.
+ */
+export interface ConfigurationFactoryProvider {
+    /**
+     * Create a configuration factory for a specific namespace.
+     * @param namespace - The namespace for the configuration
+     * @param config - The configuration data
+     * @returns A configuration factory
+     */
+    createFactory(namespace: string, config: Record<string, any>): ConfigFactory;
+    /**
+     * Create multiple namespaced configuration factories.
+     * @param config - The configuration data organized by namespace
+     * @returns Array of configuration factories
+     */
+    createNamespacedFactories(config: Record<string, any>): ConfigFactory[];
+    /**
+     * Merge AWS configuration with existing local configuration.
+     * @param awsConfig - Configuration loaded from AWS sources
+     * @param localConfig - Local configuration data
+     * @returns Merged configuration data
+     */
+    mergeWithExisting(awsConfig: Record<string, any>, localConfig: Record<string, any>): Record<string, any>;
+    /**
+     * Create an enhanced AWS configuration factory with metadata.
+     * @param namespace - Optional namespace for the configuration
+     * @param config - The configuration data
+     * @param sources - Sources that contributed to this configuration
+     * @param precedenceRule - Precedence rule applied to this configuration
+     * @returns Enhanced AWS configuration factory
+     */
+    createAwsConfigurationFactory(namespace: string | undefined, config: Record<string, any>, sources: ConfigurationSource[], precedenceRule: PrecedenceRule): AwsConfigurationFactory;
+    /**
+     * Create configuration factories from multiple sources with proper organization.
+     * @param sourceConfigs - Map of source name to configuration data
+     * @param namespaces - Optional list of namespaces to organize configuration
+     * @returns Array of configuration factories organized by namespace
+     */
+    createFactoriesFromSources(sourceConfigs: Map<string, Record<string, any>>, namespaces?: string[]): ConfigFactory[];
+    /**
+     * Create configuration factories from sources with precedence rules.
+     * @param sources - Array of configuration sources
+     * @param precedenceRule - Precedence rule to apply
+     * @param namespaces - Optional list of namespaces to organize configuration
+     * @returns Array of configuration factories
+     */
+    createFactoriesWithPrecedence(sources: ConfigurationSource[], precedenceRule: PrecedenceRule, namespaces?: string[]): ConfigFactory[];
+    /**
+     * Merge configuration with explicit precedence rule.
+     * @param sources - Configuration sources
+     * @param precedenceRule - Precedence rule to apply
+     * @returns Merged configuration data
+     */
+    mergeWithPrecedence(sources: ConfigurationSource[], precedenceRule: PrecedenceRule): Record<string, any>;
+}
+//# sourceMappingURL=configuration-factory.interface.d.ts.map

package/dist/types/integration/interfaces/configuration-factory.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-factory.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/configuration-factory.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,aAAa;IAC5D,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oDAAoD;IACpD,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,CAAC;IAE7E;;;;OAIG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,EAAE,CAAC;IAExE;;;;;OAKG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvB;;;;;;;OAOG;IACH,6BAA6B,CAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,cAAc,EAAE,cAAc,GAC7B,uBAAuB,CAAC;IAE3B;;;;;OAKG;IACH,0BAA0B,CACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,aAAa,EAAE,CAAC;IAEnB;;;;;;OAMG;IACH,6BAA6B,CAC3B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,cAAc,EAAE,cAAc,EAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,aAAa,EAAE,CAAC;IAEnB;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,cAAc,EAAE,cAAc,GAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxB"}

package/dist/types/integration/interfaces/configuration-source.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Types of configuration sources supported by the integration.
+ */
+export type ConfigurationSourceType = 'environment' | 'secrets-manager' | 'ssm' | 'local-file';
+/**
+ * Represents a configuration source with metadata about its origin and state.
+ */
+export interface ConfigurationSource {
+    /** Human-readable name of the configuration source */
+    name: string;
+    /** Type of the configuration source */
+    type: ConfigurationSourceType;
+    /** Priority of this source (higher numbers have higher priority) */
+    priority: number;
+    /** The configuration data from this source */
+    data: Record<string, any>;
+    /** Optional namespace for this configuration */
+    namespace?: string;
+    /** Timestamp when this configuration was loaded */
+    loadedAt: Date;
+    /** Any errors encountered while loading this source */
+    errors?: string[];
+}
+//# sourceMappingURL=configuration-source.interface.d.ts.map

package/dist/types/integration/interfaces/configuration-source.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-source.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/configuration-source.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,iBAAiB,GAAG,KAAK,GAAG,YAAY,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,QAAQ,EAAE,IAAI,CAAC;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

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

@@ -0,0 +1,9 @@
+export * from './integration-options.interface';
+export * from './configuration-factory.interface';
+export * from './configuration-source.interface';
+export * from './integration-state.interface';
+export * from './typed-configuration.interface';
+export * from './nestjs-config-integration.interface';
+export * from './nestjs-config-compatibility.interface';
+export * from './utility-types.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,2BAA2B,CAAC"}

package/dist/types/integration/interfaces/integration-options.interface.d.ts

@@ -0,0 +1,66 @@
+import { SecretsManagerConfig, SSMConfig } from '../../interfaces/module-options.interface';
+/**
+ * Precedence rules for configuration sources when the same key exists in multiple sources.
+ */
+export type PrecedenceRule = 'aws-first' | 'local-first' | 'merge';
+/**
+ * Error handling strategy for various failure scenarios.
+ */
+export interface ErrorHandlingStrategy {
+    /** How to handle AWS service unavailability */
+    onAwsUnavailable: 'fail' | 'warn' | 'silent';
+    /** How to handle configuration errors */
+    onConfigurationError: 'fail' | 'warn' | 'use-default';
+    /** How to handle validation errors */
+    onValidationError: 'fail' | 'warn' | 'skip-invalid';
+    /** Whether to enable detailed logging */
+    enableDetailedLogging: boolean;
+}
+/**
+ * Factory options for @nestjs/config compatibility.
+ */
+export interface FactoryOptions {
+    /** Whether to cache configuration values */
+    cache?: boolean;
+    /** Whether to expand variables in configuration values */
+    expandVariables?: boolean;
+}
+/**
+ * Configuration options for the NestJS Config AWS Integration module.
+ */
+export interface IntegrationOptions {
+    /** Configuration for AWS Secrets Manager integration */
+    secretsManagerConfig?: SecretsManagerConfig;
+    /** Configuration for AWS Systems Manager Parameter Store integration */
+    ssmConfig?: SSMConfig;
+    /** Precedence rule for configuration sources */
+    precedence?: PrecedenceRule;
+    /** Namespaces to load configuration for */
+    namespaces?: string[];
+    /** Whether to enable logging */
+    enableLogging?: boolean;
+    /** Whether to register the module globally */
+    registerGlobally?: boolean;
+    /** Factory options for @nestjs/config compatibility */
+    factoryOptions?: FactoryOptions;
+    /** Whether to fail on AWS errors */
+    failOnAwsError?: boolean;
+    /** Whether to fallback to local configuration on AWS errors */
+    fallbackToLocal?: boolean;
+    /** Error handling strategy */
+    errorHandling?: ErrorHandlingStrategy;
+    /** Prefix for environment variables (e.g., 'APP_') */
+    envPrefix?: string;
+}
+/**
+ * Async factory options for dynamic integration module configuration.
+ */
+export interface AsyncIntegrationOptions {
+    /** Factory function to create integration options */
+    useFactory: (...args: any[]) => Promise<IntegrationOptions> | IntegrationOptions;
+    /** Dependencies to inject into the factory function */
+    inject?: any[];
+    /** Imports required for the factory function */
+    imports?: any[];
+}
+//# sourceMappingURL=integration-options.interface.d.ts.map

package/dist/types/integration/interfaces/integration-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/integration-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACtD,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;IACpD,yCAAyC;IACzC,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,gDAAgD;IAChD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAGhC,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8BAA8B;IAC9B,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAEtC,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IAEjF,uDAAuD;IACvD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAEf,gDAAgD;IAChD,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB"}

package/dist/types/integration/interfaces/integration-state.interface.d.ts

@@ -0,0 +1,17 @@
+import { ConfigurationSource } from './configuration-source.interface';
+/**
+ * Represents the current state of the integration module.
+ */
+export interface IntegrationState {
+    /** Whether the integration has been initialized */
+    isInitialized: boolean;
+    /** Whether AWS services are available */
+    awsAvailable: boolean;
+    /** List of configuration sources that have been loaded */
+    loadedSources: ConfigurationSource[];
+    /** List of factory names that have been registered with @nestjs/config */
+    registeredFactories: string[];
+    /** Any errors encountered during initialization or operation */
+    errors: string[];
+}
+//# sourceMappingURL=integration-state.interface.d.ts.map

package/dist/types/integration/interfaces/integration-state.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-state.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/integration-state.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,0DAA0D;IAC1D,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,0EAA0E;IAC1E,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gEAAgE;IAChE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types/integration/interfaces/nestjs-config-compatibility.interface.d.ts

@@ -0,0 +1,332 @@
+import { ConfigService } from '@nestjs/config';
+import { Type } from '@nestjs/common';
+/**
+ * Enhanced ConfigService that provides AWS integration capabilities.
+ */
+export interface EnhancedConfigService extends ConfigService {
+    /**
+     * Get configuration value with AWS source information.
+     * @param propertyPath - Configuration property path
+     * @param defaultValue - Default value if property is not found
+     * @returns Configuration value with source metadata
+     */
+    getWithSource<T = any>(propertyPath: string, defaultValue?: T): ConfigValueWithSource<T>;
+    /**
+     * Get configuration value from AWS sources only.
+     * @param propertyPath - Configuration property path
+     * @param defaultValue - Default value if property is not found
+     * @returns Configuration value from AWS sources
+     */
+    getFromAws<T = any>(propertyPath: string, defaultValue?: T): T | undefined;
+    /**
+     * Get configuration value from local sources only.
+     * @param propertyPath - Configuration property path
+     * @param defaultValue - Default value if property is not found
+     * @returns Configuration value from local sources
+     */
+    getFromLocal<T = any>(propertyPath: string, defaultValue?: T): T | undefined;
+    /**
+     * Check if a configuration value comes from AWS sources.
+     * @param propertyPath - Configuration property path
+     * @returns True if value comes from AWS, false otherwise
+     */
+    isFromAws(propertyPath: string): boolean;
+    /**
+     * Get all configuration keys from AWS sources.
+     * @returns Array of configuration keys from AWS sources
+     */
+    getAwsKeys(): string[];
+    /**
+     * Get all configuration keys from local sources.
+     * @returns Array of configuration keys from local sources
+     */
+    getLocalKeys(): string[];
+    /**
+     * Get configuration source information for a property.
+     * @param propertyPath - Configuration property path
+     * @returns Source information or undefined
+     */
+    getSourceInfo(propertyPath: string): ConfigSourceInfo | undefined;
+    /**
+     * Refresh AWS configuration values.
+     * @returns Promise that resolves when refresh is complete
+     */
+    refreshAwsConfig(): Promise<void>;
+    /**
+     * Get configuration health status.
+     * @returns Configuration health information
+     */
+    getHealthStatus(): ConfigHealthStatus;
+}
+/**
+ * Configuration value with source metadata.
+ */
+export interface ConfigValueWithSource<T = any> {
+    /** The configuration value */
+    value: T;
+    /** Source information */
+    source: ConfigSourceInfo;
+    /** Whether the value was found */
+    found: boolean;
+}
+/**
+ * Configuration source information.
+ */
+export interface ConfigSourceInfo {
+    /** Source type */
+    type: 'environment' | 'secrets-manager' | 'ssm' | 'local-file';
+    /** Whether this is an AWS source */
+    isAws: boolean;
+    /** Source priority */
+    priority: number;
+    /** Namespace if applicable */
+    namespace?: string;
+    /** When the value was loaded */
+    loadedAt: Date;
+    /** Original key used to load the value */
+    originalKey?: string;
+}
+/**
+ * Configuration health status.
+ */
+export interface ConfigHealthStatus {
+    /** Overall health status */
+    healthy: boolean;
+    /** AWS services availability */
+    awsAvailable: boolean;
+    /** Number of loaded configuration sources */
+    sourcesLoaded: number;
+    /** Number of failed sources */
+    sourcesFailed: number;
+    /** Last successful AWS load time */
+    lastAwsLoad?: Date;
+    /** Any health issues */
+    issues: string[];
+}
+/**
+ * Decorator for injecting enhanced config service.
+ */
+export declare const InjectEnhancedConfig: () => ParameterDecorator;
+/**
+ * Configuration property decorator for type-safe configuration access.
+ */
+export interface ConfigPropertyOptions {
+    /** Configuration key */
+    key: string;
+    /** Default value */
+    defaultValue?: any;
+    /** Whether to require the property */
+    required?: boolean;
+    /** Validation function */
+    validate?: (value: any) => boolean;
+    /** Transformation function */
+    transform?: (value: any) => any;
+    /** Whether to prefer AWS sources */
+    preferAws?: boolean;
+}
+/**
+ * Configuration property decorator.
+ */
+export declare function ConfigProperty(options: ConfigPropertyOptions): PropertyDecorator;
+/**
+ * Configuration class decorator for automatic configuration injection.
+ */
+export interface ConfigClassOptions {
+    /** Configuration namespace */
+    namespace?: string;
+    /** Whether to validate all properties */
+    validate?: boolean;
+    /** Whether to prefer AWS sources */
+    preferAws?: boolean;
+}
+/**
+ * Configuration class decorator.
+ */
+export declare function ConfigClass(options?: ConfigClassOptions): ClassDecorator;
+/**
+ * Configuration validation decorator.
+ */
+export interface ConfigValidationOptions {
+    /** Validation schema */
+    schema?: any;
+    /** Custom validation function */
+    validator?: (config: any) => boolean | Promise<boolean>;
+    /** Whether to throw on validation failure */
+    throwOnError?: boolean;
+}
+/**
+ * Configuration validation decorator.
+ */
+export declare function ValidateConfig(options: ConfigValidationOptions): ClassDecorator;
+/**
+ * Configuration transformer interface.
+ */
+export interface ConfigTransformer<TInput = any, TOutput = any> {
+    /**
+     * Transform configuration value.
+     * @param value - Input value
+     * @param key - Configuration key
+     * @returns Transformed value
+     */
+    transform(value: TInput, key: string): TOutput;
+}
+/**
+ * Configuration transformer decorator.
+ */
+export declare function TransformConfig<TInput, TOutput>(transformer: ConfigTransformer<TInput, TOutput>): PropertyDecorator;
+/**
+ * Configuration factory with enhanced type safety.
+ */
+export interface TypeSafeConfigFactory<T = any> {
+    (): T;
+    KEY: string;
+    asProvider(): {
+        provide: string;
+        useFactory: () => T;
+        inject: [ConfigService];
+    };
+}
+/**
+ * Create a type-safe configuration factory.
+ */
+export declare function createTypeSafeConfigFactory<T>(key: string, factory: (config: ConfigService) => T): TypeSafeConfigFactory<T>;
+/**
+ * Configuration module builder for enhanced setup.
+ */
+export interface ConfigModuleBuilder {
+    /**
+     * Add AWS integration.
+     */
+    withAwsIntegration(options: any): ConfigModuleBuilder;
+    /**
+     * Add configuration factories.
+     */
+    withFactories(factories: TypeSafeConfigFactory[]): ConfigModuleBuilder;
+    /**
+     * Add validation.
+     */
+    withValidation(schema: any): ConfigModuleBuilder;
+    /**
+     * Set as global module.
+     */
+    asGlobal(): ConfigModuleBuilder;
+    /**
+     * Enable caching.
+     */
+    withCaching(): ConfigModuleBuilder;
+    /**
+     * Build the module.
+     */
+    build(): Type<any>;
+}
+/**
+ * Configuration testing utilities.
+ */
+export interface ConfigTestingUtils {
+    /**
+     * Create a mock config service.
+     */
+    createMockConfigService(config: Record<string, any>): EnhancedConfigService;
+    /**
+     * Create test configuration module.
+     */
+    createTestConfigModule(config: Record<string, any>): Type<any>;
+    /**
+     * Mock AWS configuration sources.
+     */
+    mockAwsSources(config: Record<string, any>): void;
+    /**
+     * Reset all mocks.
+     */
+    resetMocks(): void;
+}
+/**
+ * Configuration monitoring interface.
+ */
+export interface ConfigMonitor {
+    /**
+     * Start monitoring configuration changes.
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring configuration changes.
+     */
+    stopMonitoring(): void;
+    /**
+     * Get configuration metrics.
+     */
+    getMetrics(): ConfigMetrics;
+    /**
+     * Subscribe to configuration events.
+     */
+    subscribe(callback: (event: ConfigEvent) => void): () => void;
+}
+/**
+ * Configuration metrics.
+ */
+export interface ConfigMetrics {
+    /** Total configuration loads */
+    totalLoads: number;
+    /** Successful AWS loads */
+    successfulAwsLoads: number;
+    /** Failed AWS loads */
+    failedAwsLoads: number;
+    /** Average load time */
+    averageLoadTime: number;
+    /** Last load time */
+    lastLoadTime?: Date;
+    /** Configuration cache hit rate */
+    cacheHitRate: number;
+}
+/**
+ * Configuration event.
+ */
+export interface ConfigEvent {
+    /** Event type */
+    type: 'loaded' | 'updated' | 'error' | 'validated';
+    /** Event timestamp */
+    timestamp: Date;
+    /** Event data */
+    data: any;
+    /** Source of the event */
+    source: string;
+}
+/**
+ * Configuration audit log entry.
+ */
+export interface ConfigAuditEntry {
+    /** Audit entry ID */
+    id: string;
+    /** Timestamp */
+    timestamp: Date;
+    /** Action performed */
+    action: 'load' | 'update' | 'delete' | 'validate';
+    /** Configuration key affected */
+    key: string;
+    /** Old value (for updates) */
+    oldValue?: any;
+    /** New value */
+    newValue?: any;
+    /** Source of the change */
+    source: string;
+    /** User or system that made the change */
+    actor: string;
+}
+/**
+ * Configuration audit logger.
+ */
+export interface ConfigAuditLogger {
+    /**
+     * Log a configuration change.
+     */
+    log(entry: Omit<ConfigAuditEntry, 'id' | 'timestamp'>): void;
+    /**
+     * Get audit log entries.
+     */
+    getEntries(filter?: Partial<ConfigAuditEntry>): ConfigAuditEntry[];
+    /**
+     * Clear audit log.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=nestjs-config-compatibility.interface.d.ts.map

package/dist/types/integration/interfaces/nestjs-config-compatibility.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-config-compatibility.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/nestjs-config-compatibility.interface.ts"],"names":[],"mappings":"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"}