@dyanet/nestjs-config-aws 1.0.1

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

@@ -0,0 +1,249 @@
+/**
+ * Utility types for enhanced TypeScript support in nest-config-aws integration.
+ */
+/**
+ * Deep readonly type for configuration objects.
+ */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends (infer U)[] ? DeepReadonlyArray<U> : T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/**
+ * Deep readonly array type.
+ */
+export interface DeepReadonlyArray<T> extends ReadonlyArray<DeepReadonly<T>> {
+}
+/**
+ * Partial deep type for configuration objects.
+ */
+export type PartialDeep<T> = {
+    [P in keyof T]?: T[P] extends (infer U)[] ? PartialDeepArray<U> : T[P] extends object ? PartialDeep<T[P]> : T[P];
+};
+/**
+ * Partial deep array type.
+ */
+export interface PartialDeepArray<T> extends Array<PartialDeep<T>> {
+}
+/**
+ * Required deep type for configuration objects.
+ */
+export type RequiredDeep<T> = {
+    [P in keyof T]-?: T[P] extends (infer U)[] ? RequiredDeepArray<U> : T[P] extends object ? RequiredDeep<T[P]> : T[P];
+};
+/**
+ * Required deep array type.
+ */
+export interface RequiredDeepArray<T> extends Array<RequiredDeep<T>> {
+}
+/**
+ * Configuration path type for dot notation access.
+ */
+export type ConfigPath<T, K extends keyof T = keyof T> = K extends string ? T[K] extends Record<string, any> ? `${K}` | `${K}.${ConfigPath<T[K]>}` : `${K}` : never;
+/**
+ * Configuration value type for a given path.
+ */
+export type ConfigValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? ConfigValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+/**
+ * AWS configuration source union type.
+ */
+export type AwsConfigSource = 'secrets-manager' | 'ssm';
+/**
+ * Local configuration source union type.
+ */
+export type LocalConfigSource = 'environment' | 'local-file';
+/**
+ * All configuration source union type.
+ */
+export type AllConfigSource = AwsConfigSource | LocalConfigSource;
+/**
+ * Configuration source metadata.
+ */
+export type ConfigSourceMetadata<T extends AllConfigSource> = {
+    source: T;
+    isAws: T extends AwsConfigSource ? true : false;
+    priority: number;
+    loadedAt: Date;
+};
+/**
+ * Configuration with source metadata.
+ */
+export type ConfigWithSource<T, S extends AllConfigSource> = T & {
+    __metadata: ConfigSourceMetadata<S>;
+};
+/**
+ * Extract configuration type from a configuration factory.
+ */
+export type ExtractConfig<T> = T extends () => infer U ? U : never;
+/**
+ * Configuration factory map type.
+ */
+export type ConfigFactoryMap = Record<string, () => any>;
+/**
+ * Extract all configuration types from a factory map.
+ */
+export type ExtractConfigMap<T extends ConfigFactoryMap> = {
+    [K in keyof T]: ExtractConfig<T[K]>;
+};
+/**
+ * Namespace configuration type.
+ */
+export type NamespaceConfig<T extends Record<string, any>> = {
+    [K in keyof T]: T[K];
+};
+/**
+ * Multi-namespace configuration type.
+ */
+export type MultiNamespaceConfig<T extends Record<string, Record<string, any>>> = {
+    [K in keyof T]: NamespaceConfig<T[K]>;
+};
+/**
+ * Configuration validation result.
+ */
+export type ValidationResult<T = any> = {
+    isValid: boolean;
+    data?: T;
+    errors: string[];
+};
+/**
+ * Async configuration validation result.
+ */
+export type AsyncValidationResult<T = any> = Promise<ValidationResult<T>>;
+/**
+ * Configuration transformer function type.
+ */
+export type ConfigTransformerFn<TInput, TOutput> = (input: TInput) => TOutput;
+/**
+ * Async configuration transformer function type.
+ */
+export type AsyncConfigTransformerFn<TInput, TOutput> = (input: TInput) => Promise<TOutput>;
+/**
+ * Configuration predicate function type.
+ */
+export type ConfigPredicate<T> = (config: T) => boolean;
+/**
+ * Async configuration predicate function type.
+ */
+export type AsyncConfigPredicate<T> = (config: T) => Promise<boolean>;
+/**
+ * Configuration key extractor type.
+ */
+export type ConfigKeyExtractor<T> = (config: T) => string[];
+/**
+ * Configuration value extractor type.
+ */
+export type ConfigValueExtractor<T, U> = (config: T, key: string) => U | undefined;
+/**
+ * Configuration merger function type.
+ */
+export type ConfigMerger<T> = (primary: T, secondary: T) => T;
+/**
+ * Configuration serializer function type.
+ */
+export type ConfigSerializer<T> = (config: T) => string;
+/**
+ * Configuration deserializer function type.
+ */
+export type ConfigDeserializer<T> = (serialized: string) => T;
+/**
+ * Configuration cache key generator type.
+ */
+export type CacheKeyGenerator<T> = (config: T) => string;
+/**
+ * Configuration cache entry type.
+ */
+export type CacheEntry<T> = {
+    key: string;
+    value: T;
+    timestamp: Date;
+    ttl?: number;
+};
+/**
+ * Configuration cache type.
+ */
+export type ConfigCache<T> = Map<string, CacheEntry<T>>;
+/**
+ * Configuration event type.
+ */
+export type ConfigEventType = 'loaded' | 'updated' | 'error' | 'validated';
+/**
+ * Configuration event handler type.
+ */
+export type ConfigEventHandler<T = any> = (event: ConfigEventType, data: T) => void;
+/**
+ * Async configuration event handler type.
+ */
+export type AsyncConfigEventHandler<T = any> = (event: ConfigEventType, data: T) => Promise<void>;
+/**
+ * Configuration watcher type.
+ */
+export type ConfigWatcher<T> = {
+    watch: (handler: ConfigEventHandler<T>) => void;
+    unwatch: (handler: ConfigEventHandler<T>) => void;
+    stop: () => void;
+};
+/**
+ * Configuration builder pattern interface.
+ */
+export interface ConfigBuilder<T> {
+    /**
+     * Add a configuration source.
+     */
+    addSource(source: AllConfigSource, config: any): ConfigBuilder<T>;
+    /**
+     * Set precedence rule.
+     */
+    setPrecedence(rule: 'aws-first' | 'local-first' | 'merge'): ConfigBuilder<T>;
+    /**
+     * Add namespace.
+     */
+    addNamespace(namespace: string): ConfigBuilder<T>;
+    /**
+     * Add validation.
+     */
+    addValidation(validator: (config: any) => boolean): ConfigBuilder<T>;
+    /**
+     * Build the configuration.
+     */
+    build(): T;
+}
+/**
+ * Configuration fluent API interface.
+ */
+export interface ConfigFluentAPI<T> {
+    /**
+     * Filter configuration by predicate.
+     */
+    filter(predicate: ConfigPredicate<T>): ConfigFluentAPI<T>;
+    /**
+     * Transform configuration.
+     */
+    map<U>(transformer: ConfigTransformerFn<T, U>): ConfigFluentAPI<U>;
+    /**
+     * Validate configuration.
+     */
+    validate(validator: ConfigPredicate<T>): ConfigFluentAPI<T>;
+    /**
+     * Get the final configuration.
+     */
+    get(): T;
+}
+/**
+ * Type guard for AWS configuration sources.
+ */
+export declare const isAwsSource: (source: AllConfigSource) => source is AwsConfigSource;
+/**
+ * Type guard for local configuration sources.
+ */
+export declare const isLocalSource: (source: AllConfigSource) => source is LocalConfigSource;
+/**
+ * Type guard for configuration with metadata.
+ */
+export declare const hasMetadata: <T, S extends AllConfigSource>(config: any) => config is ConfigWithSource<T, S>;
+/**
+ * Type guard for validation result.
+ */
+export declare const isValidationResult: <T>(result: any) => result is ValidationResult<T>;
+/**
+ * Type guard for cache entry.
+ */
+export declare const isCacheEntry: <T>(entry: any) => entry is CacheEntry<T>;
+//# sourceMappingURL=utility-types.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utility-types.interface.d.ts","sourceRoot":"","sources":["../../../../src/integration/interfaces/utility-types.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC7C,iBAAiB,CAAC,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAAG;AAE/E;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACrC,gBAAgB,CAAC,CAAC,CAAC,GACnB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAAG;AAErE;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;KAC3B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GACtC,iBAAiB,CAAC,CAAC,CAAC,GACpB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACnB,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAAG;AAEvE;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,GACrE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GACnC,GAAG,CAAC,EAAE,GACR,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GAC/E,CAAC,SAAS,MAAM,CAAC,GACf,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GACvB,KAAK,GACP,CAAC,SAAS,MAAM,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC,GACJ,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,eAAe,IAAI;IAC5D,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,CAAC,SAAS,eAAe,GAAG,IAAI,GAAG,KAAK,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,eAAe,IAAI,CAAC,GAAG;IAC/D,UAAU,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;KAC1D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI;KAC/E,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,GAAG,IAAI;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,KAAK,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAElE;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE7E;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAElD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAErE;;OAEG;IACH,KAAK,IAAI,CAAC,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAEnE;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,GAAG,IAAI,CAAC,CAAC;CACV;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,eAAe,KAAG,MAAM,IAAI,eAE/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,KAAG,MAAM,IAAI,iBAEjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,CAAC,SAAS,eAAe,EACtD,QAAQ,GAAG,KACV,MAAM,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAAE,QAAQ,GAAG,KAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAS/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,GAAG,KAAG,KAAK,IAAI,UAAU,CAAC,CAAC,CASjE,CAAC"}

