@dyanet/nestjs-config-aws 1.0.1

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

@@ -0,0 +1,259 @@
+import { ConfigFactory, ConfigModuleOptions } from '@nestjs/config';
+import { DynamicModule, ModuleMetadata, Type } from '@nestjs/common';
+import { IntegrationOptions } from './integration-options.interface';
+import { ConfigurationSource } from './configuration-source.interface';
+import { TypedConfiguration, ConfigurationSchema } from './typed-configuration.interface';
+/**
+ * Enhanced module options that extend @nestjs/config options with AWS integration.
+ */
+export interface EnhancedConfigModuleOptions extends ConfigModuleOptions {
+    /** AWS integration options */
+    awsIntegration?: IntegrationOptions;
+    /** Whether to enable AWS configuration loading */
+    enableAwsIntegration?: boolean;
+    /** Custom configuration schemas for type safety */
+    schemas?: ConfigurationSchema[];
+}
+/**
+ * Factory function type for creating enhanced configuration modules.
+ */
+export type EnhancedConfigModuleFactory = (options?: EnhancedConfigModuleOptions) => DynamicModule;
+/**
+ * Async factory function type for creating enhanced configuration modules.
+ */
+export type EnhancedAsyncConfigModuleFactory = (options: EnhancedAsyncConfigModuleOptions) => DynamicModule;
+/**
+ * Async options for enhanced configuration module.
+ */
+export interface EnhancedAsyncConfigModuleOptions extends ModuleMetadata {
+    /** Factory function to create enhanced configuration options */
+    useFactory?: (...args: any[]) => Promise<EnhancedConfigModuleOptions> | EnhancedConfigModuleOptions;
+    /** Class to use as factory */
+    useClass?: Type<EnhancedConfigModuleOptionsFactory>;
+    /** Existing instance to use as factory */
+    useExisting?: Type<EnhancedConfigModuleOptionsFactory>;
+    /** Dependencies to inject into the factory function */
+    inject?: any[];
+}
+/**
+ * Factory interface for creating enhanced configuration module options.
+ */
+export interface EnhancedConfigModuleOptionsFactory {
+    /**
+     * Create enhanced configuration module options.
+     * @returns Enhanced configuration module options
+     */
+    createConfigOptions(): Promise<EnhancedConfigModuleOptions> | EnhancedConfigModuleOptions;
+}
+/**
+ * Integration service interface for managing AWS and @nestjs/config integration.
+ */
+export interface NestJSConfigIntegrationService {
+    /**
+     * Initialize the integration with @nestjs/config.
+     * @param options - Integration options
+     */
+    initialize(options: IntegrationOptions): Promise<void>;
+    /**
+     * Register configuration factories with @nestjs/config.
+     * @param factories - Configuration factories to register
+     */
+    registerFactories(factories: ConfigFactory[]): Promise<void>;
+    /**
+     * Get configuration from AWS sources and format for @nestjs/config.
+     * @param namespaces - Optional namespaces to load
+     * @returns Configuration data organized for @nestjs/config
+     */
+    getConfigurationForNestJS(namespaces?: string[]): Promise<Record<string, any>>;
+    /**
+     * Create configuration factories from AWS sources.
+     * @param sources - Configuration sources from AWS
+     * @param namespaces - Optional namespaces to organize configuration
+     * @returns Array of configuration factories
+     */
+    createFactoriesFromAwsSources(sources: ConfigurationSource[], namespaces?: string[]): ConfigFactory[];
+    /**
+     * Merge AWS configuration with existing @nestjs/config configuration.
+     * @param awsConfig - Configuration from AWS sources
+     * @param existingConfig - Existing @nestjs/config configuration
+     * @returns Merged configuration
+     */
+    mergeWithExistingConfig(awsConfig: Record<string, any>, existingConfig: Record<string, any>): Record<string, any>;
+    /**
+     * Validate configuration using @nestjs/config validation patterns.
+     * @param config - Configuration to validate
+     * @param validationSchema - Optional validation schema
+     * @returns Validation result
+     */
+    validateConfiguration(config: Record<string, any>, validationSchema?: any): Promise<boolean>;
+    /**
+     * Get typed configuration with full type safety.
+     * @param key - Configuration key or namespace
+     * @returns Typed configuration
+     */
+    getTypedConfiguration<T = any>(key: string): TypedConfiguration<T> | undefined;
+    /**
+     * Check if the integration is properly initialized.
+     * @returns True if initialized, false otherwise
+     */
+    isInitialized(): boolean;
+    /**
+     * Get integration status and health information.
+     * @returns Integration status information
+     */
+    getStatus(): IntegrationStatus;
+}
+/**
+ * Integration status information.
+ */
+export interface IntegrationStatus {
+    /** Whether the integration is initialized */
+    initialized: boolean;
+    /** Whether AWS services are available */
+    awsAvailable: boolean;
+    /** Number of configuration sources loaded */
+    sourcesLoaded: number;
+    /** Number of factories registered */
+    factoriesRegistered: number;
+    /** Any errors encountered */
+    errors: string[];
+    /** Last update timestamp */
+    lastUpdated: Date;
+}
+/**
+ * Configuration loader interface for AWS integration with @nestjs/config.
+ */
+export interface AwsConfigurationLoader {
+    /**
+     * Load configuration from AWS sources for @nestjs/config integration.
+     * @param options - Integration options
+     * @returns Promise resolving to configuration data
+     */
+    loadForNestJSConfig(options: IntegrationOptions): Promise<Record<string, any>>;
+    /**
+     * Load namespaced configuration from AWS sources.
+     * @param namespaces - Namespaces to load
+     * @param options - Integration options
+     * @returns Promise resolving to namespaced configuration data
+     */
+    loadNamespacedForNestJSConfig(namespaces: string[], options: IntegrationOptions): Promise<Record<string, Record<string, any>>>;
+    /**
+     * Check if AWS services are available for configuration loading.
+     * @returns Promise resolving to availability status
+     */
+    checkAwsAvailability(): Promise<boolean>;
+    /**
+     * Get configuration sources that are available.
+     * @param options - Integration options
+     * @returns Promise resolving to available sources
+     */
+    getAvailableSources(options: IntegrationOptions): Promise<string[]>;
+}
+/**
+ * Configuration merger interface for handling precedence rules.
+ */
+export interface ConfigurationMerger {
+    /**
+     * Merge configurations with precedence rules.
+     * @param sources - Configuration sources to merge
+     * @param precedenceRule - Precedence rule to apply
+     * @returns Merged configuration
+     */
+    mergeWithPrecedence(sources: ConfigurationSource[], precedenceRule: 'aws-first' | 'local-first' | 'merge'): Record<string, any>;
+    /**
+     * Merge two configuration objects.
+     * @param primary - Primary configuration (higher precedence)
+     * @param secondary - Secondary configuration (lower precedence)
+     * @returns Merged configuration
+     */
+    merge(primary: Record<string, any>, secondary: Record<string, any>): Record<string, any>;
+    /**
+     * Deep merge configuration objects with conflict resolution.
+     * @param configs - Array of configuration objects to merge
+     * @param conflictResolution - How to resolve conflicts
+     * @returns Merged configuration
+     */
+    deepMerge(configs: Record<string, any>[], conflictResolution?: 'first-wins' | 'last-wins' | 'merge-arrays'): Record<string, any>;
+}
+/**
+ * Configuration validator interface for AWS-sourced values.
+ */
+export interface AwsConfigurationValidator {
+    /**
+     * Validate configuration using Joi schema.
+     * @param config - Configuration to validate
+     * @param schema - Joi validation schema
+     * @returns Validation result
+     */
+    validateWithJoi(config: Record<string, any>, schema: any): Promise<boolean>;
+    /**
+     * Validate configuration using class-validator.
+     * @param config - Configuration to validate
+     * @param validationClass - Class with validation decorators
+     * @returns Validation result
+     */
+    validateWithClassValidator(config: Record<string, any>, validationClass: any): Promise<boolean>;
+    /**
+     * Validate configuration using custom validation function.
+     * @param config - Configuration to validate
+     * @param validationFn - Custom validation function
+     * @returns Validation result
+     */
+    validateWithCustomFunction(config: Record<string, any>, validationFn: (config: any) => boolean | Promise<boolean>): Promise<boolean>;
+    /**
+     * Get validation errors for configuration.
+     * @param config - Configuration to validate
+     * @param schema - Validation schema
+     * @returns Array of validation errors
+     */
+    getValidationErrors(config: Record<string, any>, schema: any): string[];
+}
+/**
+ * Utility type for extracting configuration type from @nestjs/config factory.
+ */
+export type ExtractConfigType<T> = T extends () => infer U ? U : never;
+/**
+ * Utility type for creating strongly typed configuration service.
+ */
+export type TypedConfigService<T extends Record<string, ConfigFactory>> = {
+    get<K extends keyof T>(key: K): ExtractConfigType<T[K]> | undefined;
+    getOrThrow<K extends keyof T>(key: K): ExtractConfigType<T[K]>;
+};
+/**
+ * Configuration namespace registry for managing namespaced configurations.
+ */
+export interface ConfigurationNamespaceRegistry {
+    /**
+     * Register a namespace with its configuration factory.
+     * @param namespace - Namespace name
+     * @param factory - Configuration factory for the namespace
+     */
+    register(namespace: string, factory: ConfigFactory): void;
+    /**
+     * Get a configuration factory by namespace.
+     * @param namespace - Namespace name
+     * @returns Configuration factory or undefined
+     */
+    get(namespace: string): ConfigFactory | undefined;
+    /**
+     * Check if a namespace is registered.
+     * @param namespace - Namespace name
+     * @returns True if registered, false otherwise
+     */
+    has(namespace: string): boolean;
+    /**
+     * Get all registered namespaces.
+     * @returns Array of namespace names
+     */
+    getNamespaces(): string[];
+    /**
+     * Unregister a namespace.
+     * @param namespace - Namespace name
+     */
+    unregister(namespace: string): void;
+    /**
+     * Clear all registered namespaces.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=nestjs-config-integration.interface.d.ts.map

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

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

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

@@ -0,0 +1,209 @@
+/**
+ * Generic type for typed configuration access.
+ * Provides type safety for configuration values loaded from AWS sources.
+ */
+export interface TypedConfiguration<T = any> {
+    /** The configuration data with proper typing */
+    data: T;
+    /** Namespace for this configuration */
+    namespace?: string;
+    /** Whether this configuration was loaded from AWS sources */
+    fromAws: boolean;
+    /** Timestamp when this configuration was loaded */
+    loadedAt: Date;
+}
+/**
+ * Generic configuration factory with type safety.
+ */
+export interface TypedConfigurationFactory<T = any> {
+    /** Type-safe configuration data */
+    (): T;
+}
+/**
+ * Configuration accessor with type safety for AWS-sourced values.
+ */
+export interface TypedConfigurationAccessor {
+    /**
+     * Get typed configuration value with type safety.
+     * @param key - Configuration key (supports dot notation)
+     * @returns Typed configuration value
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Get typed configuration value or throw if not found.
+     * @param key - Configuration key (supports dot notation)
+     * @returns Typed configuration value
+     * @throws Error if key is not found
+     */
+    getOrThrow<T = any>(key: string): T;
+    /**
+     * Get namespaced typed configuration.
+     * @param namespace - Configuration namespace
+     * @returns Typed configuration for the namespace
+     */
+    getNamespaced<T = any>(namespace: string): TypedConfiguration<T> | undefined;
+    /**
+     * Get namespaced typed configuration or throw if not found.
+     * @param namespace - Configuration namespace
+     * @returns Typed configuration for the namespace
+     * @throws Error if namespace is not found
+     */
+    getNamespacedOrThrow<T = any>(namespace: string): TypedConfiguration<T>;
+    /**
+     * Check if a configuration key exists.
+     * @param key - Configuration key (supports dot notation)
+     * @returns True if key exists, false otherwise
+     */
+    has(key: string): boolean;
+    /**
+     * Check if a namespace exists.
+     * @param namespace - Configuration namespace
+     * @returns True if namespace exists, false otherwise
+     */
+    hasNamespace(namespace: string): boolean;
+    /**
+     * Get all configuration keys.
+     * @returns Array of all configuration keys
+     */
+    getKeys(): string[];
+    /**
+     * Get all namespaces.
+     * @returns Array of all namespaces
+     */
+    getNamespaces(): string[];
+}
+/**
+ * Type-safe configuration schema definition.
+ */
+export interface ConfigurationSchema<T = any> {
+    /** Schema name/identifier */
+    name: string;
+    /** Optional namespace for this schema */
+    namespace?: string;
+    /** Type definition for the configuration */
+    type: new () => T;
+    /** Optional validation function */
+    validate?: (config: any) => config is T;
+    /** Optional default values */
+    defaults?: Partial<T>;
+}
+/**
+ * Configuration registry for managing typed configurations.
+ */
+export interface TypedConfigurationRegistry {
+    /**
+     * Register a typed configuration schema.
+     * @param schema - Configuration schema to register
+     */
+    register<T>(schema: ConfigurationSchema<T>): void;
+    /**
+     * Get a typed configuration by name.
+     * @param name - Schema name
+     * @returns Typed configuration or undefined
+     */
+    get<T = any>(name: string): TypedConfiguration<T> | undefined;
+    /**
+     * Get a typed configuration by name or throw if not found.
+     * @param name - Schema name
+     * @returns Typed configuration
+     * @throws Error if schema is not found
+     */
+    getOrThrow<T = any>(name: string): TypedConfiguration<T>;
+    /**
+     * Check if a schema is registered.
+     * @param name - Schema name
+     * @returns True if schema is registered, false otherwise
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered schema names.
+     * @returns Array of schema names
+     */
+    getSchemaNames(): string[];
+    /**
+     * Unregister a schema.
+     * @param name - Schema name to unregister
+     */
+    unregister(name: string): void;
+    /**
+     * Clear all registered schemas.
+     */
+    clear(): void;
+}
+/**
+ * Options for typed configuration access.
+ */
+export interface TypedConfigurationOptions {
+    /** Whether to enable strict type checking */
+    strictTypes?: boolean;
+    /** Whether to cache typed configurations */
+    cache?: boolean;
+    /** Default namespace for unnamespaced configurations */
+    defaultNamespace?: string;
+    /** Whether to throw on type validation failures */
+    throwOnValidationError?: boolean;
+}
+/**
+ * Utility type for extracting configuration type from a factory.
+ */
+export type ConfigurationType<T> = T extends TypedConfigurationFactory<infer U> ? U : never;
+/**
+ * Utility type for creating strongly typed configuration objects.
+ */
+export type StronglyTypedConfig<T extends Record<string, any>> = {
+    readonly [K in keyof T]: T[K];
+};
+/**
+ * Configuration value with metadata about its source and type.
+ */
+export interface ConfigurationValue<T = any> {
+    /** The actual configuration value */
+    value: T;
+    /** Source of this configuration value */
+    source: 'environment' | 'secrets-manager' | 'ssm' | 'local-file';
+    /** Whether this value came from AWS */
+    fromAws: boolean;
+    /** Namespace this value belongs to */
+    namespace?: string;
+    /** Original key used to access this value */
+    key: string;
+    /** Type of the value */
+    type: string;
+    /** Whether this value was validated */
+    validated: boolean;
+    /** Timestamp when this value was loaded */
+    loadedAt: Date;
+}
+/**
+ * Configuration path resolver for nested configuration access.
+ */
+export interface ConfigurationPathResolver {
+    /**
+     * Resolve a configuration path to its value.
+     * @param path - Configuration path (supports dot notation)
+     * @param config - Configuration object to resolve against
+     * @returns Resolved value or undefined
+     */
+    resolve<T = any>(path: string, config: Record<string, any>): T | undefined;
+    /**
+     * Set a value at a configuration path.
+     * @param path - Configuration path (supports dot notation)
+     * @param value - Value to set
+     * @param config - Configuration object to modify
+     */
+    set<T = any>(path: string, value: T, config: Record<string, any>): void;
+    /**
+     * Check if a configuration path exists.
+     * @param path - Configuration path (supports dot notation)
+     * @param config - Configuration object to check
+     * @returns True if path exists, false otherwise
+     */
+    exists(path: string, config: Record<string, any>): boolean;
+    /**
+     * Get all paths in a configuration object.
+     * @param config - Configuration object to analyze
+     * @returns Array of all configuration paths
+     */
+    getAllPaths(config: Record<string, any>): string[];
+}
+//# sourceMappingURL=typed-configuration.interface.d.ts.map

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

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