package/dist/types/integration/nestjs-config-integration.module.d.ts

@@ -0,0 +1,36 @@
+import { DynamicModule } from '@nestjs/common';
+import { IntegrationOptions, AsyncIntegrationOptions } from './interfaces/integration-options.interface';
+/**
+ * Token for injecting integration options
+ */
+export declare const NESTJS_CONFIG_AWS_INTEGRATION_OPTIONS = "NESTJS_CONFIG_AWS_INTEGRATION_OPTIONS";
+/**
+ * NestJS module for integrating nestjs-config-aws with @nestjs/config.
+ * This module provides AWS-sourced configuration values to the standard @nestjs/config module.
+ */
+export declare class NestConfigAwsIntegrationModule {
+    /**
+     * Create a synchronous integration module with provided options.
+     *
+     * @param options - Integration options for the module
+     * @returns Dynamic module configuration
+     */
+    static forRoot(options?: IntegrationOptions): DynamicModule;
+    /**
+     * Create an asynchronous integration module with factory-based options.
+     * Useful when integration options depend on other services or async operations.
+     *
+     * @param options - Async integration options with factory function
+     * @returns Dynamic module configuration
+     */
+    static forRootAsync(options: AsyncIntegrationOptions): DynamicModule;
+    /**
+     * Create the standard providers for the integration module.
+     */
+    private static createProviders;
+    /**
+     * Create providers for asynchronous module registration.
+     */
+    private static createAsyncProviders;
+}
+//# sourceMappingURL=nestjs-config-integration.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-config-integration.module.d.ts","sourceRoot":"","sources":["../../../src/integration/nestjs-config-integration.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAWzG;;GAEG;AACH,eAAO,MAAM,qCAAqC,0CAA0C,CAAC;AAE7F;;;GAGG;AACH,qBAEa,8BAA8B;IACzC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,aAAa;IA0B/D;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa;IAyBpE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAc9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CASpC"}

package/dist/types/integration/providers/aws-configuration-loader.service.d.ts

@@ -0,0 +1,134 @@
+import { IntegrationOptions } from '../interfaces/integration-options.interface';
+import { ConfigurationSource } from '../interfaces/configuration-source.interface';
+/**
+ * Service for loading configuration from AWS sources for integration with @nestjs/config.
+ * Uses existing AWS loaders to fetch configuration and provides namespace-aware loading capabilities.
+ */
+export declare class AwsConfigurationLoaderService {
+    private readonly logger;
+    private readonly loaders;
+    private readonly options;
+    private readonly errorHandler;
+    constructor(options?: IntegrationOptions);
+    /**
+     * Load configuration from AWS sources.
+     * @returns Promise resolving to configuration data
+     */
+    loadConfiguration(): Promise<Record<string, any>>;
+    /**
+     * Load configuration for specific namespaces from AWS sources.
+     * @param namespaces - Array of namespace names to load
+     * @returns Promise resolving to namespaced configuration data
+     */
+    loadNamespacedConfiguration(namespaces: string[]): Promise<Record<string, Record<string, any>>>;
+    /**
+     * Check if AWS services are available.
+     * @returns Promise resolving to availability status
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get all available configuration sources with their metadata.
+     * @returns Promise resolving to array of configuration sources
+     */
+    getAvailableSources(): Promise<ConfigurationSource[]>;
+    /**
+     * Create configuration loaders based on integration options.
+     * @returns Array of configuration loaders
+     */
+    private createLoaders;
+    /**
+     * Get the source type for a given loader.
+     * @param loader - The configuration loader
+     * @returns The configuration source type
+     */
+    private getSourceType;
+    /**
+     * Get the priority for a given loader based on precedence rules.
+     * @param loader - The configuration loader
+     * @returns The priority number (higher = higher priority)
+     */
+    private getSourcePriority;
+    /**
+     * Extract configuration for a specific namespace from loaded configuration.
+     * @param config - The loaded configuration
+     * @param namespace - The namespace to extract
+     * @returns Configuration values for the namespace
+     */
+    private extractNamespaceConfig;
+    /**
+     * Extract nested namespace configuration from hierarchical keys.
+     * @param config - The loaded configuration
+     * @param namespace - The namespace to extract
+     * @returns Configuration values for the namespace
+     */
+    private extractNestedNamespaceConfig;
+    /**
+     * 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 (e.g., "host/port")
+     * @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;
+    /**
+     * Get the Secrets Manager path based on configuration.
+     * @returns The secrets manager path
+     */
+    private getSecretsManagerPath;
+    /**
+     * Get the SSM Parameter Store path based on configuration.
+     * @returns The SSM parameter path
+     */
+    private getSSMParameterPath;
+    /**
+     * Check if an error is an AWS service error.
+     * @param error - The error to check
+     * @returns Whether the error is from an AWS service
+     */
+    private isAwsServiceError;
+    /**
+     * Handle AWS-specific errors with appropriate strategies.
+     * @param loader - The loader that encountered the error
+     * @param error - The AWS error
+     * @returns Whether to continue processing
+     */
+    private handleAwsSpecificError;
+    /**
+     * Get the service name for a loader.
+     * @param loader - The configuration loader
+     * @returns The service name
+     */
+    private getServiceName;
+    /**
+     * Get the resource name for a loader.
+     * @param loader - The configuration loader
+     * @returns The resource name
+     */
+    private getResourceName;
+    /**
+     * Load configuration with retry logic for retryable errors.
+     * @param loader - The configuration loader
+     * @param maxRetries - Maximum number of retries
+     * @returns Promise resolving to configuration data
+     */
+    private loadWithRetry;
+    /**
+     * Check availability with timeout and error handling.
+     * @param loader - The configuration loader
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Promise resolving to availability status
+     */
+    private checkAvailabilityWithTimeout;
+}
+//# sourceMappingURL=aws-configuration-loader.service.d.ts.map

package/dist/types/integration/providers/aws-configuration-loader.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-configuration-loader.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/providers/aws-configuration-loader.service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAA2B,MAAM,8CAA8C,CAAC;AAI5G;;;GAGG;AACH,qBACa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAGN,OAAO,CAAC,EAAE,kBAAkB;IAOzE;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAkFvD;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IA+ErG;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6BrC;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAsC3D;;;OAGG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAgC9B;;;;;OAKG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA0C9B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;OAKG;YACW,aAAa;IA2B3B;;;;;OAKG;YACW,4BAA4B;CAmB3C"}

package/dist/types/integration/providers/configuration-factory.provider.d.ts

@@ -0,0 +1,119 @@
+import { ConfigFactory } from '@nestjs/config';
+import { ConfigurationFactoryProvider, AwsConfigurationFactory } from '../interfaces/configuration-factory.interface';
+import { ConfigurationSource } from '../interfaces/configuration-source.interface';
+import { PrecedenceRule, IntegrationOptions } from '../interfaces/integration-options.interface';
+import { PrecedenceHandlerService } from '../services/precedence-handler.service';
+/**
+ * Implementation of ConfigurationFactoryProvider that creates configuration factories
+ * for @nestjs/config integration with AWS configuration sources.
+ */
+export declare class ConfigurationFactoryProviderImpl implements ConfigurationFactoryProvider {
+    private readonly precedenceHandler;
+    private readonly options?;
+    private readonly logger;
+    constructor(precedenceHandler: PrecedenceHandlerService, options?: IntegrationOptions | undefined);
+    /**
+     * Create a configuration factory for a specific namespace.
+     * @param namespace - The namespace for the configuration
+     * @param config - The configuration data
+     * @returns A configuration factory that can be used with @nestjs/config
+     */
+    createFactory(namespace: string, config: Record<string, any>): ConfigFactory;
+    /**
+     * Create multiple namespaced configuration factories from a configuration object.
+     * @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 using precedence rules.
+     * @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>;
+    /**
+     * Process configuration values to handle special cases and transformations.
+     * @param config - Raw configuration object
+     * @returns Processed configuration object
+     */
+    private processConfigurationValues;
+    /**
+     * Process individual configuration values.
+     * @param value - The value to process
+     * @returns Processed value
+     */
+    private processValue;
+    /**
+     * Convert string values to appropriate types.
+     * @param value - String value to convert
+     * @returns Converted value
+     */
+    private convertStringValue;
+    /**
+     * 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;
+    /**
+     * Deep merge two configuration objects.
+     * @param target - Target object
+     * @param source - Source object
+     * @returns Merged object
+     */
+    private deepMerge;
+    /**
+     * Extract configuration for a specific namespace from multiple sources.
+     * @param sourceConfigs - Map of source configurations
+     * @param namespace - Target namespace
+     * @returns Configuration for the namespace
+     */
+    private extractNamespaceConfig;
+    /**
+     * Merge configuration from multiple sources.
+     * @param sourceConfigs - Map of source configurations
+     * @returns Merged configuration
+     */
+    private mergeSourceConfigs;
+    /**
+     * Extract sources for a specific namespace.
+     * @param sources - All configuration sources
+     * @param namespace - Target namespace
+     * @returns Sources filtered for the namespace
+     */
+    private extractNamespaceSources;
+}
+//# sourceMappingURL=configuration-factory.provider.d.ts.map

package/dist/types/integration/providers/configuration-factory.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-factory.provider.d.ts","sourceRoot":"","sources":["../../../../src/integration/providers/configuration-factory.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACtH,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGlF;;;GAGG;AACH,qBACa,gCAAiC,YAAW,4BAA4B;IAIjF,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAL3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;gBAGzD,iBAAiB,EAAE,wBAAwB,EAE3C,OAAO,CAAC,EAAE,kBAAkB,YAAA;IAG/C;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa;IAmC5E;;;;OAIG;IACH,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,EAAE;IAqBvE;;;;;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;IA4BtB;;;;;;;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;IAgB1B;;;;;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;IA0BlB;;;;;;OAMG;IACH,6BAA6B,CAC3B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,cAAc,EAAE,cAAc,EAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,GACpB,aAAa,EAAE;IAiClB;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,cAAc,EAAE,cAAc,GAC7B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAYtB;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAuBpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAkBjB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;CAmBhC"}

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

@@ -0,0 +1,3 @@
+export * from './configuration-factory.provider';
+export * from './aws-configuration-loader.service';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integration/providers/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC"}

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

@@ -0,0 +1,84 @@
+import { ConfigFactory, ConfigModuleOptions } from '@nestjs/config';
+import { FactoryRegistrationService } from './factory-registration.service';
+import { IntegrationOptions } from '../interfaces/integration-options.interface';
+/**
+ * Helper service for async configuration support with @nestjs/config.
+ * This service provides utilities for creating async configuration factories
+ * and managing dependency injection in async scenarios.
+ */
+export declare class AsyncConfigHelperService {
+    private readonly factoryRegistrationService;
+    private readonly options;
+    private readonly logger;
+    constructor(factoryRegistrationService: FactoryRegistrationService, options?: IntegrationOptions);
+    /**
+     * Create an async configuration factory that loads AWS configuration.
+     * This factory can be used with @nestjs/config's load array.
+     *
+     * @returns Promise resolving to configuration factory
+     */
+    createAsyncConfigFactory(): Promise<ConfigFactory>;
+    /**
+     * Create multiple async configuration factories for namespaces.
+     * This method creates separate factories for each namespace.
+     *
+     * @param namespaces - Array of namespace names
+     * @returns Promise resolving to array of namespaced configuration factories
+     */
+    createAsyncNamespacedFactories(namespaces: string[]): Promise<ConfigFactory[]>;
+    /**
+     * Create an async factory function that can be used with dependency injection.
+     * This method creates a factory that can receive injected dependencies.
+     *
+     * @param dependencies - Array of dependency tokens to inject
+     * @returns Async factory function
+     */
+    createAsyncFactoryWithDependencies(dependencies?: any[]): (...args: any[]) => Promise<ConfigModuleOptions>;
+    /**
+     * Create an async factory that merges with existing configuration.
+     * This method creates a factory that can be combined with other configuration sources.
+     *
+     * @param existingFactory - Existing configuration factory to merge with
+     * @returns Promise resolving to merged configuration factory
+     */
+    createMergedAsyncFactory(existingFactory?: ConfigFactory): Promise<ConfigFactory>;
+    /**
+     * Create configuration options for async module setup.
+     * This method creates options that can be used with ConfigModule.forRoot().
+     *
+     * @param baseOptions - Base configuration options to enhance
+     * @returns Promise resolving to enhanced configuration options
+     */
+    createAsyncConfigOptions(baseOptions?: ConfigModuleOptions): Promise<ConfigModuleOptions>;
+    /**
+     * Check if AWS configuration is available for async loading.
+     * This method can be used to determine if AWS integration should be enabled.
+     *
+     * @returns Promise resolving to availability status
+     */
+    checkAsyncAvailability(): Promise<{
+        isAvailable: boolean;
+        factoriesCount: number;
+        errors: string[];
+    }>;
+    /**
+     * Create a factory that loads configuration on-demand.
+     * This factory delays AWS configuration loading until it's actually needed.
+     *
+     * @returns Configuration factory with lazy loading
+     */
+    createLazyAsyncFactory(): ConfigFactory;
+    /**
+     * Load configuration lazily for the lazy factory.
+     * @returns Promise resolving to configuration data
+     */
+    private loadConfigurationLazily;
+    /**
+     * Deep merge two configuration objects.
+     * @param target - Target object
+     * @param source - Source object
+     * @returns Merged object
+     */
+    private deepMerge;
+}
+//# sourceMappingURL=async-config-helper.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"async-config-helper.service.d.ts","sourceRoot":"","sources":["../../../../src/integration/services/async-config-helper.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGjF;;;;GAIG;AACH,qBACa,wBAAwB;IAIjC,OAAO,CAAC,QAAQ,CAAC,0BAA0B;IAE3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;gBAGjD,0BAA0B,EAAE,0BAA0B,EAEtD,OAAO,GAAE,kBAAuB;IAGnD;;;;;OAKG;IACG,wBAAwB,IAAI,OAAO,CAAC,aAAa,CAAC;IAiDxD;;;;;;OAMG;IACG,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgCpF;;;;;;OAMG;IACH,kCAAkC,CAAC,YAAY,GAAE,GAAG,EAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC;IA6C9G;;;;;;OAMG;IACG,wBAAwB,CAAC,eAAe,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDvF;;;;;;OAMG;IACG,wBAAwB,CAAC,WAAW,GAAE,mBAAwB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAyCnG;;;;;OAKG;IACG,sBAAsB,IAAI,OAAO,CAAC;QACtC,WAAW,EAAE,OAAO,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IA0BF;;;;;OAKG;IACH,sBAAsB,IAAI,aAAa;IA6BvC;;;OAGG;YACW,uBAAuB;IAqBrC;;;;;OAKG;IACH,OAAO,CAAC,SAAS;CAiBlB"}